create-windy 0.5.2 → 0.6.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (570) hide show
  1. package/dist/cli.js +288 -154
  2. package/package.json +2 -1
  3. package/template/.windy-template.json +2 -2
  4. package/template/apps/agent-server/README.md +25 -6
  5. package/template/apps/agent-server/src/southwind_agent_server/adk_adapter.py +15 -2
  6. package/template/apps/agent-server/src/southwind_agent_server/app.py +13 -34
  7. package/template/apps/agent-server/src/southwind_agent_server/config.py +49 -0
  8. package/template/apps/agent-server/src/southwind_agent_server/contracts.py +13 -0
  9. package/template/apps/agent-server/src/southwind_agent_server/engine_capacity.py +31 -0
  10. package/template/apps/agent-server/src/southwind_agent_server/fingerprint.py +5 -0
  11. package/template/apps/agent-server/src/southwind_agent_server/health_routes.py +50 -0
  12. package/template/apps/agent-server/src/southwind_agent_server/openai_engine.py +11 -2
  13. package/template/apps/agent-server/src/southwind_agent_server/openai_provider.py +3 -9
  14. package/template/apps/agent-server/src/southwind_agent_server/postgres_store.py +5 -0
  15. package/template/apps/agent-server/src/southwind_agent_server/readiness_pin.py +37 -0
  16. package/template/apps/agent-server/src/southwind_agent_server/run_admission.py +64 -0
  17. package/template/apps/agent-server/src/southwind_agent_server/run_capacity.py +59 -0
  18. package/template/apps/agent-server/src/southwind_agent_server/service.py +42 -43
  19. package/template/apps/agent-server/src/southwind_agent_server/service_errors.py +4 -0
  20. package/template/apps/agent-server/src/southwind_agent_server/service_execution.py +31 -0
  21. package/template/apps/agent-server/src/southwind_agent_server/service_tasks.py +34 -0
  22. package/template/apps/agent-server/src/southwind_agent_server/sqlite_catalog.py +11 -0
  23. package/template/apps/agent-server/src/southwind_agent_server/store.py +6 -0
  24. package/template/apps/agent-server/src/southwind_agent_server/vision_probe.py +87 -0
  25. package/template/apps/agent-server/src/southwind_agent_server/vision_requirement.py +28 -0
  26. package/template/apps/agent-server/src/southwind_agent_server/vlm_readiness.py +247 -0
  27. package/template/apps/agent-server/tests/test_api.py +16 -3
  28. package/template/apps/agent-server/tests/test_openai_provider.py +21 -4
  29. package/template/apps/agent-server/tests/test_postgres_store.py +3 -0
  30. package/template/apps/agent-server/tests/test_run_capacity.py +110 -0
  31. package/template/apps/agent-server/tests/test_runtime_factory_readiness.py +37 -0
  32. package/template/apps/agent-server/tests/test_sqlite_store.py +3 -0
  33. package/template/apps/agent-server/tests/test_vision_readiness_enforcement.py +72 -0
  34. package/template/apps/agent-server/tests/test_vlm_readiness.py +106 -0
  35. package/template/apps/document-server/src/southwind_document_server/adapter.py +117 -205
  36. package/template/apps/document-server/src/southwind_document_server/adapter_errors.py +13 -0
  37. package/template/apps/document-server/src/southwind_document_server/app.py +62 -14
  38. package/template/apps/document-server/src/southwind_document_server/artifacts.py +27 -0
  39. package/template/apps/document-server/src/southwind_document_server/config.py +96 -2
  40. package/template/apps/document-server/src/southwind_document_server/contracts.py +168 -13
  41. package/template/apps/document-server/src/southwind_document_server/fingerprint.py +128 -0
  42. package/template/apps/document-server/src/southwind_document_server/grants.py +81 -0
  43. package/template/apps/document-server/src/southwind_document_server/multipart_output.py +265 -0
  44. package/template/apps/document-server/src/southwind_document_server/output_validation.py +202 -0
  45. package/template/apps/document-server/src/southwind_document_server/progress.py +27 -0
  46. package/template/apps/document-server/src/southwind_document_server/readiness.py +280 -0
  47. package/template/apps/document-server/src/southwind_document_server/readiness_contracts.py +280 -0
  48. package/template/apps/document-server/src/southwind_document_server/readiness_http.py +87 -0
  49. package/template/apps/document-server/src/southwind_document_server/readiness_support.py +120 -0
  50. package/template/apps/document-server/src/southwind_document_server/request_validation.py +48 -0
  51. package/template/apps/document-server/src/southwind_document_server/service.py +297 -96
  52. package/template/apps/document-server/src/southwind_document_server/service_recovery.py +183 -0
  53. package/template/apps/document-server/src/southwind_document_server/sink.py +316 -0
  54. package/template/apps/document-server/src/southwind_document_server/store.py +301 -141
  55. package/template/apps/document-server/src/southwind_document_server/store_events.py +40 -0
  56. package/template/apps/document-server/src/southwind_document_server/store_models.py +62 -0
  57. package/template/apps/document-server/src/southwind_document_server/store_recovery.py +247 -0
  58. package/template/apps/document-server/src/southwind_document_server/store_schema.py +50 -0
  59. package/template/apps/document-server/tests/recovery_support.py +230 -0
  60. package/template/apps/document-server/tests/support.py +210 -0
  61. package/template/apps/document-server/tests/test_adapter.py +251 -0
  62. package/template/apps/document-server/tests/test_config.py +43 -0
  63. package/template/apps/document-server/tests/test_contracts.py +80 -0
  64. package/template/apps/document-server/tests/test_fingerprint.py +125 -0
  65. package/template/apps/document-server/tests/test_grants.py +46 -0
  66. package/template/apps/document-server/tests/test_handshake.py +154 -0
  67. package/template/apps/document-server/tests/test_integration.py +192 -0
  68. package/template/apps/document-server/tests/test_multipart_security.py +259 -0
  69. package/template/apps/document-server/tests/test_readiness.py +311 -0
  70. package/template/apps/document-server/tests/test_readiness_contracts.py +131 -0
  71. package/template/apps/document-server/tests/test_recovery.py +222 -0
  72. package/template/apps/document-server/tests/test_recovery_faults.py +101 -0
  73. package/template/apps/document-server/tests/test_recovery_races.py +283 -0
  74. package/template/apps/document-server/tests/test_service.py +16 -13
  75. package/template/apps/document-server/tests/test_service_artifacts.py +296 -0
  76. package/template/apps/document-server/tests/test_sink.py +253 -0
  77. package/template/apps/document-server/tests/test_store.py +199 -0
  78. package/template/apps/embedding-server/pyproject.toml +5 -0
  79. package/template/apps/embedding-server/src/southwind_embedding_server/adapter.py +38 -2
  80. package/template/apps/embedding-server/src/southwind_embedding_server/app.py +111 -3
  81. package/template/apps/embedding-server/src/southwind_embedding_server/config.py +27 -0
  82. package/template/apps/embedding-server/src/southwind_embedding_server/image_input.py +16 -5
  83. package/template/apps/embedding-server/src/southwind_embedding_server/run_cipher.py +31 -0
  84. package/template/apps/embedding-server/src/southwind_embedding_server/run_service.py +130 -0
  85. package/template/apps/embedding-server/src/southwind_embedding_server/run_store.py +250 -0
  86. package/template/apps/embedding-server/tests/test_adapter.py +25 -0
  87. package/template/apps/embedding-server/tests/test_run_http.py +185 -0
  88. package/template/apps/embedding-server/tests/test_run_service.py +200 -0
  89. package/template/apps/embedding-server/uv.lock +71 -0
  90. package/template/apps/server/Dockerfile +13 -0
  91. package/template/apps/server/package.json +1 -0
  92. package/template/apps/server/src/agent/drizzle-screenshot-intake-repository.integration.test.ts +283 -0
  93. package/template/apps/server/src/agent/drizzle-screenshot-intake-repository.ts +175 -0
  94. package/template/apps/server/src/agent/persistent-screenshot-intake-producer.ts +320 -0
  95. package/template/apps/server/src/agent/remote-runtime.ts +8 -1
  96. package/template/apps/server/src/agent/required-environment.ts +5 -0
  97. package/template/apps/server/src/agent/run-attach.ts +41 -0
  98. package/template/apps/server/src/agent/run-audit.ts +49 -0
  99. package/template/apps/server/src/agent/run-contracts.ts +6 -1
  100. package/template/apps/server/src/agent/run-facade.ts +66 -68
  101. package/template/apps/server/src/agent/run-route-input.ts +26 -1
  102. package/template/apps/server/src/agent/run-routes.ts +1 -0
  103. package/template/apps/server/src/agent/runtime-bootstrap-report.test.ts +1 -1
  104. package/template/apps/server/src/agent/runtime-bootstrap.ts +110 -60
  105. package/template/apps/server/src/agent/runtime-readiness-sources.test.ts +27 -0
  106. package/template/apps/server/src/agent/runtime-readiness-sources.ts +31 -0
  107. package/template/apps/server/src/agent/runtime-reporting-bootstrap.ts +40 -0
  108. package/template/apps/server/src/agent/screenshot-intake-authorization.ts +29 -0
  109. package/template/apps/server/src/agent/screenshot-intake-bootstrap.ts +61 -0
  110. package/template/apps/server/src/agent/screenshot-intake-durable.ts +53 -0
  111. package/template/apps/server/src/agent/screenshot-intake-errors.ts +9 -0
  112. package/template/apps/server/src/agent/screenshot-intake-producer.ts +41 -0
  113. package/template/apps/server/src/agent/screenshot-intake-record.ts +44 -0
  114. package/template/apps/server/src/agent/screenshot-intake-recovery.ts +106 -0
  115. package/template/apps/server/src/agent/screenshot-intake-repository.ts +64 -0
  116. package/template/apps/server/src/agent/screenshot-intake-reservation.ts +24 -0
  117. package/template/apps/server/src/agent/screenshot-intake-routes.ts +171 -0
  118. package/template/apps/server/src/agent/screenshot-intake-runtime-types.ts +6 -0
  119. package/template/apps/server/src/agent/screenshot-intake-sweep.ts +26 -0
  120. package/template/apps/server/src/agent/screenshot-intake-test-support.ts +87 -0
  121. package/template/apps/server/src/agent/screenshot-intake-v2-validation.ts +152 -0
  122. package/template/apps/server/src/agent/screenshot-intake-v2.test.ts +338 -0
  123. package/template/apps/server/src/agent/screenshot-intake-v2.ts +350 -0
  124. package/template/apps/server/src/agent/screenshot-png.ts +15 -0
  125. package/template/apps/server/src/agent/screenshot-run-binding.ts +34 -0
  126. package/template/apps/server/src/agent/unavailable-routes.ts +9 -0
  127. package/template/apps/server/src/agent/vision-facade.test.ts +98 -8
  128. package/template/apps/server/src/agent/vision-input.ts +5 -2
  129. package/template/apps/server/src/agent/vision-readiness-pin.ts +74 -0
  130. package/template/apps/server/src/agent/vision-readiness.ts +58 -0
  131. package/template/apps/server/src/ai-artifact/runtime-reference.test.ts +135 -0
  132. package/template/apps/server/src/ai-artifact/runtime.ts +134 -5
  133. package/template/apps/server/src/ai-output-artifact/cleanup.ts +214 -0
  134. package/template/apps/server/src/ai-output-artifact/contracts.ts +152 -0
  135. package/template/apps/server/src/ai-output-artifact/drizzle-cleanup.ts +37 -0
  136. package/template/apps/server/src/ai-output-artifact/drizzle-complete.ts +71 -0
  137. package/template/apps/server/src/ai-output-artifact/drizzle-grant-cleanup.ts +45 -0
  138. package/template/apps/server/src/ai-output-artifact/drizzle-grants.ts +109 -0
  139. package/template/apps/server/src/ai-output-artifact/drizzle-mapping.ts +77 -0
  140. package/template/apps/server/src/ai-output-artifact/drizzle-readiness.ts +46 -0
  141. package/template/apps/server/src/ai-output-artifact/drizzle-repository.ts +350 -0
  142. package/template/apps/server/src/ai-output-artifact/drizzle-seal.ts +64 -0
  143. package/template/apps/server/src/ai-output-artifact/grant.ts +30 -0
  144. package/template/apps/server/src/ai-output-artifact/host-registry.ts +53 -0
  145. package/template/apps/server/src/ai-output-artifact/memory-cleanup.ts +47 -0
  146. package/template/apps/server/src/ai-output-artifact/memory-grants.ts +98 -0
  147. package/template/apps/server/src/ai-output-artifact/memory-readiness.ts +26 -0
  148. package/template/apps/server/src/ai-output-artifact/memory-repository.ts +348 -0
  149. package/template/apps/server/src/ai-output-artifact/policy.test.ts +67 -0
  150. package/template/apps/server/src/ai-output-artifact/policy.ts +125 -0
  151. package/template/apps/server/src/ai-output-artifact/postgres-test-support.ts +147 -0
  152. package/template/apps/server/src/ai-output-artifact/postgres.integration.test.ts +349 -0
  153. package/template/apps/server/src/ai-output-artifact/reference-codec.ts +128 -0
  154. package/template/apps/server/src/ai-output-artifact/repository-grant-invariants.test-support.ts +165 -0
  155. package/template/apps/server/src/ai-output-artifact/repository-invariants.test-support.ts +239 -0
  156. package/template/apps/server/src/ai-output-artifact/repository-invariants.test.ts +18 -0
  157. package/template/apps/server/src/ai-output-artifact/repository.ts +107 -0
  158. package/template/apps/server/src/ai-output-artifact/route-input.ts +173 -0
  159. package/template/apps/server/src/ai-output-artifact/routes-delete.test.ts +287 -0
  160. package/template/apps/server/src/ai-output-artifact/routes-grant.test.ts +116 -0
  161. package/template/apps/server/src/ai-output-artifact/routes-nonblocking-body.test.ts +136 -0
  162. package/template/apps/server/src/ai-output-artifact/routes-security.test.ts +176 -0
  163. package/template/apps/server/src/ai-output-artifact/routes-storage-error.test.ts +105 -0
  164. package/template/apps/server/src/ai-output-artifact/routes.test-support.ts +84 -0
  165. package/template/apps/server/src/ai-output-artifact/routes.test.ts +198 -0
  166. package/template/apps/server/src/ai-output-artifact/routes.ts +280 -0
  167. package/template/apps/server/src/ai-output-artifact/service-completion.ts +60 -0
  168. package/template/apps/server/src/ai-output-artifact/service-grants.test.ts +169 -0
  169. package/template/apps/server/src/ai-output-artifact/service-grants.ts +217 -0
  170. package/template/apps/server/src/ai-output-artifact/service-input.ts +175 -0
  171. package/template/apps/server/src/ai-output-artifact/service-read.ts +89 -0
  172. package/template/apps/server/src/ai-output-artifact/service-recovery.test.ts +238 -0
  173. package/template/apps/server/src/ai-output-artifact/service-support.ts +240 -0
  174. package/template/apps/server/src/ai-output-artifact/service.test.ts +283 -0
  175. package/template/apps/server/src/ai-output-artifact/service.ts +334 -0
  176. package/template/apps/server/src/ai-output-artifact/storage-recovery.ts +33 -0
  177. package/template/apps/server/src/ai-output-artifact/storage-writer.ts +103 -0
  178. package/template/apps/server/src/ai-output-artifact/test-support.ts +161 -0
  179. package/template/apps/server/src/ai-runtime-readiness/health-response.ts +92 -0
  180. package/template/apps/server/src/ai-runtime-readiness/operation-port-trust.test.ts +66 -0
  181. package/template/apps/server/src/ai-runtime-readiness/operation-port.test-support.ts +143 -0
  182. package/template/apps/server/src/ai-runtime-readiness/operation-port.test.ts +193 -0
  183. package/template/apps/server/src/ai-runtime-readiness/operation-port.ts +172 -0
  184. package/template/apps/server/src/ai-runtime-readiness/trust-store.ts +61 -0
  185. package/template/apps/server/src/app/ai-screenshot-intake-binding.ts +22 -0
  186. package/template/apps/server/src/app/document-output-artifact-bindings.ts +5 -0
  187. package/template/apps/server/src/app/speech-output-artifact-bindings.ts +5 -0
  188. package/template/apps/server/src/application-services.ts +9 -3
  189. package/template/apps/server/src/audit/redaction.ts +1 -0
  190. package/template/apps/server/src/audit/reliable-writer.test.ts +8 -0
  191. package/template/apps/server/src/auth/password-change-license-restriction.test.ts +156 -0
  192. package/template/apps/server/src/document/cancel-response.ts +33 -0
  193. package/template/apps/server/src/document/contracts.ts +6 -0
  194. package/template/apps/server/src/document/errors.ts +11 -0
  195. package/template/apps/server/src/document/facade-cancel.test.ts +226 -0
  196. package/template/apps/server/src/document/facade-cancel.ts +110 -0
  197. package/template/apps/server/src/document/facade-grant-handoff.test.ts +113 -0
  198. package/template/apps/server/src/document/facade-idempotency.test.ts +195 -0
  199. package/template/apps/server/src/document/facade-invocation.ts +46 -0
  200. package/template/apps/server/src/document/facade-output-artifact.test.ts +310 -0
  201. package/template/apps/server/src/document/facade-read-response.ts +116 -0
  202. package/template/apps/server/src/document/facade-readiness.test.ts +95 -0
  203. package/template/apps/server/src/document/facade-support.ts +297 -0
  204. package/template/apps/server/src/document/facade.ts +164 -173
  205. package/template/apps/server/src/document/output-artifact-composition.test.ts +64 -0
  206. package/template/apps/server/src/document/output-artifact-composition.ts +78 -0
  207. package/template/apps/server/src/document/output-artifact-fingerprint.contract.test.ts +110 -0
  208. package/template/apps/server/src/document/output-artifact-fingerprint.ts +150 -0
  209. package/template/apps/server/src/document/output-artifact-host-registry.ts +44 -0
  210. package/template/apps/server/src/document/output-artifact-host.test.ts +332 -0
  211. package/template/apps/server/src/document/output-artifact-host.ts +331 -0
  212. package/template/apps/server/src/document/output-artifact-manifest.test-support.ts +71 -0
  213. package/template/apps/server/src/document/output-artifact-publish.test-support.ts +48 -0
  214. package/template/apps/server/src/document/output-artifact-readiness-probe.ts +347 -0
  215. package/template/apps/server/src/document/output-artifact-readiness-timeout.ts +30 -0
  216. package/template/apps/server/src/document/output-artifact-readiness.test.ts +264 -0
  217. package/template/apps/server/src/document/output-artifact-readiness.ts +87 -0
  218. package/template/apps/server/src/document/output-artifact-route-composition.test.ts +27 -0
  219. package/template/apps/server/src/document/output-artifact-route-composition.ts +14 -0
  220. package/template/apps/server/src/document/output-artifact-runtime.test-support.ts +8 -0
  221. package/template/apps/server/src/document/output-artifact-runtime.test.ts +124 -0
  222. package/template/apps/server/src/document/output-artifact-runtime.ts +275 -0
  223. package/template/apps/server/src/document/output-artifact.test-support.ts +350 -0
  224. package/template/apps/server/src/document/remote-response.ts +162 -0
  225. package/template/apps/server/src/document/remote-runtime.test.ts +100 -4
  226. package/template/apps/server/src/document/remote-runtime.ts +37 -85
  227. package/template/apps/server/src/document/routes-read-response.test.ts +267 -0
  228. package/template/apps/server/src/document/routes.test.ts +109 -0
  229. package/template/apps/server/src/document/routes.ts +23 -14
  230. package/template/apps/server/src/embedding/audit.ts +46 -0
  231. package/template/apps/server/src/embedding/contracts.ts +13 -0
  232. package/template/apps/server/src/embedding/drizzle-run-binding-repository.integration.test.ts +100 -0
  233. package/template/apps/server/src/embedding/drizzle-run-binding-repository.ts +102 -0
  234. package/template/apps/server/src/embedding/facade-types.ts +18 -0
  235. package/template/apps/server/src/embedding/facade.ts +242 -111
  236. package/template/apps/server/src/embedding/operation-authorization.ts +23 -0
  237. package/template/apps/server/src/embedding/remote-runtime.test.ts +18 -0
  238. package/template/apps/server/src/embedding/remote-runtime.ts +77 -0
  239. package/template/apps/server/src/embedding/routes.test.ts +118 -0
  240. package/template/apps/server/src/embedding/routes.ts +98 -0
  241. package/template/apps/server/src/embedding/run-artifact.ts +18 -0
  242. package/template/apps/server/src/embedding/run-authorization.test.ts +133 -0
  243. package/template/apps/server/src/embedding/run-authorization.ts +91 -0
  244. package/template/apps/server/src/embedding/run-binding-repository.ts +75 -0
  245. package/template/apps/server/src/embedding/run-fingerprint.test.ts +52 -0
  246. package/template/apps/server/src/embedding/run-fingerprint.ts +39 -0
  247. package/template/apps/server/src/embedding/terminal-observer.test.ts +26 -0
  248. package/template/apps/server/src/embedding/terminal-observer.ts +44 -0
  249. package/template/apps/server/src/index.ts +38 -31
  250. package/template/apps/server/src/module-host/ai-operation-port.ts +3 -3
  251. package/template/apps/server/src/module-host/durable-context.ts +194 -16
  252. package/template/apps/server/src/module-host/durable-handler-registration.ts +1 -0
  253. package/template/apps/server/src/module-host/durable-storage-filesystem-restart.test.ts +265 -0
  254. package/template/apps/server/src/module-host/durable-storage-write.test.ts +345 -0
  255. package/template/apps/server/src/module-host/http-runtime.ts +25 -0
  256. package/template/apps/server/src/module-host/initialize-contracts.ts +18 -1
  257. package/template/apps/server/src/module-host/initialize.test.ts +18 -0
  258. package/template/apps/server/src/module-host/initialize.ts +42 -2
  259. package/template/apps/server/src/module-host/module-secret-audit-version.test.ts +73 -0
  260. package/template/apps/server/src/module-host/module-secret-binding-resolution.ts +60 -0
  261. package/template/apps/server/src/module-host/module-secret-durable.test.ts +206 -0
  262. package/template/apps/server/src/module-host/module-secret-port.test-support.ts +125 -0
  263. package/template/apps/server/src/module-host/module-secret-port.test.ts +161 -0
  264. package/template/apps/server/src/module-host/module-secret-port.ts +249 -0
  265. package/template/apps/server/src/module-host/module-secret-result.test.ts +324 -0
  266. package/template/apps/server/src/module-host/module-secret-result.ts +274 -0
  267. package/template/apps/server/src/module-host/module-secret-tool-boundary.test.ts +143 -0
  268. package/template/apps/server/src/module-host/project-composition.ts +1 -0
  269. package/template/apps/server/src/module-host/report-staging-port.ts +55 -0
  270. package/template/apps/server/src/module-host/report-staging-registration.test.ts +104 -0
  271. package/template/apps/server/src/module-host/request-context.ts +58 -1
  272. package/template/apps/server/src/module-host/route-declaration.ts +11 -4
  273. package/template/apps/server/src/module-host/route-installer.test-fixture.ts +246 -0
  274. package/template/apps/server/src/module-host/route-installer.test.ts +47 -211
  275. package/template/apps/server/src/module-host/route-installer.ts +192 -21
  276. package/template/apps/server/src/module-host/route-registration.test.ts +44 -4
  277. package/template/apps/server/src/module-host/runtime-composition.ts +2 -0
  278. package/template/apps/server/src/module-host/scoped-host.ts +84 -0
  279. package/template/apps/server/src/module-host/screenshot-artifact-ref.ts +91 -0
  280. package/template/apps/server/src/module-host/screenshot-intake-composition.test.ts +292 -0
  281. package/template/apps/server/src/module-host/screenshot-intake-deadline.ts +38 -0
  282. package/template/apps/server/src/module-host/screenshot-intake-plan.ts +75 -0
  283. package/template/apps/server/src/module-host/screenshot-intake-port.ts +297 -0
  284. package/template/apps/server/src/module-host/screenshot-intake-security.test.ts +311 -0
  285. package/template/apps/server/src/module-host/screenshot-intake-store.ts +76 -0
  286. package/template/apps/server/src/module-host/screenshot-intake-test-support.ts +68 -0
  287. package/template/apps/server/src/module-host/secret-bindings.test.ts +167 -0
  288. package/template/apps/server/src/module-host/secret-bindings.ts +184 -0
  289. package/template/apps/server/src/module-host/storage-authorization-binding.test.ts +242 -0
  290. package/template/apps/server/src/module-host/storage-port.test.ts +8 -1
  291. package/template/apps/server/src/module-host/storage-port.ts +84 -8
  292. package/template/apps/server/src/module-host/storage-restart-fixture.test-support.ts +242 -0
  293. package/template/apps/server/src/module-host/storage-restart-postgres.integration.test.ts +280 -0
  294. package/template/apps/server/src/module-host/storage-scope-drift-http.test.ts +68 -0
  295. package/template/apps/server/src/module-host/storage-scope.ts +52 -1
  296. package/template/apps/server/src/module-host/storage-stream-route.test.ts +282 -0
  297. package/template/apps/server/src/module-host/storage-write-error.test.ts +174 -0
  298. package/template/apps/server/src/module-host/storage-write-error.ts +62 -0
  299. package/template/apps/server/src/module-host/storage-write-port.test.ts +323 -0
  300. package/template/apps/server/src/module-host/storage-write-port.ts +320 -0
  301. package/template/apps/server/src/module-host/storage-write-unavailable.ts +21 -0
  302. package/template/apps/server/src/module-host/storage-writer-retention.test.ts +109 -0
  303. package/template/apps/server/src/module-host/user-directory-composition.test.ts +1 -0
  304. package/template/apps/server/src/module-preflight-secret.test.ts +79 -0
  305. package/template/apps/server/src/module-preflight.ts +5 -0
  306. package/template/apps/server/src/platform-http-runtime.ts +16 -4
  307. package/template/apps/server/src/report-staging/archive-frame-stream.test.ts +209 -0
  308. package/template/apps/server/src/report-staging/archive-frame-stream.ts +341 -0
  309. package/template/apps/server/src/report-staging/archive-process.test.ts +302 -0
  310. package/template/apps/server/src/report-staging/archive-process.ts +257 -0
  311. package/template/apps/server/src/report-staging/archive-volumes.ts +30 -0
  312. package/template/apps/server/src/report-staging/cancellation.ts +13 -0
  313. package/template/apps/server/src/report-staging/contracts.ts +94 -0
  314. package/template/apps/server/src/report-staging/drizzle-lifecycle.ts +278 -0
  315. package/template/apps/server/src/report-staging/drizzle-mapping.ts +140 -0
  316. package/template/apps/server/src/report-staging/drizzle-repository.integration.test.ts +346 -0
  317. package/template/apps/server/src/report-staging/drizzle-repository.ts +255 -0
  318. package/template/apps/server/src/report-staging/drizzle-seal.integration.test.ts +267 -0
  319. package/template/apps/server/src/report-staging/drizzle-seal.ts +177 -0
  320. package/template/apps/server/src/report-staging/filesystem-cleanup.test.ts +68 -0
  321. package/template/apps/server/src/report-staging/filesystem-cleanup.ts +102 -0
  322. package/template/apps/server/src/report-staging/filesystem-errors.ts +15 -0
  323. package/template/apps/server/src/report-staging/filesystem-identifiers.ts +19 -0
  324. package/template/apps/server/src/report-staging/filesystem-io.test.ts +85 -0
  325. package/template/apps/server/src/report-staging/filesystem-io.ts +206 -0
  326. package/template/apps/server/src/report-staging/filesystem-scan.ts +85 -0
  327. package/template/apps/server/src/report-staging/filesystem-store.ts +346 -0
  328. package/template/apps/server/src/report-staging/heartbeat.test.ts +47 -0
  329. package/template/apps/server/src/report-staging/heartbeat.ts +53 -0
  330. package/template/apps/server/src/report-staging/manifest-stream.ts +46 -0
  331. package/template/apps/server/src/report-staging/memory-repository.ts +256 -0
  332. package/template/apps/server/src/report-staging/metadata-catalog.ts +89 -0
  333. package/template/apps/server/src/report-staging/metadata-spool-paths.ts +195 -0
  334. package/template/apps/server/src/report-staging/metadata-spool-schema.ts +54 -0
  335. package/template/apps/server/src/report-staging/metadata-spool.test.ts +214 -0
  336. package/template/apps/server/src/report-staging/metadata-spool.ts +305 -0
  337. package/template/apps/server/src/report-staging/native/archive-frame-helper.c +309 -0
  338. package/template/apps/server/src/report-staging/path-policy.test.ts +127 -0
  339. package/template/apps/server/src/report-staging/path-policy.ts +263 -0
  340. package/template/apps/server/src/report-staging/repository-fence.test.ts +114 -0
  341. package/template/apps/server/src/report-staging/repository.ts +75 -0
  342. package/template/apps/server/src/report-staging/runtime.ts +31 -0
  343. package/template/apps/server/src/report-staging/sealed-file.test.ts +34 -0
  344. package/template/apps/server/src/report-staging/sealed-file.ts +137 -0
  345. package/template/apps/server/src/report-staging/service-input-limits.test.ts +62 -0
  346. package/template/apps/server/src/report-staging/service-input.ts +204 -0
  347. package/template/apps/server/src/report-staging/service-lifecycle.test.ts +132 -0
  348. package/template/apps/server/src/report-staging/service-read-fence.test.ts +37 -0
  349. package/template/apps/server/src/report-staging/service-read.ts +172 -0
  350. package/template/apps/server/src/report-staging/service-support.ts +149 -0
  351. package/template/apps/server/src/report-staging/service.test-fixture.ts +226 -0
  352. package/template/apps/server/src/report-staging/service.test.ts +314 -0
  353. package/template/apps/server/src/report-staging/service.ts +255 -0
  354. package/template/apps/server/src/report-staging/supervised-process.ts +194 -0
  355. package/template/apps/server/src/speech/contracts.ts +8 -0
  356. package/template/apps/server/src/speech/errors.ts +10 -0
  357. package/template/apps/server/src/speech/facade-contract.ts +49 -0
  358. package/template/apps/server/src/speech/facade-output.test.ts +299 -0
  359. package/template/apps/server/src/speech/facade-output.ts +298 -0
  360. package/template/apps/server/src/speech/facade-validation.ts +127 -0
  361. package/template/apps/server/src/speech/facade.ts +185 -151
  362. package/template/apps/server/src/speech/fingerprint.test.ts +42 -0
  363. package/template/apps/server/src/speech/fingerprint.ts +28 -0
  364. package/template/apps/server/src/speech/output-artifact-binding.test.ts +11 -0
  365. package/template/apps/server/src/speech/output-artifact-binding.ts +30 -0
  366. package/template/apps/server/src/speech/output-artifact-error.ts +9 -0
  367. package/template/apps/server/src/speech/output-artifact-host.test-support.ts +73 -0
  368. package/template/apps/server/src/speech/output-artifact-host.test.ts +302 -0
  369. package/template/apps/server/src/speech/output-artifact-host.ts +279 -0
  370. package/template/apps/server/src/speech/output-artifact-policy.ts +114 -0
  371. package/template/apps/server/src/speech/output-artifact-replay.ts +91 -0
  372. package/template/apps/server/src/speech/remote-response.ts +158 -0
  373. package/template/apps/server/src/speech/remote-runtime.test.ts +90 -0
  374. package/template/apps/server/src/speech/remote-runtime.ts +36 -78
  375. package/template/apps/server/src/speech/routes.ts +60 -16
  376. package/template/apps/server/src/startup-finalization.ts +52 -0
  377. package/template/apps/server/src/startup-preflight.ts +2 -0
  378. package/template/apps/server/src/startup-shutdown.test.ts +69 -0
  379. package/template/apps/server/src/startup-shutdown.ts +61 -0
  380. package/template/apps/server/src/storage/drizzle-upload-purge.ts +61 -0
  381. package/template/apps/server/src/storage/drizzle-upload-references.ts +23 -0
  382. package/template/apps/server/src/storage/drizzle-upload-repository.integration.test.ts +103 -0
  383. package/template/apps/server/src/storage/drizzle-upload-repository.ts +109 -14
  384. package/template/apps/server/src/storage/host-runtime.ts +15 -0
  385. package/template/apps/server/src/storage/routes-stream-cancellation.test.ts +154 -0
  386. package/template/apps/server/src/storage/routes.test.ts +13 -2
  387. package/template/apps/server/src/storage/routes.ts +57 -18
  388. package/template/apps/server/src/storage/runtime.ts +17 -4
  389. package/template/apps/server/src/system/route-types.ts +5 -1
  390. package/template/apps/server/src/system/system-resource-monitoring.test.ts +47 -0
  391. package/template/apps/server/src/system/system-resource-monitoring.ts +60 -10
  392. package/template/apps/server/src/work-order/routes.test.ts +1 -0
  393. package/template/apps/speech-server/src/southwind_speech_server/adapter.py +58 -17
  394. package/template/apps/speech-server/src/southwind_speech_server/app.py +24 -17
  395. package/template/apps/speech-server/src/southwind_speech_server/bounded_json.py +60 -0
  396. package/template/apps/speech-server/src/southwind_speech_server/config.py +122 -2
  397. package/template/apps/speech-server/src/southwind_speech_server/contracts.py +58 -0
  398. package/template/apps/speech-server/src/southwind_speech_server/errors.py +8 -0
  399. package/template/apps/speech-server/src/southwind_speech_server/normalizer.py +14 -0
  400. package/template/apps/speech-server/src/southwind_speech_server/output_artifact.py +190 -0
  401. package/template/apps/speech-server/src/southwind_speech_server/output_validation.py +54 -0
  402. package/template/apps/speech-server/src/southwind_speech_server/pin_cli.py +83 -0
  403. package/template/apps/speech-server/src/southwind_speech_server/readiness.py +266 -0
  404. package/template/apps/speech-server/src/southwind_speech_server/readiness_contracts.py +268 -0
  405. package/template/apps/speech-server/src/southwind_speech_server/readiness_http.py +91 -0
  406. package/template/apps/speech-server/src/southwind_speech_server/readiness_local.py +161 -0
  407. package/template/apps/speech-server/src/southwind_speech_server/readiness_support.py +106 -0
  408. package/template/apps/speech-server/src/southwind_speech_server/service.py +118 -13
  409. package/template/apps/speech-server/src/southwind_speech_server/store.py +7 -0
  410. package/template/apps/speech-server/tests/test_bounded_json.py +55 -0
  411. package/template/apps/speech-server/tests/test_config.py +22 -0
  412. package/template/apps/speech-server/tests/test_output_artifact.py +60 -0
  413. package/template/apps/speech-server/tests/test_output_validation.py +44 -0
  414. package/template/apps/speech-server/tests/test_readiness.py +315 -0
  415. package/template/apps/speech-server/tests/test_readiness_http.py +48 -0
  416. package/template/apps/speech-server/tests/test_readiness_local.py +43 -0
  417. package/template/apps/speech-server/tests/test_service.py +211 -36
  418. package/template/apps/web/src/pages/system/components/OperationGpuMonitor.vue +2 -1
  419. package/template/apps/web/src/pages/system/components/OperationGpuMonitor.webtest.ts +29 -0
  420. package/template/apps/web/src/pages/system/components/OperationServiceMonitor.vue +2 -1
  421. package/template/apps/web/src/pages/system/components/OperationServiceMonitor.webtest.ts +4 -1
  422. package/template/docker-compose.yml +38 -1
  423. package/template/docs/architecture/ai-runtime-readiness.md +498 -0
  424. package/template/docs/architecture/ai-runtime.md +20 -4
  425. package/template/docs/architecture/durable-jobs.md +54 -5
  426. package/template/docs/architecture/module-host.md +72 -9
  427. package/template/docs/architecture/module-manifest-composition.md +5 -2
  428. package/template/docs/architecture/module-secret-resolution.md +250 -0
  429. package/template/docs/architecture/object-storage.md +144 -3
  430. package/template/docs/architecture/report-staging.md +158 -0
  431. package/template/docs/architecture/server-module-interface.md +29 -0
  432. package/template/docs/architecture/speech-variants.md +45 -0
  433. package/template/docs/platform/agent-tools.md +16 -0
  434. package/template/docs/platform/document-ai-runtime.md +199 -17
  435. package/template/docs/platform/module-configuration.md +5 -0
  436. package/template/docs/platform/speech-ai-runtime.md +34 -5
  437. package/template/docs/platform/vision-ai-runtime.md +24 -0
  438. package/template/package.json +4 -1
  439. package/template/packages/ai-client/package.json +1 -1
  440. package/template/packages/ai-client/src/agent/client/client.ts +3 -0
  441. package/template/packages/ai-client/src/agent/client/index.ts +1 -0
  442. package/template/packages/ai-client/src/agent/client/screenshot.test.ts +40 -0
  443. package/template/packages/ai-client/src/agent/client/screenshot.ts +146 -0
  444. package/template/packages/ai-client/src/agent/client/types.ts +2 -0
  445. package/template/packages/ai-client/src/agent/contracts/runs.ts +1 -0
  446. package/template/packages/ai-client/src/embedding/client.test.ts +52 -0
  447. package/template/packages/ai-client/src/embedding/client.ts +69 -0
  448. package/template/packages/ai-client/src/embedding/contracts.ts +47 -0
  449. package/template/packages/ai-client/src/embedding/index.ts +1 -0
  450. package/template/packages/ai-client/src/embedding/run.ts +130 -0
  451. package/template/packages/ai-client/src/speech/client.test.ts +26 -0
  452. package/template/packages/ai-client/src/speech/client.ts +25 -1
  453. package/template/packages/ai-client/src/speech/contracts.ts +19 -0
  454. package/template/packages/config/package.json +1 -1
  455. package/template/packages/database/drizzle/0048_illegal_magneto.sql +11 -0
  456. package/template/packages/database/drizzle/0049_right_lenny_balinger.sql +79 -0
  457. package/template/packages/database/drizzle/0050_greedy_sister_grimm.sql +92 -0
  458. package/template/packages/database/drizzle/0051_lame_shockwave.sql +19 -0
  459. package/template/packages/database/drizzle/0052_tiresome_komodo.sql +1 -0
  460. package/template/packages/database/drizzle/0053_calm_victor_mancha.sql +1 -0
  461. package/template/packages/database/drizzle/0054_tough_thanos.sql +29 -0
  462. package/template/packages/database/drizzle/meta/0048_snapshot.json +8852 -0
  463. package/template/packages/database/drizzle/meta/0049_snapshot.json +9410 -0
  464. package/template/packages/database/drizzle/meta/0050_snapshot.json +10115 -0
  465. package/template/packages/database/drizzle/meta/0051_snapshot.json +10257 -0
  466. package/template/packages/database/drizzle/meta/0052_snapshot.json +10263 -0
  467. package/template/packages/database/drizzle/meta/0053_snapshot.json +10270 -0
  468. package/template/packages/database/drizzle/meta/0054_snapshot.json +10468 -0
  469. package/template/packages/database/drizzle/meta/_journal.json +49 -0
  470. package/template/packages/database/package.json +1 -1
  471. package/template/packages/database/src/agent-runtime-schema.test.ts +15 -0
  472. package/template/packages/database/src/ai-output-artifacts.test.ts +57 -0
  473. package/template/packages/database/src/schema/agent-runtime.ts +43 -0
  474. package/template/packages/database/src/schema/ai-output-artifacts.ts +182 -0
  475. package/template/packages/database/src/schema/embedding-runtime.ts +62 -0
  476. package/template/packages/database/src/schema/file-storage.ts +18 -0
  477. package/template/packages/database/src/schema/index.ts +3 -0
  478. package/template/packages/database/src/schema/report-staging.ts +212 -0
  479. package/template/packages/database/src/schema.test.ts +19 -0
  480. package/template/packages/jobs/package.json +1 -1
  481. package/template/packages/modules/index.ts +1 -0
  482. package/template/packages/modules/package.json +1 -1
  483. package/template/packages/modules/src/ai-operation-composition.test.ts +37 -0
  484. package/template/packages/modules/src/ai-operation-composition.ts +2 -0
  485. package/template/packages/modules/src/ai-operation-readiness-contract.test.ts +38 -0
  486. package/template/packages/modules/src/ai-operation-readiness-contract.ts +34 -0
  487. package/template/packages/modules/src/capability-audit-validation.ts +20 -0
  488. package/template/packages/modules/src/capability-guard-validation.ts +41 -0
  489. package/template/packages/modules/src/composition.ts +11 -0
  490. package/template/packages/modules/src/manifest.ts +40 -0
  491. package/template/packages/modules/src/secret-composition.test.ts +308 -0
  492. package/template/packages/modules/src/secret-composition.ts +176 -0
  493. package/template/packages/modules/src/system-api-control-plane.ts +17 -1
  494. package/template/packages/modules/src/system-module-catalog.test.ts +52 -0
  495. package/template/packages/modules/src/system-module-catalog.ts +1 -1
  496. package/template/packages/server-sdk/contracts/ai-runtime-readiness/v1/document-python-parity.json +12 -0
  497. package/template/packages/server-sdk/contracts/ai-runtime-readiness/v1/document.json +70 -0
  498. package/template/packages/server-sdk/contracts/ai-runtime-readiness/v1/embedding.json +68 -0
  499. package/template/packages/server-sdk/contracts/ai-runtime-readiness/v1/speech.json +80 -0
  500. package/template/packages/server-sdk/contracts/ai-runtime-readiness/v1/vlm.json +70 -0
  501. package/template/packages/server-sdk/contracts/document-runtime/v1/fingerprint-fixture.json +101 -0
  502. package/template/packages/server-sdk/index.ts +109 -0
  503. package/template/packages/server-sdk/package.json +22 -3
  504. package/template/packages/server-sdk/src/ai-runtime-readiness-capture.ts +168 -0
  505. package/template/packages/server-sdk/src/ai-runtime-readiness-digest.ts +49 -0
  506. package/template/packages/server-sdk/src/ai-runtime-readiness-identity.ts +16 -0
  507. package/template/packages/server-sdk/src/ai-runtime-readiness-keys.ts +23 -0
  508. package/template/packages/server-sdk/src/ai-runtime-readiness-limits.ts +141 -0
  509. package/template/packages/server-sdk/src/ai-runtime-readiness-projection.ts +326 -0
  510. package/template/packages/server-sdk/src/ai-runtime-readiness-requirement.ts +31 -0
  511. package/template/packages/server-sdk/src/ai-runtime-readiness-time.ts +16 -0
  512. package/template/packages/server-sdk/src/ai-runtime-readiness-trust.ts +84 -0
  513. package/template/packages/server-sdk/src/ai-runtime-readiness-validation-values.ts +147 -0
  514. package/template/packages/server-sdk/src/ai-runtime-readiness-validation.ts +299 -0
  515. package/template/packages/server-sdk/src/ai-runtime-readiness-values.ts +42 -0
  516. package/template/packages/server-sdk/src/ai-runtime-readiness.adversarial-input.contract.test.ts +146 -0
  517. package/template/packages/server-sdk/src/ai-runtime-readiness.contract-support.ts +139 -0
  518. package/template/packages/server-sdk/src/ai-runtime-readiness.contract.test.ts +314 -0
  519. package/template/packages/server-sdk/src/ai-runtime-readiness.digest-safety.contract.test.ts +131 -0
  520. package/template/packages/server-sdk/src/ai-runtime-readiness.fail-closed.contract.test.ts +215 -0
  521. package/template/packages/server-sdk/src/ai-runtime-readiness.identity.contract.test.ts +138 -0
  522. package/template/packages/server-sdk/src/ai-runtime-readiness.input-safety.contract.test.ts +314 -0
  523. package/template/packages/server-sdk/src/ai-runtime-readiness.public-api.test.ts +18 -0
  524. package/template/packages/server-sdk/src/ai-runtime-readiness.python-parity.contract.test.ts +160 -0
  525. package/template/packages/server-sdk/src/ai-runtime-readiness.trust.contract.test.ts +135 -0
  526. package/template/packages/server-sdk/src/ai-runtime-readiness.ts +198 -0
  527. package/template/packages/server-sdk/src/ai-screenshot-intake-port.ts +58 -0
  528. package/template/packages/server-sdk/src/data-governance-registration.ts +1 -3
  529. package/template/packages/server-sdk/src/durable-handler.ts +12 -0
  530. package/template/packages/server-sdk/src/module-adapter.test.ts +10 -0
  531. package/template/packages/server-sdk/src/module-adapter.ts +3 -0
  532. package/template/packages/server-sdk/src/module-host.ts +8 -0
  533. package/template/packages/server-sdk/src/report-staging-context-compatibility.test.ts +25 -0
  534. package/template/packages/server-sdk/src/report-staging-port.ts +190 -0
  535. package/template/packages/server-sdk/src/request-context.ts +27 -1
  536. package/template/packages/server-sdk/src/route-definition.ts +6 -0
  537. package/template/packages/server-sdk/src/secret-binding.test.ts +66 -0
  538. package/template/packages/server-sdk/src/secret-binding.ts +54 -0
  539. package/template/packages/server-sdk/src/secret-context-compatibility.test.ts +77 -0
  540. package/template/packages/server-sdk/src/secret-port.ts +80 -0
  541. package/template/packages/server-sdk/src/storage-port.ts +129 -9
  542. package/template/packages/server-sdk/src/storage-v052-source-compatibility.test.ts +61 -0
  543. package/template/packages/shared/index.ts +2 -0
  544. package/template/packages/shared/package.json +4 -1
  545. package/template/packages/shared/src/ai-operation-readiness.test.ts +75 -0
  546. package/template/packages/shared/src/ai-operation-readiness.ts +170 -0
  547. package/template/packages/shared/src/license-catalog.ts +14 -9
  548. package/template/packages/shared/src/stable-key.ts +26 -0
  549. package/template/packages/shared/tsconfig.json +16 -0
  550. package/template/packages/storage/index.ts +2 -0
  551. package/template/packages/storage/package.json +1 -1
  552. package/template/packages/storage/src/in-memory-upload-repository.ts +105 -2
  553. package/template/packages/storage/src/local-file-blob-store.test.ts +58 -0
  554. package/template/packages/storage/src/local-file-blob-store.ts +5 -71
  555. package/template/packages/storage/src/local-file-blob-writer.ts +96 -0
  556. package/template/packages/storage/src/upload-abort-recovery.test.ts +234 -0
  557. package/template/packages/storage/src/upload-abort.ts +130 -0
  558. package/template/packages/storage/src/upload-cleanup-race.test.ts +207 -0
  559. package/template/packages/storage/src/upload-cleanup.ts +85 -0
  560. package/template/packages/storage/src/upload-completion.ts +52 -0
  561. package/template/packages/storage/src/upload-purge.test.ts +163 -0
  562. package/template/packages/storage/src/upload-purge.ts +261 -0
  563. package/template/packages/storage/src/upload-repository-v052-compatibility.test.ts +31 -0
  564. package/template/packages/storage/src/upload-repository.ts +61 -0
  565. package/template/packages/storage/src/upload-service-recovery.test.ts +296 -0
  566. package/template/packages/storage/src/upload-service.ts +138 -150
  567. package/template/packages/storage/src/upload-streams.ts +126 -30
  568. package/template/packages/storage/src/upload-types.ts +13 -0
  569. package/template/packages/storage/src/upload-validation.ts +127 -0
  570. package/template/scripts/provision-speech-readiness.ts +147 -0
@@ -0,0 +1,68 @@
1
+ {
2
+ "name": "embedding-text-ready",
3
+ "now": "2026-07-31T00:00:00.000Z",
4
+ "operation": {
5
+ "schemaVersion": 1,
6
+ "operationKey": "analysis.embedding.text",
7
+ "runtimeKind": "embedding",
8
+ "expectedDeployment": {
9
+ "key": "embedding.local-text",
10
+ "identity": "windy-deployment-v1_a294c0b7-6d31-4c52-b8ea-62fd9f4a1e03",
11
+ "releaseDigest": "sha256:cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc",
12
+ "offersDigest": "sha256:a193e4dd4a79af6915204a6b07a85b34d88a218ef04fd66fd2f85809458c7cc5"
13
+ },
14
+ "variant": "embed/text",
15
+ "requiredCapabilities": ["embedding.text"],
16
+ "inputModalities": ["text"],
17
+ "outputModalities": ["embedding"],
18
+ "limits": {
19
+ "maxDurationSeconds": 60,
20
+ "maxInputBytes": 20000000,
21
+ "maxOutputBytes": 20000000,
22
+ "maxUnits": 64
23
+ },
24
+ "resources": {
25
+ "minConcurrentRuns": 4,
26
+ "minQueueDepth": 64
27
+ }
28
+ },
29
+ "snapshot": {
30
+ "schemaVersion": 1,
31
+ "status": "ready",
32
+ "configured": true,
33
+ "runtimeKind": "embedding",
34
+ "observedAt": "2026-07-31T00:00:00.000Z",
35
+ "downstreamProbe": {
36
+ "status": "passed",
37
+ "checkedAt": "2026-07-31T00:00:00.000Z",
38
+ "validUntil": "2026-07-31T00:05:00.000Z",
39
+ "latencyMs": 12,
40
+ "deploymentIdentity": "windy-deployment-v1_a294c0b7-6d31-4c52-b8ea-62fd9f4a1e03",
41
+ "releaseDigest": "sha256:cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc",
42
+ "offersDigest": "sha256:a193e4dd4a79af6915204a6b07a85b34d88a218ef04fd66fd2f85809458c7cc5"
43
+ },
44
+ "deployment": {
45
+ "key": "embedding.local-text",
46
+ "identity": "windy-deployment-v1_a294c0b7-6d31-4c52-b8ea-62fd9f4a1e03",
47
+ "releaseDigest": "sha256:cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc",
48
+ "offersDigest": "sha256:a193e4dd4a79af6915204a6b07a85b34d88a218ef04fd66fd2f85809458c7cc5"
49
+ },
50
+ "offers": [
51
+ {
52
+ "variant": "embed/text",
53
+ "capabilities": ["embedding.text"],
54
+ "inputModalities": ["text"],
55
+ "outputModalities": ["embedding"],
56
+ "limits": {
57
+ "maxDurationSeconds": 120,
58
+ "maxInputBytes": 32000000,
59
+ "maxOutputBytes": 64000000,
60
+ "maxUnits": 256,
61
+ "maxConcurrentRuns": 8,
62
+ "maxQueueDepth": 128
63
+ }
64
+ }
65
+ ],
66
+ "unavailableReasons": []
67
+ }
68
+ }
@@ -0,0 +1,80 @@
1
+ {
2
+ "name": "speech-transcribe-ready",
3
+ "now": "2026-07-31T00:00:00.000Z",
4
+ "operation": {
5
+ "schemaVersion": 1,
6
+ "operationKey": "evidence.audio.transcribe",
7
+ "runtimeKind": "speech",
8
+ "expectedDeployment": {
9
+ "key": "speech.intranet-asr",
10
+ "identity": "windy-deployment-v1_8c4a2f19-13ab-4a7e-a1d4-24b9c49d3e02",
11
+ "releaseDigest": "sha256:bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
12
+ "offersDigest": "sha256:62b334e86cb1931cf603349b3c19110c9daad0abedb74271367ea2b93e281d43"
13
+ },
14
+ "variant": "transcribe",
15
+ "requiredCapabilities": [
16
+ "speech.transcribe.batch",
17
+ "speech.normalize",
18
+ "speech.vad",
19
+ "speech.timestamps"
20
+ ],
21
+ "inputModalities": ["audio", "video"],
22
+ "outputModalities": ["text"],
23
+ "limits": {
24
+ "maxDurationSeconds": 1800,
25
+ "maxInputBytes": 536870912,
26
+ "maxOutputBytes": 33554432,
27
+ "maxUnits": 100000,
28
+ "maxMediaDurationSeconds": 28800
29
+ },
30
+ "resources": {
31
+ "minConcurrentRuns": 1,
32
+ "minQueueDepth": 8
33
+ }
34
+ },
35
+ "snapshot": {
36
+ "schemaVersion": 1,
37
+ "status": "ready",
38
+ "configured": true,
39
+ "runtimeKind": "speech",
40
+ "observedAt": "2026-07-31T00:00:00.000Z",
41
+ "downstreamProbe": {
42
+ "status": "passed",
43
+ "checkedAt": "2026-07-31T00:00:00.000Z",
44
+ "validUntil": "2026-07-31T00:05:00.000Z",
45
+ "latencyMs": 24,
46
+ "deploymentIdentity": "windy-deployment-v1_8c4a2f19-13ab-4a7e-a1d4-24b9c49d3e02",
47
+ "releaseDigest": "sha256:bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
48
+ "offersDigest": "sha256:62b334e86cb1931cf603349b3c19110c9daad0abedb74271367ea2b93e281d43"
49
+ },
50
+ "deployment": {
51
+ "key": "speech.intranet-asr",
52
+ "identity": "windy-deployment-v1_8c4a2f19-13ab-4a7e-a1d4-24b9c49d3e02",
53
+ "releaseDigest": "sha256:bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
54
+ "offersDigest": "sha256:62b334e86cb1931cf603349b3c19110c9daad0abedb74271367ea2b93e281d43"
55
+ },
56
+ "offers": [
57
+ {
58
+ "variant": "transcribe",
59
+ "capabilities": [
60
+ "speech.transcribe.batch",
61
+ "speech.normalize",
62
+ "speech.vad",
63
+ "speech.timestamps"
64
+ ],
65
+ "inputModalities": ["audio", "video"],
66
+ "outputModalities": ["text"],
67
+ "limits": {
68
+ "maxDurationSeconds": 3600,
69
+ "maxInputBytes": 1073741824,
70
+ "maxOutputBytes": 67108864,
71
+ "maxUnits": 200000,
72
+ "maxMediaDurationSeconds": 86400,
73
+ "maxConcurrentRuns": 2,
74
+ "maxQueueDepth": 16
75
+ }
76
+ }
77
+ ],
78
+ "unavailableReasons": []
79
+ }
80
+ }
@@ -0,0 +1,70 @@
1
+ {
2
+ "name": "vlm-vision-ready",
3
+ "now": "2026-07-31T00:00:00.000Z",
4
+ "operation": {
5
+ "schemaVersion": 1,
6
+ "operationKey": "evidence.image.inspect",
7
+ "runtimeKind": "agent",
8
+ "expectedDeployment": {
9
+ "key": "ai.openai-compatible",
10
+ "identity": "windy-deployment-v1_f31e8a65-92cb-4d03-8a77-3c1b5e9d4f04",
11
+ "releaseDigest": "sha256:dddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddd",
12
+ "offersDigest": "sha256:c05c0b1d32d9e1d253c7fa6cec29dee1e39908ea4bb65725adf41e51292ad495"
13
+ },
14
+ "variant": "vision",
15
+ "requiredCapabilities": ["text-generation", "vision"],
16
+ "inputModalities": ["text", "image"],
17
+ "outputModalities": ["text"],
18
+ "limits": {
19
+ "maxDurationSeconds": 120,
20
+ "maxInputBytes": 33554432,
21
+ "maxOutputBytes": 1048576,
22
+ "maxArtifacts": 8,
23
+ "maxPixelsPerArtifact": 24000000
24
+ },
25
+ "resources": {
26
+ "minConcurrentRuns": 2,
27
+ "minQueueDepth": 16
28
+ }
29
+ },
30
+ "snapshot": {
31
+ "schemaVersion": 1,
32
+ "status": "ready",
33
+ "configured": true,
34
+ "runtimeKind": "agent",
35
+ "observedAt": "2026-07-31T00:00:00.000Z",
36
+ "downstreamProbe": {
37
+ "status": "passed",
38
+ "checkedAt": "2026-07-31T00:00:00.000Z",
39
+ "validUntil": "2026-07-31T00:05:00.000Z",
40
+ "latencyMs": 31,
41
+ "deploymentIdentity": "windy-deployment-v1_f31e8a65-92cb-4d03-8a77-3c1b5e9d4f04",
42
+ "releaseDigest": "sha256:dddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddd",
43
+ "offersDigest": "sha256:c05c0b1d32d9e1d253c7fa6cec29dee1e39908ea4bb65725adf41e51292ad495"
44
+ },
45
+ "deployment": {
46
+ "key": "ai.openai-compatible",
47
+ "identity": "windy-deployment-v1_f31e8a65-92cb-4d03-8a77-3c1b5e9d4f04",
48
+ "releaseDigest": "sha256:dddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddd",
49
+ "offersDigest": "sha256:c05c0b1d32d9e1d253c7fa6cec29dee1e39908ea4bb65725adf41e51292ad495"
50
+ },
51
+ "offers": [
52
+ {
53
+ "variant": "vision",
54
+ "capabilities": ["text-generation", "vision"],
55
+ "inputModalities": ["text", "image"],
56
+ "outputModalities": ["text"],
57
+ "limits": {
58
+ "maxDurationSeconds": 180,
59
+ "maxInputBytes": 67108864,
60
+ "maxOutputBytes": 2097152,
61
+ "maxArtifacts": 16,
62
+ "maxPixelsPerArtifact": 100000000,
63
+ "maxConcurrentRuns": 4,
64
+ "maxQueueDepth": 32
65
+ }
66
+ }
67
+ ],
68
+ "unavailableReasons": []
69
+ }
70
+ }
@@ -0,0 +1,101 @@
1
+ {
2
+ "contractVersion": 1,
3
+ "request": {
4
+ "kind": "document",
5
+ "runId": "doc_1111111111111111111111111111111111111111111111111111111111111111",
6
+ "operationKey": "evidence.document.ocr",
7
+ "options": {
8
+ "语言": "中文",
9
+ "normalize": true,
10
+ "threshold": 0.75,
11
+ "outputs": ["pages", "searchable-pdf"]
12
+ },
13
+ "sources": [
14
+ {
15
+ "value": "opaque-input-ref-a",
16
+ "mediaType": "application/pdf",
17
+ "byteSize": 12,
18
+ "sha256": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
19
+ },
20
+ {
21
+ "value": "opaque-input-ref-b",
22
+ "mediaType": "image/png",
23
+ "byteSize": 7,
24
+ "sha256": "bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb"
25
+ }
26
+ ],
27
+ "requiredCapabilities": ["document.table", "document.ocr"],
28
+ "dataClassification": "sensitive",
29
+ "limits": {
30
+ "maxDurationSeconds": 600,
31
+ "maxInputBytes": 1048576,
32
+ "maxOutputBytes": 65536,
33
+ "maxUnits": 500,
34
+ "maxArtifacts": 2
35
+ },
36
+ "providerEgress": {
37
+ "mode": "configured-endpoint",
38
+ "deploymentKey": "intranet-ocr-primary"
39
+ },
40
+ "providerDataPolicy": {
41
+ "inputFields": [
42
+ {
43
+ "jsonPointer": "/outputs",
44
+ "classification": "internal",
45
+ "dlpAction": "reject"
46
+ },
47
+ {
48
+ "jsonPointer": "/语言",
49
+ "classification": "sensitive",
50
+ "dlpAction": "redact"
51
+ }
52
+ ],
53
+ "envelopeFields": [
54
+ {
55
+ "field": "artifact-content",
56
+ "classification": "sensitive",
57
+ "dlpAction": "reject"
58
+ },
59
+ {
60
+ "field": "provider-output",
61
+ "classification": "sensitive",
62
+ "dlpAction": "redact"
63
+ }
64
+ ]
65
+ },
66
+ "outputArtifactSink": {
67
+ "contractVersion": 1,
68
+ "scope": "outscope_22222222222222222222222222222222",
69
+ "outputKind": "searchable-pdf",
70
+ "deploymentIdentity": "windy-deployment-v1_7db61d8e-e50d-4f8a-9f3f-9b7a1d932e01",
71
+ "releaseDigest": "sha256:cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc",
72
+ "offersDigest": "sha256:dddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddd",
73
+ "policyDigest": "eeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee",
74
+ "grantGeneration": 3,
75
+ "allowedMediaTypes": ["audio/wav", "application/pdf"],
76
+ "expiresAt": "2030-07-31T12:05:00.000Z",
77
+ "limits": {
78
+ "maxArtifactBytes": 32768,
79
+ "maxArtifacts": 2,
80
+ "maxTotalBytes": 65536
81
+ }
82
+ }
83
+ },
84
+ "excludedVariant": {
85
+ "sourceValues": ["rotated-ref-x", "rotated-ref-y"],
86
+ "scope": "outscope_33333333333333333333333333333333",
87
+ "grantGeneration": 9,
88
+ "expiresAt": "2031-08-01T00:00:00.000Z"
89
+ },
90
+ "invalidCanonicalJson": [
91
+ {
92
+ "label": "unsafe-integer",
93
+ "json": "{\"value\":9007199254740992}"
94
+ },
95
+ {
96
+ "label": "lone-surrogate",
97
+ "json": "{\"value\":\"\\ud800\"}"
98
+ }
99
+ ],
100
+ "expectedSha256": "65cc7fbc36b66fabb341a2ea6d55ae17aeb073b9e308a31276cbf9e47ca72837"
101
+ }
@@ -10,6 +10,55 @@ export type {
10
10
  ModuleEmbeddingItem,
11
11
  } from "./src/ai-operation-port.js";
12
12
  export { ModuleAiOperationError } from "./src/ai-operation-port.js";
13
+ export {
14
+ AI_OPERATION_MAX_REQUIRED_CAPABILITIES_V1,
15
+ AI_READINESS_REASON_CODES_V1,
16
+ AI_RUNTIME_KINDS_V1,
17
+ AI_RUNTIME_MAX_CAPABILITIES_PER_OFFER_V1,
18
+ AI_RUNTIME_MAX_OFFERS_V1,
19
+ AI_RUNTIME_MODALITIES_V1,
20
+ AI_RUNTIME_MAX_PROBE_TTL_SECONDS,
21
+ AI_RUNTIME_MAX_UNAVAILABLE_REASONS_V1,
22
+ AI_RUNTIME_PROBE_FAILURE_CODES_V1,
23
+ AI_RUNTIME_READINESS_SCHEMA_VERSION,
24
+ type AiOperationReadinessRequirementV1,
25
+ type AiOperationRequiredLimitsV1,
26
+ type AiOperationRequiredResourcesV1,
27
+ type AiReadinessReasonCodeV1,
28
+ type AiReadinessReasonV1,
29
+ type AiRuntimeDeploymentV1,
30
+ type AiRuntimeDownstreamProbeV1,
31
+ type AiRuntimeKindV1,
32
+ type AiRuntimeModalityV1,
33
+ type AiRuntimeOfferLimitsV1,
34
+ type AiRuntimeOfferV1,
35
+ type AiRuntimeOffersDigestV1,
36
+ type AiRuntimeProbeFailureCodeV1,
37
+ type AiRuntimeReadinessV1,
38
+ type AiRuntimeReadyV1,
39
+ type AiRuntimeReleaseDigestV1,
40
+ type AiRuntimeUnavailableV1,
41
+ type ModuleAiOperationReadinessPortV1,
42
+ type ModuleAiOperationReadinessV1,
43
+ type ModuleAiOperationReadyV1,
44
+ type ModuleAiOperationUnavailableV1,
45
+ } from "./src/ai-runtime-readiness.js";
46
+ export { computeAiRuntimeOffersDigestV1 } from "./src/ai-runtime-readiness-digest.js";
47
+ export {
48
+ AI_RUNTIME_DEPLOYMENT_IDENTITY_PREFIX_V1,
49
+ parseAiRuntimeDeploymentIdentityV1,
50
+ type AiRuntimeDeploymentIdentityV1,
51
+ } from "./src/ai-runtime-readiness-identity.js";
52
+ export {
53
+ parseAiRuntimeReadinessV1,
54
+ type AiRuntimeReadinessParseResult,
55
+ } from "./src/ai-runtime-readiness-validation.js";
56
+ export {
57
+ projectAiOperationReadinessV1,
58
+ type ProjectAiOperationReadinessOptionsV1,
59
+ } from "./src/ai-runtime-readiness-projection.js";
60
+ export type { AiRuntimeTrustedFullAttestationV1 } from "./src/ai-runtime-readiness-trust.js";
61
+ export { validAiOperationReadinessRequirementV1 } from "@southwind-ai/shared";
13
62
  export type {
14
63
  ModuleBackgroundAiErrorCode,
15
64
  ModuleBackgroundAiOperationInput,
@@ -46,6 +95,31 @@ export type {
46
95
  ModuleJobView,
47
96
  } from "./src/jobs-port.js";
48
97
  export { ModuleJobControlError } from "./src/jobs-port.js";
98
+ export type {
99
+ ModuleOpenedReportStagingEntry,
100
+ ModuleReportStagingCreateInput,
101
+ ModuleReportStagingEntryPage,
102
+ ModuleReportStagingEntryView,
103
+ ModuleReportStagingErrorCode,
104
+ ModuleReportStagingGroupView,
105
+ ModuleReportStagingManifestV1,
106
+ ModuleReportStagingPolicyV1,
107
+ ModuleReportStagingPortV1,
108
+ ModuleReportStagingReadLeaseView,
109
+ ModuleReportStagingSourceInput,
110
+ ModuleReportStagingSourceMode,
111
+ ModuleReportStagingSourceReader,
112
+ ModuleReportStagingSourceView,
113
+ ModuleReportStagingStatus,
114
+ } from "./src/report-staging-port.js";
115
+ export {
116
+ MODULE_REPORT_STAGING_MAX_ARCHIVE_VOLUMES,
117
+ MODULE_REPORT_STAGING_MAX_ENTRIES,
118
+ MODULE_REPORT_STAGING_MAX_SOURCES,
119
+ MODULE_REPORT_STAGING_PATH_MAX_BYTES,
120
+ ModuleReportStagingError,
121
+ requireModuleReportStagingPortV1,
122
+ } from "./src/report-staging-port.js";
49
123
  export type {
50
124
  ModuleDurableHandlerCapability,
51
125
  ModuleDurableHandlerContext,
@@ -79,6 +153,30 @@ export {
79
153
  } from "./src/module-adapter.js";
80
154
  export { requireModuleNamespace } from "./src/namespace.js";
81
155
  export type { ModuleRequestContext } from "./src/request-context.js";
156
+ export type {
157
+ ModuleAiScreenshotIntakePortV1,
158
+ ModuleAiScreenshotIntakeCreateV2,
159
+ ModuleAiScreenshotIntakeProducerV2,
160
+ ModuleAiScreenshotPlanV1,
161
+ ModuleAiScreenshotPlanV2,
162
+ } from "./src/ai-screenshot-intake-port.js";
163
+ export type {
164
+ ModuleSecretBinding,
165
+ ModuleSecretBindingResolution,
166
+ ModuleSecretPort,
167
+ ModuleSecretRequest,
168
+ ModuleSecretSafeValue,
169
+ } from "./src/secret-port.js";
170
+ export {
171
+ ModuleSecretError,
172
+ requireModuleSecretPort,
173
+ type ModuleSecretErrorCode,
174
+ } from "./src/secret-port.js";
175
+ export {
176
+ createModuleSecretBinding,
177
+ type ModuleSecretBindingInput,
178
+ type ModuleSecretValueResolver,
179
+ } from "./src/secret-binding.js";
82
180
  export type { ModuleRolePreset } from "./src/role-preset.js";
83
181
  export type {
84
182
  ModuleSandboxToolContext,
@@ -99,13 +197,24 @@ export type {
99
197
  ModuleSearchQuery,
100
198
  } from "./src/search-provider-port.js";
101
199
  export type {
200
+ ModuleFileView,
201
+ ModuleOpenedFile,
102
202
  ModuleOpenedResourceFile,
103
203
  ModuleResourceFileAccessContext,
104
204
  ModuleResourceFileAccessPolicy,
105
205
  ModuleResourceFileRequest,
206
+ ModuleStorageErrorCode,
106
207
  ModuleStoragePort,
208
+ ModuleStorageWritePortV1,
209
+ ModuleUploadPartInputV1,
210
+ ModuleUploadPartView,
107
211
  ModuleUploadSessionInput,
212
+ ModuleStorageWriterSessionInputV1,
213
+ ModuleUploadSessionStatus,
214
+ ModuleUploadSessionView,
108
215
  } from "./src/storage-port.js";
216
+ export { ModuleStorageError } from "./src/storage-port.js";
217
+ export { requireModuleStorageWritePortV1 } from "./src/storage-port.js";
109
218
  export type {
110
219
  ModuleUserDirectoryEntry,
111
220
  ModuleUserDirectoryPage,
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@southwind-ai/server-sdk",
3
- "version": "0.3.0",
3
+ "version": "0.4.0",
4
4
  "license": "UNLICENSED",
5
5
  "type": "module",
6
6
  "engines": {
@@ -10,8 +10,22 @@
10
10
  "index.ts",
11
11
  "src/actor.ts",
12
12
  "src/ai-artifact-port.ts",
13
+ "src/ai-screenshot-intake-port.ts",
13
14
  "src/ai-operation-port.ts",
14
15
  "src/ai-operation-registration.ts",
16
+ "src/ai-runtime-readiness.ts",
17
+ "src/ai-runtime-readiness-capture.ts",
18
+ "src/ai-runtime-readiness-digest.ts",
19
+ "src/ai-runtime-readiness-identity.ts",
20
+ "src/ai-runtime-readiness-keys.ts",
21
+ "src/ai-runtime-readiness-limits.ts",
22
+ "src/ai-runtime-readiness-projection.ts",
23
+ "src/ai-runtime-readiness-requirement.ts",
24
+ "src/ai-runtime-readiness-time.ts",
25
+ "src/ai-runtime-readiness-trust.ts",
26
+ "src/ai-runtime-readiness-validation.ts",
27
+ "src/ai-runtime-readiness-validation-values.ts",
28
+ "src/ai-runtime-readiness-values.ts",
15
29
  "src/audit-port.ts",
16
30
  "src/background-ai-port.ts",
17
31
  "src/data-governance-registration.ts",
@@ -22,15 +36,19 @@
22
36
  "src/module-adapter.ts",
23
37
  "src/namespace.ts",
24
38
  "src/request-context.ts",
39
+ "src/report-staging-port.ts",
25
40
  "src/role-preset.ts",
26
41
  "src/route-definition.ts",
27
42
  "src/sandbox-tool.ts",
28
43
  "src/search-provider-port.ts",
44
+ "src/secret-binding.ts",
45
+ "src/secret-port.ts",
29
46
  "src/storage-port.ts",
30
47
  "src/task-registration.ts",
31
48
  "src/tool-registration.ts",
32
49
  "src/tool-host-port.ts",
33
- "src/user-directory-port.ts"
50
+ "src/user-directory-port.ts",
51
+ "contracts/**/*.json"
34
52
  ],
35
53
  "scripts": {
36
54
  "test": "bun test",
@@ -42,7 +60,8 @@
42
60
  "@southwind-ai/storage": "workspace:^"
43
61
  },
44
62
  "exports": {
45
- ".": "./index.ts"
63
+ ".": "./index.ts",
64
+ "./contracts/ai-runtime-readiness/v1/*": "./contracts/ai-runtime-readiness/v1/*"
46
65
  },
47
66
  "publishConfig": {
48
67
  "access": "public"
@@ -0,0 +1,168 @@
1
+ import { isProxy } from "node:util/types";
2
+
3
+ const maximumDepth = 6;
4
+ const maximumNodes = 128;
5
+ const maximumProperties = 1_024;
6
+ const maximumArrayLength = 32;
7
+ const maximumKeyLength = 128;
8
+ const maximumStringLength = 256;
9
+ const maximumStringUnits = 131_072;
10
+ const captureFailure = Symbol("ai-runtime-readiness-capture-failure");
11
+ const unsafeKeys = new Set(["__proto__", "constructor", "prototype"]);
12
+
13
+ interface CaptureBudget {
14
+ nodes: number;
15
+ properties: number;
16
+ stringUnits: number;
17
+ readonly maximumRootArrayLength: number;
18
+ readonly seen: WeakSet<object>;
19
+ }
20
+
21
+ export type AiRuntimeInputCaptureResultV1 =
22
+ | { readonly ok: true; readonly value: unknown }
23
+ | { readonly ok: false };
24
+
25
+ export function captureAiRuntimeInputV1(
26
+ raw: unknown,
27
+ maximumRootArrayLength = maximumArrayLength,
28
+ ): AiRuntimeInputCaptureResultV1 {
29
+ if (
30
+ !Number.isSafeInteger(maximumRootArrayLength) ||
31
+ maximumRootArrayLength < 0 ||
32
+ maximumRootArrayLength > maximumArrayLength
33
+ ) {
34
+ return { ok: false };
35
+ }
36
+ try {
37
+ return {
38
+ ok: true,
39
+ value: captureValue(raw, 0, {
40
+ nodes: 0,
41
+ properties: 0,
42
+ stringUnits: 0,
43
+ maximumRootArrayLength,
44
+ seen: new WeakSet(),
45
+ }),
46
+ };
47
+ } catch {
48
+ return { ok: false };
49
+ }
50
+ }
51
+
52
+ function captureValue(
53
+ value: unknown,
54
+ depth: number,
55
+ budget: CaptureBudget,
56
+ ): unknown {
57
+ if (value === null || typeof value === "boolean") return value;
58
+ if (typeof value === "string") return captureString(value, budget);
59
+ if (typeof value === "number" && Number.isSafeInteger(value)) return value;
60
+ if (typeof value !== "object" || depth > maximumDepth || isProxy(value)) {
61
+ return failCapture();
62
+ }
63
+ if (budget.seen.has(value)) return failCapture();
64
+ budget.seen.add(value);
65
+ budget.nodes += 1;
66
+ if (budget.nodes > maximumNodes) return failCapture();
67
+
68
+ return Array.isArray(value)
69
+ ? captureArray(value, depth, budget)
70
+ : captureRecord(value, depth, budget);
71
+ }
72
+
73
+ function captureArray(
74
+ value: readonly unknown[],
75
+ depth: number,
76
+ budget: CaptureBudget,
77
+ ): readonly unknown[] {
78
+ const maximumLength =
79
+ depth === 0 ? budget.maximumRootArrayLength : maximumArrayLength;
80
+ if (
81
+ Object.getPrototypeOf(value) !== Array.prototype ||
82
+ value.length > maximumLength
83
+ ) {
84
+ return failCapture();
85
+ }
86
+ const descriptors = Object.getOwnPropertyDescriptors(value);
87
+ const keys = Reflect.ownKeys(descriptors);
88
+ if (keys.length !== value.length + 1) return failCapture();
89
+ const lengthDescriptor = descriptorValue(descriptors, "length");
90
+ if (
91
+ !lengthDescriptor ||
92
+ lengthDescriptor.enumerable ||
93
+ lengthDescriptor.value !== value.length
94
+ ) {
95
+ return failCapture();
96
+ }
97
+ addProperties(value.length, budget);
98
+ const captured: unknown[] = [];
99
+ for (let index = 0; index < value.length; index += 1) {
100
+ const descriptor = descriptorValue(descriptors, String(index));
101
+ if (!validEnumerableDataDescriptor(descriptor)) return failCapture();
102
+ captured.push(captureValue(descriptor.value, depth + 1, budget));
103
+ }
104
+ return Object.freeze(captured);
105
+ }
106
+
107
+ function captureRecord(
108
+ value: object,
109
+ depth: number,
110
+ budget: CaptureBudget,
111
+ ): Readonly<Record<string, unknown>> {
112
+ if (Object.getPrototypeOf(value) !== Object.prototype) return failCapture();
113
+ const descriptors = Object.getOwnPropertyDescriptors(value);
114
+ const keys = Reflect.ownKeys(descriptors);
115
+ addProperties(keys.length, budget);
116
+ const captured = Object.create(null) as Record<string, unknown>;
117
+ for (const key of keys) {
118
+ if (
119
+ typeof key !== "string" ||
120
+ key.length > maximumKeyLength ||
121
+ unsafeKeys.has(key)
122
+ ) {
123
+ return failCapture();
124
+ }
125
+ addStringUnits(key.length, budget);
126
+ const descriptor = descriptorValue(descriptors, key);
127
+ if (!validEnumerableDataDescriptor(descriptor)) return failCapture();
128
+ captured[key] = captureValue(descriptor.value, depth + 1, budget);
129
+ }
130
+ return Object.freeze(captured);
131
+ }
132
+
133
+ function captureString(value: string, budget: CaptureBudget): string {
134
+ if (value.length > maximumStringLength) return failCapture();
135
+ addStringUnits(value.length, budget);
136
+ return value;
137
+ }
138
+
139
+ function addProperties(count: number, budget: CaptureBudget): void {
140
+ budget.properties += count;
141
+ if (budget.properties > maximumProperties) failCapture();
142
+ }
143
+
144
+ function addStringUnits(count: number, budget: CaptureBudget): void {
145
+ budget.stringUnits += count;
146
+ if (budget.stringUnits > maximumStringUnits) failCapture();
147
+ }
148
+
149
+ function descriptorValue(
150
+ descriptors: object,
151
+ key: PropertyKey,
152
+ ): PropertyDescriptor | undefined {
153
+ return Object.getOwnPropertyDescriptor(descriptors, key)?.value as
154
+ | PropertyDescriptor
155
+ | undefined;
156
+ }
157
+
158
+ function validEnumerableDataDescriptor(
159
+ descriptor: PropertyDescriptor | undefined,
160
+ ): descriptor is PropertyDescriptor & { value: unknown } {
161
+ return Boolean(
162
+ descriptor && descriptor.enumerable && Object.hasOwn(descriptor, "value"),
163
+ );
164
+ }
165
+
166
+ function failCapture(): never {
167
+ throw captureFailure;
168
+ }