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,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
+ }
@@ -0,0 +1,135 @@
1
+ import type { MatchableOrigin } from "../permissions/resolve.js";
2
+ import type { LegacyBackgroundHandoffReader } from "./background-handoff.js";
3
+ import type { RecoveryNoticeCause, RecoveryRecord } from "./continuity-types.js";
4
+ import type { RecoveryOutbox } from "./recovery-outbox.js";
5
+ import { type ChannelKey } from "./types.js";
6
+ export type BackgroundObligationRef = {
7
+ obligationId: string;
8
+ generation: number;
9
+ };
10
+ export type BackgroundApplicationReceipt = {
11
+ transitionId: string;
12
+ decisionDigest: string;
13
+ expectedGeneration: number;
14
+ resultingGeneration: number;
15
+ };
16
+ export type BackgroundObligation = BackgroundObligationRef & {
17
+ schemaVersion: 1;
18
+ taskId: string;
19
+ parentSessionId: string;
20
+ parentSessionFile?: string;
21
+ accountIdentity: string;
22
+ target: ChannelKey;
23
+ principal: MatchableOrigin;
24
+ acceptedAt: number;
25
+ epoch: string;
26
+ phase: 'accepted' | 'result-ready' | 'turn-owned' | 'notice-prepared' | 'notice-owned' | 'closed';
27
+ completionId?: string;
28
+ claim?: {
29
+ turnId: string;
30
+ ownerSessionId?: string;
31
+ epoch: string;
32
+ generation: number;
33
+ };
34
+ transfer?: RecoveryRecord;
35
+ legacyCoverage?: {
36
+ id: string;
37
+ generation: number;
38
+ };
39
+ outcome?: {
40
+ kind: 'delivered' | 'intentionally-suppressed';
41
+ decisionId: string;
42
+ reason?: string;
43
+ deliveryId?: string;
44
+ };
45
+ applications: BackgroundApplicationReceipt[];
46
+ };
47
+ export type BackgroundAcceptance = {
48
+ taskId: string;
49
+ parentSessionId: string;
50
+ parentSessionFile?: string;
51
+ accountIdentity: string;
52
+ target?: ChannelKey;
53
+ key?: ChannelKey;
54
+ principal?: MatchableOrigin;
55
+ triggeringAuthorId?: string;
56
+ parentChat?: string;
57
+ acceptedAt?: number;
58
+ startedAt?: number;
59
+ subagentName?: string;
60
+ legacyGeneration?: string;
61
+ };
62
+ export type BackgroundDecision = {
63
+ transitionId: string;
64
+ decisionDigest: string;
65
+ };
66
+ declare function parse(value: unknown): BackgroundObligation;
67
+ export declare class BackgroundObligationStore {
68
+ private readonly options;
69
+ readonly epoch: string;
70
+ private readonly directory;
71
+ private frozen?;
72
+ constructor(agentDir: string, options?: {
73
+ epoch?: string;
74
+ now?: () => number;
75
+ onError?: (error: unknown) => void;
76
+ onDurability?: (phase: 'temp-synced' | 'replaced' | 'directory-synced', row: BackgroundObligation) => void | Promise<void>;
77
+ });
78
+ assertAvailable(): void;
79
+ /** PR3 journal repair must finish before any dependent background progress. */
80
+ setFrozen(error?: unknown): void;
81
+ private check;
82
+ private path;
83
+ private serialize;
84
+ run<T>(target: ChannelKey, action: () => Promise<T>): Promise<T>;
85
+ withTargetLane<T>(target: ChannelKey, action: () => Promise<T>): Promise<T>;
86
+ private read;
87
+ private write;
88
+ get(id: string): Promise<BackgroundObligation | undefined>;
89
+ list(): Promise<BackgroundObligation[]>;
90
+ /** Builds the lookup index with one directory scan per process; later lookups never scan. */
91
+ private index;
92
+ private indexedRows;
93
+ /** Exact parent/task row, closed tombstones included so a late completion cannot reopen work. */
94
+ lookup(parentSessionId: string, taskId: string): Promise<BackgroundObligation | undefined>;
95
+ /** Task row on one destination, for a successor session fetching a predecessor's result. */
96
+ lookupTask(taskId: string, target: ChannelKey): Promise<BackgroundObligation | undefined>;
97
+ private deliveryRows;
98
+ accept(input: BackgroundAcceptance): Promise<BackgroundObligation>;
99
+ resultReady(input: string | {
100
+ parentSessionId: string;
101
+ taskId: string;
102
+ }, completionId?: string): Promise<BackgroundObligation | undefined>;
103
+ apply(ref: BackgroundObligationRef, decision: BackgroundDecision, change: (row: Readonly<BackgroundObligation>) => BackgroundObligation): Promise<BackgroundObligation | undefined>;
104
+ /** Only journal replay may apply a committed decision while dependent work is frozen. */
105
+ applyJournalDecision(ref: BackgroundObligationRef, decision: BackgroundDecision, change: (row: Readonly<BackgroundObligation>) => BackgroundObligation): Promise<BackgroundObligation | undefined>;
106
+ private applyDecision;
107
+ claim(refs: BackgroundObligationRef[], owner: {
108
+ turnId: string;
109
+ ownerSessionId?: string;
110
+ target: ChannelKey;
111
+ }, decision?: BackgroundDecision): Promise<BackgroundObligationRef[]>;
112
+ move(refs: BackgroundObligationRef[], owner: {
113
+ fromTurnId: string;
114
+ turnId: string;
115
+ ownerSessionId?: string;
116
+ target: ChannelKey;
117
+ }, decision?: BackgroundDecision): Promise<BackgroundObligationRef[]>;
118
+ settle(refs: BackgroundObligationRef[], outcome: NonNullable<BackgroundObligation['outcome']>, decision?: BackgroundDecision): Promise<void>;
119
+ /**
120
+ * Freezes this child's transfer. Boot recovery keeps the default `restart`; a same-process
121
+ * abandonment passes `live-turn-ended`. An already-frozen transfer is returned unchanged.
122
+ */
123
+ prepareNotice(id: string, expectedGeneration: number, cause?: RecoveryNoticeCause): Promise<BackgroundObligation | undefined>;
124
+ ownNotice(id: string, expectedGeneration: number, deliveryId: string): Promise<BackgroundObligation | undefined>;
125
+ validateNotice(record: RecoveryRecord): Promise<'open' | 'resolved'>;
126
+ acknowledgeNotice(record: RecoveryRecord): Promise<void>;
127
+ suppressNoticeCoverage(record: RecoveryRecord, decision: {
128
+ decisionId: string;
129
+ reason: string;
130
+ }): Promise<void>;
131
+ migrateLegacy(reader: LegacyBackgroundHandoffReader, outbox: RecoveryOutbox): Promise<void>;
132
+ importOldEpoch(outbox: RecoveryOutbox): Promise<void>;
133
+ flush(): Promise<void>;
134
+ }
135
+ export { parse as parseBackgroundObligation };
@@ -0,0 +1,26 @@
1
+ import type { AdapterId } from "./schema.js";
2
+ import type { InboundMessage, RouteReceipt } from "./types.js";
3
+ export declare const CHAT_CATCH_UP_MAX_AGE_MS: number;
4
+ export declare const CATCH_UP_HEARTBEAT_MS: number;
5
+ export declare const CATCH_UP_CONVERSATION_LIMIT = 20;
6
+ export type MissedInbound = {
7
+ readonly message: InboundMessage;
8
+ readonly latestTs: number;
9
+ };
10
+ export type ListMissedInbound = (since: number) => Promise<readonly MissedInbound[]>;
11
+ export declare function createInboundCatchUp(options: {
12
+ agentDir: string;
13
+ route: (message: InboundMessage) => Promise<RouteReceipt>;
14
+ logger: {
15
+ info: (message: string) => void;
16
+ warn: (message: string) => void;
17
+ };
18
+ now?: () => number;
19
+ }): {
20
+ noteObserved(message: InboundMessage): void;
21
+ register(adapter: AdapterId, callback: ListMissedInbound): void;
22
+ unregister(adapter: AdapterId, callback: ListMissedInbound): void;
23
+ disconnect(adapter: AdapterId): void;
24
+ run: (adapter: AdapterId) => Promise<void>;
25
+ stop(): Promise<void>;
26
+ };
@@ -0,0 +1,2 @@
1
+ import type { CommandInfo } from "../commands/index.js";
2
+ export declare function formatChannelCommandHelp(commands: readonly CommandInfo[]): string;
@@ -0,0 +1,20 @@
1
+ export type CompletionClaimDecision = {
2
+ kind: 'allow';
3
+ } | {
4
+ kind: 'block';
5
+ reason: string;
6
+ } | {
7
+ kind: 'warn';
8
+ notice: string;
9
+ };
10
+ export type CompletionClaimInput = {
11
+ text: string | undefined;
12
+ qualifyingWorkObserved: boolean;
13
+ };
14
+ export type ToolResultEvidenceInput = {
15
+ toolName: string;
16
+ isError: boolean;
17
+ details: unknown;
18
+ };
19
+ export declare function checkCompletionClaim(input: CompletionClaimInput): CompletionClaimDecision;
20
+ export declare function isQualifyingWorkResult(input: ToolResultEvidenceInput): boolean;
@@ -0,0 +1 @@
1
+ export declare function detectContinuationWillingness(text: string): boolean;
@@ -0,0 +1,75 @@
1
+ import type { MatchableOrigin } from "../permissions/resolve.js";
2
+ import type { ChannelKey } from "./types.js";
3
+ export type RecoveryCoverage = {
4
+ store: 'inventory' | 'background' | 'inbound';
5
+ id: string;
6
+ generation: number;
7
+ parentSessionId?: string;
8
+ };
9
+ export type RecoveryLease = {
10
+ epoch: string;
11
+ generation: number;
12
+ attemptId: string;
13
+ acquiredAt: number;
14
+ };
15
+ export type RecoveryReceipt = {
16
+ confirmedAt: number;
17
+ messageId?: string;
18
+ messageIds?: string[];
19
+ };
20
+ export type RecoveryFailure = {
21
+ kind: 'transient' | 'rate-limit' | 'unavailable' | 'permission' | 'identity' | 'target' | 'configuration';
22
+ safeReason: string;
23
+ /** Milliseconds until another attempt is permitted. */
24
+ retryAfter?: number;
25
+ };
26
+ /**
27
+ * Why owed coverage was transferred to a notice. `restart` is the frozen RFC en/v1 boot-recovery
28
+ * notice (schemaVersion 1, no `cause` field). `live-turn-ended` is a same-process turn that ended
29
+ * without a confirmed reply; it is a distinct schemaVersion 2 record and never claims a restart.
30
+ */
31
+ export type RecoveryNoticeCause = 'restart' | 'live-turn-ended';
32
+ export type RecoveryRecord = {
33
+ schemaVersion: 1 | 2;
34
+ deliveryId: string;
35
+ purpose: 'interruption-notice';
36
+ /** Present exactly on schemaVersion 2; absent means the frozen v1 restart notice. */
37
+ cause?: Exclude<RecoveryNoticeCause, 'restart'>;
38
+ target: ChannelKey;
39
+ accountIdentity: string;
40
+ accountIdentityConflict?: string[];
41
+ boundAccountIdentity?: string;
42
+ principal: MatchableOrigin;
43
+ sourceParentSessionId?: string;
44
+ covers: RecoveryCoverage[];
45
+ transferId: string;
46
+ recoveryGeneration: string;
47
+ templateVersion: 1;
48
+ locale: 'en';
49
+ text: string;
50
+ createdAt: number;
51
+ generation: number;
52
+ state: 'pending' | 'leased' | 'delivered' | 'blocked' | 'suppressed';
53
+ lease?: RecoveryLease;
54
+ attempts: number;
55
+ nextAttemptAt?: number;
56
+ receipt?: RecoveryReceipt;
57
+ failure?: RecoveryFailure;
58
+ suppression?: {
59
+ reason: string;
60
+ decisionId: string;
61
+ };
62
+ };
63
+ export declare const RECOVERY_NOTICE_TEXT = "\u26A0\uFE0F I restarted before I could confirm a reply to your earlier request. I didn't rerun it automatically \u2014 please ask again if you still need it.";
64
+ export declare const LIVE_TURN_ENDED_NOTICE_TEXT = "\u26A0\uFE0F My earlier turn ended before I could confirm a reply to your request. I didn't rerun it automatically \u2014 please ask again if you still need it.";
65
+ export declare function recoveryNoticeDisplayText(record: Pick<RecoveryRecord, 'text'>): string;
66
+ type DeliveryIdentity = Pick<RecoveryRecord, 'purpose' | 'target' | 'accountIdentity' | 'covers' | 'recoveryGeneration' | 'cause'>;
67
+ export declare function recoveryDeliveryId(record: DeliveryIdentity): string;
68
+ export declare function recoveryNoticeCause(record: Pick<RecoveryRecord, 'cause'>): RecoveryNoticeCause;
69
+ export declare function validateRecoveryRecord(value: unknown): value is RecoveryRecord;
70
+ export declare function parseRecoveryRecord(value: unknown): RecoveryRecord;
71
+ /** Stable comparison of the frozen transfer payload, excluding dispatch state. */
72
+ export declare function recoveryPayload(record: RecoveryRecord): string;
73
+ /** Fixed-size fence for a frozen transfer payload once the full record is no longer retained. */
74
+ export declare function recoveryPayloadDigest(record: RecoveryRecord): string;
75
+ export {};
@@ -0,0 +1 @@
1
+ export declare function describeError(err: unknown): string;