typeclaw 0.49.0 → 0.50.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (442) hide show
  1. package/dist/types/agent/attention-escalation.d.ts +18 -0
  2. package/dist/types/agent/auth.d.ts +7 -0
  3. package/dist/types/agent/compaction.d.ts +8 -0
  4. package/dist/types/agent/git-nudge.d.ts +6 -0
  5. package/dist/types/agent/guard-types.d.ts +25 -0
  6. package/dist/types/agent/guards.d.ts +7 -0
  7. package/dist/types/agent/idle-compaction.d.ts +7 -0
  8. package/dist/types/agent/index.d.ts +163 -0
  9. package/dist/types/agent/live-subagents.d.ts +113 -0
  10. package/dist/types/agent/llm-replay-sanitizer.d.ts +11 -0
  11. package/dist/types/agent/loop-guard.d.ts +67 -0
  12. package/dist/types/agent/model-fallback.d.ts +29 -0
  13. package/dist/types/agent/model-overrides.d.ts +8 -0
  14. package/dist/types/agent/multimodal/index.d.ts +2 -0
  15. package/dist/types/agent/multimodal/look-at.d.ts +60 -0
  16. package/dist/types/agent/multimodal/looker.d.ts +61 -0
  17. package/dist/types/agent/multimodal/read-redirect.d.ts +6 -0
  18. package/dist/types/agent/network/response-body.d.ts +1 -0
  19. package/dist/types/agent/network/safe-http.d.ts +46 -0
  20. package/dist/types/agent/plugin-tools.d.ts +129 -0
  21. package/dist/types/agent/proactive-next-step-nudge.d.ts +2 -0
  22. package/dist/types/agent/prompt-cache-key.d.ts +3 -0
  23. package/dist/types/agent/provider-error.d.ts +23 -0
  24. package/dist/types/agent/reload-tool.d.ts +10 -0
  25. package/dist/types/agent/restart/index.d.ts +31 -0
  26. package/dist/types/agent/restart-handoff/index.d.ts +32 -0
  27. package/dist/types/agent/restart-handoff/paths.d.ts +1 -0
  28. package/dist/types/agent/retry-same-ref.d.ts +41 -0
  29. package/dist/types/agent/reviewer-activity.d.ts +3 -0
  30. package/dist/types/agent/reviewer-bash-policy.d.ts +8 -0
  31. package/dist/types/agent/self.d.ts +1 -0
  32. package/dist/types/agent/session-meta.d.ts +28 -0
  33. package/dist/types/agent/session-origin.d.ts +65 -0
  34. package/dist/types/agent/subagent-cache-keepalive.d.ts +38 -0
  35. package/dist/types/agent/subagent-completion-reminder.d.ts +29 -0
  36. package/dist/types/agent/subagent-drain.d.ts +25 -0
  37. package/dist/types/agent/subagent-session.d.ts +3 -0
  38. package/dist/types/agent/subagents.d.ts +153 -0
  39. package/dist/types/agent/system-prompt.d.ts +7 -0
  40. package/dist/types/agent/throttle-circuit.d.ts +25 -0
  41. package/dist/types/agent/todo/continuation-policy.d.ts +54 -0
  42. package/dist/types/agent/todo/continuation-state.d.ts +11 -0
  43. package/dist/types/agent/todo/continuation-wiring.d.ts +32 -0
  44. package/dist/types/agent/todo/continuation.d.ts +21 -0
  45. package/dist/types/agent/todo/scope.d.ts +6 -0
  46. package/dist/types/agent/todo/store.d.ts +16 -0
  47. package/dist/types/agent/tool-error-remediation.d.ts +1 -0
  48. package/dist/types/agent/tool-file-safety.d.ts +78 -0
  49. package/dist/types/agent/tool-not-found-nudge.d.ts +9 -0
  50. package/dist/types/agent/tool-result-budget.d.ts +15 -0
  51. package/dist/types/agent/tools/channel-disengage.d.ts +18 -0
  52. package/dist/types/agent/tools/channel-edit.d.ts +19 -0
  53. package/dist/types/agent/tools/channel-fetch-attachment.d.ts +36 -0
  54. package/dist/types/agent/tools/channel-handoff.d.ts +13 -0
  55. package/dist/types/agent/tools/channel-history-render.d.ts +3 -0
  56. package/dist/types/agent/tools/channel-history.d.ts +25 -0
  57. package/dist/types/agent/tools/channel-log.d.ts +5 -0
  58. package/dist/types/agent/tools/channel-react.d.ts +23 -0
  59. package/dist/types/agent/tools/channel-read.d.ts +27 -0
  60. package/dist/types/agent/tools/channel-reply.d.ts +47 -0
  61. package/dist/types/agent/tools/channel-send.d.ts +42 -0
  62. package/dist/types/agent/tools/channel-session-search.d.ts +10 -0
  63. package/dist/types/agent/tools/curl-impersonate.d.ts +37 -0
  64. package/dist/types/agent/tools/ddg.d.ts +18 -0
  65. package/dist/types/agent/tools/grant-role.d.ts +25 -0
  66. package/dist/types/agent/tools/keyed-semaphore.d.ts +10 -0
  67. package/dist/types/agent/tools/post-github-review.d.ts +38 -0
  68. package/dist/types/agent/tools/restart.d.ts +25 -0
  69. package/dist/types/agent/tools/runtime-notice.d.ts +3 -0
  70. package/dist/types/agent/tools/search-retry.d.ts +16 -0
  71. package/dist/types/agent/tools/skip-response.d.ts +17 -0
  72. package/dist/types/agent/tools/spawn-subagent.d.ts +77 -0
  73. package/dist/types/agent/tools/stream-snapshot.d.ts +23 -0
  74. package/dist/types/agent/tools/subagent-access.d.ts +20 -0
  75. package/dist/types/agent/tools/subagent-cancel.d.ts +23 -0
  76. package/dist/types/agent/tools/subagent-output.d.ts +50 -0
  77. package/dist/types/agent/tools/todo/index.d.ts +14 -0
  78. package/dist/types/agent/tools/webfetch/adaptive-html.d.ts +29 -0
  79. package/dist/types/agent/tools/webfetch/fetch.d.ts +26 -0
  80. package/dist/types/agent/tools/webfetch/html-lexical.d.ts +27 -0
  81. package/dist/types/agent/tools/webfetch/index.d.ts +1 -0
  82. package/dist/types/agent/tools/webfetch/inline-style-visibility.d.ts +3 -0
  83. package/dist/types/agent/tools/webfetch/strategies/grep.d.ts +11 -0
  84. package/dist/types/agent/tools/webfetch/strategies/jq.d.ts +4 -0
  85. package/dist/types/agent/tools/webfetch/strategies/raw.d.ts +1 -0
  86. package/dist/types/agent/tools/webfetch/strategies/readability.d.ts +16 -0
  87. package/dist/types/agent/tools/webfetch/strategies/selector.d.ts +4 -0
  88. package/dist/types/agent/tools/webfetch/strategies/snapshot.d.ts +1 -0
  89. package/dist/types/agent/tools/webfetch/tool.d.ts +15 -0
  90. package/dist/types/agent/tools/webfetch/types.d.ts +32 -0
  91. package/dist/types/agent/tools/websearch.d.ts +17 -0
  92. package/dist/types/agent/tools/wikipedia.d.ts +7 -0
  93. package/dist/types/agent/tools-without-local-file-operands.d.ts +1 -0
  94. package/dist/types/agent/turn-runner.d.ts +36 -0
  95. package/dist/types/agent-messenger/config-dir.d.ts +19 -0
  96. package/dist/types/browser/dockerfile.d.ts +2 -0
  97. package/dist/types/browser/registry.d.ts +49 -0
  98. package/dist/types/bundled-plugins/bun-hygiene/policy.d.ts +18 -0
  99. package/dist/types/bundled-plugins/github-cli-auth/git-askpass.d.ts +5 -0
  100. package/dist/types/bundled-plugins/guard/keys.d.ts +6 -0
  101. package/dist/types/bundled-plugins/guard/policies/managed-config.d.ts +7 -0
  102. package/dist/types/bundled-plugins/guard/policies/memory-topics-delete.d.ts +11 -0
  103. package/dist/types/bundled-plugins/guard/policies/memory-topics-write.d.ts +7 -0
  104. package/dist/types/bundled-plugins/guard/policies/non-workspace-write.d.ts +9 -0
  105. package/dist/types/bundled-plugins/guard/policies/skill-authoring.d.ts +20 -0
  106. package/dist/types/bundled-plugins/guard/policies/uncommitted-changes.d.ts +12 -0
  107. package/dist/types/bundled-plugins/guard/policy.d.ts +11 -0
  108. package/dist/types/bundled-plugins/memory/secret-detector.d.ts +11 -0
  109. package/dist/types/bundled-plugins/memory/slug.d.ts +4 -0
  110. package/dist/types/bundled-plugins/security/permissions.d.ts +20 -0
  111. package/dist/types/bundled-plugins/security/policies/private-surface-read.d.ts +34 -0
  112. package/dist/types/bundled-plugins/security/policies/ssrf.d.ts +18 -0
  113. package/dist/types/bundled-plugins/security/policy.d.ts +4 -0
  114. package/dist/types/channels/adapter-namespace.d.ts +2 -0
  115. package/dist/types/channels/adapters/mention-hints.d.ts +12 -0
  116. package/dist/types/channels/adapters/webex-id-ref.d.ts +5 -0
  117. package/dist/types/channels/background-handoff.d.ts +56 -0
  118. package/dist/types/channels/background-obligations.d.ts +135 -0
  119. package/dist/types/channels/catch-up.d.ts +26 -0
  120. package/dist/types/channels/commands.d.ts +2 -0
  121. package/dist/types/channels/completion-claim.d.ts +20 -0
  122. package/dist/types/channels/continuation-willingness.d.ts +1 -0
  123. package/dist/types/channels/continuity-types.d.ts +75 -0
  124. package/dist/types/channels/describe-error.d.ts +1 -0
  125. package/dist/types/channels/engagement.d.ts +34 -0
  126. package/dist/types/channels/github-false-receipt.d.ts +20 -0
  127. package/dist/types/channels/github-repo.d.ts +2 -0
  128. package/dist/types/channels/github-rereview-guard.d.ts +24 -0
  129. package/dist/types/channels/github-review-check.d.ts +135 -0
  130. package/dist/types/channels/github-review-claim.d.ts +3 -0
  131. package/dist/types/channels/github-review-turn-ledger.d.ts +71 -0
  132. package/dist/types/channels/github-review-verdict-coordinator.d.ts +117 -0
  133. package/dist/types/channels/github-token-bridge.d.ts +20 -0
  134. package/dist/types/channels/github-verdict-activity.d.ts +12 -0
  135. package/dist/types/channels/inbound-journal.d.ts +272 -0
  136. package/dist/types/channels/last-alive.d.ts +3 -0
  137. package/dist/types/channels/membership-cache.d.ts +27 -0
  138. package/dist/types/channels/membership.d.ts +21 -0
  139. package/dist/types/channels/outbound-flood-filter.d.ts +7 -0
  140. package/dist/types/channels/participants.d.ts +4 -0
  141. package/dist/types/channels/persistence.d.ts +32 -0
  142. package/dist/types/channels/recovery-notice.d.ts +26 -0
  143. package/dist/types/channels/recovery-outbox.d.ts +58 -0
  144. package/dist/types/channels/router.d.ts +798 -0
  145. package/dist/types/channels/schema.d.ts +501 -0
  146. package/dist/types/channels/session-handoff.d.ts +58 -0
  147. package/dist/types/channels/session-search.d.ts +29 -0
  148. package/dist/types/channels/types.d.ts +414 -0
  149. package/dist/types/channels/waiting-reactions.d.ts +25 -0
  150. package/dist/types/cli/builtins.d.ts +2 -0
  151. package/dist/types/cli/command-meta.d.ts +9 -0
  152. package/dist/types/coding-agent/broker-body.d.ts +7 -0
  153. package/dist/types/coding-agent/broker.d.ts +22 -0
  154. package/dist/types/coding-agent/claude.d.ts +22 -0
  155. package/dist/types/coding-agent/codex.d.ts +19 -0
  156. package/dist/types/coding-agent/index.d.ts +71 -0
  157. package/dist/types/coding-agent/omo-state.d.ts +2 -0
  158. package/dist/types/coding-agent/omo-stream.d.ts +22 -0
  159. package/dist/types/coding-agent/omo.d.ts +133 -0
  160. package/dist/types/coding-agent/runner.d.ts +35 -0
  161. package/dist/types/coding-agent/tool.d.ts +27 -0
  162. package/dist/types/coding-agent/worktree.d.ts +22 -0
  163. package/dist/types/commands/index.d.ts +45 -0
  164. package/dist/types/config/config.d.ts +814 -0
  165. package/dist/types/config/index.d.ts +3 -0
  166. package/dist/types/config/model-overrides.d.ts +3 -0
  167. package/dist/types/config/providers.d.ts +1456 -0
  168. package/dist/types/config/reloadable.d.ts +9 -0
  169. package/dist/types/container/agent-operation-lock.d.ts +31 -0
  170. package/dist/types/container/build-cache.d.ts +39 -0
  171. package/dist/types/container/compose-project.d.ts +1 -0
  172. package/dist/types/container/controller.d.ts +25 -0
  173. package/dist/types/container/docker-app.d.ts +23 -0
  174. package/dist/types/container/exit-reason.d.ts +10 -0
  175. package/dist/types/container/index.d.ts +14 -0
  176. package/dist/types/container/log-archive.d.ts +68 -0
  177. package/dist/types/container/log-colors.d.ts +3 -0
  178. package/dist/types/container/log-timestamps.d.ts +9 -0
  179. package/dist/types/container/logs.d.ts +37 -0
  180. package/dist/types/container/memory-limit.d.ts +13 -0
  181. package/dist/types/container/memory-oversubscription.d.ts +20 -0
  182. package/dist/types/container/oom-events.d.ts +18 -0
  183. package/dist/types/container/port.d.ts +18 -0
  184. package/dist/types/container/require-running.d.ts +16 -0
  185. package/dist/types/container/restart.d.ts +32 -0
  186. package/dist/types/container/shared.d.ts +93 -0
  187. package/dist/types/container/shell.d.ts +35 -0
  188. package/dist/types/container/start.d.ts +144 -0
  189. package/dist/types/container/stats.d.ts +31 -0
  190. package/dist/types/container/status.d.ts +25 -0
  191. package/dist/types/container/stop.d.ts +24 -0
  192. package/dist/types/container/tool-oom-priority.d.ts +4 -0
  193. package/dist/types/container/verify-running.d.ts +49 -0
  194. package/dist/types/cron/consumer.d.ts +42 -0
  195. package/dist/types/cron/count-state.d.ts +24 -0
  196. package/dist/types/cron/index.d.ts +21 -0
  197. package/dist/types/cron/list.d.ts +33 -0
  198. package/dist/types/cron/reloadable.d.ts +11 -0
  199. package/dist/types/cron/scheduler.d.ts +51 -0
  200. package/dist/types/cron/schema.d.ts +108 -0
  201. package/dist/types/dependencies/bin-resolver.d.ts +28 -0
  202. package/dist/types/dependencies/bins.d.ts +22 -0
  203. package/dist/types/dependencies/index.d.ts +2 -0
  204. package/dist/types/git/bound-gc-config.d.ts +4 -0
  205. package/dist/types/git/hookless.d.ts +1 -0
  206. package/dist/types/git/reconcile-ignored.d.ts +13 -0
  207. package/dist/types/git/resolve-agent-git.d.ts +8 -0
  208. package/dist/types/git/resolve-identity.d.ts +10 -0
  209. package/dist/types/git/run.d.ts +24 -0
  210. package/dist/types/git/system-commit.d.ts +2 -0
  211. package/dist/types/hostd/client.d.ts +13 -0
  212. package/dist/types/hostd/models.d.ts +1 -0
  213. package/dist/types/hostd/paths.d.ts +17 -0
  214. package/dist/types/hostd/protocol.d.ts +93 -0
  215. package/dist/types/hostd/spawn.d.ts +17 -0
  216. package/dist/types/hostd/version.d.ts +18 -0
  217. package/dist/types/init/auto-upgrade.d.ts +41 -0
  218. package/dist/types/init/cli-version.d.ts +7 -0
  219. package/dist/types/init/dockerfile.d.ts +34 -0
  220. package/dist/types/init/ensure-deps.d.ts +17 -0
  221. package/dist/types/init/env-file.d.ts +3 -0
  222. package/dist/types/init/gitignore.d.ts +5 -0
  223. package/dist/types/init/local-source-stamp.d.ts +3 -0
  224. package/dist/types/init/packagejson.d.ts +7 -0
  225. package/dist/types/init/paths.d.ts +3 -0
  226. package/dist/types/init/reconcile-plugin-deps.d.ts +13 -0
  227. package/dist/types/init/run-bun-install.d.ts +16 -0
  228. package/dist/types/init/windows-dev-link.d.ts +8 -0
  229. package/dist/types/mcp/catalog.d.ts +7 -0
  230. package/dist/types/mcp/client.d.ts +58 -0
  231. package/dist/types/mcp/manager.d.ts +56 -0
  232. package/dist/types/mcp/tools.d.ts +23 -0
  233. package/dist/types/models/embedding-model.d.ts +20 -0
  234. package/dist/types/models/transformers-version.d.ts +1 -0
  235. package/dist/types/network/internal-destinations.d.ts +29 -0
  236. package/dist/types/operations/classify-tool-outcome.d.ts +35 -0
  237. package/dist/types/operations/incidents.d.ts +47 -0
  238. package/dist/types/operations/index.d.ts +3 -0
  239. package/dist/types/operations/remediations.d.ts +25 -0
  240. package/dist/types/path-safety/real-intended-path.d.ts +9 -0
  241. package/dist/types/permissions/builtins.d.ts +25 -0
  242. package/dist/types/permissions/grant.d.ts +19 -0
  243. package/dist/types/permissions/index.d.ts +6 -0
  244. package/dist/types/permissions/match-rule.d.ts +28 -0
  245. package/dist/types/permissions/permissions.d.ts +42 -0
  246. package/dist/types/permissions/resolve.d.ts +25 -0
  247. package/dist/types/permissions/schema.d.ts +14 -0
  248. package/dist/types/plugin/context.d.ts +20 -0
  249. package/dist/types/plugin/core-tool-names.d.ts +4 -0
  250. package/dist/types/plugin/define.d.ts +46 -0
  251. package/dist/types/plugin/hooks.d.ts +52 -0
  252. package/dist/types/plugin/index.d.ts +11 -0
  253. package/dist/types/plugin/load-skill.d.ts +14 -0
  254. package/dist/types/plugin/loader.d.ts +25 -0
  255. package/dist/types/plugin/manager.d.ts +42 -0
  256. package/dist/types/plugin/registry.d.ts +73 -0
  257. package/dist/types/plugin/skills.d.ts +11 -0
  258. package/dist/types/plugin/types.d.ts +336 -0
  259. package/dist/types/plugin/zod-introspect.d.ts +11 -0
  260. package/dist/types/reload/client.d.ts +11 -0
  261. package/dist/types/reload/docker-exec-client.d.ts +11 -0
  262. package/dist/types/reload/format.d.ts +2 -0
  263. package/dist/types/reload/index.d.ts +6 -0
  264. package/dist/types/reload/recover.d.ts +22 -0
  265. package/dist/types/reload/registry.d.ts +10 -0
  266. package/dist/types/reload/types.d.ts +25 -0
  267. package/dist/types/role-claim/client.d.ts +20 -0
  268. package/dist/types/role-claim/code.d.ts +4 -0
  269. package/dist/types/role-claim/controller.d.ts +59 -0
  270. package/dist/types/role-claim/index.d.ts +6 -0
  271. package/dist/types/role-claim/match-rule.d.ts +9 -0
  272. package/dist/types/role-claim/pending.d.ts +35 -0
  273. package/dist/types/role-claim/reload-after-claim.d.ts +16 -0
  274. package/dist/types/run/llm-fetch-observer.d.ts +50 -0
  275. package/dist/types/sandbox/availability.d.ts +21 -0
  276. package/dist/types/sandbox/build.d.ts +7 -0
  277. package/dist/types/sandbox/canonical-secrets.d.ts +8 -0
  278. package/dist/types/sandbox/coding-agent.d.ts +20 -0
  279. package/dist/types/sandbox/dependency-bins.d.ts +19 -0
  280. package/dist/types/sandbox/dev-source.d.ts +4 -0
  281. package/dist/types/sandbox/env-exposure.d.ts +1 -0
  282. package/dist/types/sandbox/errors.d.ts +20 -0
  283. package/dist/types/sandbox/hidden-paths.d.ts +11 -0
  284. package/dist/types/sandbox/index.d.ts +14 -0
  285. package/dist/types/sandbox/package-install.d.ts +1 -0
  286. package/dist/types/sandbox/policy.d.ts +71 -0
  287. package/dist/types/sandbox/privileged-runtime.d.ts +13 -0
  288. package/dist/types/sandbox/quote.d.ts +2 -0
  289. package/dist/types/sandbox/runtime-private.d.ts +1 -0
  290. package/dist/types/sandbox/session-tmp.d.ts +6 -0
  291. package/dist/types/sandbox/symlinks.d.ts +6 -0
  292. package/dist/types/sandbox/writable-zones.d.ts +15 -0
  293. package/dist/types/secrets/coding-agent-auth.d.ts +25 -0
  294. package/dist/types/secrets/defaults.d.ts +21 -0
  295. package/dist/types/secrets/export-github-cli-store.d.ts +22 -0
  296. package/dist/types/secrets/hydrate.d.ts +7 -0
  297. package/dist/types/secrets/index.d.ts +7 -0
  298. package/dist/types/secrets/provision-github-cli-store.d.ts +45 -0
  299. package/dist/types/secrets/refresh-provider-oauth.d.ts +22 -0
  300. package/dist/types/secrets/resolve.d.ts +14 -0
  301. package/dist/types/secrets/schema.d.ts +840 -0
  302. package/dist/types/secrets/storage.d.ts +56 -0
  303. package/dist/types/shared/host-locale.d.ts +1 -0
  304. package/dist/types/shared/index.d.ts +5 -0
  305. package/dist/types/shared/local-time.d.ts +4 -0
  306. package/dist/types/shared/platform.d.ts +2 -0
  307. package/dist/types/shared/protocol.d.ts +424 -0
  308. package/dist/types/shared/style-text.d.ts +3 -0
  309. package/dist/types/shared/wsl.d.ts +17 -0
  310. package/dist/types/stream/broker.d.ts +2 -0
  311. package/dist/types/stream/index.d.ts +2 -0
  312. package/dist/types/stream/types.d.ts +71 -0
  313. package/package.json +9 -2
  314. package/scripts/build-plugin-types.ts +105 -0
  315. package/scripts/check-plugin-sdk.ts +111 -0
  316. package/scripts/require-parallel.ts +5 -32
  317. package/src/agent/guard-types.ts +3 -0
  318. package/src/agent/guards.ts +4 -0
  319. package/src/agent/idle-compaction.ts +174 -0
  320. package/src/agent/index.ts +74 -16
  321. package/src/agent/live-subagents.ts +19 -0
  322. package/src/agent/multimodal/look-at.ts +22 -9
  323. package/src/agent/plugin-tools.ts +13 -1
  324. package/src/agent/reviewer-bash-policy.ts +41 -1
  325. package/src/agent/session-origin.ts +26 -10
  326. package/src/agent/subagent-cache-keepalive.ts +198 -0
  327. package/src/agent/subagent-session.ts +6 -0
  328. package/src/agent/subagents.ts +46 -8
  329. package/src/agent/system-prompt.ts +1 -1
  330. package/src/agent/tool-file-safety.ts +6 -1
  331. package/src/agent/tools/channel-edit.ts +20 -10
  332. package/src/agent/tools/channel-fetch-attachment.ts +12 -5
  333. package/src/agent/tools/channel-handoff.ts +72 -0
  334. package/src/agent/tools/channel-read.ts +57 -10
  335. package/src/agent/tools/channel-reply.ts +33 -26
  336. package/src/agent/tools/channel-send.ts +21 -13
  337. package/src/agent/tools/channel-session-search.ts +35 -0
  338. package/src/agent/tools/curl-impersonate.ts +11 -4
  339. package/src/agent/tools/ddg.ts +13 -5
  340. package/src/agent/tools/spawn-subagent.ts +27 -11
  341. package/src/agent/tools/stream-snapshot.ts +15 -2
  342. package/src/agent/tools/subagent-access.ts +11 -4
  343. package/src/browser/bsk-shim.mjs +74 -0
  344. package/src/browser/dockerfile.ts +84 -0
  345. package/src/browser/egress.ts +104 -0
  346. package/src/browser/managed-browser.ts +205 -0
  347. package/src/browser/registry.ts +110 -0
  348. package/src/browser/relay.ts +231 -0
  349. package/src/browser/sandbox-entry.ts +167 -0
  350. package/src/bundled-plugins/agent-browser/index.ts +2 -0
  351. package/src/bundled-plugins/browser-agent/browser-agent.ts +89 -0
  352. package/src/bundled-plugins/browser-agent/index.ts +12 -0
  353. package/src/bundled-plugins/doc-render/index.ts +0 -10
  354. package/src/bundled-plugins/doc-render/render.ts +83 -111
  355. package/src/bundled-plugins/doc-render/skills/typeclaw-render-pdf/SKILL.md +152 -257
  356. package/src/bundled-plugins/github-cli-auth/gh-command.ts +4 -0
  357. package/src/bundled-plugins/github-cli-auth/git-auth-diagnostic.ts +95 -0
  358. package/src/bundled-plugins/github-cli-auth/index.ts +75 -59
  359. package/src/bundled-plugins/managed-browser/index.ts +74 -0
  360. package/src/bundled-plugins/managed-browser/skills/browser-use/browser-use/SKILL.md +27 -0
  361. package/src/bundled-plugins/managed-browser/skills/browserskill/browserskill/SKILL.md +28 -0
  362. package/src/bundled-plugins/managed-browser/skills/omowright/omowright/SKILL.md +40 -0
  363. package/src/bundled-plugins/operator/operator.ts +1 -1
  364. package/src/bundled-plugins/qa/index.ts +11 -0
  365. package/src/bundled-plugins/qa/qa.ts +160 -0
  366. package/src/bundled-plugins/qa/skills/qa-cli.ts +50 -0
  367. package/src/bundled-plugins/qa/skills/qa-general.ts +30 -0
  368. package/src/bundled-plugins/qa/skills/qa-http.ts +39 -0
  369. package/src/bundled-plugins/qa/skills/qa-pr.ts +51 -0
  370. package/src/bundled-plugins/qa/skills/qa-web.ts +49 -0
  371. package/src/bundled-plugins/security/index.ts +53 -34
  372. package/src/bundled-plugins/security/policies/outbound-secret-scan.ts +1 -0
  373. package/src/channels/adapter-namespace.ts +13 -0
  374. package/src/channels/adapters/discord-bot.ts +97 -5
  375. package/src/channels/adapters/github/index.ts +16 -0
  376. package/src/channels/adapters/github/last-alive.ts +4 -16
  377. package/src/channels/adapters/slack-attachment-download.ts +14 -3
  378. package/src/channels/adapters/slack-bot-author-resolver.ts +4 -3
  379. package/src/channels/adapters/slack-bot-channel-resolver.ts +9 -6
  380. package/src/channels/adapters/slack-bot-classify.ts +1 -0
  381. package/src/channels/adapters/slack-bot-slash-commands.ts +3 -1
  382. package/src/channels/adapters/slack-bot.ts +299 -67
  383. package/src/channels/adapters/slack-classify.ts +1 -0
  384. package/src/channels/catch-up.ts +137 -0
  385. package/src/channels/continuation-willingness.ts +2 -2
  386. package/src/channels/continuity-types.ts +1 -0
  387. package/src/channels/engagement.ts +17 -1
  388. package/src/channels/github-false-receipt.ts +3 -3
  389. package/src/channels/github-rereview-guard.ts +9 -5
  390. package/src/channels/github-token-bridge.ts +24 -0
  391. package/src/channels/last-alive.ts +34 -0
  392. package/src/channels/manager.ts +8 -1
  393. package/src/channels/router.ts +427 -136
  394. package/src/channels/session-handoff.fixture.ts +144 -0
  395. package/src/channels/session-handoff.ts +175 -0
  396. package/src/channels/session-search.ts +71 -0
  397. package/src/channels/types.ts +12 -2
  398. package/src/cli/channel.ts +2 -3
  399. package/src/cli/init.ts +2 -3
  400. package/src/cli/model.ts +132 -3
  401. package/src/coding-agent/index.ts +7 -1
  402. package/src/coding-agent/omo-stream.ts +40 -0
  403. package/src/coding-agent/runner.ts +30 -8
  404. package/src/config/config.ts +111 -22
  405. package/src/config/model-overrides.ts +59 -0
  406. package/src/config/models-mutation.ts +185 -2
  407. package/src/config/providers-mutation.ts +12 -4
  408. package/src/config/providers.ts +59 -0
  409. package/src/container/start.ts +95 -4
  410. package/src/doctor/checks.ts +8 -6
  411. package/src/hostd/daemon.ts +13 -1
  412. package/src/init/auto-upgrade.ts +7 -1
  413. package/src/init/dockerfile.ts +57 -12
  414. package/src/init/index.ts +4 -3
  415. package/src/init/local-source-stamp.ts +68 -0
  416. package/src/init/models-dev.ts +4 -0
  417. package/src/init/validate-api-key.ts +3 -0
  418. package/src/permissions/builtins.ts +7 -0
  419. package/src/permissions/permissions.ts +18 -9
  420. package/src/permissions/resolve.ts +7 -1
  421. package/src/plugin/context.ts +2 -0
  422. package/src/plugin/hooks.ts +137 -0
  423. package/src/plugin/index.ts +6 -0
  424. package/src/plugin/manager.ts +4 -0
  425. package/src/plugin/types.ts +60 -0
  426. package/src/run/bundled-plugins.ts +6 -0
  427. package/src/run/index.ts +24 -14
  428. package/src/run/llm-fetch-observer.ts +12 -15
  429. package/src/sandbox/canonical-secrets.ts +4 -0
  430. package/src/sandbox/dev-source.ts +26 -0
  431. package/src/sandbox/hidden-paths.ts +16 -2
  432. package/src/secrets/storage.ts +13 -0
  433. package/src/skills/typeclaw-channel-github/SKILL.md +8 -8
  434. package/src/skills/typeclaw-config/SKILL.md +39 -5
  435. package/src/skills/typeclaw-config/references/dockerfile.md +2 -2
  436. package/src/skills/typeclaw-github-contributing/SKILL.md +1 -1
  437. package/src/skills/typeclaw-monorepo/SKILL.md +1 -1
  438. package/src/skills/typeclaw-permissions/SKILL.md +7 -7
  439. package/src/skills/typeclaw-troubleshooting/SKILL.md +12 -1
  440. package/typeclaw.schema.json +436 -5
  441. package/src/bundled-plugins/doc-render/templates/lib.typ +0 -339
  442. package/src/bundled-plugins/github-cli-auth/gh-store.ts +0 -733
@@ -0,0 +1,25 @@
1
+ import { type ModelRef } from "../config/providers.js";
2
+ export declare const THROTTLE_THRESHOLD = 2;
3
+ export declare const THROTTLE_WINDOW_MS = 60000;
4
+ export declare const COOLDOWN_MS = 180000;
5
+ export type ThrottleCircuitKey = {
6
+ profile?: string;
7
+ ref: ModelRef;
8
+ };
9
+ export declare class ThrottleCircuit {
10
+ private readonly entries;
11
+ private readonly now;
12
+ constructor(opts?: {
13
+ now?: () => number;
14
+ });
15
+ isOpen(key: ThrottleCircuitKey): boolean;
16
+ isProviderOpen(key: ThrottleCircuitKey): boolean;
17
+ recordThrottle(key: ThrottleCircuitKey): void;
18
+ recordProviderTrip(key: ThrottleCircuitKey): void;
19
+ recordSuccess(key: ThrottleCircuitKey): void;
20
+ private isEntryOpen;
21
+ private recordFailure;
22
+ private providerKeyId;
23
+ private keyId;
24
+ }
25
+ export declare const modelThrottleCircuit: ThrottleCircuit;
@@ -0,0 +1,54 @@
1
+ import { type Todo } from "./store.js";
2
+ export declare const DEFAULT_MAX_AUTO_TURNS = 3;
3
+ export declare const DEFAULT_MAX_CUMULATIVE_TOKENS = 25000;
4
+ export declare const DEFAULT_MAX_WALL_CLOCK_MS: number;
5
+ export declare const DEFAULT_STAGNATION_LIMIT = 2;
6
+ export type ContinuationLimits = {
7
+ maxAutoTurns: number;
8
+ maxCumulativeTokens: number;
9
+ maxWallClockMs: number;
10
+ stagnationLimit: number;
11
+ };
12
+ export declare const DEFAULT_CONTINUATION_LIMITS: ContinuationLimits;
13
+ export type ContinuationEpisode = {
14
+ episodeId: string;
15
+ startedAt: number;
16
+ autoTurnCount: number;
17
+ cumulativeTokens: number;
18
+ failureCount: number;
19
+ stagnationCount: number;
20
+ lastIncompleteHash: string | null;
21
+ };
22
+ export type TurnOutcome = {
23
+ turnId: string;
24
+ stopReason: 'stop' | 'length' | 'aborted' | 'error' | 'unknown';
25
+ termination?: 'terminal-after-channel-reply';
26
+ endedAt: number;
27
+ tokens?: number;
28
+ };
29
+ export type ContinuationState = {
30
+ episode: ContinuationEpisode | null;
31
+ lastTurnOutcome: TurnOutcome | null;
32
+ suppressNextIdleNudgeReason: 'restart-kick' | null;
33
+ autoResumeBlockedUntilRealUserTurn: boolean;
34
+ restartAbortPending: boolean;
35
+ };
36
+ export declare function emptyContinuationState(): ContinuationState;
37
+ export declare function parseContinuationState(value: unknown): ContinuationState;
38
+ export declare function hashIncomplete(todos: readonly Todo[]): string;
39
+ export declare function hasRealProgress(prev: readonly Todo[], next: readonly Todo[]): boolean;
40
+ export type ContinuationDecision = {
41
+ kind: 'inject';
42
+ episode: ContinuationEpisode;
43
+ } | {
44
+ kind: 'skip';
45
+ reason: ContinuationSkipReason;
46
+ };
47
+ export type ContinuationSkipReason = 'no-incomplete-todos' | 'restart-kick-suppressed' | 'user-abort-blocked' | 'turn-not-safe' | 'max-auto-turns' | 'max-tokens' | 'max-wall-clock' | 'stagnation';
48
+ export declare function decideContinuation(args: {
49
+ state: ContinuationState;
50
+ todos: readonly Todo[];
51
+ limits: ContinuationLimits;
52
+ now: number;
53
+ newEpisodeId: () => string;
54
+ }): ContinuationDecision;
@@ -0,0 +1,11 @@
1
+ import { type ContinuationState, type TurnOutcome } from "./continuation-policy.js";
2
+ import type { TodoScope } from "./scope.js";
3
+ export declare function continuationStatePath(agentDir: string, scope: TodoScope): string;
4
+ export declare function readContinuationState(agentDir: string, scope: TodoScope): Promise<ContinuationState>;
5
+ export declare function writeContinuationState(agentDir: string, scope: TodoScope, state: ContinuationState): Promise<void>;
6
+ export declare function onTurnStart(state: ContinuationState, isRealUserTurn: boolean): ContinuationState;
7
+ export declare function onTurnOutcome(state: ContinuationState, outcome: TurnOutcome): ContinuationState;
8
+ export declare function markRestartAbortPending(state: ContinuationState): ContinuationState;
9
+ export declare function armRestartKickSuppression(state: ContinuationState): ContinuationState;
10
+ export declare function clearAbortSuppression(state: ContinuationState): ContinuationState;
11
+ export declare function consumeRestartKickSuppression(state: ContinuationState): ContinuationState;
@@ -0,0 +1,32 @@
1
+ import type { SessionOrigin } from "../session-origin.js";
2
+ import { type TurnOutcome } from "./continuation-policy.js";
3
+ export declare function classifyStopReason(raw: unknown): TurnOutcome['stopReason'];
4
+ export declare function extractTurnUsage(event: unknown): {
5
+ stopReason: TurnOutcome['stopReason'];
6
+ tokens?: number;
7
+ } | null;
8
+ export declare function extractStopReason(event: unknown): TurnOutcome['stopReason'] | null;
9
+ export declare function recordTurnOutcome(args: {
10
+ agentDir: string;
11
+ origin: SessionOrigin;
12
+ turnId: string;
13
+ stopReason: TurnOutcome['stopReason'];
14
+ termination?: TurnOutcome['termination'];
15
+ tokens?: number;
16
+ now?: number;
17
+ }): Promise<void>;
18
+ export declare function recordTurnStart(args: {
19
+ agentDir: string;
20
+ origin: SessionOrigin;
21
+ isRealUserTurn: boolean;
22
+ }): Promise<void>;
23
+ export declare function armRestartKickForOrigin(agentDir: string, origin: SessionOrigin): Promise<void>;
24
+ export declare function markRestartAbortPendingForOrigin(agentDir: string, origin: SessionOrigin): Promise<void>;
25
+ export declare function clearAbortSuppressionForOrigin(agentDir: string, origin: SessionOrigin): Promise<void>;
26
+ export declare function clearTodosForOrigin(agentDir: string, origin: SessionOrigin): Promise<void>;
27
+ export type DeliverContinuation = (text: string) => void;
28
+ export declare function runIdleContinuation(args: {
29
+ agentDir: string;
30
+ origin: SessionOrigin;
31
+ deliver: DeliverContinuation;
32
+ }): Promise<boolean>;
@@ -0,0 +1,21 @@
1
+ import type { SessionOrigin } from "../session-origin.js";
2
+ import { type ContinuationLimits } from "./continuation-policy.js";
3
+ import { type TodoScope } from "./scope.js";
4
+ export declare const TODO_CONTINUATION_SOURCE = "todo-continuation";
5
+ export declare const CONTINUATION_PROMPT: string;
6
+ export type ContinuationInjectResult = {
7
+ kind: 'injected';
8
+ scope: TodoScope;
9
+ text: string;
10
+ } | {
11
+ kind: 'skipped';
12
+ reason: string;
13
+ };
14
+ export type MaybeInjectContinuationArgs = {
15
+ agentDir: string;
16
+ origin: SessionOrigin | undefined;
17
+ now?: number;
18
+ limits?: ContinuationLimits;
19
+ newEpisodeId?: () => string;
20
+ };
21
+ export declare function maybeInjectContinuation(args: MaybeInjectContinuationArgs): Promise<ContinuationInjectResult>;
@@ -0,0 +1,6 @@
1
+ import type { SessionOrigin } from "../session-origin.js";
2
+ export type TodoScope = {
3
+ kind: 'tui' | 'channel' | 'cron';
4
+ key: string;
5
+ };
6
+ export declare function resolveTodoScope(origin: SessionOrigin): TodoScope | null;
@@ -0,0 +1,16 @@
1
+ import type { TodoScope } from "./scope.js";
2
+ export declare const TODO_STATUSES: readonly ["pending", "in_progress", "completed", "cancelled"];
3
+ export type TodoStatus = (typeof TODO_STATUSES)[number];
4
+ export declare const TODO_PRIORITIES: readonly ["high", "medium", "low"];
5
+ export type TodoPriority = (typeof TODO_PRIORITIES)[number];
6
+ export type Todo = {
7
+ content: string;
8
+ status: TodoStatus;
9
+ priority?: TodoPriority;
10
+ id?: string;
11
+ };
12
+ export declare function todoDir(agentDir: string): string;
13
+ export declare function todoContentPath(agentDir: string, scope: TodoScope): string;
14
+ export declare function readTodos(agentDir: string, scope: TodoScope): Promise<Todo[]>;
15
+ export declare function writeTodos(agentDir: string, scope: TodoScope, todos: Todo[]): Promise<void>;
16
+ export declare function incompleteTodos(todos: readonly Todo[]): Todo[];
@@ -0,0 +1 @@
1
+ export declare function remediateToolErrorMessage(toolName: string, message: string): string;
@@ -0,0 +1,78 @@
1
+ import { type FileHandle } from 'node:fs/promises';
2
+ import type { ToolFileOperands, ToolLogger, ToolProvenance, ToolResult } from "../plugin/index.js";
3
+ import type { HiddenPaths } from "../sandbox/hidden-paths.js";
4
+ import { TOOLS_WITHOUT_LOCAL_FILE_OPERANDS } from "./tools-without-local-file-operands.js";
5
+ export { TOOLS_WITHOUT_LOCAL_FILE_OPERANDS };
6
+ export declare const TOOL_INPUT_MAX_BYTES: {
7
+ readonly read: number;
8
+ readonly look_at: number;
9
+ readonly channel_upload: number;
10
+ };
11
+ export declare const TOOL_INPUT_MAX_COUNT: {
12
+ readonly read: 1;
13
+ readonly look_at: 16;
14
+ readonly channel_upload: 32;
15
+ };
16
+ export declare const PINNED_SNAPSHOT_GLOBAL_MAX_BYTES: number;
17
+ export declare const PINNED_SNAPSHOT_GLOBAL_MAX_COUNT: 32;
18
+ export declare const PINNED_SNAPSHOT_MAX_WAITERS = 32;
19
+ export declare const TREE_SNAPSHOT_MAX_ENTRIES = 4096;
20
+ export declare const TOOL_INPUT_TEMP_PREFIX = "typeclaw-tool-input-";
21
+ export type PinnedToolFiles = {
22
+ restoreResult(result: ToolResult): ToolResult;
23
+ cleanup(): Promise<void>;
24
+ };
25
+ export type EnforceAndPinToolFilesHooks = {
26
+ afterBudgetAcquire?(): void | Promise<void>;
27
+ pinnedSnapshotBudgetForTests?: ReturnType<typeof createPinnedSnapshotBudgetForTests>;
28
+ };
29
+ export declare function enforceAndPinToolFiles(options: {
30
+ tool: string;
31
+ args: Record<string, unknown>;
32
+ agentDir: string;
33
+ tempRoot?: string;
34
+ genericInputs?: boolean;
35
+ fileOperands?: ToolFileOperands;
36
+ hidden?: HiddenPaths;
37
+ logger?: Pick<ToolLogger, 'warn'>;
38
+ signal?: AbortSignal;
39
+ toolProvenance?: ToolProvenance;
40
+ }, hooks?: EnforceAndPinToolFilesHooks): Promise<PinnedToolFiles>;
41
+ export declare function enforceCanonicalSecretDenial(options: {
42
+ tool: string;
43
+ args: Record<string, unknown>;
44
+ agentDir: string;
45
+ toolProvenance?: ToolProvenance;
46
+ }): void;
47
+ export declare function writeFileAnchored(options: {
48
+ targetPath: string;
49
+ data: Uint8Array;
50
+ agentDir: string;
51
+ tool: string;
52
+ }): Promise<void>;
53
+ export declare function writeToolOutputNoFollow(targetPath: string, content: string): Promise<void>;
54
+ export declare function createAndOpenAnchoredDirectory(absolute: string, createMissing?: boolean): Promise<FileHandle>;
55
+ type BudgetLease = {
56
+ resize(bytes: number, count: number): boolean;
57
+ release(): void;
58
+ };
59
+ declare class PinnedSnapshotBudget {
60
+ private readonly limits;
61
+ private readonly onWait?;
62
+ private bytes;
63
+ private count;
64
+ private readonly queue;
65
+ constructor(limits: {
66
+ maxBytes: number;
67
+ maxCount: number;
68
+ maxWaiters: number;
69
+ }, onWait?: (() => void) | undefined);
70
+ acquire(bytes: number, count: number, signal?: AbortSignal): Promise<BudgetLease>;
71
+ private drain;
72
+ }
73
+ export declare function createPinnedSnapshotBudgetForTests(options: {
74
+ maxBytes: number;
75
+ maxCount: number;
76
+ maxWaiters: number;
77
+ onWait?: () => void;
78
+ }): PinnedSnapshotBudget;
@@ -0,0 +1,9 @@
1
+ export type NudgeableSession = {
2
+ subscribe: (listener: (event: unknown) => void) => () => void;
3
+ steer: (text: string) => Promise<unknown>;
4
+ };
5
+ export declare function extractNotFoundToolName(resultText: string): string | null;
6
+ export declare function closestToolName(requested: string, known: readonly string[]): string | null;
7
+ export declare function renderToolNotFoundNudge(requested: string, suggestion: string): string;
8
+ export declare function buildToolNotFoundNudge(resultText: string, known: readonly string[]): string | null;
9
+ export declare function attachToolNotFoundNudge(session: NudgeableSession, knownToolNames: readonly string[]): () => void;
@@ -0,0 +1,15 @@
1
+ import type { AgentTool } from '@earendil-works/pi-agent-core';
2
+ import type { ToolDefinition } from '@earendil-works/pi-coding-agent';
3
+ import type { TSchema } from 'typebox';
4
+ export type ToolResultBudget = {
5
+ maxTotalBytes: number;
6
+ toolNames: readonly string[];
7
+ exhaustedMessage?: (used: number, max: number) => string;
8
+ };
9
+ export type BudgetState = {
10
+ used: number;
11
+ exhausted: boolean;
12
+ };
13
+ export declare function createBudgetState(): BudgetState;
14
+ export declare function wrapAgentToolWithBudget<TParams extends TSchema, TDetails = unknown>(tool: AgentTool<TParams, TDetails>, budget: ToolResultBudget, state: BudgetState): AgentTool<TParams, TDetails>;
15
+ export declare function wrapToolDefinitionWithBudget<TParams extends TSchema, TDetails = unknown, TState = unknown>(tool: ToolDefinition<TParams, TDetails, TState>, budget: ToolResultBudget, state: BudgetState): ToolDefinition<TParams, TDetails, TState>;
@@ -0,0 +1,18 @@
1
+ import { Type } from '@earendil-works/pi-ai';
2
+ import type { ChannelRouter } from "../../channels/router.js";
3
+ import type { AdapterId } from "../../channels/schema.js";
4
+ export type ChannelDisengageOrigin = {
5
+ adapter: AdapterId;
6
+ workspace: string;
7
+ chat: string;
8
+ thread: string | null;
9
+ };
10
+ export type CreateChannelDisengageToolOptions = {
11
+ router: ChannelRouter;
12
+ origin: ChannelDisengageOrigin;
13
+ };
14
+ export type ChannelDisengageDetails = {
15
+ ok: boolean;
16
+ cleared: number;
17
+ };
18
+ export declare function createChannelDisengageTool({ router, origin }: CreateChannelDisengageToolOptions): import("@earendil-works/pi-coding-agent").ToolDefinition<Type.TObject<{}>, ChannelDisengageDetails, any> & import("@earendil-works/pi-coding-agent").ToolDefinition<any, any, any>;
@@ -0,0 +1,19 @@
1
+ import { Type } from '@earendil-works/pi-ai';
2
+ import { type ChannelRouter } from "../../channels/router.js";
3
+ import type { ChannelOutboundOrigin } from "../../plugin/index.js";
4
+ import { type ChannelToolLogger } from "./channel-log.js";
5
+ export type CreateChannelEditToolOptions = {
6
+ router: ChannelRouter;
7
+ getOutboundOrigin?: () => ChannelOutboundOrigin | undefined;
8
+ logger?: ChannelToolLogger;
9
+ };
10
+ export declare function createChannelEditTool({ router, getOutboundOrigin, logger, }: CreateChannelEditToolOptions): import("@earendil-works/pi-coding-agent").ToolDefinition<Type.TObject<{
11
+ adapter: Type.TUnion<Type.TLiteral<"discord" | "discord-bot" | "github" | "instagram" | "line" | "kakaotalk" | "slack" | "slack-bot" | "teams" | "telegram-bot" | "webex" | "webex-bot">[]>;
12
+ workspace: Type.TString;
13
+ chat: Type.TString;
14
+ thread: Type.TOptional<Type.TString>;
15
+ message_id: Type.TString;
16
+ text: Type.TString;
17
+ }>, {
18
+ ok: boolean;
19
+ }, any> & import("@earendil-works/pi-coding-agent").ToolDefinition<any, any, any>;
@@ -0,0 +1,36 @@
1
+ import { Type } from '@earendil-works/pi-ai';
2
+ import type { SessionOrigin } from "../session-origin.js";
3
+ import type { ChannelRouter } from "../../channels/router.js";
4
+ import type { AdapterId } from "../../channels/schema.js";
5
+ import type { PermissionService } from "../../permissions/index.js";
6
+ import { type ChannelToolLogger } from "./channel-log.js";
7
+ export type ChannelFetchAttachmentOrigin = {
8
+ adapter: AdapterId;
9
+ workspace: string;
10
+ chat: string;
11
+ thread: string | null;
12
+ };
13
+ type FetchAttachmentDetails = {
14
+ ok: boolean;
15
+ error?: string;
16
+ path?: string;
17
+ mimetype?: string;
18
+ size?: number;
19
+ };
20
+ export type CreateChannelFetchAttachmentToolOptions = {
21
+ router: ChannelRouter;
22
+ origin: ChannelFetchAttachmentOrigin;
23
+ inboxDir?: string;
24
+ resolveBaseDir?: () => string;
25
+ logger?: ChannelToolLogger;
26
+ agentDir?: string;
27
+ };
28
+ export declare const DEFAULT_INBOX_DIR = "/agent/workspace/inbox";
29
+ export declare const PUBLIC_INBOX_DIR = "/agent/public/inbox";
30
+ export declare function createChannelFetchAttachmentTool({ router, origin, inboxDir, resolveBaseDir, logger, agentDir, }: CreateChannelFetchAttachmentToolOptions): import("@earendil-works/pi-coding-agent").ToolDefinition<Type.TObject<{
31
+ attachment_id: Type.TInteger;
32
+ file_id: Type.TOptional<Type.TString>;
33
+ filename: Type.TOptional<Type.TString>;
34
+ }>, FetchAttachmentDetails, any> & import("@earendil-works/pi-coding-agent").ToolDefinition<any, any, any>;
35
+ export declare function resolveInboxBaseDir(permissions: PermissionService, origin: SessionOrigin | undefined, agentDir: string): string;
36
+ export {};
@@ -0,0 +1,13 @@
1
+ import { Type } from '@earendil-works/pi-ai';
2
+ import type { ChannelHandoffResult, ChannelRouter } from "../../channels/router.js";
3
+ export type CreateChannelHandoffToolOptions = {
4
+ router: Pick<ChannelRouter, 'handoff'>;
5
+ sessionId: string;
6
+ };
7
+ export declare function createChannelHandoffTool({ router, sessionId }: CreateChannelHandoffToolOptions): import("@earendil-works/pi-coding-agent").ToolDefinition<Type.TObject<{
8
+ adapter: Type.TUnion<Type.TLiteral<"discord" | "discord-bot" | "github" | "instagram" | "line" | "kakaotalk" | "slack" | "slack-bot" | "teams" | "telegram-bot" | "webex" | "webex-bot">[]>;
9
+ workspace: Type.TString;
10
+ chat: Type.TString;
11
+ thread: Type.TOptional<Type.TString>;
12
+ text: Type.TString;
13
+ }>, ChannelHandoffResult, any> & import("@earendil-works/pi-coding-agent").ToolDefinition<any, any, any>;
@@ -0,0 +1,3 @@
1
+ import type { ChannelHistoryMessage } from "../../channels/types.js";
2
+ export declare function renderHistoryMessages(messages: readonly ChannelHistoryMessage[]): string;
3
+ export declare function renderHistoryMessage(m: ChannelHistoryMessage): string;
@@ -0,0 +1,25 @@
1
+ import { Type } from '@earendil-works/pi-ai';
2
+ import type { ChannelRouter } from "../../channels/router.js";
3
+ import type { AdapterId } from "../../channels/schema.js";
4
+ import { type ChannelToolLogger } from "./channel-log.js";
5
+ export type ChannelHistoryOrigin = {
6
+ adapter: AdapterId;
7
+ workspace: string;
8
+ chat: string;
9
+ thread: string | null;
10
+ };
11
+ export type CreateChannelHistoryToolOptions = {
12
+ router: ChannelRouter;
13
+ origin: ChannelHistoryOrigin;
14
+ logger?: ChannelToolLogger;
15
+ };
16
+ export declare function createChannelHistoryTool({ router, origin, logger, }: CreateChannelHistoryToolOptions): import("@earendil-works/pi-coding-agent").ToolDefinition<Type.TObject<{
17
+ limit: Type.TOptional<Type.TNumber>;
18
+ cursor: Type.TOptional<Type.TString>;
19
+ scope: Type.TOptional<Type.TUnion<[Type.TLiteral<"thread">, Type.TLiteral<"channel">]>>;
20
+ }>, {
21
+ ok: boolean;
22
+ error?: string;
23
+ count?: number;
24
+ nextCursor?: string;
25
+ }, any> & import("@earendil-works/pi-coding-agent").ToolDefinition<any, any, any>;
@@ -0,0 +1,5 @@
1
+ export type ChannelToolLogger = {
2
+ warn: (msg: string) => void;
3
+ };
4
+ export declare const consoleChannelLogger: ChannelToolLogger;
5
+ export declare function formatChannelToolFailure(tool: string, error: string): string;
@@ -0,0 +1,23 @@
1
+ import { Type } from '@earendil-works/pi-ai';
2
+ import type { ChannelRouter } from "../../channels/router.js";
3
+ import type { AdapterId } from "../../channels/schema.js";
4
+ import type { ReactionRef } from "../../channels/types.js";
5
+ import { type ChannelToolLogger } from "./channel-log.js";
6
+ export type ChannelReactOrigin = {
7
+ adapter: AdapterId;
8
+ workspace: string;
9
+ chat: string;
10
+ thread: string | null;
11
+ };
12
+ export type CreateChannelReactToolOptions = {
13
+ router: ChannelRouter;
14
+ origin: ChannelReactOrigin;
15
+ getReactionRef: () => ReactionRef | undefined;
16
+ logger?: ChannelToolLogger;
17
+ };
18
+ export declare function createChannelReactTool({ router, origin, getReactionRef, logger, }: CreateChannelReactToolOptions): import("@earendil-works/pi-coding-agent").ToolDefinition<Type.TObject<{
19
+ emoji: Type.TString;
20
+ }>, {
21
+ ok: boolean;
22
+ error?: string;
23
+ }, any> & import("@earendil-works/pi-coding-agent").ToolDefinition<any, any, any>;
@@ -0,0 +1,27 @@
1
+ import { Type } from '@earendil-works/pi-ai';
2
+ import type { ChannelRouter } from "../../channels/router.js";
3
+ import type { ChannelKey } from "../../channels/types.js";
4
+ import { type ChannelToolLogger } from "./channel-log.js";
5
+ export type CreateChannelReadToolOptions = {
6
+ router: ChannelRouter;
7
+ logger?: ChannelToolLogger;
8
+ sessionId?: string;
9
+ };
10
+ export declare function createChannelReadTool({ router, logger, sessionId, }: CreateChannelReadToolOptions): import("@earendil-works/pi-coding-agent").ToolDefinition<Type.TObject<{
11
+ mode: Type.TUnion<[Type.TLiteral<"history">, Type.TLiteral<"message">, Type.TLiteral<"list">]>;
12
+ adapter: Type.TUnion<Type.TLiteral<"discord" | "discord-bot" | "github" | "instagram" | "line" | "kakaotalk" | "slack" | "slack-bot" | "teams" | "telegram-bot" | "webex" | "webex-bot">[]>;
13
+ workspace: Type.TString;
14
+ chat: Type.TOptional<Type.TString>;
15
+ thread: Type.TOptional<Type.TString>;
16
+ message_id: Type.TOptional<Type.TString>;
17
+ limit: Type.TOptional<Type.TNumber>;
18
+ cursor: Type.TOptional<Type.TString>;
19
+ }>, Details, any> & import("@earendil-works/pi-coding-agent").ToolDefinition<any, any, any>;
20
+ type Details = {
21
+ ok: boolean;
22
+ error?: string;
23
+ count?: number;
24
+ nextCursor?: string;
25
+ handoffTargets?: readonly ChannelKey[];
26
+ };
27
+ export {};
@@ -0,0 +1,47 @@
1
+ import { Type } from '@earendil-works/pi-ai';
2
+ import type { BackgroundObligationRef } from "../../channels/background-obligations.js";
3
+ import type { InboundRef } from "../../channels/inbound-journal.js";
4
+ import { type ChannelRouter } from "../../channels/router.js";
5
+ import type { AdapterId } from "../../channels/schema.js";
6
+ import type { GithubReviewFollowupRound } from "../../channels/types.js";
7
+ import type { ChannelOutboundOrigin } from "../../plugin/index.js";
8
+ import { type ChannelToolLogger } from "./channel-log.js";
9
+ export type ChannelReplyOrigin = {
10
+ adapter: AdapterId;
11
+ workspace: string;
12
+ chat: string;
13
+ thread: string | null;
14
+ githubReviewRound?: GithubReviewFollowupRound;
15
+ };
16
+ export type CreateChannelReplyToolOptions = {
17
+ router: ChannelRouter;
18
+ origin: ChannelReplyOrigin;
19
+ getOutboundOrigin?: () => ChannelOutboundOrigin | undefined;
20
+ sessionId?: string;
21
+ logger?: ChannelToolLogger;
22
+ };
23
+ export declare function createChannelReplyTool({ router, origin, getOutboundOrigin, sessionId, logger, }: CreateChannelReplyToolOptions): import("@earendil-works/pi-coding-agent").ToolDefinition<Type.TObject<{
24
+ text: Type.TOptional<Type.TString>;
25
+ link_previews: Type.TOptional<Type.TBoolean>;
26
+ attachments: Type.TOptional<Type.TArray<Type.TObject<{
27
+ path: Type.TString;
28
+ filename: Type.TOptional<Type.TString>;
29
+ }>>>;
30
+ continue_after_reply: Type.TBoolean;
31
+ resolve_review_thread: Type.TOptional<Type.TBoolean>;
32
+ }>, {
33
+ ok: boolean;
34
+ error?: string;
35
+ continue_after_reply?: boolean;
36
+ messageId?: string;
37
+ messageIds?: readonly string[];
38
+ backgroundCoverage?: BackgroundObligationRef[];
39
+ inboundCoverage?: InboundRef[];
40
+ }, any> & import("@earendil-works/pi-coding-agent").ToolDefinition<any, any, any>;
41
+ export declare const TOOL_RESULT_PREFIX = "[system: tool result, not a user message] ";
42
+ export declare const ECHO_MAX_CHARS = 500;
43
+ export declare function renderEcho(text: string): string;
44
+ export declare function renderOutboundEcho(text: string | undefined, attachments: ReadonlyArray<{
45
+ path: string;
46
+ filename?: string;
47
+ }> | undefined): string;
@@ -0,0 +1,42 @@
1
+ import { Type } from '@earendil-works/pi-ai';
2
+ import type { BackgroundObligationRef } from "../../channels/background-obligations.js";
3
+ import type { InboundRef } from "../../channels/inbound-journal.js";
4
+ import { type ChannelRouter } from "../../channels/router.js";
5
+ import { type AdapterId } from "../../channels/schema.js";
6
+ import type { GithubReviewFollowupRound } from "../../channels/types.js";
7
+ import type { ChannelOutboundOrigin } from "../../plugin/index.js";
8
+ import { type ChannelToolLogger } from "./channel-log.js";
9
+ export type ChannelSendOrigin = {
10
+ adapter: AdapterId;
11
+ workspace: string;
12
+ chat: string;
13
+ thread: string | null;
14
+ githubReviewRound?: GithubReviewFollowupRound;
15
+ };
16
+ export type CreateChannelSendToolOptions = {
17
+ router: ChannelRouter;
18
+ origin?: ChannelSendOrigin;
19
+ getOutboundOrigin?: () => ChannelOutboundOrigin | undefined;
20
+ sessionId?: string;
21
+ logger?: ChannelToolLogger;
22
+ };
23
+ export declare function createChannelSendTool({ router, origin, getOutboundOrigin, sessionId, logger, }: CreateChannelSendToolOptions): import("@earendil-works/pi-coding-agent").ToolDefinition<Type.TObject<{
24
+ adapter: Type.TUnion<Type.TLiteral<"discord" | "discord-bot" | "github" | "instagram" | "line" | "kakaotalk" | "slack" | "slack-bot" | "teams" | "telegram-bot" | "webex" | "webex-bot">[]>;
25
+ workspace: Type.TString;
26
+ chat: Type.TString;
27
+ thread: Type.TOptional<Type.TString>;
28
+ text: Type.TOptional<Type.TString>;
29
+ link_previews: Type.TOptional<Type.TBoolean>;
30
+ attachments: Type.TOptional<Type.TArray<Type.TObject<{
31
+ path: Type.TString;
32
+ filename: Type.TOptional<Type.TString>;
33
+ }>>>;
34
+ resolve_review_thread: Type.TOptional<Type.TBoolean>;
35
+ }>, {
36
+ ok: boolean;
37
+ error?: string;
38
+ messageId?: string;
39
+ messageIds?: readonly string[];
40
+ backgroundCoverage?: BackgroundObligationRef[];
41
+ inboundCoverage?: InboundRef[];
42
+ }, any> & import("@earendil-works/pi-coding-agent").ToolDefinition<any, any, any>;
@@ -0,0 +1,10 @@
1
+ import { Type } from '@earendil-works/pi-ai';
2
+ import type { ChannelRouter } from "../../channels/router.js";
3
+ export declare function createChannelSessionSearchTool(options: {
4
+ router: Pick<ChannelRouter, 'searchSessions'>;
5
+ sessionId: string;
6
+ }): import("@earendil-works/pi-coding-agent").ToolDefinition<Type.TObject<{
7
+ query: Type.TString;
8
+ }>, {
9
+ targets: import("../../channels/session-search").SessionSearchTarget[];
10
+ }, any> & import("@earendil-works/pi-coding-agent").ToolDefinition<any, any, any>;
@@ -0,0 +1,37 @@
1
+ export declare const CURL_IMPERSONATE_BINARY = "curl_chrome136";
2
+ export declare const DEFAULT_TIMEOUT_SECONDS = 30;
3
+ export declare function _setCurlBinaryForTest(binary: string | null): void;
4
+ export type CurlImpersonateRequest = {
5
+ url: string;
6
+ binary?: string;
7
+ method?: 'GET' | 'POST';
8
+ formFields?: Array<{
9
+ name: string;
10
+ value: string;
11
+ }>;
12
+ maxBytes?: number;
13
+ timeoutSeconds?: number;
14
+ cookieJarPath?: string;
15
+ signal?: AbortSignal;
16
+ };
17
+ export type CurlImpersonateResponse = {
18
+ body: string;
19
+ finalUrl: string;
20
+ httpStatus: number;
21
+ contentType: string;
22
+ bytesIn: number;
23
+ setCookieNames: string[];
24
+ };
25
+ export declare const CURL_EXIT_TIMEOUT = 28;
26
+ export declare const CURL_EXIT_MAX_FILESIZE_PRECHECK = 63;
27
+ export declare const CURL_EXIT_RECV_FAILURE_OR_FILESIZE = 56;
28
+ export declare class CurlImpersonateError extends Error {
29
+ readonly exitCode: number | null;
30
+ readonly stderr: string;
31
+ constructor(message: string, exitCode: number | null, stderr: string);
32
+ }
33
+ export declare function isCurlExitFilesizeExceeded(error: CurlImpersonateError): boolean;
34
+ export declare function isCurlExitTimeout(error: CurlImpersonateError): boolean;
35
+ export declare function curlImpersonate(req: CurlImpersonateRequest): Promise<CurlImpersonateResponse>;
36
+ export declare function isCurlImpersonateAvailable(): Promise<boolean>;
37
+ export declare function _resetAvailabilityCacheForTest(): void;
@@ -0,0 +1,18 @@
1
+ import { type SearchRetryOptions } from "./search-retry.js";
2
+ export { _setCurlBinaryForTest } from "./curl-impersonate.js";
3
+ export declare const DDG_PROFILES: readonly ["curl_firefox147", "curl_safari184"];
4
+ export declare const DDG_CONCURRENCY = 2;
5
+ export type DdgResult = {
6
+ title: string;
7
+ url: string;
8
+ snippet: string;
9
+ };
10
+ type RetryOverride = Pick<SearchRetryOptions, 'attempts' | 'baseDelayMs' | 'maxDelayMs' | 'sleep'>;
11
+ export declare function _setSearchRetryForTest(override: RetryOverride | null): void;
12
+ export declare function ddgSearch(query: string, limit: number, signal?: AbortSignal): Promise<DdgResult[]>;
13
+ export declare function isTransientSearchError(error: unknown): boolean;
14
+ export declare class DdgCaptchaError extends Error {
15
+ constructor();
16
+ }
17
+ export declare function fetchDdgHtml(query: string, signal?: AbortSignal, binary?: string): Promise<string>;
18
+ export declare function parseDdgHtml(html: string): DdgResult[];