create-windy 0.8.2 → 0.9.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 (574) hide show
  1. package/dist/cli.js +855 -560
  2. package/package.json +1 -1
  3. package/template/.windy-template.json +2 -2
  4. package/template/apps/agent-server/Dockerfile +92 -22
  5. package/template/apps/agent-server/README.md +47 -85
  6. package/template/apps/agent-server/documents/office.py +216 -0
  7. package/template/apps/agent-server/documents/query_report.py +136 -0
  8. package/template/apps/agent-server/documents/smoke.py +177 -0
  9. package/template/apps/agent-server/documents/test_boundaries.py +185 -0
  10. package/template/apps/agent-server/host-contracts.ts +56 -0
  11. package/template/apps/agent-server/install-native.ts +167 -0
  12. package/template/apps/agent-server/main.ts +179 -0
  13. package/template/apps/agent-server/native/EXTENSIONS.md +46 -0
  14. package/template/apps/agent-server/native/admission.ts +73 -0
  15. package/template/apps/agent-server/native/authorization.test.ts +176 -0
  16. package/template/apps/agent-server/native/authorization.ts +118 -0
  17. package/template/apps/agent-server/native/boundary-io.ts +93 -0
  18. package/template/apps/agent-server/native/boundary-product.ts +107 -0
  19. package/template/apps/agent-server/native/boundary-project.test.ts +247 -0
  20. package/template/apps/agent-server/native/boundary-project.ts +188 -0
  21. package/template/apps/agent-server/native/boundary.ts +188 -0
  22. package/template/apps/agent-server/native/compaction-policy.test.ts +175 -0
  23. package/template/apps/agent-server/native/config.ts +95 -0
  24. package/template/apps/agent-server/native/conversation-instructions.ts +9 -0
  25. package/template/apps/agent-server/native/extensions.test.ts +190 -0
  26. package/template/apps/agent-server/native/extensions.ts +31 -0
  27. package/template/apps/agent-server/native/host-profile.test.ts +91 -0
  28. package/template/apps/agent-server/native/host-profile.ts +33 -0
  29. package/template/apps/agent-server/native/host-test-fixture.ts +13 -0
  30. package/template/apps/agent-server/native/http.ts +129 -0
  31. package/template/apps/agent-server/native/lifecycle.test.ts +285 -0
  32. package/template/apps/agent-server/native/lifecycle.ts +136 -0
  33. package/template/apps/agent-server/native/manager.ts +292 -0
  34. package/template/apps/agent-server/native/native.test.ts +207 -0
  35. package/template/apps/agent-server/native/office-preview.test.ts +50 -0
  36. package/template/apps/agent-server/native/office-preview.ts +25 -0
  37. package/template/apps/agent-server/native/parallel-harness.ts +242 -0
  38. package/template/apps/agent-server/native/parallel-mcp-fixture.ts +97 -0
  39. package/template/apps/agent-server/native/parallel.test.ts +256 -0
  40. package/template/apps/agent-server/native/profile-composition.test.ts +147 -0
  41. package/template/apps/agent-server/native/profile.ts +307 -0
  42. package/template/apps/agent-server/native/request.ts +61 -0
  43. package/template/apps/agent-server/native/session-conflict.test.ts +235 -0
  44. package/template/apps/agent-server/native/session-conflict.ts +21 -0
  45. package/template/apps/agent-server/native/shared-skills.test.ts +128 -0
  46. package/template/apps/agent-server/native/shared-skills.ts +240 -0
  47. package/template/apps/agent-server/native/socket-lifecycle.test.ts +48 -0
  48. package/template/apps/agent-server/native/socket.ts +130 -0
  49. package/template/apps/agent-server/native/storage-lifecycle.test.ts +217 -0
  50. package/template/apps/agent-server/native/storage.ts +188 -0
  51. package/template/apps/agent-server/native/stream-authorization.test.ts +89 -0
  52. package/template/apps/agent-server/native/worker.ts +77 -0
  53. package/template/apps/agent-server/native-download.test.ts +119 -0
  54. package/template/apps/agent-server/native-download.ts +145 -0
  55. package/template/apps/agent-server/package.json +63 -0
  56. package/template/apps/agent-server/plugins/access.mjs +126 -0
  57. package/template/apps/agent-server/plugins/branding/README.md +9 -0
  58. package/template/apps/agent-server/plugins/branding/brand.css +85 -0
  59. package/template/apps/agent-server/plugins/branding/client.js +338 -0
  60. package/template/apps/agent-server/plugins/branding/index.mjs +35 -0
  61. package/template/apps/agent-server/plugins/branding/loading.d.mts +2 -0
  62. package/template/apps/agent-server/plugins/branding/loading.mjs +66 -0
  63. package/template/apps/agent-server/plugins/branding/loading.test.ts +89 -0
  64. package/template/apps/agent-server/plugins/branding/package.json +21 -0
  65. package/template/apps/agent-server/plugins/branding.test.ts +294 -0
  66. package/template/apps/agent-server/plugins/compaction.mjs +83 -0
  67. package/template/apps/agent-server/plugins/compaction.test.ts +91 -0
  68. package/template/apps/agent-server/plugins/confine-network.py +57 -0
  69. package/template/apps/agent-server/plugins/default-skills.test.ts +62 -0
  70. package/template/apps/agent-server/plugins/downloads/README.md +28 -0
  71. package/template/apps/agent-server/plugins/downloads/client.js +126 -0
  72. package/template/apps/agent-server/plugins/downloads/downloads.test.ts +222 -0
  73. package/template/apps/agent-server/plugins/downloads/index.d.mts +19 -0
  74. package/template/apps/agent-server/plugins/downloads/index.mjs +180 -0
  75. package/template/apps/agent-server/plugins/downloads/package.json +20 -0
  76. package/template/apps/agent-server/plugins/drop-overlay/README.md +24 -0
  77. package/template/apps/agent-server/plugins/drop-overlay/drop-overlay.test.ts +199 -0
  78. package/template/apps/agent-server/plugins/drop-overlay/index.d.mts +8 -0
  79. package/template/apps/agent-server/plugins/drop-overlay/index.mjs +12 -0
  80. package/template/apps/agent-server/plugins/drop-overlay/style.css +102 -0
  81. package/template/apps/agent-server/plugins/locale/client.js +61 -0
  82. package/template/apps/agent-server/plugins/locale/index.d.mts +9 -0
  83. package/template/apps/agent-server/plugins/locale/index.mjs +16 -0
  84. package/template/apps/agent-server/plugins/locale/locale.test.ts +217 -0
  85. package/template/apps/agent-server/plugins/locale/package.json +19 -0
  86. package/template/apps/agent-server/plugins/parallel.mjs +146 -0
  87. package/template/apps/agent-server/plugins/preset-registry.d.mts +2 -0
  88. package/template/apps/agent-server/plugins/preset-registry.mjs +41 -0
  89. package/template/apps/agent-server/plugins/preset-registry.test.ts +46 -0
  90. package/template/apps/agent-server/plugins/questions.d.mts +25 -0
  91. package/template/apps/agent-server/plugins/questions.mjs +142 -0
  92. package/template/apps/agent-server/plugins/questions.test.ts +105 -0
  93. package/template/apps/agent-server/plugins/settings/README.md +17 -0
  94. package/template/apps/agent-server/plugins/settings/client.js +102 -0
  95. package/template/apps/agent-server/plugins/settings/index.mjs +17 -0
  96. package/template/apps/agent-server/plugins/settings/package.json +19 -0
  97. package/template/apps/agent-server/plugins/settings/settings.test.ts +129 -0
  98. package/template/apps/agent-server/plugins/settings-controller.d.mts +4 -0
  99. package/template/apps/agent-server/plugins/settings-controller.mjs +31 -0
  100. package/template/apps/agent-server/plugins/settings-controller.test.ts +17 -0
  101. package/template/apps/agent-server/plugins/settings-dispatch.test.ts +34 -0
  102. package/template/apps/agent-server/plugins/shared-skills.d.mts +15 -0
  103. package/template/apps/agent-server/plugins/shared-skills.mjs +82 -0
  104. package/template/apps/agent-server/plugins/shared-skills.test.ts +51 -0
  105. package/template/apps/agent-server/plugins/skill-library/README.md +11 -0
  106. package/template/apps/agent-server/plugins/skill-library/archive.test.ts +43 -0
  107. package/template/apps/agent-server/plugins/skill-library/bundle.mjs +234 -0
  108. package/template/apps/agent-server/plugins/skill-library/client-chunks.test.ts +107 -0
  109. package/template/apps/agent-server/plugins/skill-library/client-form-mount.test.ts +139 -0
  110. package/template/apps/agent-server/plugins/skill-library/client-form.test.ts +261 -0
  111. package/template/apps/agent-server/plugins/skill-library/client-ui.test.ts +268 -0
  112. package/template/apps/agent-server/plugins/skill-library/client-use.test.ts +158 -0
  113. package/template/apps/agent-server/plugins/skill-library/client.editor.js +93 -0
  114. package/template/apps/agent-server/plugins/skill-library/client.form.js +316 -0
  115. package/template/apps/agent-server/plugins/skill-library/client.js +348 -0
  116. package/template/apps/agent-server/plugins/skill-library/client.request.js +52 -0
  117. package/template/apps/agent-server/plugins/skill-library/client.transfer.js +48 -0
  118. package/template/apps/agent-server/plugins/skill-library/client.use.js +46 -0
  119. package/template/apps/agent-server/plugins/skill-library/default-roots.test.ts +84 -0
  120. package/template/apps/agent-server/plugins/skill-library/draft.d.mts +17 -0
  121. package/template/apps/agent-server/plugins/skill-library/draft.mjs +152 -0
  122. package/template/apps/agent-server/plugins/skill-library/draft.test.ts +287 -0
  123. package/template/apps/agent-server/plugins/skill-library/index.d.mts +49 -0
  124. package/template/apps/agent-server/plugins/skill-library/index.mjs +226 -0
  125. package/template/apps/agent-server/plugins/skill-library/package.json +24 -0
  126. package/template/apps/agent-server/plugins/skill-library/presentation/README.md +27 -0
  127. package/template/apps/agent-server/plugins/skill-library/presentation/UPSTREAM.md +54 -0
  128. package/template/apps/agent-server/plugins/skill-library/presentation/boot.test.ts +150 -0
  129. package/template/apps/agent-server/plugins/skill-library/presentation/client.js +146 -0
  130. package/template/apps/agent-server/plugins/skill-library/presentation/client.test.ts +195 -0
  131. package/template/apps/agent-server/plugins/skill-library/presentation/index.d.mts +9 -0
  132. package/template/apps/agent-server/plugins/skill-library/presentation/index.mjs +30 -0
  133. package/template/apps/agent-server/plugins/skill-library/presentation/metadata.test.ts +82 -0
  134. package/template/apps/agent-server/plugins/skill-library/presentation/package.json +21 -0
  135. package/template/apps/agent-server/plugins/skill-library/presentation/react-boot.test.ts +162 -0
  136. package/template/apps/agent-server/plugins/skill-library/skills.test.ts +342 -0
  137. package/template/apps/agent-server/plugins/skill-library/storage.mjs +293 -0
  138. package/template/apps/agent-server/plugins/skill-library/style.css +229 -0
  139. package/template/apps/agent-server/plugins/skill-library/test-fixture.ts +77 -0
  140. package/template/apps/agent-server/plugins/skill-library/workflow.d.mts +18 -0
  141. package/template/apps/agent-server/plugins/skill-library/workflow.mjs +189 -0
  142. package/template/apps/agent-server/plugins/skill-library/workflow.test.ts +164 -0
  143. package/template/apps/agent-server/plugins/skills/README.md +5 -0
  144. package/template/apps/agent-server/plugins/skills/windy-data-summary/SKILL.md +14 -0
  145. package/template/apps/agent-server/plugins/skills/windy-extension-guide/SKILL.md +14 -0
  146. package/template/apps/agent-server/plugins/skills/windy-office/SKILL.md +14 -0
  147. package/template/apps/agent-server/plugins/skills/windy-skill-capture/SKILL.md +14 -0
  148. package/template/apps/agent-server/plugins/skills/windy-source-compare/SKILL.md +14 -0
  149. package/template/apps/agent-server/plugins/subprocess.mjs +40 -0
  150. package/template/apps/agent-server/plugins/theme/README.md +18 -0
  151. package/template/apps/agent-server/plugins/theme/client.js +18 -0
  152. package/template/apps/agent-server/plugins/theme/index.d.mts +9 -0
  153. package/template/apps/agent-server/plugins/theme/index.mjs +18 -0
  154. package/template/apps/agent-server/plugins/theme/package.json +19 -0
  155. package/template/apps/agent-server/plugins/theme/source-tokens.ts +82 -0
  156. package/template/apps/agent-server/plugins/theme/sync-tokens.ts +12 -0
  157. package/template/apps/agent-server/plugins/theme/theme.test.ts +193 -0
  158. package/template/apps/agent-server/plugins/theme/tokens.json +166 -0
  159. package/template/apps/agent-server/plugins/tool-catalog/README.md +79 -0
  160. package/template/apps/agent-server/plugins/tool-catalog/categories.mjs +111 -0
  161. package/template/apps/agent-server/plugins/tool-catalog/categories.test.ts +118 -0
  162. package/template/apps/agent-server/plugins/tool-catalog/client-cache.test.ts +264 -0
  163. package/template/apps/agent-server/plugins/tool-catalog/client.js +333 -0
  164. package/template/apps/agent-server/plugins/tool-catalog/client.test.ts +136 -0
  165. package/template/apps/agent-server/plugins/tool-catalog/discovery.d.mts +42 -0
  166. package/template/apps/agent-server/plugins/tool-catalog/discovery.mjs +242 -0
  167. package/template/apps/agent-server/plugins/tool-catalog/discovery.test.ts +229 -0
  168. package/template/apps/agent-server/plugins/tool-catalog/index.d.mts +5 -0
  169. package/template/apps/agent-server/plugins/tool-catalog/index.mjs +91 -0
  170. package/template/apps/agent-server/plugins/tool-catalog/package.json +23 -0
  171. package/template/apps/agent-server/plugins/tool-catalog/presentation.d.mts +21 -0
  172. package/template/apps/agent-server/plugins/tool-catalog/presentation.mjs +153 -0
  173. package/template/apps/agent-server/plugins/tool-catalog/presentation.test.ts +166 -0
  174. package/template/apps/agent-server/plugins/tool-catalog/routes.test.ts +209 -0
  175. package/template/apps/agent-server/plugins/tool-catalog/style.css +155 -0
  176. package/template/apps/agent-server/plugins/tool-catalog/use-tool.test.ts +160 -0
  177. package/template/apps/agent-server/plugins/tool-presentation/README.md +7 -0
  178. package/template/apps/agent-server/plugins/tool-presentation/build-client.ts +29 -0
  179. package/template/apps/agent-server/plugins/tool-presentation/client.js +312 -0
  180. package/template/apps/agent-server/plugins/tool-presentation/client.results.js +9 -0
  181. package/template/apps/agent-server/plugins/tool-presentation/client.test.ts +178 -0
  182. package/template/apps/agent-server/plugins/tool-presentation/index.mjs +10 -0
  183. package/template/apps/agent-server/plugins/tool-presentation/package.json +24 -0
  184. package/template/apps/agent-server/plugins/tool-presentation/result-discovery.mjs +43 -0
  185. package/template/apps/agent-server/plugins/tool-presentation/result-model.d.mts +51 -0
  186. package/template/apps/agent-server/plugins/tool-presentation/result-model.mjs +96 -0
  187. package/template/apps/agent-server/plugins/workspace/README.md +5 -0
  188. package/template/apps/agent-server/plugins/workspace/index.mjs +8 -0
  189. package/template/apps/agent-server/plugins/workspace/package.json +10 -0
  190. package/template/apps/agent-server/plugins/workspace/style.css +124 -0
  191. package/template/apps/agent-server/project/host.ts +13 -0
  192. package/template/apps/agent-server/runtime/artifacts.ts +115 -0
  193. package/template/apps/agent-server/runtime/audit.nodecheck.ts +60 -0
  194. package/template/apps/agent-server/runtime/capacity.ts +61 -0
  195. package/template/apps/agent-server/runtime/client-completion-budget.nodecheck.ts +92 -0
  196. package/template/apps/agent-server/runtime/compatibility.ts +33 -0
  197. package/template/apps/agent-server/runtime/completions.ts +320 -0
  198. package/template/apps/agent-server/runtime/config.ts +246 -0
  199. package/template/apps/agent-server/runtime/context-budget.ts +70 -0
  200. package/template/apps/agent-server/runtime/context-plugin.ts +306 -0
  201. package/template/apps/agent-server/runtime/context.nodecheck.ts +241 -0
  202. package/template/apps/agent-server/runtime/contracts.ts +201 -0
  203. package/template/apps/agent-server/runtime/dsh-engine.ts +196 -0
  204. package/template/apps/agent-server/runtime/evaluation-plugin.ts +115 -0
  205. package/template/apps/agent-server/runtime/evaluation.nodecheck.ts +194 -0
  206. package/template/apps/agent-server/runtime/events.ts +71 -0
  207. package/template/apps/agent-server/runtime/governance.ts +194 -0
  208. package/template/apps/agent-server/runtime/index.ts +339 -0
  209. package/template/apps/agent-server/runtime/internal-output.ts +37 -0
  210. package/template/apps/agent-server/runtime/isolation.nodecheck.ts +287 -0
  211. package/template/apps/agent-server/runtime/model-payload.ts +97 -0
  212. package/template/apps/agent-server/runtime/model-plugin.ts +308 -0
  213. package/template/apps/agent-server/runtime/model-route.ts +34 -0
  214. package/template/apps/agent-server/runtime/model-usage.ts +51 -0
  215. package/template/apps/agent-server/runtime/model-wire.ts +45 -0
  216. package/template/apps/agent-server/runtime/native-authorization.nodecheck.ts +126 -0
  217. package/template/apps/agent-server/runtime/native-completion.nodecheck.ts +81 -0
  218. package/template/apps/agent-server/runtime/output-validation.ts +66 -0
  219. package/template/apps/agent-server/runtime/production-capacity.nodecheck.ts +121 -0
  220. package/template/apps/agent-server/runtime/questions-workflow.nodecheck.ts +249 -0
  221. package/template/apps/agent-server/runtime/report-breakdown.ts +79 -0
  222. package/template/apps/agent-server/runtime/reporting.ts +219 -0
  223. package/template/apps/agent-server/runtime/run-completion.ts +39 -0
  224. package/template/apps/agent-server/runtime/run-request-digest.ts +18 -0
  225. package/template/apps/agent-server/runtime/runtime-test-fixtures.ts +264 -0
  226. package/template/apps/agent-server/runtime/runtime.nodecheck.ts +150 -0
  227. package/template/apps/agent-server/runtime/store-idempotency.nodecheck.ts +74 -0
  228. package/template/apps/agent-server/runtime/store.ts +324 -0
  229. package/template/apps/agent-server/runtime/structured-output-mode.nodecheck.ts +51 -0
  230. package/template/apps/agent-server/runtime/tool-name.ts +6 -0
  231. package/template/apps/agent-server/runtime/tool-plugin.ts +201 -0
  232. package/template/apps/agent-server/runtime/vision-readiness.ts +200 -0
  233. package/template/apps/agent-server/scripts/confinement-check.mjs +103 -0
  234. package/template/apps/agent-server/scripts/coordinator-check.mjs +344 -0
  235. package/template/apps/agent-server/scripts/documents-delivery-check.mjs +309 -0
  236. package/template/apps/agent-server/scripts/office-preview-check.mjs +92 -0
  237. package/template/apps/agent-server/scripts/test-confinement.ts +58 -0
  238. package/template/apps/agent-server/scripts/test-coordinator.ts +36 -0
  239. package/template/apps/agent-server/scripts/test-runtime.ts +46 -0
  240. package/template/apps/agent-server/tsconfig.json +21 -0
  241. package/template/apps/server/Dockerfile +3 -0
  242. package/template/apps/server/package.json +5 -1
  243. package/template/apps/server/scripts/check-dsh-platform-example.ts +251 -0
  244. package/template/apps/server/src/agent/admin-catalog-bootstrap.ts +25 -0
  245. package/template/apps/server/src/agent/agent-session-bootstrap.ts +7 -8
  246. package/template/apps/server/src/agent/agent-session-facade.ts +12 -0
  247. package/template/apps/server/src/agent/agent-session-validation.ts +43 -0
  248. package/template/apps/server/src/agent/dsh-runtime-wire.test.ts +33 -0
  249. package/template/apps/server/src/agent/governance-runtime.ts +41 -0
  250. package/template/apps/server/src/agent/operation-catalog.test.ts +202 -0
  251. package/template/apps/server/src/agent/operation-catalog.ts +135 -0
  252. package/template/apps/server/src/agent/remote-runtime-response.ts +1 -1
  253. package/template/apps/server/src/agent/run-browser-visibility.test.ts +59 -0
  254. package/template/apps/server/src/agent/run-browser-visibility.ts +11 -0
  255. package/template/apps/server/src/agent/run-contracts.ts +1 -0
  256. package/template/apps/server/src/agent/run-definition-support.ts +9 -0
  257. package/template/apps/server/src/agent/run-operation-policy.ts +1 -0
  258. package/template/apps/server/src/agent/run-route-response.ts +35 -0
  259. package/template/apps/server/src/agent/run-routes.ts +46 -43
  260. package/template/apps/server/src/agent/runtime-bootstrap.ts +21 -20
  261. package/template/apps/server/src/agent/runtime-disabled-composition.ts +28 -0
  262. package/template/apps/server/src/agent/runtime-tool-composition.ts +2 -0
  263. package/template/apps/server/src/agent/session-projection-facade.ts +8 -9
  264. package/template/apps/server/src/agent/session-projection-governance.ts +10 -0
  265. package/template/apps/server/src/agent/session-projection-view.ts +19 -16
  266. package/template/apps/server/src/agent/session-recording-reader.contract.test.ts +131 -0
  267. package/template/apps/server/src/agent/session-recording-reader.ts +62 -0
  268. package/template/apps/server/src/agent/tool-catalog-audit.ts +22 -0
  269. package/template/apps/server/src/agent/tool-catalog-availability.ts +21 -0
  270. package/template/apps/server/src/agent/tool-catalog-routes.test.ts +103 -0
  271. package/template/apps/server/src/agent/tool-catalog-routes.ts +62 -0
  272. package/template/apps/server/src/agent/tool-catalog.test.ts +122 -0
  273. package/template/apps/server/src/agent/tool-catalog.ts +44 -0
  274. package/template/apps/server/src/agent/tool-registry.ts +45 -14
  275. package/template/apps/server/src/agent/workbench-bootstrap.ts +39 -0
  276. package/template/apps/server/src/agent/workbench-event-projection.ts +115 -0
  277. package/template/apps/server/src/agent/workbench-facade.contract.test.ts +189 -0
  278. package/template/apps/server/src/agent/workbench-facade.ts +339 -0
  279. package/template/apps/server/src/agent/workbench-recording.contract.test.ts +328 -0
  280. package/template/apps/server/src/agent/workbench-routes.ts +97 -0
  281. package/template/apps/server/src/agent/workbench-run-integration.test.ts +231 -0
  282. package/template/apps/server/src/agent/workbench-run-reader.ts +187 -0
  283. package/template/apps/server/src/agent/workbench-safe-result.ts +61 -0
  284. package/template/apps/server/src/agent/workbench-sse.ts +50 -0
  285. package/template/apps/server/src/agent/workflow-runtime-bootstrap.ts +9 -0
  286. package/template/apps/server/src/agent-skills/access.ts +88 -0
  287. package/template/apps/server/src/agent-skills/bootstrap.ts +49 -0
  288. package/template/apps/server/src/agent-skills/builtin-registration.ts +83 -0
  289. package/template/apps/server/src/agent-skills/builtins.ts +19 -0
  290. package/template/apps/server/src/agent-skills/bundle-zip.ts +163 -0
  291. package/template/apps/server/src/agent-skills/bundle.test.ts +79 -0
  292. package/template/apps/server/src/agent-skills/bundle.ts +133 -0
  293. package/template/apps/server/src/agent-skills/contracts.ts +46 -0
  294. package/template/apps/server/src/agent-skills/drizzle-repository.ts +125 -0
  295. package/template/apps/server/src/agent-skills/input.ts +29 -0
  296. package/template/apps/server/src/agent-skills/postgres.integration.test.ts +348 -0
  297. package/template/apps/server/src/agent-skills/read-routes.test.ts +116 -0
  298. package/template/apps/server/src/agent-skills/reader.ts +108 -0
  299. package/template/apps/server/src/agent-skills/repository.ts +105 -0
  300. package/template/apps/server/src/agent-skills/routes.ts +176 -0
  301. package/template/apps/server/src/agent-skills/service.test.ts +295 -0
  302. package/template/apps/server/src/agent-skills/service.ts +301 -0
  303. package/template/apps/server/src/agent-workflow/preset-registry.test.ts +137 -0
  304. package/template/apps/server/src/agent-workflow/preset-registry.ts +191 -0
  305. package/template/apps/server/src/agent-workflow/preset-routes.test.ts +94 -0
  306. package/template/apps/server/src/agent-workflow/preset-routes.ts +45 -0
  307. package/template/apps/server/src/agent-workflow/query-service.ts +36 -0
  308. package/template/apps/server/src/agent-workflow/recording-projection.contract.test.ts +196 -0
  309. package/template/apps/server/src/agent-workflow/recording-projection.ts +86 -0
  310. package/template/apps/server/src/ai-runtime-report/service.test.ts +10 -7
  311. package/template/apps/server/src/ai-runtime-report/service.ts +1 -1
  312. package/template/apps/server/src/app/agent-workflow-presets.ts +4 -0
  313. package/template/apps/server/src/app/dsh-skill-draft-audit.test.ts +195 -0
  314. package/template/apps/server/src/app/dsh-skill-draft-audit.ts +115 -0
  315. package/template/apps/server/src/app/dsh-workbench-audit.test.ts +71 -0
  316. package/template/apps/server/src/app/dsh-workbench-audit.ts +34 -0
  317. package/template/apps/server/src/app/dsh-workbench-handshake.test.ts +63 -0
  318. package/template/apps/server/src/app/dsh-workbench-handshake.ts +48 -0
  319. package/template/apps/server/src/app/dsh-workbench-http.test.ts +96 -0
  320. package/template/apps/server/src/app/dsh-workbench-lan-origin.test.ts +114 -0
  321. package/template/apps/server/src/app/dsh-workbench-launch.test.ts +70 -0
  322. package/template/apps/server/src/app/dsh-workbench-origin.test.ts +54 -0
  323. package/template/apps/server/src/app/dsh-workbench-proxy.ts +205 -0
  324. package/template/apps/server/src/app/dsh-workbench-session-conflict.test.ts +61 -0
  325. package/template/apps/server/src/app/dsh-workbench-session.ts +59 -0
  326. package/template/apps/server/src/app/dsh-workbench-socket-audit.test.ts +115 -0
  327. package/template/apps/server/src/app/dsh-workbench-socket.test.ts +246 -0
  328. package/template/apps/server/src/app/dsh-workbench-socket.ts +272 -0
  329. package/template/apps/server/src/app/dsh-workbench-test-support.ts +158 -0
  330. package/template/apps/server/src/app/dsh-workbench.test.ts +213 -0
  331. package/template/apps/server/src/app/dsh-workbench.ts +279 -0
  332. package/template/apps/server/src/app/workbench-public-origin.ts +16 -0
  333. package/template/apps/server/src/data-governance/user-plaintext-routes.test.ts +3 -0
  334. package/template/apps/server/src/http-app.ts +31 -0
  335. package/template/apps/server/src/mcp/adapter.ts +1 -0
  336. package/template/apps/server/src/module-composition.test.ts +23 -0
  337. package/template/apps/server/src/module-composition.ts +9 -2
  338. package/template/apps/server/src/observability/bootstrap.ts +12 -0
  339. package/template/apps/server/src/observability/diagnostic-failure-recorder.ts +94 -0
  340. package/template/apps/server/src/observability/diagnostic-http-contract.test.ts +42 -0
  341. package/template/apps/server/src/observability/diagnostic-index.test.ts +89 -0
  342. package/template/apps/server/src/observability/diagnostic-index.ts +88 -0
  343. package/template/apps/server/src/observability/diagnostic-repository.ts +67 -0
  344. package/template/apps/server/src/platform-app-bootstrap.ts +42 -0
  345. package/template/apps/server/src/platform-http-runtime.ts +6 -0
  346. package/template/apps/server/src/runtime-development.test.ts +25 -0
  347. package/template/apps/server/src/runtime-development.ts +6 -44
  348. package/template/apps/server/src/system/diagnostic-routes.test.ts +78 -0
  349. package/template/apps/server/src/system/diagnostic-routes.ts +66 -0
  350. package/template/apps/web/Dockerfile +9 -1
  351. package/template/apps/web/dev/start.ts +21 -10
  352. package/template/apps/web/dsh-workbench-location.ts +21 -0
  353. package/template/apps/web/dsh-workbench-proxy.test.ts +121 -0
  354. package/template/apps/web/dsh-workbench-proxy.ts +194 -0
  355. package/template/apps/web/package.json +3 -1
  356. package/template/apps/web/server.ts +27 -6
  357. package/template/apps/web/src/composables/useLoginFlow.ts +13 -1
  358. package/template/apps/web/src/pages/errors/PlatformErrorPage.vue +6 -0
  359. package/template/apps/web/src/pages/errors/PlatformErrorPage.webtest.ts +14 -1
  360. package/template/apps/web/src/pages/errors/error-page-extension.ts +1 -0
  361. package/template/apps/web/src/pages/system/AgentDebugPage.vue +14 -0
  362. package/template/apps/web/src/pages/system/AgentNativePage.vue +44 -0
  363. package/template/apps/web/src/pages/system/AgentSessionPage.vue +29 -8
  364. package/template/apps/web/src/pages/system/AgentToolsPage.vue +76 -0
  365. package/template/apps/web/src/pages/system/AgentWorkflowPage.vue +20 -7
  366. package/template/apps/web/src/pages/system/DiagnosticLookupPage.vue +56 -0
  367. package/template/apps/web/src/pages/system/DiagnosticLookupPage.webtest.ts +99 -0
  368. package/template/apps/web/src/pages/system/SystemAgentSkillsPage.vue +88 -0
  369. package/template/apps/web/src/pages/system/components/DiagnosticRecordDetails.vue +52 -0
  370. package/template/apps/web/src/pages/system/components/agent-skills/AgentSkillDetailDialog.vue +166 -0
  371. package/template/apps/web/src/pages/system/components/agent-skills/AgentSkillGovernanceActionDialog.vue +51 -0
  372. package/template/apps/web/src/pages/system/components/agent-skills/AgentSkillImportDialog.vue +320 -0
  373. package/template/apps/web/src/pages/system/components/agent-skills/AgentSkillImportDialog.webtest.ts +96 -0
  374. package/template/apps/web/src/pages/system/components/agent-skills/AgentSkillsTable.vue +69 -0
  375. package/template/apps/web/src/pages/system/components/agent-workbench/AgentWorkbench.vue +236 -0
  376. package/template/apps/web/src/pages/system/components/agent-workbench/DraftLeaveDialog.vue +34 -0
  377. package/template/apps/web/src/pages/system/components/agent-workbench/ReplayEventDetail.vue +175 -0
  378. package/template/apps/web/src/pages/system/components/agent-workbench/SessionReplayTimeline.vue +142 -0
  379. package/template/apps/web/src/pages/system/components/agent-workbench/SessionReplayTimeline.webtest.ts +242 -0
  380. package/template/apps/web/src/pages/system/components/agent-workbench/TestRunComposer.vue +97 -0
  381. package/template/apps/web/src/pages/system/components/agent-workbench/ToolCatalogPanel.vue +100 -0
  382. package/template/apps/web/src/pages/system/components/agent-workbench/ToolCatalogPanel.webtest.ts +55 -0
  383. package/template/apps/web/src/pages/system/components/agent-workbench/ToolRuleDetail.vue +81 -0
  384. package/template/apps/web/src/pages/system/components/agent-workbench/WorkbenchSessionList.vue +57 -0
  385. package/template/apps/web/src/pages/system/components/agent-workbench/catalog-presenter.ts +20 -0
  386. package/template/apps/web/src/pages/system/components/agent-workbench/replay-presenter.ts +94 -0
  387. package/template/apps/web/src/pages/system/components/agent-workflow/WorkflowPresetCatalog.vue +82 -0
  388. package/template/apps/web/src/pages/system/components/agent-workflow/WorkflowPresetCatalog.webtest.ts +57 -0
  389. package/template/apps/web/src/pages/system/composables/useAgentSkillsGovernance.ts +105 -0
  390. package/template/apps/web/src/pages/system/composables/useAgentWorkbench.ts +298 -0
  391. package/template/apps/web/src/pages/system/composables/useAgentWorkbench.webtest.ts +164 -0
  392. package/template/apps/web/src/pages/system/composables/useAgentWorkflowPresets.ts +44 -0
  393. package/template/apps/web/src/pages/system/composables/useDiagnosticLookup.ts +64 -0
  394. package/template/apps/web/src/pages/system/composables/useSessionReplay.ts +48 -0
  395. package/template/apps/web/src/router/error-navigation.ts +3 -1
  396. package/template/apps/web/src/router/error-navigation.webtest.ts +14 -2
  397. package/template/apps/web/src/router/index.ts +8 -45
  398. package/template/apps/web/src/router/platform-admin-pages.ts +79 -0
  399. package/template/apps/web/src/router/platform-admin-route-bindings.ts +12 -0
  400. package/template/apps/web/src/services/agent-admin-api.ts +155 -0
  401. package/template/apps/web/src/services/agent-admin-api.webtest.ts +120 -0
  402. package/template/apps/web/src/services/agent-skills-api.ts +55 -0
  403. package/template/apps/web/src/services/agent-workbench-event.ts +60 -0
  404. package/template/apps/web/src/services/agent-workflow-api.ts +12 -0
  405. package/template/apps/web/src/services/diagnostics-api.ts +12 -0
  406. package/template/apps/web/src/services/http.ts +18 -0
  407. package/template/apps/web/src/services/http.webtest.ts +51 -0
  408. package/template/apps/web/vite.config.ts +39 -0
  409. package/template/deploy/dsh/README.md +5 -0
  410. package/template/deploy/dsh/documents/README.md +9 -0
  411. package/template/deploy/dsh/documents/requirements.in +6 -0
  412. package/template/deploy/dsh/documents/requirements.lock +72 -0
  413. package/template/docker-compose.yml +24 -10
  414. package/template/docs/adr/0004-embedded-dsh-runtime.md +9 -0
  415. package/template/docs/architecture/agent-admin-workbench-implementation.md +73 -0
  416. package/template/docs/architecture/agent-admin-workbench-plan.md +41 -0
  417. package/template/docs/architecture/agent-harness.md +6 -0
  418. package/template/docs/architecture/agent-runtime-compatibility.md +2 -0
  419. package/template/docs/architecture/embedded-dsh-integration.md +44 -0
  420. package/template/docs/development/dsh-plugins.md +55 -0
  421. package/template/docs/operations/dsh-agent-migration.md +98 -0
  422. package/template/docs/platform/agent-production-store.md +5 -78
  423. package/template/docs/platform/agent-runtime-observability.md +2 -0
  424. package/template/docs/platform/agent-runtime.md +2 -0
  425. package/template/docs/platform/agent-skills.md +25 -0
  426. package/template/package.json +4 -3
  427. package/template/packages/database/drizzle/0064_dsh_skills_diagnostics.sql +42 -0
  428. package/template/packages/database/drizzle/meta/0064_snapshot.json +15349 -0
  429. package/template/packages/database/drizzle/meta/_journal.json +7 -0
  430. package/template/packages/database/package.json +2 -2
  431. package/template/packages/database/src/schema/agent-skills.ts +65 -0
  432. package/template/packages/database/src/schema/diagnostics.ts +27 -0
  433. package/template/packages/database/src/schema/index.ts +8 -0
  434. package/template/packages/modules/package.json +1 -1
  435. package/template/packages/modules/src/ai-operation-composition.ts +9 -0
  436. package/template/packages/modules/src/ai-operation-visibility.test.ts +33 -0
  437. package/template/packages/modules/src/manifest.ts +2 -0
  438. package/template/packages/modules/src/system-admin-routes.ts +40 -0
  439. package/template/packages/modules/src/system-admin-ui-catalog.ts +24 -11
  440. package/template/packages/modules/src/system-agent-admin-bindings.ts +44 -0
  441. package/template/packages/modules/src/system-agent-admin-menus.ts +46 -0
  442. package/template/packages/modules/src/system-agent-admin-registration.test.ts +52 -0
  443. package/template/packages/modules/src/system-agent-audit-actions.ts +8 -0
  444. package/template/packages/modules/src/system-agent-dsh.ts +119 -0
  445. package/template/packages/modules/src/system-ai-api-bindings.ts +2 -0
  446. package/template/packages/modules/src/system-api-permissions.ts +9 -0
  447. package/template/packages/modules/src/system-audit-actions.ts +36 -0
  448. package/template/packages/modules/src/system-features.ts +24 -0
  449. package/template/packages/modules/src/system-module-audit-selection.ts +25 -0
  450. package/template/packages/modules/src/system-module-catalog.ts +22 -40
  451. package/template/packages/modules/src/system-module-ownership.ts +12 -0
  452. package/template/packages/modules/src/system-modules.ts +16 -3
  453. package/template/packages/modules/src/system-permissions.ts +15 -0
  454. package/template/packages/server-sdk/index.ts +2 -0
  455. package/template/packages/server-sdk/package.json +2 -2
  456. package/template/packages/server-sdk/src/agent-session-provider.ts +19 -0
  457. package/template/packages/shared/index.ts +14 -0
  458. package/template/packages/shared/package.json +1 -1
  459. package/template/packages/shared/src/agent-admin-catalog.ts +73 -0
  460. package/template/packages/shared/src/agent-skills.ts +68 -0
  461. package/template/packages/shared/src/agent-workbench.ts +100 -0
  462. package/template/packages/shared/src/agent-workflow-presets.ts +26 -0
  463. package/template/packages/shared/src/diagnostics.ts +13 -0
  464. package/template/packages/shared/src/rbac.ts +1 -0
  465. package/template/apps/agent-server/install-python-dependencies.sh +0 -92
  466. package/template/apps/agent-server/pyproject.toml +0 -51
  467. package/template/apps/agent-server/src/southwind_agent_server/__init__.py +0 -5
  468. package/template/apps/agent-server/src/southwind_agent_server/app.py +0 -344
  469. package/template/apps/agent-server/src/southwind_agent_server/approval_resolution.py +0 -30
  470. package/template/apps/agent-server/src/southwind_agent_server/artifact_input.py +0 -153
  471. package/template/apps/agent-server/src/southwind_agent_server/asgi.py +0 -8
  472. package/template/apps/agent-server/src/southwind_agent_server/attempt_context.py +0 -199
  473. package/template/apps/agent-server/src/southwind_agent_server/attempt_context_projection.py +0 -203
  474. package/template/apps/agent-server/src/southwind_agent_server/client_completion_contracts.py +0 -61
  475. package/template/apps/agent-server/src/southwind_agent_server/client_completion_governance.py +0 -82
  476. package/template/apps/agent-server/src/southwind_agent_server/client_completion_routes.py +0 -121
  477. package/template/apps/agent-server/src/southwind_agent_server/client_completion_runtime.py +0 -158
  478. package/template/apps/agent-server/src/southwind_agent_server/config.py +0 -267
  479. package/template/apps/agent-server/src/southwind_agent_server/context_message_digest.py +0 -24
  480. package/template/apps/agent-server/src/southwind_agent_server/context_version_contracts.py +0 -71
  481. package/template/apps/agent-server/src/southwind_agent_server/context_version_port.py +0 -307
  482. package/template/apps/agent-server/src/southwind_agent_server/contracts.py +0 -297
  483. package/template/apps/agent-server/src/southwind_agent_server/deterministic.py +0 -63
  484. package/template/apps/agent-server/src/southwind_agent_server/engine.py +0 -134
  485. package/template/apps/agent-server/src/southwind_agent_server/engine_capacity.py +0 -31
  486. package/template/apps/agent-server/src/southwind_agent_server/engine_identity.py +0 -2
  487. package/template/apps/agent-server/src/southwind_agent_server/fingerprint.py +0 -61
  488. package/template/apps/agent-server/src/southwind_agent_server/health_routes.py +0 -93
  489. package/template/apps/agent-server/src/southwind_agent_server/http_helpers.py +0 -62
  490. package/template/apps/agent-server/src/southwind_agent_server/lease.py +0 -15
  491. package/template/apps/agent-server/src/southwind_agent_server/multimodal.py +0 -76
  492. package/template/apps/agent-server/src/southwind_agent_server/openai_engine.py +0 -329
  493. package/template/apps/agent-server/src/southwind_agent_server/openai_engine_validation.py +0 -165
  494. package/template/apps/agent-server/src/southwind_agent_server/openai_provider.py +0 -345
  495. package/template/apps/agent-server/src/southwind_agent_server/postgres_report_insert.py +0 -37
  496. package/template/apps/agent-server/src/southwind_agent_server/postgres_report_queries.py +0 -235
  497. package/template/apps/agent-server/src/southwind_agent_server/postgres_report_replay.py +0 -44
  498. package/template/apps/agent-server/src/southwind_agent_server/postgres_report_status.py +0 -83
  499. package/template/apps/agent-server/src/southwind_agent_server/postgres_report_store.py +0 -336
  500. package/template/apps/agent-server/src/southwind_agent_server/postgres_report_summary.py +0 -304
  501. package/template/apps/agent-server/src/southwind_agent_server/postgres_store.py +0 -335
  502. package/template/apps/agent-server/src/southwind_agent_server/postgres_store_backend.py +0 -333
  503. package/template/apps/agent-server/src/southwind_agent_server/provider_audit.py +0 -144
  504. package/template/apps/agent-server/src/southwind_agent_server/provider_governance.py +0 -309
  505. package/template/apps/agent-server/src/southwind_agent_server/provider_output_guidance.py +0 -34
  506. package/template/apps/agent-server/src/southwind_agent_server/readiness_pin.py +0 -37
  507. package/template/apps/agent-server/src/southwind_agent_server/report_lifecycle.py +0 -218
  508. package/template/apps/agent-server/src/southwind_agent_server/report_metrics.py +0 -149
  509. package/template/apps/agent-server/src/southwind_agent_server/report_presenter.py +0 -300
  510. package/template/apps/agent-server/src/southwind_agent_server/report_routes.py +0 -132
  511. package/template/apps/agent-server/src/southwind_agent_server/report_store.py +0 -298
  512. package/template/apps/agent-server/src/southwind_agent_server/report_store_protocol.py +0 -75
  513. package/template/apps/agent-server/src/southwind_agent_server/report_types.py +0 -118
  514. package/template/apps/agent-server/src/southwind_agent_server/run_admission.py +0 -64
  515. package/template/apps/agent-server/src/southwind_agent_server/run_capacity.py +0 -59
  516. package/template/apps/agent-server/src/southwind_agent_server/runtime_budget.py +0 -74
  517. package/template/apps/agent-server/src/southwind_agent_server/runtime_compatibility.py +0 -89
  518. package/template/apps/agent-server/src/southwind_agent_server/runtime_factory.py +0 -105
  519. package/template/apps/agent-server/src/southwind_agent_server/runtime_logging.py +0 -57
  520. package/template/apps/agent-server/src/southwind_agent_server/service.py +0 -325
  521. package/template/apps/agent-server/src/southwind_agent_server/service_control.py +0 -64
  522. package/template/apps/agent-server/src/southwind_agent_server/service_errors.py +0 -4
  523. package/template/apps/agent-server/src/southwind_agent_server/service_execution.py +0 -34
  524. package/template/apps/agent-server/src/southwind_agent_server/service_tasks.py +0 -34
  525. package/template/apps/agent-server/src/southwind_agent_server/signal_events.py +0 -53
  526. package/template/apps/agent-server/src/southwind_agent_server/sqlite_catalog.py +0 -118
  527. package/template/apps/agent-server/src/southwind_agent_server/sqlite_errors.py +0 -2
  528. package/template/apps/agent-server/src/southwind_agent_server/sqlite_schema.py +0 -73
  529. package/template/apps/agent-server/src/southwind_agent_server/sqlite_serialization.py +0 -16
  530. package/template/apps/agent-server/src/southwind_agent_server/sqlite_store.py +0 -350
  531. package/template/apps/agent-server/src/southwind_agent_server/sse.py +0 -41
  532. package/template/apps/agent-server/src/southwind_agent_server/store.py +0 -255
  533. package/template/apps/agent-server/src/southwind_agent_server/store_cipher.py +0 -40
  534. package/template/apps/agent-server/src/southwind_agent_server/structured_logging.py +0 -145
  535. package/template/apps/agent-server/src/southwind_agent_server/telemetry.py +0 -93
  536. package/template/apps/agent-server/src/southwind_agent_server/tool_host.py +0 -152
  537. package/template/apps/agent-server/src/southwind_agent_server/trajectory.py +0 -137
  538. package/template/apps/agent-server/src/southwind_agent_server/unavailable_engine.py +0 -58
  539. package/template/apps/agent-server/src/southwind_agent_server/vision_probe.py +0 -87
  540. package/template/apps/agent-server/src/southwind_agent_server/vision_requirement.py +0 -28
  541. package/template/apps/agent-server/src/southwind_agent_server/vlm_readiness.py +0 -247
  542. package/template/apps/agent-server/tests/__init__.py +0 -1
  543. package/template/apps/agent-server/tests/openai_provider_test_support.py +0 -131
  544. package/template/apps/agent-server/tests/test_api.py +0 -305
  545. package/template/apps/agent-server/tests/test_artifact_input.py +0 -110
  546. package/template/apps/agent-server/tests/test_client_completion.py +0 -230
  547. package/template/apps/agent-server/tests/test_config.py +0 -106
  548. package/template/apps/agent-server/tests/test_fingerprint.py +0 -10
  549. package/template/apps/agent-server/tests/test_multimodal.py +0 -81
  550. package/template/apps/agent-server/tests/test_openai_provider.py +0 -320
  551. package/template/apps/agent-server/tests/test_postgres_report_status.py +0 -59
  552. package/template/apps/agent-server/tests/test_postgres_report_summary.py +0 -298
  553. package/template/apps/agent-server/tests/test_postgres_store.py +0 -135
  554. package/template/apps/agent-server/tests/test_provider_attempt_reporting.py +0 -140
  555. package/template/apps/agent-server/tests/test_provider_governance.py +0 -276
  556. package/template/apps/agent-server/tests/test_report_attempt_lifecycle.py +0 -126
  557. package/template/apps/agent-server/tests/test_report_resilience.py +0 -183
  558. package/template/apps/agent-server/tests/test_report_routes.py +0 -143
  559. package/template/apps/agent-server/tests/test_report_store.py +0 -347
  560. package/template/apps/agent-server/tests/test_report_summary_parity.py +0 -116
  561. package/template/apps/agent-server/tests/test_report_terminal_sync.py +0 -177
  562. package/template/apps/agent-server/tests/test_run_capacity.py +0 -112
  563. package/template/apps/agent-server/tests/test_run_operational_logging.py +0 -114
  564. package/template/apps/agent-server/tests/test_runtime_compatibility.py +0 -119
  565. package/template/apps/agent-server/tests/test_runtime_factory_readiness.py +0 -52
  566. package/template/apps/agent-server/tests/test_sqlite_store.py +0 -182
  567. package/template/apps/agent-server/tests/test_structured_logging.py +0 -142
  568. package/template/apps/agent-server/tests/test_telemetry.py +0 -25
  569. package/template/apps/agent-server/tests/test_tool_approval.py +0 -28
  570. package/template/apps/agent-server/tests/test_tool_structured_output.py +0 -347
  571. package/template/apps/agent-server/tests/test_trajectory.py +0 -91
  572. package/template/apps/agent-server/tests/test_vision_readiness_enforcement.py +0 -72
  573. package/template/apps/agent-server/tests/test_vlm_readiness.py +0 -106
  574. package/template/apps/agent-server/uv.lock +0 -831
@@ -0,0 +1,251 @@
1
+ /** Synthetic acceptance: actual platform query Tool + official DSH Loop; no customer data or live model. */
2
+ import assert from "node:assert/strict";
3
+ import { resolve } from "node:path";
4
+ import { mkdir, rm, writeFile } from "node:fs/promises";
5
+ import {
6
+ createFoundationSnapshot,
7
+ loadSystemModules,
8
+ } from "../src/foundation.ts";
9
+ import { createServerRuntime } from "../src/runtime.ts";
10
+ import { createSystemRepositories } from "../src/system/seed.ts";
11
+ import { createSystemToolHandlers } from "../src/agent/routes.ts";
12
+ import { GovernedToolRegistry } from "../src/agent/tool-registry.ts";
13
+ import { RemoteAgentRuntime } from "../src/agent/remote-runtime.ts";
14
+ import { toolDefinitions } from "../src/agent/run-definition-support.ts";
15
+ import { platformBuiltinAgentSkills } from "../src/agent-skills/builtins.ts";
16
+
17
+ const root = resolve(import.meta.dir, "../../..");
18
+ const modules = loadSystemModules();
19
+ const runtime = createServerRuntime(
20
+ { WINDY_DEV_ADMIN_TOKEN: "synthetic-example" },
21
+ { featureCatalog: modules.flatMap((module) => module.features) },
22
+ );
23
+ const context = await runtime.createGuardContext(
24
+ new Request("http://fixture/api/agent/runs", {
25
+ headers: { authorization: "Bearer synthetic-example" },
26
+ }),
27
+ );
28
+ const repositories = createSystemRepositories(
29
+ createFoundationSnapshot(undefined, modules),
30
+ );
31
+ const registry = new GovernedToolRegistry(
32
+ modules,
33
+ createSystemToolHandlers(repositories, runtime),
34
+ runtime,
35
+ );
36
+ const token = crypto.randomUUID() + crypto.randomUUID();
37
+ let modelCalls = 0,
38
+ toolCalls = 0,
39
+ userCount = -1;
40
+ const host = Bun.serve({
41
+ hostname: "127.0.0.1",
42
+ port: 0,
43
+ async fetch(request) {
44
+ const path = new URL(request.url).pathname;
45
+ if (path === "/api/internal/agent/tools/execute") {
46
+ assert.equal(request.headers.get("authorization"), `Bearer ${token}`);
47
+ const body = (await request.json()) as {
48
+ executionGrant: string;
49
+ toolKey: string;
50
+ arguments: Record<string, unknown>;
51
+ };
52
+ assert.equal(body.executionGrant, "synthetic-grant");
53
+ assert.equal(body.toolKey, "system.users.list");
54
+ const value = await registry.execute(
55
+ body.toolKey,
56
+ body.arguments,
57
+ context,
58
+ );
59
+ userCount = (value as { total: number }).total;
60
+ toolCalls++;
61
+ return Response.json({ value });
62
+ }
63
+ if (path !== "/v1/chat/completions")
64
+ return new Response(null, { status: 404 });
65
+ const body = (await request.json()) as {
66
+ messages: { role: string; content: unknown }[];
67
+ tools: { function: { name: string } }[];
68
+ };
69
+ modelCalls++;
70
+ assert(
71
+ JSON.stringify(body.messages).includes("平台工具查询") ||
72
+ JSON.stringify(body.messages).includes("当前会话实际可见的工具目录"),
73
+ );
74
+ const done = body.messages.at(-1)?.role === "tool";
75
+ const delta = done
76
+ ? {
77
+ content: JSON.stringify({
78
+ answer: `当前授权平台用户共${userCount}名`,
79
+ }),
80
+ }
81
+ : {
82
+ tool_calls: [
83
+ {
84
+ index: 0,
85
+ id: "synthetic-call",
86
+ type: "function",
87
+ function: {
88
+ name: body.tools[0]!.function.name,
89
+ arguments: '{"page":1,"pageSize":10}',
90
+ },
91
+ },
92
+ ],
93
+ };
94
+ return new Response(
95
+ `data: ${JSON.stringify({ choices: [{ delta, finish_reason: done ? "stop" : "tool_calls" }] })}\n\ndata: ${JSON.stringify({ choices: [], usage: { prompt_tokens: 100, completion_tokens: 10 } })}\n\ndata: [DONE]\n\n`,
96
+ { headers: { "content-type": "text/event-stream" } },
97
+ );
98
+ },
99
+ });
100
+ const outputRoot =
101
+ process.env.WINDY_DSH_EXAMPLE_OUTPUT ||
102
+ resolve(root, ".artifacts/dsh-platform-example");
103
+ await mkdir(outputRoot, { recursive: true });
104
+ const out = resolve(root, "apps/agent-server/.tmp/platform-example");
105
+ await mkdir(out, { recursive: true });
106
+ const entry = resolve(out, "entry.ts");
107
+ await writeFile(
108
+ entry,
109
+ `import {startAgentServer} from ${JSON.stringify(resolve(root, "apps/agent-server/main.ts"))}; const a=await startAgentServer(0); console.log(JSON.stringify({port:a.server.address().port})); process.on("SIGTERM",()=>void a.close().then(()=>process.exit(0)));`,
110
+ );
111
+ const built = await Bun.build({
112
+ entrypoints: [entry],
113
+ target: "node",
114
+ outdir: out,
115
+ external: ["@deepseek-ai/*", "ajv", "zod", "sharp", "ws"],
116
+ });
117
+ assert(built.success, built.logs.map(String).join("\n"));
118
+ const child = Bun.spawn(["node", resolve(out, "entry.js")], {
119
+ cwd: resolve(root, "apps/agent-server"),
120
+ env: {
121
+ ...process.env,
122
+ AGENT_SERVER_INTERNAL_TOKEN: token,
123
+ AGENT_RUNTIME_DATABASE_PATH: ":memory:",
124
+ QWEN_API_URL: `${host.url.origin}/v1`,
125
+ QWEN_MODEL: "synthetic-model",
126
+ AI_TOOL_HOST_URL: host.url.origin,
127
+ AI_PROVIDER_MAX_CONCURRENT_RUNS: "1",
128
+ AI_PROVIDER_MAX_QUEUE_DEPTH: "0",
129
+ AGENT_DSH_HOME: resolve(out, "unused-native-home"),
130
+ },
131
+ stdout: "pipe",
132
+ stderr: "inherit",
133
+ });
134
+ try {
135
+ const reader = child.stdout.getReader();
136
+ let ready = "";
137
+ while (!ready.includes("\n")) {
138
+ const chunk = await reader.read();
139
+ assert(!chunk.done, "agent startup failed");
140
+ ready += new TextDecoder().decode(chunk.value);
141
+ }
142
+ const port = JSON.parse(ready.split("\n")[0]!).port as number;
143
+ const remote = new RemoteAgentRuntime({
144
+ baseUrl: `http://127.0.0.1:${port}`,
145
+ internalToken: token,
146
+ toolHostUrl: host.url.origin,
147
+ compatibilityMode: "require-v1",
148
+ });
149
+ const fields = [
150
+ "instructions",
151
+ "user-prompt",
152
+ "tool-definitions",
153
+ "output-schema",
154
+ "provider-output",
155
+ "tool-results",
156
+ ] as const;
157
+ const created = await remote.start(
158
+ {
159
+ kind: "agent",
160
+ operationKey: "system.agent.example",
161
+ input: {},
162
+ instructions: platformBuiltinAgentSkills[0]!.markdown,
163
+ userPrompt: "按当前权限查询平台用户数,并形成可核验汇总",
164
+ inputModalities: ["text"],
165
+ requiredCapabilities: ["text-generation"],
166
+ artifacts: [],
167
+ outputSchemaKey: "system.agent.example.v1",
168
+ outputSchema: {
169
+ type: "object",
170
+ properties: { answer: { type: "string" } },
171
+ required: ["answer"],
172
+ additionalProperties: false,
173
+ },
174
+ allowedTools: toolDefinitions(modules, ["system.users.list"]),
175
+ limits: {
176
+ maxDurationSeconds: 30,
177
+ maxInputBytes: 65536,
178
+ maxOutputBytes: 65536,
179
+ },
180
+ providerEgress: {
181
+ mode: "configured-endpoint",
182
+ deploymentKey: "ai.openai-compatible",
183
+ },
184
+ providerDataPolicy: {
185
+ inputFields: [],
186
+ envelopeFields: fields.map((field) => ({
187
+ field,
188
+ classification: "internal",
189
+ dlpAction: "reject",
190
+ })),
191
+ },
192
+ toolNetworkPolicy: { mode: "forbidden" },
193
+ executionGrant: "synthetic-grant",
194
+ release: {
195
+ releaseId: "synthetic-release",
196
+ operationVersion: "1",
197
+ workflowVersion: "1",
198
+ promptVersion: "1",
199
+ routeVersion: "1",
200
+ outputSchemaVersion: "1",
201
+ toolSchemaVersion: "1",
202
+ manifestDigest: "1",
203
+ },
204
+ traceId: "synthetic-trace",
205
+ reporting: { actorId: context.actor.id, actorType: "user" },
206
+ },
207
+ "synthetic-platform-example",
208
+ );
209
+ const events = await remote.events(
210
+ created.runId,
211
+ 0,
212
+ AbortSignal.timeout(45000),
213
+ );
214
+ const stream = await events.text();
215
+ assert.match(stream, /event: run.completed/);
216
+ assert.match(stream, /event: tool.completed/);
217
+ const response = await remote.result(created.runId);
218
+ const result = (await response.json()) as { output: { answer: string } };
219
+ assert.equal(result.output.answer, `当前授权平台用户共${userCount}名`);
220
+ assert.equal(toolCalls, 1);
221
+ assert.equal(modelCalls, 2);
222
+ assert(userCount > 0);
223
+ const evidence = {
224
+ synthetic: true,
225
+ skill: "windy-tool-query",
226
+ tool: "system.users.list",
227
+ modelCalls,
228
+ toolCalls,
229
+ userCount,
230
+ answer: result.output.answer,
231
+ checks: [
232
+ "actual-platform-tool-registry",
233
+ "manifest-schema-forwarding",
234
+ "official-dsh-loop",
235
+ "canonical-sse",
236
+ "typed-output",
237
+ "provider-synthetic",
238
+ ],
239
+ };
240
+ await writeFile(
241
+ resolve(outputRoot, "platform-example.json"),
242
+ JSON.stringify(evidence, null, 2),
243
+ );
244
+ console.log(JSON.stringify(evidence));
245
+ reader.releaseLock();
246
+ } finally {
247
+ child.kill("SIGTERM");
248
+ await child.exited;
249
+ host.stop(true);
250
+ await rm(out, { recursive: true, force: true });
251
+ }
@@ -0,0 +1,25 @@
1
+ import type { ModuleAiOperationReadinessPortV1 } from "@southwind-ai/server-sdk";
2
+ import type { AgentPlatformRuntimeInput } from "./runtime-bootstrap-input.js";
3
+ import type { composeAgentToolRuntime } from "./runtime-tool-composition.js";
4
+ import { registerAgentAdminCatalogRoutes } from "./tool-catalog-routes.js";
5
+
6
+ export interface AgentAdminReadinessRef {
7
+ current?: ModuleAiOperationReadinessPortV1;
8
+ }
9
+
10
+ export function registerAgentAdminCatalogRuntime(
11
+ input: AgentPlatformRuntimeInput,
12
+ tools: ReturnType<typeof composeAgentToolRuntime>,
13
+ readiness: AgentAdminReadinessRef,
14
+ ) {
15
+ registerAgentAdminCatalogRoutes(input.app, {
16
+ modules: input.modules,
17
+ hosts: input.hosts,
18
+ runtime: input.runtime,
19
+ registry: tools.toolRegistry,
20
+ authorizer: tools.routeAuthorizer,
21
+ runtimeAvailable: () => input.platformConfig.enableAI,
22
+ operationReadiness: async (operationKey) =>
23
+ (await readiness.current?.inspect({ operationKey }))?.status === "ready",
24
+ });
25
+ }
@@ -11,13 +11,12 @@ export function registerAgentSessions(input: {
11
11
  runtime: ReturnType<typeof createServerRuntime>;
12
12
  secret: string;
13
13
  }) {
14
- if (!input.hosts.agentSessionProviders.length) return;
15
- registerAgentSessionRoutesV1(
16
- input.app,
17
- new AgentSessionFacadeV1(
18
- input.hosts,
19
- input.runtime,
20
- new AgentSessionIdCodecV1(input.secret),
21
- ),
14
+ const facade = new AgentSessionFacadeV1(
15
+ input.hosts,
16
+ input.runtime,
17
+ new AgentSessionIdCodecV1(input.secret),
22
18
  );
19
+ if (!input.hosts.agentSessionProviders.length) return facade;
20
+ registerAgentSessionRoutesV1(input.app, facade);
21
+ return facade;
23
22
  }
@@ -2,6 +2,8 @@ import { randomUUIDv7 } from "bun";
2
2
  import {
3
3
  MODULE_AGENT_SESSION_SCHEMA_VERSION,
4
4
  type ModuleAgentSessionSummaryV1,
5
+ type ModuleAgentSessionRunReferenceV1,
6
+ type ModuleAgentSessionWorkflowReferenceV1,
5
7
  } from "@southwind-ai/server-sdk";
6
8
  import { evaluateAccessGuards } from "../access-guards.js";
7
9
  import { auditActor, type RequestGuardContext } from "../guards.js";
@@ -33,12 +35,15 @@ export interface AgentSessionSummaryDtoV1 {
33
35
  }
34
36
 
35
37
  export interface AgentSessionDetailDtoV1 extends AgentSessionSummaryDtoV1 {
38
+ readonly truncated?: boolean;
36
39
  readonly messages: readonly {
37
40
  sequence: number;
38
41
  role: "user" | "assistant";
39
42
  content: string;
40
43
  createdAt: string;
41
44
  }[];
45
+ readonly runRefs?: readonly ModuleAgentSessionRunReferenceV1[];
46
+ readonly workflowRefs?: readonly ModuleAgentSessionWorkflowReferenceV1[];
42
47
  }
43
48
 
44
49
  export class AgentSessionFacadeError extends Error {
@@ -156,6 +161,13 @@ export class AgentSessionFacadeV1 {
156
161
  session: {
157
162
  ...this.project(entry, actor.id, validated),
158
163
  messages: validated.messages,
164
+ ...(validated.truncated !== undefined
165
+ ? { truncated: validated.truncated }
166
+ : {}),
167
+ ...(validated.runRefs ? { runRefs: validated.runRefs } : {}),
168
+ ...(validated.workflowRefs
169
+ ? { workflowRefs: validated.workflowRefs }
170
+ : {}),
159
171
  } satisfies AgentSessionDetailDtoV1,
160
172
  };
161
173
  } catch (error) {
@@ -66,6 +66,49 @@ export function validateAgentSessionDetail(
66
66
  previousSequence = message.sequence;
67
67
  }
68
68
  if (totalChars > MAX_TOTAL_MESSAGE_CHARS) invalidProvider();
69
+ if (value.truncated !== undefined && typeof value.truncated !== "boolean")
70
+ invalidProvider();
71
+ const messageSequences = new Set(
72
+ value.messages.map(({ sequence }) => sequence),
73
+ );
74
+ if (value.runRefs !== undefined) {
75
+ if (!Array.isArray(value.runRefs) || value.runRefs.length > 200)
76
+ invalidProvider();
77
+ const ids = new Set<string>();
78
+ for (const ref of value.runRefs) {
79
+ if (
80
+ !ref ||
81
+ !validText(ref.runId, 200) ||
82
+ !validText(ref.operationKey, 200) ||
83
+ !/^[a-z][a-z0-9]*(?:[.-][a-z0-9]+)*$/.test(ref.operationKey) ||
84
+ ids.has(ref.runId) ||
85
+ (ref.sessionId !== undefined && !validText(ref.sessionId, 200)) ||
86
+ (ref.turnId !== undefined && !validText(ref.turnId, 200)) ||
87
+ (ref.workflowRunId !== undefined &&
88
+ !validText(ref.workflowRunId, 200)) ||
89
+ (ref.messageSequence !== undefined &&
90
+ !messageSequences.has(ref.messageSequence))
91
+ )
92
+ invalidProvider();
93
+ ids.add(ref.runId);
94
+ }
95
+ }
96
+ if (value.workflowRefs !== undefined) {
97
+ if (!Array.isArray(value.workflowRefs) || value.workflowRefs.length > 100)
98
+ invalidProvider();
99
+ const ids = new Set<string>();
100
+ for (const ref of value.workflowRefs) {
101
+ if (
102
+ !ref ||
103
+ !validText(ref.workflowRunId, 200) ||
104
+ ids.has(ref.workflowRunId) ||
105
+ (ref.messageSequence !== undefined &&
106
+ !messageSequences.has(ref.messageSequence))
107
+ )
108
+ invalidProvider();
109
+ ids.add(ref.workflowRunId);
110
+ }
111
+ }
69
112
  return value;
70
113
  }
71
114
 
@@ -0,0 +1,33 @@
1
+ import { expect, test } from "bun:test";
2
+ import { loadSystemModules } from "../foundation.js";
3
+ import { toolDefinitions } from "./run-definition-support.js";
4
+ import { parseRemoteStatus } from "./remote-runtime-response.js";
5
+
6
+ test("Operation将Manifest工具输入Schema传到DSH,缺失Schema时拒绝装配", () => {
7
+ const modules = loadSystemModules();
8
+ const [tool] = toolDefinitions(modules, ["system.users.list"]);
9
+ expect(tool?.inputSchema).toMatchObject({ type: "object" });
10
+ const missing = modules.map((module) => ({ ...module, jsonSchemas: [] }));
11
+ expect(() => toolDefinitions(missing, ["system.users.list"])).toThrow(
12
+ "输入 Schema",
13
+ );
14
+ });
15
+
16
+ test("Node运行中状态的null终态不会被误解析为已完成,终态仍必须匹配事件", () => {
17
+ expect(
18
+ parseRemoteStatus({
19
+ runId: "run_synthetic",
20
+ status: "running",
21
+ lastSequence: 1,
22
+ terminalEvent: null,
23
+ }),
24
+ ).toEqual({ runId: "run_synthetic", status: "running", lastSequence: 1 });
25
+ expect(() =>
26
+ parseRemoteStatus({
27
+ runId: "run_synthetic",
28
+ status: "completed",
29
+ lastSequence: 1,
30
+ terminalEvent: null,
31
+ }),
32
+ ).toThrow();
33
+ });
@@ -0,0 +1,41 @@
1
+ import type { ModuleManifest } from "@southwind-ai/modules";
2
+ import type { NodePgDatabase } from "drizzle-orm/node-postgres";
3
+ import { bootstrapAgentSkills } from "../agent-skills/bootstrap.js";
4
+ import { platformBuiltinAgentSkills } from "../agent-skills/builtins.js";
5
+ import type { AgentSkillService } from "../agent-skills/service.js";
6
+ import type { GovernedToolRegistry } from "./tool-registry.js";
7
+ import type { createServerRuntime } from "../runtime.js";
8
+
9
+ type Runtime = ReturnType<typeof createServerRuntime>;
10
+ interface Governance {
11
+ readonly skills: AgentSkillService;
12
+ tools?: GovernedToolRegistry;
13
+ }
14
+ // Runtime-scoped ownership lets asynchronous platform startup precede Tool Host binding.
15
+ const runtimes = new WeakMap<Runtime, Governance>();
16
+ export async function prepareAgentGovernance(input: {
17
+ runtime: Runtime;
18
+ modules: readonly ModuleManifest[];
19
+ db?: NodePgDatabase;
20
+ }) {
21
+ const previous = runtimes.get(input.runtime);
22
+ if (previous) return previous;
23
+ const governance: Governance = {
24
+ skills: bootstrapAgentSkills({
25
+ ...input,
26
+ tools: () => governance.tools,
27
+ }),
28
+ };
29
+ await governance.skills.registerBuiltins(platformBuiltinAgentSkills, {
30
+ tenantId: "single-tenant",
31
+ });
32
+ runtimes.set(input.runtime, governance);
33
+ return governance;
34
+ }
35
+ export function bindAgentGovernanceTools(
36
+ runtime: Runtime,
37
+ tools: GovernedToolRegistry,
38
+ ) {
39
+ const governance = runtimes.get(runtime);
40
+ if (governance) governance.tools = tools;
41
+ }
@@ -0,0 +1,202 @@
1
+ import { describe, expect, test } from "bun:test";
2
+ import { createServerRuntime } from "../runtime.js";
3
+ import { AgentAdminOperationCatalog } from "./operation-catalog.js";
4
+ import {
5
+ createRunFacadeFixture,
6
+ runFacadeManifest,
7
+ } from "./run-facade.test-support.js";
8
+
9
+ async function fixture(
10
+ options: { workflowOnly?: boolean; runtimeAvailable?: boolean } = {},
11
+ ) {
12
+ const run = await createRunFacadeFixture(undefined, {
13
+ workflowOnly: options.workflowOnly,
14
+ });
15
+ const module = runFacadeManifest(options.workflowOnly);
16
+ const catalog = new AgentAdminOperationCatalog({
17
+ modules: [module],
18
+ hosts: run.hosts,
19
+ runtime: run.runtime,
20
+ runtimeAvailable: () => options.runtimeAvailable ?? true,
21
+ });
22
+ return { ...run, catalog, module };
23
+ }
24
+
25
+ describe("Admin Operation catalogue uses production registration", () => {
26
+ test("Registered and governed agent exposes real Schema/limits/tools, without preparing or running", async () => {
27
+ const { catalog, context, prepared, module, remote } = await fixture();
28
+ const [operation] = await catalog.list(context);
29
+ expect(operation).toMatchObject({
30
+ key: "business.answer",
31
+ module: "business",
32
+ inputSchemaKey: "business.input.v1",
33
+ inputSchema: module.jsonSchemas!.find(
34
+ ({ key }) => key === "business.input.v1",
35
+ )!.schema,
36
+ outputSchemaKey: "business.output.v1",
37
+ allowedToolKeys: ["business.records.list"],
38
+ limits: module.aiOperations![0]!.limits,
39
+ selectable: true,
40
+ availabilityReason: "allowed",
41
+ });
42
+ expect(prepared).toHaveLength(0);
43
+ expect(remote.started).toHaveLength(0);
44
+ });
45
+
46
+ test("Catalog read capability cannot start an unauthorized operation", async () => {
47
+ const { catalog, context, facade } = await fixture();
48
+ context.actor.permissionKeys = ["system.agent-debug.read"];
49
+ const [operation] = await catalog.list(context);
50
+ expect(operation).toMatchObject({
51
+ selectable: false,
52
+ availabilityReason: "permission-denied",
53
+ });
54
+ await expect(
55
+ facade.start(
56
+ "business.answer",
57
+ { question: "测试" },
58
+ "catalog-no-grant",
59
+ context,
60
+ ),
61
+ ).rejects.toMatchObject({ code: "FORBIDDEN" });
62
+ });
63
+
64
+ test("Workflow-only operation and unavailable Runtime are unselectable", async () => {
65
+ const workflow = await fixture({ workflowOnly: true });
66
+ expect((await workflow.catalog.list(workflow.context))[0]).toMatchObject({
67
+ selectable: false,
68
+ availabilityReason: "workflow-only",
69
+ launchAuthority: "workflow-artifact",
70
+ });
71
+ const unavailable = await fixture({ runtimeAvailable: false });
72
+ expect(
73
+ (await unavailable.catalog.list(unavailable.context))[0],
74
+ ).toMatchObject({
75
+ selectable: false,
76
+ availabilityReason: "runtime-unavailable",
77
+ });
78
+ });
79
+
80
+ test("Declared readiness needs a current successful projection", async () => {
81
+ const { module, hosts, runtime, context } = await fixture();
82
+ module.aiOperations![0]!.readiness = {
83
+ contractVersion: 1,
84
+ variant: "test",
85
+ inputModalities: ["text"],
86
+ outputModalities: ["text"],
87
+ expectedDeployment: {
88
+ key: "test",
89
+ identity: "test",
90
+ releaseDigest: `sha256:${"a".repeat(64)}`,
91
+ offersDigest: `sha256:${"b".repeat(64)}`,
92
+ },
93
+ minConcurrentRuns: 1,
94
+ minQueueDepth: 1,
95
+ };
96
+ const input = {
97
+ modules: [module],
98
+ hosts,
99
+ runtime,
100
+ runtimeAvailable: () => true,
101
+ };
102
+ expect(
103
+ (await new AgentAdminOperationCatalog(input).list(context))[0],
104
+ ).toMatchObject({
105
+ selectable: false,
106
+ availabilityReason: "runtime-unavailable",
107
+ });
108
+ expect(
109
+ (
110
+ await new AgentAdminOperationCatalog({
111
+ ...input,
112
+ operationReadiness: async () => false,
113
+ }).list(context)
114
+ )[0],
115
+ ).toMatchObject({
116
+ selectable: false,
117
+ availabilityReason: "runtime-unavailable",
118
+ });
119
+ expect(
120
+ (
121
+ await new AgentAdminOperationCatalog({
122
+ ...input,
123
+ operationReadiness: async () => true,
124
+ }).list(context)
125
+ )[0],
126
+ ).toMatchObject({ selectable: true });
127
+ });
128
+
129
+ test("Unregistered handler, unsupported kind, invalid scope fail closed", async () => {
130
+ const { module, hosts, runtime, context } = await fixture();
131
+ const catalog = (current = module, currentHosts = hosts) =>
132
+ new AgentAdminOperationCatalog({
133
+ modules: [current],
134
+ hosts: currentHosts,
135
+ runtime,
136
+ runtimeAvailable: () => true,
137
+ });
138
+ expect(
139
+ (
140
+ await catalog(module, { ...hosts, aiOperationHandlers: [] }).list(
141
+ context,
142
+ )
143
+ )[0],
144
+ ).toMatchObject({
145
+ selectable: false,
146
+ availabilityReason: "handler-unavailable",
147
+ });
148
+ const speech = structuredClone(module);
149
+ speech.aiOperations![0]!.kind = "speech";
150
+ expect((await catalog(speech).list(context))[0]).toMatchObject({
151
+ selectable: false,
152
+ availabilityReason: "unsupported-operation",
153
+ });
154
+ delete context.actor.scopeContext;
155
+ expect((await catalog().list(context))[0]).toMatchObject({
156
+ selectable: false,
157
+ availabilityReason: "scope-unavailable",
158
+ });
159
+ });
160
+
161
+ test("Feature closure and missing registered output Schema fail closed", async () => {
162
+ const { module, hosts, runtime, context } = await fixture();
163
+ const missingSchema = structuredClone(module);
164
+ missingSchema.jsonSchemas = missingSchema.jsonSchemas!.filter(
165
+ ({ key }) => key !== "business.output.v1",
166
+ );
167
+ expect(
168
+ () =>
169
+ new AgentAdminOperationCatalog({
170
+ modules: [missingSchema],
171
+ hosts,
172
+ runtime,
173
+ runtimeAvailable: () => true,
174
+ }),
175
+ ).toThrow();
176
+ const disabledModule = structuredClone(module);
177
+ disabledModule.features = disabledModule.features.map((feature) => ({
178
+ ...feature,
179
+ enabled: false,
180
+ }));
181
+ const disabledRuntime = createServerRuntime(
182
+ {},
183
+ { featureCatalog: disabledModule.features },
184
+ );
185
+ const missing = new AgentAdminOperationCatalog({
186
+ modules: [disabledModule],
187
+ hosts,
188
+ runtime: disabledRuntime,
189
+ runtimeAvailable: () => true,
190
+ });
191
+ expect((await missing.list(context))[0]).toMatchObject({
192
+ selectable: false,
193
+ availabilityReason: "feature-unavailable",
194
+ });
195
+ context.license = { status: "expired", restricted: true };
196
+ context.licenseEnforced = true;
197
+ expect((await missing.list(context))[0]).toMatchObject({
198
+ selectable: false,
199
+ availabilityReason: "license-unavailable",
200
+ });
201
+ });
202
+ });