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,7 @@
1
+ import { type SandboxPolicy } from "./policy.js";
2
+ export type SandboxedCommand = {
3
+ argv: string[];
4
+ commandString: string;
5
+ spawnEnv: Record<string, string>;
6
+ };
7
+ export declare function buildSandboxedCommand(command: string, policy?: SandboxPolicy): SandboxedCommand;
@@ -0,0 +1,8 @@
1
+ export declare const BROWSER_PROFILE_RELATIVE_DIR = ".typeclaw/browser-profile";
2
+ export declare const RUNTIME_OWNED_SECRET_DIRS: readonly ["workspace/.agent-messenger", ".typeclaw/home", ".typeclaw/logs", ".typeclaw/browser-profile"];
3
+ export declare const OPERATOR_CLI_CREDENTIAL_DIRS: readonly ["workspace/.config/gws", "workspace/.config/agent-messenger"];
4
+ export declare const CANONICAL_AGENT_SECRET_DIRS: readonly ["workspace/.config/gws", "workspace/.config/agent-messenger", "workspace/.agent-messenger", ".typeclaw/home", ".typeclaw/logs", ".typeclaw/browser-profile"];
5
+ export declare const CANONICAL_AGENT_SECRET_FILES: readonly [".env", "secrets.json", "auth.json"];
6
+ export declare const CONTAINER_RUNTIME_HOME = "/home/agent";
7
+ export declare const CANONICAL_HOME_SECRET_DIRS: readonly [".ssh", ".config/gh", ".config/gws", ".config/agent-messenger", ".agent-messenger", ".codex", ".claude"];
8
+ export declare const CANONICAL_HOME_SECRET_FILES: readonly [".gitconfig", ".claude.json", ".netrc"];
@@ -0,0 +1,20 @@
1
+ import { type SandboxedCommand } from "./build.js";
2
+ import { type SandboxPolicy, type SandboxProcStrategy } from "./policy.js";
3
+ export declare const CODING_SOURCE = "/typeclaw-coding-source";
4
+ export declare const CODING_MASK_DIRS: readonly ["workspace/.config/gws", "workspace/.config/agent-messenger", "workspace/.agent-messenger", ".typeclaw/home", ".typeclaw/logs", ".typeclaw/browser-profile", ...(".ssh" | ".config/gh" | ".config/gws" | ".config/agent-messenger" | ".agent-messenger")[], ".typeclaw"];
5
+ export declare const CODING_MASK_FILES: readonly [".env", "secrets.json", "auth.json", ".gitconfig", ".claude.json", ".netrc", ".typeclaw/incidents.json", ".typeclaw/coding-agent-tasks.json", ".claude/.credentials.json", ".codex/auth.json"];
6
+ export declare function codingSourceMaskDirs(source: string, taskRoot: string): readonly string[];
7
+ export type CodingSandboxOptions = {
8
+ readonly source: string;
9
+ readonly taskRoot: string;
10
+ readonly mode: 'code' | 'plan' | 'snapshot';
11
+ readonly cwd: string;
12
+ readonly env?: Record<string, string>;
13
+ readonly engine?: 'claude' | 'codex' | 'omo';
14
+ };
15
+ export declare function assertCodingDirectory(path: string): Promise<void>;
16
+ export declare function codingSandboxPolicy(options: CodingSandboxOptions, proc: SandboxProcStrategy): Promise<SandboxPolicy>;
17
+ export declare function prepareCodingCommand(argv: readonly string[], options: CodingSandboxOptions): Promise<SandboxedCommand & {
18
+ extraFiles: Array<number | 'ignore'>;
19
+ cleanup(): Promise<void>;
20
+ }>;
@@ -0,0 +1,19 @@
1
+ import { type DependencyBinIssue, type ResolvedDependencyBin } from "../dependencies/index.js";
2
+ export declare const DEPENDENCY_BIN_DIR_NAME = "typeclaw-dependency-bin";
3
+ export declare const DEPENDENCY_BIN_SANDBOX_DIR = "/tmp/typeclaw-dependency-bin";
4
+ export declare const DEPENDENCY_BIN_SANDBOX_PATH = "/tmp/typeclaw-dependency-bin:/usr/local/bin:/usr/bin:/bin";
5
+ export type DependencyBinReconciliation = {
6
+ wrapperDir: string;
7
+ resolutions: ResolvedDependencyBin[];
8
+ unavailable: Extract<ResolvedDependencyBin, {
9
+ kind: 'unavailable';
10
+ }>[];
11
+ issues: DependencyBinIssue[];
12
+ protectedFiles: string[];
13
+ };
14
+ export declare function reconcileDependencyBinWrappers(options: {
15
+ agentDir: string;
16
+ sessionTmp: string;
17
+ baselineDirs?: readonly string[];
18
+ }): Promise<DependencyBinReconciliation>;
19
+ export declare function dependencyBinUnavailableHint(command: string, reconciliation: DependencyBinReconciliation): string | undefined;
@@ -0,0 +1,4 @@
1
+ import type { SandboxMount } from "./policy.js";
2
+ export declare function resolveDevSourceMount(agentDir: string, moduleFile?: string): Promise<Extract<SandboxMount, {
3
+ type: 'ro-bind';
4
+ }> | undefined>;
@@ -0,0 +1 @@
1
+ export declare function resolveExposableEnvNames(declaredEnv: ReadonlyMap<string, string>, runtimeEnv?: Readonly<Record<string, string | undefined>>): string[];
@@ -0,0 +1,20 @@
1
+ export declare class SandboxUnavailableError extends Error {
2
+ readonly name = "SandboxUnavailableError";
3
+ constructor();
4
+ }
5
+ export declare class SandboxMaskTargetError extends Error {
6
+ readonly name = "SandboxMaskTargetError";
7
+ constructor(target: string, reason: string);
8
+ }
9
+ export declare class SandboxPolicyError extends Error {
10
+ readonly name = "SandboxPolicyError";
11
+ constructor(reason: string);
12
+ }
13
+ export declare class SandboxDegradedProcError extends Error {
14
+ readonly name = "SandboxDegradedProcError";
15
+ constructor();
16
+ }
17
+ export declare class SandboxProcProbeUnverifiedError extends Error {
18
+ readonly name = "SandboxProcProbeUnverifiedError";
19
+ constructor();
20
+ }
@@ -0,0 +1,11 @@
1
+ import type { SessionOrigin } from "../agent/session-origin.js";
2
+ import type { PermissionService } from "../permissions/permissions.js";
3
+ export type HiddenPaths = {
4
+ dirs: string[];
5
+ files: string[];
6
+ };
7
+ export declare function resolveHiddenPaths(permissions: PermissionService, origin: SessionOrigin | undefined, agentDir: string): HiddenPaths;
8
+ export declare function canWriteAgentRootInSandbox(permissions: PermissionService, origin: SessionOrigin | undefined): boolean;
9
+ export declare function ensureHiddenMaskTargets(hidden: HiddenPaths): Promise<HiddenPaths>;
10
+ export declare function verifyHiddenMaskTargets(hidden: HiddenPaths): Promise<void>;
11
+ export declare function rejectHardlinkAliases(root: string, maxEntries?: number): Promise<void>;
@@ -0,0 +1,14 @@
1
+ export { buildSandboxedCommand, type SandboxedCommand } from "./build.js";
2
+ export { CANONICAL_AGENT_SECRET_DIRS, CANONICAL_AGENT_SECRET_FILES, CANONICAL_HOME_SECRET_DIRS, CANONICAL_HOME_SECRET_FILES, CONTAINER_RUNTIME_HOME, OPERATOR_CLI_CREDENTIAL_DIRS, RUNTIME_OWNED_SECRET_DIRS, } from "./canonical-secrets.js";
3
+ export { CANONICAL_AGENT_RUNTIME_PRIVATE_FILES } from "./runtime-private.js";
4
+ export { buildProcBindProbeScript, canBindProcSafely, canMountRealProc, ensureBwrapAvailable, getProcBindSafetyVerdict, PROC_BIND_RETRY_BACKOFF_MS, resolveProcBindSafetyWithRetry, resolveProcSelfExe, type ProcBindSafetyVerdict, _resetBwrapAvailabilityCacheForTests, _resetProcBindProbeCacheForTests, _resetRealProcProbeCacheForTests, } from "./availability.js";
5
+ export { canWriteAgentRootInSandbox, ensureHiddenMaskTargets, resolveHiddenPaths, verifyHiddenMaskTargets, type HiddenPaths, } from "./hidden-paths.js";
6
+ export { resolveProtectedZones, resolveWritableZones, isGitControlPath, subtractMasked, type ProtectedZones, type WritableZones, } from "./writable-zones.js";
7
+ export { resolveSandboxSymlinks, type SandboxSymlinkSpec } from "./symlinks.js";
8
+ export { commandNeedsRealProc } from "./package-install.js";
9
+ export { cleanupPrivilegedSandboxRuntime, resolvePrivilegedSandboxRuntime, verifyPrivilegedSandboxRuntime, type PrivilegedSandboxRuntime, } from "./privileged-runtime.js";
10
+ export { ensureSessionTmpDir, isUnderTmp, mapVirtualTmpPath, SESSION_TMP_ROOT, enterSubagentTmpScope, sessionTmpDir, } from "./session-tmp.js";
11
+ export { DEPENDENCY_BIN_SANDBOX_DIR, DEPENDENCY_BIN_SANDBOX_PATH, dependencyBinUnavailableHint, reconcileDependencyBinWrappers, type DependencyBinReconciliation, } from "./dependency-bins.js";
12
+ export { formatCommand, shellQuote } from "./quote.js";
13
+ export { SandboxDegradedProcError, SandboxMaskTargetError, SandboxPolicyError, SandboxProcProbeUnverifiedError, SandboxUnavailableError, } from "./errors.js";
14
+ export { DEFAULT_SANDBOX_ENV, type SandboxCommandFilter, type SandboxEnvPolicy, type SandboxMount, type SandboxNetwork, type SandboxPolicy, type SandboxProcessPolicy, type SandboxProcStrategy, type SandboxProtectedPolicy, type SandboxSymlinkOp, type SandboxWritablePolicy, type SandboxWritableRootPolicy, } from "./policy.js";
@@ -0,0 +1 @@
1
+ export declare function commandNeedsRealProc(command: string): boolean;
@@ -0,0 +1,71 @@
1
+ export type SandboxMount = {
2
+ type: 'ro-bind';
3
+ source: string;
4
+ dest: string;
5
+ } | {
6
+ type: 'bind';
7
+ source: string;
8
+ dest: string;
9
+ } | {
10
+ type: 'ro-bind-fd' | 'bind-fd';
11
+ fd: number;
12
+ dest: string;
13
+ } | {
14
+ type: 'tmpfs';
15
+ dest: string;
16
+ } | {
17
+ type: 'dev';
18
+ dest: string;
19
+ };
20
+ export type SandboxNetwork = 'none' | 'inherit';
21
+ export type SandboxProcStrategy = 'tmpfs' | 'none' | 'real-proc' | 'proc-bind';
22
+ export type SandboxEnvPolicy = {
23
+ set?: Record<string, string>;
24
+ passthrough?: string[];
25
+ withhold?: string[];
26
+ inherit?: string[];
27
+ };
28
+ export type SandboxCommandFilter = {
29
+ allowPrefixes?: string[];
30
+ rejectShellMetacharacters?: boolean;
31
+ };
32
+ export type SandboxProcessPolicy = {
33
+ newSession?: boolean;
34
+ dieWithParent?: boolean;
35
+ };
36
+ export type SandboxMaskPolicy = {
37
+ dirs?: string[];
38
+ files?: string[];
39
+ };
40
+ export type SandboxWritablePolicy = {
41
+ dirs?: string[];
42
+ files?: string[];
43
+ };
44
+ export type SandboxProtectedPolicy = {
45
+ dirs?: string[];
46
+ files?: string[];
47
+ };
48
+ export type SandboxSymlinkOp = {
49
+ target: string;
50
+ dest: string;
51
+ };
52
+ export type SandboxWritableRootPolicy = {
53
+ dir: string;
54
+ };
55
+ export type SandboxPolicy = {
56
+ bwrapPath?: string;
57
+ cwd?: string;
58
+ procSelfExe?: string;
59
+ mounts?: SandboxMount[];
60
+ writableRoot?: SandboxWritableRootPolicy;
61
+ masks?: SandboxMaskPolicy;
62
+ writable?: SandboxWritablePolicy;
63
+ protected?: SandboxProtectedPolicy;
64
+ symlinks?: SandboxSymlinkOp[];
65
+ network?: SandboxNetwork;
66
+ env?: SandboxEnvPolicy;
67
+ commandFilter?: SandboxCommandFilter;
68
+ process?: SandboxProcessPolicy;
69
+ proc?: SandboxProcStrategy;
70
+ };
71
+ export declare const DEFAULT_SANDBOX_ENV: Record<string, string>;
@@ -0,0 +1,13 @@
1
+ import type { SandboxMount } from "./policy.js";
2
+ export type PrivilegedSandboxRuntime = {
3
+ env: Record<string, string>;
4
+ mounts: SandboxMount[];
5
+ };
6
+ export declare function resolvePrivilegedSandboxRuntime(options: {
7
+ agentDir: string;
8
+ command: string;
9
+ env?: NodeJS.ProcessEnv;
10
+ homeDir?: string;
11
+ }): Promise<PrivilegedSandboxRuntime>;
12
+ export declare function verifyPrivilegedSandboxRuntime(runtime: PrivilegedSandboxRuntime): Promise<void>;
13
+ export declare function cleanupPrivilegedSandboxRuntime(runtime: PrivilegedSandboxRuntime): Promise<void>;
@@ -0,0 +1,2 @@
1
+ export declare function shellQuote(arg: string): string;
2
+ export declare function formatCommand(argv: readonly string[]): string;
@@ -0,0 +1 @@
1
+ export declare const CANONICAL_AGENT_RUNTIME_PRIVATE_FILES: readonly [".typeclaw/incidents.json", ".typeclaw/coding-agent-tasks.json"];
@@ -0,0 +1,6 @@
1
+ export declare const SESSION_TMP_ROOT = "/tmp/typeclaw-session";
2
+ export declare function sessionTmpDir(sessionId: string): string;
3
+ export declare function enterSubagentTmpScope(sessionId: string, parentSessionId: string): () => void;
4
+ export declare function ensureSessionTmpDir(sessionId: string): Promise<string>;
5
+ export declare function isUnderTmp(agentDir: string, rawPath: string): boolean;
6
+ export declare function mapVirtualTmpPath(agentDir: string, sessionId: string, rawPath: string): string | undefined;
@@ -0,0 +1,6 @@
1
+ import type { SandboxSymlinkOp } from "./policy.js";
2
+ export type SandboxSymlinkSpec = {
3
+ from: string;
4
+ to: string;
5
+ };
6
+ export declare function resolveSandboxSymlinks(agentDir: string, specs: readonly SandboxSymlinkSpec[], sandboxHome: string): SandboxSymlinkOp[];
@@ -0,0 +1,15 @@
1
+ export type WritableZones = {
2
+ dirs: string[];
3
+ files: string[];
4
+ };
5
+ export type ProtectedZones = {
6
+ dirs: string[];
7
+ files: string[];
8
+ };
9
+ export declare function resolveWritableZones(agentDir: string, configuredWritablePaths?: readonly string[]): Promise<WritableZones>;
10
+ export declare function resolveProtectedZones(agentDir: string): Promise<ProtectedZones>;
11
+ export declare function isGitControlPath(agentDir: string, candidate: string): Promise<boolean>;
12
+ export declare function subtractMasked(writable: WritableZones, masked: {
13
+ dirs: string[];
14
+ files: string[];
15
+ }): WritableZones;
@@ -0,0 +1,25 @@
1
+ import type { CredentialStore } from '@earendil-works/pi-ai';
2
+ import { ModelRuntime } from '@earendil-works/pi-coding-agent';
3
+ /** Runtime-only value. Never serialize this into a tool receipt or child configuration. */
4
+ export type CodingAgentProvider = 'anthropic' | 'openai-codex';
5
+ export type CodingAgentAuth = {
6
+ readonly token: string;
7
+ readonly secrets: readonly string[];
8
+ } & ({
9
+ readonly provider?: 'anthropic';
10
+ readonly type: 'api_key' | 'oauth';
11
+ } | {
12
+ readonly provider: 'openai-codex';
13
+ readonly type: 'oauth';
14
+ readonly accountId: string;
15
+ });
16
+ export declare class CodingAgentAuthError extends Error {
17
+ constructor(provider: CodingAgentProvider);
18
+ }
19
+ export type CodingAgentAuthResolver = {
20
+ resolve(signal?: AbortSignal, rejected?: CodingAgentAuth, provider?: CodingAgentProvider): Promise<CodingAgentAuth>;
21
+ };
22
+ export declare function createCodingAgentAuthResolver(agentDir: string, dependencies?: {
23
+ credentials: CredentialStore;
24
+ runtime: ModelRuntime;
25
+ }): Promise<CodingAgentAuthResolver>;
@@ -0,0 +1,21 @@
1
+ import { type KnownProviderId } from "../config/providers.js";
2
+ export declare const CHANNEL_FIELD_ENV: {
3
+ readonly 'discord-bot': {
4
+ readonly token: "DISCORD_BOT_TOKEN";
5
+ };
6
+ readonly 'slack-bot': {
7
+ readonly botToken: "SLACK_BOT_TOKEN";
8
+ readonly appToken: "SLACK_APP_TOKEN";
9
+ };
10
+ readonly 'telegram-bot': {
11
+ readonly token: "TELEGRAM_BOT_TOKEN";
12
+ };
13
+ readonly 'webex-bot': {
14
+ readonly token: "WEBEX_BOT_TOKEN";
15
+ };
16
+ };
17
+ export type KnownAdapterId = keyof typeof CHANNEL_FIELD_ENV;
18
+ export declare function isKnownAdapterId(id: string): id is KnownAdapterId;
19
+ export declare function channelFieldDefaultEnv(adapterId: string, fieldName: string): string | undefined;
20
+ export declare function providerKeyDefaultEnv(providerId: string): string | undefined;
21
+ export declare function isKnownProviderId(id: string): id is KnownProviderId;
@@ -0,0 +1,22 @@
1
+ import type { GithubCliSecrets } from "./schema.js";
2
+ export type ExportGithubCliStoreResult = {
3
+ action: 'skipped';
4
+ reason: 'no-github-cli-credential';
5
+ } | {
6
+ action: 'wrote';
7
+ path: string;
8
+ } | {
9
+ action: 'failed';
10
+ reason: string;
11
+ };
12
+ export type ExportGithubCliStoreOptions = {
13
+ githubCli?: GithubCliSecrets;
14
+ homeDir?: string;
15
+ log?: (message: string) => void;
16
+ };
17
+ export declare function exportGithubCliStoreIfApplicable(options: ExportGithubCliStoreOptions): ExportGithubCliStoreResult;
18
+ export declare function exportGithubCliStoreForAgent(options: {
19
+ agentDir: string;
20
+ homeDir?: string;
21
+ log?: (message: string) => void;
22
+ }): ExportGithubCliStoreResult;
@@ -0,0 +1,7 @@
1
+ export declare function hydrateChannelEnvFromSecrets(options: {
2
+ agentDir: string;
3
+ env?: NodeJS.ProcessEnv;
4
+ }): {
5
+ applied: string[];
6
+ skipped: string[];
7
+ };
@@ -0,0 +1,7 @@
1
+ export { type Channels, type GithubCliSecrets, type GithubSecretsBlock, type McpCredential, type McpSlice, } from "./schema.js";
2
+ export { createSecretsStoreForAgent, SecretsBackend } from "./storage.js";
3
+ export { type Secret } from "./resolve.js";
4
+ export { hydrateChannelEnvFromSecrets } from "./hydrate.js";
5
+ export { type GithubCliProvisionResult, type GithubCliProvisionRunner, provisionGithubCliStore, } from "./provision-github-cli-store.js";
6
+ export { type ExportGithubCliStoreResult, exportGithubCliStoreForAgent, exportGithubCliStoreIfApplicable, } from "./export-github-cli-store.js";
7
+ export { type ProviderRefreshEntry, type ProviderRefreshOutcome, type RefreshProviderOAuthResult, refreshProviderOAuthCredentials, refreshProviderOAuthForAgent, } from "./refresh-provider-oauth.js";
@@ -0,0 +1,45 @@
1
+ export type GithubCliProvisionRequest = {
2
+ command: string;
3
+ args: string[];
4
+ env: NodeJS.ProcessEnv;
5
+ stdin?: string;
6
+ timeoutMs: number;
7
+ maxOutputBytes: number;
8
+ };
9
+ export type GithubCliProvisionRunner = (request: GithubCliProvisionRequest) => {
10
+ status: number | null;
11
+ stdout: string;
12
+ stderr: string;
13
+ };
14
+ export type GithubCliProvisionResult = {
15
+ ok: true;
16
+ } | {
17
+ ok: false;
18
+ reason: string;
19
+ };
20
+ export type ProvisionGithubCliStoreOptions = {
21
+ agentDir: string;
22
+ deniedRoots?: readonly string[];
23
+ env?: NodeJS.ProcessEnv;
24
+ runner?: GithubCliProvisionRunner;
25
+ resolveExecutable?: GithubCliExecutableResolver;
26
+ revalidateExecutable?: (identity: GithubCliExecutableIdentity) => boolean;
27
+ };
28
+ export type GithubCliExecutableIdentity = {
29
+ canonicalPath: string;
30
+ dev: bigint;
31
+ ino: bigint;
32
+ mode: bigint;
33
+ size: bigint;
34
+ ctimeNs: bigint;
35
+ mtimeNs: bigint;
36
+ };
37
+ export type GithubCliExecutableResolver = (options: ResolveGithubCliExecutableOptions) => GithubCliExecutableIdentity | null;
38
+ export type ResolveGithubCliExecutableOptions = {
39
+ platform?: NodeJS.Platform;
40
+ env?: NodeJS.ProcessEnv;
41
+ deniedRoots?: readonly string[];
42
+ isRegularExecutable?: (path: string) => boolean;
43
+ };
44
+ export declare function provisionGithubCliStore(options: ProvisionGithubCliStoreOptions): GithubCliProvisionResult;
45
+ export declare function resolveGithubCliExecutable(options?: ResolveGithubCliExecutableOptions): GithubCliExecutableIdentity | null;
@@ -0,0 +1,22 @@
1
+ import type { CredentialStore } from '@earendil-works/pi-ai';
2
+ import { ModelRuntime } from '@earendil-works/pi-coding-agent';
3
+ export type ProviderRefreshOutcome = 'valid-or-refreshed' | 'refresh-failed';
4
+ export type ProviderRefreshEntry = {
5
+ providerId: string;
6
+ outcome: ProviderRefreshOutcome;
7
+ error?: string;
8
+ };
9
+ export type RefreshProviderOAuthResult = {
10
+ entries: ProviderRefreshEntry[];
11
+ };
12
+ export type RefreshProviderOAuthOptions = {
13
+ modelRuntime: ModelRuntime;
14
+ credentials: CredentialStore;
15
+ log?: (message: string) => void;
16
+ };
17
+ export declare function refreshProviderOAuthCredentials(options: RefreshProviderOAuthOptions): Promise<RefreshProviderOAuthResult>;
18
+ export type RefreshProviderOAuthForAgentOptions = {
19
+ agentDir: string;
20
+ log?: (message: string) => void;
21
+ };
22
+ export declare function refreshProviderOAuthForAgent(options: RefreshProviderOAuthForAgentOptions): Promise<RefreshProviderOAuthResult>;
@@ -0,0 +1,14 @@
1
+ import { z } from 'zod';
2
+ export declare const secretFieldSchema: z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
3
+ value: z.ZodOptional<z.ZodString>;
4
+ env: z.ZodOptional<z.ZodString>;
5
+ }, z.core.$strip>]>, z.ZodTransform<{
6
+ value?: string | undefined;
7
+ env?: string | undefined;
8
+ }, string | {
9
+ value?: string | undefined;
10
+ env?: string | undefined;
11
+ }>>;
12
+ export type Secret = z.infer<typeof secretFieldSchema>;
13
+ export declare function resolveSecret(secret: Secret, defaultEnv: string | undefined, env: NodeJS.ProcessEnv): string | undefined;
14
+ export declare function effectiveEnvName(secret: Secret, defaultEnv: string | undefined): string | undefined;