typeclaw 0.49.0 → 0.51.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (502) hide show
  1. package/dist/types/agent/attention-escalation.d.ts +18 -0
  2. package/dist/types/agent/auth.d.ts +7 -0
  3. package/dist/types/agent/bash-sandbox-env.d.ts +15 -0
  4. package/dist/types/agent/bash-sandbox-proc.d.ts +8 -0
  5. package/dist/types/agent/bash-sandbox.d.ts +94 -0
  6. package/dist/types/agent/compaction.d.ts +8 -0
  7. package/dist/types/agent/git-nudge.d.ts +6 -0
  8. package/dist/types/agent/guard-types.d.ts +25 -0
  9. package/dist/types/agent/guards.d.ts +7 -0
  10. package/dist/types/agent/idle-compaction.d.ts +8 -0
  11. package/dist/types/agent/index.d.ts +151 -0
  12. package/dist/types/agent/live-subagents.d.ts +113 -0
  13. package/dist/types/agent/llm-replay-sanitizer.d.ts +11 -0
  14. package/dist/types/agent/loop-guard.d.ts +67 -0
  15. package/dist/types/agent/model-fallback.d.ts +29 -0
  16. package/dist/types/agent/model-overrides.d.ts +8 -0
  17. package/dist/types/agent/multimodal/index.d.ts +2 -0
  18. package/dist/types/agent/multimodal/look-at.d.ts +60 -0
  19. package/dist/types/agent/multimodal/looker.d.ts +61 -0
  20. package/dist/types/agent/multimodal/read-redirect.d.ts +6 -0
  21. package/dist/types/agent/network/response-body.d.ts +1 -0
  22. package/dist/types/agent/network/safe-http.d.ts +46 -0
  23. package/dist/types/agent/output-allowance.d.ts +4 -0
  24. package/dist/types/agent/plugin-tools.d.ts +58 -0
  25. package/dist/types/agent/proactive-next-step-nudge.d.ts +2 -0
  26. package/dist/types/agent/prompt-cache-key.d.ts +3 -0
  27. package/dist/types/agent/provider-error.d.ts +23 -0
  28. package/dist/types/agent/reload-tool.d.ts +10 -0
  29. package/dist/types/agent/restart/index.d.ts +31 -0
  30. package/dist/types/agent/restart-handoff/index.d.ts +32 -0
  31. package/dist/types/agent/restart-handoff/paths.d.ts +1 -0
  32. package/dist/types/agent/retry-same-ref.d.ts +41 -0
  33. package/dist/types/agent/reviewer-activity.d.ts +3 -0
  34. package/dist/types/agent/reviewer-bash-policy.d.ts +8 -0
  35. package/dist/types/agent/self.d.ts +1 -0
  36. package/dist/types/agent/session-meta.d.ts +28 -0
  37. package/dist/types/agent/session-origin.d.ts +65 -0
  38. package/dist/types/agent/subagent-cache-keepalive.d.ts +38 -0
  39. package/dist/types/agent/subagent-completion-reminder.d.ts +29 -0
  40. package/dist/types/agent/subagent-drain.d.ts +25 -0
  41. package/dist/types/agent/subagent-session.d.ts +3 -0
  42. package/dist/types/agent/subagents.d.ts +153 -0
  43. package/dist/types/agent/system-prompt-composition.d.ts +17 -0
  44. package/dist/types/agent/system-prompt.d.ts +7 -0
  45. package/dist/types/agent/throttle-circuit.d.ts +25 -0
  46. package/dist/types/agent/todo/continuation-policy.d.ts +54 -0
  47. package/dist/types/agent/todo/continuation-state.d.ts +11 -0
  48. package/dist/types/agent/todo/continuation-wiring.d.ts +32 -0
  49. package/dist/types/agent/todo/continuation.d.ts +21 -0
  50. package/dist/types/agent/todo/scope.d.ts +6 -0
  51. package/dist/types/agent/todo/store.d.ts +16 -0
  52. package/dist/types/agent/tool-error-remediation.d.ts +1 -0
  53. package/dist/types/agent/tool-file-safety.d.ts +78 -0
  54. package/dist/types/agent/tool-not-found-nudge.d.ts +9 -0
  55. package/dist/types/agent/tool-result-budget.d.ts +15 -0
  56. package/dist/types/agent/tools/channel-disengage.d.ts +18 -0
  57. package/dist/types/agent/tools/channel-edit.d.ts +19 -0
  58. package/dist/types/agent/tools/channel-fetch-attachment.d.ts +36 -0
  59. package/dist/types/agent/tools/channel-handoff.d.ts +13 -0
  60. package/dist/types/agent/tools/channel-history-render.d.ts +3 -0
  61. package/dist/types/agent/tools/channel-history.d.ts +25 -0
  62. package/dist/types/agent/tools/channel-log.d.ts +5 -0
  63. package/dist/types/agent/tools/channel-react.d.ts +23 -0
  64. package/dist/types/agent/tools/channel-read.d.ts +27 -0
  65. package/dist/types/agent/tools/channel-reply.d.ts +47 -0
  66. package/dist/types/agent/tools/channel-send.d.ts +42 -0
  67. package/dist/types/agent/tools/channel-session-search.d.ts +10 -0
  68. package/dist/types/agent/tools/curl-impersonate.d.ts +37 -0
  69. package/dist/types/agent/tools/ddg.d.ts +27 -0
  70. package/dist/types/agent/tools/grant-role.d.ts +25 -0
  71. package/dist/types/agent/tools/keyed-semaphore.d.ts +10 -0
  72. package/dist/types/agent/tools/post-github-review.d.ts +38 -0
  73. package/dist/types/agent/tools/restart.d.ts +25 -0
  74. package/dist/types/agent/tools/runtime-notice.d.ts +3 -0
  75. package/dist/types/agent/tools/search-retry.d.ts +16 -0
  76. package/dist/types/agent/tools/skip-response.d.ts +17 -0
  77. package/dist/types/agent/tools/spawn-subagent.d.ts +77 -0
  78. package/dist/types/agent/tools/stream-snapshot.d.ts +23 -0
  79. package/dist/types/agent/tools/subagent-access.d.ts +20 -0
  80. package/dist/types/agent/tools/subagent-cancel.d.ts +23 -0
  81. package/dist/types/agent/tools/subagent-output.d.ts +50 -0
  82. package/dist/types/agent/tools/todo/index.d.ts +14 -0
  83. package/dist/types/agent/tools/webfetch/adaptive-html.d.ts +29 -0
  84. package/dist/types/agent/tools/webfetch/fetch.d.ts +26 -0
  85. package/dist/types/agent/tools/webfetch/html-lexical.d.ts +27 -0
  86. package/dist/types/agent/tools/webfetch/index.d.ts +1 -0
  87. package/dist/types/agent/tools/webfetch/inline-style-visibility.d.ts +3 -0
  88. package/dist/types/agent/tools/webfetch/strategies/grep.d.ts +11 -0
  89. package/dist/types/agent/tools/webfetch/strategies/jq.d.ts +4 -0
  90. package/dist/types/agent/tools/webfetch/strategies/raw.d.ts +1 -0
  91. package/dist/types/agent/tools/webfetch/strategies/readability.d.ts +16 -0
  92. package/dist/types/agent/tools/webfetch/strategies/selector.d.ts +4 -0
  93. package/dist/types/agent/tools/webfetch/strategies/snapshot.d.ts +1 -0
  94. package/dist/types/agent/tools/webfetch/tool.d.ts +15 -0
  95. package/dist/types/agent/tools/webfetch/types.d.ts +32 -0
  96. package/dist/types/agent/tools/websearch.d.ts +17 -0
  97. package/dist/types/agent/tools/wikipedia.d.ts +7 -0
  98. package/dist/types/agent/tools-without-local-file-operands.d.ts +1 -0
  99. package/dist/types/agent/turn-runner.d.ts +36 -0
  100. package/dist/types/agent-messenger/config-dir.d.ts +19 -0
  101. package/dist/types/browser/dockerfile.d.ts +2 -0
  102. package/dist/types/browser/registry.d.ts +49 -0
  103. package/dist/types/bundled-plugins/bun-hygiene/policy.d.ts +18 -0
  104. package/dist/types/bundled-plugins/github-cli-auth/git-askpass.d.ts +5 -0
  105. package/dist/types/bundled-plugins/guard/keys.d.ts +6 -0
  106. package/dist/types/bundled-plugins/guard/policies/managed-config.d.ts +7 -0
  107. package/dist/types/bundled-plugins/guard/policies/memory-topics-delete.d.ts +11 -0
  108. package/dist/types/bundled-plugins/guard/policies/memory-topics-write.d.ts +7 -0
  109. package/dist/types/bundled-plugins/guard/policies/non-workspace-write.d.ts +9 -0
  110. package/dist/types/bundled-plugins/guard/policies/skill-authoring.d.ts +20 -0
  111. package/dist/types/bundled-plugins/guard/policies/uncommitted-changes.d.ts +12 -0
  112. package/dist/types/bundled-plugins/guard/policy.d.ts +11 -0
  113. package/dist/types/bundled-plugins/memory/secret-detector.d.ts +11 -0
  114. package/dist/types/bundled-plugins/memory/slug.d.ts +4 -0
  115. package/dist/types/bundled-plugins/security/permissions.d.ts +20 -0
  116. package/dist/types/bundled-plugins/security/policies/private-surface-read.d.ts +34 -0
  117. package/dist/types/bundled-plugins/security/policies/ssrf.d.ts +18 -0
  118. package/dist/types/bundled-plugins/security/policy.d.ts +4 -0
  119. package/dist/types/channels/adapter-namespace.d.ts +2 -0
  120. package/dist/types/channels/adapters/mention-hints.d.ts +12 -0
  121. package/dist/types/channels/adapters/webex-id-ref.d.ts +5 -0
  122. package/dist/types/channels/background-handoff.d.ts +56 -0
  123. package/dist/types/channels/background-obligations.d.ts +135 -0
  124. package/dist/types/channels/catch-up.d.ts +26 -0
  125. package/dist/types/channels/commands.d.ts +2 -0
  126. package/dist/types/channels/completion-claim.d.ts +20 -0
  127. package/dist/types/channels/continuation-willingness.d.ts +1 -0
  128. package/dist/types/channels/continuity-types.d.ts +75 -0
  129. package/dist/types/channels/describe-error.d.ts +1 -0
  130. package/dist/types/channels/engagement.d.ts +34 -0
  131. package/dist/types/channels/github-false-receipt.d.ts +20 -0
  132. package/dist/types/channels/github-repo.d.ts +2 -0
  133. package/dist/types/channels/github-rereview-guard.d.ts +24 -0
  134. package/dist/types/channels/github-review-check.d.ts +135 -0
  135. package/dist/types/channels/github-review-claim.d.ts +3 -0
  136. package/dist/types/channels/github-review-turn-ledger.d.ts +71 -0
  137. package/dist/types/channels/github-review-verdict-coordinator.d.ts +117 -0
  138. package/dist/types/channels/github-token-bridge.d.ts +20 -0
  139. package/dist/types/channels/github-verdict-activity.d.ts +12 -0
  140. package/dist/types/channels/inbound-journal.d.ts +272 -0
  141. package/dist/types/channels/last-alive.d.ts +3 -0
  142. package/dist/types/channels/membership-cache.d.ts +27 -0
  143. package/dist/types/channels/membership.d.ts +21 -0
  144. package/dist/types/channels/outbound-flood-filter.d.ts +7 -0
  145. package/dist/types/channels/participants.d.ts +4 -0
  146. package/dist/types/channels/persistence.d.ts +32 -0
  147. package/dist/types/channels/recovery-notice.d.ts +26 -0
  148. package/dist/types/channels/recovery-outbox.d.ts +58 -0
  149. package/dist/types/channels/router.d.ts +760 -0
  150. package/dist/types/channels/schema.d.ts +501 -0
  151. package/dist/types/channels/session-handoff.d.ts +58 -0
  152. package/dist/types/channels/session-search.d.ts +29 -0
  153. package/dist/types/channels/types.d.ts +414 -0
  154. package/dist/types/channels/waiting-reactions.d.ts +25 -0
  155. package/dist/types/cli/builtins.d.ts +2 -0
  156. package/dist/types/cli/command-meta.d.ts +9 -0
  157. package/dist/types/coding-agent/broker-body.d.ts +7 -0
  158. package/dist/types/coding-agent/broker.d.ts +22 -0
  159. package/dist/types/coding-agent/claude.d.ts +22 -0
  160. package/dist/types/coding-agent/codex.d.ts +19 -0
  161. package/dist/types/coding-agent/index.d.ts +71 -0
  162. package/dist/types/coding-agent/omo-state.d.ts +2 -0
  163. package/dist/types/coding-agent/omo-stream.d.ts +22 -0
  164. package/dist/types/coding-agent/omo.d.ts +133 -0
  165. package/dist/types/coding-agent/runner.d.ts +35 -0
  166. package/dist/types/coding-agent/tool.d.ts +27 -0
  167. package/dist/types/coding-agent/worktree.d.ts +22 -0
  168. package/dist/types/commands/index.d.ts +45 -0
  169. package/dist/types/config/config.d.ts +827 -0
  170. package/dist/types/config/index.d.ts +3 -0
  171. package/dist/types/config/model-overrides.d.ts +3 -0
  172. package/dist/types/config/providers.d.ts +1458 -0
  173. package/dist/types/config/reloadable.d.ts +9 -0
  174. package/dist/types/container/agent-operation-lock.d.ts +31 -0
  175. package/dist/types/container/build-cache.d.ts +39 -0
  176. package/dist/types/container/compose-project.d.ts +1 -0
  177. package/dist/types/container/controller.d.ts +25 -0
  178. package/dist/types/container/docker-app.d.ts +23 -0
  179. package/dist/types/container/exit-reason.d.ts +10 -0
  180. package/dist/types/container/index.d.ts +14 -0
  181. package/dist/types/container/log-archive.d.ts +68 -0
  182. package/dist/types/container/log-colors.d.ts +3 -0
  183. package/dist/types/container/log-timestamps.d.ts +9 -0
  184. package/dist/types/container/logs.d.ts +37 -0
  185. package/dist/types/container/memory-limit.d.ts +13 -0
  186. package/dist/types/container/memory-oversubscription.d.ts +20 -0
  187. package/dist/types/container/oom-events.d.ts +18 -0
  188. package/dist/types/container/port.d.ts +18 -0
  189. package/dist/types/container/require-running.d.ts +16 -0
  190. package/dist/types/container/restart.d.ts +32 -0
  191. package/dist/types/container/shared.d.ts +93 -0
  192. package/dist/types/container/shell.d.ts +35 -0
  193. package/dist/types/container/start.d.ts +145 -0
  194. package/dist/types/container/stats.d.ts +31 -0
  195. package/dist/types/container/status.d.ts +25 -0
  196. package/dist/types/container/stop.d.ts +24 -0
  197. package/dist/types/container/tool-oom-priority.d.ts +4 -0
  198. package/dist/types/container/verify-running.d.ts +49 -0
  199. package/dist/types/cron/consumer.d.ts +42 -0
  200. package/dist/types/cron/count-state.d.ts +24 -0
  201. package/dist/types/cron/index.d.ts +21 -0
  202. package/dist/types/cron/list.d.ts +33 -0
  203. package/dist/types/cron/reloadable.d.ts +11 -0
  204. package/dist/types/cron/scheduler.d.ts +51 -0
  205. package/dist/types/cron/schema.d.ts +108 -0
  206. package/dist/types/dependencies/bin-resolver.d.ts +28 -0
  207. package/dist/types/dependencies/bins.d.ts +22 -0
  208. package/dist/types/dependencies/index.d.ts +2 -0
  209. package/dist/types/eval/cell.d.ts +26 -0
  210. package/dist/types/eval/config.d.ts +19 -0
  211. package/dist/types/eval/dispatch.d.ts +7 -0
  212. package/dist/types/eval/kernel.d.ts +28 -0
  213. package/dist/types/eval/process.d.ts +23 -0
  214. package/dist/types/eval/protocol.d.ts +34 -0
  215. package/dist/types/eval/sandbox.d.ts +10 -0
  216. package/dist/types/eval/tool.d.ts +17 -0
  217. package/dist/types/eval/wire.d.ts +33 -0
  218. package/dist/types/git/bound-gc-config.d.ts +4 -0
  219. package/dist/types/git/hookless.d.ts +1 -0
  220. package/dist/types/git/reconcile-ignored.d.ts +13 -0
  221. package/dist/types/git/resolve-agent-git.d.ts +8 -0
  222. package/dist/types/git/resolve-identity.d.ts +10 -0
  223. package/dist/types/git/run.d.ts +24 -0
  224. package/dist/types/git/system-commit.d.ts +2 -0
  225. package/dist/types/hostd/client.d.ts +13 -0
  226. package/dist/types/hostd/models.d.ts +1 -0
  227. package/dist/types/hostd/paths.d.ts +17 -0
  228. package/dist/types/hostd/protocol.d.ts +93 -0
  229. package/dist/types/hostd/spawn.d.ts +17 -0
  230. package/dist/types/hostd/version.d.ts +18 -0
  231. package/dist/types/init/auto-upgrade.d.ts +41 -0
  232. package/dist/types/init/cli-version.d.ts +7 -0
  233. package/dist/types/init/dockerfile.d.ts +34 -0
  234. package/dist/types/init/ensure-deps.d.ts +17 -0
  235. package/dist/types/init/env-file.d.ts +3 -0
  236. package/dist/types/init/gitignore.d.ts +5 -0
  237. package/dist/types/init/local-source-stamp.d.ts +3 -0
  238. package/dist/types/init/packagejson.d.ts +7 -0
  239. package/dist/types/init/paths.d.ts +3 -0
  240. package/dist/types/init/reconcile-plugin-deps.d.ts +13 -0
  241. package/dist/types/init/run-bun-install.d.ts +16 -0
  242. package/dist/types/init/windows-dev-link.d.ts +8 -0
  243. package/dist/types/mcp/catalog.d.ts +7 -0
  244. package/dist/types/mcp/client.d.ts +58 -0
  245. package/dist/types/mcp/manager.d.ts +56 -0
  246. package/dist/types/mcp/tools.d.ts +23 -0
  247. package/dist/types/models/embedding-model.d.ts +20 -0
  248. package/dist/types/models/transformers-version.d.ts +1 -0
  249. package/dist/types/network/internal-destinations.d.ts +29 -0
  250. package/dist/types/operations/classify-tool-outcome.d.ts +35 -0
  251. package/dist/types/operations/incidents.d.ts +47 -0
  252. package/dist/types/operations/index.d.ts +3 -0
  253. package/dist/types/operations/remediations.d.ts +25 -0
  254. package/dist/types/path-safety/real-intended-path.d.ts +9 -0
  255. package/dist/types/permissions/builtins.d.ts +25 -0
  256. package/dist/types/permissions/grant.d.ts +19 -0
  257. package/dist/types/permissions/index.d.ts +6 -0
  258. package/dist/types/permissions/match-rule.d.ts +28 -0
  259. package/dist/types/permissions/permissions.d.ts +42 -0
  260. package/dist/types/permissions/resolve.d.ts +25 -0
  261. package/dist/types/permissions/schema.d.ts +14 -0
  262. package/dist/types/plugin/context.d.ts +20 -0
  263. package/dist/types/plugin/core-tool-names.d.ts +4 -0
  264. package/dist/types/plugin/define.d.ts +46 -0
  265. package/dist/types/plugin/hooks.d.ts +52 -0
  266. package/dist/types/plugin/index.d.ts +11 -0
  267. package/dist/types/plugin/load-skill.d.ts +14 -0
  268. package/dist/types/plugin/loader.d.ts +25 -0
  269. package/dist/types/plugin/manager.d.ts +42 -0
  270. package/dist/types/plugin/registry.d.ts +73 -0
  271. package/dist/types/plugin/skills.d.ts +11 -0
  272. package/dist/types/plugin/types.d.ts +336 -0
  273. package/dist/types/plugin/zod-introspect.d.ts +11 -0
  274. package/dist/types/reload/client.d.ts +11 -0
  275. package/dist/types/reload/docker-exec-client.d.ts +11 -0
  276. package/dist/types/reload/format.d.ts +2 -0
  277. package/dist/types/reload/index.d.ts +6 -0
  278. package/dist/types/reload/recover.d.ts +22 -0
  279. package/dist/types/reload/registry.d.ts +10 -0
  280. package/dist/types/reload/types.d.ts +25 -0
  281. package/dist/types/role-claim/client.d.ts +20 -0
  282. package/dist/types/role-claim/code.d.ts +4 -0
  283. package/dist/types/role-claim/controller.d.ts +59 -0
  284. package/dist/types/role-claim/index.d.ts +6 -0
  285. package/dist/types/role-claim/match-rule.d.ts +9 -0
  286. package/dist/types/role-claim/pending.d.ts +35 -0
  287. package/dist/types/role-claim/reload-after-claim.d.ts +16 -0
  288. package/dist/types/run/llm-fetch-observer.d.ts +50 -0
  289. package/dist/types/sandbox/availability.d.ts +21 -0
  290. package/dist/types/sandbox/build.d.ts +7 -0
  291. package/dist/types/sandbox/canonical-secrets.d.ts +8 -0
  292. package/dist/types/sandbox/coding-agent.d.ts +20 -0
  293. package/dist/types/sandbox/dependency-bins.d.ts +19 -0
  294. package/dist/types/sandbox/dev-source.d.ts +4 -0
  295. package/dist/types/sandbox/env-exposure.d.ts +3 -0
  296. package/dist/types/sandbox/errors.d.ts +20 -0
  297. package/dist/types/sandbox/hidden-paths.d.ts +11 -0
  298. package/dist/types/sandbox/index.d.ts +14 -0
  299. package/dist/types/sandbox/package-install.d.ts +1 -0
  300. package/dist/types/sandbox/policy.d.ts +71 -0
  301. package/dist/types/sandbox/privileged-runtime.d.ts +13 -0
  302. package/dist/types/sandbox/quote.d.ts +2 -0
  303. package/dist/types/sandbox/runtime-private.d.ts +1 -0
  304. package/dist/types/sandbox/session-tmp.d.ts +6 -0
  305. package/dist/types/sandbox/symlinks.d.ts +6 -0
  306. package/dist/types/sandbox/writable-zones.d.ts +15 -0
  307. package/dist/types/secrets/coding-agent-auth.d.ts +25 -0
  308. package/dist/types/secrets/defaults.d.ts +21 -0
  309. package/dist/types/secrets/export-github-cli-store.d.ts +22 -0
  310. package/dist/types/secrets/hydrate.d.ts +7 -0
  311. package/dist/types/secrets/index.d.ts +7 -0
  312. package/dist/types/secrets/provision-github-cli-store.d.ts +45 -0
  313. package/dist/types/secrets/refresh-provider-oauth.d.ts +22 -0
  314. package/dist/types/secrets/resolve.d.ts +14 -0
  315. package/dist/types/secrets/schema.d.ts +840 -0
  316. package/dist/types/secrets/storage.d.ts +56 -0
  317. package/dist/types/shared/host-locale.d.ts +1 -0
  318. package/dist/types/shared/index.d.ts +5 -0
  319. package/dist/types/shared/local-time.d.ts +4 -0
  320. package/dist/types/shared/platform.d.ts +2 -0
  321. package/dist/types/shared/protocol.d.ts +424 -0
  322. package/dist/types/shared/style-text.d.ts +3 -0
  323. package/dist/types/shared/wsl.d.ts +17 -0
  324. package/dist/types/stream/broker.d.ts +2 -0
  325. package/dist/types/stream/index.d.ts +2 -0
  326. package/dist/types/stream/types.d.ts +71 -0
  327. package/package.json +13 -6
  328. package/scripts/build-plugin-types.ts +105 -0
  329. package/scripts/check-plugin-sdk.ts +111 -0
  330. package/scripts/require-parallel.ts +5 -32
  331. package/src/agent/bash-sandbox-env.ts +104 -0
  332. package/src/agent/bash-sandbox-proc.ts +70 -0
  333. package/src/agent/bash-sandbox.ts +225 -0
  334. package/src/agent/compaction.ts +22 -10
  335. package/src/agent/guard-types.ts +3 -0
  336. package/src/agent/guards.ts +4 -0
  337. package/src/agent/idle-compaction.ts +178 -0
  338. package/src/agent/index.ts +139 -172
  339. package/src/agent/live-subagents.ts +19 -0
  340. package/src/agent/multimodal/look-at.ts +22 -9
  341. package/src/agent/output-allowance.ts +7 -0
  342. package/src/agent/plugin-tools.ts +39 -377
  343. package/src/agent/reviewer-bash-policy.ts +41 -1
  344. package/src/agent/session-origin.ts +28 -11
  345. package/src/agent/subagent-cache-keepalive.ts +198 -0
  346. package/src/agent/subagent-completion-reminder.ts +2 -2
  347. package/src/agent/subagent-session.ts +6 -0
  348. package/src/agent/subagents.ts +46 -8
  349. package/src/agent/system-prompt-composition.ts +141 -0
  350. package/src/agent/system-prompt.ts +5 -5
  351. package/src/agent/todo/scope.ts +1 -1
  352. package/src/agent/tool-file-safety.ts +6 -1
  353. package/src/agent/tools/channel-edit.ts +20 -10
  354. package/src/agent/tools/channel-fetch-attachment.ts +12 -5
  355. package/src/agent/tools/channel-handoff.ts +72 -0
  356. package/src/agent/tools/channel-read.ts +57 -10
  357. package/src/agent/tools/channel-reply.ts +33 -26
  358. package/src/agent/tools/channel-send.ts +21 -13
  359. package/src/agent/tools/channel-session-search.ts +35 -0
  360. package/src/agent/tools/curl-impersonate.ts +11 -4
  361. package/src/agent/tools/ddg.ts +84 -16
  362. package/src/agent/tools/spawn-subagent.ts +27 -11
  363. package/src/agent/tools/stream-snapshot.ts +15 -2
  364. package/src/agent/tools/subagent-access.ts +11 -4
  365. package/src/agent/tools-without-local-file-operands.ts +4 -0
  366. package/src/browser/bsk-shim.mjs +74 -0
  367. package/src/browser/dockerfile.ts +84 -0
  368. package/src/browser/egress.ts +104 -0
  369. package/src/browser/fill-secret.ts +307 -0
  370. package/src/browser/managed-browser.ts +205 -0
  371. package/src/browser/registry.ts +110 -0
  372. package/src/browser/relay.ts +231 -0
  373. package/src/browser/sandbox-entry.ts +167 -0
  374. package/src/bundled-plugins/agent-browser/index.ts +2 -0
  375. package/src/bundled-plugins/browser-agent/browser-agent.ts +89 -0
  376. package/src/bundled-plugins/browser-agent/index.ts +12 -0
  377. package/src/bundled-plugins/doc-render/index.ts +0 -10
  378. package/src/bundled-plugins/doc-render/render.ts +83 -111
  379. package/src/bundled-plugins/doc-render/skills/typeclaw-render-pdf/SKILL.md +152 -257
  380. package/src/bundled-plugins/explorer/explorer.ts +1 -1
  381. package/src/bundled-plugins/github-cli-auth/gh-command.ts +4 -0
  382. package/src/bundled-plugins/github-cli-auth/gh-review-detect.ts +40 -16
  383. package/src/bundled-plugins/github-cli-auth/git-auth-diagnostic.ts +95 -0
  384. package/src/bundled-plugins/github-cli-auth/graphql-auth-nudge.ts +12 -7
  385. package/src/bundled-plugins/github-cli-auth/index.ts +85 -60
  386. package/src/bundled-plugins/managed-browser/index.ts +179 -0
  387. package/src/bundled-plugins/managed-browser/skills/browser-use/browser-use/SKILL.md +27 -0
  388. package/src/bundled-plugins/managed-browser/skills/browserskill/browserskill/SKILL.md +28 -0
  389. package/src/bundled-plugins/managed-browser/skills/omowright/omowright/SKILL.md +40 -0
  390. package/src/bundled-plugins/memory/dreaming.ts +4 -1
  391. package/src/bundled-plugins/memory/load-memory.ts +2 -4
  392. package/src/bundled-plugins/memory/memory-logger.ts +74 -2
  393. package/src/bundled-plugins/memory/transcript-preload.ts +103 -0
  394. package/src/bundled-plugins/memory/vector/hybrid.ts +25 -14
  395. package/src/bundled-plugins/operator/operator.ts +1 -1
  396. package/src/bundled-plugins/qa/index.ts +11 -0
  397. package/src/bundled-plugins/qa/qa.ts +160 -0
  398. package/src/bundled-plugins/qa/skills/qa-cli.ts +50 -0
  399. package/src/bundled-plugins/qa/skills/qa-general.ts +30 -0
  400. package/src/bundled-plugins/qa/skills/qa-http.ts +39 -0
  401. package/src/bundled-plugins/qa/skills/qa-pr.ts +51 -0
  402. package/src/bundled-plugins/qa/skills/qa-web.ts +49 -0
  403. package/src/bundled-plugins/security/index.ts +53 -34
  404. package/src/bundled-plugins/security/policies/outbound-secret-scan.ts +1 -0
  405. package/src/bundled-plugins/security/policies/private-surface-read.ts +166 -201
  406. package/src/channels/adapter-namespace.ts +13 -0
  407. package/src/channels/adapters/discord-bot-reference.ts +5 -4
  408. package/src/channels/adapters/discord-bot.ts +98 -5
  409. package/src/channels/adapters/discord-classify.ts +8 -3
  410. package/src/channels/adapters/discord.ts +29 -0
  411. package/src/channels/adapters/github/index.ts +16 -0
  412. package/src/channels/adapters/github/last-alive.ts +4 -16
  413. package/src/channels/adapters/slack-attachment-download.ts +14 -3
  414. package/src/channels/adapters/slack-bot-author-resolver.ts +4 -3
  415. package/src/channels/adapters/slack-bot-channel-resolver.ts +9 -6
  416. package/src/channels/adapters/slack-bot-classify.ts +1 -0
  417. package/src/channels/adapters/slack-bot-slash-commands.ts +3 -1
  418. package/src/channels/adapters/slack-bot.ts +299 -67
  419. package/src/channels/adapters/slack-classify.ts +1 -0
  420. package/src/channels/catch-up.ts +137 -0
  421. package/src/channels/continuation-willingness.ts +2 -2
  422. package/src/channels/continuity-types.ts +1 -0
  423. package/src/channels/engagement.ts +17 -1
  424. package/src/channels/github-false-receipt.ts +3 -3
  425. package/src/channels/github-rereview-guard.ts +9 -5
  426. package/src/channels/github-review-check.ts +5 -1
  427. package/src/channels/github-review-verdict-coordinator.ts +68 -2
  428. package/src/channels/github-token-bridge.ts +24 -0
  429. package/src/channels/last-alive.ts +34 -0
  430. package/src/channels/manager.ts +8 -1
  431. package/src/channels/router.ts +515 -243
  432. package/src/channels/session-handoff.fixture.ts +144 -0
  433. package/src/channels/session-handoff.ts +175 -0
  434. package/src/channels/session-search.ts +71 -0
  435. package/src/channels/subagent-completion-bridge.ts +3 -2
  436. package/src/channels/types.ts +12 -2
  437. package/src/cli/channel.ts +2 -3
  438. package/src/cli/hostd.ts +3 -0
  439. package/src/cli/init.ts +2 -3
  440. package/src/cli/model.ts +132 -3
  441. package/src/coding-agent/index.ts +7 -1
  442. package/src/coding-agent/omo-stream.ts +40 -0
  443. package/src/coding-agent/runner.ts +30 -8
  444. package/src/config/config.ts +126 -22
  445. package/src/config/model-overrides.ts +59 -0
  446. package/src/config/models-mutation.ts +185 -2
  447. package/src/config/providers-mutation.ts +12 -4
  448. package/src/config/providers.ts +69 -4
  449. package/src/container/start.ts +132 -5
  450. package/src/doctor/checks.ts +33 -22
  451. package/src/doctor/index.ts +48 -12
  452. package/src/doctor/operational-incidents.ts +16 -1
  453. package/src/doctor/plugin-bridge.ts +14 -1
  454. package/src/doctor/stage.ts +14 -0
  455. package/src/doctor/types.ts +6 -0
  456. package/src/eval/cell.ts +93 -0
  457. package/src/eval/config.ts +32 -0
  458. package/src/eval/dispatch.ts +67 -0
  459. package/src/eval/entry.ts +261 -0
  460. package/src/eval/kernel.ts +154 -0
  461. package/src/eval/process.ts +113 -0
  462. package/src/eval/protocol.ts +26 -0
  463. package/src/eval/redeclare.ts +174 -0
  464. package/src/eval/sandbox.ts +114 -0
  465. package/src/eval/tool.ts +98 -0
  466. package/src/eval/wire.ts +93 -0
  467. package/src/hostd/daemon.ts +13 -1
  468. package/src/init/auto-upgrade.ts +7 -1
  469. package/src/init/dockerfile.ts +57 -12
  470. package/src/init/index.ts +4 -3
  471. package/src/init/local-source-stamp.ts +68 -0
  472. package/src/init/models-dev.ts +4 -0
  473. package/src/init/validate-api-key.ts +3 -0
  474. package/src/operations/classify-tool-outcome.ts +1 -1
  475. package/src/permissions/builtins.ts +7 -0
  476. package/src/permissions/permissions.ts +18 -9
  477. package/src/permissions/resolve.ts +7 -1
  478. package/src/plugin/context.ts +2 -0
  479. package/src/plugin/core-tool-names.ts +6 -1
  480. package/src/plugin/hooks.ts +137 -0
  481. package/src/plugin/index.ts +6 -0
  482. package/src/plugin/manager.ts +4 -0
  483. package/src/plugin/types.ts +60 -0
  484. package/src/run/bundled-plugins.ts +6 -0
  485. package/src/run/index.ts +24 -14
  486. package/src/run/llm-fetch-observer.ts +12 -15
  487. package/src/sandbox/canonical-secrets.ts +4 -0
  488. package/src/sandbox/dev-source.ts +26 -0
  489. package/src/sandbox/env-exposure.ts +20 -0
  490. package/src/sandbox/hidden-paths.ts +16 -2
  491. package/src/secrets/storage.ts +13 -0
  492. package/src/server/index.ts +46 -11
  493. package/src/skills/typeclaw-channel-github/SKILL.md +8 -8
  494. package/src/skills/typeclaw-config/SKILL.md +57 -5
  495. package/src/skills/typeclaw-config/references/dockerfile.md +2 -2
  496. package/src/skills/typeclaw-github-contributing/SKILL.md +1 -1
  497. package/src/skills/typeclaw-monorepo/SKILL.md +1 -1
  498. package/src/skills/typeclaw-permissions/SKILL.md +7 -7
  499. package/src/skills/typeclaw-troubleshooting/SKILL.md +12 -1
  500. package/typeclaw.schema.json +488 -5
  501. package/src/bundled-plugins/doc-render/templates/lib.typ +0 -339
  502. package/src/bundled-plugins/github-cli-auth/gh-store.ts +0 -733
@@ -0,0 +1,16 @@
1
+ export type ReadabilityDetailedResult = {
2
+ output: string;
3
+ parsedArticle: boolean;
4
+ usedBodyFallback: boolean;
5
+ hasSemanticContentContainer: boolean;
6
+ hasArticleContainer: boolean;
7
+ proseElementCount: number;
8
+ structuredContentElementCount: number;
9
+ scriptCount: number;
10
+ visibleTextCharacterCount: number;
11
+ };
12
+ export declare function applyReadability(html: string, url: string): Promise<string>;
13
+ export declare function applyReadabilityDetailed(html: string, url: string): Promise<ReadabilityDetailedResult>;
14
+ export declare function buildComputedStyleResolver(document: Document, resolve: (element: Element) => CSSStyleDeclaration): ((element: Element) => CSSStyleDeclaration) | undefined;
15
+ export declare function reduceToVisibilityDeclarations(styles: HTMLStyleElement[]): void;
16
+ export declare function pruneHiddenContent(document: Document, computedStyle: ((element: Element) => CSSStyleDeclaration) | undefined): void;
@@ -0,0 +1,4 @@
1
+ export declare class SelectorError extends Error {
2
+ constructor(message: string);
3
+ }
4
+ export declare function applySelector(html: string, selector: string): Promise<string>;
@@ -0,0 +1 @@
1
+ export declare function applySnapshot(html: string): Promise<string>;
@@ -0,0 +1,15 @@
1
+ import { Type } from '@earendil-works/pi-ai';
2
+ import { type WebFetchDetails } from "./types.js";
3
+ export declare const webFetchTool: import("@earendil-works/pi-coding-agent").ToolDefinition<Type.TObject<{
4
+ url: Type.TString;
5
+ strategy: Type.TOptional<Type.TUnion<Type.TLiteral<"grep" | "jq" | "selector" | "snapshot" | "raw" | "readability">[]>>;
6
+ query: Type.TOptional<Type.TString>;
7
+ selector: Type.TOptional<Type.TString>;
8
+ pattern: Type.TOptional<Type.TString>;
9
+ before: Type.TOptional<Type.TInteger>;
10
+ after: Type.TOptional<Type.TInteger>;
11
+ limit: Type.TOptional<Type.TInteger>;
12
+ offset: Type.TOptional<Type.TInteger>;
13
+ timeout: Type.TOptional<Type.TInteger>;
14
+ antibotWarmup: Type.TOptional<Type.TUnion<[Type.TLiteral<"auto">, Type.TLiteral<"off">]>>;
15
+ }>, WebFetchDetails, any> & import("@earendil-works/pi-coding-agent").ToolDefinition<any, any, any>;
@@ -0,0 +1,32 @@
1
+ export type CompactionStrategy = 'readability' | 'jq' | 'selector' | 'grep' | 'snapshot' | 'raw';
2
+ export type AntibotWarmupDetails = {
3
+ triggered: boolean;
4
+ initialStatus?: number;
5
+ initialSetCookieNames?: string[];
6
+ replayStatus?: number;
7
+ };
8
+ export type HtmlExtractionAttempt = {
9
+ route: 'readability' | 'json_ld';
10
+ outcome: 'success' | 'unusable' | 'error';
11
+ reason: string;
12
+ };
13
+ export type WebFetchDetails = {
14
+ url: string;
15
+ finalUrl: string;
16
+ strategy: CompactionStrategy | 'none';
17
+ autoDetected: boolean;
18
+ contentType: string;
19
+ httpStatus: number;
20
+ bytesIn: number;
21
+ bytesOut: number;
22
+ truncated: boolean;
23
+ durationMs: number;
24
+ antibotWarmup?: AntibotWarmupDetails;
25
+ extractionAttempts?: HtmlExtractionAttempt[];
26
+ error?: boolean;
27
+ message?: string;
28
+ };
29
+ export declare const OUTPUT_CAPS: Record<CompactionStrategy, number>;
30
+ export declare const MAX_RESPONSE_BYTES: number;
31
+ export declare const DEFAULT_TIMEOUT_SECONDS = 30;
32
+ export declare const MAX_TIMEOUT_SECONDS = 120;
@@ -0,0 +1,17 @@
1
+ import { Type } from '@earendil-works/pi-ai';
2
+ import { type DdgResult } from "./ddg.js";
3
+ import { type WikipediaResult } from "./wikipedia.js";
4
+ type WebSearchDetails = {
5
+ query: string;
6
+ source: 'web' | 'wikipedia' | 'none';
7
+ count: number;
8
+ results: (DdgResult | WikipediaResult)[];
9
+ error?: boolean;
10
+ message?: string;
11
+ };
12
+ export declare const webSearchTool: import("@earendil-works/pi-coding-agent").ToolDefinition<Type.TObject<{
13
+ query: Type.TString;
14
+ limit: Type.TOptional<Type.TInteger>;
15
+ source: Type.TOptional<Type.TUnion<[Type.TLiteral<"web">, Type.TLiteral<"wikipedia">]>>;
16
+ }>, WebSearchDetails, any> & import("@earendil-works/pi-coding-agent").ToolDefinition<any, any, any>;
17
+ export {};
@@ -0,0 +1,7 @@
1
+ export type WikipediaResult = {
2
+ title: string;
3
+ url: string;
4
+ snippet: string;
5
+ };
6
+ export declare function wikipediaSearch(query: string, limit: number, signal?: AbortSignal): Promise<WikipediaResult[]>;
7
+ export declare function parseOpenSearch(json: unknown): WikipediaResult[];
@@ -0,0 +1 @@
1
+ export declare const TOOLS_WITHOUT_LOCAL_FILE_OPERANDS: ReadonlySet<string>;
@@ -0,0 +1,36 @@
1
+ import { type ModelRef } from "../config/providers.js";
2
+ import type { AgentSession } from "./index.js";
3
+ import { type RetryPolicy } from "./retry-same-ref.js";
4
+ import { type ThrottleCircuit } from "./throttle-circuit.js";
5
+ export type PersistentTurnAttempt = {
6
+ ref: ModelRef;
7
+ outcome: 'hard' | 'soft' | 'success';
8
+ errorMessage?: string;
9
+ };
10
+ export type PersistentTurnResult = {
11
+ success: boolean;
12
+ refUsed: ModelRef;
13
+ attempts: PersistentTurnAttempt[];
14
+ lastError?: Error;
15
+ };
16
+ export declare function promptPersistentTurnWithFallback(opts: {
17
+ refs: ModelRef[];
18
+ currentModelRef: ModelRef;
19
+ session: AgentSession;
20
+ text: string;
21
+ shouldFailover: (err: Error) => boolean;
22
+ setModelForRef: (ref: ModelRef) => Promise<void>;
23
+ profile?: string;
24
+ retryPolicy?: RetryPolicy;
25
+ circuit?: ThrottleCircuit;
26
+ skipProviderErrorSubscription?: boolean;
27
+ detectSoftErrorFromLeaf?: boolean;
28
+ authorizeRetryAfterCompletedToolResult?: () => boolean;
29
+ retryRandom?: () => number;
30
+ overloadBackoffMs?: (attempt: number) => number;
31
+ onRetryBackoffStart?: () => void;
32
+ beforeAttempt?: (ref: ModelRef) => void;
33
+ onAttemptFailed?: (attempt: PersistentTurnAttempt) => void;
34
+ onToolExecutionStarted?: () => void;
35
+ now?: () => number;
36
+ }): Promise<PersistentTurnResult>;
@@ -0,0 +1,19 @@
1
+ export declare const AGENT_MESSENGER_CONFIG_RELATIVE_DIR = "workspace/.config/agent-messenger";
2
+ export declare const LEGACY_AGENT_MESSENGER_CONFIG_RELATIVE_DIR = "workspace/.agent-messenger";
3
+ export declare const CONTAINER_AGENT_MESSENGER_CONFIG_DIR: string;
4
+ export type MigrationResult = {
5
+ ok: true;
6
+ migrated: boolean;
7
+ } | {
8
+ ok: false;
9
+ reason: string;
10
+ };
11
+ export type AgentMessengerConfigPolicy = {
12
+ override: string | null;
13
+ containerDir: string;
14
+ migrate: boolean;
15
+ };
16
+ export declare function agentMessengerConfigDir(agentDir: string): string;
17
+ export declare function legacyAgentMessengerConfigDir(agentDir: string): string;
18
+ export declare function resolveAgentMessengerConfigPolicy(agentDir: string): AgentMessengerConfigPolicy;
19
+ export declare function migrateAgentMessengerConfigDir(agentDir: string): Promise<MigrationResult>;
@@ -0,0 +1,2 @@
1
+ import { type BrowserConfig } from "./registry.js";
2
+ export declare function renderBrowserLayers(browser: BrowserConfig): string;
@@ -0,0 +1,49 @@
1
+ export declare const BROWSER_ENGINE_IDS: readonly ["agent-browser", "omowright", "browser-use"];
2
+ export type BrowserEngineId = (typeof BROWSER_ENGINE_IDS)[number];
3
+ export declare const BROWSER_EXTENSION_IDS: readonly ["browserskill"];
4
+ export type BrowserExtensionId = (typeof BROWSER_EXTENSION_IDS)[number];
5
+ export type BrowserEngineInstall = {
6
+ kind: 'image';
7
+ } | {
8
+ kind: 'bun-global';
9
+ spec: string;
10
+ } | {
11
+ kind: 'uv-tool';
12
+ package: string;
13
+ version: string;
14
+ python: string;
15
+ };
16
+ export type BrowserEngineSpec = {
17
+ id: BrowserEngineId;
18
+ install: BrowserEngineInstall;
19
+ env: (cdpUrl: string) => Record<string, string>;
20
+ };
21
+ export type BrowserExtensionSpec = {
22
+ id: BrowserExtensionId;
23
+ version: string;
24
+ zip: {
25
+ url: string;
26
+ sha256: string;
27
+ };
28
+ cli: {
29
+ name: string;
30
+ urlByArch: Record<'amd64' | 'arm64', {
31
+ url: string;
32
+ sha256: string;
33
+ }>;
34
+ };
35
+ };
36
+ export declare const BROWSER_ROOT = "/usr/local/lib/typeclaw-browser";
37
+ export declare const CHROME_LAUNCHER = "/usr/local/lib/typeclaw-agent-browser/chrome";
38
+ export declare const BSK_BIN = "/usr/local/lib/typeclaw-browser/bsk/bsk";
39
+ export declare const BSK_SHIM = "/usr/local/lib/typeclaw-browser/bsk/shim.mjs";
40
+ export declare const BSK_DAEMON_PORT = 52800;
41
+ export declare const OMOWRIGHT_MODULE = "/usr/local/lib/typeclaw-browser/omowright/index.js";
42
+ export declare const BROWSER_ENGINES: Record<BrowserEngineId, BrowserEngineSpec>;
43
+ export declare const BROWSER_EXTENSIONS: Record<BrowserExtensionId, BrowserExtensionSpec>;
44
+ export type BrowserConfig = {
45
+ engines: readonly BrowserEngineId[];
46
+ extensions: readonly BrowserExtensionId[];
47
+ };
48
+ export declare function needsManagedBrowser(config: BrowserConfig): boolean;
49
+ export declare function extensionDir(id: BrowserExtensionId): string;
@@ -0,0 +1,18 @@
1
+ import type { InternalGuardResult } from "../../agent/guard-types.js";
2
+ export { GUARD_GLOBAL_INSTALL, GUARD_NON_BUN_PACKAGE_MANAGER, GUARD_NON_BUN_PACKAGE_RUNNER } from "../guard/keys.js";
3
+ export declare function checkBunHygieneGuard(options: {
4
+ tool: string;
5
+ args: Readonly<Record<string, unknown>>;
6
+ }): InternalGuardResult;
7
+ export declare function checkGlobalInstallGuard(options: {
8
+ tool: string;
9
+ args: Readonly<Record<string, unknown>>;
10
+ }): InternalGuardResult;
11
+ export declare function checkNonBunPackageManagerGuard(options: {
12
+ tool: string;
13
+ args: Readonly<Record<string, unknown>>;
14
+ }): InternalGuardResult;
15
+ export declare function checkNonBunPackageRunnerGuard(options: {
16
+ tool: string;
17
+ args: Readonly<Record<string, unknown>>;
18
+ }): InternalGuardResult;
@@ -0,0 +1,5 @@
1
+ export declare const ASKPASS_SCRIPT = "#!/bin/sh\ncase \"$1\" in\n *//github.com/*|*//github.com\\'*|*//*@github.com/*|*//*@github.com\\'*) : ;;\n *) exit 1 ;;\nesac\nif [ -n \"$TYPECLAW_GIT_CREDENTIALS\" ]; then\n prompt=$(printf '%s' \"$1\" | tr '[:upper:]' '[:lower:]')\n selected_token=''\n while IFS='\t' read -r repo token; do\n case \"$prompt\" in\n *//github.com/\"$repo\"\\'*|*//github.com/\"$repo\".git\\'*|*//*@github.com/\"$repo\"\\'*|*//*@github.com/\"$repo\".git\\'*) selected_token=$token; break ;;\n esac\n done <<TYPECLAW_GIT_CREDENTIALS_EOF\n$TYPECLAW_GIT_CREDENTIALS\nTYPECLAW_GIT_CREDENTIALS_EOF\n [ -n \"$selected_token\" ] || exit 1\n case \"$1\" in\n *Username*) printf '%s\\n' 'x-access-token' ;;\n *) printf '%s\\n' \"$selected_token\" ;;\n esac\n exit 0\nfi\nif [ -n \"$TYPECLAW_GIT_EXPECTED_REPO\" ]; then\n expected_repo=$(printf '%s' \"$TYPECLAW_GIT_EXPECTED_REPO\" | tr '[:upper:]' '[:lower:]')\n prompt=$(printf '%s' \"$1\" | tr '[:upper:]' '[:lower:]')\n case \"$prompt\" in\n *//github.com/\"$expected_repo\"\\'*|*//github.com/\"$expected_repo\".git\\'*|*//*@github.com/\"$expected_repo\"\\'*|*//*@github.com/\"$expected_repo\".git\\'*) : ;;\n *) exit 1 ;;\n esac\nfi\ncase \"$1\" in\n *Username*) printf '%s\\n' 'x-access-token' ;;\n *) printf '%s\\n' \"$TYPECLAW_GIT_TOKEN\" ;;\nesac\n";
2
+ export declare const TYPECLAW_GIT_ASKPASS_PATH = "/usr/local/bin/typeclaw-git-askpass";
3
+ export declare function resolveSandboxGitAskPassPath(): string;
4
+ export declare function resetGitAskPassHelperForTests(): void;
5
+ export declare function ensureGitAskPassHelper(path?: string): Promise<string>;
@@ -0,0 +1,6 @@
1
+ export declare const ACKNOWLEDGE_GUARDS = "acknowledgeGuards";
2
+ export declare const GUARD_IMAGE_READ_REDIRECT = "imageReadRedirect";
3
+ export declare const GUARD_NON_WORKSPACE_WRITE = "nonWorkspaceWrite";
4
+ export declare const GUARD_GLOBAL_INSTALL = "globalInstall";
5
+ export declare const GUARD_NON_BUN_PACKAGE_MANAGER = "nonBunPackageManager";
6
+ export declare const GUARD_NON_BUN_PACKAGE_RUNNER = "nonBunPackageRunner";
@@ -0,0 +1,7 @@
1
+ import type { GuardBlock } from "../policy.js";
2
+ export declare const GUARD_MANAGED_CONFIG = "managedConfig";
3
+ export declare function checkManagedConfigGuard(options: {
4
+ tool: string;
5
+ args: Record<string, unknown>;
6
+ agentDir: string;
7
+ }): Promise<GuardBlock | undefined>;
@@ -0,0 +1,11 @@
1
+ import type { SessionOrigin } from "../../../agent/session-origin.js";
2
+ import type { SecuritySeverity } from "../../security/permissions.js";
3
+ import type { GuardBlock } from "../policy.js";
4
+ export declare const GUARD_MEMORY_TOPICS_DELETE = "memoryTopicsDelete";
5
+ export declare const GUARD_MEMORY_TOPICS_DELETE_SEVERITY: SecuritySeverity;
6
+ export declare function checkMemoryTopicsDeleteGuard(options: {
7
+ tool: string;
8
+ args: Record<string, unknown>;
9
+ agentDir: string;
10
+ origin?: SessionOrigin;
11
+ }): GuardBlock | undefined;
@@ -0,0 +1,7 @@
1
+ import type { SessionOrigin } from "../../../agent/session-origin.js";
2
+ export declare function isMemoryTopicsWriteAllowed(options: {
3
+ tool: string;
4
+ args: Record<string, unknown>;
5
+ agentDir: string;
6
+ origin?: SessionOrigin;
7
+ }): Promise<boolean>;
@@ -0,0 +1,9 @@
1
+ import type { InternalGuardResult } from "../../../agent/guard-types.js";
2
+ import type { SessionOrigin } from "../../../agent/session-origin.js";
3
+ export { GUARD_NON_WORKSPACE_WRITE } from "../keys.js";
4
+ export declare function checkNonWorkspaceWriteGuard(options: {
5
+ tool: string;
6
+ args: Record<string, unknown>;
7
+ agentDir: string;
8
+ origin?: SessionOrigin;
9
+ }): Promise<InternalGuardResult>;
@@ -0,0 +1,20 @@
1
+ import type { GuardBlock } from "../policy.js";
2
+ export declare const GUARD_SKILL_AUTHORING = "skillAuthoring";
3
+ export type SkillAuthoringDecision = GuardBlock | {
4
+ allow: true;
5
+ } | undefined;
6
+ export declare function checkSkillAuthoringGuard(options: {
7
+ tool: string;
8
+ args: Record<string, unknown>;
9
+ agentDir: string;
10
+ }): Promise<GuardBlock | undefined>;
11
+ export declare function checkSkillAuthoringDecision(options: {
12
+ tool: string;
13
+ args: Record<string, unknown>;
14
+ agentDir: string;
15
+ }): Promise<SkillAuthoringDecision>;
16
+ export declare function isSkillAuthoringAllowed(options: {
17
+ tool: string;
18
+ args: Record<string, unknown>;
19
+ agentDir: string;
20
+ }): Promise<boolean>;
@@ -0,0 +1,12 @@
1
+ import type { ToolResult } from "../../../plugin/index.js";
2
+ export declare const GUARD_UNCOMMITTED_CHANGES = "uncommittedChanges";
3
+ export type UncommittedChangesDeps = {
4
+ readStatus: (agentDir: string, gitArgs: readonly string[]) => Promise<readonly string[] | null>;
5
+ };
6
+ export declare function checkUncommittedChangesAdvice(options: {
7
+ tool: string;
8
+ agentDir: string;
9
+ result: ToolResult;
10
+ deps?: UncommittedChangesDeps;
11
+ }): Promise<void>;
12
+ export declare function parsePorcelain(stdout: string): string[];
@@ -0,0 +1,11 @@
1
+ export { ACKNOWLEDGE_GUARDS } from "./keys.js";
2
+ export type GuardBlock = {
3
+ block: true;
4
+ reason: string;
5
+ };
6
+ export { GUARD_MANAGED_CONFIG, checkManagedConfigGuard } from "./policies/managed-config.js";
7
+ export { GUARD_NON_WORKSPACE_WRITE, checkNonWorkspaceWriteGuard } from "./policies/non-workspace-write.js";
8
+ export { GUARD_SKILL_AUTHORING, checkSkillAuthoringDecision, checkSkillAuthoringGuard, isSkillAuthoringAllowed, } from "./policies/skill-authoring.js";
9
+ export { GUARD_MEMORY_TOPICS_DELETE, checkMemoryTopicsDeleteGuard } from "./policies/memory-topics-delete.js";
10
+ export { isMemoryTopicsWriteAllowed } from "./policies/memory-topics-write.js";
11
+ export { GUARD_UNCOMMITTED_CHANGES, checkUncommittedChangesAdvice } from "./policies/uncommitted-changes.js";
@@ -0,0 +1,11 @@
1
+ export type SecretRule = {
2
+ readonly name: string;
3
+ readonly pattern: RegExp;
4
+ };
5
+ export declare const SECRET_RULES: readonly SecretRule[];
6
+ export type SecretMatch = {
7
+ readonly rule: string;
8
+ readonly index: number;
9
+ };
10
+ export declare function detectSecrets(content: string): SecretMatch[];
11
+ export declare function isSecretShapedToken(token: string): boolean;
@@ -0,0 +1,4 @@
1
+ export declare const SLUG_REGEX: RegExp;
2
+ export declare function isValidSlug(slug: string): boolean;
3
+ export declare function headingToSlug(heading: string, existingSlugs: Set<string>): string;
4
+ export declare function slugIsHeadingEcho(heading: string, slug: string): boolean;
@@ -0,0 +1,20 @@
1
+ export type SecuritySeverity = 'low' | 'medium' | 'high';
2
+ export declare const SECURITY_PERMISSIONS: {
3
+ readonly bypassSecretExfilBash: "security.bypass.secretExfilBash";
4
+ readonly bypassGitExfil: "security.bypass.gitExfil";
5
+ readonly bypassSecretExfilRead: "security.bypass.secretExfilRead";
6
+ readonly bypassSsrf: "security.bypass.ssrf";
7
+ readonly bypassSessionSearchSecrets: "security.bypass.sessionSearchSecrets";
8
+ readonly bypassSystemPromptLeak: "security.bypass.systemPromptLeak";
9
+ readonly bypassOutboundSecret: "security.bypass.outboundSecret";
10
+ readonly bypassGitRemoteTainted: "security.bypass.gitRemoteTainted";
11
+ readonly bypassRolePromotion: "security.bypass.rolePromotion";
12
+ readonly bypassCronPromotion: "security.bypass.cronPromotion";
13
+ readonly bypassPluginAddition: "security.bypass.pluginAddition";
14
+ readonly bypassLow: "security.bypass.low";
15
+ readonly bypassMedium: "security.bypass.medium";
16
+ readonly bypassHigh: "security.bypass.high";
17
+ };
18
+ export type SecurityPermission = (typeof SECURITY_PERMISSIONS)[keyof typeof SECURITY_PERMISSIONS];
19
+ export declare const SEVERITY_PERMISSION: Record<SecuritySeverity, string>;
20
+ export declare const HIGH_TIER_PER_GUARD_PERMISSIONS: readonly string[];
@@ -0,0 +1,34 @@
1
+ import { type Dir, type Stats } from 'node:fs';
2
+ import type { ToolFileOperands, ToolProvenance } from "../../../plugin/index.js";
3
+ import { type HiddenPaths } from "../../../sandbox/index.js";
4
+ import type { SecurityBlock } from "../policy.js";
5
+ export declare const GUARD_PRIVATE_SURFACE_READ = "privateSurfaceRead";
6
+ export declare function checkPrivateSurfaceReadGuard(options: {
7
+ tool: string;
8
+ args: Record<string, unknown>;
9
+ agentDir: string;
10
+ hidden: HiddenPaths;
11
+ fileOperands?: ToolFileOperands;
12
+ toolProvenance?: ToolProvenance;
13
+ }, hooks?: PrivateSurfaceIdentityScanHooks): SecurityBlock | undefined;
14
+ type PrivateSurfaceIdentityOptions = {
15
+ tool: string;
16
+ agentDir: string;
17
+ hidden: HiddenPaths;
18
+ };
19
+ export type PrivateSurfaceIdentityScanHooks = {
20
+ maxEntries?: number;
21
+ openDirectory?(directory: string): Pick<Dir, 'readSync' | 'closeSync'>;
22
+ lstat?(candidate: string): Stats;
23
+ realpathNative?(candidate: string): string;
24
+ onInternalError?(error: unknown): void;
25
+ afterEntryLstat?(candidate: string, stats: Stats): void;
26
+ };
27
+ export type PrivateSurfaceIdentityVerifier = {
28
+ check(identity: Pick<Stats, 'dev' | 'ino' | 'nlink'>): SecurityBlock | undefined;
29
+ };
30
+ export declare function createPrivateSurfaceReadIdentityVerifier(options: PrivateSurfaceIdentityOptions, hooks?: PrivateSurfaceIdentityScanHooks): PrivateSurfaceIdentityVerifier;
31
+ export declare function checkPrivateSurfaceReadIdentityGuard(options: PrivateSurfaceIdentityOptions & {
32
+ identity: Pick<Stats, 'dev' | 'ino' | 'nlink'>;
33
+ }, hooks?: PrivateSurfaceIdentityScanHooks): SecurityBlock | undefined;
34
+ export {};
@@ -0,0 +1,18 @@
1
+ import { type InternalDestinationPolicy } from "../../../network/internal-destinations.js";
2
+ import type { SecuritySeverity } from "../permissions.js";
3
+ import type { SecurityBlock } from "../policy.js";
4
+ export declare const GUARD_SSRF = "ssrf";
5
+ export declare const GUARD_SSRF_SEVERITY: SecuritySeverity;
6
+ export type SsrfClassification = {
7
+ blocked: boolean;
8
+ category?: 'loopback' | 'private_ipv4' | 'link_local' | 'cloud_metadata' | 'ipv6_internal' | 'unspecified' | 'shared_cgnat' | 'reserved_internal_host' | 'unsupported_scheme';
9
+ reason?: string;
10
+ };
11
+ export declare function classifyUrl(rawUrl: string, internalDestinationPolicy?: InternalDestinationPolicy): SsrfClassification;
12
+ export declare function classifyIpAddress(address: string): SsrfClassification;
13
+ export declare function allowsInternalDestination(hostname: string, address: string | undefined, policy: InternalDestinationPolicy): boolean;
14
+ export declare function checkSsrfGuard(options: {
15
+ tool: string;
16
+ args: Record<string, unknown>;
17
+ internalDestinationPolicy?: InternalDestinationPolicy;
18
+ }): SecurityBlock | undefined;
@@ -0,0 +1,4 @@
1
+ export type SecurityBlock = {
2
+ block: true;
3
+ reason: string;
4
+ };
@@ -0,0 +1,2 @@
1
+ import type { AdapterId } from "./schema.js";
2
+ export declare function adapterNamespace(adapter: AdapterId): AdapterId;
@@ -0,0 +1,12 @@
1
+ import type { AdapterId } from "../schema.js";
2
+ export type DiscordMentionUser = {
3
+ id: string;
4
+ username?: string;
5
+ global_name?: string | null;
6
+ };
7
+ export type MentionHintOptions = {
8
+ botUserId?: string | null;
9
+ };
10
+ export declare function extractMentionedUserIds(adapter: AdapterId, text: string): string[];
11
+ export declare function addSlackMentionHints(text: string, resolveUserName: (id: string) => Promise<string>, options?: MentionHintOptions): Promise<string>;
12
+ export declare function addDiscordMentionHints(text: string, usersById: Map<string, DiscordMentionUser>, options?: MentionHintOptions): string;
@@ -0,0 +1,5 @@
1
+ import type { WebexRestIdType } from 'agent-messenger/webex';
2
+ export { decodeWebexId } from 'agent-messenger/webex';
3
+ export type { DecodedWebexId, WebexRestIdType } from 'agent-messenger/webex';
4
+ export declare function toRef(id: string): string;
5
+ export declare function isWebexIdOfType(id: string, type: WebexRestIdType): boolean;
@@ -0,0 +1,56 @@
1
+ import { type RecoveryRecord } from "./continuity-types.js";
2
+ import type { ChannelKey, ReactionRef } from "./types.js";
3
+ export type BackgroundInventoryRecord = {
4
+ schemaVersion: 1;
5
+ generationId: string;
6
+ processEpoch: string;
7
+ parentSessionId: string;
8
+ parentSessionFile?: string;
9
+ key: ChannelKey;
10
+ triggeringAuthorId?: string;
11
+ parentChat?: string;
12
+ accountIdentity?: string;
13
+ recoveryTransfer?: {
14
+ phase: 'notice-prepared' | 'notice-owned';
15
+ record: RecoveryRecord;
16
+ };
17
+ tasks: {
18
+ taskId: string;
19
+ subagentName: string;
20
+ startedAt: number;
21
+ accountIdentity?: string;
22
+ triggerReactionRef?: ReactionRef;
23
+ }[];
24
+ };
25
+ export type BackgroundRecoveryIdentity = {
26
+ accountIdentity: string;
27
+ accountIdentityConflict?: string[];
28
+ };
29
+ /** Resolve admitted task evidence; legacy group identity applies only to absent row fields. */
30
+ export declare function resolveBackgroundRecoveryIdentity(record: BackgroundInventoryRecord): BackgroundRecoveryIdentity;
31
+ /** Frozen PR1 identity; upgrading the source must not create another delivery. */
32
+ export declare function createLegacyRecoveryNotice(source: BackgroundInventoryRecord): RecoveryRecord;
33
+ export type ClaimedBackgroundInventory = {
34
+ record: BackgroundInventoryRecord;
35
+ claimPath: string;
36
+ };
37
+ export declare class LegacyBackgroundHandoffReader {
38
+ /** Upgrade-only legacy reader. New launches are admitted by BackgroundObligationStore. */
39
+ readonly processEpoch: string;
40
+ private readonly directory;
41
+ private readonly bootStartedAt;
42
+ private readonly onError;
43
+ private readonly ownedClaims;
44
+ constructor(agentDir: string, options?: {
45
+ processEpoch?: string;
46
+ now?: () => number;
47
+ onError?: (error: unknown) => void;
48
+ });
49
+ private report;
50
+ private files;
51
+ claim(): Promise<ClaimedBackgroundInventory[]>;
52
+ prepareRecovery(claim: ClaimedBackgroundInventory, record: RecoveryRecord): Promise<RecoveryRecord>;
53
+ ownRecovery(claim: ClaimedBackgroundInventory, record: RecoveryRecord): Promise<RecoveryRecord>;
54
+ private updateRecovery;
55
+ retire(claim: ClaimedBackgroundInventory): Promise<void>;
56
+ }