typeclaw 0.49.0 → 0.51.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (502) hide show
  1. package/dist/types/agent/attention-escalation.d.ts +18 -0
  2. package/dist/types/agent/auth.d.ts +7 -0
  3. package/dist/types/agent/bash-sandbox-env.d.ts +15 -0
  4. package/dist/types/agent/bash-sandbox-proc.d.ts +8 -0
  5. package/dist/types/agent/bash-sandbox.d.ts +94 -0
  6. package/dist/types/agent/compaction.d.ts +8 -0
  7. package/dist/types/agent/git-nudge.d.ts +6 -0
  8. package/dist/types/agent/guard-types.d.ts +25 -0
  9. package/dist/types/agent/guards.d.ts +7 -0
  10. package/dist/types/agent/idle-compaction.d.ts +8 -0
  11. package/dist/types/agent/index.d.ts +151 -0
  12. package/dist/types/agent/live-subagents.d.ts +113 -0
  13. package/dist/types/agent/llm-replay-sanitizer.d.ts +11 -0
  14. package/dist/types/agent/loop-guard.d.ts +67 -0
  15. package/dist/types/agent/model-fallback.d.ts +29 -0
  16. package/dist/types/agent/model-overrides.d.ts +8 -0
  17. package/dist/types/agent/multimodal/index.d.ts +2 -0
  18. package/dist/types/agent/multimodal/look-at.d.ts +60 -0
  19. package/dist/types/agent/multimodal/looker.d.ts +61 -0
  20. package/dist/types/agent/multimodal/read-redirect.d.ts +6 -0
  21. package/dist/types/agent/network/response-body.d.ts +1 -0
  22. package/dist/types/agent/network/safe-http.d.ts +46 -0
  23. package/dist/types/agent/output-allowance.d.ts +4 -0
  24. package/dist/types/agent/plugin-tools.d.ts +58 -0
  25. package/dist/types/agent/proactive-next-step-nudge.d.ts +2 -0
  26. package/dist/types/agent/prompt-cache-key.d.ts +3 -0
  27. package/dist/types/agent/provider-error.d.ts +23 -0
  28. package/dist/types/agent/reload-tool.d.ts +10 -0
  29. package/dist/types/agent/restart/index.d.ts +31 -0
  30. package/dist/types/agent/restart-handoff/index.d.ts +32 -0
  31. package/dist/types/agent/restart-handoff/paths.d.ts +1 -0
  32. package/dist/types/agent/retry-same-ref.d.ts +41 -0
  33. package/dist/types/agent/reviewer-activity.d.ts +3 -0
  34. package/dist/types/agent/reviewer-bash-policy.d.ts +8 -0
  35. package/dist/types/agent/self.d.ts +1 -0
  36. package/dist/types/agent/session-meta.d.ts +28 -0
  37. package/dist/types/agent/session-origin.d.ts +65 -0
  38. package/dist/types/agent/subagent-cache-keepalive.d.ts +38 -0
  39. package/dist/types/agent/subagent-completion-reminder.d.ts +29 -0
  40. package/dist/types/agent/subagent-drain.d.ts +25 -0
  41. package/dist/types/agent/subagent-session.d.ts +3 -0
  42. package/dist/types/agent/subagents.d.ts +153 -0
  43. package/dist/types/agent/system-prompt-composition.d.ts +17 -0
  44. package/dist/types/agent/system-prompt.d.ts +7 -0
  45. package/dist/types/agent/throttle-circuit.d.ts +25 -0
  46. package/dist/types/agent/todo/continuation-policy.d.ts +54 -0
  47. package/dist/types/agent/todo/continuation-state.d.ts +11 -0
  48. package/dist/types/agent/todo/continuation-wiring.d.ts +32 -0
  49. package/dist/types/agent/todo/continuation.d.ts +21 -0
  50. package/dist/types/agent/todo/scope.d.ts +6 -0
  51. package/dist/types/agent/todo/store.d.ts +16 -0
  52. package/dist/types/agent/tool-error-remediation.d.ts +1 -0
  53. package/dist/types/agent/tool-file-safety.d.ts +78 -0
  54. package/dist/types/agent/tool-not-found-nudge.d.ts +9 -0
  55. package/dist/types/agent/tool-result-budget.d.ts +15 -0
  56. package/dist/types/agent/tools/channel-disengage.d.ts +18 -0
  57. package/dist/types/agent/tools/channel-edit.d.ts +19 -0
  58. package/dist/types/agent/tools/channel-fetch-attachment.d.ts +36 -0
  59. package/dist/types/agent/tools/channel-handoff.d.ts +13 -0
  60. package/dist/types/agent/tools/channel-history-render.d.ts +3 -0
  61. package/dist/types/agent/tools/channel-history.d.ts +25 -0
  62. package/dist/types/agent/tools/channel-log.d.ts +5 -0
  63. package/dist/types/agent/tools/channel-react.d.ts +23 -0
  64. package/dist/types/agent/tools/channel-read.d.ts +27 -0
  65. package/dist/types/agent/tools/channel-reply.d.ts +47 -0
  66. package/dist/types/agent/tools/channel-send.d.ts +42 -0
  67. package/dist/types/agent/tools/channel-session-search.d.ts +10 -0
  68. package/dist/types/agent/tools/curl-impersonate.d.ts +37 -0
  69. package/dist/types/agent/tools/ddg.d.ts +27 -0
  70. package/dist/types/agent/tools/grant-role.d.ts +25 -0
  71. package/dist/types/agent/tools/keyed-semaphore.d.ts +10 -0
  72. package/dist/types/agent/tools/post-github-review.d.ts +38 -0
  73. package/dist/types/agent/tools/restart.d.ts +25 -0
  74. package/dist/types/agent/tools/runtime-notice.d.ts +3 -0
  75. package/dist/types/agent/tools/search-retry.d.ts +16 -0
  76. package/dist/types/agent/tools/skip-response.d.ts +17 -0
  77. package/dist/types/agent/tools/spawn-subagent.d.ts +77 -0
  78. package/dist/types/agent/tools/stream-snapshot.d.ts +23 -0
  79. package/dist/types/agent/tools/subagent-access.d.ts +20 -0
  80. package/dist/types/agent/tools/subagent-cancel.d.ts +23 -0
  81. package/dist/types/agent/tools/subagent-output.d.ts +50 -0
  82. package/dist/types/agent/tools/todo/index.d.ts +14 -0
  83. package/dist/types/agent/tools/webfetch/adaptive-html.d.ts +29 -0
  84. package/dist/types/agent/tools/webfetch/fetch.d.ts +26 -0
  85. package/dist/types/agent/tools/webfetch/html-lexical.d.ts +27 -0
  86. package/dist/types/agent/tools/webfetch/index.d.ts +1 -0
  87. package/dist/types/agent/tools/webfetch/inline-style-visibility.d.ts +3 -0
  88. package/dist/types/agent/tools/webfetch/strategies/grep.d.ts +11 -0
  89. package/dist/types/agent/tools/webfetch/strategies/jq.d.ts +4 -0
  90. package/dist/types/agent/tools/webfetch/strategies/raw.d.ts +1 -0
  91. package/dist/types/agent/tools/webfetch/strategies/readability.d.ts +16 -0
  92. package/dist/types/agent/tools/webfetch/strategies/selector.d.ts +4 -0
  93. package/dist/types/agent/tools/webfetch/strategies/snapshot.d.ts +1 -0
  94. package/dist/types/agent/tools/webfetch/tool.d.ts +15 -0
  95. package/dist/types/agent/tools/webfetch/types.d.ts +32 -0
  96. package/dist/types/agent/tools/websearch.d.ts +17 -0
  97. package/dist/types/agent/tools/wikipedia.d.ts +7 -0
  98. package/dist/types/agent/tools-without-local-file-operands.d.ts +1 -0
  99. package/dist/types/agent/turn-runner.d.ts +36 -0
  100. package/dist/types/agent-messenger/config-dir.d.ts +19 -0
  101. package/dist/types/browser/dockerfile.d.ts +2 -0
  102. package/dist/types/browser/registry.d.ts +49 -0
  103. package/dist/types/bundled-plugins/bun-hygiene/policy.d.ts +18 -0
  104. package/dist/types/bundled-plugins/github-cli-auth/git-askpass.d.ts +5 -0
  105. package/dist/types/bundled-plugins/guard/keys.d.ts +6 -0
  106. package/dist/types/bundled-plugins/guard/policies/managed-config.d.ts +7 -0
  107. package/dist/types/bundled-plugins/guard/policies/memory-topics-delete.d.ts +11 -0
  108. package/dist/types/bundled-plugins/guard/policies/memory-topics-write.d.ts +7 -0
  109. package/dist/types/bundled-plugins/guard/policies/non-workspace-write.d.ts +9 -0
  110. package/dist/types/bundled-plugins/guard/policies/skill-authoring.d.ts +20 -0
  111. package/dist/types/bundled-plugins/guard/policies/uncommitted-changes.d.ts +12 -0
  112. package/dist/types/bundled-plugins/guard/policy.d.ts +11 -0
  113. package/dist/types/bundled-plugins/memory/secret-detector.d.ts +11 -0
  114. package/dist/types/bundled-plugins/memory/slug.d.ts +4 -0
  115. package/dist/types/bundled-plugins/security/permissions.d.ts +20 -0
  116. package/dist/types/bundled-plugins/security/policies/private-surface-read.d.ts +34 -0
  117. package/dist/types/bundled-plugins/security/policies/ssrf.d.ts +18 -0
  118. package/dist/types/bundled-plugins/security/policy.d.ts +4 -0
  119. package/dist/types/channels/adapter-namespace.d.ts +2 -0
  120. package/dist/types/channels/adapters/mention-hints.d.ts +12 -0
  121. package/dist/types/channels/adapters/webex-id-ref.d.ts +5 -0
  122. package/dist/types/channels/background-handoff.d.ts +56 -0
  123. package/dist/types/channels/background-obligations.d.ts +135 -0
  124. package/dist/types/channels/catch-up.d.ts +26 -0
  125. package/dist/types/channels/commands.d.ts +2 -0
  126. package/dist/types/channels/completion-claim.d.ts +20 -0
  127. package/dist/types/channels/continuation-willingness.d.ts +1 -0
  128. package/dist/types/channels/continuity-types.d.ts +75 -0
  129. package/dist/types/channels/describe-error.d.ts +1 -0
  130. package/dist/types/channels/engagement.d.ts +34 -0
  131. package/dist/types/channels/github-false-receipt.d.ts +20 -0
  132. package/dist/types/channels/github-repo.d.ts +2 -0
  133. package/dist/types/channels/github-rereview-guard.d.ts +24 -0
  134. package/dist/types/channels/github-review-check.d.ts +135 -0
  135. package/dist/types/channels/github-review-claim.d.ts +3 -0
  136. package/dist/types/channels/github-review-turn-ledger.d.ts +71 -0
  137. package/dist/types/channels/github-review-verdict-coordinator.d.ts +117 -0
  138. package/dist/types/channels/github-token-bridge.d.ts +20 -0
  139. package/dist/types/channels/github-verdict-activity.d.ts +12 -0
  140. package/dist/types/channels/inbound-journal.d.ts +272 -0
  141. package/dist/types/channels/last-alive.d.ts +3 -0
  142. package/dist/types/channels/membership-cache.d.ts +27 -0
  143. package/dist/types/channels/membership.d.ts +21 -0
  144. package/dist/types/channels/outbound-flood-filter.d.ts +7 -0
  145. package/dist/types/channels/participants.d.ts +4 -0
  146. package/dist/types/channels/persistence.d.ts +32 -0
  147. package/dist/types/channels/recovery-notice.d.ts +26 -0
  148. package/dist/types/channels/recovery-outbox.d.ts +58 -0
  149. package/dist/types/channels/router.d.ts +760 -0
  150. package/dist/types/channels/schema.d.ts +501 -0
  151. package/dist/types/channels/session-handoff.d.ts +58 -0
  152. package/dist/types/channels/session-search.d.ts +29 -0
  153. package/dist/types/channels/types.d.ts +414 -0
  154. package/dist/types/channels/waiting-reactions.d.ts +25 -0
  155. package/dist/types/cli/builtins.d.ts +2 -0
  156. package/dist/types/cli/command-meta.d.ts +9 -0
  157. package/dist/types/coding-agent/broker-body.d.ts +7 -0
  158. package/dist/types/coding-agent/broker.d.ts +22 -0
  159. package/dist/types/coding-agent/claude.d.ts +22 -0
  160. package/dist/types/coding-agent/codex.d.ts +19 -0
  161. package/dist/types/coding-agent/index.d.ts +71 -0
  162. package/dist/types/coding-agent/omo-state.d.ts +2 -0
  163. package/dist/types/coding-agent/omo-stream.d.ts +22 -0
  164. package/dist/types/coding-agent/omo.d.ts +133 -0
  165. package/dist/types/coding-agent/runner.d.ts +35 -0
  166. package/dist/types/coding-agent/tool.d.ts +27 -0
  167. package/dist/types/coding-agent/worktree.d.ts +22 -0
  168. package/dist/types/commands/index.d.ts +45 -0
  169. package/dist/types/config/config.d.ts +827 -0
  170. package/dist/types/config/index.d.ts +3 -0
  171. package/dist/types/config/model-overrides.d.ts +3 -0
  172. package/dist/types/config/providers.d.ts +1458 -0
  173. package/dist/types/config/reloadable.d.ts +9 -0
  174. package/dist/types/container/agent-operation-lock.d.ts +31 -0
  175. package/dist/types/container/build-cache.d.ts +39 -0
  176. package/dist/types/container/compose-project.d.ts +1 -0
  177. package/dist/types/container/controller.d.ts +25 -0
  178. package/dist/types/container/docker-app.d.ts +23 -0
  179. package/dist/types/container/exit-reason.d.ts +10 -0
  180. package/dist/types/container/index.d.ts +14 -0
  181. package/dist/types/container/log-archive.d.ts +68 -0
  182. package/dist/types/container/log-colors.d.ts +3 -0
  183. package/dist/types/container/log-timestamps.d.ts +9 -0
  184. package/dist/types/container/logs.d.ts +37 -0
  185. package/dist/types/container/memory-limit.d.ts +13 -0
  186. package/dist/types/container/memory-oversubscription.d.ts +20 -0
  187. package/dist/types/container/oom-events.d.ts +18 -0
  188. package/dist/types/container/port.d.ts +18 -0
  189. package/dist/types/container/require-running.d.ts +16 -0
  190. package/dist/types/container/restart.d.ts +32 -0
  191. package/dist/types/container/shared.d.ts +93 -0
  192. package/dist/types/container/shell.d.ts +35 -0
  193. package/dist/types/container/start.d.ts +145 -0
  194. package/dist/types/container/stats.d.ts +31 -0
  195. package/dist/types/container/status.d.ts +25 -0
  196. package/dist/types/container/stop.d.ts +24 -0
  197. package/dist/types/container/tool-oom-priority.d.ts +4 -0
  198. package/dist/types/container/verify-running.d.ts +49 -0
  199. package/dist/types/cron/consumer.d.ts +42 -0
  200. package/dist/types/cron/count-state.d.ts +24 -0
  201. package/dist/types/cron/index.d.ts +21 -0
  202. package/dist/types/cron/list.d.ts +33 -0
  203. package/dist/types/cron/reloadable.d.ts +11 -0
  204. package/dist/types/cron/scheduler.d.ts +51 -0
  205. package/dist/types/cron/schema.d.ts +108 -0
  206. package/dist/types/dependencies/bin-resolver.d.ts +28 -0
  207. package/dist/types/dependencies/bins.d.ts +22 -0
  208. package/dist/types/dependencies/index.d.ts +2 -0
  209. package/dist/types/eval/cell.d.ts +26 -0
  210. package/dist/types/eval/config.d.ts +19 -0
  211. package/dist/types/eval/dispatch.d.ts +7 -0
  212. package/dist/types/eval/kernel.d.ts +28 -0
  213. package/dist/types/eval/process.d.ts +23 -0
  214. package/dist/types/eval/protocol.d.ts +34 -0
  215. package/dist/types/eval/sandbox.d.ts +10 -0
  216. package/dist/types/eval/tool.d.ts +17 -0
  217. package/dist/types/eval/wire.d.ts +33 -0
  218. package/dist/types/git/bound-gc-config.d.ts +4 -0
  219. package/dist/types/git/hookless.d.ts +1 -0
  220. package/dist/types/git/reconcile-ignored.d.ts +13 -0
  221. package/dist/types/git/resolve-agent-git.d.ts +8 -0
  222. package/dist/types/git/resolve-identity.d.ts +10 -0
  223. package/dist/types/git/run.d.ts +24 -0
  224. package/dist/types/git/system-commit.d.ts +2 -0
  225. package/dist/types/hostd/client.d.ts +13 -0
  226. package/dist/types/hostd/models.d.ts +1 -0
  227. package/dist/types/hostd/paths.d.ts +17 -0
  228. package/dist/types/hostd/protocol.d.ts +93 -0
  229. package/dist/types/hostd/spawn.d.ts +17 -0
  230. package/dist/types/hostd/version.d.ts +18 -0
  231. package/dist/types/init/auto-upgrade.d.ts +41 -0
  232. package/dist/types/init/cli-version.d.ts +7 -0
  233. package/dist/types/init/dockerfile.d.ts +34 -0
  234. package/dist/types/init/ensure-deps.d.ts +17 -0
  235. package/dist/types/init/env-file.d.ts +3 -0
  236. package/dist/types/init/gitignore.d.ts +5 -0
  237. package/dist/types/init/local-source-stamp.d.ts +3 -0
  238. package/dist/types/init/packagejson.d.ts +7 -0
  239. package/dist/types/init/paths.d.ts +3 -0
  240. package/dist/types/init/reconcile-plugin-deps.d.ts +13 -0
  241. package/dist/types/init/run-bun-install.d.ts +16 -0
  242. package/dist/types/init/windows-dev-link.d.ts +8 -0
  243. package/dist/types/mcp/catalog.d.ts +7 -0
  244. package/dist/types/mcp/client.d.ts +58 -0
  245. package/dist/types/mcp/manager.d.ts +56 -0
  246. package/dist/types/mcp/tools.d.ts +23 -0
  247. package/dist/types/models/embedding-model.d.ts +20 -0
  248. package/dist/types/models/transformers-version.d.ts +1 -0
  249. package/dist/types/network/internal-destinations.d.ts +29 -0
  250. package/dist/types/operations/classify-tool-outcome.d.ts +35 -0
  251. package/dist/types/operations/incidents.d.ts +47 -0
  252. package/dist/types/operations/index.d.ts +3 -0
  253. package/dist/types/operations/remediations.d.ts +25 -0
  254. package/dist/types/path-safety/real-intended-path.d.ts +9 -0
  255. package/dist/types/permissions/builtins.d.ts +25 -0
  256. package/dist/types/permissions/grant.d.ts +19 -0
  257. package/dist/types/permissions/index.d.ts +6 -0
  258. package/dist/types/permissions/match-rule.d.ts +28 -0
  259. package/dist/types/permissions/permissions.d.ts +42 -0
  260. package/dist/types/permissions/resolve.d.ts +25 -0
  261. package/dist/types/permissions/schema.d.ts +14 -0
  262. package/dist/types/plugin/context.d.ts +20 -0
  263. package/dist/types/plugin/core-tool-names.d.ts +4 -0
  264. package/dist/types/plugin/define.d.ts +46 -0
  265. package/dist/types/plugin/hooks.d.ts +52 -0
  266. package/dist/types/plugin/index.d.ts +11 -0
  267. package/dist/types/plugin/load-skill.d.ts +14 -0
  268. package/dist/types/plugin/loader.d.ts +25 -0
  269. package/dist/types/plugin/manager.d.ts +42 -0
  270. package/dist/types/plugin/registry.d.ts +73 -0
  271. package/dist/types/plugin/skills.d.ts +11 -0
  272. package/dist/types/plugin/types.d.ts +336 -0
  273. package/dist/types/plugin/zod-introspect.d.ts +11 -0
  274. package/dist/types/reload/client.d.ts +11 -0
  275. package/dist/types/reload/docker-exec-client.d.ts +11 -0
  276. package/dist/types/reload/format.d.ts +2 -0
  277. package/dist/types/reload/index.d.ts +6 -0
  278. package/dist/types/reload/recover.d.ts +22 -0
  279. package/dist/types/reload/registry.d.ts +10 -0
  280. package/dist/types/reload/types.d.ts +25 -0
  281. package/dist/types/role-claim/client.d.ts +20 -0
  282. package/dist/types/role-claim/code.d.ts +4 -0
  283. package/dist/types/role-claim/controller.d.ts +59 -0
  284. package/dist/types/role-claim/index.d.ts +6 -0
  285. package/dist/types/role-claim/match-rule.d.ts +9 -0
  286. package/dist/types/role-claim/pending.d.ts +35 -0
  287. package/dist/types/role-claim/reload-after-claim.d.ts +16 -0
  288. package/dist/types/run/llm-fetch-observer.d.ts +50 -0
  289. package/dist/types/sandbox/availability.d.ts +21 -0
  290. package/dist/types/sandbox/build.d.ts +7 -0
  291. package/dist/types/sandbox/canonical-secrets.d.ts +8 -0
  292. package/dist/types/sandbox/coding-agent.d.ts +20 -0
  293. package/dist/types/sandbox/dependency-bins.d.ts +19 -0
  294. package/dist/types/sandbox/dev-source.d.ts +4 -0
  295. package/dist/types/sandbox/env-exposure.d.ts +3 -0
  296. package/dist/types/sandbox/errors.d.ts +20 -0
  297. package/dist/types/sandbox/hidden-paths.d.ts +11 -0
  298. package/dist/types/sandbox/index.d.ts +14 -0
  299. package/dist/types/sandbox/package-install.d.ts +1 -0
  300. package/dist/types/sandbox/policy.d.ts +71 -0
  301. package/dist/types/sandbox/privileged-runtime.d.ts +13 -0
  302. package/dist/types/sandbox/quote.d.ts +2 -0
  303. package/dist/types/sandbox/runtime-private.d.ts +1 -0
  304. package/dist/types/sandbox/session-tmp.d.ts +6 -0
  305. package/dist/types/sandbox/symlinks.d.ts +6 -0
  306. package/dist/types/sandbox/writable-zones.d.ts +15 -0
  307. package/dist/types/secrets/coding-agent-auth.d.ts +25 -0
  308. package/dist/types/secrets/defaults.d.ts +21 -0
  309. package/dist/types/secrets/export-github-cli-store.d.ts +22 -0
  310. package/dist/types/secrets/hydrate.d.ts +7 -0
  311. package/dist/types/secrets/index.d.ts +7 -0
  312. package/dist/types/secrets/provision-github-cli-store.d.ts +45 -0
  313. package/dist/types/secrets/refresh-provider-oauth.d.ts +22 -0
  314. package/dist/types/secrets/resolve.d.ts +14 -0
  315. package/dist/types/secrets/schema.d.ts +840 -0
  316. package/dist/types/secrets/storage.d.ts +56 -0
  317. package/dist/types/shared/host-locale.d.ts +1 -0
  318. package/dist/types/shared/index.d.ts +5 -0
  319. package/dist/types/shared/local-time.d.ts +4 -0
  320. package/dist/types/shared/platform.d.ts +2 -0
  321. package/dist/types/shared/protocol.d.ts +424 -0
  322. package/dist/types/shared/style-text.d.ts +3 -0
  323. package/dist/types/shared/wsl.d.ts +17 -0
  324. package/dist/types/stream/broker.d.ts +2 -0
  325. package/dist/types/stream/index.d.ts +2 -0
  326. package/dist/types/stream/types.d.ts +71 -0
  327. package/package.json +13 -6
  328. package/scripts/build-plugin-types.ts +105 -0
  329. package/scripts/check-plugin-sdk.ts +111 -0
  330. package/scripts/require-parallel.ts +5 -32
  331. package/src/agent/bash-sandbox-env.ts +104 -0
  332. package/src/agent/bash-sandbox-proc.ts +70 -0
  333. package/src/agent/bash-sandbox.ts +225 -0
  334. package/src/agent/compaction.ts +22 -10
  335. package/src/agent/guard-types.ts +3 -0
  336. package/src/agent/guards.ts +4 -0
  337. package/src/agent/idle-compaction.ts +178 -0
  338. package/src/agent/index.ts +139 -172
  339. package/src/agent/live-subagents.ts +19 -0
  340. package/src/agent/multimodal/look-at.ts +22 -9
  341. package/src/agent/output-allowance.ts +7 -0
  342. package/src/agent/plugin-tools.ts +39 -377
  343. package/src/agent/reviewer-bash-policy.ts +41 -1
  344. package/src/agent/session-origin.ts +28 -11
  345. package/src/agent/subagent-cache-keepalive.ts +198 -0
  346. package/src/agent/subagent-completion-reminder.ts +2 -2
  347. package/src/agent/subagent-session.ts +6 -0
  348. package/src/agent/subagents.ts +46 -8
  349. package/src/agent/system-prompt-composition.ts +141 -0
  350. package/src/agent/system-prompt.ts +5 -5
  351. package/src/agent/todo/scope.ts +1 -1
  352. package/src/agent/tool-file-safety.ts +6 -1
  353. package/src/agent/tools/channel-edit.ts +20 -10
  354. package/src/agent/tools/channel-fetch-attachment.ts +12 -5
  355. package/src/agent/tools/channel-handoff.ts +72 -0
  356. package/src/agent/tools/channel-read.ts +57 -10
  357. package/src/agent/tools/channel-reply.ts +33 -26
  358. package/src/agent/tools/channel-send.ts +21 -13
  359. package/src/agent/tools/channel-session-search.ts +35 -0
  360. package/src/agent/tools/curl-impersonate.ts +11 -4
  361. package/src/agent/tools/ddg.ts +84 -16
  362. package/src/agent/tools/spawn-subagent.ts +27 -11
  363. package/src/agent/tools/stream-snapshot.ts +15 -2
  364. package/src/agent/tools/subagent-access.ts +11 -4
  365. package/src/agent/tools-without-local-file-operands.ts +4 -0
  366. package/src/browser/bsk-shim.mjs +74 -0
  367. package/src/browser/dockerfile.ts +84 -0
  368. package/src/browser/egress.ts +104 -0
  369. package/src/browser/fill-secret.ts +307 -0
  370. package/src/browser/managed-browser.ts +205 -0
  371. package/src/browser/registry.ts +110 -0
  372. package/src/browser/relay.ts +231 -0
  373. package/src/browser/sandbox-entry.ts +167 -0
  374. package/src/bundled-plugins/agent-browser/index.ts +2 -0
  375. package/src/bundled-plugins/browser-agent/browser-agent.ts +89 -0
  376. package/src/bundled-plugins/browser-agent/index.ts +12 -0
  377. package/src/bundled-plugins/doc-render/index.ts +0 -10
  378. package/src/bundled-plugins/doc-render/render.ts +83 -111
  379. package/src/bundled-plugins/doc-render/skills/typeclaw-render-pdf/SKILL.md +152 -257
  380. package/src/bundled-plugins/explorer/explorer.ts +1 -1
  381. package/src/bundled-plugins/github-cli-auth/gh-command.ts +4 -0
  382. package/src/bundled-plugins/github-cli-auth/gh-review-detect.ts +40 -16
  383. package/src/bundled-plugins/github-cli-auth/git-auth-diagnostic.ts +95 -0
  384. package/src/bundled-plugins/github-cli-auth/graphql-auth-nudge.ts +12 -7
  385. package/src/bundled-plugins/github-cli-auth/index.ts +85 -60
  386. package/src/bundled-plugins/managed-browser/index.ts +179 -0
  387. package/src/bundled-plugins/managed-browser/skills/browser-use/browser-use/SKILL.md +27 -0
  388. package/src/bundled-plugins/managed-browser/skills/browserskill/browserskill/SKILL.md +28 -0
  389. package/src/bundled-plugins/managed-browser/skills/omowright/omowright/SKILL.md +40 -0
  390. package/src/bundled-plugins/memory/dreaming.ts +4 -1
  391. package/src/bundled-plugins/memory/load-memory.ts +2 -4
  392. package/src/bundled-plugins/memory/memory-logger.ts +74 -2
  393. package/src/bundled-plugins/memory/transcript-preload.ts +103 -0
  394. package/src/bundled-plugins/memory/vector/hybrid.ts +25 -14
  395. package/src/bundled-plugins/operator/operator.ts +1 -1
  396. package/src/bundled-plugins/qa/index.ts +11 -0
  397. package/src/bundled-plugins/qa/qa.ts +160 -0
  398. package/src/bundled-plugins/qa/skills/qa-cli.ts +50 -0
  399. package/src/bundled-plugins/qa/skills/qa-general.ts +30 -0
  400. package/src/bundled-plugins/qa/skills/qa-http.ts +39 -0
  401. package/src/bundled-plugins/qa/skills/qa-pr.ts +51 -0
  402. package/src/bundled-plugins/qa/skills/qa-web.ts +49 -0
  403. package/src/bundled-plugins/security/index.ts +53 -34
  404. package/src/bundled-plugins/security/policies/outbound-secret-scan.ts +1 -0
  405. package/src/bundled-plugins/security/policies/private-surface-read.ts +166 -201
  406. package/src/channels/adapter-namespace.ts +13 -0
  407. package/src/channels/adapters/discord-bot-reference.ts +5 -4
  408. package/src/channels/adapters/discord-bot.ts +98 -5
  409. package/src/channels/adapters/discord-classify.ts +8 -3
  410. package/src/channels/adapters/discord.ts +29 -0
  411. package/src/channels/adapters/github/index.ts +16 -0
  412. package/src/channels/adapters/github/last-alive.ts +4 -16
  413. package/src/channels/adapters/slack-attachment-download.ts +14 -3
  414. package/src/channels/adapters/slack-bot-author-resolver.ts +4 -3
  415. package/src/channels/adapters/slack-bot-channel-resolver.ts +9 -6
  416. package/src/channels/adapters/slack-bot-classify.ts +1 -0
  417. package/src/channels/adapters/slack-bot-slash-commands.ts +3 -1
  418. package/src/channels/adapters/slack-bot.ts +299 -67
  419. package/src/channels/adapters/slack-classify.ts +1 -0
  420. package/src/channels/catch-up.ts +137 -0
  421. package/src/channels/continuation-willingness.ts +2 -2
  422. package/src/channels/continuity-types.ts +1 -0
  423. package/src/channels/engagement.ts +17 -1
  424. package/src/channels/github-false-receipt.ts +3 -3
  425. package/src/channels/github-rereview-guard.ts +9 -5
  426. package/src/channels/github-review-check.ts +5 -1
  427. package/src/channels/github-review-verdict-coordinator.ts +68 -2
  428. package/src/channels/github-token-bridge.ts +24 -0
  429. package/src/channels/last-alive.ts +34 -0
  430. package/src/channels/manager.ts +8 -1
  431. package/src/channels/router.ts +515 -243
  432. package/src/channels/session-handoff.fixture.ts +144 -0
  433. package/src/channels/session-handoff.ts +175 -0
  434. package/src/channels/session-search.ts +71 -0
  435. package/src/channels/subagent-completion-bridge.ts +3 -2
  436. package/src/channels/types.ts +12 -2
  437. package/src/cli/channel.ts +2 -3
  438. package/src/cli/hostd.ts +3 -0
  439. package/src/cli/init.ts +2 -3
  440. package/src/cli/model.ts +132 -3
  441. package/src/coding-agent/index.ts +7 -1
  442. package/src/coding-agent/omo-stream.ts +40 -0
  443. package/src/coding-agent/runner.ts +30 -8
  444. package/src/config/config.ts +126 -22
  445. package/src/config/model-overrides.ts +59 -0
  446. package/src/config/models-mutation.ts +185 -2
  447. package/src/config/providers-mutation.ts +12 -4
  448. package/src/config/providers.ts +69 -4
  449. package/src/container/start.ts +132 -5
  450. package/src/doctor/checks.ts +33 -22
  451. package/src/doctor/index.ts +48 -12
  452. package/src/doctor/operational-incidents.ts +16 -1
  453. package/src/doctor/plugin-bridge.ts +14 -1
  454. package/src/doctor/stage.ts +14 -0
  455. package/src/doctor/types.ts +6 -0
  456. package/src/eval/cell.ts +93 -0
  457. package/src/eval/config.ts +32 -0
  458. package/src/eval/dispatch.ts +67 -0
  459. package/src/eval/entry.ts +261 -0
  460. package/src/eval/kernel.ts +154 -0
  461. package/src/eval/process.ts +113 -0
  462. package/src/eval/protocol.ts +26 -0
  463. package/src/eval/redeclare.ts +174 -0
  464. package/src/eval/sandbox.ts +114 -0
  465. package/src/eval/tool.ts +98 -0
  466. package/src/eval/wire.ts +93 -0
  467. package/src/hostd/daemon.ts +13 -1
  468. package/src/init/auto-upgrade.ts +7 -1
  469. package/src/init/dockerfile.ts +57 -12
  470. package/src/init/index.ts +4 -3
  471. package/src/init/local-source-stamp.ts +68 -0
  472. package/src/init/models-dev.ts +4 -0
  473. package/src/init/validate-api-key.ts +3 -0
  474. package/src/operations/classify-tool-outcome.ts +1 -1
  475. package/src/permissions/builtins.ts +7 -0
  476. package/src/permissions/permissions.ts +18 -9
  477. package/src/permissions/resolve.ts +7 -1
  478. package/src/plugin/context.ts +2 -0
  479. package/src/plugin/core-tool-names.ts +6 -1
  480. package/src/plugin/hooks.ts +137 -0
  481. package/src/plugin/index.ts +6 -0
  482. package/src/plugin/manager.ts +4 -0
  483. package/src/plugin/types.ts +60 -0
  484. package/src/run/bundled-plugins.ts +6 -0
  485. package/src/run/index.ts +24 -14
  486. package/src/run/llm-fetch-observer.ts +12 -15
  487. package/src/sandbox/canonical-secrets.ts +4 -0
  488. package/src/sandbox/dev-source.ts +26 -0
  489. package/src/sandbox/env-exposure.ts +20 -0
  490. package/src/sandbox/hidden-paths.ts +16 -2
  491. package/src/secrets/storage.ts +13 -0
  492. package/src/server/index.ts +46 -11
  493. package/src/skills/typeclaw-channel-github/SKILL.md +8 -8
  494. package/src/skills/typeclaw-config/SKILL.md +57 -5
  495. package/src/skills/typeclaw-config/references/dockerfile.md +2 -2
  496. package/src/skills/typeclaw-github-contributing/SKILL.md +1 -1
  497. package/src/skills/typeclaw-monorepo/SKILL.md +1 -1
  498. package/src/skills/typeclaw-permissions/SKILL.md +7 -7
  499. package/src/skills/typeclaw-troubleshooting/SKILL.md +12 -1
  500. package/typeclaw.schema.json +488 -5
  501. package/src/bundled-plugins/doc-render/templates/lib.typ +0 -339
  502. package/src/bundled-plugins/github-cli-auth/gh-store.ts +0 -733
@@ -0,0 +1,18 @@
1
+ import type { ThinkingLevel } from '@earendil-works/pi-agent-core';
2
+ export type QuestionSignal = {
3
+ endedWithQuestion: boolean;
4
+ questionSentenceCount: number;
5
+ dominant: boolean;
6
+ alnumCount: number;
7
+ };
8
+ export declare function getQuestionSignal(text: string): QuestionSignal;
9
+ export declare function detectAttentionEscalation(text: string, prior?: QuestionSignal | null): boolean;
10
+ export type TurnThinkingOptions = {
11
+ allowEscalation?: boolean;
12
+ };
13
+ export declare function resolveTurnThinkingLevel(text: string, sessionDefault: ThinkingLevel | undefined, prior?: QuestionSignal | null, options?: TurnThinkingOptions): ThinkingLevel | undefined;
14
+ type ThinkingLevelSettable = {
15
+ setThinkingLevel(level: ThinkingLevel): void;
16
+ };
17
+ export declare function applyTurnThinkingLevel(session: ThinkingLevelSettable, text: string, sessionDefault: ThinkingLevel | undefined, prior?: QuestionSignal | null, options?: TurnThinkingOptions): void;
18
+ export {};
@@ -0,0 +1,7 @@
1
+ import { ModelRuntime } from '@earendil-works/pi-coding-agent';
2
+ import { type KnownProviderId } from "../config/providers.js";
3
+ export type ProviderAuth = {
4
+ modelRuntime: ModelRuntime;
5
+ };
6
+ export declare function getAuthFor(providerId: KnownProviderId): Promise<ProviderAuth>;
7
+ export declare function invalidateProviderAuthCache(): void;
@@ -0,0 +1,15 @@
1
+ type BashEnvOverlay = Record<string, string>;
2
+ export declare function buildSandboxEnvPolicy(overlay: BashEnvOverlay | undefined, runtimeEnv: Record<string, string> | undefined, exposableEnvNames?: readonly string[], withhold?: readonly string[]): {
3
+ inherit?: string[];
4
+ set?: Record<string, string>;
5
+ withhold?: string[];
6
+ };
7
+ export declare function spreadSandboxEnv(policy: ReturnType<typeof buildSandboxEnvPolicy>): {
8
+ env?: ReturnType<typeof buildSandboxEnvPolicy>;
9
+ };
10
+ export declare function resolveExposableBashEnvNames(agentDir: string): {
11
+ exposable: string[];
12
+ withheld: string[];
13
+ };
14
+ export declare function buildRoleScopedConfigEnv(agentDir: string, hiddenDirs: string[], envOverlay: BashEnvOverlay | undefined): BashEnvOverlay | undefined;
15
+ export {};
@@ -0,0 +1,8 @@
1
+ export type ProcStrategyResolution = {
2
+ strategy: 'real-proc' | 'proc-bind';
3
+ degradeReason?: undefined;
4
+ } | {
5
+ strategy: 'tmpfs';
6
+ degradeReason: 'definitive' | 'unverified';
7
+ };
8
+ export declare function resolveProcStrategy(): Promise<ProcStrategyResolution>;
@@ -0,0 +1,94 @@
1
+ import type { PermissionService } from "../permissions/permissions.js";
2
+ import { buildSandboxedCommand, cleanupPrivilegedSandboxRuntime, resolvePrivilegedSandboxRuntime, verifyPrivilegedSandboxRuntime, type SandboxMount, type SandboxNetwork, type SandboxPolicy, type DependencyBinReconciliation } from "../sandbox/index.js";
3
+ import { type ProcStrategyResolution } from "./bash-sandbox-proc.js";
4
+ import type { SessionOrigin } from "./session-origin.js";
5
+ export type DeferredBashPreparationResult = {
6
+ command: string;
7
+ env?: Record<string, string>;
8
+ mount: Extract<SandboxMount, {
9
+ type: 'ro-bind';
10
+ }>;
11
+ cleanup: () => Promise<void>;
12
+ };
13
+ export type DeferredBashPreparation = () => Promise<DeferredBashPreparationResult>;
14
+ export type BashSandboxBoundary = {
15
+ ensureAvailable: () => Promise<void>;
16
+ buildCommand: typeof buildSandboxedCommand;
17
+ resolveProcStrategy?: () => Promise<ProcStrategyResolution>;
18
+ resolveRuntime?: typeof resolvePrivilegedSandboxRuntime;
19
+ verifyRuntime?: typeof verifyPrivilegedSandboxRuntime;
20
+ cleanupRuntime?: typeof cleanupPrivilegedSandboxRuntime;
21
+ };
22
+ type BashFilesystemPolicyOptions = {
23
+ agentDir: string;
24
+ canWriteAgentRoot: boolean;
25
+ masks: {
26
+ dirs: string[];
27
+ files: string[];
28
+ };
29
+ writable: {
30
+ dirs: string[];
31
+ files: string[];
32
+ };
33
+ protected: {
34
+ dirs: string[];
35
+ files: string[];
36
+ };
37
+ };
38
+ export type PreparedBashSandbox = {
39
+ commandString: string;
40
+ policy: SandboxPolicy;
41
+ verify: () => Promise<void>;
42
+ cleanup: () => Promise<void>;
43
+ spawnEnv: Record<string, string>;
44
+ dependencyBins?: DependencyBinReconciliation;
45
+ withheld: {
46
+ paths: {
47
+ dirs: string[];
48
+ files: string[];
49
+ };
50
+ envNames: string[];
51
+ };
52
+ };
53
+ export declare function buildBashFilesystemPolicy(options: BashFilesystemPolicyOptions): {
54
+ writableRoot: {
55
+ dir: string;
56
+ };
57
+ masks: {
58
+ dirs: string[];
59
+ files: string[];
60
+ };
61
+ protected: {
62
+ dirs: string[];
63
+ files: string[];
64
+ };
65
+ writable?: undefined;
66
+ } | {
67
+ masks: {
68
+ dirs: string[];
69
+ files: string[];
70
+ };
71
+ writable: {
72
+ dirs: string[];
73
+ files: string[];
74
+ };
75
+ protected: {
76
+ dirs: string[];
77
+ files: string[];
78
+ };
79
+ writableRoot?: undefined;
80
+ };
81
+ export type BashSandboxRequest = {
82
+ readonly command: string;
83
+ readonly permissions: PermissionService;
84
+ readonly origin: SessionOrigin | undefined;
85
+ readonly agentDir: string;
86
+ readonly sessionId: string;
87
+ readonly envOverlay?: Record<string, string>;
88
+ readonly envWithhold?: string[];
89
+ readonly deferredPreparation?: DeferredBashPreparation;
90
+ readonly boundary?: BashSandboxBoundary;
91
+ readonly network?: SandboxNetwork;
92
+ };
93
+ export declare function prepareBashSandbox(options: BashSandboxRequest): Promise<PreparedBashSandbox>;
94
+ export {};
@@ -0,0 +1,8 @@
1
+ import type { KnownApi, Model } from '@earendil-works/pi-ai';
2
+ import { SettingsManager } from '@earendil-works/pi-coding-agent';
3
+ export declare const COMPACTION_TRIGGER_PERCENT = 0.8;
4
+ export declare const COMPACTION_ABSOLUTE_TRIGGER_TOKENS = 200000;
5
+ export declare const COMPACTION_KEEP_RECENT_TOKENS = 20000;
6
+ export declare function compactionTriggerTokens<TApi extends KnownApi>(model: Model<TApi>, maxTriggerTokens?: number): number;
7
+ export declare function reserveTokensForModel<TApi extends KnownApi>(model: Model<TApi>, maxTriggerTokens?: number): number;
8
+ export declare function createCompactionSettingsManager<TApi extends KnownApi>(model: Model<TApi>, maxTriggerTokens?: number): SettingsManager;
@@ -0,0 +1,6 @@
1
+ export type GitNudgeDeps = {
2
+ readStatus: (agentDir: string, gitArgs: readonly string[]) => Promise<readonly string[] | null>;
3
+ };
4
+ export declare function renderGitNudge(agentDir: string, deps?: GitNudgeDeps): Promise<string>;
5
+ export declare function formatNudge(dirtyPaths: readonly string[]): string;
6
+ export declare function parsePorcelain(stdout: string): string[];
@@ -0,0 +1,25 @@
1
+ import type { ToolFileOperands, ToolProvenance } from "../plugin/index.js";
2
+ import type { SessionOrigin } from "./session-origin.js";
3
+ export type InternalGuardEvent = {
4
+ readonly tool: string;
5
+ readonly sessionId: string;
6
+ readonly callId: string;
7
+ readonly args: Readonly<Record<string, unknown>>;
8
+ readonly origin?: SessionOrigin;
9
+ readonly toolProvenance?: ToolProvenance;
10
+ readonly fileOperands?: ToolFileOperands;
11
+ };
12
+ export type InternalGuardResult = undefined | {
13
+ readonly kind: 'block';
14
+ readonly reason: string;
15
+ } | {
16
+ readonly kind: 'acknowledgement-required';
17
+ readonly reason: string;
18
+ };
19
+ export type InternalGuard = {
20
+ readonly owner: string;
21
+ readonly key: string;
22
+ readonly tools: ReadonlySet<string>;
23
+ readonly skipOnCheckError?: true;
24
+ readonly check: (event: InternalGuardEvent) => InternalGuardResult | Promise<InternalGuardResult>;
25
+ };
@@ -0,0 +1,7 @@
1
+ import type { InternalGuard } from "./guard-types.js";
2
+ export type { InternalGuard } from "./guard-types.js";
3
+ type InternalGuardDeclaration = Omit<InternalGuard, 'tools'> & {
4
+ readonly tools: readonly [string, ...string[]];
5
+ };
6
+ export declare function buildInternalGuards(agentDir: string): readonly InternalGuard[];
7
+ export declare function validateInternalGuardDeclarations(guards: readonly InternalGuardDeclaration[], availableToolNames: ReadonlySet<string>): void;
@@ -0,0 +1,8 @@
1
+ import { AgentSession } from '@earendil-works/pi-coding-agent';
2
+ type IdleSchedule = (run: () => Promise<void>) => () => void;
3
+ export declare function attachIdleCompaction(session: AgentSession, options?: {
4
+ schedule?: IdleSchedule;
5
+ onApplied?: () => void;
6
+ maxTriggerTokens?: number;
7
+ }): () => void;
8
+ export {};
@@ -0,0 +1,151 @@
1
+ import { createAgentSession, DefaultResourceLoader, SessionManager } from '@earendil-works/pi-coding-agent';
2
+ import type { AgentSession, ToolDefinition } from '@earendil-works/pi-coding-agent';
3
+ import type { ChannelRouter } from "../channels/router.js";
4
+ import { type Models, type ResolvedProfile, type ThinkingLevel } from "../config/index.js";
5
+ import { type SystemPromptMode } from "./system-prompt-composition.js";
6
+ export { composeSystemPrompt, deriveSystemPromptMode, type SystemPromptMode, type SystemPromptComposition, } from "./system-prompt-composition.js";
7
+ import { type ModelRef } from "../config/providers.js";
8
+ import type { McpManager } from "../mcp/manager.js";
9
+ import { type PermissionService, type RolesConfig } from "../permissions/index.js";
10
+ import type { BuiltinToolRef, HookBus, MaterializedSkills, PluginRegistry, Tool as PluginTool } from "../plugin/index.js";
11
+ import type { ReloadRegistry } from "../reload/index.js";
12
+ import type { Stream } from "../stream/index.js";
13
+ import type { InternalGuard } from "./guard-types.js";
14
+ import type { LiveSubagentRegistry } from "./live-subagents.js";
15
+ import type { RestartHandoffOrigin } from "./restart-handoff/index.js";
16
+ import type { SubagentBashPolicy } from "./reviewer-bash-policy.js";
17
+ import { type SessionOrigin } from "./session-origin.js";
18
+ import type { CreateSessionForSubagent, SubagentCoalescer, SubagentRegistry } from "./subagents.js";
19
+ import { type ToolResultBudget } from "./tool-result-budget.js";
20
+ export type { SessionOrigin } from "./session-origin.js";
21
+ export type { AgentSession };
22
+ export { renderTurnRoleAnchor, renderTurnTimeAnchor } from "./system-prompt.js";
23
+ type AgentSessionTools = NonNullable<Parameters<typeof createAgentSession>[0]>['tools'];
24
+ export { DEFAULT_MAX_OUTPUT_TOKENS } from "./output-allowance.js";
25
+ export type PluginSessionWiring = {
26
+ registry: PluginRegistry;
27
+ hooks: HookBus;
28
+ sessionId: string;
29
+ agentDir: string;
30
+ };
31
+ export type PluginSubagentSelection = {
32
+ pluginName: string;
33
+ toolRefs?: BuiltinToolRef[];
34
+ customTools?: PluginTool<any>[];
35
+ toolNamePrefix: string;
36
+ };
37
+ export type SessionOriginRef = {
38
+ current: SessionOrigin | undefined;
39
+ };
40
+ export type CreateSessionOptions = {
41
+ reloadRegistry?: ReloadRegistry;
42
+ sessionManager?: SessionManager;
43
+ stream?: Stream;
44
+ channelRouter?: ChannelRouter;
45
+ mcpManager?: McpManager;
46
+ systemPromptOverride?: string;
47
+ origin?: SessionOrigin;
48
+ originRef?: SessionOriginRef;
49
+ tools?: AgentSessionTools;
50
+ customTools?: ToolDefinition[];
51
+ plugins?: PluginSessionWiring;
52
+ pluginSubagent?: PluginSubagentSelection;
53
+ bashPolicy?: SubagentBashPolicy;
54
+ containerName?: string;
55
+ runtimeVersion?: string;
56
+ permissions?: PermissionService;
57
+ reloadRoles?: () => RolesConfig | undefined;
58
+ profile?: string;
59
+ thinkingLevel?: ThinkingLevel;
60
+ refOverride?: ModelRef;
61
+ toolResultBudget?: ToolResultBudget;
62
+ toolResultBudgetMessage?: ToolResultBudget['exhaustedMessage'];
63
+ liveSubagentRegistry?: LiveSubagentRegistry;
64
+ subagentCoalescer?: SubagentCoalescer;
65
+ subagentRegistry?: SubagentRegistry;
66
+ createSessionForSubagent?: CreateSessionForSubagent;
67
+ allowBackgroundFromSubagent?: boolean;
68
+ };
69
+ export type CreateSessionResult = {
70
+ session: AgentSession & {
71
+ getAbortReason?: () => string | undefined;
72
+ };
73
+ dispose: () => Promise<void>;
74
+ getAbortReason?: () => string | undefined;
75
+ };
76
+ export declare function resolveSessionThinkingLevel(models: Models, resolved: Pick<ResolvedProfile, 'thinkingLevel' | 'profile'> & {
77
+ fellBackToDefault?: boolean;
78
+ }, activeRef: ModelRef, override?: ThinkingLevel): ThinkingLevel | undefined;
79
+ export declare function createSession(options?: CreateSessionOptions): Promise<AgentSession>;
80
+ export declare function attachLoopGuardTurnTracking(agent: {
81
+ subscribe: (listener: (event: unknown) => void) => () => void;
82
+ }, onTurnStart: () => void): () => void;
83
+ export declare function createSessionWithDispose(options?: CreateSessionOptions): Promise<CreateSessionResult>;
84
+ export declare function buildRestartHandoffWiring(options: {
85
+ origin?: SessionOrigin;
86
+ plugins?: {
87
+ agentDir: string;
88
+ };
89
+ }, sessionManager: SessionManager): {
90
+ agentDir?: string;
91
+ originatingSessionFile?: string;
92
+ handoffOrigin?: RestartHandoffOrigin;
93
+ };
94
+ export declare function currentChannelAuthor(getOrigin: () => SessionOrigin | undefined): string | undefined;
95
+ export declare function subscribeRestartNotice(stream: Stream | undefined, sessionManager: SessionManager): (() => void) | null;
96
+ export declare function formatRestartNotice(restartedAt: string): string;
97
+ export declare function formatRestartNoticeOriginating(restartedAt: string): string;
98
+ export declare function buildChannelTools(channelRouter: ChannelRouter | undefined, origin: SessionOrigin | undefined, sessionId?: string, getOrigin?: () => SessionOrigin | undefined, permissions?: PermissionService, agentDir?: string): ToolDefinition[];
99
+ export declare function buildMcpDispatcherToolDefinitions(manager: McpManager, opts: {
100
+ permissions: PermissionService | undefined;
101
+ getOrigin: () => SessionOrigin | undefined;
102
+ agentDir: string;
103
+ }): ToolDefinition[];
104
+ export declare function buildSubagentOrchestrationTools(opts: {
105
+ liveRegistry: LiveSubagentRegistry | undefined;
106
+ registry: SubagentRegistry | undefined;
107
+ createSessionForSubagent: CreateSessionForSubagent | undefined;
108
+ agentDir: string | undefined;
109
+ parentSessionId: string;
110
+ getOrigin: () => SessionOrigin | undefined;
111
+ getSessionFile?: () => string | undefined;
112
+ permissions: PermissionService | undefined;
113
+ stream: Stream | undefined;
114
+ allowBackgroundFromSubagent?: boolean;
115
+ coalescer?: SubagentCoalescer;
116
+ channelRouter?: ChannelRouter;
117
+ }): ToolDefinition[];
118
+ export declare function buildRoleGrantTools(opts: {
119
+ agentDir: string | undefined;
120
+ getOrigin: () => SessionOrigin | undefined;
121
+ permissions: PermissionService | undefined;
122
+ reloadRoles: (() => RolesConfig | undefined) | undefined;
123
+ }): ToolDefinition[];
124
+ export declare function buildTodoTools(agentDir: string | undefined, getOrigin: () => SessionOrigin | undefined): ToolDefinition[];
125
+ export declare function wrapSystemTools(tools: ToolDefinition[], options: {
126
+ agentDir: string;
127
+ sessionId: string;
128
+ hooks: HookBus;
129
+ guards?: readonly InternalGuard[];
130
+ getOrigin: () => SessionOrigin | undefined;
131
+ getAbort: () => ((reason?: string) => void) | undefined;
132
+ getLoopGuardTurn?: () => number | undefined;
133
+ mcpManager?: McpManager;
134
+ }): ToolDefinition[];
135
+ export declare function wrapSubagentCustomTools(selection: PluginSubagentSelection, plugins: PluginSessionWiring | undefined, getOrigin: () => SessionOrigin | undefined, getAbort: () => ((reason?: string) => void) | undefined, getLoopGuardTurn: () => number | undefined, permissions: PermissionService | undefined): ToolDefinition[];
136
+ export declare function createOverrideResourceLoader(systemPrompt: string, origin?: SessionOrigin, permissions?: PermissionService, runtimeVersion?: string): Promise<DefaultResourceLoader>;
137
+ export type CreateResourceLoaderOptions = {
138
+ agentDir?: string;
139
+ plugins?: PluginSessionWiring;
140
+ materializedSkills?: MaterializedSkills | null;
141
+ origin?: SessionOrigin;
142
+ mcpManager?: McpManager;
143
+ permissions?: PermissionService;
144
+ runtimeVersion?: string;
145
+ subagentRegistry?: SubagentRegistry;
146
+ mode?: SystemPromptMode;
147
+ proactiveNextStepNudge?: boolean;
148
+ evalEnabled?: boolean;
149
+ };
150
+ export declare function createResourceLoader(options?: CreateResourceLoaderOptions): Promise<DefaultResourceLoader>;
151
+ export declare function getBundledSkillsDir(): string;
@@ -0,0 +1,113 @@
1
+ import type { AgentSession } from "./index.js";
2
+ export type SubagentProgressEvent = {
3
+ kind: 'started';
4
+ ts: number;
5
+ } | {
6
+ kind: 'tool';
7
+ name: string;
8
+ ok: boolean;
9
+ ts: number;
10
+ } | {
11
+ kind: 'message';
12
+ preview: string;
13
+ ts: number;
14
+ };
15
+ export type SubagentStatus = 'running' | 'completed' | 'failed';
16
+ export type SubagentCompletion = {
17
+ ok: boolean;
18
+ finalMessage?: string;
19
+ error?: string;
20
+ durationMs: number;
21
+ };
22
+ export type LiveSubagent = {
23
+ taskId: string;
24
+ sessionId: string;
25
+ subagentName: string;
26
+ parentSessionId?: string;
27
+ workKey?: string;
28
+ spawnedByRole?: string;
29
+ background?: boolean;
30
+ startedAt: number;
31
+ status: SubagentStatus;
32
+ completion?: SubagentCompletion;
33
+ abort: () => Promise<void>;
34
+ releaseCoalesceKey?: () => void;
35
+ };
36
+ export type PendingWorkKeyRegistration = {
37
+ readonly workKey: string;
38
+ cancelled: boolean;
39
+ };
40
+ export declare const MAX_EVENTS_PER_SUBAGENT = 100;
41
+ export declare const MESSAGE_PREVIEW_CHARS = 200;
42
+ export declare function newestRunningBackgroundChildStartedAt(children: readonly LiveSubagent[]): number | null;
43
+ type AgentSessionEvent = {
44
+ type: 'message_update';
45
+ assistantMessageEvent: {
46
+ type: string;
47
+ delta?: string;
48
+ };
49
+ } | {
50
+ type: 'message_end';
51
+ message: unknown;
52
+ } | {
53
+ type: 'tool_execution_start';
54
+ toolCallId: string;
55
+ toolName: string;
56
+ args: unknown;
57
+ } | {
58
+ type: 'tool_execution_end';
59
+ toolCallId: string;
60
+ toolName: string;
61
+ result: unknown;
62
+ isError: boolean;
63
+ } | {
64
+ type: string;
65
+ };
66
+ export declare function coarsen(event: AgentSessionEvent, now: number): SubagentProgressEvent | null;
67
+ export type StatusSnapshot = {
68
+ taskId: string;
69
+ sessionId: string;
70
+ subagentName: string;
71
+ status: SubagentStatus;
72
+ startedAt: number;
73
+ elapsedMs: number;
74
+ eventsCount: number;
75
+ eventsRecent: SubagentProgressEvent[];
76
+ lastActivity: SubagentProgressEvent | null;
77
+ statusSummary: string;
78
+ completion?: SubagentCompletion;
79
+ };
80
+ export declare class LiveSubagentRegistry {
81
+ private readonly listeners;
82
+ private readonly entries;
83
+ private readonly events;
84
+ private readonly capturedFinalMessages;
85
+ private readonly pendingWorkKeyRegistrations;
86
+ subscribe(listener: (parentSessionId: string | undefined) => void): () => void;
87
+ private notify;
88
+ register(live: LiveSubagent): void;
89
+ beginWorkKeyRegistration(workKey: string): PendingWorkKeyRegistration;
90
+ abandonWorkKeyRegistration(registration: PendingWorkKeyRegistration): void;
91
+ registerIfWorkKeyActive(live: LiveSubagent, registration: PendingWorkKeyRegistration): boolean;
92
+ unregister(taskId: string): void;
93
+ get(taskId: string): LiveSubagent | undefined;
94
+ list(filter?: {
95
+ parentSessionId?: string;
96
+ }): LiveSubagent[];
97
+ hasLiveForSession(sessionId: string): boolean;
98
+ recordEvent(taskId: string, event: SubagentProgressEvent): void;
99
+ recordCapturedFinalMessageIfRunning(taskId: string, finalMessage: string): boolean;
100
+ getCapturedFinalMessage(taskId: string): string | undefined;
101
+ recordCompletion(taskId: string, completion: SubagentCompletion): void;
102
+ recordCompletionIfRunning(taskId: string, completion: SubagentCompletion): boolean;
103
+ cancelRunningByWorkKey(workKey: string, reason: string): Promise<{
104
+ matched: number;
105
+ cancelled: number;
106
+ failures: number;
107
+ }>;
108
+ snapshot(taskId: string, now?: number): StatusSnapshot | undefined;
109
+ clear(): void;
110
+ private removePendingWorkKeyRegistration;
111
+ }
112
+ export declare function attachProgressCapture(registry: LiveSubagentRegistry, taskId: string, session: Pick<AgentSession, 'subscribe'>): () => void;
113
+ export {};
@@ -0,0 +1,11 @@
1
+ import type { Message } from '@earendil-works/pi-ai';
2
+ export type ReplaySanitizerStats = {
3
+ droppedOrphans: number;
4
+ droppedDuplicates: number;
5
+ droppedErrorAssistants: number;
6
+ };
7
+ export type SanitizeResult = {
8
+ messages: Message[];
9
+ stats: ReplaySanitizerStats;
10
+ };
11
+ export declare function sanitizeMessagesForLlmReplay(messages: Message[]): SanitizeResult;
@@ -0,0 +1,67 @@
1
+ export declare const LOOP_SOFT_WARN = 3;
2
+ export declare const LOOP_HARD_BLOCK = 5;
3
+ export declare const WINDOW_SIZE = 16;
4
+ export declare const WINDOW_SOFT_WARN = 4;
5
+ export declare const WINDOW_HARD_BLOCK = 6;
6
+ export type LoopReason = 'consecutive' | 'windowed';
7
+ export type LoopGuardReceipt = {
8
+ sessionId: string;
9
+ tool: string;
10
+ signature: string;
11
+ windowSignature: string;
12
+ recorded: boolean;
13
+ readPage?: ReadPage;
14
+ };
15
+ export type LoopGuardCheckContext = {
16
+ turnId?: number;
17
+ cwd?: string;
18
+ };
19
+ export type LoopObservedResult = 'running' | 'terminal';
20
+ export type ReadObservedResult = {
21
+ nonEmpty: boolean;
22
+ outputLines?: number;
23
+ textual?: boolean;
24
+ };
25
+ export type LoopGuardDecision = {
26
+ kind: 'ok';
27
+ receipt: LoopGuardReceipt;
28
+ } | {
29
+ kind: 'warn';
30
+ count: number;
31
+ reason: LoopReason;
32
+ message: string;
33
+ receipt: LoopGuardReceipt;
34
+ } | {
35
+ kind: 'block';
36
+ count: number;
37
+ reason: LoopReason;
38
+ message: string;
39
+ receipt: LoopGuardReceipt;
40
+ deferable: boolean;
41
+ };
42
+ export type LoopGuard = {
43
+ check: (sessionId: string, tool: string, args: unknown, context?: LoopGuardCheckContext) => LoopGuardDecision;
44
+ reset: (sessionId: string) => void;
45
+ forget: (sessionId: string) => void;
46
+ forgetTool: (sessionId: string, tool: string) => void;
47
+ retract: (receipt: LoopGuardReceipt) => void;
48
+ noteResult: (receipt: LoopGuardReceipt, result: LoopObservedResult) => void;
49
+ noteReadResult: (receipt: LoopGuardReceipt, result: ReadObservedResult) => void;
50
+ };
51
+ export type CreateLoopGuardOptions = {
52
+ softWarn?: number;
53
+ hardBlock?: number;
54
+ maxSessions?: number;
55
+ windowSize?: number;
56
+ windowSoftWarn?: number;
57
+ windowHardBlock?: number;
58
+ };
59
+ export declare function createLoopGuard(options?: CreateLoopGuardOptions): LoopGuard;
60
+ type ReadTarget = {
61
+ path: string;
62
+ };
63
+ type ReadPage = ReadTarget & {
64
+ offset: number;
65
+ limit?: number;
66
+ };
67
+ export {};
@@ -0,0 +1,29 @@
1
+ import type { Models } from "../config/config.js";
2
+ import type { KnownModelRef, ModelRef } from "../config/providers.js";
3
+ import type { AgentSession } from "./index.js";
4
+ type FallbackModelRef = KnownModelRef | ModelRef;
5
+ export type FallbackPromptResult<TRef extends FallbackModelRef = ModelRef> = {
6
+ success: boolean;
7
+ refUsed: TRef;
8
+ attempts: FallbackAttempt<TRef>[];
9
+ session: AgentSession;
10
+ dispose: () => Promise<void>;
11
+ lastError?: Error;
12
+ };
13
+ export type FallbackAttempt<TRef extends FallbackModelRef = ModelRef> = {
14
+ ref: TRef;
15
+ outcome: 'hard' | 'soft' | 'success';
16
+ errorMessage?: string;
17
+ };
18
+ export declare function resolveFallbackChain(models: Models, profile: string | undefined): ModelRef[];
19
+ export declare function promptWithFallback<TRef extends FallbackModelRef>(opts: {
20
+ refs: TRef[];
21
+ text: string;
22
+ createSessionForRef: (ref: TRef) => Promise<{
23
+ session: AgentSession;
24
+ dispose: () => Promise<void>;
25
+ }>;
26
+ onAttemptFailed?: (attempt: FallbackAttempt<TRef>) => void;
27
+ shouldFailover?: (err: Error) => boolean;
28
+ }): Promise<FallbackPromptResult<TRef>>;
29
+ export {};
@@ -0,0 +1,8 @@
1
+ import type { Api, Model } from '@earendil-works/pi-ai';
2
+ import { type KnownModelRef, type KnownProviderId, type ModelRef } from "../config/providers.js";
3
+ export declare const PROVIDER_BASE_URL_ENV: {
4
+ readonly anthropic: "ANTHROPIC_BASE_URL";
5
+ readonly openai: "OPENAI_BASE_URL";
6
+ };
7
+ export declare function applyModelRuntimeOverrides<TApi extends Api>(model: Model<TApi>, ref: KnownModelRef | ModelRef | string, env?: NodeJS.ProcessEnv): Model<TApi>;
8
+ export declare function effectiveBaseUrl(providerId: KnownProviderId, fallback: string, env?: NodeJS.ProcessEnv): string | undefined;
@@ -0,0 +1,2 @@
1
+ export { createChannelLookAtTool, createLookAtTool, lookAtTool } from "./look-at.js";
2
+ export { buildMultimodalLookerSystemPrompt, imageInputSchema, multimodalLookerPayloadSchema, resolveImage, URL_FETCH_MAX_BYTES, URL_FETCH_TIMEOUT_MS, type ImageInput, type MultimodalLookerPayload, type ResolvedImage, } from "./looker.js";
@@ -0,0 +1,60 @@
1
+ import { Type } from '@earendil-works/pi-ai';
2
+ import type { ImageContent } from '@earendil-works/pi-ai';
3
+ import type { ChannelRouter } from "../../channels/router.js";
4
+ import type { AdapterId } from "../../channels/schema.js";
5
+ import type { PermissionService } from "../../permissions/index.js";
6
+ type LookAtDetails = {
7
+ count: number;
8
+ prompt?: string;
9
+ text?: string;
10
+ error?: string;
11
+ };
12
+ export type ChannelLookAtOrigin = {
13
+ adapter: AdapterId;
14
+ workspace: string;
15
+ chat: string;
16
+ thread: string | null;
17
+ };
18
+ export declare function createLookAtTool(permissions?: PermissionService): import("@earendil-works/pi-coding-agent").ToolDefinition<Type.TObject<{
19
+ images: Type.TArray<Type.TObject<{
20
+ url: Type.TOptional<Type.TString>;
21
+ path: Type.TOptional<Type.TString>;
22
+ data: Type.TOptional<Type.TString>;
23
+ mimeType: Type.TOptional<Type.TString>;
24
+ }>>;
25
+ prompt: Type.TOptional<Type.TString>;
26
+ }>, LookAtDetails, any> & import("@earendil-works/pi-coding-agent").ToolDefinition<any, any, any>;
27
+ export declare const lookAtTool: import("@earendil-works/pi-coding-agent").ToolDefinition<Type.TObject<{
28
+ images: Type.TArray<Type.TObject<{
29
+ url: Type.TOptional<Type.TString>;
30
+ path: Type.TOptional<Type.TString>;
31
+ data: Type.TOptional<Type.TString>;
32
+ mimeType: Type.TOptional<Type.TString>;
33
+ }>>;
34
+ prompt: Type.TOptional<Type.TString>;
35
+ }>, LookAtDetails, any> & import("@earendil-works/pi-coding-agent").ToolDefinition<any, any, any>;
36
+ export declare function createChannelLookAtTool(router: ChannelRouter, origin: ChannelLookAtOrigin, permissions?: PermissionService): import("@earendil-works/pi-coding-agent").ToolDefinition<Type.TObject<{
37
+ attachment_id: Type.TInteger;
38
+ file_id: Type.TOptional<Type.TString>;
39
+ prompt: Type.TOptional<Type.TString>;
40
+ }>, LookAtDetails, any> & import("@earendil-works/pi-coding-agent").ToolDefinition<any, any, any>;
41
+ export declare const GLM_VISION_MAX_RESPONSE_BYTES: number;
42
+ export declare const GLM_VISION_TTFB_MS = 45000;
43
+ export declare function resolveGlmVisionTtfbMs(env?: NodeJS.ProcessEnv): number;
44
+ export declare function buildGlmVisionMessages(imageContents: ImageContent[], prompt: string | undefined): ({
45
+ role: "system";
46
+ content: string;
47
+ } | {
48
+ role: "user";
49
+ content: ({
50
+ type: "image_url";
51
+ image_url: {
52
+ url: string;
53
+ };
54
+ } | {
55
+ type: "text";
56
+ text: string;
57
+ })[];
58
+ })[];
59
+ export declare function extractGlmVisionText(body: unknown): string | null;
60
+ export {};