@chankov/agent-fleet 2.0.19 → 2.0.20

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 (784) hide show
  1. package/.pi/agent-fleet/scripts/coms-claude-bridge.ts +5 -5
  2. package/.pi/extensions/compact-and-continue/index.ts +18 -2
  3. package/.pi/harnesses/agent-hub/README.md +163 -130
  4. package/.pi/harnesses/agent-hub/access-approval.ts +15 -9
  5. package/.pi/harnesses/agent-hub/action-authorization.ts +10 -0
  6. package/.pi/harnesses/agent-hub/agentic-sources.ts +1 -1
  7. package/.pi/harnesses/agent-hub/approval-wait.ts +1 -0
  8. package/.pi/harnesses/agent-hub/assist-profile.ts +3 -0
  9. package/.pi/harnesses/agent-hub/budget-recovery.ts +4 -95
  10. package/.pi/harnesses/agent-hub/commands/context.ts +0 -1
  11. package/.pi/harnesses/agent-hub/config/model-profiles.ts +3 -2
  12. package/.pi/harnesses/agent-hub/config/overrides.ts +2 -2
  13. package/.pi/harnesses/agent-hub/context/budgets.ts +12 -66
  14. package/.pi/harnesses/agent-hub/context-compaction-monitor.ts +35 -0
  15. package/.pi/harnesses/agent-hub/context-compaction-preflight.ts +21 -0
  16. package/.pi/harnesses/agent-hub/context-compaction-runtime.ts +69 -0
  17. package/.pi/harnesses/agent-hub/context-compaction.ts +34 -0
  18. package/.pi/harnesses/agent-hub/context-continuity-broker.ts +42 -0
  19. package/.pi/harnesses/agent-hub/context-continuity-child.ts +83 -0
  20. package/.pi/harnesses/agent-hub/context-continuity-client.ts +19 -0
  21. package/.pi/harnesses/agent-hub/context-continuity-compat.ts +30 -0
  22. package/.pi/harnesses/agent-hub/context-continuity-owners.ts +15 -0
  23. package/.pi/harnesses/agent-hub/context-continuity-registry.ts +8 -0
  24. package/.pi/harnesses/agent-hub/context-continuity.ts +82 -0
  25. package/.pi/harnesses/agent-hub/context-pressure.ts +37 -6
  26. package/.pi/harnesses/agent-hub/damage-guard-approval.ts +59 -0
  27. package/.pi/harnesses/agent-hub/damage-guard-broker.ts +125 -0
  28. package/.pi/harnesses/agent-hub/damage-guard-contract.ts +22 -0
  29. package/.pi/harnesses/agent-hub/damage-guard-descendant.ts +76 -0
  30. package/.pi/harnesses/agent-hub/damage-guard-hub.ts +249 -0
  31. package/.pi/harnesses/agent-hub/damage-guard-identity.ts +12 -0
  32. package/.pi/harnesses/agent-hub/damage-guard-owners.ts +54 -0
  33. package/.pi/harnesses/agent-hub/damage-guard-state.ts +43 -0
  34. package/.pi/harnesses/agent-hub/delegate.ts +4 -4
  35. package/.pi/harnesses/agent-hub/deterministic-fs.ts +33 -7
  36. package/.pi/harnesses/agent-hub/dispatch-coms.ts +3 -2
  37. package/.pi/harnesses/agent-hub/dispatch-native-complete.ts +1 -1
  38. package/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +32 -7
  39. package/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +24 -4
  40. package/.pi/harnesses/agent-hub/dispatch-native-types.ts +26 -0
  41. package/.pi/harnesses/agent-hub/dispatch-native.ts +2 -0
  42. package/.pi/harnesses/agent-hub/execution-trace.ts +241 -0
  43. package/.pi/harnesses/agent-hub/file-discovery/adapters.ts +9 -3
  44. package/.pi/harnesses/agent-hub/file-discovery/broker-client.ts +10 -4
  45. package/.pi/harnesses/agent-hub/file-discovery/broker.ts +8 -5
  46. package/.pi/harnesses/agent-hub/file-discovery/child-extension.ts +17 -8
  47. package/.pi/harnesses/agent-hub/file-discovery/descendant.ts +5 -1
  48. package/.pi/harnesses/agent-hub/file-discovery/discovery-worker.mjs +1 -1
  49. package/.pi/harnesses/agent-hub/file-discovery/evaluate.ts +14 -5
  50. package/.pi/harnesses/agent-hub/file-discovery/hub.ts +33 -16
  51. package/.pi/harnesses/agent-hub/file-discovery/results.ts +7 -6
  52. package/.pi/harnesses/agent-hub/file-discovery/runtime.ts +21 -11
  53. package/.pi/harnesses/agent-hub/file-discovery/semantic-profiles.ts +18 -0
  54. package/.pi/harnesses/agent-hub/file-discovery/sources.ts +2 -2
  55. package/.pi/harnesses/agent-hub/filesystem-tool.ts +6 -25
  56. package/.pi/harnesses/agent-hub/history-projection.ts +116 -0
  57. package/.pi/harnesses/agent-hub/hub-state-audit.js +0 -24
  58. package/.pi/harnesses/agent-hub/index.ts +102 -113
  59. package/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +122 -24
  60. package/.pi/harnesses/agent-hub/no-progress.ts +42 -15
  61. package/.pi/harnesses/agent-hub/operator-watchdog.ts +97 -0
  62. package/.pi/harnesses/agent-hub/orchestration-activation.ts +18 -21
  63. package/.pi/harnesses/agent-hub/orchestration-route.ts +8 -16
  64. package/.pi/harnesses/agent-hub/package.json +1 -1
  65. package/.pi/harnesses/agent-hub/policy/work-mode.ts +8 -3
  66. package/.pi/harnesses/agent-hub/proactive-runtime.ts +1 -1
  67. package/.pi/harnesses/agent-hub/process-obligations.ts +23 -22
  68. package/.pi/harnesses/agent-hub/prompts/context.ts +1 -2
  69. package/.pi/harnesses/agent-hub/prompts/fragments.ts +21 -30
  70. package/.pi/harnesses/agent-hub/prompts/session-start.ts +1 -1
  71. package/.pi/harnesses/agent-hub/recovery-contract.ts +2 -1
  72. package/.pi/harnesses/agent-hub/research/runtime.ts +14 -0
  73. package/.pi/harnesses/agent-hub/research/spawn-run.ts +41 -14
  74. package/.pi/harnesses/agent-hub/review-continuity.ts +73 -0
  75. package/.pi/harnesses/agent-hub/review-findings.js +2 -10
  76. package/.pi/harnesses/agent-hub/review-reuse.ts +47 -0
  77. package/.pi/harnesses/agent-hub/run-budget.js +17 -229
  78. package/.pi/harnesses/agent-hub/scope-gate.js +99 -15
  79. package/.pi/harnesses/agent-hub/session-audit.ts +22 -4
  80. package/.pi/harnesses/agent-hub/spawn.ts +87 -11
  81. package/.pi/harnesses/agent-hub/specialist-result-receipt.ts +13 -0
  82. package/.pi/harnesses/agent-hub/specialist-result.ts +69 -0
  83. package/.pi/harnesses/agent-hub/system1-communication-store.ts +29 -2
  84. package/.pi/harnesses/agent-hub/system1-runtime.ts +7 -0
  85. package/.pi/harnesses/agent-hub/task-continuation.ts +4 -0
  86. package/.pi/harnesses/agent-hub/task-triage-authorization.ts +43 -14
  87. package/.pi/harnesses/agent-hub/task-triage-config.ts +5 -14
  88. package/.pi/harnesses/agent-hub/task-triage-obligations.ts +17 -1
  89. package/.pi/harnesses/agent-hub/task-triage-runtime.ts +15 -10
  90. package/.pi/harnesses/agent-hub/task-triage-stage-guard.ts +1 -1
  91. package/.pi/harnesses/agent-hub/tool-catalog-runtime.ts +18 -7
  92. package/.pi/harnesses/agent-hub/tools/action-executors.ts +11 -10
  93. package/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +2 -2
  94. package/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +144 -64
  95. package/.pi/harnesses/agent-hub/ui/context-budget.ts +5 -3
  96. package/.pi/harnesses/agent-hub/ui/grid.ts +1 -1
  97. package/.pi/harnesses/agent-hub/work-mode.ts +3 -4
  98. package/.pi/harnesses/ask-user-remote/index.ts +13 -2
  99. package/.pi/harnesses/ask-user-remote/questions.ts +4 -6
  100. package/.pi/harnesses/ask-user-remote/runtime-ask.ts +16 -1
  101. package/.pi/harnesses/coms/package.json +1 -1
  102. package/.pi/harnesses/damage-control-continue/README.md +26 -0
  103. package/.pi/harnesses/damage-control-continue/index.ts +87 -20
  104. package/.pi/harnesses/damage-control-continue/package.json +1 -1
  105. package/.pi/harnesses/damage-control-continue/result-screen.ts +98 -0
  106. package/.pi/harnesses/damage-control-continue/system1-child.ts +35 -0
  107. package/.pi/harnesses/damage-control-continue/system1-client.ts +85 -0
  108. package/.pi/harnesses/damage-control-continue/system1-guard.ts +65 -0
  109. package/.pi/harnesses/lib/approval-wait.ts +17 -0
  110. package/.pi/harnesses/lib/bash-policy-analysis.ts +155 -0
  111. package/.pi/harnesses/lib/clarification-policy.ts +9 -0
  112. package/.pi/harnesses/lib/coms-core-io.ts +2 -1
  113. package/.pi/harnesses/lib/coms-core.ts +3 -2
  114. package/.pi/harnesses/lib/coms-registry-entry.ts +4 -2
  115. package/.pi/harnesses/lib/context-budget-child-prompt.ts +8 -14
  116. package/.pi/harnesses/lib/context-budget-view.ts +5 -0
  117. package/.pi/harnesses/lib/context-compaction-policy.js +35 -0
  118. package/.pi/harnesses/lib/damage-action-hash.ts +28 -0
  119. package/.pi/harnesses/lib/damage-control-shared.ts +3 -0
  120. package/.pi/harnesses/lib/damage-guard-port.ts +25 -0
  121. package/.pi/harnesses/lib/damage-result-evidence.ts +25 -0
  122. package/.pi/harnesses/lib/damage-result-view.ts +16 -0
  123. package/.pi/harnesses/lib/execution-trace.ts +45 -0
  124. package/.pi/harnesses/lib/herdr-presence.ts +4 -4
  125. package/.pi/harnesses/lib/identical-dialog.ts +27 -0
  126. package/.pi/harnesses/lib/installation-state.js +62 -0
  127. package/.pi/harnesses/lib/process-shared.ts +9 -0
  128. package/.pi/harnesses/lib/semantic-approval.ts +80 -0
  129. package/.pi/harnesses/lib/system1/config-context-compaction.js +16 -0
  130. package/.pi/harnesses/lib/system1/config-damage-guard.js +24 -0
  131. package/.pi/harnesses/lib/system1/config-file-discovery.js +4 -2
  132. package/.pi/harnesses/lib/system1/config-v2.js +11 -5
  133. package/.pi/harnesses/lib/system1/payload-screen.ts +65 -0
  134. package/.pi/harnesses/lib/system1/service.ts +1 -1
  135. package/.pi/harnesses/package-lock.json +1041 -959
  136. package/.pi/harnesses/package.json +3 -0
  137. package/.versions/2.0.20/.pi/agent-fleet/hermes/README.md +347 -0
  138. package/.versions/2.0.20/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  139. package/.versions/2.0.20/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  140. package/.versions/2.0.20/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  141. package/.versions/2.0.20/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  142. package/.versions/2.0.20/.pi/agent-fleet/hermes/gates/gate-o-capability.md +8 -0
  143. package/.versions/2.0.20/.pi/agent-fleet/hermes/gates/gate-o-validator-fixtures.json +1 -0
  144. package/.versions/2.0.20/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +773 -0
  145. package/.versions/2.0.20/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  146. package/.versions/2.0.20/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  147. package/.versions/2.0.20/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  148. package/.versions/2.0.20/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  149. package/.versions/2.0.20/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  150. package/.versions/2.0.20/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  151. package/.versions/2.0.20/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  152. package/.versions/2.0.20/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  153. package/.versions/2.0.20/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  154. package/.versions/2.0.20/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  155. package/.versions/2.0.20/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  156. package/.versions/2.0.20/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  157. package/.versions/2.0.20/.pi/agent-fleet/hermes/skills/hub-conductor/SKILL.md +84 -0
  158. package/.versions/2.0.20/.pi/agent-fleet/hermes/skills/hub-liaison/SKILL.md +84 -0
  159. package/.versions/2.0.20/.pi/agent-fleet/hermes/skills/hub-watchdog/SKILL.md +76 -0
  160. package/.versions/2.0.20/.pi/agent-fleet/hermes/skills/hub-watchdog/manifest.json +1 -0
  161. package/.versions/2.0.20/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  162. package/.versions/2.0.20/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  163. package/.versions/2.0.20/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  164. package/.versions/2.0.20/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  165. package/.versions/2.0.20/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  166. package/.versions/2.0.20/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  167. package/.versions/2.0.20/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  168. package/.versions/2.0.20/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  169. package/.versions/2.0.20/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  170. package/.versions/2.0.20/.pi/agent-fleet/hermes/watchdog-tests/__init__.py +0 -0
  171. package/.versions/2.0.20/.pi/agent-fleet/hooks/coms-stop-hook.mjs +84 -0
  172. package/.versions/2.0.20/.pi/agent-fleet/scripts/claude-code-preflight.ts +70 -0
  173. package/.versions/2.0.20/.pi/agent-fleet/scripts/coms-claude-bridge.ts +437 -0
  174. package/.versions/2.0.20/.pi/agent-fleet/scripts/coms-cli.ts +425 -0
  175. package/.versions/2.0.20/.pi/agent-fleet/scripts/coms-hermes-bridge.ts +413 -0
  176. package/.versions/2.0.20/.pi/agent-fleet/scripts/fleet-codex-client.ts +69 -0
  177. package/.versions/2.0.20/.pi/agent-fleet/scripts/fleet-codex-read.py +148 -0
  178. package/.versions/2.0.20/.pi/agent-fleet/scripts/fleet.ts +217 -0
  179. package/.versions/2.0.20/.pi/agent-fleet/scripts/flow.ts +157 -0
  180. package/.versions/2.0.20/.pi/agent-fleet/scripts/hermes-monitor-capability-runner.ts +25 -0
  181. package/.versions/2.0.20/.pi/agent-fleet/scripts/hermes-monitor-scenario.ts +474 -0
  182. package/.versions/2.0.20/.pi/agent-fleet/scripts/hermes-watchdog-capability-probe.ts +45 -0
  183. package/.versions/2.0.20/.pi/agent-fleet/scripts/install-hermes-plugin.sh +180 -0
  184. package/.versions/2.0.20/.pi/agent-fleet/scripts/lib/claude-bridge-core.ts +208 -0
  185. package/.versions/2.0.20/.pi/agent-fleet/scripts/lib/coms-envelope.ts +582 -0
  186. package/.versions/2.0.20/.pi/agent-fleet/scripts/lib/fake-herdr-server.ts +88 -0
  187. package/.versions/2.0.20/.pi/agent-fleet/scripts/lib/fleet-codex-catalog.ts +63 -0
  188. package/.versions/2.0.20/.pi/agent-fleet/scripts/lib/fleet-codex-operations.ts +190 -0
  189. package/.versions/2.0.20/.pi/agent-fleet/scripts/lib/fleet-codex-session.ts +166 -0
  190. package/.versions/2.0.20/.pi/agent-fleet/scripts/lib/fleet-codex-transport.ts +124 -0
  191. package/.versions/2.0.20/.pi/agent-fleet/scripts/lib/fleet-command.ts +252 -0
  192. package/.versions/2.0.20/.pi/agent-fleet/scripts/lib/flow-command.ts +98 -0
  193. package/.versions/2.0.20/.pi/agent-fleet/scripts/lib/flow-maintenance.ts +230 -0
  194. package/.versions/2.0.20/.pi/agent-fleet/scripts/lib/herdr-layout.ts +281 -0
  195. package/.versions/2.0.20/.pi/agent-fleet/scripts/lib/hermes-bridge-core.ts +241 -0
  196. package/.versions/2.0.20/.pi/agent-fleet/scripts/lib/hermes-monitor-events.ts +1 -0
  197. package/.versions/2.0.20/.pi/agent-fleet/scripts/lib/hermes-monitor-herdr.ts +2 -0
  198. package/.versions/2.0.20/.pi/agent-fleet/scripts/lib/hermes-monitor-model.ts +3 -0
  199. package/.versions/2.0.20/.pi/agent-fleet/scripts/lib/hermes-monitor-registry.ts +2 -0
  200. package/.versions/2.0.20/.pi/agent-fleet/scripts/lib/hermes-monitor-socket.ts +2 -0
  201. package/.versions/2.0.20/.pi/agent-fleet/scripts/lib/hermes-monitor-store.ts +2 -0
  202. package/.versions/2.0.20/.pi/agent-fleet/scripts/lib/monitor-env.ts +146 -0
  203. package/.versions/2.0.20/.pi/agent-fleet/scripts/lib/peer-launch.ts +318 -0
  204. package/.versions/2.0.20/.pi/agent-fleet/scripts/lib/persona-banner.ts +62 -0
  205. package/.versions/2.0.20/.pi/agent-fleet/scripts/lib/persona-dirs.ts +25 -0
  206. package/.versions/2.0.20/.pi/agent-fleet/scripts/lib/runtime-dependencies.js +124 -0
  207. package/.versions/2.0.20/.pi/agent-fleet/scripts/lib/spawn-stagger.ts +101 -0
  208. package/.versions/2.0.20/.pi/agent-fleet/scripts/lib/team-project.ts +178 -0
  209. package/.versions/2.0.20/.pi/agent-fleet/scripts/lib/team-snapshot.ts +147 -0
  210. package/.versions/2.0.20/.pi/agent-fleet/scripts/package-lock.json +35 -0
  211. package/.versions/2.0.20/.pi/agent-fleet/scripts/package.json +9 -0
  212. package/.versions/2.0.20/.pi/agent-fleet/scripts/peer-banner.ts +41 -0
  213. package/.versions/2.0.20/.pi/agent-fleet/scripts/peer-launch.ts +283 -0
  214. package/.versions/2.0.20/.pi/agent-fleet/scripts/team-snapshot.ts +237 -0
  215. package/.versions/2.0.20/.pi/agent-fleet/scripts/team-up.ts +378 -0
  216. package/.versions/2.0.20/.pi/agent-fleet/scripts/workflows/lib/agent-phase.ts +179 -0
  217. package/.versions/2.0.20/.pi/agent-fleet/scripts/workflows/lib/changes.ts +61 -0
  218. package/.versions/2.0.20/.pi/agent-fleet/scripts/workflows/lib/debate.ts +149 -0
  219. package/.versions/2.0.20/.pi/agent-fleet/scripts/workflows/lib/env.ts +34 -0
  220. package/.versions/2.0.20/.pi/agent-fleet/scripts/workflows/lib/envelopes.ts +169 -0
  221. package/.versions/2.0.20/.pi/agent-fleet/scripts/workflows/lib/gates.ts +81 -0
  222. package/.versions/2.0.20/.pi/agent-fleet/scripts/workflows/lib/git.ts +96 -0
  223. package/.versions/2.0.20/.pi/agent-fleet/scripts/workflows/lib/isolated-snapshot.ts +125 -0
  224. package/.versions/2.0.20/.pi/agent-fleet/scripts/workflows/lib/merge.ts +95 -0
  225. package/.versions/2.0.20/.pi/agent-fleet/scripts/workflows/lib/model-profile.ts +22 -0
  226. package/.versions/2.0.20/.pi/agent-fleet/scripts/workflows/lib/model-visibility.ts +92 -0
  227. package/.versions/2.0.20/.pi/agent-fleet/scripts/workflows/lib/permissions.ts +130 -0
  228. package/.versions/2.0.20/.pi/agent-fleet/scripts/workflows/lib/personas.ts +57 -0
  229. package/.versions/2.0.20/.pi/agent-fleet/scripts/workflows/lib/poll.ts +86 -0
  230. package/.versions/2.0.20/.pi/agent-fleet/scripts/workflows/lib/project-policy.ts +36 -0
  231. package/.versions/2.0.20/.pi/agent-fleet/scripts/workflows/lib/quality.ts +64 -0
  232. package/.versions/2.0.20/.pi/agent-fleet/scripts/workflows/lib/run.ts +108 -0
  233. package/.versions/2.0.20/.pi/agent-fleet/scripts/workflows/lib/scout-data-boundary.ts +55 -0
  234. package/.versions/2.0.20/.pi/agent-fleet/scripts/workflows/lib/trace.ts +34 -0
  235. package/.versions/2.0.20/.pi/agent-fleet/scripts/workflows/lib/voices.ts +128 -0
  236. package/.versions/2.0.20/.pi/agent-fleet/scripts/workflows/lib/writer-lease.ts +112 -0
  237. package/.versions/2.0.20/.pi/agent-fleet/scripts/workflows/tsconfig.json +22 -0
  238. package/.versions/2.0.20/.pi/agent-fleet/scripts/workflows/wf-build-test.ts +61 -0
  239. package/.versions/2.0.20/.pi/agent-fleet/scripts/workflows/wf-debate.ts +87 -0
  240. package/.versions/2.0.20/.pi/agent-fleet/scripts/workflows/wf-document.ts +50 -0
  241. package/.versions/2.0.20/.pi/agent-fleet/scripts/workflows/wf-poll.ts +95 -0
  242. package/.versions/2.0.20/.pi/agent-fleet/scripts/workflows/wf-quality.ts +20 -0
  243. package/.versions/2.0.20/.pi/agent-fleet/scripts/workflows/wf-scout.ts +40 -0
  244. package/.versions/2.0.20/.pi/agents/dispatch-policy.yaml +32 -0
  245. package/.versions/2.0.20/.pi/agents/model-profiles.yaml +134 -0
  246. package/.versions/2.0.20/.pi/agents/peers.yaml +147 -0
  247. package/.versions/2.0.20/.pi/agents/teams.yaml +41 -0
  248. package/.versions/2.0.20/.pi/agents/voices.yaml +13 -0
  249. package/.versions/2.0.20/.pi/damage-control-rules.yaml +297 -0
  250. package/.versions/2.0.20/.pi/extensions/btw/README.md +120 -0
  251. package/.versions/2.0.20/.pi/extensions/btw/index.ts +914 -0
  252. package/.versions/2.0.20/.pi/extensions/btw/package.json +6 -0
  253. package/.versions/2.0.20/.pi/extensions/btw/state.js +179 -0
  254. package/.versions/2.0.20/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
  255. package/.versions/2.0.20/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  256. package/.versions/2.0.20/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  257. package/.versions/2.0.20/.pi/extensions/compact-and-continue/README.md +42 -0
  258. package/.versions/2.0.20/.pi/extensions/compact-and-continue/index.ts +136 -0
  259. package/.versions/2.0.20/.pi/extensions/compact-and-continue/package.json +6 -0
  260. package/.versions/2.0.20/.pi/extensions/mcp-bridge/README.md +46 -0
  261. package/.versions/2.0.20/.pi/extensions/mcp-bridge/index.ts +206 -0
  262. package/.versions/2.0.20/.pi/extensions/mcp-bridge/package.json +6 -0
  263. package/.versions/2.0.20/.pi/extensions/package-lock.json +1175 -0
  264. package/.versions/2.0.20/.pi/extensions/package.json +9 -0
  265. package/.versions/2.0.20/.pi/extensions/pi-voice-stt/README.md +224 -0
  266. package/.versions/2.0.20/.pi/extensions/pi-voice-stt/config.ts +198 -0
  267. package/.versions/2.0.20/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  268. package/.versions/2.0.20/.pi/extensions/pi-voice-stt/index.ts +248 -0
  269. package/.versions/2.0.20/.pi/extensions/pi-voice-stt/package.json +6 -0
  270. package/.versions/2.0.20/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  271. package/.versions/2.0.20/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  272. package/.versions/2.0.20/.pi/harnesses/agent-hub/README.md +1516 -0
  273. package/.versions/2.0.20/.pi/harnesses/agent-hub/acceptance.ts +199 -0
  274. package/.versions/2.0.20/.pi/harnesses/agent-hub/access-approval.ts +141 -0
  275. package/.versions/2.0.20/.pi/harnesses/agent-hub/action-authorization.ts +10 -0
  276. package/.versions/2.0.20/.pi/harnesses/agent-hub/agentic-contract.ts +43 -0
  277. package/.versions/2.0.20/.pi/harnesses/agent-hub/agentic-evidence.ts +64 -0
  278. package/.versions/2.0.20/.pi/harnesses/agent-hub/agentic-hub.ts +54 -0
  279. package/.versions/2.0.20/.pi/harnesses/agent-hub/agentic-runtime.ts +56 -0
  280. package/.versions/2.0.20/.pi/harnesses/agent-hub/agentic-sources-worker.mjs +4 -0
  281. package/.versions/2.0.20/.pi/harnesses/agent-hub/agentic-sources.ts +74 -0
  282. package/.versions/2.0.20/.pi/harnesses/agent-hub/agentic-state.ts +23 -0
  283. package/.versions/2.0.20/.pi/harnesses/agent-hub/approval-wait.ts +1 -0
  284. package/.versions/2.0.20/.pi/harnesses/agent-hub/artifacts.js +146 -0
  285. package/.versions/2.0.20/.pi/harnesses/agent-hub/assertion-ledger.js +67 -0
  286. package/.versions/2.0.20/.pi/harnesses/agent-hub/assist-profile.ts +19 -0
  287. package/.versions/2.0.20/.pi/harnesses/agent-hub/backend-policy.js +174 -0
  288. package/.versions/2.0.20/.pi/harnesses/agent-hub/bounded-output.ts +26 -0
  289. package/.versions/2.0.20/.pi/harnesses/agent-hub/budget-recovery.ts +123 -0
  290. package/.versions/2.0.20/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
  291. package/.versions/2.0.20/.pi/harnesses/agent-hub/capability-packs.ts +184 -0
  292. package/.versions/2.0.20/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
  293. package/.versions/2.0.20/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
  294. package/.versions/2.0.20/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
  295. package/.versions/2.0.20/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
  296. package/.versions/2.0.20/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
  297. package/.versions/2.0.20/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
  298. package/.versions/2.0.20/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
  299. package/.versions/2.0.20/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
  300. package/.versions/2.0.20/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
  301. package/.versions/2.0.20/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
  302. package/.versions/2.0.20/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
  303. package/.versions/2.0.20/.pi/harnesses/agent-hub/commands/audit.ts +9 -0
  304. package/.versions/2.0.20/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
  305. package/.versions/2.0.20/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
  306. package/.versions/2.0.20/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
  307. package/.versions/2.0.20/.pi/harnesses/agent-hub/commands/context.ts +46 -0
  308. package/.versions/2.0.20/.pi/harnesses/agent-hub/commands/debate.ts +9 -0
  309. package/.versions/2.0.20/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
  310. package/.versions/2.0.20/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
  311. package/.versions/2.0.20/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
  312. package/.versions/2.0.20/.pi/harnesses/agent-hub/commands/models.ts +10 -0
  313. package/.versions/2.0.20/.pi/harnesses/agent-hub/commands/poll.ts +9 -0
  314. package/.versions/2.0.20/.pi/harnesses/agent-hub/commands/recover.ts +61 -0
  315. package/.versions/2.0.20/.pi/harnesses/agent-hub/commands/retry.ts +10 -0
  316. package/.versions/2.0.20/.pi/harnesses/agent-hub/commands/task-triage-recover.ts +12 -0
  317. package/.versions/2.0.20/.pi/harnesses/agent-hub/commands/task-triage-waive.ts +12 -0
  318. package/.versions/2.0.20/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
  319. package/.versions/2.0.20/.pi/harnesses/agent-hub/commands/work-mode.ts +29 -0
  320. package/.versions/2.0.20/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
  321. package/.versions/2.0.20/.pi/harnesses/agent-hub/config/agents.ts +178 -0
  322. package/.versions/2.0.20/.pi/harnesses/agent-hub/config/model-profiles.ts +237 -0
  323. package/.versions/2.0.20/.pi/harnesses/agent-hub/config/overrides.ts +165 -0
  324. package/.versions/2.0.20/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
  325. package/.versions/2.0.20/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +221 -0
  326. package/.versions/2.0.20/.pi/harnesses/agent-hub/context/budgets.ts +152 -0
  327. package/.versions/2.0.20/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
  328. package/.versions/2.0.20/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
  329. package/.versions/2.0.20/.pi/harnesses/agent-hub/context-compaction-monitor.ts +35 -0
  330. package/.versions/2.0.20/.pi/harnesses/agent-hub/context-compaction-preflight.ts +21 -0
  331. package/.versions/2.0.20/.pi/harnesses/agent-hub/context-compaction-runtime.ts +69 -0
  332. package/.versions/2.0.20/.pi/harnesses/agent-hub/context-compaction.ts +34 -0
  333. package/.versions/2.0.20/.pi/harnesses/agent-hub/context-continuity-broker.ts +42 -0
  334. package/.versions/2.0.20/.pi/harnesses/agent-hub/context-continuity-child.ts +83 -0
  335. package/.versions/2.0.20/.pi/harnesses/agent-hub/context-continuity-client.ts +19 -0
  336. package/.versions/2.0.20/.pi/harnesses/agent-hub/context-continuity-compat.ts +30 -0
  337. package/.versions/2.0.20/.pi/harnesses/agent-hub/context-continuity-owners.ts +15 -0
  338. package/.versions/2.0.20/.pi/harnesses/agent-hub/context-continuity-registry.ts +8 -0
  339. package/.versions/2.0.20/.pi/harnesses/agent-hub/context-continuity.ts +82 -0
  340. package/.versions/2.0.20/.pi/harnesses/agent-hub/context-pressure.ts +222 -0
  341. package/.versions/2.0.20/.pi/harnesses/agent-hub/context-window.js +108 -0
  342. package/.versions/2.0.20/.pi/harnesses/agent-hub/damage-guard-approval.ts +59 -0
  343. package/.versions/2.0.20/.pi/harnesses/agent-hub/damage-guard-broker.ts +125 -0
  344. package/.versions/2.0.20/.pi/harnesses/agent-hub/damage-guard-contract.ts +22 -0
  345. package/.versions/2.0.20/.pi/harnesses/agent-hub/damage-guard-descendant.ts +76 -0
  346. package/.versions/2.0.20/.pi/harnesses/agent-hub/damage-guard-hub.ts +249 -0
  347. package/.versions/2.0.20/.pi/harnesses/agent-hub/damage-guard-identity.ts +12 -0
  348. package/.versions/2.0.20/.pi/harnesses/agent-hub/damage-guard-owners.ts +54 -0
  349. package/.versions/2.0.20/.pi/harnesses/agent-hub/damage-guard-state.ts +43 -0
  350. package/.versions/2.0.20/.pi/harnesses/agent-hub/damage-guard-test-tsconfig.json +19 -0
  351. package/.versions/2.0.20/.pi/harnesses/agent-hub/debate-command.ts +176 -0
  352. package/.versions/2.0.20/.pi/harnesses/agent-hub/delegate.ts +478 -0
  353. package/.versions/2.0.20/.pi/harnesses/agent-hub/deterministic-fs.ts +195 -0
  354. package/.versions/2.0.20/.pi/harnesses/agent-hub/diagnostic-probe-extension.ts +26 -0
  355. package/.versions/2.0.20/.pi/harnesses/agent-hub/diagnostic-series-budget.ts +178 -0
  356. package/.versions/2.0.20/.pi/harnesses/agent-hub/dispatch-coms.ts +253 -0
  357. package/.versions/2.0.20/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
  358. package/.versions/2.0.20/.pi/harnesses/agent-hub/dispatch-native-complete.ts +173 -0
  359. package/.versions/2.0.20/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +295 -0
  360. package/.versions/2.0.20/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +253 -0
  361. package/.versions/2.0.20/.pi/harnesses/agent-hub/dispatch-native-types.ts +293 -0
  362. package/.versions/2.0.20/.pi/harnesses/agent-hub/dispatch-native.ts +236 -0
  363. package/.versions/2.0.20/.pi/harnesses/agent-hub/dispatch-observability.ts +225 -0
  364. package/.versions/2.0.20/.pi/harnesses/agent-hub/dispatch-triage-contract.ts +27 -0
  365. package/.versions/2.0.20/.pi/harnesses/agent-hub/dispatch-triage-eval.ts +77 -0
  366. package/.versions/2.0.20/.pi/harnesses/agent-hub/dispatch-triage-policy.ts +29 -0
  367. package/.versions/2.0.20/.pi/harnesses/agent-hub/dispatch-triage-runtime.ts +55 -0
  368. package/.versions/2.0.20/.pi/harnesses/agent-hub/dispatch-triage-state.ts +33 -0
  369. package/.versions/2.0.20/.pi/harnesses/agent-hub/docs-lane.js +123 -0
  370. package/.versions/2.0.20/.pi/harnesses/agent-hub/drift-judge.ts +352 -0
  371. package/.versions/2.0.20/.pi/harnesses/agent-hub/drift-runtime.ts +480 -0
  372. package/.versions/2.0.20/.pi/harnesses/agent-hub/drift-system1-policy.ts +39 -0
  373. package/.versions/2.0.20/.pi/harnesses/agent-hub/drift-system1.ts +469 -0
  374. package/.versions/2.0.20/.pi/harnesses/agent-hub/drift-watchdog.js +349 -0
  375. package/.versions/2.0.20/.pi/harnesses/agent-hub/evidence-manifest.ts +51 -0
  376. package/.versions/2.0.20/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  377. package/.versions/2.0.20/.pi/harnesses/agent-hub/execution-evidence.ts +80 -0
  378. package/.versions/2.0.20/.pi/harnesses/agent-hub/execution-trace.ts +241 -0
  379. package/.versions/2.0.20/.pi/harnesses/agent-hub/external-blocker.js +85 -0
  380. package/.versions/2.0.20/.pi/harnesses/agent-hub/file-discovery/adapters.ts +88 -0
  381. package/.versions/2.0.20/.pi/harnesses/agent-hub/file-discovery/broker-client.ts +62 -0
  382. package/.versions/2.0.20/.pi/harnesses/agent-hub/file-discovery/broker.ts +128 -0
  383. package/.versions/2.0.20/.pi/harnesses/agent-hub/file-discovery/child-extension.ts +42 -0
  384. package/.versions/2.0.20/.pi/harnesses/agent-hub/file-discovery/descendant.ts +67 -0
  385. package/.versions/2.0.20/.pi/harnesses/agent-hub/file-discovery/discovery-worker.mjs +15 -0
  386. package/.versions/2.0.20/.pi/harnesses/agent-hub/file-discovery/discovery.ts +126 -0
  387. package/.versions/2.0.20/.pi/harnesses/agent-hub/file-discovery/evaluate.ts +57 -0
  388. package/.versions/2.0.20/.pi/harnesses/agent-hub/file-discovery/hub.ts +169 -0
  389. package/.versions/2.0.20/.pi/harnesses/agent-hub/file-discovery/native-context.ts +8 -0
  390. package/.versions/2.0.20/.pi/harnesses/agent-hub/file-discovery/native-fixture.test-support.ts +108 -0
  391. package/.versions/2.0.20/.pi/harnesses/agent-hub/file-discovery/owners.ts +96 -0
  392. package/.versions/2.0.20/.pi/harnesses/agent-hub/file-discovery/results.ts +55 -0
  393. package/.versions/2.0.20/.pi/harnesses/agent-hub/file-discovery/runtime.ts +130 -0
  394. package/.versions/2.0.20/.pi/harnesses/agent-hub/file-discovery/semantic-profiles.ts +18 -0
  395. package/.versions/2.0.20/.pi/harnesses/agent-hub/file-discovery/sources.ts +69 -0
  396. package/.versions/2.0.20/.pi/harnesses/agent-hub/file-discovery/state.ts +22 -0
  397. package/.versions/2.0.20/.pi/harnesses/agent-hub/filesystem-tool.ts +166 -0
  398. package/.versions/2.0.20/.pi/harnesses/agent-hub/fixtures/registration-surface.json +66 -0
  399. package/.versions/2.0.20/.pi/harnesses/agent-hub/fixtures/t0a-synthetic/catalog.ts +189 -0
  400. package/.versions/2.0.20/.pi/harnesses/agent-hub/footer.ts +30 -0
  401. package/.versions/2.0.20/.pi/harnesses/agent-hub/helpers.ts +270 -0
  402. package/.versions/2.0.20/.pi/harnesses/agent-hub/history-projection.ts +116 -0
  403. package/.versions/2.0.20/.pi/harnesses/agent-hub/hub-state-audit.js +41 -0
  404. package/.versions/2.0.20/.pi/harnesses/agent-hub/index.ts +2614 -0
  405. package/.versions/2.0.20/.pi/harnesses/agent-hub/input/completions.ts +82 -0
  406. package/.versions/2.0.20/.pi/harnesses/agent-hub/input/shortcuts.ts +20 -0
  407. package/.versions/2.0.20/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +231 -0
  408. package/.versions/2.0.20/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
  409. package/.versions/2.0.20/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +144 -0
  410. package/.versions/2.0.20/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +74 -0
  411. package/.versions/2.0.20/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  412. package/.versions/2.0.20/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  413. package/.versions/2.0.20/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  414. package/.versions/2.0.20/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  415. package/.versions/2.0.20/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  416. package/.versions/2.0.20/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  417. package/.versions/2.0.20/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  418. package/.versions/2.0.20/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
  419. package/.versions/2.0.20/.pi/harnesses/agent-hub/no-progress.ts +620 -0
  420. package/.versions/2.0.20/.pi/harnesses/agent-hub/operator-watchdog.ts +97 -0
  421. package/.versions/2.0.20/.pi/harnesses/agent-hub/orchestration-activation.ts +109 -0
  422. package/.versions/2.0.20/.pi/harnesses/agent-hub/orchestration-metrics.ts +78 -0
  423. package/.versions/2.0.20/.pi/harnesses/agent-hub/orchestration-route.ts +68 -0
  424. package/.versions/2.0.20/.pi/harnesses/agent-hub/package.json +7 -0
  425. package/.versions/2.0.20/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
  426. package/.versions/2.0.20/.pi/harnesses/agent-hub/policy/models.ts +153 -0
  427. package/.versions/2.0.20/.pi/harnesses/agent-hub/policy/profile-activation.ts +62 -0
  428. package/.versions/2.0.20/.pi/harnesses/agent-hub/policy/profile-runtime.ts +120 -0
  429. package/.versions/2.0.20/.pi/harnesses/agent-hub/policy/roster.ts +94 -0
  430. package/.versions/2.0.20/.pi/harnesses/agent-hub/policy/work-mode.ts +142 -0
  431. package/.versions/2.0.20/.pi/harnesses/agent-hub/poll-command.ts +176 -0
  432. package/.versions/2.0.20/.pi/harnesses/agent-hub/presentation.ts +48 -0
  433. package/.versions/2.0.20/.pi/harnesses/agent-hub/proactive-config.ts +21 -0
  434. package/.versions/2.0.20/.pi/harnesses/agent-hub/proactive-evaluate.ts +138 -0
  435. package/.versions/2.0.20/.pi/harnesses/agent-hub/proactive-external-git.ts +82 -0
  436. package/.versions/2.0.20/.pi/harnesses/agent-hub/proactive-external.ts +142 -0
  437. package/.versions/2.0.20/.pi/harnesses/agent-hub/proactive-feedback.ts +104 -0
  438. package/.versions/2.0.20/.pi/harnesses/agent-hub/proactive-findings.ts +115 -0
  439. package/.versions/2.0.20/.pi/harnesses/agent-hub/proactive-local.ts +89 -0
  440. package/.versions/2.0.20/.pi/harnesses/agent-hub/proactive-observer.ts +106 -0
  441. package/.versions/2.0.20/.pi/harnesses/agent-hub/proactive-rules.ts +171 -0
  442. package/.versions/2.0.20/.pi/harnesses/agent-hub/proactive-runtime.ts +318 -0
  443. package/.versions/2.0.20/.pi/harnesses/agent-hub/proactive-selection.ts +68 -0
  444. package/.versions/2.0.20/.pi/harnesses/agent-hub/proactive-snapshot-worker.mjs +12 -0
  445. package/.versions/2.0.20/.pi/harnesses/agent-hub/proactive-snapshot.ts +271 -0
  446. package/.versions/2.0.20/.pi/harnesses/agent-hub/proactive-types.ts +67 -0
  447. package/.versions/2.0.20/.pi/harnesses/agent-hub/process-obligations.ts +159 -0
  448. package/.versions/2.0.20/.pi/harnesses/agent-hub/prompts/context.ts +55 -0
  449. package/.versions/2.0.20/.pi/harnesses/agent-hub/prompts/fragments.ts +86 -0
  450. package/.versions/2.0.20/.pi/harnesses/agent-hub/prompts/session-start.ts +90 -0
  451. package/.versions/2.0.20/.pi/harnesses/agent-hub/prompts/system-prompt.ts +125 -0
  452. package/.versions/2.0.20/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  453. package/.versions/2.0.20/.pi/harnesses/agent-hub/reconcile.ts +26 -0
  454. package/.versions/2.0.20/.pi/harnesses/agent-hub/recover-policy.ts +44 -0
  455. package/.versions/2.0.20/.pi/harnesses/agent-hub/recover-state.ts +104 -0
  456. package/.versions/2.0.20/.pi/harnesses/agent-hub/recovery-contract.ts +151 -0
  457. package/.versions/2.0.20/.pi/harnesses/agent-hub/rerun-policy.ts +40 -0
  458. package/.versions/2.0.20/.pi/harnesses/agent-hub/research/controls.ts +74 -0
  459. package/.versions/2.0.20/.pi/harnesses/agent-hub/research/runtime.ts +215 -0
  460. package/.versions/2.0.20/.pi/harnesses/agent-hub/research/spawn-run.ts +221 -0
  461. package/.versions/2.0.20/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  462. package/.versions/2.0.20/.pi/harnesses/agent-hub/return-contract.js +349 -0
  463. package/.versions/2.0.20/.pi/harnesses/agent-hub/return-extract.js +77 -0
  464. package/.versions/2.0.20/.pi/harnesses/agent-hub/review-closure.ts +43 -0
  465. package/.versions/2.0.20/.pi/harnesses/agent-hub/review-continuity.ts +73 -0
  466. package/.versions/2.0.20/.pi/harnesses/agent-hub/review-findings.js +96 -0
  467. package/.versions/2.0.20/.pi/harnesses/agent-hub/review-reuse.ts +47 -0
  468. package/.versions/2.0.20/.pi/harnesses/agent-hub/routing-observation.ts +41 -0
  469. package/.versions/2.0.20/.pi/harnesses/agent-hub/routing-proposal.ts +46 -0
  470. package/.versions/2.0.20/.pi/harnesses/agent-hub/run-budget.js +342 -0
  471. package/.versions/2.0.20/.pi/harnesses/agent-hub/run-namespace.js +93 -0
  472. package/.versions/2.0.20/.pi/harnesses/agent-hub/runtime-test-check.ts +54 -0
  473. package/.versions/2.0.20/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  474. package/.versions/2.0.20/.pi/harnesses/agent-hub/scope-gate.js +228 -0
  475. package/.versions/2.0.20/.pi/harnesses/agent-hub/session-audit.ts +331 -0
  476. package/.versions/2.0.20/.pi/harnesses/agent-hub/session-health.js +110 -0
  477. package/.versions/2.0.20/.pi/harnesses/agent-hub/session-start.ts +42 -0
  478. package/.versions/2.0.20/.pi/harnesses/agent-hub/spawn.ts +639 -0
  479. package/.versions/2.0.20/.pi/harnesses/agent-hub/specialist-result-receipt.ts +13 -0
  480. package/.versions/2.0.20/.pi/harnesses/agent-hub/specialist-result.ts +69 -0
  481. package/.versions/2.0.20/.pi/harnesses/agent-hub/system1-activity.ts +625 -0
  482. package/.versions/2.0.20/.pi/harnesses/agent-hub/system1-communication-store.ts +217 -0
  483. package/.versions/2.0.20/.pi/harnesses/agent-hub/system1-report.ts +275 -0
  484. package/.versions/2.0.20/.pi/harnesses/agent-hub/system1-runtime.ts +265 -0
  485. package/.versions/2.0.20/.pi/harnesses/agent-hub/task-continuation.ts +4 -0
  486. package/.versions/2.0.20/.pi/harnesses/agent-hub/task-resume-contract.ts +70 -0
  487. package/.versions/2.0.20/.pi/harnesses/agent-hub/task-triage-authorization.ts +151 -0
  488. package/.versions/2.0.20/.pi/harnesses/agent-hub/task-triage-config.ts +20 -0
  489. package/.versions/2.0.20/.pi/harnesses/agent-hub/task-triage-contract.ts +14 -0
  490. package/.versions/2.0.20/.pi/harnesses/agent-hub/task-triage-live-stage-boundary.mjs +49 -0
  491. package/.versions/2.0.20/.pi/harnesses/agent-hub/task-triage-obligations.ts +120 -0
  492. package/.versions/2.0.20/.pi/harnesses/agent-hub/task-triage-policy.ts +16 -0
  493. package/.versions/2.0.20/.pi/harnesses/agent-hub/task-triage-review-contract.mjs +43 -0
  494. package/.versions/2.0.20/.pi/harnesses/agent-hub/task-triage-reviewer-only-contract.mjs +156 -0
  495. package/.versions/2.0.20/.pi/harnesses/agent-hub/task-triage-reviewer-only-diagnostics.mjs +112 -0
  496. package/.versions/2.0.20/.pi/harnesses/agent-hub/task-triage-runtime.ts +130 -0
  497. package/.versions/2.0.20/.pi/harnesses/agent-hub/task-triage-stage-guard.ts +21 -0
  498. package/.versions/2.0.20/.pi/harnesses/agent-hub/task-triage-state.ts +46 -0
  499. package/.versions/2.0.20/.pi/harnesses/agent-hub/timeline.ts +72 -0
  500. package/.versions/2.0.20/.pi/harnesses/agent-hub/tool-catalog-runtime.ts +79 -0
  501. package/.versions/2.0.20/.pi/harnesses/agent-hub/tool-catalog-state.ts +123 -0
  502. package/.versions/2.0.20/.pi/harnesses/agent-hub/tool-protocol.ts +134 -0
  503. package/.versions/2.0.20/.pi/harnesses/agent-hub/tools/action-executors.ts +214 -0
  504. package/.versions/2.0.20/.pi/harnesses/agent-hub/tools/ask-system1-files.ts +15 -0
  505. package/.versions/2.0.20/.pi/harnesses/agent-hub/tools/ask-system1.ts +25 -0
  506. package/.versions/2.0.20/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
  507. package/.versions/2.0.20/.pi/harnesses/agent-hub/tools/context.ts +144 -0
  508. package/.versions/2.0.20/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +88 -0
  509. package/.versions/2.0.20/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +640 -0
  510. package/.versions/2.0.20/.pi/harnesses/agent-hub/tools/dispatch-triage.ts +16 -0
  511. package/.versions/2.0.20/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +22 -0
  512. package/.versions/2.0.20/.pi/harnesses/agent-hub/tools/fleet-tools.ts +200 -0
  513. package/.versions/2.0.20/.pi/harnesses/agent-hub/tools/herdr-executors.ts +95 -0
  514. package/.versions/2.0.20/.pi/harnesses/agent-hub/tools/run-flow.ts +136 -0
  515. package/.versions/2.0.20/.pi/harnesses/agent-hub/tools/set-task-tier.ts +31 -0
  516. package/.versions/2.0.20/.pi/harnesses/agent-hub/tools/spawn-research.ts +67 -0
  517. package/.versions/2.0.20/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
  518. package/.versions/2.0.20/.pi/harnesses/agent-hub/tools/verification-contract.ts +80 -0
  519. package/.versions/2.0.20/.pi/harnesses/agent-hub/tsconfig.json +22 -0
  520. package/.versions/2.0.20/.pi/harnesses/agent-hub/types.ts +66 -0
  521. package/.versions/2.0.20/.pi/harnesses/agent-hub/ui/activity-dots.ts +25 -0
  522. package/.versions/2.0.20/.pi/harnesses/agent-hub/ui/context-budget.ts +89 -0
  523. package/.versions/2.0.20/.pi/harnesses/agent-hub/ui/detail-panel.ts +192 -0
  524. package/.versions/2.0.20/.pi/harnesses/agent-hub/ui/fleet-actions.ts +78 -0
  525. package/.versions/2.0.20/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +155 -0
  526. package/.versions/2.0.20/.pi/harnesses/agent-hub/ui/fleet-editor.ts +44 -0
  527. package/.versions/2.0.20/.pi/harnesses/agent-hub/ui/fleet-source.ts +179 -0
  528. package/.versions/2.0.20/.pi/harnesses/agent-hub/ui/grid.ts +159 -0
  529. package/.versions/2.0.20/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
  530. package/.versions/2.0.20/.pi/harnesses/agent-hub/ui/history.ts +234 -0
  531. package/.versions/2.0.20/.pi/harnesses/agent-hub/ui/pool.ts +103 -0
  532. package/.versions/2.0.20/.pi/harnesses/agent-hub/ui/running-strip.ts +2 -0
  533. package/.versions/2.0.20/.pi/harnesses/agent-hub/ui/system1-communication.ts +59 -0
  534. package/.versions/2.0.20/.pi/harnesses/agent-hub/ui/zoom.ts +206 -0
  535. package/.versions/2.0.20/.pi/harnesses/agent-hub/unknown-tool-counter.ts +116 -0
  536. package/.versions/2.0.20/.pi/harnesses/agent-hub/version.ts +42 -0
  537. package/.versions/2.0.20/.pi/harnesses/agent-hub/watchdog-evaluation.ts +110 -0
  538. package/.versions/2.0.20/.pi/harnesses/agent-hub/work-mode-controls.ts +56 -0
  539. package/.versions/2.0.20/.pi/harnesses/agent-hub/work-mode.ts +186 -0
  540. package/.versions/2.0.20/.pi/harnesses/agent-hub/write-isolation.ts +187 -0
  541. package/.versions/2.0.20/.pi/harnesses/ask-user-remote/README.md +59 -0
  542. package/.versions/2.0.20/.pi/harnesses/ask-user-remote/index.ts +569 -0
  543. package/.versions/2.0.20/.pi/harnesses/ask-user-remote/questions.ts +159 -0
  544. package/.versions/2.0.20/.pi/harnesses/ask-user-remote/race-core.js +124 -0
  545. package/.versions/2.0.20/.pi/harnesses/ask-user-remote/runtime-ask.ts +83 -0
  546. package/.versions/2.0.20/.pi/harnesses/coms/README.md +100 -0
  547. package/.versions/2.0.20/.pi/harnesses/coms/index.ts +282 -0
  548. package/.versions/2.0.20/.pi/harnesses/coms/package.json +7 -0
  549. package/.versions/2.0.20/.pi/harnesses/coms/version.ts +42 -0
  550. package/.versions/2.0.20/.pi/harnesses/damage-control-continue/README.md +161 -0
  551. package/.versions/2.0.20/.pi/harnesses/damage-control-continue/index.ts +600 -0
  552. package/.versions/2.0.20/.pi/harnesses/damage-control-continue/package.json +7 -0
  553. package/.versions/2.0.20/.pi/harnesses/damage-control-continue/result-screen.ts +98 -0
  554. package/.versions/2.0.20/.pi/harnesses/damage-control-continue/system1-child.ts +35 -0
  555. package/.versions/2.0.20/.pi/harnesses/damage-control-continue/system1-client.ts +85 -0
  556. package/.versions/2.0.20/.pi/harnesses/damage-control-continue/system1-guard.ts +65 -0
  557. package/.versions/2.0.20/.pi/harnesses/damage-control-continue/version.ts +42 -0
  558. package/.versions/2.0.20/.pi/harnesses/lib/approval-wait.ts +17 -0
  559. package/.versions/2.0.20/.pi/harnesses/lib/bash-policy-analysis.ts +155 -0
  560. package/.versions/2.0.20/.pi/harnesses/lib/changed-file-diagnostics.ts +642 -0
  561. package/.versions/2.0.20/.pi/harnesses/lib/clarification-policy.ts +9 -0
  562. package/.versions/2.0.20/.pi/harnesses/lib/coms-core-io.ts +386 -0
  563. package/.versions/2.0.20/.pi/harnesses/lib/coms-core.ts +578 -0
  564. package/.versions/2.0.20/.pi/harnesses/lib/coms-registry-entry.ts +96 -0
  565. package/.versions/2.0.20/.pi/harnesses/lib/context-budget-child-prompt.ts +214 -0
  566. package/.versions/2.0.20/.pi/harnesses/lib/context-budget-hub-prompt.ts +121 -0
  567. package/.versions/2.0.20/.pi/harnesses/lib/context-budget-view.ts +112 -0
  568. package/.versions/2.0.20/.pi/harnesses/lib/context-budget.ts +114 -0
  569. package/.versions/2.0.20/.pi/harnesses/lib/context-compaction-policy.js +35 -0
  570. package/.versions/2.0.20/.pi/harnesses/lib/damage-action-hash.ts +28 -0
  571. package/.versions/2.0.20/.pi/harnesses/lib/damage-control-shared.ts +229 -0
  572. package/.versions/2.0.20/.pi/harnesses/lib/damage-guard-port.ts +25 -0
  573. package/.versions/2.0.20/.pi/harnesses/lib/damage-result-evidence.ts +25 -0
  574. package/.versions/2.0.20/.pi/harnesses/lib/damage-result-view.ts +16 -0
  575. package/.versions/2.0.20/.pi/harnesses/lib/deterministic-handle-path.ts +25 -0
  576. package/.versions/2.0.20/.pi/harnesses/lib/execution-trace.ts +45 -0
  577. package/.versions/2.0.20/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
  578. package/.versions/2.0.20/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
  579. package/.versions/2.0.20/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
  580. package/.versions/2.0.20/.pi/harnesses/lib/fleet-dashboard-ops.ts +178 -0
  581. package/.versions/2.0.20/.pi/harnesses/lib/fleet-dashboard-view.ts +172 -0
  582. package/.versions/2.0.20/.pi/harnesses/lib/fleet-detail-view.ts +339 -0
  583. package/.versions/2.0.20/.pi/harnesses/lib/fleet-overlay.ts +26 -0
  584. package/.versions/2.0.20/.pi/harnesses/lib/fleet-panel.ts +34 -0
  585. package/.versions/2.0.20/.pi/harnesses/lib/fleet-read-model.ts +609 -0
  586. package/.versions/2.0.20/.pi/harnesses/lib/fleet-selection.ts +24 -0
  587. package/.versions/2.0.20/.pi/harnesses/lib/fleet-strip-controller.ts +75 -0
  588. package/.versions/2.0.20/.pi/harnesses/lib/fleet-strip-view.ts +179 -0
  589. package/.versions/2.0.20/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
  590. package/.versions/2.0.20/.pi/harnesses/lib/herdr-client.ts +472 -0
  591. package/.versions/2.0.20/.pi/harnesses/lib/herdr-presence.ts +399 -0
  592. package/.versions/2.0.20/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  593. package/.versions/2.0.20/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  594. package/.versions/2.0.20/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  595. package/.versions/2.0.20/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  596. package/.versions/2.0.20/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  597. package/.versions/2.0.20/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  598. package/.versions/2.0.20/.pi/harnesses/lib/identical-dialog.ts +27 -0
  599. package/.versions/2.0.20/.pi/harnesses/lib/installation-state.js +62 -0
  600. package/.versions/2.0.20/.pi/harnesses/lib/policy-roots.js +106 -0
  601. package/.versions/2.0.20/.pi/harnesses/lib/policy-roots.ts +31 -0
  602. package/.versions/2.0.20/.pi/harnesses/lib/process-shared.ts +9 -0
  603. package/.versions/2.0.20/.pi/harnesses/lib/safe-source-read.js +29 -0
  604. package/.versions/2.0.20/.pi/harnesses/lib/semantic-approval.ts +80 -0
  605. package/.versions/2.0.20/.pi/harnesses/lib/spawned-peers.js +191 -0
  606. package/.versions/2.0.20/.pi/harnesses/lib/system1/config-agentic.js +15 -0
  607. package/.versions/2.0.20/.pi/harnesses/lib/system1/config-context-compaction.js +16 -0
  608. package/.versions/2.0.20/.pi/harnesses/lib/system1/config-damage-guard.js +24 -0
  609. package/.versions/2.0.20/.pi/harnesses/lib/system1/config-file-discovery.js +23 -0
  610. package/.versions/2.0.20/.pi/harnesses/lib/system1/config-json.js +37 -0
  611. package/.versions/2.0.20/.pi/harnesses/lib/system1/config-loader.js +44 -0
  612. package/.versions/2.0.20/.pi/harnesses/lib/system1/config-proactive.js +68 -0
  613. package/.versions/2.0.20/.pi/harnesses/lib/system1/config-triage.js +42 -0
  614. package/.versions/2.0.20/.pi/harnesses/lib/system1/config-v2.js +112 -0
  615. package/.versions/2.0.20/.pi/harnesses/lib/system1/config.js +50 -0
  616. package/.versions/2.0.20/.pi/harnesses/lib/system1/contracts.ts +154 -0
  617. package/.versions/2.0.20/.pi/harnesses/lib/system1/demo.ts +95 -0
  618. package/.versions/2.0.20/.pi/harnesses/lib/system1/jev.ts +503 -0
  619. package/.versions/2.0.20/.pi/harnesses/lib/system1/payload-screen.ts +65 -0
  620. package/.versions/2.0.20/.pi/harnesses/lib/system1/selection.js +11 -0
  621. package/.versions/2.0.20/.pi/harnesses/lib/system1/service.ts +245 -0
  622. package/.versions/2.0.20/.pi/harnesses/lib/update-check.ts +222 -0
  623. package/.versions/2.0.20/.pi/harnesses/package-lock.json +2121 -0
  624. package/.versions/2.0.20/.pi/harnesses/package.json +13 -0
  625. package/.versions/2.0.20/.pi/prompts/af-build.md +27 -0
  626. package/.versions/2.0.20/.pi/prompts/af-code-simplify.md +22 -0
  627. package/.versions/2.0.20/.pi/prompts/af-constraints.md +31 -0
  628. package/.versions/2.0.20/.pi/prompts/af-plan.md +17 -0
  629. package/.versions/2.0.20/.pi/prompts/af-review.md +16 -0
  630. package/.versions/2.0.20/.pi/prompts/af-set-hermes-telegram.md +15 -0
  631. package/.versions/2.0.20/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  632. package/.versions/2.0.20/.pi/prompts/af-setup-rules.md +20 -0
  633. package/.versions/2.0.20/.pi/prompts/af-ship.md +17 -0
  634. package/.versions/2.0.20/.pi/prompts/af-spec.md +15 -0
  635. package/.versions/2.0.20/.pi/prompts/af-test.md +19 -0
  636. package/.versions/2.0.20/.pi/skills/bowser/SKILL.md +145 -0
  637. package/.versions/2.0.20/.version +1 -0
  638. package/.versions/2.0.20/agents/architect.md +24 -0
  639. package/.versions/2.0.20/agents/bowser.md +28 -0
  640. package/.versions/2.0.20/agents/builder.md +55 -0
  641. package/.versions/2.0.20/agents/code-reviewer.md +209 -0
  642. package/.versions/2.0.20/agents/deep-researcher.md +32 -0
  643. package/.versions/2.0.20/agents/documenter.md +22 -0
  644. package/.versions/2.0.20/agents/orchestrator.md +22 -0
  645. package/.versions/2.0.20/agents/plan-reviewer.md +83 -0
  646. package/.versions/2.0.20/agents/planner.md +107 -0
  647. package/.versions/2.0.20/agents/releaser.md +24 -0
  648. package/.versions/2.0.20/agents/researcher.md +30 -0
  649. package/.versions/2.0.20/agents/security-auditor.md +167 -0
  650. package/.versions/2.0.20/agents/test-engineer.md +153 -0
  651. package/.versions/2.0.20/agents/web-debugger.md +44 -0
  652. package/.versions/2.0.20/agents/web-performance-auditor.md +194 -0
  653. package/.versions/2.0.20/bin/catalog/harness-runtime-closure.json +73 -0
  654. package/.versions/2.0.20/codex/fleet-session-client/SKILL.md +34 -0
  655. package/.versions/2.0.20/codex/fleet-session-client.zip +0 -0
  656. package/.versions/2.0.20/docs/ARCHITECTURE.md +977 -0
  657. package/.versions/2.0.20/docs/agent-fleet-setup.md +1103 -0
  658. package/.versions/2.0.20/docs/claude-code-coms-bridge.md +147 -0
  659. package/.versions/2.0.20/docs/codex-session-bridge.md +219 -0
  660. package/.versions/2.0.20/docs/coms-hermes-bridge.md +188 -0
  661. package/.versions/2.0.20/docs/getting-started.md +126 -0
  662. package/.versions/2.0.20/docs/npm-install.md +535 -0
  663. package/.versions/2.0.20/docs/pi-extensions.md +455 -0
  664. package/.versions/2.0.20/docs/pi-setup.md +92 -0
  665. package/.versions/2.0.20/docs/skill-anatomy.md +150 -0
  666. package/.versions/2.0.20/install-manifest.json +3210 -0
  667. package/.versions/2.0.20/justfile +247 -0
  668. package/.versions/2.0.20/manifest-meta.json +1088 -0
  669. package/.versions/2.0.20/references/accessibility-checklist.md +160 -0
  670. package/.versions/2.0.20/references/communication-contract.md +26 -0
  671. package/.versions/2.0.20/references/definition-of-done.md +67 -0
  672. package/.versions/2.0.20/references/fleet-coordination-patterns.md +171 -0
  673. package/.versions/2.0.20/references/observability-checklist.md +92 -0
  674. package/.versions/2.0.20/references/orchestration-patterns.md +370 -0
  675. package/.versions/2.0.20/references/performance-checklist.md +236 -0
  676. package/.versions/2.0.20/references/prompting-patterns.md +380 -0
  677. package/.versions/2.0.20/references/security-checklist.md +245 -0
  678. package/.versions/2.0.20/references/testing-patterns.md +235 -0
  679. package/.versions/2.0.20/references/workflow-authoring.md +304 -0
  680. package/.versions/2.0.20/skills/_internal/grilling.md +59 -0
  681. package/.versions/2.0.20/skills/browser-testing-with-devtools/SKILL.md +351 -0
  682. package/.versions/2.0.20/skills/code-review-and-quality/SKILL.md +396 -0
  683. package/.versions/2.0.20/skills/compound-learning/SKILL.md +137 -0
  684. package/.versions/2.0.20/skills/constraint-driven-development/SKILL.md +338 -0
  685. package/.versions/2.0.20/skills/constraint-driven-development/references/floor-guard.md +99 -0
  686. package/.versions/2.0.20/skills/context-engineering/SKILL.md +341 -0
  687. package/.versions/2.0.20/skills/deprecation-and-migration/SKILL.md +247 -0
  688. package/.versions/2.0.20/skills/designing-agents/SKILL.md +394 -0
  689. package/.versions/2.0.20/skills/designing-agents/pi-harness-authoring.md +222 -0
  690. package/.versions/2.0.20/skills/drafting-workflows/SKILL.md +143 -0
  691. package/.versions/2.0.20/skills/drafting-workflows/scripts/make-workflow.ts +177 -0
  692. package/.versions/2.0.20/skills/frontend-ui-engineering/SKILL.md +328 -0
  693. package/.versions/2.0.20/skills/git-workflow-and-versioning/SKILL.md +316 -0
  694. package/.versions/2.0.20/skills/idea-refine/SKILL.md +182 -0
  695. package/.versions/2.0.20/skills/idea-refine/examples.md +238 -0
  696. package/.versions/2.0.20/skills/idea-refine/frameworks.md +99 -0
  697. package/.versions/2.0.20/skills/idea-refine/refinement-criteria.md +113 -0
  698. package/.versions/2.0.20/skills/idea-refine/scripts/idea-refine.sh +15 -0
  699. package/.versions/2.0.20/skills/incremental-implementation/SKILL.md +353 -0
  700. package/.versions/2.0.20/skills/incremental-implementation.zip +0 -0
  701. package/.versions/2.0.20/skills/interview-me/SKILL.md +226 -0
  702. package/.versions/2.0.20/skills/orchestration-verification/SKILL.md +182 -0
  703. package/.versions/2.0.20/skills/peer-coms/SKILL.md +90 -0
  704. package/.versions/2.0.20/skills/performance-optimization/SKILL.md +496 -0
  705. package/.versions/2.0.20/skills/planning-and-task-breakdown/SKILL.md +318 -0
  706. package/.versions/2.0.20/skills/planning-and-task-breakdown.zip +0 -0
  707. package/.versions/2.0.20/skills/repository-ai-setup/SKILL.md +135 -0
  708. package/.versions/2.0.20/skills/repository-ai-setup/references/agent-fleet-ai-state.template.json +4 -0
  709. package/.versions/2.0.20/skills/repository-ai-setup/references/apply-contract.md +74 -0
  710. package/.versions/2.0.20/skills/repository-ai-setup/references/provenance-template.md +16 -0
  711. package/.versions/2.0.20/skills/repository-ai-setup/references/setup-flow.md +108 -0
  712. package/.versions/2.0.20/skills/repository-ai-setup/references/verify-setup.md +20 -0
  713. package/.versions/2.0.20/skills/repository-ai-setup.zip +0 -0
  714. package/.versions/2.0.20/skills/security-and-hardening/SKILL.md +524 -0
  715. package/.versions/2.0.20/skills/spec-driven-development/SKILL.md +295 -0
  716. package/.versions/2.0.20/skills/spec-driven-development.zip +0 -0
  717. package/.versions/2.0.20/skills/using-agent-skills/SKILL.md +198 -0
  718. package/.versions/2.0.20/vendor/agent-skills-upstream/LICENSE +21 -0
  719. package/.versions/2.0.20/vendor/agent-skills-upstream/README.md +430 -0
  720. package/.versions/2.0.20/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +367 -0
  721. package/.versions/2.0.20/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  722. package/.versions/2.0.20/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  723. package/.versions/2.0.20/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  724. package/.versions/2.0.20/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  725. package/.versions/2.0.20/vendor/agent-skills-upstream/skills/constraint-driven-development/SKILL.md +311 -0
  726. package/.versions/2.0.20/vendor/agent-skills-upstream/skills/constraint-driven-development/references/floor-guard.md +99 -0
  727. package/.versions/2.0.20/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +337 -0
  728. package/.versions/2.0.20/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  729. package/.versions/2.0.20/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  730. package/.versions/2.0.20/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +288 -0
  731. package/.versions/2.0.20/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  732. package/.versions/2.0.20/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  733. package/.versions/2.0.20/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  734. package/.versions/2.0.20/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  735. package/.versions/2.0.20/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  736. package/.versions/2.0.20/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  737. package/.versions/2.0.20/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  738. package/.versions/2.0.20/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  739. package/.versions/2.0.20/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  740. package/.versions/2.0.20/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  741. package/.versions/2.0.20/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +238 -0
  742. package/.versions/2.0.20/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +496 -0
  743. package/.versions/2.0.20/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +257 -0
  744. package/.versions/2.0.20/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +524 -0
  745. package/.versions/2.0.20/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +330 -0
  746. package/.versions/2.0.20/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +216 -0
  747. package/.versions/2.0.20/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +245 -0
  748. package/.versions/2.0.20/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +398 -0
  749. package/.versions/2.0.20/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +192 -0
  750. package/CHANGELOG.md +32 -0
  751. package/README.md +3 -2
  752. package/agents/builder.md +1 -1
  753. package/agents/planner.md +6 -4
  754. package/bin/cli.js +9 -2
  755. package/bin/lib/apply.js +4 -0
  756. package/bin/lib/desired.js +2 -0
  757. package/bin/lib/doctor.js +13 -7
  758. package/bin/lib/state.js +7 -4
  759. package/bin/lib/transaction.js +6 -1
  760. package/bin/lib/validate-overrides.js +7 -3
  761. package/bin/lib/verify.js +9 -2
  762. package/docs/ARCHITECTURE.md +177 -74
  763. package/docs/agent-fleet-setup.md +10 -8
  764. package/docs/external-project-ai-content.md +17 -2
  765. package/docs/pi-extensions.md +7 -6
  766. package/docs/system1-agentic.md +4 -4
  767. package/docs/system1-config.md +144 -1
  768. package/docs/system1-context-continuity.md +224 -0
  769. package/docs/system1-damage-guard.md +172 -0
  770. package/docs/system1-dispatch-triage.md +169 -0
  771. package/docs/system1-file-discovery.md +16 -4
  772. package/docs/system1.example.json +102 -0
  773. package/install-manifest.json +17 -4
  774. package/manifest-meta.json +14 -1
  775. package/package.json +21 -9
  776. package/skills/_internal/grilling.md +54 -54
  777. package/skills/incremental-implementation/SKILL.md +8 -8
  778. package/skills/incremental-implementation.zip +0 -0
  779. package/skills/planning-and-task-breakdown/SKILL.md +7 -7
  780. package/skills/planning-and-task-breakdown.zip +0 -0
  781. package/skills/spec-driven-development/SKILL.md +1 -1
  782. package/skills/spec-driven-development.zip +0 -0
  783. package/.pi/harnesses/agent-hub/budget-continuation.ts +0 -13
  784. package/.pi/harnesses/agent-hub/commands/budget-continue.ts +0 -10
@@ -1,3 +1,4 @@
1
+ import { SPECIALIST_RESULT_INSTRUCTION } from "./specialist-result.ts";
1
2
  import {appendDiscoveryContext} from './file-discovery/native-context.ts';
2
3
  import { fileURLToPath } from "node:url";
3
4
  import { isCaptureEnabled } from "./proactive-config.ts";
@@ -27,6 +28,8 @@ export function sessionObserverAssignment(config: ProactiveConfig | null | undef
27
28
  export async function prepareNativeRun(base: NativeRunBase, _resumeRequested: boolean, requestedContract?: Omit<TaskResumeInput, "previous">): Promise<PreparedNativeRun | NativeDispatchResult> {
28
29
  const { deps, state, ctx, task, inputArtifacts, scopeGlobs, personaKey, agentKey, runNumber } = base;
29
30
  const admittedTools=state.def.tools;
31
+ const admittedCwd=ctx.cwd||process.cwd();
32
+ const payloadSnapshot=JSON.stringify([task,scopeGlobs,inputArtifacts]);
30
33
  const model = deps.resolvedModel(state.def)
31
34
  ?? (ctx.model ? `${ctx.model.provider}/${ctx.model.id}` : "openrouter/google/gemini-3-flash-preview");
32
35
  const fallbackCandidate = profileFallback(deps.substitutedModel(fallbackModelFor(state.def, model)));
@@ -43,6 +46,18 @@ export async function prepareNativeRun(base: NativeRunBase, _resumeRequested: bo
43
46
  permissions: requestedContract?.permissions ?? state.def.tools,
44
47
  previous: state.resumeContract,
45
48
  });
49
+ const contractOf=(value: typeof resumeContract)=>Object.freeze({
50
+ taskId:value.taskId,instructions:value.instructions,
51
+ scope:Object.freeze([...value.scope]),deliverables:Object.freeze([...value.deliverables]),
52
+ artifacts:Object.freeze([...value.artifacts]),permissions:Object.freeze([...value.permissions]),
53
+ });
54
+ const admittedContract=contractOf(resumeContract);
55
+ const contractSnapshot=JSON.stringify(admittedContract);
56
+ const currentContract=()=>contractOf(bindResume({
57
+ taskId:requestedContract?.taskId??task,instructions:requestedContract?.instructions??task,
58
+ scope:requestedContract?.scope??scopeGlobs,deliverables:requestedContract?.deliverables,
59
+ artifacts:requestedContract?.artifacts??inputArtifacts.map(a=>a.path),permissions:requestedContract?.permissions??state.def.tools,
60
+ }));
46
61
  let resumeAllowed = resumeContract.resumeAllowed && !!state.sessionFile && existsSync(state.sessionFile);
47
62
  if (resumeAllowed) copyFileSync(state.sessionFile!, agentSessionFile);
48
63
  else if (state.sessionFile) {
@@ -184,7 +199,9 @@ export async function prepareNativeRun(base: NativeRunBase, _resumeRequested: bo
184
199
  + (stageConfirmation ? "\n\nActive exact-action confirmation: this stage run has inspection tools only. Return the full plan/review in your final response; the Hub saves that response as the stage artifact. Do not use bash, write, edit, delegate or remote execution. No stage result authorizes a later effect." : "");
185
200
  const thinkingLevel = deps.resolveThinkingLevel(deps.resolvedThinking(state.def));
186
201
  const wantThinking = thinkingLevel !== "off";
187
- let runPrompt = deps.appendDeclaredScope(deps.appendInputArtifacts(task, inputArtifacts), scopeGlobs);
202
+ extensions.push(fileURLToPath(new URL("./specialist-result.ts", import.meta.url)));
203
+ effectiveTools = [...new Set([...effectiveTools.split(","), "submit_result"])].join(",");
204
+ let runPrompt = deps.appendDeclaredScope(deps.appendInputArtifacts(task, inputArtifacts), scopeGlobs) + "\n\n" + SPECIALIST_RESULT_INSTRUCTION;
188
205
  let writeIsolation: WriteIsolationRequest | undefined;
189
206
  let writeIsolationPolicy;
190
207
  if (assist['write-isolation']) {
@@ -208,13 +225,21 @@ export async function prepareNativeRun(base: NativeRunBase, _resumeRequested: bo
208
225
  }
209
226
  if (base.activeProfileSnapshot) delegateEnv = { ...delegateEnv, [PROFILE_ENV]: JSON.stringify(base.activeProfileSnapshot) };
210
227
 
211
- const admitted=()=>state.def.tools===admittedTools&&!state.killedByOperator&&!state.restarting&&deps.getAgentState(base.key)===state&&state.dispatchId===base.dispatchId&&deps.getSessionDir()===base.sessionDir&&base.launchIdentity===deps.launchIdentity?.()&&deps.nativeAdmission?.(personaKey)!==false;
212
- const admissionRefused=async()=>({...await base.finishRun('Native admission cancelled or changed during discovery preparation; no child started.',143),lifecycle:{launched:false,closeSeen:false}});
228
+ const admitted=()=>{
229
+ try{return state.def.tools===admittedTools&&!state.killedByOperator&&!state.restarting&&deps.getAgentState(base.key)===state&&state.dispatchId===base.dispatchId&&deps.getSessionDir()===base.sessionDir&&base.launchIdentity===deps.launchIdentity?.()&&deps.nativeAdmission?.(personaKey)!==false
230
+ &&(ctx.cwd||process.cwd())===admittedCwd&&state.task===task&&JSON.stringify([base.task,scopeGlobs,inputArtifacts])===payloadSnapshot&&JSON.stringify(currentContract())===contractSnapshot;
231
+ }catch{return false;}
232
+ };
233
+ const admissionRefused=async()=>({...await base.finishRun('Native admission cancelled or changed during preparation; no child started.',143),lifecycle:{launched:false,closeSeen:false}});
234
+ const effectiveToolSnapshot=Object.freeze(effectiveTools.split(',').map(t=>t.trim()).filter(Boolean));
213
235
  if(!admitted())return admissionRefused();
214
- const discoveryContext=await deps.prepareDiscovery?.({ownerId:base.dispatchId,task:requestedContract?.instructions??task,query:JSON.stringify([requestedContract?.instructions??task,scopeGlobs]),scope:scopeGlobs,tools:effectiveTools.split(',').map(t=>t.trim()),cwd:ctx.cwd||process.cwd()});
215
- if(!admitted()||discoveryContext?.current()===false)return admissionRefused();
236
+ const discoveryContext=await deps.prepareDiscovery?.({ownerId:base.dispatchId,task:requestedContract?.instructions??task,query:JSON.stringify([requestedContract?.instructions??task,scopeGlobs]),scope:[...scopeGlobs],tools:[...effectiveToolSnapshot],cwd:admittedCwd});
237
+ const discoveryAdmitted=()=>{try{return admitted()&&discoveryContext?.current()!==false;}catch{return false;}};
238
+ if(!discoveryAdmitted())return admissionRefused();
216
239
  runPrompt=appendDiscoveryContext(runPrompt,discoveryContext);
217
- const discoveryAdmitted=()=>admitted()&&discoveryContext?.current()!==false;
240
+ const damageRegistration=await deps.prepareDamageGuard?.(Object.freeze({ownerId:base.dispatchId,cwd:admittedCwd,tools:effectiveToolSnapshot,contract:admittedContract,admit:discoveryAdmitted}));
241
+ const nativeAdmitted=()=>{try{return discoveryAdmitted()&&(!damageRegistration||damageRegistration.validate()===true);}catch{return false;}};
242
+ if(!nativeAdmitted())return admissionRefused();
218
243
 
219
244
  if (state.sessionFile && !sessionRecycled) {
220
245
  const overflow = shouldRecycleBeforeSpawn({
@@ -241,7 +266,7 @@ export async function prepareNativeRun(base: NativeRunBase, _resumeRequested: bo
241
266
 
242
267
  return {
243
268
  ...base,
244
- discoveryContext,discoveryAdmitted,
269
+ discoveryContext,discoveryAdmitted,damageRegistration,nativeAdmitted,admittedCwd,
245
270
  model,
246
271
  originalModelFallback,
247
272
  agentWindow,
@@ -1,4 +1,5 @@
1
1
  import { relative } from "node:path";
2
+ import { TRACE_OWNER_ENV } from "../lib/execution-trace.ts";
2
3
  import { mkdirSync, watch } from "node:fs";
3
4
  import { ingestObserverManifests } from "./proactive-runtime.ts";
4
5
  import { contextPct, overWindowDiagnostic } from "./context-window.js";
@@ -83,6 +84,7 @@ function createSpawnCallbacks(run: PreparedNativeRun, drift: DriftRuntime, usage
83
84
  state.zoomRender?.();
84
85
  }),
85
86
  onToolStart: (toolName, argStr, callId) => live(() => {
87
+ run.trace?.toolStart(toolName, argStr, callId);
86
88
  state.toolCount++;
87
89
  deps.appendTimelineEvent(state, {
88
90
  kind: "tool-start",
@@ -97,6 +99,7 @@ function createSpawnCallbacks(run: PreparedNativeRun, drift: DriftRuntime, usage
97
99
  if (violation) drift.escalate(violation);
98
100
  }),
99
101
  onToolEnd: (toolName, callId, isError, resultText, durationMs) => live(() => {
102
+ run.trace?.toolEnd(toolName, callId, isError, resultText, durationMs);
100
103
  deps.appendTimelineEvent(state, {
101
104
  kind: "tool-result",
102
105
  title: `Result: ${toolName}`,
@@ -156,7 +159,13 @@ export async function runPreparedNative(run: PreparedNativeRun): Promise<NativeS
156
159
  }
157
160
  state.driftFence = drift.fence;
158
161
  const spawnOptions: SpawnPiAgentOptions = {
162
+ damageRegistration:run.damageRegistration?{
163
+ tools:run.damageRegistration.tools,
164
+ validate:()=>run.nativeAdmitted(),
165
+ open:physical=>run.damageRegistration!.open(physical),
166
+ }:undefined,
159
167
  discoveryRegistration:run.discoveryContext?.registration?{...run.discoveryContext.registration,admit:run.discoveryAdmitted}:undefined,
168
+ specialistResultTool: extensions.some(path => path.endsWith("/specialist-result.ts")),
160
169
  runtimeTestObserver: extensions.some(path => path.endsWith("/runtime-test-check.ts")),
161
170
  model,
162
171
  activeProfileSnapshot: run.activeProfileSnapshot,
@@ -169,10 +178,17 @@ export async function runPreparedNative(run: PreparedNativeRun): Promise<NativeS
169
178
  sessionFile: agentSessionFile,
170
179
  resume: run.resumeAllowed,
171
180
  prompt: runPrompt,
172
- cwd: ctx.cwd || process.cwd(),
181
+ cwd: run.admittedCwd,
173
182
  extensions,
174
- env: { ...deps.guardrailEnv(run.agentKey), ...(delegateEnv || {}) },
175
- attemptLifecycle: drift.attemptLifecycle,
183
+ env: { ...deps.guardrailEnv(run.agentKey), ...(delegateEnv || {}), [TRACE_OWNER_ENV]: run.dispatchId },
184
+ attemptLifecycle: {
185
+ ...drift.attemptLifecycle,
186
+ beforePhysicalSpawn: info=>{
187
+ const attempt=drift.attemptLifecycle.beforePhysicalSpawn(info);
188
+ if(!run.nativeAdmitted())throw Error('native_physical_admission_changed');
189
+ return attempt;
190
+ },
191
+ },
176
192
  ...(delegateEnv?.AGENT_FLEET_BOUNDED_OUTPUT_DIR ? { boundedOutputDir: delegateEnv.AGENT_FLEET_BOUNDED_OUTPUT_DIR } : {}),
177
193
  detached: true,
178
194
  ...(RESEARCHER_PERSONAS.has(personaKey) ? { toolWatchdog: { timeoutMs: deps.getReconSearchTimeoutMs() } } : {}),
@@ -184,7 +200,7 @@ export async function runPreparedNative(run: PreparedNativeRun): Promise<NativeS
184
200
  let sessionReset = run.sessionReset;
185
201
  try {
186
202
  const res = await deps.providerSemaphore.run(model, async () => {
187
- if(run.discoveryAdmitted?.()===false)return {output:'Native admission changed while queued; no child started.',stderr:'',exitCode:143,modelUsed:model,toolCallsStarted:0,lifecycle:{launched:false,closeSeen:false}};
203
+ if(!run.nativeAdmitted())return {output:'Native admission changed while queued; no child started.',stderr:'',exitCode:143,modelUsed:model,toolCallsStarted:0,lifecycle:{launched:false,closeSeen:false}};
188
204
  let result = await deps.spawnPiAgentWithModelFallback(spawnOptions, originalModelFallback, callbacks);
189
205
  if (!result.spawnError && isCorruptSessionExit({ code: result.exitCode, output: result.output, stderr: result.stderr })) {
190
206
  const quarantine = forceQuarantineSession(agentSessionFile, deps.getSessionHealthIo());
@@ -197,6 +213,10 @@ export async function runPreparedNative(run: PreparedNativeRun): Promise<NativeS
197
213
  quarantined: quarantine.quarantined,
198
214
  retried: quarantine.ok,
199
215
  };
216
+ if (quarantine.ok && !run.nativeAdmitted()) {
217
+ sessionReset.retried=false;
218
+ return {output:'Native admission changed before clean retry; no child started.',stderr:'',exitCode:143,modelUsed:model,toolCallsStarted:0,lifecycle:{launched:false,closeSeen:false}};
219
+ }
200
220
  if (quarantine.ok) {
201
221
  ctx.ui.notify(`${deps.displayName(state.def.name)}: pi rejected the session file — quarantined, retrying once from a clean session`, "warning");
202
222
  result = await deps.spawnPiAgentWithModelFallback({ ...spawnOptions, resume: false }, originalModelFallback, callbacks);
@@ -91,6 +91,8 @@ export interface NativeExecutionDiagnostics {
91
91
  }
92
92
 
93
93
  export interface NativeDispatchResult {
94
+ specialistResult?: import("./specialist-result.ts").SpecialistResult;
95
+ specialistResultTool?: boolean;
94
96
  runtimeTests?: import("./runtime-test-check.ts").RuntimeTestRecord[];
95
97
  writeIsolation?: Pick<WriteIsolationResult, "applied" | "failClosed" | "mechanism" | "permissionExpansion" | "rollsBackUserEdits" | "protectsConcurrentUserWrites">;
96
98
  toolEvents?: import("./tool-protocol.ts").ToolExecutionEvent[];
@@ -126,7 +128,27 @@ export interface NativeProviderSemaphore {
126
128
  run<T>(model: string, fn: () => Promise<T>): Promise<T>;
127
129
  }
128
130
 
131
+ export interface NativeDamageContract {
132
+ readonly taskId: string;
133
+ readonly instructions: string;
134
+ readonly scope: readonly string[];
135
+ readonly deliverables: readonly string[];
136
+ readonly artifacts: readonly string[];
137
+ readonly permissions: readonly string[];
138
+ }
139
+
140
+ /** Parent-only admission input; model and environment are not authority. */
141
+ export interface NativeDamagePreparation {
142
+ readonly ownerId: string;
143
+ readonly cwd: string;
144
+ readonly tools: readonly string[];
145
+ readonly contract: NativeDamageContract;
146
+ admit(): boolean;
147
+ }
148
+
129
149
  export interface NativeDispatchDeps {
150
+ traceNative?(owner: string, actor: string): ReturnType<typeof import("./execution-trace.ts").createNativeExecutionTrace>;
151
+ prepareDamageGuard?(input: NativeDamagePreparation): import('./damage-guard-owners.ts').DamageSpawnRegistration | null | undefined | Promise<import('./damage-guard-owners.ts').DamageSpawnRegistration | null | undefined>;
130
152
  prepareDiscovery?:import('./file-discovery/native-context.ts').PrepareNativeDiscovery;
131
153
  launchIdentity?():unknown;
132
154
  nativeAdmission?(personaKey:string):boolean;
@@ -205,6 +227,7 @@ export interface NativeDispatchDeps {
205
227
  }
206
228
 
207
229
  export interface NativeRunBase {
230
+ trace?: ReturnType<typeof import("./execution-trace.ts").createNativeExecutionTrace>;
208
231
  readonly sessionDir: string;
209
232
  readonly launchIdentity?:unknown;
210
233
  readonly evidenceDir: string;
@@ -231,6 +254,9 @@ export interface NativeRunBase {
231
254
  }
232
255
 
233
256
  export interface PreparedNativeRun extends NativeRunBase {
257
+ admittedCwd: string;
258
+ nativeAdmitted(): boolean;
259
+ damageRegistration?: import('./damage-guard-owners.ts').DamageSpawnRegistration | null;
234
260
  discoveryContext?:import('./file-discovery/native-context.ts').NativeDiscoveryContext|null;
235
261
  discoveryAdmitted?():boolean;
236
262
  model: string;
@@ -119,6 +119,7 @@ function beginNativeRun(deps: NativeDispatchDeps, state: NativeDispatchState, ar
119
119
  };
120
120
 
121
121
  return {
122
+ trace: deps.traceNative?.(dispatchId, agentKey),
122
123
  dispatchId, transcriptPath, sessionDir, evidenceDir, deps, state, ctx, task, inputArtifacts, scopeGlobs, watchdogParam, launchIdentity:deps.launchIdentity?.(),
123
124
  key: normalizeAgentInput(args.agentName),
124
125
  personaKey: state.def.name.toLowerCase(),
@@ -213,6 +214,7 @@ async function dispatchNative(deps: NativeDispatchDeps, args: Omit<NativeDispatc
213
214
  let result: NativeDispatchResult;
214
215
  try { result = await execute(); }
215
216
  catch (error) { result = await run.finishRun(`Dispatch exception: ${error instanceof Error ? error.stack : String(error)}`, 1); }
217
+ run.trace?.finish(result);
216
218
  deps.flushTimelineStore(run.state);
217
219
  return finishExecutionEvidence(run.evidenceDir, result);
218
220
  }
@@ -0,0 +1,241 @@
1
+ import { createHash, randomUUID } from "node:crypto";
2
+ import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
3
+ import { EXECUTION_TRACE_CHANNEL, policyTraceReason, type TraceEnvelope, type TraceEnd, type TraceKind, type TraceSource, type TraceStart, type TraceStatus } from "../lib/execution-trace.ts";
4
+
5
+ export const EXECUTION_TRACE_ENTRY = "agent-hub-execution-trace";
6
+ // v2 journals one row per finished span (start time, end time and outcome together);
7
+ // only long-lived turn/child spans also journal their start, so a crash still shows
8
+ // what was in flight. v1 rows (separate start/end) from older sessions remain readable.
9
+ const SCHEMA = "agent-fleet.execution-trace/v2";
10
+ const LEGACY_SCHEMA = "agent-fleet.execution-trace/v1";
11
+ const JOURNALED_STARTS = new Set<TraceKind>(["turn", "child"]);
12
+ const MAX_ROWS = 5000;
13
+ const kinds = new Set<TraceKind>(["input", "turn", "model", "tool", "policy", "approval", "queue", "child"]);
14
+ const sources = new Set<TraceSource>(["runtime", "native", "process", "task-triage", "damage-control", "damage-guard", "access-escalation"]);
15
+ const statuses = new Set<TraceStatus>(["pending", "completed", "failed", "allowed", "denied", "blocked", "cancelled", "interrupted", "unavailable", "reused", "not_started", "busy"]);
16
+ const reasons = new Set(["zero_access", "read_only", "no_delete", "authority_changed", "human_denial", "policy_rule", "task_transition_pending", "process_state_corrupt", "risk_required", "action_confirmation_unsupported", "approval_queue"]);
17
+ const actors = new Set(["operator", "specialist", "builder", "planner", "plan-reviewer", "code-reviewer", "security-auditor", "test-engineer", "researcher", "deep-researcher", "architect", "documenter", "debugger"]);
18
+ const tools = new Set(["bash", "read", "write", "edit", "grep", "find", "ls", "filesystem", "ask_user", "dispatch_agent", "spawn_research", "set_task_tier", "set_assertions", "update_assertion", "get_assertions", "coms_send", "coms_get", "coms_await", "delegate"]);
19
+ const hash = (value: string) => createHash("sha256").update(value).digest("hex");
20
+ const millis = (value: unknown): value is number => typeof value === "number" && Number.isFinite(value) && value >= 0;
21
+ const digest = (value: unknown): value is string => typeof value === "string" && /^[a-f0-9]{64}$/.test(value);
22
+
23
+ export interface ExecutionTraceRow {
24
+ schema: typeof SCHEMA | typeof LEGACY_SCHEMA; instanceId: string; sequence: number; atMs: number;
25
+ /** Present on a v2 finished-span row; atMs is then the span's start. */
26
+ endAtMs?: number;
27
+ spanId: string; parentSpanId: string | null; ownerIdHash: string; taskIdHash: string; inputRevisionHash: string;
28
+ kind: TraceKind; source: TraceSource; phase: "start" | "end" | "span"; status: TraceStatus;
29
+ tool?: string; ruleId?: string; fingerprint?: string; childIdHash?: string; durationMs?: number;
30
+ decision?: TraceEnd["decision"];
31
+ reason?: string;
32
+ actor: string; analysis?: TraceEnd["analysis"];
33
+ }
34
+ export interface ExecutionTraceSnapshot { rows: ExecutionTraceRow[]; persistenceFailures: number; droppedRows: number; open?: ExecutionTraceRow[]; }
35
+
36
+ export function createExecutionTrace(ports: { identity(): { taskId: string; inputRevision: string }; persist(row: ExecutionTraceRow): void; now?(): number }) {
37
+ let instanceId = randomUUID(), sequence = 0, persistenceFailures = 0, droppedRows = 0;
38
+ const active = new Map<string, { row: ExecutionTraceRow; finish: (end: TraceEnd) => void }>();
39
+ const rows: ExecutionTraceRow[] = [];
40
+ const now = ports.now ?? Date.now;
41
+ const key = (kind: TraceKind, id: string, owner = "hub") => JSON.stringify([kind, owner, id]);
42
+ const spanId = (kind: TraceKind, id: string, owner = "hub") => hash(JSON.stringify([instanceId, kind, owner, id]));
43
+ const record = (row: ExecutionTraceRow) => {
44
+ rows.push(row); if (rows.length > MAX_ROWS) { rows.shift(); droppedRows++; }
45
+ try { ports.persist(row); } catch { persistenceFailures++; }
46
+ };
47
+ const start = (input: TraceStart, capturedIdentity?: ReturnType<typeof ports.identity>): ((end: TraceEnd) => void) => {
48
+ if (!input || !kinds.has(input.kind) || typeof input.id !== "string" || !input.id || input.id.length > 512) return () => {};
49
+ const binding = key(input.kind, input.id, input.owner), prior = active.get(binding);
50
+ if (prior) return prior.finish;
51
+ const identity = capturedIdentity ?? ports.identity(), epoch = instanceId;
52
+ const parent=input.parentId?active.get(key(input.parentKind??"tool",input.parentId,input.owner))?.row:undefined;
53
+ const child=input.owner?active.get(key("child",input.owner,input.owner))?.row:undefined;
54
+ const row: ExecutionTraceRow = {
55
+ schema: SCHEMA, instanceId, sequence: ++sequence, atMs: now(),
56
+ spanId: spanId(input.kind, input.id, input.owner),
57
+ parentSpanId: input.parentId ? spanId(input.parentKind ?? "tool", input.parentId, input.owner) : null,
58
+ ownerIdHash: hash(input.owner ?? "hub"), taskIdHash: parent?.taskIdHash??child?.taskIdHash??hash(identity.taskId), inputRevisionHash: parent?.inputRevisionHash??child?.inputRevisionHash??hash(identity.inputRevision),
59
+ actor: input.actor&&actors.has(input.actor)?input.actor:parent?.actor??child?.actor??(!input.owner||input.owner==="hub"?"operator":"specialist"),
60
+ kind: input.kind, source: input.source && sources.has(input.source) ? input.source : "runtime", phase: "start", status: "pending",
61
+ ...(input.tool ? { tool: tools.has(input.tool) ? input.tool : "other" } : {}),
62
+ ...(input.rule ? { ruleId: hash(input.rule) } : {}), ...(input.fingerprint ? { fingerprint: hash(input.fingerprint) } : {}),
63
+ ...(input.reason && reasons.has(input.reason) ? { reason: input.reason } : {}),
64
+ };
65
+ const finish = (end: TraceEnd) => {
66
+ if (instanceId !== epoch || active.get(binding)?.row !== row || !end || !statuses.has(end.status)) return;
67
+ active.delete(binding);
68
+ record({ ...row, sequence: ++sequence, endAtMs: Math.max(row.atMs, now()), phase: "span", status: end.status,
69
+ ...(millis(end.durationMs) ? { durationMs: end.durationMs } : {}), ...(end.childId ? { childIdHash: hash(end.childId) } : {}),
70
+ ...(end.rule ? { ruleId: hash(end.rule) } : {}), ...(end.reason && reasons.has(end.reason) ? { reason: end.reason } : {}),
71
+ ...(end.analysis && ["static_operands","conservative_text"].includes(end.analysis) ? {analysis:end.analysis} : {}),
72
+ ...(end.decision && ["selected_first", "selected_second", "freeform", "multiple", "none"].includes(end.decision) ? { decision: end.decision } : {}) });
73
+ };
74
+ active.set(binding, { row, finish }); if (JOURNALED_STARTS.has(row.kind)) record(row); return finish;
75
+ };
76
+ const close = () => { for (const item of [...active.values()]) item.finish({ status: "interrupted" }); };
77
+ return {
78
+ start: (input:TraceStart) => start(input),
79
+ endTool(id: string, end: TraceEnd, owner = "hub") { active.get(key("tool", id, owner))?.finish(end); },
80
+ input(id: string) { start({ kind: "input", id })({ status: "completed" }); },
81
+ close,
82
+ reset() { close(); instanceId = randomUUID(); sequence = 0; rows.length = 0; persistenceFailures = 0; droppedRows = 0; },
83
+ snapshot: (): ExecutionTraceSnapshot => ({ rows: [...rows], persistenceFailures, droppedRows, open: [...active.values()].map(item => item.row) }),
84
+ forOwner(owner: string) {
85
+ const epoch=instanceId,identity=ports.identity();
86
+ return {
87
+ start: (input:TraceStart) => instanceId===epoch ? start({...input,owner},identity) : (_end:TraceEnd)=>{},
88
+ endTool: (id:string,end:TraceEnd) => { if(instanceId===epoch)active.get(key("tool",id,owner))?.finish(end); },
89
+ close: () => { if(instanceId===epoch)for(const item of [...active.values()])if(item.row.ownerIdHash===hash(owner))item.finish({status:"interrupted"}); },
90
+ };
91
+ },
92
+ };
93
+ }
94
+ export type ExecutionTrace = ReturnType<typeof createExecutionTrace>;
95
+
96
+ /** Native callbacks already transport tool metadata; no new child transport. */
97
+ export function createNativeExecutionTrace(trace:ExecutionTrace,owner:string,actor?:string) {
98
+ const scope=trace.forOwner(owner),finish=scope.start({kind:"child",id:owner,actor});
99
+ let closed=false;
100
+ return {
101
+ toolStart(tool:string,args:string,id?:string) { if(id&&!closed)scope.start({kind:"tool",id,parentId:owner,parentKind:"child",tool,source:"native",fingerprint:args}); },
102
+ toolEnd(tool:string,id?:string,isError?:boolean,resultText?:string,durationMs?:number) {
103
+ if(!id||closed)return;
104
+ // An allowlisted marker explains refusal; it is never proof or permission.
105
+ const blocked=isError&&durationMs===undefined&&/Damage-Control:/.test(resultText??"");
106
+ if(blocked)scope.start({kind:"policy",id:`baseline:${id}`,parentId:id,source:"damage-control",tool,rule:(resultText??"").split("\n",1)[0],reason:policyTraceReason(resultText??"")})({status:"blocked"});
107
+ scope.endTool(id,{status:blocked?"blocked":isError?"failed":"completed",durationMs});
108
+ },
109
+ finish(result:{exitCode:number;pending?:boolean}) { closed=true;finish({status:result.pending?"pending":result.exitCode===0?"completed":"failed"});scope.close(); },
110
+ };
111
+ }
112
+
113
+ function normalizeRow(raw: unknown): ExecutionTraceRow | null {
114
+ if (!raw || typeof raw !== "object") return null;
115
+ const row = raw as ExecutionTraceRow;
116
+ const phases = row.schema === SCHEMA ? ["start", "span"] : row.schema === LEGACY_SCHEMA ? ["start", "end"] : [];
117
+ if (!/^[a-f0-9-]{36}$/.test(row.instanceId) || !Number.isSafeInteger(row.sequence) || row.sequence < 1 || !millis(row.atMs)
118
+ || !digest(row.spanId) || row.parentSpanId !== null && !digest(row.parentSpanId) || ![row.ownerIdHash, row.taskIdHash, row.inputRevisionHash].every(digest)
119
+ || !kinds.has(row.kind) || !sources.has(row.source) || !phases.includes(row.phase) || !statuses.has(row.status)
120
+ || row.phase === "span" && !(millis(row.endAtMs) && row.endAtMs >= row.atMs)) return null;
121
+ return { schema: row.schema, instanceId: row.instanceId, sequence: row.sequence, atMs: row.atMs, ...(row.phase === "span" ? { endAtMs: row.endAtMs } : {}), spanId: row.spanId, parentSpanId: row.parentSpanId,
122
+ ownerIdHash: row.ownerIdHash, taskIdHash: row.taskIdHash, inputRevisionHash: row.inputRevisionHash, kind: row.kind, source: row.source, phase: row.phase, status: row.status,
123
+ actor: actors.has(row.actor)?row.actor:"specialist",...(row.analysis&&["static_operands","conservative_text"].includes(row.analysis)?{analysis:row.analysis}:{}),
124
+ ...(row.tool && (tools.has(row.tool) || row.tool === "other") ? { tool: row.tool } : {}),
125
+ ...(digest(row.ruleId) ? { ruleId: row.ruleId } : {}), ...(digest(row.fingerprint) ? { fingerprint: row.fingerprint } : {}),
126
+ ...(digest(row.childIdHash) ? { childIdHash: row.childIdHash } : {}), ...(millis(row.durationMs) ? { durationMs: row.durationMs } : {}),
127
+ ...(row.decision && ["selected_first", "selected_second", "freeform", "multiple", "none"].includes(row.decision) ? { decision: row.decision } : {}),
128
+ ...(row.reason && reasons.has(row.reason) ? { reason: row.reason } : {}),
129
+ };
130
+ }
131
+ type Interval = [number, number];
132
+ function union(intervals: Interval[]): Interval[] {
133
+ const merged: Interval[] = [];
134
+ for (const [start, end] of intervals.sort((a, b) => a[0] - b[0])) {
135
+ const last = merged.at(-1);
136
+ if (last && start <= last[1]) last[1] = Math.max(last[1], end); else merged.push([start, end]);
137
+ }
138
+ return merged;
139
+ }
140
+ const length = (intervals: Interval[]) => union(intervals).reduce((sum, [a, b]) => sum + Math.max(0, b - a), 0);
141
+ const intersections = (left: Interval[], right: Interval[]) => left.flatMap(([a, b]) => right.map(([c, d]): Interval => [Math.max(a, c), Math.max(Math.max(a, c), Math.min(b, d))]));
142
+
143
+ export function projectExecutionTrace(entries: readonly unknown[], live?: ExecutionTraceSnapshot) {
144
+ let invalidRecords = 0, duplicateRecords = 0, droppedRows = 0;
145
+ const retained = new Map<string, ExecutionTraceRow>();
146
+ for (const entry of entries) {
147
+ const value = entry as { customType?: unknown; data?: unknown };
148
+ if (value?.customType !== EXECUTION_TRACE_ENTRY) continue;
149
+ const row = normalizeRow(value.data); if (!row) { invalidRecords++; continue; }
150
+ const key = `${row.instanceId}:${row.sequence}`, previous = retained.get(key);
151
+ if (previous) { duplicateRecords++; if (JSON.stringify(previous) !== JSON.stringify(row)) invalidRecords++; }
152
+ else retained.set(key, row);
153
+ }
154
+ if (live?.persistenceFailures) for (const raw of live.rows) { const row = normalizeRow(raw); if (row) retained.set(`${row.instanceId}:${row.sequence}`, row); }
155
+ // Unfinished spans are journaled only for turn/child; the live view still shows the rest.
156
+ for (const raw of live?.open ?? []) { const row = normalizeRow(raw); if (row) retained.set(`${row.instanceId}:${row.sequence}`, row); }
157
+ const all = [...retained.values()].sort((a, b) => a.atMs - b.atMs || a.sequence - b.sequence);
158
+ if (all.length > MAX_ROWS) droppedRows += all.length - MAX_ROWS;
159
+ const events = all.slice(-MAX_ROWS), grouped = new Map<string, { start?: ExecutionTraceRow; end?: ExecutionTraceRow }>();
160
+ for (const row of events) {
161
+ const item = grouped.get(row.spanId) ?? {};
162
+ if (row.phase === "span") { item.start ??= row; item.end = { ...row, atMs: row.endAtMs! }; } else item[row.phase] = row;
163
+ grouped.set(row.spanId, item);
164
+ }
165
+ const spans = [...grouped].map(([spanId, { start, end }]) => {
166
+ const row = start ?? end!;
167
+ return { spanId, instanceId: row.instanceId, parentSpanId: row.parentSpanId, ownerIdHash: row.ownerIdHash, taskIdHash: row.taskIdHash, inputRevisionHash: row.inputRevisionHash,
168
+ kind: row.kind, source: row.source, actor:row.actor, tool: row.tool, ruleId: end?.ruleId ?? row.ruleId, reason: end?.reason ?? row.reason, analysis:end?.analysis, fingerprint: row.fingerprint, childIdHash: end?.childIdHash, decision: end?.decision,
169
+ startedAt: start?.atMs ?? null, endedAt: end?.atMs ?? null, status: end?.status ?? "open", elapsedMs: start && end ? Math.max(0, end.atMs - start.atMs) : null,
170
+ executionMs: end?.durationMs ?? null, humanWaitMs: 0, executionWithoutHumanMs: null as number | null, repeatOf: null as string | null,
171
+ correlation: row.parentSpanId ? "direct" : null as string | null };
172
+ });
173
+ const byId = new Map(spans.map(s => [s.spanId, s]));
174
+ for (const child of spans.filter(s => s.kind === "child" && !s.parentSpanId)) {
175
+ const parents = spans.filter(s => s.kind === "tool" && s.instanceId === child.instanceId && s.childIdHash === child.ownerIdHash);
176
+ if (parents.length === 1) { child.parentSpanId = parents[0].spanId; child.correlation = "runtime_child"; }
177
+ }
178
+ // The existing child broker has its own request id. Join only one exact input
179
+ // observation from the same owner and time range; ambiguous calls stay unlinked.
180
+ for(const policy of spans.filter(s=>s.kind==="policy"&&!s.parentSpanId&&s.fingerprint&&s.source==="damage-guard")){
181
+ const candidates=spans.filter(s=>s.kind==="tool"&&s.instanceId===policy.instanceId&&s.ownerIdHash===policy.ownerIdHash&&s.tool===policy.tool&&s.fingerprint===policy.fingerprint
182
+ &&s.startedAt!==null&&policy.startedAt!==null&&s.startedAt<=policy.startedAt&&(s.endedAt===null||policy.endedAt!==null&&s.endedAt>=policy.endedAt));
183
+ if(candidates.length===1){policy.parentSpanId=candidates[0].spanId;policy.correlation="exact_input_unique";}
184
+ }
185
+ const below = (span: typeof spans[number], ancestor: typeof spans[number]) => {
186
+ const seen = new Set<string>(); let parent = span.parentSpanId;
187
+ while (parent && !seen.has(parent)) { if (parent === ancestor.spanId) return true; seen.add(parent); parent = byId.get(parent)?.parentSpanId ?? null; }
188
+ return false;
189
+ };
190
+ const interval = (s: typeof spans[number]): Interval[] => s.startedAt === null || s.endedAt === null ? [] : [[s.startedAt, s.endedAt]];
191
+ const waits = spans.filter(s => s.kind === "approval" && s.status !== "reused").flatMap(interval);
192
+ const repeats = new Map<string, string>();
193
+ for (const tool of spans.filter(s => s.kind === "tool")) {
194
+ const ownWaits = spans.filter(s => s.kind === "approval" && s.status !== "reused" && below(s, tool)).flatMap(interval);
195
+ tool.humanWaitMs = length(ownWaits);
196
+ if (tool.executionMs !== null && tool.endedAt !== null) {
197
+ const execution: Interval[] = [[Math.max(tool.startedAt ?? 0, tool.endedAt - tool.executionMs), tool.endedAt]];
198
+ tool.executionWithoutHumanMs = Math.max(0, tool.executionMs - length(intersections(execution, ownWaits)));
199
+ }
200
+ if (tool.status === "failed" && tool.executionMs === null && spans.some(s => s.kind === "policy" && s.parentSpanId === tool.spanId && s.status === "blocked")) tool.status = "blocked";
201
+ if (tool.fingerprint) { const key = JSON.stringify([tool.instanceId, tool.ownerIdHash, tool.taskIdHash, tool.inputRevisionHash, tool.tool, tool.fingerprint]); tool.repeatOf = repeats.get(key) ?? null; repeats.set(key, tool.spanId); }
202
+ }
203
+ const executions: Interval[] = spans.filter(s => s.kind === "tool" && s.executionMs !== null && s.endedAt !== null).map(s => [Math.max(s.startedAt ?? 0, s.endedAt! - s.executionMs!), s.endedAt!]);
204
+ return { schema: SCHEMA, diagnosticOnly: true,
205
+ coverage: { availability: live?.persistenceFailures ? "live_degraded" : events.length ? "recorded" : "not_recorded", persistenceFailures: live?.persistenceFailures ?? 0,
206
+ invalidRecords, duplicateRecords, droppedRows, liveDroppedRows: live?.droppedRows ?? 0, openSpans: spans.filter(s => s.status === "open").length,
207
+ incompleteSpans: spans.filter(s => s.startedAt === null || s.endedAt === null || ["interrupted","pending"].includes(s.status)).length,
208
+ unlinkedSpans: spans.filter(s=>s.parentSpanId&&!byId.has(s.parentSpanId)||s.kind==="policy"&&s.source==="damage-guard"&&!s.parentSpanId).length },
209
+ totals: { scope:"retained_trace_window", observedWallMs: events.length ? Math.max(0, Math.max(...events.map(row => row.endAtMs ?? row.atMs)) - events[0].atMs) : null,
210
+ toolActivityMs: events.length?length(spans.filter(s => s.kind === "tool").flatMap(interval)):null, humanWaitMs: events.length?length(waits):null,
211
+ queueWaitMs: events.length?length(spans.filter(s=>s.kind==="queue").flatMap(interval)):null, modelRoundMs: events.length?length(spans.filter(s=>s.kind==="model").flatMap(interval)):null,
212
+ executionMs: events.length?length(executions):null, executionWithoutHumanMs: events.length?Math.max(0, length(executions) - length(intersections(executions, waits))):null,
213
+ repeatedTools: spans.filter(s => s.repeatOf).length, blockedTools: spans.filter(s => s.kind === "tool" && s.status === "blocked").length },
214
+ spans, events,
215
+ };
216
+ }
217
+
218
+ export function registerExecutionTrace(pi: Pick<ExtensionAPI, "on" | "events">, trace: ExecutionTrace): void {
219
+ const receive = (value: unknown) => {
220
+ const envelope = value as TraceEnvelope;
221
+ if (envelope?.start) envelope.finish = trace.start(envelope.start);
222
+ };
223
+ let unsubscribe: (() => void) | undefined = pi.events.on(EXECUTION_TRACE_CHANNEL, receive);
224
+ pi.on("session_start", async () => { trace.reset(); unsubscribe ??= pi.events.on(EXECUTION_TRACE_CHANNEL, receive); });
225
+ // before_switch is only a proposal: another extension may cancel it.
226
+ pi.on("session_shutdown", async () => { trace.close(); unsubscribe?.(); unsubscribe = undefined; });
227
+ let finishTurn: ((end: TraceEnd) => void) | undefined;
228
+ let finishModel: ((end: TraceEnd) => void) | undefined;
229
+ pi.on("agent_start", async () => { finishTurn = trace.start({ kind: "turn", id: randomUUID() }); });
230
+ pi.on("agent_end", async () => { finishTurn?.({ status: "completed" }); trace.close(); });
231
+ pi.on("turn_start",async()=>{finishModel=trace.start({kind:"model",id:randomUUID()});});
232
+ pi.on("message_end",async event=>{if(event.message.role==="assistant")finishModel?.({status:event.message.stopReason==="error"?"failed":event.message.stopReason==="aborted"?"cancelled":"completed"});});
233
+ pi.on("tool_execution_start", async event => {
234
+ trace.start({ kind: "tool", id: event.toolCallId, tool: event.toolName, fingerprint: JSON.stringify(event.args ?? {}) });
235
+ });
236
+ pi.on("tool_execution_end", async event => {
237
+ const details = event.result?.details as Record<string, unknown> | undefined;
238
+ const status: TraceStatus = details?.status === "review_reused" ? "reused" : details?.status === "busy" ? "busy" : details?.started === false ? "not_started" : event.isError ? "failed" : "completed";
239
+ trace.endTool(event.toolCallId, { status, durationMs: (event as typeof event & { durationMs?: number }).durationMs, childId: typeof details?.dispatchId === "string" ? details.dispatchId : undefined });
240
+ });
241
+ }
@@ -2,13 +2,13 @@ import {basename,dirname,isAbsolute,relative,resolve} from 'node:path';
2
2
  import {lstatSync,readdirSync,realpathSync} from 'node:fs';
3
3
  import {checkedSourcePath} from '../../lib/safe-source-read.js';
4
4
  import {exportPathAllowed} from '../agentic-sources.ts';
5
- export const PINNED_PI_VERSION='0.84.2';
5
+ export const PINNED_PI_VERSION='1.1.0';
6
6
  export interface CandidateSet {paths:string[];discoveryComplete:boolean;remaining:0|'unknown';reason?:string;hidden?:number;excluded?:number}
7
7
  const refused=(reason:string):CandidateSet=>({paths:[],discoveryComplete:false,remaining:'unknown',reason});
8
8
  export function canonicalCandidate(root:string,path:string,include:readonly string[]):string|undefined {
9
9
  try{
10
10
  const full=checkedSourcePath(root,resolve(root,path)),rel=relative(realpathSync(root),full).split('\\').join('/');
11
- if(!lstatSync(full).isFile()||!exportPathAllowed(rel,include))return;
11
+ if(/(?:^|\/)file-discovery-[0-9a-f-]{36}\/page-\d+\.json$/.test(rel)||!lstatSync(full).isFile()||!exportPathAllowed(rel,include))return;
12
12
  return rel;
13
13
  }catch{return;}
14
14
  }
@@ -30,8 +30,14 @@ export function adaptDiscovery(options:{tool:string;args:Record<string,unknown>;
30
30
  let complete=true,excluded=0;const candidates:string[]=[];
31
31
  const add=(path:string)=>{const candidate=canonicalCandidate(root,path,include);if(candidate)candidates.push(candidate);else {try{if(lstatSync(checkedSourcePath(root,path)).isFile())excluded++;}catch{}}};
32
32
  if(tool==='filesystem'){
33
- if(args.operation!=='inventory')return refused('unsupported_operation');
34
33
  const value=result?.details?.result;
34
+ if(args.operation==='stat'){
35
+ if(!value||value.path!==search||!['file','directory','other'].includes(value.type)||typeof value.selfRead!=='boolean'||!Number.isSafeInteger(value.limitBytes))return refused('unknown_shape');
36
+ if(value.type!=='file')return refused('not_file');
37
+ if(!Number.isSafeInteger(value.bytes)||value.bytes<0)return refused('unknown_shape');
38
+ add(search);return {paths:[...new Set(candidates)],discoveryComplete:true,remaining:0,excluded};
39
+ }
40
+ if(args.operation!=='inventory')return refused('unsupported_operation');
35
41
  if(!value||value.root!==search||!Array.isArray(value.entries)||typeof value.truncated!=='boolean'||!Number.isSafeInteger(value.totalEntries))return refused('unknown_shape');
36
42
  complete=!value.truncated;
37
43
  for(const entry of value.entries){
@@ -2,9 +2,10 @@ import {createConnection} from 'node:net';
2
2
  import {randomUUID} from 'node:crypto';
3
3
  import {TextDecoder} from 'node:util';
4
4
  import type {DiscoveryAssignment} from './owners.ts';
5
+ import {FOREGROUND_MS} from './semantic-profiles.ts';
5
6
  import {BROKER_LIMITS,type BrokerReply} from './broker.ts';
6
- export function rankDiscovery(assignment:DiscoveryAssignment,input:{paths:readonly string[];discovery:{complete:boolean;reason?:string}},signal?:AbortSignal,timeoutMs:number=BROKER_LIMITS.requestMs):Promise<BrokerReply> {
7
- return discoveryRequest(assignment,{type:'rank_discovery',paths:input.paths,discovery:input.discovery},signal,timeoutMs);
7
+ export function rankDiscovery(assignment:DiscoveryAssignment,input:{paths:readonly string[];foreground?:boolean;discovery:{complete:boolean;reason?:string}},signal?:AbortSignal,timeoutMs:number=BROKER_LIMITS.requestMs):Promise<BrokerReply> {
8
+ return discoveryRequest(assignment,{type:'rank_discovery',paths:input.paths,discovery:input.discovery,...(input.foreground?{foreground:true}:{})},signal,input.foreground?Math.min(timeoutMs,FOREGROUND_MS):timeoutMs);
8
9
  }
9
10
  export function registerDescendant(assignment:DiscoveryAssignment,input:{childId:string;task:string;query:string;tools:readonly string[]},signal?:AbortSignal):Promise<BrokerReply> {
10
11
  return discoveryRequest(assignment,{type:'register_descendant',...input},signal);
@@ -26,13 +27,18 @@ async function discoveryRequest(assignment:DiscoveryAssignment,payload:Record<st
26
27
  let cleanupTimer:ReturnType<typeof setTimeout>|undefined;
27
28
  const settle=(result:BrokerReply)=>{if(done)return;done=true;clearTimeout(timer);clearTimeout(cleanupTimer);signal?.removeEventListener('abort',abort);resolve(result);};
28
29
  const finish=(result:BrokerReply)=>{if(done)return;settle(result);socket.destroy();};
29
- const abort=()=>{if(!awaitingDeadline)finish({ok:false,error:'cancelled'});};
30
+ const abort=()=>{if(payload.foreground===true||!awaitingDeadline)finish({ok:false,error:'cancelled'});};
30
31
  const timer=setTimeout(()=>{
31
32
  if(!terminal){finish({ok:false,error:'deadline'});return;}
32
33
  if(!connected||socket.destroyed||!socket.writable){finish({ok:false,error:'channel_unavailable'});return;}
33
34
  // The local deadline wins over later caller abort, but delivery needs the
34
35
  // broker's reply on this request connection after it latches the typed cause.
35
36
  awaitingDeadline=true;
37
+ if(payload.foreground===true){
38
+ // Caller deadline includes IPC/ACK cleanup. Latch the cause, then detach locally.
39
+ try{socket.end(terminal);}catch{/* channel is already unavailable */}
40
+ settle({ok:false,error:'deadline'});setTimeout(()=>socket.destroy(),BROKER_LIMITS.partialFrameMs).unref();return;
41
+ }
36
42
  cleanupTimer=setTimeout(()=>finish({ok:false,error:'channel_unavailable'}),BROKER_LIMITS.partialFrameMs);
37
43
  try{socket.end(terminal);}catch{finish({ok:false,error:'channel_unavailable'});}
38
44
  },timeoutMs);
@@ -43,7 +49,7 @@ async function discoveryRequest(assignment:DiscoveryAssignment,payload:Record<st
43
49
  socket.on('data',chunk=>{
44
50
  if(done)return;
45
51
  if(buffer.length+chunk.length>BROKER_LIMITS.responseBytes){finish({ok:false,error:'response_too_large'});return;}
46
- buffer=Buffer.concat([buffer,chunk]);const newline=buffer.indexOf(10);if(newline<0)return;
52
+ buffer=Buffer.concat([buffer,typeof chunk==='string'?Buffer.from(chunk):chunk]);const newline=buffer.indexOf(10);if(newline<0)return;
47
53
  try{
48
54
  if(newline!==buffer.length-1)throw Error();
49
55
  const reply=JSON.parse(new TextDecoder('utf-8',{fatal:true}).decode(buffer.subarray(0,newline)));
@@ -4,10 +4,11 @@ import {join,resolve,relative,isAbsolute} from 'node:path';
4
4
  import {createServer,type Socket} from 'node:net';
5
5
  import {TextDecoder} from 'node:util';
6
6
  import {DISCOVERY_DEADLINE,isDiscoveryDeadline,type DiscoveryRuntime} from './runtime.ts';
7
+ import {FOREGROUND_MS} from './semantic-profiles.ts';
7
8
  import type {DiscoveryResult} from './results.ts';
8
9
  import type {DiscoveryOwners,OwnerLease} from './owners.ts';
9
10
  export const BROKER_LIMITS=Object.freeze({frameBytes:65536,responseBytes:65536,connections:16,partialFrameMs:1000,requestMs:20000,maxCandidates:1024});
10
- export interface RankDiscoveryRequest {type:'rank_discovery';capability:string;sessionId:string;taskId:string;ownerId:string;attemptId:string;queryHash:string;requestId:string;paths:string[];discovery:{complete:boolean;reason?:string}}
11
+ export interface RankDiscoveryRequest {type:'rank_discovery';capability:string;sessionId:string;taskId:string;ownerId:string;attemptId:string;queryHash:string;requestId:string;paths:string[];foreground?:boolean;discovery:{complete:boolean;reason?:string}}
11
12
  export interface RankDeadlineRequest extends Omit<RankDiscoveryRequest,'type'|'paths'|'discovery'> {type:'rank_deadline'}
12
13
  const requestIdentity=['capability','sessionId','taskId','ownerId','attemptId','queryHash','requestId'] as const;
13
14
  function validRankDeadline(value:any,request:RankDiscoveryRequest):value is RankDeadlineRequest {
@@ -25,7 +26,7 @@ function validControlRequest(value:any):value is DescendantRequest|RevokeDiscove
25
26
  }
26
27
  export function validBrokerRequest(value:any):value is RankDiscoveryRequest {
27
28
  const record=(v:any)=>v&&typeof v==='object'&&!Array.isArray(v);
28
- return record(value)&&Object.keys(value).every(k=>['type','capability','sessionId','taskId','ownerId','attemptId','queryHash','requestId','paths','discovery'].includes(k))&&value.type==='rank_discovery'&&typeof value.capability==='string'&&/^[0-9a-f]{64}$/.test(value.capability)&&typeof value.queryHash==='string'&&/^[0-9a-f]{64}$/.test(value.queryHash)&&['sessionId','taskId','ownerId','attemptId','requestId'].every(k=>typeof value[k]==='string'&&/^[A-Za-z0-9._:-]{1,128}$/.test(value[k]))&&Array.isArray(value.paths)&&value.paths.length<=BROKER_LIMITS.maxCandidates&&value.paths.every((p:any)=>typeof p==='string'&&p.length<=1024&&p.length>0&&!/[\\\x00-\x1f\x7f]/.test(p)&&!p.startsWith('/')&&p.split('/').every((s:string)=>s&&s!=='.'&&s!=='..'))&&record(value.discovery)&&Object.keys(value.discovery).every(k=>['complete','reason'].includes(k))&&typeof value.discovery.complete==='boolean'&&(value.discovery.reason===undefined||['candidate_limit','deadline','truncated','unavailable'].includes(value.discovery.reason));
29
+ return record(value)&&Object.keys(value).every(k=>['type','capability','sessionId','taskId','ownerId','attemptId','queryHash','requestId','paths','discovery','foreground'].includes(k))&&value.type==='rank_discovery'&&(value.foreground===undefined||typeof value.foreground==='boolean')&&typeof value.capability==='string'&&/^[0-9a-f]{64}$/.test(value.capability)&&typeof value.queryHash==='string'&&/^[0-9a-f]{64}$/.test(value.queryHash)&&['sessionId','taskId','ownerId','attemptId','requestId'].every(k=>typeof value[k]==='string'&&/^[A-Za-z0-9._:-]{1,128}$/.test(value[k]))&&Array.isArray(value.paths)&&value.paths.length<=BROKER_LIMITS.maxCandidates&&value.paths.every((p:any)=>typeof p==='string'&&p.length<=1024&&p.length>0&&!/[\\\x00-\x1f\x7f]/.test(p)&&!p.startsWith('/')&&p.split('/').every((s:string)=>s&&s!=='.'&&s!=='..'))&&record(value.discovery)&&Object.keys(value.discovery).every(k=>['complete','reason'].includes(k))&&typeof value.discovery.complete==='boolean'&&(value.discovery.reason===undefined||['candidate_limit','deadline','truncated','unavailable'].includes(value.discovery.reason));
29
30
  }
30
31
  export async function createDiscoveryBroker(options:{root:string;runtime:DiscoveryRuntime;owners:DiscoveryOwners;publish?(result:DiscoveryResult,lease:OwnerLease):unknown;limits?:Partial<Record<keyof typeof BROKER_LIMITS,number>>}) {
31
32
  if(process.platform==='win32')throw Error('unsupported_platform');
@@ -74,6 +75,8 @@ export async function createDiscoveryBroker(options:{root:string;runtime:Discove
74
75
  }
75
76
  // Registry supplies query/cwd/effective permissions. Reject unknown/cross-scope identities BEFORE any source collection, including cache hits.
76
77
  const paths=[...new Set(request.paths)];
78
+ const foreground=request.foreground===true&&paths.length===1&&options.runtime.semanticEnabled;
79
+ if(request.foreground&&!foreground){reply({ok:false,error:'consumer_off'});return;}
77
80
  if(paths.some(p=>!options.owners.allows(owner,p,false))){reply({ok:false,error:'source_denied'});return;}
78
81
  const canonical=paths.map(p=>relative(root,resolve(owner.cwd,p)).split('\\').join('/'));
79
82
  if(canonical.some(p=>isAbsolute(p)||p==='..'||p.startsWith('../')||!p)){reply({ok:false,error:'source_denied'});return;}
@@ -82,10 +85,10 @@ export async function createDiscoveryBroker(options:{root:string;runtime:Discove
82
85
  revoke=()=>{if(!controller.signal.aborted){abort();reply({ok:false,error:'revoked'});}};owner.signal.addEventListener('abort',revoke,{once:true});if(owner.signal.aborted)revoke();
83
86
  if(controller.signal.aborted)return;
84
87
  rankRequest=request;
85
- requestTimer=setTimeout(()=>{if(!controller.signal.aborted){abort(DISCOVERY_DEADLINE);reply({ok:false,error:'deadline'});}},limits.requestMs);
88
+ requestTimer=setTimeout(()=>{if(!controller.signal.aborted){abort(DISCOVERY_DEADLINE);reply({ok:false,error:'deadline'});}},foreground?Math.min(FOREGROUND_MS,limits.requestMs):limits.requestMs);
86
89
  // A child's immutable bound query survives same-task Hub followups. Authority
87
90
  // and permission checks still fence every job before reads and after awaits.
88
- void options.runtime.rank({owner:owner.ownerId,attempt:owner.attemptId,trigger:'native',task:owner.task,query:owner.query,context:()=>options.owners.current(owner)?owner.taskId+':'+owner.queryHash:'revoked',paths:canonical,discoveryComplete:request.discovery.complete,signal:controller.signal,permissionIdentity:permission,canDisplay:p=>options.owners.allows(owner,fromWorkspace(p),false),canRead:p=>options.owners.allows(owner,fromWorkspace(p),true)}).then(result=>{
91
+ void options.runtime.rank({owner:owner.ownerId,attempt:owner.attemptId,trigger:'native',foreground,task:owner.task,query:owner.query,context:()=>options.owners.current(owner)?owner.taskId+':'+owner.queryHash:'revoked',paths:canonical,discoveryComplete:request.discovery.complete,signal:controller.signal,permissionIdentity:permission,canDisplay:p=>options.owners.allows(owner,fromWorkspace(p),false),canRead:p=>options.owners.allows(owner,fromWorkspace(p),true)}).then(result=>{
89
92
  if(controller.signal.aborted){reply({ok:false,error:isDiscoveryDeadline(controller.signal.reason)?'deadline':'revoked'});return;}
90
93
  if(!options.owners.current(owner)){reply({ok:false,error:'revoked'});return;}
91
94
  reply({ok:true,result:options.publish?.(result,owner)??result});
@@ -95,7 +98,7 @@ export async function createDiscoveryBroker(options:{root:string;runtime:Discove
95
98
  bytes+=chunk.length;if(bytes>limits.frameBytes){rejectFrame();return;}
96
99
  // The combined rank + optional terminal input retains the original byte cap.
97
100
  if(handled&&!buffer.length){clearTimeout(timer);timer=setTimeout(rejectFrame,limits.partialFrameMs);}
98
- buffer=Buffer.concat([buffer,chunk]);const newline=buffer.indexOf(10);if(newline<0)return;
101
+ buffer=Buffer.concat([buffer,typeof chunk==='string'?Buffer.from(chunk):chunk]);const newline=buffer.indexOf(10);if(newline<0)return;
99
102
  let value:unknown;try{value=decode(buffer.subarray(0,newline));}catch{if(handled)rejectFrame();else reply({ok:false,error:'malformed_request'});return;}
100
103
  buffer=buffer.subarray(newline+1);
101
104
  if(handled){if(buffer.length)rejectFrame();else terminal(value);return;}