akm-cli 0.9.16 → 0.9.17-alpha.10

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 (403) hide show
  1. package/CHANGELOG.md +2101 -0
  2. package/STABILITY.md +11 -10
  3. package/dist/akm +124 -193
  4. package/dist/akm-migrate +38 -19
  5. package/dist/assets/hints/cli-hints-full.md +6 -7
  6. package/dist/assets/improve-strategies/catchup.json +0 -3
  7. package/dist/assets/improve-strategies/consolidate.json +0 -1
  8. package/dist/assets/improve-strategies/default.json +1 -2
  9. package/dist/assets/improve-strategies/proactive-maintenance.json +1 -2
  10. package/dist/assets/improve-strategies/quick.json +1 -2
  11. package/dist/assets/improve-strategies/reflect-distill.json +1 -2
  12. package/dist/assets/improve-strategies/thorough.json +0 -3
  13. package/dist/assets/prompts/consolidate-pair.md +20 -0
  14. package/dist/assets/prompts/consolidate-system.md +4 -11
  15. package/dist/assets/prompts/retrieval-relevance-judge.md +6 -0
  16. package/dist/assets/stash-skeleton/facts/conventions/backlinks.md +20 -20
  17. package/dist/assets/stash-skeleton/facts/conventions/domains.md +2 -2
  18. package/dist/assets/templates/html/health.html +3 -5
  19. package/dist/cli/retired-commands.js +1 -1
  20. package/dist/cli/shared.js +6 -2
  21. package/dist/cli/unknown-flags.js +24 -1
  22. package/dist/cli.js +68 -10
  23. package/dist/commands/agent/agent-dispatch.js +1 -1
  24. package/dist/commands/command/command-execution.js +24 -62
  25. package/dist/commands/feedback-cli.js +0 -1
  26. package/dist/commands/health/accept-rate.js +6 -0
  27. package/dist/commands/health/archive-usage.js +92 -0
  28. package/dist/commands/health/checks.js +83 -74
  29. package/dist/commands/health/config-skew.js +38 -0
  30. package/dist/commands/health/data-dir-usage.js +25 -13
  31. package/dist/commands/health/egress.js +54 -0
  32. package/dist/commands/health/html-report.js +1 -42
  33. package/dist/commands/health/improve-metrics.js +136 -591
  34. package/dist/commands/health/md-report.js +1 -6
  35. package/dist/commands/health/plugin-staleness.js +53 -3
  36. package/dist/commands/health/renderers.js +12 -4
  37. package/dist/commands/health/report-view-model.js +14 -120
  38. package/dist/commands/health/types-improve.js +4 -19
  39. package/dist/commands/health/windows.js +64 -74
  40. package/dist/commands/health.js +145 -143
  41. package/dist/commands/improve/consolidate/chunking.js +26 -117
  42. package/dist/commands/improve/consolidate/continuity-check.js +137 -0
  43. package/dist/commands/improve/consolidate/pair-pass.js +791 -0
  44. package/dist/commands/improve/consolidate/sanitize.js +54 -149
  45. package/dist/commands/improve/consolidate.js +589 -1127
  46. package/dist/commands/improve/content-hash.js +16 -24
  47. package/dist/commands/improve/distill/content-repair.js +18 -100
  48. package/dist/commands/improve/distill-guards.js +20 -81
  49. package/dist/commands/improve/distill-promotion-policy.js +23 -243
  50. package/dist/commands/improve/distill.js +608 -1041
  51. package/dist/commands/improve/eligibility.js +126 -390
  52. package/dist/commands/improve/execution.js +8 -10
  53. package/dist/commands/improve/extract-prompt.js +1 -2
  54. package/dist/commands/improve/extract.js +487 -1046
  55. package/dist/commands/improve/feedback-valence.js +0 -25
  56. package/dist/commands/improve/improve-cli.js +75 -169
  57. package/dist/commands/improve/improve-result-file.js +10 -66
  58. package/dist/commands/improve/improve-strategies.js +52 -4
  59. package/dist/commands/improve/improve-usage-report.js +18 -64
  60. package/dist/commands/improve/improve.js +480 -1074
  61. package/dist/commands/improve/ledger.js +119 -0
  62. package/dist/commands/improve/locks.js +2 -8
  63. package/dist/commands/improve/loop-stages.js +415 -1073
  64. package/dist/commands/improve/memory/derived-ref.js +12 -77
  65. package/dist/commands/improve/memory/memory-belief.js +16 -118
  66. package/dist/commands/improve/memory/memory-improve.js +266 -14
  67. package/dist/commands/improve/outcome-loop.js +28 -156
  68. package/dist/commands/improve/planner.js +5 -15
  69. package/dist/commands/improve/preparation.js +779 -2319
  70. package/dist/commands/improve/proactive-maintenance.js +34 -101
  71. package/dist/commands/improve/reflect-noise.js +104 -280
  72. package/dist/commands/improve/reflect.js +642 -1353
  73. package/dist/commands/improve/retrieval-gate.js +127 -0
  74. package/dist/commands/improve/retrieval-scope.js +92 -0
  75. package/dist/commands/improve/salience.js +41 -240
  76. package/dist/commands/improve/session-asset.js +19 -100
  77. package/dist/commands/improve/stage.js +322 -0
  78. package/dist/commands/lint/base-linter.js +37 -15
  79. package/dist/commands/proposal/drain.js +261 -578
  80. package/dist/commands/proposal/proposal-cli.js +19 -20
  81. package/dist/commands/proposal/proposal-types.js +31 -24
  82. package/dist/commands/proposal/proposal.js +38 -8
  83. package/dist/commands/proposal/propose.js +134 -160
  84. package/dist/commands/proposal/repository.js +1097 -1394
  85. package/dist/commands/proposal/validators/proposal-quality-validators.js +71 -174
  86. package/dist/commands/proposal/validators/proposal-validators.js +1 -1
  87. package/dist/commands/proposal/validators/proposals.js +22 -89
  88. package/dist/commands/read/curate.js +105 -462
  89. package/dist/commands/read/knowledge.js +3 -2
  90. package/dist/commands/read/search-cli.js +16 -33
  91. package/dist/commands/read/search.js +17 -23
  92. package/dist/commands/read/show.js +57 -108
  93. package/dist/commands/sources/bundle-cli.js +25 -2
  94. package/dist/commands/sources/bundle-config-ops.js +4 -0
  95. package/dist/commands/sources/dangerous-env-audit.js +1 -2
  96. package/dist/commands/sources/info.js +127 -29
  97. package/dist/commands/sources/installed-stashes.js +197 -746
  98. package/dist/commands/sources/schema-repair.js +98 -129
  99. package/dist/commands/sources/source-add.js +62 -12
  100. package/dist/commands/sources/source-manage.js +9 -2
  101. package/dist/commands/sources/stash-cli.js +24 -4
  102. package/dist/commands/tasks/explain.js +10 -13
  103. package/dist/commands/tasks/tasks-cli.js +12 -13
  104. package/dist/commands/tasks/tasks.js +350 -936
  105. package/dist/commands/tasks/validate.js +26 -24
  106. package/dist/commands/workflow/plan.js +22 -29
  107. package/dist/commands/workflow-cli.js +4 -4
  108. package/dist/core/adapter/adapters/akm-adapter.js +2 -1
  109. package/dist/core/adapter/adapters/akm-lint.js +2 -3
  110. package/dist/core/adapter/adapters/akm-metadata.js +42 -12
  111. package/dist/core/adapter/adapters/akm-task-adapter.js +29 -8
  112. package/dist/core/adapter/adapters/akm-workflow-adapter.js +1 -1
  113. package/dist/core/adapter/execution-source.js +17 -29
  114. package/dist/core/asset/asset-placement.js +4 -13
  115. package/dist/core/asset/frontmatter.js +106 -1
  116. package/dist/core/asset/resolve-ref.js +1 -1
  117. package/dist/core/bundle-id.js +42 -5
  118. package/dist/core/bundle-rename.js +285 -0
  119. package/dist/core/config/config-io.js +1 -2
  120. package/dist/core/config/config-schema.js +9 -34
  121. package/dist/core/config/config-walker.js +1 -1
  122. package/dist/core/config/config.js +184 -111
  123. package/dist/core/config/engine-semantics.js +0 -2
  124. package/dist/core/config/legacy-source-shape-shim.js +38 -9
  125. package/dist/core/config/schema/embedding.js +20 -5
  126. package/dist/core/config/schema/engines.js +5 -0
  127. package/dist/core/config/schema/execution.js +1 -1
  128. package/dist/core/config/schema/experimental.js +1 -1
  129. package/dist/core/config/schema/improve-processes.js +54 -125
  130. package/dist/core/config/schema/improve.js +4 -42
  131. package/dist/core/config/schema/index-config.js +9 -48
  132. package/dist/core/config/schema/scheduler.js +12 -12
  133. package/dist/core/config/schema/search.js +6 -22
  134. package/dist/core/env-secret-ref.js +0 -1
  135. package/dist/core/errors.js +8 -9
  136. package/dist/core/file-change.js +13 -5
  137. package/dist/core/file-lock.js +76 -173
  138. package/dist/core/improve-result.js +35 -7
  139. package/dist/core/improve-types.js +0 -1
  140. package/dist/core/logs-db.js +2 -2
  141. package/dist/core/loopback.js +7 -12
  142. package/dist/core/non-task-input.js +20 -0
  143. package/dist/core/parse.js +13 -16
  144. package/dist/core/paths.js +0 -24
  145. package/dist/core/redaction.js +109 -2
  146. package/dist/core/run-lock.js +2 -5
  147. package/dist/core/spawn-env.js +1 -1
  148. package/dist/core/state/migrations.js +123 -61
  149. package/dist/core/state-db-scope.js +2 -4
  150. package/dist/core/state-db.js +126 -692
  151. package/dist/core/time.js +0 -20
  152. package/dist/core/type-presentation.js +1 -9
  153. package/dist/core/write-source.js +294 -1005
  154. package/dist/execution/input-contract.js +1 -1
  155. package/dist/execution/resolved-request.js +135 -689
  156. package/dist/execution/source.js +63 -257
  157. package/dist/execution/target-ref.js +1 -1
  158. package/dist/indexer/bundle-identity-guard.js +2 -2
  159. package/dist/indexer/db/llm-cache.js +2 -2
  160. package/dist/indexer/ensure-index.js +77 -73
  161. package/dist/indexer/index-rebuild-lock.js +3 -11
  162. package/dist/indexer/index-writer-lock.js +8 -17
  163. package/dist/indexer/index-written-assets.js +141 -154
  164. package/dist/indexer/indexer.js +400 -1124
  165. package/dist/indexer/links/declared-links.js +90 -0
  166. package/dist/indexer/materialize-embeddings.js +60 -397
  167. package/dist/indexer/passes/memory-inference.js +96 -90
  168. package/dist/indexer/passes/metadata.js +132 -219
  169. package/dist/indexer/read-preflight.js +0 -7
  170. package/dist/indexer/scan/doc-to-entry.js +2 -3
  171. package/dist/indexer/scan/drain-dir.js +1 -1
  172. package/dist/indexer/search/db-search.js +190 -590
  173. package/dist/indexer/search/fts-query.js +30 -41
  174. package/dist/indexer/search/ranking.js +28 -154
  175. package/dist/indexer/search/search-attribution.js +12 -32
  176. package/dist/indexer/search/search-fields.js +11 -15
  177. package/dist/indexer/search/search-hit-enrichers.js +54 -85
  178. package/dist/indexer/search/search-source.js +1 -4
  179. package/dist/indexer/usage/usage-events.js +36 -7
  180. package/dist/indexer/walk/walker.js +3 -4
  181. package/dist/integrations/agent/engine-fallback.js +23 -40
  182. package/dist/integrations/agent/engine-resolution.js +93 -183
  183. package/dist/integrations/agent/execution.js +507 -0
  184. package/dist/integrations/agent/model-map.js +28 -156
  185. package/dist/integrations/agent/request-lowering.js +66 -141
  186. package/dist/integrations/agent/runner-dispatch.js +143 -321
  187. package/dist/integrations/agent/runner.js +54 -14
  188. package/dist/integrations/lockfile.js +53 -101
  189. package/dist/llm/client.js +18 -6
  190. package/dist/llm/embedders/deterministic.js +2 -3
  191. package/dist/llm/embedders/profile.js +71 -0
  192. package/dist/llm/embedders/remote.js +11 -17
  193. package/dist/llm/feature-gate.js +0 -8
  194. package/dist/llm/index-passes.js +3 -5
  195. package/dist/llm/memory-infer.js +1 -2
  196. package/dist/llm/structured-call.js +5 -24
  197. package/dist/output/generic-render.js +23 -11
  198. package/dist/output/html-render.js +13 -10
  199. package/dist/output/render-registry.js +3 -32
  200. package/dist/output/shapes/helpers.js +25 -38
  201. package/dist/output/shapes/passthrough.js +1 -9
  202. package/dist/{indexer/graph/graph-types.js → output/text/bundle-rename.js} +4 -1
  203. package/dist/output/text/command-format.js +69 -31
  204. package/dist/output/text/helpers.js +1 -1
  205. package/dist/output/text/migrate.js +5 -14
  206. package/dist/output/text/proposal-format.js +48 -3
  207. package/dist/output/text/show-format.js +13 -17
  208. package/dist/output/text/workflow-format.js +0 -32
  209. package/dist/output/text.js +2 -0
  210. package/dist/registry/factory.js +4 -19
  211. package/dist/registry/network.js +66 -220
  212. package/dist/registry/providers/index.js +0 -2
  213. package/dist/registry/providers/skills-sh.js +3 -14
  214. package/dist/registry/providers/static-index.js +24 -26
  215. package/dist/registry/resolve.js +55 -131
  216. package/dist/scripts/akm-migrate-node.js +42948 -92369
  217. package/dist/scripts/akm-migrate.js +42935 -92354
  218. package/dist/setup/registry-stash-loader.js +4 -13
  219. package/dist/setup/semantic-assets.js +3 -44
  220. package/dist/setup/setup.js +1 -1
  221. package/dist/setup/steps/connection.js +5 -6
  222. package/dist/setup/steps/platforms.js +2 -2
  223. package/dist/setup/steps/tasks.js +25 -15
  224. package/dist/sources/provider-factory.js +17 -18
  225. package/dist/sources/providers/filesystem.js +2 -3
  226. package/dist/sources/providers/git-install.js +7 -1
  227. package/dist/sources/providers/git-provider.js +0 -3
  228. package/dist/sources/providers/git-stash.js +83 -21
  229. package/dist/sources/providers/npm.js +2 -4
  230. package/dist/sources/providers/provider-utils.js +5 -10
  231. package/dist/sources/providers/website.js +0 -2
  232. package/dist/sources/snapshot-fetchers/website-ingest.js +1 -1
  233. package/dist/sources/website-url.js +2 -2
  234. package/dist/storage/database.js +9 -35
  235. package/dist/storage/repositories/improve-ledger-repository.js +209 -0
  236. package/dist/storage/repositories/index-connection.js +39 -72
  237. package/dist/storage/repositories/index-entries-repository.js +131 -129
  238. package/dist/storage/repositories/index-entry-mapper.js +1 -2
  239. package/dist/storage/repositories/index-entry-schema.js +101 -268
  240. package/dist/storage/repositories/index-fts-repository.js +86 -256
  241. package/dist/storage/repositories/index-links-repository.js +143 -0
  242. package/dist/storage/repositories/index-llm-cache-repository.js +7 -9
  243. package/dist/storage/repositories/index-meta-repository.js +6 -4
  244. package/dist/storage/repositories/index-schema.js +257 -325
  245. package/dist/storage/repositories/index-utility-repository.js +8 -29
  246. package/dist/storage/repositories/index-vec-repository.js +133 -414
  247. package/dist/storage/repositories/outcome-repository.js +2 -1
  248. package/dist/storage/repositories/proposals-repository.js +104 -1
  249. package/dist/storage/repositories/registry-index-cache-repository.js +100 -0
  250. package/dist/storage/repositories/salience-repository.js +1 -19
  251. package/dist/storage/repositories/task-history-repository.js +26 -4
  252. package/dist/storage/repositories/workflow-runs-repository.js +53 -244
  253. package/dist/storage/sqlite-migrations.js +136 -0
  254. package/dist/storage/sqlite-pragmas.js +11 -9
  255. package/dist/storage/sqlite-transaction.js +170 -0
  256. package/dist/storage/state-db-integrity.js +130 -0
  257. package/dist/tasks/activation-config.js +134 -62
  258. package/dist/tasks/backends/cron.js +191 -302
  259. package/dist/tasks/backends/exec-utils.js +2 -5
  260. package/dist/tasks/backends/launchd.js +141 -748
  261. package/dist/tasks/backends/schtasks.js +119 -623
  262. package/dist/tasks/prepare/prepare-support.js +5 -15
  263. package/dist/tasks/prepare/prepare.js +0 -2
  264. package/dist/tasks/resolve-akm-bin.js +20 -79
  265. package/dist/tasks/run/attempt-lifecycle.js +0 -1
  266. package/dist/tasks/run/load-task.js +1 -1
  267. package/dist/tasks/scheduler-binding.js +20 -238
  268. package/dist/tasks/scheduler-invocation.js +136 -244
  269. package/dist/tasks/scheduler-lock.js +53 -0
  270. package/dist/tasks/scheduler-sync.js +368 -679
  271. package/dist/tasks/source/parse-task-source.js +55 -9
  272. package/dist/tasks/source/task-source-v3-frozen.js +3 -4
  273. package/dist/tasks/source/task-to-v4.js +464 -88
  274. package/dist/workflows/authoring/authoring.js +3 -12
  275. package/dist/workflows/compile.js +211 -0
  276. package/dist/workflows/concurrency-policy.js +13 -74
  277. package/dist/workflows/exec/child-invocation.js +3 -17
  278. package/dist/workflows/exec/child-workflow.js +32 -141
  279. package/dist/workflows/exec/dispatch-redaction.js +13 -53
  280. package/dist/workflows/exec/environment.js +98 -0
  281. package/dist/workflows/exec/exec-unit.js +33 -140
  282. package/dist/workflows/exec/frozen-judge.js +7 -59
  283. package/dist/workflows/exec/native-executor.js +82 -341
  284. package/dist/workflows/exec/param-secrets.js +29 -47
  285. package/dist/workflows/exec/run-workflow.js +154 -387
  286. package/dist/workflows/exec/scheduler.js +9 -36
  287. package/dist/workflows/exec/step-work.js +127 -430
  288. package/dist/workflows/exec/unit-dispatch.js +11 -63
  289. package/dist/workflows/exec/unit-writer.js +8 -52
  290. package/dist/workflows/exec/worktree.js +39 -273
  291. package/dist/workflows/freeze/child-output-references.js +4 -15
  292. package/dist/workflows/freeze/environment.js +99 -92
  293. package/dist/workflows/freeze/freeze.js +172 -0
  294. package/dist/workflows/freeze/step-values.js +19 -21
  295. package/dist/workflows/freeze/targets/child-workflow.js +23 -92
  296. package/dist/workflows/freeze/targets/command.js +10 -33
  297. package/dist/workflows/freeze/targets/script.js +5 -12
  298. package/dist/workflows/freeze/targets/shell.js +3 -6
  299. package/dist/workflows/freeze/targets/task.js +25 -80
  300. package/dist/workflows/freeze/task-bindings.js +20 -67
  301. package/dist/workflows/{source-ir/github-yaml.js → github-yaml.js} +88 -206
  302. package/dist/workflows/ir/params.js +6 -51
  303. package/dist/workflows/ir/plan-hash.js +2 -34
  304. package/dist/workflows/parser.js +140 -43
  305. package/dist/{commands/improve/consolidate/types.js → workflows/plan.js} +2 -1
  306. package/dist/workflows/renderer.js +36 -69
  307. package/dist/workflows/resource-limits.js +12 -120
  308. package/dist/workflows/runtime/agent-identity.js +8 -40
  309. package/dist/workflows/runtime/run-outputs.js +3 -6
  310. package/dist/workflows/runtime/run-plan.js +316 -0
  311. package/dist/workflows/runtime/runs.js +48 -200
  312. package/dist/workflows/runtime/workflow-asset-loader.js +24 -57
  313. package/dist/workflows/{source-ir/semantics.js → source-semantics.js} +16 -20
  314. package/dist/workflows/validate-summary.js +2 -7
  315. package/docs/integration/bundling-akm.md +49 -42
  316. package/docs/migration/README.md +1 -0
  317. package/docs/migration/release-notes/0.9.17.md +43 -0
  318. package/docs/migration/v0.9.1-to-v0.9.2.md +23 -7
  319. package/docs/reference/cli.md +232 -135
  320. package/docs/reference/configuration.md +71 -57
  321. package/docs/reference/data-and-telemetry.md +20 -21
  322. package/docs/reference/tasks.md +105 -39
  323. package/docs/reference/workflow-schema.md +14 -18
  324. package/docs/reference/workflows.md +6 -9
  325. package/package.json +1 -1
  326. package/schemas/akm-config.json +115 -738
  327. package/schemas/akm-workflow.json +1 -0
  328. package/dist/assets/improve-strategies/graph-refresh.json +0 -15
  329. package/dist/assets/prompts/contradiction-judge.md +0 -33
  330. package/dist/assets/prompts/graph-extract-system.md +0 -1
  331. package/dist/assets/prompts/graph-extract-user-prompt.md +0 -35
  332. package/dist/assets/prompts/metadata-enhance-system.md +0 -1
  333. package/dist/assets/tasks/improve/akm-graph-refresh-weekly.yml +0 -4
  334. package/dist/commands/health/advisories.js +0 -150
  335. package/dist/commands/health/metrics.js +0 -329
  336. package/dist/commands/health/surfaces.js +0 -102
  337. package/dist/commands/improve/anti-collapse.js +0 -83
  338. package/dist/commands/improve/collapse-detector.js +0 -432
  339. package/dist/commands/improve/consolidate/eligibility.js +0 -48
  340. package/dist/commands/improve/consolidate/merge.js +0 -149
  341. package/dist/commands/improve/distill/promote-memory.js +0 -291
  342. package/dist/commands/improve/distill/quality-gate.js +0 -337
  343. package/dist/commands/improve/eval-cases.js +0 -52
  344. package/dist/commands/improve/memory/memory-contradiction-detect.js +0 -291
  345. package/dist/commands/improve/proposal-envelope.js +0 -31
  346. package/dist/commands/improve/run-context.js +0 -123
  347. package/dist/commands/improve/shared.js +0 -31
  348. package/dist/commands/improve/source-identity.js +0 -28
  349. package/dist/commands/improve/triage.js +0 -96
  350. package/dist/commands/proposal/drain-policies.js +0 -151
  351. package/dist/commands/sources/update-transaction.js +0 -220
  352. package/dist/core/action-contributors.js +0 -28
  353. package/dist/core/config/config-version-shim.js +0 -101
  354. package/dist/core/fs-txn.js +0 -405
  355. package/dist/core/lexical-score.js +0 -25
  356. package/dist/core/maintenance-barrier.js +0 -167
  357. package/dist/execution/executable-identity.js +0 -105
  358. package/dist/execution/guarded-source.js +0 -427
  359. package/dist/indexer/db/graph-db.js +0 -444
  360. package/dist/indexer/graph/graph-boost.js +0 -427
  361. package/dist/indexer/graph/graph-dedup.js +0 -95
  362. package/dist/indexer/graph/graph-extraction.js +0 -1108
  363. package/dist/indexer/search/name-match.js +0 -35
  364. package/dist/indexer/search/ranking-contributors.js +0 -515
  365. package/dist/indexer/search/ranking-types.js +0 -4
  366. package/dist/indexer/walk/project-context.js +0 -192
  367. package/dist/integrations/agent/execution-cascade.js +0 -566
  368. package/dist/integrations/agent/execution-definitions.js +0 -202
  369. package/dist/integrations/agent/execution-lowering.js +0 -841
  370. package/dist/integrations/agent/execution-preparation.js +0 -98
  371. package/dist/integrations/agent/inline-execution.js +0 -74
  372. package/dist/llm/graph-extract.js +0 -728
  373. package/dist/llm/metadata-enhance.js +0 -96
  374. package/dist/registry/create-provider-registry.js +0 -29
  375. package/dist/registry/pinned-request-helper.js +0 -247
  376. package/dist/registry/pinned-transport.js +0 -717
  377. package/dist/sources/providers/index.js +0 -14
  378. package/dist/storage/engines/sqlite-migrations.js +0 -271
  379. package/dist/storage/repositories/canaries-repository.js +0 -107
  380. package/dist/storage/repositories/embedding-salvage-repository.js +0 -184
  381. package/dist/storage/repositories/registry-cache.js +0 -113
  382. package/dist/tasks/scheduler-sync-preview.js +0 -52
  383. package/dist/tasks/source/task-to-v3.js +0 -507
  384. package/dist/workflows/freeze/resolve-steps.js +0 -86
  385. package/dist/workflows/freeze/source-freeze.js +0 -64
  386. package/dist/workflows/ir/compile.js +0 -321
  387. package/dist/workflows/ir/environment-v4.js +0 -330
  388. package/dist/workflows/ir/freeze-v4.js +0 -153
  389. package/dist/workflows/ir/schema-v4.js +0 -745
  390. package/dist/workflows/ir/schema.js +0 -354
  391. package/dist/workflows/program/schema.js +0 -77
  392. package/dist/workflows/runtime/checkin.js +0 -57
  393. package/dist/workflows/runtime/plan-classifier.js +0 -196
  394. package/dist/workflows/runtime/unit-checkin.js +0 -45
  395. package/dist/workflows/runtime/unit-phases.js +0 -20
  396. package/dist/workflows/schema.js +0 -4
  397. package/dist/workflows/source-ir/compile.js +0 -200
  398. package/dist/workflows/source-ir/program.js +0 -50
  399. package/dist/workflows/source-ir/result.js +0 -26
  400. package/dist/workflows/source-ir/schema.js +0 -786
  401. package/dist/workflows/source-ir/triggers.js +0 -79
  402. package/dist/workflows/source-ir/uses.js +0 -40
  403. package/dist/workflows/validator.js +0 -60
@@ -1,717 +0,0 @@
1
- // This Source Code Form is subject to the terms of the Mozilla Public
2
- // License, v. 2.0. If a copy of the MPL was not distributed with this
3
- // file, You can obtain one at https://mozilla.org/MPL/2.0/.
4
- import { spawn, spawnSync } from "node:child_process";
5
- import fs from "node:fs";
6
- import http from "node:http";
7
- import https from "node:https";
8
- import { isIP } from "node:net";
9
- import os from "node:os";
10
- import path from "node:path";
11
- import { PassThrough, Readable } from "node:stream";
12
- import { createBrotliDecompress, createGunzip, createInflate } from "node:zlib";
13
- import { bareHostname } from "../core/network-policy.js";
14
- import { nodePinnedRequestHelperSource } from "./pinned-request-helper.js";
15
- const MAX_HELPER_PRELUDE_BYTES = 64 * 1024;
16
- const MAX_HELPER_FRAME_BYTES = 1024 * 1024;
17
- const MAX_HELPER_STDERR_BYTES = 8 * 1024;
18
- const MAX_REGISTRY_REQUEST_BODY_BYTES = 16 * 1024 * 1024;
19
- const FRAME_PRELUDE = 0;
20
- const FRAME_BODY = 1;
21
- const FRAME_END = 2;
22
- const FRAME_ERROR = 3;
23
- export class RegistryPinnedTransportError extends Error {
24
- code = "REGISTRY_PINNED_TRANSPORT";
25
- constructor(message, options) {
26
- super(message, options);
27
- this.name = "RegistryPinnedTransportError";
28
- }
29
- }
30
- /**
31
- * Connect to `address` while retaining the URL hostname for Host, TLS SNI, and
32
- * certificate verification. Node uses a request-level pinned lookup. Bun uses
33
- * the same Node transport in a fresh one-request helper because Bun's TLS
34
- * client currently drops SNI when the connection is pinned to a numeric IP.
35
- */
36
- export async function requestRegistryAddressPinned(url, address, init, timeoutMs, testOptions) {
37
- if (isIP(address) === 0)
38
- throw new Error(`Pinned registry address is not an IP literal: ${address}`);
39
- const nodeExecutable = process.versions.bun ? resolveNodeExecutable(testOptions?.nodeExecutable) : undefined;
40
- assertNodeRuntimeVersion();
41
- const prepared = await prepareRequest(url, init);
42
- if (process.versions.bun) {
43
- if (!nodeExecutable)
44
- throw new RegistryPinnedTransportError("Pinned registry Node helper is unavailable");
45
- return requestWithNodeHelper(url, address, prepared, init, timeoutMs, nodeExecutable, testOptions);
46
- }
47
- return requestWithNodePinnedLookup(url, address, prepared, init, timeoutMs, testOptions);
48
- }
49
- /** Fail before DNS or socket activity when this runtime cannot provide the pinned transport. */
50
- export function assertRegistryPinnedTransportAvailable() {
51
- if (process.versions.bun) {
52
- resolveNodeExecutable(undefined);
53
- return;
54
- }
55
- assertNodeRuntimeVersion();
56
- }
57
- async function requestWithNodePinnedLookup(url, address, prepared, init, timeoutMs, testOptions) {
58
- const hostname = bareHostname(url.hostname);
59
- const requestOptions = {
60
- protocol: url.protocol,
61
- hostname,
62
- port: url.port || undefined,
63
- path: `${url.pathname}${url.search}`,
64
- method: prepared.method,
65
- headers: requestHeaders(prepared.headers, url),
66
- lookup: pinnedLookup(address),
67
- // Never reuse a connection selected for an earlier DNS answer.
68
- agent: false,
69
- signal: init?.signal ?? undefined,
70
- };
71
- if (url.protocol === "https:" && isIP(hostname) === 0) {
72
- requestOptions.servername = hostname;
73
- if (testOptions?.ca)
74
- requestOptions.ca = testOptions.ca;
75
- }
76
- return new Promise((resolve, reject) => {
77
- let settled = false;
78
- let headerTimer;
79
- const requestFn = url.protocol === "https:" ? https.request : http.request;
80
- const request = requestFn(requestOptions, (incoming) => {
81
- if (settled) {
82
- incoming.destroy();
83
- return;
84
- }
85
- settled = true;
86
- if (headerTimer)
87
- clearTimeout(headerTimer);
88
- resolve(responseFromIncoming(incoming, prepared.method, init?.signal));
89
- });
90
- headerTimer = setTimeout(() => {
91
- if (settled)
92
- return;
93
- settled = true;
94
- const error = new Error(`Registry request timed out after ${timeoutMs}ms while awaiting response headers`);
95
- reject(error);
96
- request.destroy(error);
97
- }, timeoutMs);
98
- request.once("error", (error) => {
99
- if (headerTimer)
100
- clearTimeout(headerTimer);
101
- if (settled)
102
- return;
103
- settled = true;
104
- reject(error);
105
- });
106
- writeRequestBody(request, prepared.body).catch((error) => request.destroy(error));
107
- });
108
- }
109
- async function requestWithNodeHelper(url, address, prepared, init, timeoutMs, executable, testOptions) {
110
- const artifacts = createHelperArtifacts(testOptions?.ca);
111
- const env = helperEnvironment(artifacts.caPath);
112
- const args = [artifacts.helperPath];
113
- let child;
114
- try {
115
- child = spawn(executable, args, {
116
- env,
117
- shell: false,
118
- stdio: ["pipe", "pipe", "pipe"],
119
- windowsHide: true,
120
- });
121
- }
122
- catch (error) {
123
- artifacts.cleanup();
124
- throw new RegistryPinnedTransportError("Unable to start the pinned registry Node helper", { cause: error });
125
- }
126
- try {
127
- testOptions?.onHelperSpawn?.({
128
- executable,
129
- args: [...args],
130
- env: { ...env },
131
- directory: artifacts.directory,
132
- pid: child.pid,
133
- });
134
- }
135
- catch (error) {
136
- child.kill("SIGKILL");
137
- artifacts.cleanup();
138
- throw error;
139
- }
140
- let promiseSettled = false;
141
- let responseProduced = false;
142
- let protocolTerminal = false;
143
- let childKilled = false;
144
- let consumerCancelled = false;
145
- const rawBody = new PassThrough();
146
- const stderr = collectLimitedStderr(child.stderr).catch(() => "");
147
- const exited = new Promise((resolve, reject) => {
148
- child.once("error", reject);
149
- child.once("exit", (code, signal) => resolve({ code, signal }));
150
- });
151
- void exited.then(artifacts.cleanup, artifacts.cleanup);
152
- const killChild = () => {
153
- if (childKilled || child.exitCode !== null || child.signalCode !== null)
154
- return;
155
- childKilled = true;
156
- child.kill("SIGKILL");
157
- };
158
- const abortReason = () => {
159
- const reason = init?.signal?.reason;
160
- return reason instanceof Error ? reason : new Error("Registry request aborted");
161
- };
162
- return new Promise((resolve, reject) => {
163
- const rejectBeforeResponse = (error) => {
164
- if (responseProduced) {
165
- if (!rawBody.destroyed)
166
- rawBody.destroy(asTransportError(error));
167
- return;
168
- }
169
- if (promiseSettled)
170
- return;
171
- promiseSettled = true;
172
- reject(asTransportError(error));
173
- };
174
- const onAbort = () => {
175
- const error = abortReason();
176
- killChild();
177
- rejectBeforeResponse(error);
178
- };
179
- if (init?.signal?.aborted) {
180
- onAbort();
181
- return;
182
- }
183
- init?.signal?.addEventListener("abort", onAbort, { once: true });
184
- const headerTimer = setTimeout(() => {
185
- const error = new RegistryPinnedTransportError(`Registry request timed out after ${timeoutMs}ms while awaiting response headers`);
186
- killChild();
187
- rejectBeforeResponse(error);
188
- }, timeoutMs);
189
- void writeHelperRequest(child, url, address, prepared, timeoutMs).catch((error) => {
190
- if (protocolTerminal || promiseSettled)
191
- return;
192
- killChild();
193
- rejectBeforeResponse(error);
194
- });
195
- void pumpHelperFrames(child.stdout, rawBody, exited, {
196
- onPrelude: (prelude) => {
197
- if (responseProduced)
198
- throw new RegistryPinnedTransportError("Registry helper sent more than one prelude");
199
- if (promiseSettled)
200
- throw new RegistryPinnedTransportError("Registry helper responded after the request ended");
201
- responseProduced = true;
202
- promiseSettled = true;
203
- clearTimeout(headerTimer);
204
- const response = responseFromRaw(rawBody, prelude, prepared.method, init?.signal, () => {
205
- consumerCancelled = true;
206
- if (!protocolTerminal)
207
- killChild();
208
- });
209
- resolve(response);
210
- },
211
- onTerminal: () => {
212
- protocolTerminal = true;
213
- },
214
- })
215
- .catch(async (error) => {
216
- clearTimeout(headerTimer);
217
- killChild();
218
- if (consumerCancelled || init?.signal?.aborted) {
219
- if (!promiseSettled)
220
- rejectBeforeResponse(abortReason());
221
- return;
222
- }
223
- // Always drain but never surface helper stderr: a failed executable
224
- // could echo the private stdin request, including authorization.
225
- await stderr;
226
- rejectBeforeResponse(new RegistryPinnedTransportError(asErrorMessage(error), { cause: error }));
227
- })
228
- .finally(() => {
229
- clearTimeout(headerTimer);
230
- init?.signal?.removeEventListener("abort", onAbort);
231
- });
232
- });
233
- }
234
- function resolveNodeExecutable(override) {
235
- if (override === null) {
236
- throw new RegistryPinnedTransportError("Pinned registry networking under Bun requires Node.js >= 22 on PATH; no Node executable is available");
237
- }
238
- const candidates = override === undefined
239
- ? (process.env.PATH ?? "")
240
- .split(path.delimiter)
241
- .filter(Boolean)
242
- .map((directory) => path.join(directory, process.platform === "win32" ? "node.exe" : "node"))
243
- : [override];
244
- for (const candidate of candidates) {
245
- if (!path.isAbsolute(candidate))
246
- continue;
247
- try {
248
- const resolved = fs.realpathSync(candidate);
249
- if (!path.isAbsolute(resolved) || !fs.statSync(resolved).isFile())
250
- continue;
251
- fs.accessSync(resolved, fs.constants.X_OK);
252
- if (override === undefined && !isSupportedNodeExecutable(resolved))
253
- continue;
254
- return resolved;
255
- }
256
- catch {
257
- // Try the next PATH entry. The helper itself enforces Node >= 22.
258
- }
259
- }
260
- throw new RegistryPinnedTransportError("Pinned registry networking under Bun requires Node.js >= 22 on PATH. Install Node.js or run akm with Node.");
261
- }
262
- function isSupportedNodeExecutable(executable) {
263
- const result = spawnSync(executable, ["--version"], {
264
- encoding: "utf8",
265
- env: helperEnvironment(undefined),
266
- maxBuffer: 1_024,
267
- shell: false,
268
- timeout: 3_000,
269
- windowsHide: true,
270
- });
271
- if (result.error || result.status !== 0)
272
- return false;
273
- const match = /^v(\d+)\./.exec(result.stdout.trim());
274
- const major = match?.[1];
275
- return major !== undefined && Number.parseInt(major, 10) >= 22;
276
- }
277
- function assertNodeRuntimeVersion() {
278
- if (process.versions.bun)
279
- return;
280
- const major = Number.parseInt(process.versions.node.split(".")[0] ?? "0", 10);
281
- if (!Number.isInteger(major) || major < 22) {
282
- throw new RegistryPinnedTransportError(`Pinned registry networking requires Node.js >= 22; found ${process.versions.node}`);
283
- }
284
- }
285
- function createHelperArtifacts(ca) {
286
- const directory = fs.mkdtempSync(path.join(os.tmpdir(), "akm-registry-helper-"));
287
- fs.chmodSync(directory, 0o700);
288
- const helperPath = path.join(directory, "request.mjs");
289
- const caPath = ca === undefined ? undefined : path.join(directory, "ca.pem");
290
- const cleanup = () => {
291
- for (const file of [helperPath, caPath]) {
292
- if (!file)
293
- continue;
294
- try {
295
- const stat = fs.lstatSync(file, { throwIfNoEntry: false });
296
- if (stat?.isFile())
297
- fs.unlinkSync(file);
298
- }
299
- catch {
300
- // A private one-request directory is best-effort cleanup after exit.
301
- }
302
- }
303
- try {
304
- fs.rmdirSync(directory);
305
- }
306
- catch {
307
- // Preserve unexpected contents for diagnosis; never recurse here.
308
- }
309
- };
310
- try {
311
- const source = nodePinnedRequestHelperSource();
312
- fs.writeFileSync(helperPath, source, { encoding: "utf8", flag: "wx", mode: 0o600 });
313
- if (caPath && ca !== undefined)
314
- fs.writeFileSync(caPath, ca, { flag: "wx", mode: 0o600 });
315
- for (const file of [helperPath, caPath]) {
316
- if (!file)
317
- continue;
318
- const stat = fs.lstatSync(file);
319
- if (!stat.isFile())
320
- throw new RegistryPinnedTransportError("Registry helper artifact is not a regular file");
321
- }
322
- return { directory, helperPath, caPath, cleanup };
323
- }
324
- catch (error) {
325
- cleanup();
326
- if (error instanceof RegistryPinnedTransportError)
327
- throw error;
328
- throw new RegistryPinnedTransportError("Unable to prepare the pinned registry Node helper", { cause: error });
329
- }
330
- }
331
- function helperEnvironment(caPath) {
332
- const env = {};
333
- for (const name of [
334
- "SystemRoot",
335
- "WINDIR",
336
- "TMPDIR",
337
- "TEMP",
338
- "TMP",
339
- "LANG",
340
- "LC_ALL",
341
- "TZ",
342
- "SSL_CERT_FILE",
343
- "SSL_CERT_DIR",
344
- "NODE_EXTRA_CA_CERTS",
345
- ]) {
346
- const value = process.env[name];
347
- if (value !== undefined)
348
- env[name] = value;
349
- }
350
- if (caPath)
351
- env.NODE_EXTRA_CA_CERTS = caPath;
352
- return env;
353
- }
354
- async function writeHelperRequest(child, url, address, prepared, timeoutMs) {
355
- const prelude = Buffer.from(JSON.stringify({
356
- url: url.toString(),
357
- address,
358
- method: prepared.method,
359
- headers: [...prepared.headers.entries()],
360
- timeoutMs,
361
- bodyPresent: prepared.body !== undefined,
362
- }));
363
- if (prelude.byteLength === 0 || prelude.byteLength > MAX_HELPER_PRELUDE_BYTES) {
364
- throw new RegistryPinnedTransportError("Registry helper request prelude exceeds its protocol limit");
365
- }
366
- const length = Buffer.allocUnsafe(4);
367
- length.writeUInt32BE(prelude.byteLength, 0);
368
- await writeNodeChunk(child.stdin, length);
369
- await writeNodeChunk(child.stdin, prelude);
370
- if (prepared.body instanceof Uint8Array) {
371
- await writeNodeChunk(child.stdin, prepared.body);
372
- }
373
- else if (prepared.body) {
374
- for await (const chunk of Readable.fromWeb(prepared.body)) {
375
- await writeNodeChunk(child.stdin, Buffer.from(chunk));
376
- }
377
- }
378
- await endNodeWritable(child.stdin);
379
- }
380
- async function writeNodeChunk(stream, chunk) {
381
- await new Promise((resolve, reject) => {
382
- stream.write(chunk, (error) => (error ? reject(error) : resolve()));
383
- });
384
- }
385
- async function endNodeWritable(stream) {
386
- await new Promise((resolve, reject) => {
387
- stream.once("error", reject);
388
- stream.end(() => resolve());
389
- });
390
- }
391
- async function pumpHelperFrames(stdout, rawBody, exited, callbacks) {
392
- const iterator = stdout[Symbol.asyncIterator]();
393
- let buffered = Buffer.alloc(0);
394
- const readExact = async (length) => {
395
- while (buffered.byteLength < length) {
396
- const next = await iterator.next();
397
- if (next.done)
398
- throw new RegistryPinnedTransportError("Registry helper output ended before a terminal frame");
399
- buffered = Buffer.concat([buffered, Buffer.from(next.value)]);
400
- }
401
- const result = buffered.subarray(0, length);
402
- buffered = buffered.subarray(length);
403
- return result;
404
- };
405
- let sawPrelude = false;
406
- while (true) {
407
- const frameHeader = await readExact(5);
408
- const type = frameHeader[0];
409
- const length = frameHeader.readUInt32BE(1);
410
- const limit = type === FRAME_BODY ? MAX_HELPER_FRAME_BYTES : MAX_HELPER_PRELUDE_BYTES;
411
- if (length > limit)
412
- throw new RegistryPinnedTransportError("Registry helper frame exceeds its protocol limit");
413
- const payload = await readExact(length);
414
- if (type === FRAME_PRELUDE) {
415
- if (sawPrelude)
416
- throw new RegistryPinnedTransportError("Registry helper sent duplicate response metadata");
417
- const prelude = parseHelperPrelude(payload);
418
- sawPrelude = true;
419
- callbacks.onPrelude(prelude);
420
- // A HEAD or null-body status cancels the transport synchronously from
421
- // the prelude callback. Do not consume any body frames already buffered
422
- // behind that prelude or wait for a helper that has been terminated.
423
- if (rawBody.destroyed)
424
- return;
425
- continue;
426
- }
427
- if (type === FRAME_BODY) {
428
- if (!sawPrelude)
429
- throw new RegistryPinnedTransportError("Registry helper sent body data before response metadata");
430
- if (payload.byteLength > 0 && !rawBody.write(payload)) {
431
- await new Promise((resolve, reject) => {
432
- const onDrain = () => {
433
- cleanup();
434
- resolve();
435
- };
436
- const onError = (error) => {
437
- cleanup();
438
- reject(error);
439
- };
440
- const cleanup = () => {
441
- rawBody.off("drain", onDrain);
442
- rawBody.off("error", onError);
443
- };
444
- rawBody.once("drain", onDrain);
445
- rawBody.once("error", onError);
446
- });
447
- }
448
- continue;
449
- }
450
- if (type === FRAME_END) {
451
- if (!sawPrelude || length !== 0)
452
- throw new RegistryPinnedTransportError("Registry helper sent an invalid end frame");
453
- const result = await exited;
454
- if (result.code !== 0 || result.signal) {
455
- throw new RegistryPinnedTransportError(`Registry helper exited unexpectedly (${result.signal ?? `code ${result.code ?? "unknown"}`})`);
456
- }
457
- callbacks.onTerminal();
458
- rawBody.end();
459
- return;
460
- }
461
- if (type === FRAME_ERROR) {
462
- const detail = parseHelperError(payload);
463
- throw new RegistryPinnedTransportError(detail);
464
- }
465
- throw new RegistryPinnedTransportError(`Registry helper sent unknown frame type ${String(type)}`);
466
- }
467
- }
468
- function parseHelperPrelude(payload) {
469
- let candidate;
470
- try {
471
- candidate = JSON.parse(payload.toString("utf8"));
472
- }
473
- catch {
474
- throw new RegistryPinnedTransportError("Registry helper sent invalid response metadata");
475
- }
476
- if (typeof candidate !== "object" || candidate === null) {
477
- throw new RegistryPinnedTransportError("Registry helper sent invalid response metadata");
478
- }
479
- const value = candidate;
480
- if (typeof value.status !== "number" ||
481
- !Number.isInteger(value.status) ||
482
- value.status < 200 ||
483
- value.status > 599 ||
484
- typeof value.statusText !== "string" ||
485
- !Array.isArray(value.rawHeaders) ||
486
- value.rawHeaders.length > 512 ||
487
- value.rawHeaders.length % 2 !== 0 ||
488
- value.rawHeaders.some((entry) => typeof entry !== "string" || entry.length > 16_384)) {
489
- throw new RegistryPinnedTransportError("Registry helper sent invalid response metadata");
490
- }
491
- return { status: value.status, statusText: value.statusText, rawHeaders: value.rawHeaders };
492
- }
493
- function parseHelperError(payload) {
494
- try {
495
- const candidate = JSON.parse(payload.toString("utf8"));
496
- const message = typeof candidate.message === "string" ? candidate.message : "Pinned registry helper failed";
497
- const code = typeof candidate.code === "string" ? ` [${candidate.code}]` : "";
498
- return `${message}${code}`;
499
- }
500
- catch {
501
- return "Pinned registry helper failed with an invalid error frame";
502
- }
503
- }
504
- function collectLimitedStderr(stderr) {
505
- return (async () => {
506
- const chunks = [];
507
- let total = 0;
508
- for await (const chunk of stderr) {
509
- if (total >= MAX_HELPER_STDERR_BYTES)
510
- continue;
511
- const buffer = Buffer.from(chunk);
512
- const selected = buffer.subarray(0, MAX_HELPER_STDERR_BYTES - total);
513
- chunks.push(selected);
514
- total += selected.byteLength;
515
- }
516
- return Buffer.concat(chunks).toString("utf8").trim();
517
- })();
518
- }
519
- function pinnedLookup(address) {
520
- const family = isIP(address);
521
- if (family === 0)
522
- throw new Error(`Pinned registry address is not an IP literal: ${address}`);
523
- return ((_hostname, options, callback) => {
524
- if (typeof options === "object" && options.all) {
525
- callback(null, [{ address, family }]);
526
- return;
527
- }
528
- callback(null, address, family);
529
- });
530
- }
531
- async function prepareRequest(url, init) {
532
- const method = (init?.method ?? "GET").toUpperCase();
533
- const headers = new Headers(init?.headers);
534
- const body = init?.body;
535
- if (body === undefined || body === null)
536
- return { method, headers };
537
- if (method === "GET" || method === "HEAD") {
538
- throw new TypeError(`Request with ${method} method cannot have a body`);
539
- }
540
- if (typeof body === "string") {
541
- if (!headers.has("content-type"))
542
- headers.set("content-type", "text/plain;charset=UTF-8");
543
- return { method, headers, body: boundedRequestBytes(new TextEncoder().encode(body)) };
544
- }
545
- if (body instanceof URLSearchParams) {
546
- if (!headers.has("content-type")) {
547
- headers.set("content-type", "application/x-www-form-urlencoded;charset=UTF-8");
548
- }
549
- return { method, headers, body: boundedRequestBytes(new TextEncoder().encode(body.toString())) };
550
- }
551
- if (body instanceof Blob) {
552
- if (body.type && !headers.has("content-type"))
553
- headers.set("content-type", body.type);
554
- if (body.size > MAX_REGISTRY_REQUEST_BODY_BYTES)
555
- throw requestBodyTooLarge(body.size);
556
- return { method, headers, body: boundedRequestBytes(new Uint8Array(await body.arrayBuffer())) };
557
- }
558
- if (body instanceof FormData) {
559
- const encoded = new Request(url, { method, body });
560
- for (const [name, value] of encoded.headers) {
561
- if (!headers.has(name))
562
- headers.set(name, value);
563
- }
564
- return { method, headers, body: boundedRequestBytes(new Uint8Array(await encoded.arrayBuffer())) };
565
- }
566
- if (body instanceof ArrayBuffer) {
567
- return { method, headers, body: boundedRequestBytes(new Uint8Array(body)) };
568
- }
569
- if (ArrayBuffer.isView(body)) {
570
- return {
571
- method,
572
- headers,
573
- body: boundedRequestBytes(new Uint8Array(body.buffer, body.byteOffset, body.byteLength)),
574
- };
575
- }
576
- if (body instanceof ReadableStream) {
577
- return { method, headers, body: boundedRequestStream(body) };
578
- }
579
- throw new TypeError("Unsupported registry request body type");
580
- }
581
- function boundedRequestBytes(body) {
582
- if (body.byteLength > MAX_REGISTRY_REQUEST_BODY_BYTES)
583
- throw requestBodyTooLarge(body.byteLength);
584
- return body;
585
- }
586
- function boundedRequestStream(body) {
587
- let total = 0;
588
- return body.pipeThrough(new TransformStream({
589
- transform(chunk, controller) {
590
- if (!(chunk instanceof Uint8Array)) {
591
- controller.error(new RegistryPinnedTransportError("Registry request body stream must contain byte chunks"));
592
- return;
593
- }
594
- total += chunk.byteLength;
595
- if (total > MAX_REGISTRY_REQUEST_BODY_BYTES) {
596
- controller.error(requestBodyTooLarge(total));
597
- return;
598
- }
599
- controller.enqueue(chunk);
600
- },
601
- }));
602
- }
603
- function requestBodyTooLarge(observedBytes) {
604
- return new RegistryPinnedTransportError(`Registry request body exceeds ${MAX_REGISTRY_REQUEST_BODY_BYTES} bytes (observed: ${observedBytes})`);
605
- }
606
- function requestHeaders(headers, url) {
607
- const result = {};
608
- for (const [name, value] of headers)
609
- result[name] = value;
610
- for (const name of [
611
- "connection",
612
- "keep-alive",
613
- "proxy-authorization",
614
- "proxy-connection",
615
- "te",
616
- "trailer",
617
- "transfer-encoding",
618
- "upgrade",
619
- ]) {
620
- delete result[name];
621
- }
622
- // Never let a caller pair the validated socket/TLS identity with an
623
- // unrelated HTTP virtual host.
624
- result.host = url.host;
625
- return result;
626
- }
627
- async function writeRequestBody(request, body) {
628
- if (!body) {
629
- request.end();
630
- return;
631
- }
632
- if (body instanceof Uint8Array) {
633
- request.end(body);
634
- return;
635
- }
636
- const readable = Readable.fromWeb(body);
637
- readable.once("error", (error) => request.destroy(error));
638
- readable.pipe(request);
639
- }
640
- function responseFromIncoming(incoming, method, signal) {
641
- return responseFromRaw(incoming, {
642
- status: incoming.statusCode ?? 500,
643
- statusText: incoming.statusMessage ?? "",
644
- rawHeaders: incoming.rawHeaders,
645
- }, method, signal, () => incoming.destroy());
646
- }
647
- function responseFromRaw(raw, metadata, method, signal, onCancel) {
648
- const headers = responseHeaders(metadata.rawHeaders);
649
- const { status, statusText } = metadata;
650
- if (responseMustNotHaveBody(method, status)) {
651
- // Draining is unsafe here: a hostile peer can attach an endless chunked
652
- // body to a null-body status and retain the pinned socket/helper forever.
653
- // Terminate the underlying transport before exposing the bodyless response.
654
- onCancel();
655
- if (!raw.destroyed)
656
- raw.destroy();
657
- return new Response(null, { status, statusText, headers });
658
- }
659
- const decoded = decodeResponseStream(raw, headers.get("content-encoding") ?? "");
660
- const onAbort = () => {
661
- const reason = signal?.reason;
662
- decoded.destroy(reason instanceof Error ? reason : new Error("Registry response body aborted"));
663
- onCancel();
664
- };
665
- if (signal) {
666
- if (signal.aborted)
667
- onAbort();
668
- else
669
- signal.addEventListener("abort", onAbort, { once: true });
670
- decoded.once("close", () => signal.removeEventListener("abort", onAbort));
671
- }
672
- decoded.once("error", onCancel);
673
- decoded.once("close", onCancel);
674
- const body = Readable.toWeb(decoded);
675
- return new Response(body, { status, statusText, headers });
676
- }
677
- /** Fetch null-body cases accepted by the helper's final-response protocol. */
678
- function responseMustNotHaveBody(method, status) {
679
- // Interim 1xx responses never enter this function: node:http reports them
680
- // separately and the helper protocol accepts final statuses from 200 onward.
681
- return method === "HEAD" || status === 204 || status === 205 || status === 304;
682
- }
683
- function responseHeaders(rawHeaders) {
684
- const headers = new Headers();
685
- for (let index = 0; index < rawHeaders.length; index += 2) {
686
- const name = rawHeaders[index];
687
- const value = rawHeaders[index + 1];
688
- if (name !== undefined && value !== undefined)
689
- headers.append(name, value);
690
- }
691
- return headers;
692
- }
693
- function decodeResponseStream(raw, contentEncoding) {
694
- const encodings = contentEncoding
695
- .split(",")
696
- .map((encoding) => encoding.trim().toLowerCase())
697
- .filter(Boolean)
698
- .reverse();
699
- let stream = raw;
700
- for (const encoding of encodings) {
701
- if (encoding === "gzip" || encoding === "x-gzip")
702
- stream = stream.pipe(createGunzip());
703
- else if (encoding === "deflate")
704
- stream = stream.pipe(createInflate());
705
- else if (encoding === "br")
706
- stream = stream.pipe(createBrotliDecompress());
707
- }
708
- return stream;
709
- }
710
- function asTransportError(error) {
711
- if (error instanceof Error)
712
- return error;
713
- return new RegistryPinnedTransportError(String(error));
714
- }
715
- function asErrorMessage(error) {
716
- return error instanceof Error ? error.message : String(error);
717
- }