@nubl/maestro 0.0.1 → 0.1.1

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 (398) hide show
  1. package/README.md +56 -2
  2. package/dist/config.json.example +30 -0
  3. package/dist/maestro/adapters/fake/fake-harness-adapter.d.ts +24 -0
  4. package/dist/maestro/adapters/fake/fake-harness-adapter.d.ts.map +1 -0
  5. package/dist/maestro/adapters/fake/fake-harness-adapter.js +210 -0
  6. package/dist/maestro/adapters/fake/fake-harness-adapter.js.map +1 -0
  7. package/dist/maestro/adapters/pi/accept-groups.d.ts +35 -0
  8. package/dist/maestro/adapters/pi/accept-groups.d.ts.map +1 -0
  9. package/dist/maestro/adapters/pi/accept-groups.js +70 -0
  10. package/dist/maestro/adapters/pi/accept-groups.js.map +1 -0
  11. package/dist/maestro/adapters/pi/accept-runner.d.ts +37 -0
  12. package/dist/maestro/adapters/pi/accept-runner.d.ts.map +1 -0
  13. package/dist/maestro/adapters/pi/accept-runner.js +161 -0
  14. package/dist/maestro/adapters/pi/accept-runner.js.map +1 -0
  15. package/dist/maestro/adapters/pi/activity-file.d.ts +39 -0
  16. package/dist/maestro/adapters/pi/activity-file.d.ts.map +1 -0
  17. package/dist/maestro/adapters/pi/activity-file.js +454 -0
  18. package/dist/maestro/adapters/pi/activity-file.js.map +1 -0
  19. package/dist/maestro/adapters/pi/child/accept-check.d.ts +24 -0
  20. package/dist/maestro/adapters/pi/child/accept-check.d.ts.map +1 -0
  21. package/dist/maestro/adapters/pi/child/accept-check.js +82 -0
  22. package/dist/maestro/adapters/pi/child/accept-check.js.map +1 -0
  23. package/dist/maestro/adapters/pi/child/declared-skills.d.ts +51 -0
  24. package/dist/maestro/adapters/pi/child/declared-skills.d.ts.map +1 -0
  25. package/dist/maestro/adapters/pi/child/declared-skills.js +148 -0
  26. package/dist/maestro/adapters/pi/child/declared-skills.js.map +1 -0
  27. package/dist/maestro/adapters/pi/child/done-nudge.d.ts +38 -0
  28. package/dist/maestro/adapters/pi/child/done-nudge.d.ts.map +1 -0
  29. package/dist/maestro/adapters/pi/child/done-nudge.js +77 -0
  30. package/dist/maestro/adapters/pi/child/done-nudge.js.map +1 -0
  31. package/dist/maestro/adapters/pi/child/entry.d.ts +3 -0
  32. package/dist/maestro/adapters/pi/child/entry.d.ts.map +1 -0
  33. package/dist/maestro/adapters/pi/child/entry.js +3 -0
  34. package/dist/maestro/adapters/pi/child/entry.js.map +1 -0
  35. package/dist/maestro/adapters/pi/child/protocol.d.ts +56 -0
  36. package/dist/maestro/adapters/pi/child/protocol.d.ts.map +1 -0
  37. package/dist/maestro/adapters/pi/child/protocol.js +510 -0
  38. package/dist/maestro/adapters/pi/child/protocol.js.map +1 -0
  39. package/dist/maestro/adapters/pi/completion.d.ts +45 -0
  40. package/dist/maestro/adapters/pi/completion.d.ts.map +1 -0
  41. package/dist/maestro/adapters/pi/completion.js +295 -0
  42. package/dist/maestro/adapters/pi/completion.js.map +1 -0
  43. package/dist/maestro/adapters/pi/launch-command.d.ts +27 -0
  44. package/dist/maestro/adapters/pi/launch-command.d.ts.map +1 -0
  45. package/dist/maestro/adapters/pi/launch-command.js +75 -0
  46. package/dist/maestro/adapters/pi/launch-command.js.map +1 -0
  47. package/dist/maestro/adapters/pi/launch-operations.d.ts +78 -0
  48. package/dist/maestro/adapters/pi/launch-operations.d.ts.map +1 -0
  49. package/dist/maestro/adapters/pi/launch-operations.js +270 -0
  50. package/dist/maestro/adapters/pi/launch-operations.js.map +1 -0
  51. package/dist/maestro/adapters/pi/launch-resume.d.ts +4 -0
  52. package/dist/maestro/adapters/pi/launch-resume.d.ts.map +1 -0
  53. package/dist/maestro/adapters/pi/launch-resume.js +183 -0
  54. package/dist/maestro/adapters/pi/launch-resume.js.map +1 -0
  55. package/dist/maestro/adapters/pi/launch.d.ts +148 -0
  56. package/dist/maestro/adapters/pi/launch.d.ts.map +1 -0
  57. package/dist/maestro/adapters/pi/launch.js +655 -0
  58. package/dist/maestro/adapters/pi/launch.js.map +1 -0
  59. package/dist/maestro/adapters/pi/model-registry.d.ts +3 -0
  60. package/dist/maestro/adapters/pi/model-registry.d.ts.map +1 -0
  61. package/dist/maestro/adapters/pi/model-registry.js +29 -0
  62. package/dist/maestro/adapters/pi/model-registry.js.map +1 -0
  63. package/dist/maestro/adapters/pi/pi-harness-adapter.d.ts +95 -0
  64. package/dist/maestro/adapters/pi/pi-harness-adapter.d.ts.map +1 -0
  65. package/dist/maestro/adapters/pi/pi-harness-adapter.js +549 -0
  66. package/dist/maestro/adapters/pi/pi-harness-adapter.js.map +1 -0
  67. package/dist/maestro/adapters/pi/process-identity.d.ts +92 -0
  68. package/dist/maestro/adapters/pi/process-identity.d.ts.map +1 -0
  69. package/dist/maestro/adapters/pi/process-identity.js +248 -0
  70. package/dist/maestro/adapters/pi/process-identity.js.map +1 -0
  71. package/dist/maestro/adapters/pi/process-tree.d.ts +48 -0
  72. package/dist/maestro/adapters/pi/process-tree.d.ts.map +1 -0
  73. package/dist/maestro/adapters/pi/process-tree.js +69 -0
  74. package/dist/maestro/adapters/pi/process-tree.js.map +1 -0
  75. package/dist/maestro/adapters/pi/script-shell.d.ts +40 -0
  76. package/dist/maestro/adapters/pi/script-shell.d.ts.map +1 -0
  77. package/dist/maestro/adapters/pi/script-shell.js +43 -0
  78. package/dist/maestro/adapters/pi/script-shell.js.map +1 -0
  79. package/dist/maestro/adapters/pi/session.d.ts +207 -0
  80. package/dist/maestro/adapters/pi/session.d.ts.map +1 -0
  81. package/dist/maestro/adapters/pi/session.js +714 -0
  82. package/dist/maestro/adapters/pi/session.js.map +1 -0
  83. package/dist/maestro/adapters/pi/task-model-init.d.ts +4 -0
  84. package/dist/maestro/adapters/pi/task-model-init.d.ts.map +1 -0
  85. package/dist/maestro/adapters/pi/task-model-init.js +47 -0
  86. package/dist/maestro/adapters/pi/task-model-init.js.map +1 -0
  87. package/dist/maestro/core/accept.d.ts +150 -0
  88. package/dist/maestro/core/accept.d.ts.map +1 -0
  89. package/dist/maestro/core/accept.js +243 -0
  90. package/dist/maestro/core/accept.js.map +1 -0
  91. package/dist/maestro/core/activity.d.ts +4 -0
  92. package/dist/maestro/core/activity.d.ts.map +1 -0
  93. package/dist/maestro/core/activity.js +18 -0
  94. package/dist/maestro/core/activity.js.map +1 -0
  95. package/dist/maestro/core/child-busy.d.ts +14 -0
  96. package/dist/maestro/core/child-busy.d.ts.map +1 -0
  97. package/dist/maestro/core/child-busy.js +14 -0
  98. package/dist/maestro/core/child-busy.js.map +1 -0
  99. package/dist/maestro/core/config/guidelines-config.d.ts +8 -0
  100. package/dist/maestro/core/config/guidelines-config.d.ts.map +1 -0
  101. package/dist/maestro/core/config/guidelines-config.js +60 -0
  102. package/dist/maestro/core/config/guidelines-config.js.map +1 -0
  103. package/dist/maestro/core/config/herdr-config.d.ts +13 -0
  104. package/dist/maestro/core/config/herdr-config.d.ts.map +1 -0
  105. package/dist/maestro/core/config/herdr-config.js +65 -0
  106. package/dist/maestro/core/config/herdr-config.js.map +1 -0
  107. package/dist/maestro/core/config/model-config.d.ts +92 -0
  108. package/dist/maestro/core/config/model-config.d.ts.map +1 -0
  109. package/dist/maestro/core/config/model-config.js +522 -0
  110. package/dist/maestro/core/config/model-config.js.map +1 -0
  111. package/dist/maestro/core/config/outcome-ledger-config.d.ts +8 -0
  112. package/dist/maestro/core/config/outcome-ledger-config.d.ts.map +1 -0
  113. package/dist/maestro/core/config/outcome-ledger-config.js +49 -0
  114. package/dist/maestro/core/config/outcome-ledger-config.js.map +1 -0
  115. package/dist/maestro/core/config/pane-config.d.ts +15 -0
  116. package/dist/maestro/core/config/pane-config.d.ts.map +1 -0
  117. package/dist/maestro/core/config/pane-config.js +101 -0
  118. package/dist/maestro/core/config/pane-config.js.map +1 -0
  119. package/dist/maestro/core/config/persistent-config.d.ts +7 -0
  120. package/dist/maestro/core/config/persistent-config.d.ts.map +1 -0
  121. package/dist/maestro/core/config/persistent-config.js +72 -0
  122. package/dist/maestro/core/config/persistent-config.js.map +1 -0
  123. package/dist/maestro/core/config/role-config.d.ts +7 -0
  124. package/dist/maestro/core/config/role-config.d.ts.map +1 -0
  125. package/dist/maestro/core/config/role-config.js +74 -0
  126. package/dist/maestro/core/config/role-config.js.map +1 -0
  127. package/dist/maestro/core/config/spawning-config.d.ts +7 -0
  128. package/dist/maestro/core/config/spawning-config.d.ts.map +1 -0
  129. package/dist/maestro/core/config/spawning-config.js +65 -0
  130. package/dist/maestro/core/config/spawning-config.js.map +1 -0
  131. package/dist/maestro/core/config/supervision-config.d.ts +7 -0
  132. package/dist/maestro/core/config/supervision-config.d.ts.map +1 -0
  133. package/dist/maestro/core/config/supervision-config.js +69 -0
  134. package/dist/maestro/core/config/supervision-config.js.map +1 -0
  135. package/dist/maestro/core/config/task-model-init.d.ts +118 -0
  136. package/dist/maestro/core/config/task-model-init.d.ts.map +1 -0
  137. package/dist/maestro/core/config/task-model-init.js +168 -0
  138. package/dist/maestro/core/config/task-model-init.js.map +1 -0
  139. package/dist/maestro/core/config/task-model-types.d.ts +36 -0
  140. package/dist/maestro/core/config/task-model-types.d.ts.map +1 -0
  141. package/dist/maestro/core/config/task-model-types.js +17 -0
  142. package/dist/maestro/core/config/task-model-types.js.map +1 -0
  143. package/dist/maestro/core/config/type-guards.d.ts +22 -0
  144. package/dist/maestro/core/config/type-guards.d.ts.map +1 -0
  145. package/dist/maestro/core/config/type-guards.js +31 -0
  146. package/dist/maestro/core/config/type-guards.js.map +1 -0
  147. package/dist/maestro/core/deadline.d.ts +11 -0
  148. package/dist/maestro/core/deadline.d.ts.map +1 -0
  149. package/dist/maestro/core/deadline.js +30 -0
  150. package/dist/maestro/core/deadline.js.map +1 -0
  151. package/dist/maestro/core/declared-skills.d.ts +16 -0
  152. package/dist/maestro/core/declared-skills.d.ts.map +1 -0
  153. package/dist/maestro/core/declared-skills.js +52 -0
  154. package/dist/maestro/core/declared-skills.js.map +1 -0
  155. package/dist/maestro/core/delegation-depth.d.ts +38 -0
  156. package/dist/maestro/core/delegation-depth.d.ts.map +1 -0
  157. package/dist/maestro/core/delegation-depth.js +59 -0
  158. package/dist/maestro/core/delegation-depth.js.map +1 -0
  159. package/dist/maestro/core/git-environment.d.ts +3 -0
  160. package/dist/maestro/core/git-environment.d.ts.map +1 -0
  161. package/dist/maestro/core/git-environment.js +29 -0
  162. package/dist/maestro/core/git-environment.js.map +1 -0
  163. package/dist/maestro/core/harness-adapter.d.ts +89 -0
  164. package/dist/maestro/core/harness-adapter.d.ts.map +1 -0
  165. package/dist/maestro/core/harness-adapter.js +2 -0
  166. package/dist/maestro/core/harness-adapter.js.map +1 -0
  167. package/dist/maestro/core/host-text.d.ts +49 -0
  168. package/dist/maestro/core/host-text.d.ts.map +1 -0
  169. package/dist/maestro/core/host-text.js +106 -0
  170. package/dist/maestro/core/host-text.js.map +1 -0
  171. package/dist/maestro/core/index.d.ts +4 -0
  172. package/dist/maestro/core/index.d.ts.map +1 -0
  173. package/dist/maestro/core/index.js +2 -0
  174. package/dist/maestro/core/index.js.map +1 -0
  175. package/dist/maestro/core/lifecycle.d.ts +16 -0
  176. package/dist/maestro/core/lifecycle.d.ts.map +1 -0
  177. package/dist/maestro/core/lifecycle.js +429 -0
  178. package/dist/maestro/core/lifecycle.js.map +1 -0
  179. package/dist/maestro/core/opened-primary-workspace.d.ts +31 -0
  180. package/dist/maestro/core/opened-primary-workspace.d.ts.map +1 -0
  181. package/dist/maestro/core/opened-primary-workspace.js +49 -0
  182. package/dist/maestro/core/opened-primary-workspace.js.map +1 -0
  183. package/dist/maestro/core/platform-support.d.ts +15 -0
  184. package/dist/maestro/core/platform-support.d.ts.map +1 -0
  185. package/dist/maestro/core/platform-support.js +23 -0
  186. package/dist/maestro/core/platform-support.js.map +1 -0
  187. package/dist/maestro/core/realpath-without-opening.d.ts +9 -0
  188. package/dist/maestro/core/realpath-without-opening.d.ts.map +1 -0
  189. package/dist/maestro/core/realpath-without-opening.js +45 -0
  190. package/dist/maestro/core/realpath-without-opening.js.map +1 -0
  191. package/dist/maestro/core/roles/discovery.d.ts +64 -0
  192. package/dist/maestro/core/roles/discovery.d.ts.map +1 -0
  193. package/dist/maestro/core/roles/discovery.js +422 -0
  194. package/dist/maestro/core/roles/discovery.js.map +1 -0
  195. package/dist/maestro/core/routing.d.ts +115 -0
  196. package/dist/maestro/core/routing.d.ts.map +1 -0
  197. package/dist/maestro/core/routing.js +449 -0
  198. package/dist/maestro/core/routing.js.map +1 -0
  199. package/dist/maestro/core/script-launch.d.ts +47 -0
  200. package/dist/maestro/core/script-launch.d.ts.map +1 -0
  201. package/dist/maestro/core/script-launch.js +102 -0
  202. package/dist/maestro/core/script-launch.js.map +1 -0
  203. package/dist/maestro/core/shell.d.ts +2 -0
  204. package/dist/maestro/core/shell.d.ts.map +1 -0
  205. package/dist/maestro/core/shell.js +4 -0
  206. package/dist/maestro/core/shell.js.map +1 -0
  207. package/dist/maestro/core/specialist-notice.d.ts +36 -0
  208. package/dist/maestro/core/specialist-notice.d.ts.map +1 -0
  209. package/dist/maestro/core/specialist-notice.js +41 -0
  210. package/dist/maestro/core/specialist-notice.js.map +1 -0
  211. package/dist/maestro/core/status.d.ts +87 -0
  212. package/dist/maestro/core/status.d.ts.map +1 -0
  213. package/dist/maestro/core/status.js +369 -0
  214. package/dist/maestro/core/status.js.map +1 -0
  215. package/dist/maestro/core/supervision.d.ts +56 -0
  216. package/dist/maestro/core/supervision.d.ts.map +1 -0
  217. package/dist/maestro/core/supervision.js +249 -0
  218. package/dist/maestro/core/supervision.js.map +1 -0
  219. package/dist/maestro/core/surface-provider.d.ts +200 -0
  220. package/dist/maestro/core/surface-provider.d.ts.map +1 -0
  221. package/dist/maestro/core/surface-provider.js +71 -0
  222. package/dist/maestro/core/surface-provider.js.map +1 -0
  223. package/dist/maestro/core/types.d.ts +388 -0
  224. package/dist/maestro/core/types.d.ts.map +1 -0
  225. package/dist/maestro/core/types.js +2 -0
  226. package/dist/maestro/core/types.js.map +1 -0
  227. package/dist/maestro/core/undelivered-children.d.ts +27 -0
  228. package/dist/maestro/core/undelivered-children.d.ts.map +1 -0
  229. package/dist/maestro/core/undelivered-children.js +31 -0
  230. package/dist/maestro/core/undelivered-children.js.map +1 -0
  231. package/dist/maestro/core/wake.d.ts +32 -0
  232. package/dist/maestro/core/wake.d.ts.map +1 -0
  233. package/dist/maestro/core/wake.js +125 -0
  234. package/dist/maestro/core/wake.js.map +1 -0
  235. package/dist/maestro/core/worktree-cleanup.d.ts +75 -0
  236. package/dist/maestro/core/worktree-cleanup.d.ts.map +1 -0
  237. package/dist/maestro/core/worktree-cleanup.js +278 -0
  238. package/dist/maestro/core/worktree-cleanup.js.map +1 -0
  239. package/dist/maestro/core/worktree.d.ts +50 -0
  240. package/dist/maestro/core/worktree.d.ts.map +1 -0
  241. package/dist/maestro/core/worktree.js +23 -0
  242. package/dist/maestro/core/worktree.js.map +1 -0
  243. package/dist/maestro/engine.d.ts +5 -0
  244. package/dist/maestro/engine.d.ts.map +1 -0
  245. package/dist/maestro/engine.js +5 -0
  246. package/dist/maestro/engine.js.map +1 -0
  247. package/dist/maestro/pi/child.d.ts +8 -0
  248. package/dist/maestro/pi/child.d.ts.map +1 -0
  249. package/dist/maestro/pi/child.js +8 -0
  250. package/dist/maestro/pi/child.js.map +1 -0
  251. package/dist/maestro/pi/extension.d.ts +10 -0
  252. package/dist/maestro/pi/extension.d.ts.map +1 -0
  253. package/dist/maestro/pi/extension.js +8 -0
  254. package/dist/maestro/pi/extension.js.map +1 -0
  255. package/dist/maestro/pi/subagents-index.d.ts +9 -0
  256. package/dist/maestro/pi/subagents-index.d.ts.map +1 -0
  257. package/dist/maestro/pi/subagents-index.js +9 -0
  258. package/dist/maestro/pi/subagents-index.js.map +1 -0
  259. package/dist/maestro/pi.d.ts +9 -0
  260. package/dist/maestro/pi.d.ts.map +1 -0
  261. package/dist/maestro/pi.js +7 -0
  262. package/dist/maestro/pi.js.map +1 -0
  263. package/dist/maestro/runtime/accept-recheck.d.ts +32 -0
  264. package/dist/maestro/runtime/accept-recheck.d.ts.map +1 -0
  265. package/dist/maestro/runtime/accept-recheck.js +92 -0
  266. package/dist/maestro/runtime/accept-recheck.js.map +1 -0
  267. package/dist/maestro/runtime/delegated-marker.d.ts +112 -0
  268. package/dist/maestro/runtime/delegated-marker.d.ts.map +1 -0
  269. package/dist/maestro/runtime/delegated-marker.js +200 -0
  270. package/dist/maestro/runtime/delegated-marker.js.map +1 -0
  271. package/dist/maestro/runtime/host-surface-binding.d.ts +25 -0
  272. package/dist/maestro/runtime/host-surface-binding.d.ts.map +1 -0
  273. package/dist/maestro/runtime/host-surface-binding.js +2 -0
  274. package/dist/maestro/runtime/host-surface-binding.js.map +1 -0
  275. package/dist/maestro/runtime/index.d.ts +10 -0
  276. package/dist/maestro/runtime/index.d.ts.map +1 -0
  277. package/dist/maestro/runtime/index.js +6 -0
  278. package/dist/maestro/runtime/index.js.map +1 -0
  279. package/dist/maestro/runtime/pi-persistent-io.d.ts +7 -0
  280. package/dist/maestro/runtime/pi-persistent-io.d.ts.map +1 -0
  281. package/dist/maestro/runtime/pi-persistent-io.js +64 -0
  282. package/dist/maestro/runtime/pi-persistent-io.js.map +1 -0
  283. package/dist/maestro/runtime/pi-run-session-types.d.ts +328 -0
  284. package/dist/maestro/runtime/pi-run-session-types.d.ts.map +1 -0
  285. package/dist/maestro/runtime/pi-run-session-types.js +2 -0
  286. package/dist/maestro/runtime/pi-run-session-types.js.map +1 -0
  287. package/dist/maestro/runtime/pi-run-session.d.ts +12 -0
  288. package/dist/maestro/runtime/pi-run-session.d.ts.map +1 -0
  289. package/dist/maestro/runtime/pi-run-session.js +809 -0
  290. package/dist/maestro/runtime/pi-run-session.js.map +1 -0
  291. package/dist/maestro/runtime/run-session.d.ts +129 -0
  292. package/dist/maestro/runtime/run-session.d.ts.map +1 -0
  293. package/dist/maestro/runtime/run-session.js +680 -0
  294. package/dist/maestro/runtime/run-session.js.map +1 -0
  295. package/dist/maestro/runtime/surface-retention.d.ts +3 -0
  296. package/dist/maestro/runtime/surface-retention.d.ts.map +1 -0
  297. package/dist/maestro/runtime/surface-retention.js +5 -0
  298. package/dist/maestro/runtime/surface-retention.js.map +1 -0
  299. package/dist/maestro/runtime/task-model-init.d.ts +34 -0
  300. package/dist/maestro/runtime/task-model-init.d.ts.map +1 -0
  301. package/dist/maestro/runtime/task-model-init.js +78 -0
  302. package/dist/maestro/runtime/task-model-init.js.map +1 -0
  303. package/dist/maestro/runtime/worktree-operations.d.ts +31 -0
  304. package/dist/maestro/runtime/worktree-operations.d.ts.map +1 -0
  305. package/dist/maestro/runtime/worktree-operations.js +633 -0
  306. package/dist/maestro/runtime/worktree-operations.js.map +1 -0
  307. package/dist/maestro/surfaces/fake/fake-surface-provider.d.ts +54 -0
  308. package/dist/maestro/surfaces/fake/fake-surface-provider.d.ts.map +1 -0
  309. package/dist/maestro/surfaces/fake/fake-surface-provider.js +231 -0
  310. package/dist/maestro/surfaces/fake/fake-surface-provider.js.map +1 -0
  311. package/dist/maestro/testing/harness-adapter.conformance.d.ts +31 -0
  312. package/dist/maestro/testing/harness-adapter.conformance.d.ts.map +1 -0
  313. package/dist/maestro/testing/harness-adapter.conformance.js +181 -0
  314. package/dist/maestro/testing/harness-adapter.conformance.js.map +1 -0
  315. package/dist/maestro/testing/index.d.ts +5 -0
  316. package/dist/maestro/testing/index.d.ts.map +1 -0
  317. package/dist/maestro/testing/index.js +5 -0
  318. package/dist/maestro/testing/index.js.map +1 -0
  319. package/dist/maestro/testing/surface-provider.conformance.d.ts +20 -0
  320. package/dist/maestro/testing/surface-provider.conformance.d.ts.map +1 -0
  321. package/dist/maestro/testing/surface-provider.conformance.js +167 -0
  322. package/dist/maestro/testing/surface-provider.conformance.js.map +1 -0
  323. package/dist/pi-extension/subagents/catalog.d.ts +70 -0
  324. package/dist/pi-extension/subagents/catalog.d.ts.map +1 -0
  325. package/dist/pi-extension/subagents/catalog.js +231 -0
  326. package/dist/pi-extension/subagents/catalog.js.map +1 -0
  327. package/dist/pi-extension/subagents/config-path.d.ts +6 -0
  328. package/dist/pi-extension/subagents/config-path.d.ts.map +1 -0
  329. package/dist/pi-extension/subagents/config-path.js +21 -0
  330. package/dist/pi-extension/subagents/config-path.js.map +1 -0
  331. package/dist/pi-extension/subagents/control-tools.d.ts +21 -0
  332. package/dist/pi-extension/subagents/control-tools.d.ts.map +1 -0
  333. package/dist/pi-extension/subagents/control-tools.js +150 -0
  334. package/dist/pi-extension/subagents/control-tools.js.map +1 -0
  335. package/dist/pi-extension/subagents/controls.d.ts +52 -0
  336. package/dist/pi-extension/subagents/controls.d.ts.map +1 -0
  337. package/dist/pi-extension/subagents/controls.js +173 -0
  338. package/dist/pi-extension/subagents/controls.js.map +1 -0
  339. package/dist/pi-extension/subagents/deferred-tools.d.ts +43 -0
  340. package/dist/pi-extension/subagents/deferred-tools.d.ts.map +1 -0
  341. package/dist/pi-extension/subagents/deferred-tools.js +67 -0
  342. package/dist/pi-extension/subagents/deferred-tools.js.map +1 -0
  343. package/dist/pi-extension/subagents/delivery.d.ts +22 -0
  344. package/dist/pi-extension/subagents/delivery.d.ts.map +1 -0
  345. package/dist/pi-extension/subagents/delivery.js +365 -0
  346. package/dist/pi-extension/subagents/delivery.js.map +1 -0
  347. package/dist/pi-extension/subagents/extension.d.ts +100 -0
  348. package/dist/pi-extension/subagents/extension.d.ts.map +1 -0
  349. package/dist/pi-extension/subagents/extension.js +367 -0
  350. package/dist/pi-extension/subagents/extension.js.map +1 -0
  351. package/dist/pi-extension/subagents/launch-tools.d.ts +33 -0
  352. package/dist/pi-extension/subagents/launch-tools.d.ts.map +1 -0
  353. package/dist/pi-extension/subagents/launch-tools.js +373 -0
  354. package/dist/pi-extension/subagents/launch-tools.js.map +1 -0
  355. package/dist/pi-extension/subagents/launch.d.ts +86 -0
  356. package/dist/pi-extension/subagents/launch.d.ts.map +1 -0
  357. package/dist/pi-extension/subagents/launch.js +133 -0
  358. package/dist/pi-extension/subagents/launch.js.map +1 -0
  359. package/dist/pi-extension/subagents/model-registry.d.ts +13 -0
  360. package/dist/pi-extension/subagents/model-registry.d.ts.map +1 -0
  361. package/dist/pi-extension/subagents/model-registry.js +52 -0
  362. package/dist/pi-extension/subagents/model-registry.js.map +1 -0
  363. package/dist/pi-extension/subagents/observation.d.ts +38 -0
  364. package/dist/pi-extension/subagents/observation.d.ts.map +1 -0
  365. package/dist/pi-extension/subagents/observation.js +168 -0
  366. package/dist/pi-extension/subagents/observation.js.map +1 -0
  367. package/dist/pi-extension/subagents/persistent.d.ts +72 -0
  368. package/dist/pi-extension/subagents/persistent.d.ts.map +1 -0
  369. package/dist/pi-extension/subagents/persistent.js +322 -0
  370. package/dist/pi-extension/subagents/persistent.js.map +1 -0
  371. package/dist/pi-extension/subagents/presentation-hooks.d.ts +25 -0
  372. package/dist/pi-extension/subagents/presentation-hooks.d.ts.map +1 -0
  373. package/dist/pi-extension/subagents/presentation-hooks.js +2 -0
  374. package/dist/pi-extension/subagents/presentation-hooks.js.map +1 -0
  375. package/dist/pi-extension/subagents/presentation.d.ts +149 -0
  376. package/dist/pi-extension/subagents/presentation.d.ts.map +1 -0
  377. package/dist/pi-extension/subagents/presentation.js +419 -0
  378. package/dist/pi-extension/subagents/presentation.js.map +1 -0
  379. package/dist/pi-extension/subagents/state.d.ts +183 -0
  380. package/dist/pi-extension/subagents/state.d.ts.map +1 -0
  381. package/dist/pi-extension/subagents/state.js +92 -0
  382. package/dist/pi-extension/subagents/state.js.map +1 -0
  383. package/dist/pi-extension/subagents/task-models.d.ts +9 -0
  384. package/dist/pi-extension/subagents/task-models.d.ts.map +1 -0
  385. package/dist/pi-extension/subagents/task-models.js +293 -0
  386. package/dist/pi-extension/subagents/task-models.js.map +1 -0
  387. package/dist/pi-extension/subagents/tool-boundary.d.ts +16 -0
  388. package/dist/pi-extension/subagents/tool-boundary.d.ts.map +1 -0
  389. package/dist/pi-extension/subagents/tool-boundary.js +53 -0
  390. package/dist/pi-extension/subagents/tool-boundary.js.map +1 -0
  391. package/dist/pi-extension/subagents/worktree-tools.d.ts +16 -0
  392. package/dist/pi-extension/subagents/worktree-tools.d.ts.map +1 -0
  393. package/dist/pi-extension/subagents/worktree-tools.js +185 -0
  394. package/dist/pi-extension/subagents/worktree-tools.js.map +1 -0
  395. package/dist/provenance.json +5 -0
  396. package/package.json +540 -27
  397. package/index.d.ts +0 -1
  398. package/index.js +0 -2
@@ -0,0 +1,522 @@
1
+ import { createHash, randomUUID } from "node:crypto";
2
+ import { closeSync, mkdirSync, openSync, readFileSync, renameSync, rmSync, unlinkSync, writeFileSync, writeSync, } from "node:fs";
3
+ import { hostname } from "node:os";
4
+ import { basename, dirname, join, resolve } from "node:path";
5
+ import { realpathWithoutOpening } from "../realpath-without-opening.js";
6
+ import { isPlainObject, isRecord, isString, } from "./type-guards.js";
7
+ import { isThinkingLevel, THINKING_LEVELS } from "../routing.js";
8
+ import { TASK_CATEGORIES, } from "./task-model-types.js";
9
+ function invalidModelConfig(source, message) {
10
+ throw new Error(`Invalid subagent model config in ${source}: ${message}`);
11
+ }
12
+ function rejectTaskReference(value, field, source) {
13
+ if (value.trim().toLowerCase().startsWith("task:")) {
14
+ invalidModelConfig(source, `${field} cannot use task: references; task: references are only valid in the subagent tool's model parameter`);
15
+ }
16
+ }
17
+ function parseTasks(value, source) {
18
+ if (value == null)
19
+ return undefined;
20
+ if (!isPlainObject(value))
21
+ invalidModelConfig(source, "models.tasks must be an object");
22
+ const keys = Object.keys(value);
23
+ if (keys.length === 0)
24
+ return undefined;
25
+ const unsupported = keys.filter(
26
+ // SAFETY: this check only compares strings against the fixed category set.
27
+ (key) => !TASK_CATEGORIES.includes(key));
28
+ if (unsupported.length > 0) {
29
+ invalidModelConfig(source, `models.tasks.${unsupported[0]} is unsupported; supported categories: ${TASK_CATEGORIES.join(", ")}`);
30
+ }
31
+ const tasks = {};
32
+ for (const category of TASK_CATEGORIES) {
33
+ if (!Object.hasOwn(value, category))
34
+ continue;
35
+ const candidates = value[category];
36
+ if (!Array.isArray(candidates) || candidates.length === 0) {
37
+ invalidModelConfig(source, `models.tasks.${category} must be a non-empty list`);
38
+ }
39
+ const seen = new Set();
40
+ tasks[category] = candidates.map((candidate, index) => {
41
+ if (!isString(candidate) || candidate.trim() === "") {
42
+ invalidModelConfig(source, `models.tasks.${category}[${index}] must be a non-empty string`);
43
+ }
44
+ const reference = candidate.trim();
45
+ if (seen.has(reference)) {
46
+ invalidModelConfig(source, `models.tasks.${category} has duplicate candidate ${JSON.stringify(reference)}`);
47
+ }
48
+ seen.add(reference);
49
+ return reference;
50
+ });
51
+ }
52
+ return tasks;
53
+ }
54
+ function parseTasksThinking(value, source) {
55
+ if (value == null)
56
+ return undefined;
57
+ if (!isPlainObject(value))
58
+ invalidModelConfig(source, "models.tasksThinking must be an object");
59
+ const thinking = {};
60
+ for (const [category, level] of Object.entries(value)) {
61
+ // SAFETY: category membership is checked before indexing the typed map.
62
+ if (!TASK_CATEGORIES.includes(category))
63
+ invalidModelConfig(source, `models.tasksThinking.${category} is unsupported; supported categories: ${TASK_CATEGORIES.join(", ")}`);
64
+ if (!isString(level) || !isThinkingLevel(level))
65
+ invalidModelConfig(source, `models.tasksThinking.${category} must be one of: ${THINKING_LEVELS.join(", ")}`);
66
+ // SAFETY: the fixed category check above rejects unknown keys.
67
+ thinking[category] = level;
68
+ }
69
+ return thinking;
70
+ }
71
+ function parseTasksMeta(value, source) {
72
+ if (value == null)
73
+ return undefined;
74
+ if (!isPlainObject(value))
75
+ invalidModelConfig(source, "models.tasksMeta must be an object");
76
+ const unsupported = Object.keys(value).filter((key) => key !== "generatedAt" && key !== "method");
77
+ if (unsupported.length > 0) {
78
+ invalidModelConfig(source, `models.tasksMeta has unsupported key(s): ${unsupported.join(", ")}`);
79
+ }
80
+ if (!isString(value.generatedAt) ||
81
+ !/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d+)?(?:Z|[+-]\d{2}:\d{2})$/.test(value.generatedAt) ||
82
+ Number.isNaN(Date.parse(value.generatedAt))) {
83
+ invalidModelConfig(source, "models.tasksMeta.generatedAt must be an ISO-8601 string");
84
+ }
85
+ if (value.method !== "research" && value.method !== "registry-only") {
86
+ invalidModelConfig(source, 'models.tasksMeta.method must be "research" or "registry-only"');
87
+ }
88
+ return { generatedAt: value.generatedAt, method: value.method };
89
+ }
90
+ export function parseModelConfig(rawConfig, source = "config.json") {
91
+ if (!isPlainObject(rawConfig))
92
+ invalidModelConfig(source, "root must be an object");
93
+ const models = rawConfig.models;
94
+ if (models == null)
95
+ return { agents: {} };
96
+ if (!isPlainObject(models))
97
+ invalidModelConfig(source, "models must be an object");
98
+ const allowedKeys = new Set([
99
+ "default",
100
+ "agents",
101
+ "tasks",
102
+ "tasksThinking",
103
+ "tasksMeta",
104
+ ]);
105
+ const unsupportedKeys = Object.keys(models).filter((key) => !allowedKeys.has(key));
106
+ if (unsupportedKeys.length > 0)
107
+ invalidModelConfig(source, `models has unsupported key(s): ${unsupportedKeys.join(", ")}`);
108
+ let defaultModel;
109
+ if (models.default != null) {
110
+ if (!isString(models.default) || models.default.trim() === "")
111
+ invalidModelConfig(source, "models.default must be a non-empty string");
112
+ const trimmedDefault = models.default.trim();
113
+ defaultModel = trimmedDefault;
114
+ rejectTaskReference(trimmedDefault, "models.default", source);
115
+ }
116
+ const agents = {};
117
+ if (models.agents != null) {
118
+ if (!isPlainObject(models.agents))
119
+ invalidModelConfig(source, "models.agents must be an object");
120
+ for (const [agent, model] of Object.entries(models.agents)) {
121
+ if (!isString(model) || model.trim() === "")
122
+ invalidModelConfig(source, `models.agents.${agent} must be a non-empty string`);
123
+ const trimmed = model.trim();
124
+ rejectTaskReference(trimmed, `models.agents.${agent}`, source);
125
+ Object.defineProperty(agents, agent, {
126
+ value: trimmed,
127
+ enumerable: true,
128
+ writable: true,
129
+ configurable: true,
130
+ });
131
+ }
132
+ }
133
+ const tasks = parseTasks(models.tasks, source);
134
+ const tasksThinking = parseTasksThinking(models.tasksThinking, source);
135
+ const tasksMeta = parseTasksMeta(models.tasksMeta, source);
136
+ const config = { agents };
137
+ if (defaultModel)
138
+ config.default = defaultModel;
139
+ if (tasks)
140
+ config.tasks = tasks;
141
+ if (tasksThinking)
142
+ config.tasksThinking = tasksThinking;
143
+ if (tasksMeta)
144
+ config.tasksMeta = tasksMeta;
145
+ return config;
146
+ }
147
+ export function resolveModelDefault(agentName, agentModel, config) {
148
+ if (agentModel)
149
+ return agentModel;
150
+ if (agentName && Object.hasOwn(config.agents, agentName))
151
+ return config.agents[agentName];
152
+ return config.default;
153
+ }
154
+ export function loadModelConfig(configDir) {
155
+ return readModelConfigSnapshot(configDir).config;
156
+ }
157
+ /** Parse the saved model settings and revision them from one read of the file. */
158
+ export function readModelConfigSnapshot(configDir) {
159
+ const configPath = join(configDir, "config.json");
160
+ const bytes = readBytesIfExists(configPath);
161
+ if (bytes == null)
162
+ return { config: { agents: {} }, revision: MISSING_CONFIG_REVISION };
163
+ try {
164
+ return {
165
+ config: parseModelConfig(JSON.parse(bytes.toString("utf8")), configPath),
166
+ revision: computeConfigRevision(bytes),
167
+ };
168
+ }
169
+ catch (error) {
170
+ if (error instanceof SyntaxError)
171
+ throw new Error(`Invalid JSON in subagent model config ${configPath}: ${error.message}`);
172
+ throw error;
173
+ }
174
+ }
175
+ function invalidBasis(message) {
176
+ throw new Error(`Invalid ranking basis: ${message}`);
177
+ }
178
+ function isUsableUrl(value) {
179
+ const url = URL.parse(value);
180
+ return (url !== null &&
181
+ (url.protocol === "https:" || url.protocol === "http:") &&
182
+ url.hostname !== "");
183
+ }
184
+ /**
185
+ * Validate a writer call's optional ranking basis against its tasksMeta.method.
186
+ * Code checks shape and consistency only; it cannot prove a source was read.
187
+ */
188
+ export function parseRankingBasis(value, method) {
189
+ if (!isPlainObject(value))
190
+ invalidBasis("basis must be an object");
191
+ if (value.kind !== method)
192
+ invalidBasis(`basis.kind ${JSON.stringify(value.kind)} must equal tasksMeta.method ${JSON.stringify(method)}`);
193
+ if (value.kind === "registry-only") {
194
+ if (Object.keys(value).length !== 1)
195
+ invalidBasis("a registry-only basis has no other fields");
196
+ return { kind: "registry-only" };
197
+ }
198
+ if (Object.keys(value).some((key) => key !== "kind" && key !== "sources" && key !== "uncertainty"))
199
+ invalidBasis("a research basis has only kind, sources and uncertainty");
200
+ if (!Array.isArray(value.sources) || value.sources.length === 0)
201
+ invalidBasis("research needs at least one source that informed the ranking");
202
+ // SAFETY: the check above rejected an empty list, and map keeps its length.
203
+ const sources = value.sources.map((source, index) => {
204
+ if (!isPlainObject(source) ||
205
+ Object.keys(source).some((key) => key !== "url" && key !== "influence"))
206
+ invalidBasis(`sources[${index}] has only url and influence`);
207
+ if (!isString(source.url) || !isUsableUrl(source.url))
208
+ invalidBasis(`sources[${index}].url must be an http(s) URL with a host`);
209
+ if (!isString(source.influence) || source.influence.trim() === "")
210
+ invalidBasis(`sources[${index}].influence must say how the source informed the ranking`);
211
+ return { url: source.url, influence: source.influence };
212
+ });
213
+ if (!isString(value.uncertainty) || value.uncertainty.trim() === "")
214
+ invalidBasis("research must disclose its remaining uncertainty");
215
+ return { kind: "research", sources, uncertainty: value.uncertainty };
216
+ }
217
+ /** Revision of an absent config file. */
218
+ export const MISSING_CONFIG_REVISION = "missing";
219
+ const CONFIG_REVISION_PATTERN = /^sha256:[0-9a-f]{64}$/;
220
+ /** `sha256:<lowercase hex>` over the exact file bytes, never normalized JSON. */
221
+ export function computeConfigRevision(bytes) {
222
+ return `sha256:${createHash("sha256").update(bytes).digest("hex")}`;
223
+ }
224
+ export function isConfigRevision(value) {
225
+ return (value === MISSING_CONFIG_REVISION ||
226
+ (isString(value) && CONFIG_REVISION_PATTERN.test(value)));
227
+ }
228
+ /** Read the exact-byte revision of a config file, or `missing` when absent. */
229
+ export function readConfigRevision(configPath) {
230
+ const bytes = readBytesIfExists(configPath);
231
+ return bytes == null ? MISSING_CONFIG_REVISION : computeConfigRevision(bytes);
232
+ }
233
+ export class TaskModelConfigWriteError extends Error {
234
+ code;
235
+ constructor(code, message) {
236
+ super(message);
237
+ this.name = "TaskModelConfigWriteError";
238
+ this.code = code;
239
+ }
240
+ }
241
+ /** Normalize and validate a proposal without creating files or acquiring a lock. */
242
+ export function validateTaskModelProposal(configPath, tasks, tasksMeta, isAuthenticatedCandidate, options = {}) {
243
+ if (options.expectedConfigRevision !== undefined &&
244
+ !isConfigRevision(options.expectedConfigRevision)) {
245
+ throw new TaskModelConfigWriteError("invalid-revision", `Invalid expectedConfigRevision: use "sha256:" followed by 64 lowercase hex digits of the exact config bytes, or "${MISSING_CONFIG_REVISION}" when the config file is absent. Omit it only for an unconditional write.`);
246
+ }
247
+ const candidate = parseModelConfig({ models: { tasks, tasksThinking: options.tasksThinking, tasksMeta } }, configPath);
248
+ for (const category of Object.keys(candidate.tasksThinking ?? {})) {
249
+ if (!Object.hasOwn(candidate.tasks ?? {}, category))
250
+ invalidModelConfig(configPath, `models.tasksThinking.${category} has no submitted task category`);
251
+ }
252
+ for (const candidates of Object.values(candidate.tasks ?? {})) {
253
+ for (const ref of candidates) {
254
+ if (!isAuthenticatedCandidate(ref))
255
+ throw new Error(`Task model candidate ${JSON.stringify(ref)} is not an authenticated exact registry model`);
256
+ }
257
+ }
258
+ return candidate;
259
+ }
260
+ /** Check the proposal's revision before approval and again under the write lock. */
261
+ export function assertTaskModelConfigRevision(configPath, expected, actual) {
262
+ if (expected === undefined || actual === expected)
263
+ return;
264
+ let state = "the config file bytes changed since the proposal was read";
265
+ if (expected === MISSING_CONFIG_REVISION)
266
+ state = "the proposal expected no config file, but one now exists";
267
+ else if (actual === MISSING_CONFIG_REVISION)
268
+ state =
269
+ "the proposal expected an existing config file, but it is now missing";
270
+ throw new TaskModelConfigWriteError("stale-revision", `Stale task model config revision for ${configPath}: ${state}. Configuration was not replaced. Re-read the config, prepare a fresh proposal, and obtain fresh approval before writing.`);
271
+ }
272
+ /** Legacy callers preserve thinking only for task categories they retain. */
273
+ export function resolveTaskThinkingPreferences(tasks, requested, previous) {
274
+ const selected = requested ?? previous;
275
+ if (!selected)
276
+ return undefined;
277
+ const retained = {};
278
+ for (const category of TASK_CATEGORIES) {
279
+ const level = selected[category];
280
+ if (tasks?.[category] && level !== undefined)
281
+ retained[category] = level;
282
+ }
283
+ return Object.keys(retained).length > 0 ? retained : undefined;
284
+ }
285
+ /** Resolve existing symlinks without creating missing parent directories. */
286
+ function resolveConfigDirectory(path) {
287
+ try {
288
+ return realpathWithoutOpening(path);
289
+ }
290
+ catch (error) {
291
+ // SAFETY: filesystem errors expose the Node errno code.
292
+ if (error.code !== "ENOENT")
293
+ throw error;
294
+ const parent = dirname(path);
295
+ if (parent === path)
296
+ throw error;
297
+ return join(resolveConfigDirectory(parent), basename(path));
298
+ }
299
+ }
300
+ function assertApprovedDirectory(configPath, approved) {
301
+ if (resolveConfigDirectory(dirname(resolve(configPath))) !==
302
+ approved.realConfigDir)
303
+ throw new Error("Task model config directory changed after approval. Configuration was not replaced; obtain fresh approval.");
304
+ }
305
+ function parseTaskModelDocument(source, configPath) {
306
+ let parsed;
307
+ try {
308
+ parsed = JSON.parse(source);
309
+ }
310
+ catch (error) {
311
+ throw new Error(`Invalid JSON in subagent config ${configPath}: ${error instanceof Error ? error.message : String(error)}`);
312
+ }
313
+ if (!isPlainObject(parsed))
314
+ throw new Error(`Invalid JSON in subagent config ${configPath}: root must be an object`);
315
+ return parsed;
316
+ }
317
+ function taskModelOutput(configPath, bytes, candidate) {
318
+ const parsed = bytes == null
319
+ ? { status: { enabled: true } }
320
+ : parseTaskModelDocument(bytes.toString("utf8"), configPath);
321
+ const models = isRecord(parsed.models) ? { ...parsed.models } : {};
322
+ const retained = resolveTaskThinkingPreferences(candidate.tasks, candidate.tasksThinking, candidate.tasksThinking === undefined
323
+ ? parseTasksThinking(models.tasksThinking, configPath)
324
+ : undefined);
325
+ if (retained)
326
+ models.tasksThinking = retained;
327
+ else
328
+ delete models.tasksThinking;
329
+ models.tasks = candidate.tasks;
330
+ models.tasksMeta = candidate.tasksMeta
331
+ ? { ...candidate.tasksMeta }
332
+ : undefined;
333
+ return JSON.stringify({ ...parsed, models }, null, 2) + "\n";
334
+ }
335
+ /** Read and compute every byte before approval, including the minimal new-file seed. */
336
+ export function prepareTaskModelWrite(configPath, candidate, expectedConfigRevision) {
337
+ const realConfigDir = resolveConfigDirectory(dirname(resolve(configPath)));
338
+ const realConfigPath = join(realConfigDir, basename(configPath));
339
+ const bytes = readBytesIfExists(realConfigPath);
340
+ const configRevision = bytes == null ? MISSING_CONFIG_REVISION : computeConfigRevision(bytes);
341
+ assertTaskModelConfigRevision(configPath, expectedConfigRevision, configRevision);
342
+ const output = taskModelOutput(configPath, bytes, candidate);
343
+ const parsed = parseTaskModelDocument(output, configPath);
344
+ return {
345
+ configPath,
346
+ realConfigDir,
347
+ realConfigPath,
348
+ configRevision,
349
+ output,
350
+ before: bytes == null
351
+ ? { agents: {} }
352
+ : parseModelConfig(parseTaskModelDocument(bytes.toString("utf8"), configPath), configPath),
353
+ after: parseModelConfig(parsed, configPath),
354
+ newFile: bytes == null,
355
+ topLevelKeys: Object.keys(parsed),
356
+ };
357
+ }
358
+ /** Best-effort re-read after an approved write throws; never infer that failure means no publication. */
359
+ export function describeTaskModelWriteFailure(approved) {
360
+ try {
361
+ const current = readConfigRevision(approved.realConfigPath);
362
+ if (current === computeConfigRevision(Buffer.from(approved.output)))
363
+ return "Configuration matches the approved replacement (verified by re-read).";
364
+ if (current === approved.configRevision)
365
+ return "Configuration was not replaced (verified unchanged by re-read).";
366
+ return `Configuration changed to revision ${current}; replacement by this call is unknown.`;
367
+ }
368
+ catch {
369
+ return "Configuration replacement is unknown: the file could not be re-read.";
370
+ }
371
+ }
372
+ /**
373
+ * Atomically replace models.tasks, category thinking and models.tasksMeta in the durable user config.
374
+ * `_examplePath` is retained for positional compatibility only; missing files
375
+ * receive the minimal required status setting and proposed models, never an example seed.
376
+ *
377
+ * Cooperating calls use an exclusive sibling lock around snapshot validation
378
+ * and temporary-file publication. Non-cooperating processes can unlink it, so
379
+ * continued ownership is not guaranteed. It serializes cooperating writers only and
380
+ * cannot constrain editors or processes that ignore it. Contention and stale locks
381
+ * fail closed without waiting or breaking another owner's lock.
382
+ */
383
+ export function writeTaskModelConfig(configPath, _examplePath, tasks, tasksMeta, isAuthenticatedCandidate, options = {}) {
384
+ const expected = options.expectedConfigRevision ?? options.approvedWrite?.configRevision;
385
+ const candidateConfig = validateTaskModelProposal(configPath, tasks, tasksMeta, isAuthenticatedCandidate, options);
386
+ const fileOperations = options.fileOperations ?? {
387
+ renameSync,
388
+ writeFileSync,
389
+ };
390
+ const approved = options.approvedWrite;
391
+ const targetPath = approved?.realConfigPath ?? configPath;
392
+ if (approved)
393
+ assertApprovedDirectory(configPath, approved);
394
+ mkdirSync(dirname(targetPath), { recursive: true });
395
+ return withConfigWriteLock(targetPath, () => {
396
+ if (approved)
397
+ assertApprovedDirectory(configPath, approved);
398
+ const currentBytes = readBytesIfExists(targetPath);
399
+ assertTaskModelConfigRevision(configPath, expected, currentBytes == null
400
+ ? MISSING_CONFIG_REVISION
401
+ : computeConfigRevision(currentBytes));
402
+ const output = taskModelOutput(configPath, currentBytes, candidateConfig);
403
+ if (approved && output !== approved.output)
404
+ throw new Error("Task model replacement bytes differ from the approved proposal. Configuration was not replaced; obtain fresh approval.");
405
+ const retainedThinking = parseModelConfig(parseTaskModelDocument(output, configPath), configPath).tasksThinking;
406
+ const temporary = join(dirname(targetPath), `.${Date.now()}-${process.pid}-${randomUUID()}-config.tmp`);
407
+ let published = false;
408
+ try {
409
+ fileOperations.writeFileSync(temporary, output, { flag: "wx" });
410
+ if (approved)
411
+ assertApprovedDirectory(configPath, approved);
412
+ fileOperations.renameSync(temporary, targetPath);
413
+ published = true;
414
+ }
415
+ finally {
416
+ if (!published)
417
+ rmSync(temporary, { force: true });
418
+ }
419
+ const saved = {
420
+ configPath,
421
+ tasks: candidateConfig.tasks ?? {},
422
+ tasksMeta: candidateConfig.tasksMeta,
423
+ missingCategories: TASK_CATEGORIES.filter((category) => !candidateConfig.tasks?.[category]),
424
+ configRevision: readConfigRevision(targetPath),
425
+ };
426
+ if (retainedThinking)
427
+ saved.tasksThinking = retainedThinking;
428
+ return saved;
429
+ });
430
+ }
431
+ /** Sibling advisory lock path shared by every cooperating config writer. */
432
+ export function getConfigWriteLockPath(configPath) {
433
+ return `${configPath}.lock`;
434
+ }
435
+ function withConfigWriteLock(configPath, write) {
436
+ const lockPath = getConfigWriteLockPath(configPath);
437
+ const token = randomUUID();
438
+ let descriptor;
439
+ try {
440
+ descriptor = openSync(lockPath, "wx");
441
+ }
442
+ catch (error) {
443
+ // SAFETY: openSync errors expose the Node errno code.
444
+ if (error.code === "EEXIST")
445
+ throw new TaskModelConfigWriteError("busy", describeHeldLock(lockPath));
446
+ throw error;
447
+ }
448
+ try {
449
+ try {
450
+ writeSync(descriptor, JSON.stringify({
451
+ pid: process.pid,
452
+ hostname: hostname(),
453
+ token,
454
+ createdAt: new Date().toISOString(),
455
+ }));
456
+ }
457
+ finally {
458
+ closeSync(descriptor);
459
+ }
460
+ }
461
+ catch (error) {
462
+ rmSync(lockPath, { force: true });
463
+ throw error;
464
+ }
465
+ try {
466
+ return write();
467
+ }
468
+ finally {
469
+ releaseConfigWriteLock(lockPath, token);
470
+ }
471
+ }
472
+ function releaseConfigWriteLock(lockPath, token) {
473
+ let owner;
474
+ try {
475
+ owner = JSON.parse(readFileSync(lockPath, "utf8"));
476
+ }
477
+ catch {
478
+ return;
479
+ }
480
+ // Never remove a lock this invocation does not own.
481
+ if (isPlainObject(owner) && owner.token === token)
482
+ unlinkSync(lockPath);
483
+ }
484
+ function describeHeldLock(lockPath) {
485
+ let owner = "an unidentified owner";
486
+ let stale = "";
487
+ try {
488
+ const parsed = JSON.parse(readFileSync(lockPath, "utf8"));
489
+ if (isPlainObject(parsed) && Number.isInteger(parsed.pid)) {
490
+ owner = `pid ${parsed.pid}${isString(parsed.hostname) ? ` on ${parsed.hostname}` : ""}${isString(parsed.createdAt) ? ` since ${parsed.createdAt}` : ""}`;
491
+ if (parsed.hostname === hostname() && !isProcessAlive(parsed.pid))
492
+ stale =
493
+ " That process is no longer running, so the lock appears stale.";
494
+ }
495
+ }
496
+ catch {
497
+ // Unreadable lock contents still mean another writer may be active.
498
+ }
499
+ return `Task model config writer busy: lock ${lockPath} is held by ${owner}. Configuration was not replaced.${stale} Retry after the other writer finishes; remove the lock manually only after confirming no writer is active. Locks are never broken automatically.`;
500
+ }
501
+ function isProcessAlive(pid) {
502
+ try {
503
+ process.kill(pid, 0);
504
+ return true;
505
+ }
506
+ catch (error) {
507
+ // SAFETY: process.kill errors expose the Node errno code.
508
+ return error.code === "EPERM";
509
+ }
510
+ }
511
+ function readBytesIfExists(path) {
512
+ try {
513
+ return readFileSync(path);
514
+ }
515
+ catch (error) {
516
+ // SAFETY: readFileSync errors expose the Node errno code.
517
+ if (error.code === "ENOENT")
518
+ return undefined;
519
+ throw error;
520
+ }
521
+ }
522
+ //# sourceMappingURL=model-config.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"model-config.js","sourceRoot":"","sources":["../../../../maestro/core/config/model-config.ts"],"names":[],"mappings":"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","sourcesContent":["import { createHash, randomUUID } from \"node:crypto\";\nimport {\n\tcloseSync,\n\tmkdirSync,\n\topenSync,\n\treadFileSync,\n\trenameSync,\n\trmSync,\n\tunlinkSync,\n\twriteFileSync,\n\twriteSync,\n} from \"node:fs\";\nimport { hostname } from \"node:os\";\nimport { basename, dirname, join, resolve } from \"node:path\";\nimport { realpathWithoutOpening } from \"../realpath-without-opening.ts\";\nimport {\n\tisPlainObject,\n\tisRecord,\n\tisString,\n\ttype JsonObject,\n} from \"./type-guards.ts\";\nimport { isThinkingLevel, THINKING_LEVELS } from \"../routing.ts\";\n\nimport {\n\ttype RankingBasis,\n\ttype ResearchSource,\n\tTASK_CATEGORIES,\n\ttype TaskCategory,\n\ttype TaskPreferences,\n\ttype TaskPreferencesMeta,\n\ttype TaskThinkingPreferences,\n} from \"./task-model-types.ts\";\n\nexport interface ModelConfig {\n\tdefault?: string;\n\tagents: Record<string, string>;\n\ttasks?: TaskPreferences;\n\ttasksThinking?: TaskThinkingPreferences;\n\ttasksMeta?: TaskPreferencesMeta;\n}\n\nfunction invalidModelConfig(source: string, message: string): never {\n\tthrow new Error(`Invalid subagent model config in ${source}: ${message}`);\n}\n\nfunction rejectTaskReference(\n\tvalue: string,\n\tfield: string,\n\tsource: string,\n): void {\n\tif (value.trim().toLowerCase().startsWith(\"task:\")) {\n\t\tinvalidModelConfig(\n\t\t\tsource,\n\t\t\t`${field} cannot use task: references; task: references are only valid in the subagent tool's model parameter`,\n\t\t);\n\t}\n}\n\nfunction parseTasks(value: any, source: string): TaskPreferences | undefined {\n\tif (value == null) return undefined;\n\tif (!isPlainObject(value))\n\t\tinvalidModelConfig(source, \"models.tasks must be an object\");\n\tconst keys = Object.keys(value);\n\tif (keys.length === 0) return undefined;\n\tconst unsupported = keys.filter(\n\t\t// SAFETY: this check only compares strings against the fixed category set.\n\t\t(key) => !TASK_CATEGORIES.includes(key as TaskCategory),\n\t);\n\tif (unsupported.length > 0) {\n\t\tinvalidModelConfig(\n\t\t\tsource,\n\t\t\t`models.tasks.${unsupported[0]} is unsupported; supported categories: ${TASK_CATEGORIES.join(\", \")}`,\n\t\t);\n\t}\n\tconst tasks: TaskPreferences = {};\n\tfor (const category of TASK_CATEGORIES) {\n\t\tif (!Object.hasOwn(value, category)) continue;\n\t\tconst candidates = value[category];\n\t\tif (!Array.isArray(candidates) || candidates.length === 0) {\n\t\t\tinvalidModelConfig(\n\t\t\t\tsource,\n\t\t\t\t`models.tasks.${category} must be a non-empty list`,\n\t\t\t);\n\t\t}\n\t\tconst seen = new Set<string>();\n\t\ttasks[category] = candidates.map((candidate, index) => {\n\t\t\tif (!isString(candidate) || candidate.trim() === \"\") {\n\t\t\t\tinvalidModelConfig(\n\t\t\t\t\tsource,\n\t\t\t\t\t`models.tasks.${category}[${index}] must be a non-empty string`,\n\t\t\t\t);\n\t\t\t}\n\t\t\tconst reference = candidate.trim();\n\t\t\tif (seen.has(reference)) {\n\t\t\t\tinvalidModelConfig(\n\t\t\t\t\tsource,\n\t\t\t\t\t`models.tasks.${category} has duplicate candidate ${JSON.stringify(reference)}`,\n\t\t\t\t);\n\t\t\t}\n\t\t\tseen.add(reference);\n\t\t\treturn reference;\n\t\t});\n\t}\n\treturn tasks;\n}\n\nfunction parseTasksThinking(\n\tvalue: any,\n\tsource: string,\n): TaskThinkingPreferences | undefined {\n\tif (value == null) return undefined;\n\tif (!isPlainObject(value))\n\t\tinvalidModelConfig(source, \"models.tasksThinking must be an object\");\n\tconst thinking: TaskThinkingPreferences = {};\n\tfor (const [category, level] of Object.entries(value)) {\n\t\t// SAFETY: category membership is checked before indexing the typed map.\n\t\tif (!TASK_CATEGORIES.includes(category as TaskCategory))\n\t\t\tinvalidModelConfig(\n\t\t\t\tsource,\n\t\t\t\t`models.tasksThinking.${category} is unsupported; supported categories: ${TASK_CATEGORIES.join(\", \")}`,\n\t\t\t);\n\t\tif (!isString(level) || !isThinkingLevel(level))\n\t\t\tinvalidModelConfig(\n\t\t\t\tsource,\n\t\t\t\t`models.tasksThinking.${category} must be one of: ${THINKING_LEVELS.join(\", \")}`,\n\t\t\t);\n\t\t// SAFETY: the fixed category check above rejects unknown keys.\n\t\tthinking[category as TaskCategory] = level;\n\t}\n\treturn thinking;\n}\n\nfunction parseTasksMeta(\n\tvalue: any,\n\tsource: string,\n): TaskPreferencesMeta | undefined {\n\tif (value == null) return undefined;\n\tif (!isPlainObject(value))\n\t\tinvalidModelConfig(source, \"models.tasksMeta must be an object\");\n\tconst unsupported = Object.keys(value).filter(\n\t\t(key) => key !== \"generatedAt\" && key !== \"method\",\n\t);\n\tif (unsupported.length > 0) {\n\t\tinvalidModelConfig(\n\t\t\tsource,\n\t\t\t`models.tasksMeta has unsupported key(s): ${unsupported.join(\", \")}`,\n\t\t);\n\t}\n\tif (\n\t\t!isString(value.generatedAt) ||\n\t\t!/^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?(?:Z|[+-]\\d{2}:\\d{2})$/.test(\n\t\t\tvalue.generatedAt,\n\t\t) ||\n\t\tNumber.isNaN(Date.parse(value.generatedAt))\n\t) {\n\t\tinvalidModelConfig(\n\t\t\tsource,\n\t\t\t\"models.tasksMeta.generatedAt must be an ISO-8601 string\",\n\t\t);\n\t}\n\tif (value.method !== \"research\" && value.method !== \"registry-only\") {\n\t\tinvalidModelConfig(\n\t\t\tsource,\n\t\t\t'models.tasksMeta.method must be \"research\" or \"registry-only\"',\n\t\t);\n\t}\n\treturn { generatedAt: value.generatedAt, method: value.method };\n}\n\nexport function parseModelConfig(\n\trawConfig: any,\n\tsource = \"config.json\",\n): ModelConfig {\n\tif (!isPlainObject(rawConfig))\n\t\tinvalidModelConfig(source, \"root must be an object\");\n\tconst models = rawConfig.models;\n\tif (models == null) return { agents: {} };\n\tif (!isPlainObject(models))\n\t\tinvalidModelConfig(source, \"models must be an object\");\n\tconst allowedKeys = new Set([\n\t\t\"default\",\n\t\t\"agents\",\n\t\t\"tasks\",\n\t\t\"tasksThinking\",\n\t\t\"tasksMeta\",\n\t]);\n\tconst unsupportedKeys = Object.keys(models).filter(\n\t\t(key) => !allowedKeys.has(key),\n\t);\n\tif (unsupportedKeys.length > 0)\n\t\tinvalidModelConfig(\n\t\t\tsource,\n\t\t\t`models has unsupported key(s): ${unsupportedKeys.join(\", \")}`,\n\t\t);\n\n\tlet defaultModel: string | undefined;\n\tif (models.default != null) {\n\t\tif (!isString(models.default) || models.default.trim() === \"\")\n\t\t\tinvalidModelConfig(source, \"models.default must be a non-empty string\");\n\t\tconst trimmedDefault = models.default.trim();\n\t\tdefaultModel = trimmedDefault;\n\t\trejectTaskReference(trimmedDefault, \"models.default\", source);\n\t}\n\tconst agents: Record<string, string> = {};\n\tif (models.agents != null) {\n\t\tif (!isPlainObject(models.agents))\n\t\t\tinvalidModelConfig(source, \"models.agents must be an object\");\n\t\tfor (const [agent, model] of Object.entries(models.agents)) {\n\t\t\tif (!isString(model) || model.trim() === \"\")\n\t\t\t\tinvalidModelConfig(\n\t\t\t\t\tsource,\n\t\t\t\t\t`models.agents.${agent} must be a non-empty string`,\n\t\t\t\t);\n\t\t\tconst trimmed = model.trim();\n\t\t\trejectTaskReference(trimmed, `models.agents.${agent}`, source);\n\t\t\tObject.defineProperty(agents, agent, {\n\t\t\t\tvalue: trimmed,\n\t\t\t\tenumerable: true,\n\t\t\t\twritable: true,\n\t\t\t\tconfigurable: true,\n\t\t\t});\n\t\t}\n\t}\n\tconst tasks = parseTasks(models.tasks, source);\n\tconst tasksThinking = parseTasksThinking(models.tasksThinking, source);\n\tconst tasksMeta = parseTasksMeta(models.tasksMeta, source);\n\tconst config: ModelConfig = { agents };\n\tif (defaultModel) config.default = defaultModel;\n\tif (tasks) config.tasks = tasks;\n\tif (tasksThinking) config.tasksThinking = tasksThinking;\n\tif (tasksMeta) config.tasksMeta = tasksMeta;\n\treturn config;\n}\n\nexport function resolveModelDefault(\n\tagentName: string | undefined,\n\tagentModel: string | undefined,\n\tconfig: ModelConfig,\n): string | undefined {\n\tif (agentModel) return agentModel;\n\tif (agentName && Object.hasOwn(config.agents, agentName))\n\t\treturn config.agents[agentName];\n\treturn config.default;\n}\n\nexport function loadModelConfig(configDir: string): ModelConfig {\n\treturn readModelConfigSnapshot(configDir).config;\n}\n\nexport interface ModelConfigSnapshot {\n\tconfig: ModelConfig;\n\t/** Revision of the exact bytes `config` was parsed from. */\n\trevision: string;\n}\n\n/** Parse the saved model settings and revision them from one read of the file. */\nexport function readModelConfigSnapshot(\n\tconfigDir: string,\n): ModelConfigSnapshot {\n\tconst configPath = join(configDir, \"config.json\");\n\tconst bytes = readBytesIfExists(configPath);\n\tif (bytes == null)\n\t\treturn { config: { agents: {} }, revision: MISSING_CONFIG_REVISION };\n\ttry {\n\t\treturn {\n\t\t\tconfig: parseModelConfig(JSON.parse(bytes.toString(\"utf8\")), configPath),\n\t\t\trevision: computeConfigRevision(bytes),\n\t\t};\n\t} catch (error) {\n\t\tif (error instanceof SyntaxError)\n\t\t\tthrow new Error(\n\t\t\t\t`Invalid JSON in subagent model config ${configPath}: ${error.message}`,\n\t\t\t);\n\t\tthrow error;\n\t}\n}\n\nfunction invalidBasis(message: string): never {\n\tthrow new Error(`Invalid ranking basis: ${message}`);\n}\n\nfunction isUsableUrl(value: string): boolean {\n\tconst url = URL.parse(value);\n\treturn (\n\t\turl !== null &&\n\t\t(url.protocol === \"https:\" || url.protocol === \"http:\") &&\n\t\turl.hostname !== \"\"\n\t);\n}\n\n/**\n * Validate a writer call's optional ranking basis against its tasksMeta.method.\n * Code checks shape and consistency only; it cannot prove a source was read.\n */\nexport function parseRankingBasis(\n\tvalue: any,\n\tmethod: TaskPreferencesMeta[\"method\"],\n): RankingBasis {\n\tif (!isPlainObject(value)) invalidBasis(\"basis must be an object\");\n\tif (value.kind !== method)\n\t\tinvalidBasis(\n\t\t\t`basis.kind ${JSON.stringify(value.kind)} must equal tasksMeta.method ${JSON.stringify(method)}`,\n\t\t);\n\tif (value.kind === \"registry-only\") {\n\t\tif (Object.keys(value).length !== 1)\n\t\t\tinvalidBasis(\"a registry-only basis has no other fields\");\n\t\treturn { kind: \"registry-only\" };\n\t}\n\tif (\n\t\tObject.keys(value).some(\n\t\t\t(key) => key !== \"kind\" && key !== \"sources\" && key !== \"uncertainty\",\n\t\t)\n\t)\n\t\tinvalidBasis(\"a research basis has only kind, sources and uncertainty\");\n\tif (!Array.isArray(value.sources) || value.sources.length === 0)\n\t\tinvalidBasis(\n\t\t\t\"research needs at least one source that informed the ranking\",\n\t\t);\n\t// SAFETY: the check above rejected an empty list, and map keeps its length.\n\tconst sources = value.sources.map((source: any, index: number) => {\n\t\tif (\n\t\t\t!isPlainObject(source) ||\n\t\t\tObject.keys(source).some((key) => key !== \"url\" && key !== \"influence\")\n\t\t)\n\t\t\tinvalidBasis(`sources[${index}] has only url and influence`);\n\t\tif (!isString(source.url) || !isUsableUrl(source.url))\n\t\t\tinvalidBasis(`sources[${index}].url must be an http(s) URL with a host`);\n\t\tif (!isString(source.influence) || source.influence.trim() === \"\")\n\t\t\tinvalidBasis(\n\t\t\t\t`sources[${index}].influence must say how the source informed the ranking`,\n\t\t\t);\n\t\treturn { url: source.url, influence: source.influence };\n\t}) as [ResearchSource, ...ResearchSource[]];\n\tif (!isString(value.uncertainty) || value.uncertainty.trim() === \"\")\n\t\tinvalidBasis(\"research must disclose its remaining uncertainty\");\n\treturn { kind: \"research\", sources, uncertainty: value.uncertainty };\n}\n\nexport interface SavedTaskModelConfig {\n\tconfigPath: string;\n\ttasks: TaskPreferences;\n\ttasksThinking?: TaskThinkingPreferences;\n\ttasksMeta: TaskPreferencesMeta | undefined;\n\tmissingCategories: TaskCategory[];\n\t/** Revision of the exact bytes this call published. */\n\tconfigRevision: string;\n}\n\n/** Revision of an absent config file. */\nexport const MISSING_CONFIG_REVISION = \"missing\";\nconst CONFIG_REVISION_PATTERN = /^sha256:[0-9a-f]{64}$/;\n\n/** `sha256:<lowercase hex>` over the exact file bytes, never normalized JSON. */\nexport function computeConfigRevision(bytes: Uint8Array): string {\n\treturn `sha256:${createHash(\"sha256\").update(bytes).digest(\"hex\")}`;\n}\n\nexport function isConfigRevision(value: any): value is string {\n\treturn (\n\t\tvalue === MISSING_CONFIG_REVISION ||\n\t\t(isString(value) && CONFIG_REVISION_PATTERN.test(value))\n\t);\n}\n\n/** Read the exact-byte revision of a config file, or `missing` when absent. */\nexport function readConfigRevision(configPath: string): string {\n\tconst bytes = readBytesIfExists(configPath);\n\treturn bytes == null ? MISSING_CONFIG_REVISION : computeConfigRevision(bytes);\n}\n\nexport type TaskModelConfigWriteErrorCode =\n\t| \"invalid-revision\"\n\t| \"stale-revision\"\n\t| \"busy\";\n\nexport class TaskModelConfigWriteError extends Error {\n\treadonly code: TaskModelConfigWriteErrorCode;\n\tconstructor(code: TaskModelConfigWriteErrorCode, message: string) {\n\t\tsuper(message);\n\t\tthis.name = \"TaskModelConfigWriteError\";\n\t\tthis.code = code;\n\t}\n}\n\nexport interface WriteTaskModelConfigOptions {\n\t/** Replaces category thinking when supplied; omitted preserves it for retained categories. */\n\ttasksThinking?: TaskThinkingPreferences | null;\n\t/** Exact precomputed replacement and real directory shown for approval. */\n\tapprovedWrite?: PreparedTaskModelWrite;\n\t/**\n\t * Exact-byte revision the caller proposed against. Omitted keeps the\n\t * unconditional write; `missing` requires the file to be absent.\n\t */\n\texpectedConfigRevision?: string;\n\tfileOperations?: Pick<\n\t\ttypeof import(\"node:fs\"),\n\t\t\"renameSync\" | \"writeFileSync\"\n\t>;\n}\n\n/** Normalize and validate a proposal without creating files or acquiring a lock. */\nexport function validateTaskModelProposal(\n\tconfigPath: string,\n\ttasks: TaskPreferences,\n\ttasksMeta: TaskPreferencesMeta,\n\tisAuthenticatedCandidate: (candidate: string) => boolean,\n\toptions: WriteTaskModelConfigOptions = {},\n): ModelConfig {\n\tif (\n\t\toptions.expectedConfigRevision !== undefined &&\n\t\t!isConfigRevision(options.expectedConfigRevision)\n\t) {\n\t\tthrow new TaskModelConfigWriteError(\n\t\t\t\"invalid-revision\",\n\t\t\t`Invalid expectedConfigRevision: use \"sha256:\" followed by 64 lowercase hex digits of the exact config bytes, or \"${MISSING_CONFIG_REVISION}\" when the config file is absent. Omit it only for an unconditional write.`,\n\t\t);\n\t}\n\tconst candidate = parseModelConfig(\n\t\t{ models: { tasks, tasksThinking: options.tasksThinking, tasksMeta } },\n\t\tconfigPath,\n\t);\n\tfor (const category of Object.keys(candidate.tasksThinking ?? {})) {\n\t\tif (!Object.hasOwn(candidate.tasks ?? {}, category))\n\t\t\tinvalidModelConfig(\n\t\t\t\tconfigPath,\n\t\t\t\t`models.tasksThinking.${category} has no submitted task category`,\n\t\t\t);\n\t}\n\tfor (const candidates of Object.values(candidate.tasks ?? {})) {\n\t\tfor (const ref of candidates) {\n\t\t\tif (!isAuthenticatedCandidate(ref))\n\t\t\t\tthrow new Error(\n\t\t\t\t\t`Task model candidate ${JSON.stringify(ref)} is not an authenticated exact registry model`,\n\t\t\t\t);\n\t\t}\n\t}\n\treturn candidate;\n}\n\n/** Check the proposal's revision before approval and again under the write lock. */\nexport function assertTaskModelConfigRevision(\n\tconfigPath: string,\n\texpected: string | undefined,\n\tactual: string,\n): void {\n\tif (expected === undefined || actual === expected) return;\n\tlet state = \"the config file bytes changed since the proposal was read\";\n\tif (expected === MISSING_CONFIG_REVISION)\n\t\tstate = \"the proposal expected no config file, but one now exists\";\n\telse if (actual === MISSING_CONFIG_REVISION)\n\t\tstate =\n\t\t\t\"the proposal expected an existing config file, but it is now missing\";\n\tthrow new TaskModelConfigWriteError(\n\t\t\"stale-revision\",\n\t\t`Stale task model config revision for ${configPath}: ${state}. Configuration was not replaced. Re-read the config, prepare a fresh proposal, and obtain fresh approval before writing.`,\n\t);\n}\n\n/** Legacy callers preserve thinking only for task categories they retain. */\nexport function resolveTaskThinkingPreferences(\n\ttasks: TaskPreferences | undefined,\n\trequested: TaskThinkingPreferences | undefined,\n\tprevious: TaskThinkingPreferences | undefined,\n): TaskThinkingPreferences | undefined {\n\tconst selected = requested ?? previous;\n\tif (!selected) return undefined;\n\tconst retained: TaskThinkingPreferences = {};\n\tfor (const category of TASK_CATEGORIES) {\n\t\tconst level = selected[category];\n\t\tif (tasks?.[category] && level !== undefined) retained[category] = level;\n\t}\n\treturn Object.keys(retained).length > 0 ? retained : undefined;\n}\n\nexport interface PreparedTaskModelWrite {\n\tconfigPath: string;\n\trealConfigPath: string;\n\trealConfigDir: string;\n\tconfigRevision: string;\n\tbefore: ModelConfig;\n\tafter: ModelConfig;\n\toutput: string;\n\tnewFile: boolean;\n\ttopLevelKeys: string[];\n}\n\n/** Resolve existing symlinks without creating missing parent directories. */\nfunction resolveConfigDirectory(path: string): string {\n\ttry {\n\t\treturn realpathWithoutOpening(path);\n\t} catch (error) {\n\t\t// SAFETY: filesystem errors expose the Node errno code.\n\t\tif ((error as NodeJS.ErrnoException).code !== \"ENOENT\") throw error;\n\t\tconst parent = dirname(path);\n\t\tif (parent === path) throw error;\n\t\treturn join(resolveConfigDirectory(parent), basename(path));\n\t}\n}\n\nfunction assertApprovedDirectory(\n\tconfigPath: string,\n\tapproved: PreparedTaskModelWrite,\n): void {\n\tif (\n\t\tresolveConfigDirectory(dirname(resolve(configPath))) !==\n\t\tapproved.realConfigDir\n\t)\n\t\tthrow new Error(\n\t\t\t\"Task model config directory changed after approval. Configuration was not replaced; obtain fresh approval.\",\n\t\t);\n}\n\nfunction parseTaskModelDocument(\n\tsource: string,\n\tconfigPath: string,\n): JsonObject {\n\tlet parsed: any;\n\ttry {\n\t\tparsed = JSON.parse(source);\n\t} catch (error) {\n\t\tthrow new Error(\n\t\t\t`Invalid JSON in subagent config ${configPath}: ${error instanceof Error ? error.message : String(error)}`,\n\t\t);\n\t}\n\tif (!isPlainObject(parsed))\n\t\tthrow new Error(\n\t\t\t`Invalid JSON in subagent config ${configPath}: root must be an object`,\n\t\t);\n\treturn parsed;\n}\n\nfunction taskModelOutput(\n\tconfigPath: string,\n\tbytes: Buffer | undefined,\n\tcandidate: ModelConfig,\n): string {\n\tconst parsed: JsonObject =\n\t\tbytes == null\n\t\t\t? { status: { enabled: true } }\n\t\t\t: parseTaskModelDocument(bytes.toString(\"utf8\"), configPath);\n\tconst models = isRecord(parsed.models) ? { ...parsed.models } : {};\n\tconst retained = resolveTaskThinkingPreferences(\n\t\tcandidate.tasks,\n\t\tcandidate.tasksThinking,\n\t\tcandidate.tasksThinking === undefined\n\t\t\t? parseTasksThinking(models.tasksThinking, configPath)\n\t\t\t: undefined,\n\t);\n\tif (retained) models.tasksThinking = retained;\n\telse delete models.tasksThinking;\n\tmodels.tasks = candidate.tasks;\n\tmodels.tasksMeta = candidate.tasksMeta\n\t\t? { ...candidate.tasksMeta }\n\t\t: undefined;\n\treturn JSON.stringify({ ...parsed, models }, null, 2) + \"\\n\";\n}\n\n/** Read and compute every byte before approval, including the minimal new-file seed. */\nexport function prepareTaskModelWrite(\n\tconfigPath: string,\n\tcandidate: ModelConfig,\n\texpectedConfigRevision?: string,\n): PreparedTaskModelWrite {\n\tconst realConfigDir = resolveConfigDirectory(dirname(resolve(configPath)));\n\tconst realConfigPath = join(realConfigDir, basename(configPath));\n\tconst bytes = readBytesIfExists(realConfigPath);\n\tconst configRevision =\n\t\tbytes == null ? MISSING_CONFIG_REVISION : computeConfigRevision(bytes);\n\tassertTaskModelConfigRevision(\n\t\tconfigPath,\n\t\texpectedConfigRevision,\n\t\tconfigRevision,\n\t);\n\tconst output = taskModelOutput(configPath, bytes, candidate);\n\tconst parsed = parseTaskModelDocument(output, configPath);\n\treturn {\n\t\tconfigPath,\n\t\trealConfigDir,\n\t\trealConfigPath,\n\t\tconfigRevision,\n\t\toutput,\n\t\tbefore:\n\t\t\tbytes == null\n\t\t\t\t? { agents: {} }\n\t\t\t\t: parseModelConfig(\n\t\t\t\t\t\tparseTaskModelDocument(bytes.toString(\"utf8\"), configPath),\n\t\t\t\t\t\tconfigPath,\n\t\t\t\t\t),\n\t\tafter: parseModelConfig(parsed, configPath),\n\t\tnewFile: bytes == null,\n\t\ttopLevelKeys: Object.keys(parsed),\n\t};\n}\n\n/** Best-effort re-read after an approved write throws; never infer that failure means no publication. */\nexport function describeTaskModelWriteFailure(\n\tapproved: PreparedTaskModelWrite,\n): string {\n\ttry {\n\t\tconst current = readConfigRevision(approved.realConfigPath);\n\t\tif (current === computeConfigRevision(Buffer.from(approved.output)))\n\t\t\treturn \"Configuration matches the approved replacement (verified by re-read).\";\n\t\tif (current === approved.configRevision)\n\t\t\treturn \"Configuration was not replaced (verified unchanged by re-read).\";\n\t\treturn `Configuration changed to revision ${current}; replacement by this call is unknown.`;\n\t} catch {\n\t\treturn \"Configuration replacement is unknown: the file could not be re-read.\";\n\t}\n}\n\n/**\n * Atomically replace models.tasks, category thinking and models.tasksMeta in the durable user config.\n * `_examplePath` is retained for positional compatibility only; missing files\n * receive the minimal required status setting and proposed models, never an example seed.\n *\n * Cooperating calls use an exclusive sibling lock around snapshot validation\n * and temporary-file publication. Non-cooperating processes can unlink it, so\n * continued ownership is not guaranteed. It serializes cooperating writers only and\n * cannot constrain editors or processes that ignore it. Contention and stale locks\n * fail closed without waiting or breaking another owner's lock.\n */\nexport function writeTaskModelConfig(\n\tconfigPath: string,\n\t_examplePath: string,\n\ttasks: TaskPreferences,\n\ttasksMeta: TaskPreferencesMeta,\n\tisAuthenticatedCandidate: (candidate: string) => boolean,\n\toptions: WriteTaskModelConfigOptions = {},\n): SavedTaskModelConfig {\n\tconst expected =\n\t\toptions.expectedConfigRevision ?? options.approvedWrite?.configRevision;\n\tconst candidateConfig = validateTaskModelProposal(\n\t\tconfigPath,\n\t\ttasks,\n\t\ttasksMeta,\n\t\tisAuthenticatedCandidate,\n\t\toptions,\n\t);\n\tconst fileOperations = options.fileOperations ?? {\n\t\trenameSync,\n\t\twriteFileSync,\n\t};\n\tconst approved = options.approvedWrite;\n\tconst targetPath = approved?.realConfigPath ?? configPath;\n\tif (approved) assertApprovedDirectory(configPath, approved);\n\tmkdirSync(dirname(targetPath), { recursive: true });\n\treturn withConfigWriteLock(targetPath, () => {\n\t\tif (approved) assertApprovedDirectory(configPath, approved);\n\t\tconst currentBytes = readBytesIfExists(targetPath);\n\t\tassertTaskModelConfigRevision(\n\t\t\tconfigPath,\n\t\t\texpected,\n\t\t\tcurrentBytes == null\n\t\t\t\t? MISSING_CONFIG_REVISION\n\t\t\t\t: computeConfigRevision(currentBytes),\n\t\t);\n\t\tconst output = taskModelOutput(configPath, currentBytes, candidateConfig);\n\t\tif (approved && output !== approved.output)\n\t\t\tthrow new Error(\n\t\t\t\t\"Task model replacement bytes differ from the approved proposal. Configuration was not replaced; obtain fresh approval.\",\n\t\t\t);\n\t\tconst retainedThinking = parseModelConfig(\n\t\t\tparseTaskModelDocument(output, configPath),\n\t\t\tconfigPath,\n\t\t).tasksThinking;\n\t\tconst temporary = join(\n\t\t\tdirname(targetPath),\n\t\t\t`.${Date.now()}-${process.pid}-${randomUUID()}-config.tmp`,\n\t\t);\n\t\tlet published = false;\n\t\ttry {\n\t\t\tfileOperations.writeFileSync(temporary, output, { flag: \"wx\" });\n\t\t\tif (approved) assertApprovedDirectory(configPath, approved);\n\t\t\tfileOperations.renameSync(temporary, targetPath);\n\t\t\tpublished = true;\n\t\t} finally {\n\t\t\tif (!published) rmSync(temporary, { force: true });\n\t\t}\n\t\tconst saved: SavedTaskModelConfig = {\n\t\t\tconfigPath,\n\t\t\ttasks: candidateConfig.tasks ?? {},\n\t\t\ttasksMeta: candidateConfig.tasksMeta,\n\t\t\tmissingCategories: TASK_CATEGORIES.filter(\n\t\t\t\t(category) => !candidateConfig.tasks?.[category],\n\t\t\t),\n\t\t\tconfigRevision: readConfigRevision(targetPath),\n\t\t};\n\t\tif (retainedThinking) saved.tasksThinking = retainedThinking;\n\t\treturn saved;\n\t});\n}\n\n/** Sibling advisory lock path shared by every cooperating config writer. */\nexport function getConfigWriteLockPath(configPath: string): string {\n\treturn `${configPath}.lock`;\n}\n\nfunction withConfigWriteLock<T>(configPath: string, write: () => T): T {\n\tconst lockPath = getConfigWriteLockPath(configPath);\n\tconst token = randomUUID();\n\tlet descriptor: number;\n\ttry {\n\t\tdescriptor = openSync(lockPath, \"wx\");\n\t} catch (error) {\n\t\t// SAFETY: openSync errors expose the Node errno code.\n\t\tif ((error as NodeJS.ErrnoException).code === \"EEXIST\")\n\t\t\tthrow new TaskModelConfigWriteError(\"busy\", describeHeldLock(lockPath));\n\t\tthrow error;\n\t}\n\ttry {\n\t\ttry {\n\t\t\twriteSync(\n\t\t\t\tdescriptor,\n\t\t\t\tJSON.stringify({\n\t\t\t\t\tpid: process.pid,\n\t\t\t\t\thostname: hostname(),\n\t\t\t\t\ttoken,\n\t\t\t\t\tcreatedAt: new Date().toISOString(),\n\t\t\t\t}),\n\t\t\t);\n\t\t} finally {\n\t\t\tcloseSync(descriptor);\n\t\t}\n\t} catch (error) {\n\t\trmSync(lockPath, { force: true });\n\t\tthrow error;\n\t}\n\ttry {\n\t\treturn write();\n\t} finally {\n\t\treleaseConfigWriteLock(lockPath, token);\n\t}\n}\n\nfunction releaseConfigWriteLock(lockPath: string, token: string): void {\n\tlet owner: any;\n\ttry {\n\t\towner = JSON.parse(readFileSync(lockPath, \"utf8\"));\n\t} catch {\n\t\treturn;\n\t}\n\t// Never remove a lock this invocation does not own.\n\tif (isPlainObject(owner) && owner.token === token) unlinkSync(lockPath);\n}\n\nfunction describeHeldLock(lockPath: string): string {\n\tlet owner = \"an unidentified owner\";\n\tlet stale = \"\";\n\ttry {\n\t\tconst parsed = JSON.parse(readFileSync(lockPath, \"utf8\"));\n\t\tif (isPlainObject(parsed) && Number.isInteger(parsed.pid)) {\n\t\t\towner = `pid ${parsed.pid}${isString(parsed.hostname) ? ` on ${parsed.hostname}` : \"\"}${isString(parsed.createdAt) ? ` since ${parsed.createdAt}` : \"\"}`;\n\t\t\tif (parsed.hostname === hostname() && !isProcessAlive(parsed.pid))\n\t\t\t\tstale =\n\t\t\t\t\t\" That process is no longer running, so the lock appears stale.\";\n\t\t}\n\t} catch {\n\t\t// Unreadable lock contents still mean another writer may be active.\n\t}\n\treturn `Task model config writer busy: lock ${lockPath} is held by ${owner}. Configuration was not replaced.${stale} Retry after the other writer finishes; remove the lock manually only after confirming no writer is active. Locks are never broken automatically.`;\n}\n\nfunction isProcessAlive(pid: number): boolean {\n\ttry {\n\t\tprocess.kill(pid, 0);\n\t\treturn true;\n\t} catch (error) {\n\t\t// SAFETY: process.kill errors expose the Node errno code.\n\t\treturn (error as NodeJS.ErrnoException).code === \"EPERM\";\n\t}\n}\n\nfunction readBytesIfExists(path: string): Buffer | undefined {\n\ttry {\n\t\treturn readFileSync(path);\n\t} catch (error) {\n\t\t// SAFETY: readFileSync errors expose the Node errno code.\n\t\tif ((error as NodeJS.ErrnoException).code === \"ENOENT\") return undefined;\n\t\tthrow error;\n\t}\n}\n"]}
@@ -0,0 +1,8 @@
1
+ /** Whether the parent appends one outcome-ledger line per model attempt. */
2
+ export interface OutcomeLedgerConfig {
3
+ enabled: boolean;
4
+ }
5
+ /** `outcomeLedger` is on unless set to `false`; any non-boolean is rejected. */
6
+ export declare function parseOutcomeLedgerConfig(rawConfig: any, source?: string): OutcomeLedgerConfig;
7
+ export declare function loadOutcomeLedgerConfig(configDir: string, examplePath: string): OutcomeLedgerConfig;
8
+ //# sourceMappingURL=outcome-ledger-config.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"outcome-ledger-config.d.ts","sourceRoot":"","sources":["../../../../maestro/core/config/outcome-ledger-config.ts"],"names":[],"mappings":"AAIA,4EAA4E;AAC5E,MAAM,WAAW,mBAAmB;IACnC,OAAO,EAAE,OAAO,CAAC;CACjB;AAMD,gFAAgF;AAChF,wBAAgB,wBAAwB,CACvC,SAAS,EAAE,GAAG,EACd,MAAM,SAAgB,GACpB,mBAAmB,CAMrB;AAED,wBAAgB,uBAAuB,CACtC,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,GACjB,mBAAmB,CA6BrB"}