Clone any viral video with AI agents. Not just a script, the whole workflow: swap the face, the words, the B-roll, ship 100 variants in one command, and get your 100M views.
TypeScript agentic-aiaiai-agentsai-videocompilerdslffmpeggenerative-aillmmarkup-languagemonorepoplugin-systemprogramming-languagetext-to-videotypescriptvideovideo-automationvideo-clonevideo-editingvideo-generation
refactor(v2): complete graph-first runtime foundation
kashorin2855fd2a8065
diff --git a/.gitignore b/.gitignoreindex 67b8005e..3f29cfd2 100644--- a/.gitignore+++ b/.gitignore@@ -9,3 +9,5 @@ examples/**/evidence/generated/services/whisperx/.venv/services/whisperx/**/__pycache__/services/whisperx/src/*.egg-info/+services/image-opencv/.venv/+services/image-opencv/**/__pycache__/diff --git a/README.md b/README.mdindex 9d81efa6..b4347362 100644--- a/README.md+++ b/README.md@@ -140,6 +140,8 @@ These inputs are separate by design:| `.svs` | reusable package-defined Recipe values || `.svrun` | Targets, Candidates and explicit Satisfaction edges for one reusable Run || `svml.runtime.json` / `svml.runtime.ts` | Scheduler, Stores, credential references, Endpoints and concurrency |+| `svml.packages.lock` | physical author/compute implementation closure |+| `svml.runtime-packages.lock` | physical Provider/Store adapter closure and privileged code identity |Source imports activate author vocabulary only. They never authorize network, filesystem, process,credential or queue access.@@ -207,10 +209,9 @@ rewritten under `packages/`. They are not the public v2 package taxonomy or sour## Current priorities-Work is intentionally focused on two layers:--1. Run/Runtime diagnostics, package lifecycle and developer inspection;-2. repeatable live acceptance and replaceable local/cloud Endpoint environments.--Broader Text, Caption, B-roll and Ranking visual behavior is deferred until those foundations are-clean. See the [roadmap](docs/roadmap.md).+The domain-neutral Run/Runtime foundation, developer inspection path and the first replaceable local+Endpoint environments are implemented. Current work is split between making that foundation ready+for trusted-developer distribution and turning the real talking-film acceptance path into a+repeatable harness. Text, Caption and B-roll already execute as vertical slices; their full visual+breadth, Ranking and the final video compatibility freeze remain deferred. See the+[implementation status](docs/implementation-status.md) and [roadmap](docs/roadmap.md).diff --git a/docs/README.md b/docs/README.mdindex 2bd83461..ee53792d 100644--- a/docs/README.md+++ b/docs/README.md@@ -24,6 +24,8 @@ the working tree contains only documents that should inform current implementatilocking, contributions and Host-selected facet activation.- [`local-developer-runtime-v1.md`](./local-developer-runtime-v1.md) — local SQLite/filesystemRuntime, recovery and environment replacement.+- [`runtime-adapter-loading-v1.md`](./runtime-adapter-loading-v1.md) — separately locked Provider+ and Store activation, physical-code identity, diagnostics and explicit Artifact maintenance.- [`build-archive-and-egress-v1.md`](./build-archive-and-egress-v1.md) — Targets, durable Records,Artifact retention and optional Host materialization as four separate concerns.- [`source-and-run-compilation-v1.md`](./source-and-run-compilation-v1.md) — mandatory Source Header,@@ -46,6 +48,7 @@ These video contracts are executable candidates, not yet an open-source compatib- [`kie-generation-modules-v1.md`](./kie-generation-modules-v1.md)- [`media-inspection-and-normalization-v1.md`](./media-inspection-and-normalization-v1.md)- [`media-execution-boundary-v1.md`](./media-execution-boundary-v1.md)+- [`image-transform-v1.md`](./image-transform-v1.md)- [`caption-gemini-provider-contract.md`](./caption-gemini-provider-contract.md)- [`../services/whisperx/README.md`](../services/whisperx/README.md)- [`../examples/echo-pro-aroll/README.md`](../examples/echo-pro-aroll/README.md) — current four-takediff --git a/examples/composite-speech-program/README.md b/examples/composite-speech-program/README.mdindex 054c5345..24a56550 100644--- a/examples/composite-speech-program/README.md+++ b/examples/composite-speech-program/README.md@@ -1,4 +1,9 @@-# Composite Speech Program executable fixture+# Legacy v1 Composite Speech Program executable fixture++This directory is retained as executable v1 regression evidence while the rewrite proceeds. Its+`.svk` filename is a fixture-local legacy convention, not a v2 package kind, import rule or public+file suffix. Current v2 sources use self-described Frontend Headers and ordinary package facets;+see [`../../docs/source-and-run-compilation-v1.md`](../../docs/source-and-run-compilation-v1.md).This directory proves the implemented `composite-v1` profile.diff --git a/examples/echo-pro-aroll/README.md b/examples/echo-pro-aroll/README.mdindex d319b1bf..d210d5de 100644--- a/examples/echo-pro-aroll/README.md+++ b/examples/echo-pro-aroll/README.md@@ -50,6 +50,14 @@ pnpm svml:v2 lock-packages examples/echo-pro-aroll/svml.packages.lock \--package @svml/hyperframes-render \--package @svml/run-text \--root .++pnpm svml:v2 lock-packages examples/echo-pro-aroll/svml.runtime-packages.lock \+ --package @svml/provider-kie \+ --package @svml/provider-media-local \+ --package @svml/provider-whisperx-local \+ --package @svml/provider-google-vertex \+ --package @svml/provider-hyperframes-local \+ --root .```Inspect all authored outputs—including `*.prompt` and `*.program`—without a paid call:diff --git a/examples/echo-pro-aroll/svml.packages.lock b/examples/echo-pro-aroll/svml.packages.lockindex 118bd14c..2273e711 100644--- a/examples/echo-pro-aroll/svml.packages.lock+++ b/examples/echo-pro-aroll/svml.packages.lock@@ -9,12 +9,12 @@{"name": "@svml/caption-gemini","version": "0.0.0-dev",- "digest": "sha256:13a61548967a7bfad911bb369719466f4051434c06729c5ab3c154e7aeb898a0"+ "digest": "sha256:9627669c488f9df22fef6a27f74d2bf5d499e3a0ba651eb594a9b47fe82cd21f"},{"name": "@svml/caption","version": "0.0.0-dev",- "digest": "sha256:a713e3b93bc5f1284d98a4a8e586662e1cb009b329eb0394229bf5170f996527"+ "digest": "sha256:a7f225fee5e57574f3f0d874a3ebaaca896126bee9a1ba420a022b560aaffc53"},{"name": "@svml/component-kit",@@ -24,32 +24,32 @@{"name": "@svml/contracts","version": "0.0.0-dev",- "digest": "sha256:3ff4cc952af34cd1a593a7410c688a81ad40ff23ce637b3e427776b1d2e2faa5"+ "digest": "sha256:b3a9eea0f89a6c0a5920fb055f919a123c9a45b268b31f029e466415565059d3"},{"name": "@svml/core","version": "0.0.0-dev",- "digest": "sha256:cfb73d509a819e42cad5490f26e53bf4e28a2df7ed1e47ffa85bb2833e40bd1e"+ "digest": "sha256:7b8af092e472c43f2b990d92cd7f0b0d426e19f4003582f50ca7aaefd3ec6007"},{"name": "@svml/elaborator","version": "0.0.0-dev",- "digest": "sha256:d31db89e8b0b81ec7e26da804500d14447af7fdf90c6af3a0ad95504c39f37a2"+ "digest": "sha256:d5987b778a5bc3c4b2f734140bb8fd520f5abcb86ce85391464643d59c45f78a"},{"name": "@svml/estimate","version": "0.0.0-dev",- "digest": "sha256:91770660f244539d2d0db49d46000073cca3202c6148c17466c0547001c4f2dc"+ "digest": "sha256:889457c4fce0be6df8e815add53d3ac3accd0836c78269588e3b94b8d86ee908"},{"name": "@svml/film","version": "0.0.0-dev",- "digest": "sha256:bdb739078b86f66e1b0fed646fbab675ff4875b74b5c1b58c122e5c3feb61515"+ "digest": "sha256:8ff3f93c98fe9c7825e5b47c916f50e0fc76f99331033ddc2ef59d0c71823025"},{"name": "@svml/generation","version": "0.0.0-dev",- "digest": "sha256:e1dd0c788e89989f679ed3f1de3825d3d76df32a1670258922c42fe0b7414940"+ "digest": "sha256:7cbe6e3c8db1bbe3c084bbdac82fe672908f3f8ec7f1585de28349d8711e1843"},{"name": "@svml/host",@@ -59,17 +59,17 @@{"name": "@svml/hyperframes-render","version": "0.0.0-dev",- "digest": "sha256:84fdc643dcfc751fe1c429d6d5ee665f64f0e1de8b3a3208ff64ed12c0986343"+ "digest": "sha256:6f0dcd08108987e1dd9a5701ee5d2f21d42c4559def713539f3103a19b4d5d3b"},{"name": "@svml/hyperframes","version": "0.0.0-dev",- "digest": "sha256:aea7f05d870f84782efe831c09dd729d5303cc9a5b7a54184ac3d1c193bd59fa"+ "digest": "sha256:c121a31f96d6e5c3205040c58a3a5b03d52ceb31ba584975df2d9b8ceb720ebb"},{"name": "@svml/media-pipeline","version": "0.0.0-dev",- "digest": "sha256:05cf1caee616a44c3a2796d93b38fc6022544b751a29aeaf25869d5f7a84f260"+ "digest": "sha256:4bea3929ab3efabda5748ba897bd597bcfd571ce25459cb387630dfa2a23110a"},{"name": "@svml/media",@@ -84,22 +84,22 @@{"name": "@svml/prompt-kit","version": "0.0.0-dev",- "digest": "sha256:4373ee51043dc513a04b159e90000147775ff09aa12d5496340f8297903d1575"+ "digest": "sha256:ad946daeeeba5aade1da5fc91660849f32672f6f78a085faa8efc62c1598bf85"},{"name": "@svml/protocol","version": "0.0.0-dev",- "digest": "sha256:849da200db7a4389f114381ac7b4ce64766ed350481d271394cd0c7348e76786"+ "digest": "sha256:cdede72e3612684f37302267a757cdfde7cd7d474c671e738969b10268e2e7fe"},{"name": "@svml/realization","version": "0.0.0-dev",- "digest": "sha256:049aea1333272415b6605c10004d1ca26c72d348bd00c1885927f425cedc60a2"+ "digest": "sha256:49658ecd041f65f5802e8e460c6cd03b96f0f0a455d77a831383bcd4345ccd33"},{"name": "@svml/run-text","version": "0.0.0-dev",- "digest": "sha256:77d70b1e6f8a2144e71412ca5c44ea80209546525c5b0c3db645d0413b4bd5fc"+ "digest": "sha256:f8ed7cb0371c4fee1f4f45512289784b35da303ae256b1ec805f9bba62be66d0"},{"name": "@svml/run",@@ -109,17 +109,17 @@{"name": "@svml/script","version": "0.0.0-dev",- "digest": "sha256:dfde3dd72c7151982e16c8cef39118d1514b5bf0f38543c25b601ae238fd0bfb"+ "digest": "sha256:ab8aaebbf9826330a6c3a5e51f6c2214f8d7043875a46f744987bfab10ccdb4b"},{"name": "@svml/seedance-speaker","version": "0.0.0-dev",- "digest": "sha256:12e0433da60323502018c5c6cf640e2d2dd3815bec547bc5f919f9d152909dce"+ "digest": "sha256:ed0d55e96c61d4cfb9afa2f5ba6b2d5f4d09d8f1042868678d186f3d9fef4247"},{"name": "@svml/seedance","version": "0.0.0-dev",- "digest": "sha256:f557df859cebe1af12da15890f891ca92af436583234aec694517b82fa6f3bb4"+ "digest": "sha256:495f6a66fecf255ee806c79c37c0c093be3ea3449c7d8bc57e6808b4823cb528"},{"name": "@svml/source",@@ -129,17 +129,17 @@{"name": "@svml/speech-align","version": "0.0.0-dev",- "digest": "sha256:fd66824aeae08e54e7d224cbe151bd8f1ee75e429071cc05aed1fddf52fe9c12"+ "digest": "sha256:1ae65828af4e46e1e8b4065c28451ee08109fe5e5d58e60e457ff0a610c02d90"},{"name": "@svml/speech-program","version": "0.0.0-dev",- "digest": "sha256:154950cc6346aad5b00c22450ca7e346186e3c51247d3fc11b444710d879a70a"+ "digest": "sha256:a5a120a568bcacc7a01594230d44fc0054e9f044085024332ebb15bc5ebecb2e"},{"name": "@svml/speech-take","version": "0.0.0-dev",- "digest": "sha256:67c738aede20b50bcdd748aa46ba0563b01731444eb4de7663b299f1006f863e"+ "digest": "sha256:51109dd455c17efb026f07e38a760952ab132f7c6571b7e0fcc9fd29178941b3"},{"name": "@svml/svs",@@ -159,7 +159,7 @@{"name": "@svml/whisperx","version": "0.0.0-dev",- "digest": "sha256:e3fe125fbb4ed52ffb6f099674181dda2ae859890c712644402f63745739a7b8"+ "digest": "sha256:9047e6ed3c9d88dcce16f05d273eb2295692e274b68b6d7ea1835031ef55bebf"}],"packages": [@@ -169,7 +169,8 @@"name": "@svml/artifact","version": "0.0.0-dev"},- "facetsDigest": "sha256:ed2ce2db96aff1ca26c03c28fbf3a3b7da9f25d13ea5cf62525ad6a606f952cf"+ "facetsDigest": "sha256:ed2ce2db96aff1ca26c03c28fbf3a3b7da9f25d13ea5cf62525ad6a606f952cf",+ "closureDigest": "sha256:b3a2d87a65dff2fbbb3b2e922a1d12785434a9d549776476e480260f826ddc66"},{"specifier": "@svml/caption",@@ -177,7 +178,8 @@"name": "@svml/caption","version": "0.0.0-dev"},- "facetsDigest": "sha256:182ddde2b002c4c3bc2013c5e984831aa6d034d1ded3ab17e0e71e4dd307438a"+ "facetsDigest": "sha256:9ec15efda63a1faff4f877e62465398a97a14344ff032665edb92f5d5f2fa383",+ "closureDigest": "sha256:cc5d2da369694203e40f3c818fe80c51b9e9b0e19c8e3dc1a9501c29250c3357"},{"specifier": "@svml/caption-gemini",@@ -185,7 +187,8 @@"name": "@svml/caption-gemini","version": "0.0.0-dev"},- "facetsDigest": "sha256:06d8072364f86102207c0a4bc0b59f126613010636250f53f9d5184d31bb2766"+ "facetsDigest": "sha256:b117ade42802e2b16f133d575697610cec6b48383e55c92d2d2c785a1b54b55f",+ "closureDigest": "sha256:7c5191db9d11a4981fd7db6d73f05a0bd1c9d178ad89f64dd46631e52dcd8e1b"},{"specifier": "@svml/contracts",@@ -193,7 +196,8 @@"name": "@svml/contracts","version": "0.0.0-dev"},- "facetsDigest": "sha256:1bba3b6672c77931cbc0e002d0509c6ba8f8612cb2a4e0c5897831230b3f35a9"+ "facetsDigest": "sha256:470bff823282df679db44f674439f0885a6c24947616a29bbc87ccda16a7d8a4",+ "closureDigest": "sha256:4c6d67219370a7637d19151ab8df0a2ad77647df490e00d2b9d9863e4f094547"},{"specifier": "@svml/estimate",@@ -201,7 +205,8 @@"name": "@svml/estimate","version": "0.0.0-dev"},- "facetsDigest": "sha256:9ed84b03dc1ff2010dafae78d98be326058d466bdca92d71398bc237b8c239cc"+ "facetsDigest": "sha256:2de426cc4d8dfaf06f2efe62ab8673d37ba736d7470e07014333ce223824aebf",+ "closureDigest": "sha256:0bcd70e29cad16979299b0452c7f158a45e309c62553b7c04edb02643e32c2db"},{"specifier": "@svml/film",@@ -209,7 +214,8 @@"name": "@svml/film","version": "0.0.0-dev"},- "facetsDigest": "sha256:3670c3b1093c0d4a1fea763f4fd071a86cae99e1348aee3dbc6cb57d30252dd2"+ "facetsDigest": "sha256:a3354c9ee0a11c8d9a8547cdd79404b1b2913a948caae842487d205f685ec231",+ "closureDigest": "sha256:e2ce2e2a7cca76db2ee101c46f3bf8f74fd5b843121f78767dcd4b68e92cb785"},{"specifier": "@svml/generation",@@ -217,7 +223,8 @@"name": "@svml/generation","version": "0.0.0-dev"},- "facetsDigest": "sha256:fcba65cbdbe1bf8e3df2df7bd96004b98241a2cc577d5e836b1f9640c6204918"+ "facetsDigest": "sha256:7866bcd3cbe7443a581565a4df4b79dec8d5739c29960711657fe77ec97197b6",+ "closureDigest": "sha256:417b253050509e404efda19abe91073ffc8581ed7f900d9df8360e9f0e35c257"},{"specifier": "@svml/hyperframes",@@ -225,7 +232,8 @@"name": "@svml/hyperframes","version": "0.0.0-dev"},- "facetsDigest": "sha256:7ad54eba232aa29e5c7475d798fdfc19f51ae72c0fc49171df84b63cbe0921d5"+ "facetsDigest": "sha256:26523187df5ae9458b0ab8796919fcfb7a596922c0ad594222ff50d463f2c98d",+ "closureDigest": "sha256:c8f8c62fb8d94e2d6086bab1a39858396ed67a236a6fcafcad8eb9fe3c9355eb"},{"specifier": "@svml/hyperframes-render",@@ -233,7 +241,8 @@"name": "@svml/hyperframes-render","version": "0.0.0-dev"},- "facetsDigest": "sha256:7ca59aba36e096f1a088ae4510d59d27ec083295ac08d224eae8bc51e51b5af3"+ "facetsDigest": "sha256:583b662f225a6c900b1b31ea8005e0ad99fbb78c27dd7cb3d708376c9aae06c6",+ "closureDigest": "sha256:2dd184588bb46c6700ec7dd3f4a0d4a6501f2be4d1022d9ea9d0a48d20db33f3"},{"specifier": "@svml/media",@@ -241,7 +250,8 @@"name": "@svml/media","version": "0.0.0-dev"},- "facetsDigest": "sha256:c2b1e3c1fee0315dada7ad9bcc806cd52eb152ef3efd3aca0313c16944e156ad"+ "facetsDigest": "sha256:fc960a6c4d070aee2cb86c7a677c6f00e1938f14c76cdcb0b4a574bfe8ac2aaa",+ "closureDigest": "sha256:5a88335ee71073b5385efca087a523cc5bef1fb8734543ca6bf93c644d60cd64"},{"specifier": "@svml/media-pipeline",@@ -249,7 +259,8 @@"name": "@svml/media-pipeline","version": "0.0.0-dev"},- "facetsDigest": "sha256:b44c81fb191daf1578cf0ba32272b2f7ec8228bb102e8150aebe5851a88e233d"+ "facetsDigest": "sha256:43e8355a979de13d6e192d79978782661bb487fe1ac0e3df42acb442fb519896",+ "closureDigest": "sha256:35b9b8ee38fca121a270aabff9043baf95102c936867e2c996d6ba44a83591c1"},{"specifier": "@svml/prompt-kit",@@ -257,7 +268,8 @@"name": "@svml/prompt-kit","version": "0.0.0-dev"},- "facetsDigest": "sha256:426de83b2e174b73026913781e661e57a6b25120898ef34b327f5dd87db99e5e"+ "facetsDigest": "sha256:7d1ed168ac2235280255d44640b877da5c6be3019355c7d1e3e2a554365c1c18",+ "closureDigest": "sha256:37dea3ca13f002565e0d3a794c8c888f1c1d21a5a4a686ee33414a17572905bf"},{"specifier": "@svml/run-text",@@ -265,7 +277,8 @@"name": "@svml/run-text","version": "0.0.0-dev"},- "facetsDigest": "sha256:b3ef99ff47151f27a7601586667fff693724bbe50d45b30317da827997d6a6b4"+ "facetsDigest": "sha256:b3ef99ff47151f27a7601586667fff693724bbe50d45b30317da827997d6a6b4",+ "closureDigest": "sha256:32b0798f74a970493da1e811c85eb95d1c82e4b0824a914c3f2c3d7d4820fb1b"},{"specifier": "@svml/script",@@ -273,7 +286,8 @@"name": "@svml/script","version": "0.0.0-dev"},- "facetsDigest": "sha256:e7d80b9059cae0881ee29bfa6e18f96b445c43227ae665b93196aa4eeaeb1f21"+ "facetsDigest": "sha256:6f2278fc4077d7ea2354aa053f509c088344e9ca45141ff67e8695dbb03e8d5e",+ "closureDigest": "sha256:5402b7e2d2673d77d68861080e7c404c16bb0bb3755988478199f80af602a81a"},{"specifier": "@svml/seedance",@@ -281,7 +295,8 @@"name": "@svml/seedance","version": "0.0.0-dev"},- "facetsDigest": "sha256:99a965be70300fe85f53e9cd660efe1a99ce390061f7f1f759e2892ce8965f30"+ "facetsDigest": "sha256:6d4fb9a090fd5c420040ea8ff85016d9871a22179f52fdf22e72753ef28ba3e7",+ "closureDigest": "sha256:fcf996eeb148435f0696e1088f7491057a859b16b39e6c79429b387a142be63c"},{"specifier": "@svml/seedance-speaker",@@ -289,7 +304,8 @@"name": "@svml/seedance-speaker","version": "0.0.0-dev"},- "facetsDigest": "sha256:776b0b7aa7dc312eda8566d05f2db7c8b3c25ced8f8dd9181c89940cb90762db"+ "facetsDigest": "sha256:b5a6a66863cb54377bfb13004364582b39bf7b602a64ef9daff1d78c8d8fda0b",+ "closureDigest": "sha256:4aaf216143986461dc76424fd6072806abb8d0c6b1e5648e33f09c87de993d03"},{"specifier": "@svml/speech-align",@@ -297,7 +313,8 @@"name": "@svml/speech-align","version": "0.0.0-dev"},- "facetsDigest": "sha256:5a9a50527fb24cb04c3ddef171b180591522a6ac47d8c186ffb74edf9f3dbe55"+ "facetsDigest": "sha256:59e86a0a789c47b0698797cf2cb4ecd4bf95c78cbff7bd89bc029c9515f3ae73",+ "closureDigest": "sha256:bbef092660ea05599a3373271cf0c78663cfab80259c5a3038495d12978d0f52"},{"specifier": "@svml/speech-program",@@ -305,7 +322,8 @@"name": "@svml/speech-program","version": "0.0.0-dev"},- "facetsDigest": "sha256:35fbb339defcbbdf7cd0a117ec6fef71e2b348e750a0448c8fe58a4fe1798c68"+ "facetsDigest": "sha256:1831df9cadb0f843e91f52a9c0a04a8d2e93b7feb9bc537d3aade5e87ca48fa2",+ "closureDigest": "sha256:d6fc5959442c60b91b39f2797edcd6a9463ac6d65dcf7cd3da6e205ad85f887e"},{"specifier": "@svml/speech-take",@@ -313,7 +331,8 @@"name": "@svml/speech-take","version": "0.0.0-dev"},- "facetsDigest": "sha256:58dbc3fe7e419e563bbcdbdd6101c2857fe1e00d1992b2d3cf915803203fca02"+ "facetsDigest": "sha256:a6022935001b262190151d389c83fe5514490a3c4deca99fa1988ca388695e30",+ "closureDigest": "sha256:01f8f9b843e1e3203d14daf5239ad7c6a1187d3cc2426a0c17734b5f1a518aa7"},{"specifier": "@svml/svs",@@ -321,7 +340,8 @@"name": "@svml/svs","version": "0.0.0-dev"},- "facetsDigest": "sha256:40b91f0e3bbaae42fb7bccacb28f49f44a2be37b0506292c49ed98f842371ebe"+ "facetsDigest": "sha256:40b91f0e3bbaae42fb7bccacb28f49f44a2be37b0506292c49ed98f842371ebe",+ "closureDigest": "sha256:ac11397e8eab51d2a44c5d35651943850893571311c7c47ba9251cf1fdf50351"},{"specifier": "@svml/whisperx",@@ -329,8 +349,9 @@"name": "@svml/whisperx","version": "0.0.0-dev"},- "facetsDigest": "sha256:8cfd95fd8932a7159a6a1b82a73ad3858aa5e3a99d96e6a793d3c7d02c235b9d"+ "facetsDigest": "sha256:ed95bc93f9d122d1f0c5c5207ec72920ad1a60927b43131e5b5d34124712349f",+ "closureDigest": "sha256:6af6fab9c184eb29acf8993a98a46fe3e2e6c79809172067ad5794054df9bf16"}],- "digest": "sha256:ffb477f7b19d975c09197db11e7b3c7952f643544d84ba2bcd1400859fac037d"+ "digest": "sha256:0e274098626c5f9b5e996996842b631ca9bd71f21239f8f5fa66b72f408ee76e"}diff --git a/examples/echo-pro-aroll/svml.runtime-packages.lock b/examples/echo-pro-aroll/svml.runtime-packages.locknew file mode 100644index 00000000..8599a17f--- /dev/null+++ b/examples/echo-pro-aroll/svml.runtime-packages.lock@@ -0,0 +1,898 @@+{+ "format": "svml.node-package-lock@1",+ "artifacts": [+ {+ "name": "@esbuild/darwin-arm64",+ "version": "0.25.12",+ "digest": "sha256:db9d414d5c92d188d53dd0e100d3e104543f4b272037beb258edc2ead0d28998"+ },+ {+ "name": "@google/genai",+ "version": "1.52.0",+ "digest": "sha256:ccae11f511dd32659ff165bb7f1086574ec919e45b4a72df1756c3464e3f8050"+ },+ {+ "name": "@hono/node-server",+ "version": "2.0.12",+ "digest": "sha256:87fdbb42f820648585a5837efaaeb60ec591224edec033de67a13f2b28eb63eb"+ },+ {+ "name": "@img/colour",+ "version": "1.1.0",+ "digest": "sha256:87ff399e23a6a25336858a0dbd64f7b83720c5e801e05b4c6309af6d12521c45"+ },+ {+ "name": "@isaacs/fs-minipass",+ "version": "4.0.1",+ "digest": "sha256:9004aaba5f83bb21b33ede79ad6420cef93105d4e7347622c2bf778407152b88"+ },+ {+ "name": "@protobufjs/aspromise",+ "version": "1.1.2",+ "digest": "sha256:b26d2da7a85f408d36a1e5cf7653f1b315c7f86e24a94a7ca90adfce78a52259"+ },+ {+ "name": "@protobufjs/base64",+ "version": "1.1.2",+ "digest": "sha256:03d093e51f450fc70ab0d38e5feb3ff3009db4caa1400aa89f77312be60dbd4e"+ },+ {+ "name": "@protobufjs/codegen",+ "version": "2.0.5",+ "digest": "sha256:a51d648a01c9e4b1ce86aeaa7b3580d6736872d85ca2708a265a7a3d5db60e47"+ },+ {+ "name": "@protobufjs/eventemitter",+ "version": "1.1.1",+ "digest": "sha256:9b70b7b43a6dc11270198eddb75e741ffa22aa6ae1e907480d3fb923956d44b6"+ },+ {+ "name": "@protobufjs/fetch",+ "version": "1.1.1",+ "digest": "sha256:9b4fa3a53ebb883c1d711aab0196745351c385eac35dd57aa5e8d943edc621ed"+ },+ {+ "name": "@protobufjs/float",+ "version": "1.0.2",+ "digest": "sha256:6ed05c3181c9ea4a8516b3561541a7b7d32cd6e8e7746fbaadf0aee3ead9804e"+ },+ {+ "name": "@protobufjs/path",+ "version": "1.1.2",+ "digest": "sha256:c90aff98ba0fefc2e509a3e31f87bd8c0d300b5321613281a569a97d336217db"+ },+ {+ "name": "@protobufjs/pool",+ "version": "1.1.0",+ "digest": "sha256:898bf407a5251b1fcacc5ba59d491b465249dcbe985b30b907d6a8efe929e015"+ },+ {+ "name": "@protobufjs/utf8",+ "version": "1.1.2",+ "digest": "sha256:8a0bcf97df0a7807dc0ad71e46fb349b11d3f7f6fbb5d9e4d8227a7361c43fbb"+ },+ {+ "name": "@puppeteer/browsers",+ "version": "3.0.6",+ "digest": "sha256:1fc1212e7cf17104bd0e45e8e63c90b984df83e9a2b11ef8104b162bb140893f"+ },+ {+ "name": "@svml/artifact",+ "version": "0.0.0-dev",+ "digest": "sha256:368270c5c19f9300599a4a1ee9f7525f39b1e3e2c036bf0b03317fa2dc32a303"+ },+ {+ "name": "@svml/caption-gemini",+ "version": "0.0.0-dev",+ "digest": "sha256:9627669c488f9df22fef6a27f74d2bf5d499e3a0ba651eb594a9b47fe82cd21f"+ },+ {+ "name": "@svml/caption",+ "version": "0.0.0-dev",+ "digest": "sha256:a7f225fee5e57574f3f0d874a3ebaaca896126bee9a1ba420a022b560aaffc53"+ },+ {+ "name": "@svml/component-kit",+ "version": "0.0.0-dev",+ "digest": "sha256:789d38bf44d7d40cf13734e09f68c8fd8302807fcd9b20a9ef0439f488af1ae2"+ },+ {+ "name": "@svml/contracts",+ "version": "0.0.0-dev",+ "digest": "sha256:b3a9eea0f89a6c0a5920fb055f919a123c9a45b268b31f029e466415565059d3"+ },+ {+ "name": "@svml/core",+ "version": "0.0.0-dev",+ "digest": "sha256:7b8af092e472c43f2b990d92cd7f0b0d426e19f4003582f50ca7aaefd3ec6007"+ },+ {+ "name": "@svml/elaborator",+ "version": "0.0.0-dev",+ "digest": "sha256:d5987b778a5bc3c4b2f734140bb8fd520f5abcb86ce85391464643d59c45f78a"+ },+ {+ "name": "@svml/endpoint-kit",+ "version": "0.0.0-dev",+ "digest": "sha256:49ba39c758614bba5c473601cbc0d36b7d38e823031b2d3dfdd76f95c6b6702e"+ },+ {+ "name": "@svml/gemini-omni",+ "version": "0.0.0-dev",+ "digest": "sha256:d50e807fac4ebb56d157a871d714d7c1ed33b0825fef9b2612782c4c8d7de81c"+ },+ {+ "name": "@svml/generation",+ "version": "0.0.0-dev",+ "digest": "sha256:7cbe6e3c8db1bbe3c084bbdac82fe672908f3f8ec7f1585de28349d8711e1843"+ },+ {+ "name": "@svml/gpt-image",+ "version": "0.0.0-dev",+ "digest": "sha256:5df4a843ea5421cd32368e1e3c3874d02245efa3d9b46e261b90a267059db5a6"+ },+ {+ "name": "@svml/grok-imagine",+ "version": "0.0.0-dev",+ "digest": "sha256:88113fd6ee317e00a191129c0e44b1c9c08637859a25e01bc4020546b9e7a306"+ },+ {+ "name": "@svml/host",+ "version": "0.0.0-dev",+ "digest": "sha256:a59a3ac2647bebd223b6ebb4d2830a1c86a19d427d49095ae3479de79519f815"+ },+ {+ "name": "@svml/hyperframes-render",+ "version": "0.0.0-dev",+ "digest": "sha256:6f0dcd08108987e1dd9a5701ee5d2f21d42c4559def713539f3103a19b4d5d3b"+ },+ {+ "name": "@svml/hyperframes",+ "version": "0.0.0-dev",+ "digest": "sha256:c121a31f96d6e5c3205040c58a3a5b03d52ceb31ba584975df2d9b8ceb720ebb"+ },+ {+ "name": "@svml/media-pipeline",+ "version": "0.0.0-dev",+ "digest": "sha256:4bea3929ab3efabda5748ba897bd597bcfd571ce25459cb387630dfa2a23110a"+ },+ {+ "name": "@svml/minimax-h3",+ "version": "0.0.0-dev",+ "digest": "sha256:aebb4ccc3d376f5f766dea05132eb30c7bb9dbf71224bfcea1c5d2d53a5293c1"+ },+ {+ "name": "@svml/model-kit",+ "version": "0.0.0-dev",+ "digest": "sha256:51c71bac3365c6811b27d0aa345b63ff64cee26047bd33b524ad6aa969cc02de"+ },+ {+ "name": "@svml/nano-banana",+ "version": "0.0.0-dev",+ "digest": "sha256:0f7de960105c3889ba5a53be86eb0cc9e2c18ab7d8f7047250fd903752f4c0c0"+ },+ {+ "name": "@svml/protocol",+ "version": "0.0.0-dev",+ "digest": "sha256:cdede72e3612684f37302267a757cdfde7cd7d474c671e738969b10268e2e7fe"+ },+ {+ "name": "@svml/provider-google-vertex",+ "version": "0.0.0-dev",+ "digest": "sha256:7084e3278a7a9c987f8c7c58ffabdaa2c908d2a42af2de5d31b590a19a1dbf94"+ },+ {+ "name": "@svml/provider-hyperframes-local",+ "version": "0.0.0-dev",+ "digest": "sha256:f94e3d0e32fe4b43d4e72ddf1a1f3233fc8a470004c0589b7eb7c3b4bac3bbc5"+ },+ {+ "name": "@svml/provider-kie",+ "version": "0.0.0-dev",+ "digest": "sha256:ca7a6cc1ab96011c68ec20d82847e7bb92287735a34c3110181430db34e35035"+ },+ {+ "name": "@svml/provider-media-local",+ "version": "0.0.0-dev",+ "digest": "sha256:8b25af7a32644b6a5c1d168ab487e18ba5f97dc9b148887aac289fc83e5b9242"+ },+ {+ "name": "@svml/provider-whisperx-local",+ "version": "0.0.0-dev",+ "digest": "sha256:fc69b1beb7c726ad93a337365c7e7106c6e23752021118d05fcdf4f9b845285b"+ },+ {+ "name": "@svml/runtime-adapter-node",+ "version": "0.0.0-dev",+ "digest": "sha256:a298036b5c46dd8e2bb4c76db9c9e024e8e8738f0e442176dd36d63a9b24aced"+ },+ {+ "name": "@svml/runtime-adapter",+ "version": "0.0.0-dev",+ "digest": "sha256:d900d18ab1fd68d4b6a1ddcfb84f3c1323092346e6d056fbd67a4ea48cd53c45"+ },+ {+ "name": "@svml/runtime",+ "version": "0.0.0-dev",+ "digest": "sha256:e1c9c6e856d69f3a5a00bda85064a8934320a4f7cfc4d7c962f56eb9d18905ff"+ },+ {+ "name": "@svml/seedance",+ "version": "0.0.0-dev",+ "digest": "sha256:495f6a66fecf255ee806c79c37c0c093be3ea3449c7d8bc57e6808b4823cb528"+ },+ {+ "name": "@svml/seedream",+ "version": "0.0.0-dev",+ "digest": "sha256:5c50cd0e4d015c669f1d398dd46d65cf8eb9f4fcc511f14b7083e55f57446a54"+ },+ {+ "name": "@svml/source",+ "version": "0.0.0-dev",+ "digest": "sha256:2ab24d6e0a392e602f99573166ce3d48a8c561fa55f9ee425a25361077b8c483"+ },+ {+ "name": "@svml/speech-align",+ "version": "0.0.0-dev",+ "digest": "sha256:1ae65828af4e46e1e8b4065c28451ee08109fe5e5d58e60e457ff0a610c02d90"+ },+ {+ "name": "@svml/svs",+ "version": "0.0.0-dev",+ "digest": "sha256:a336db7f075cab5357a96ba0d3b079c213c93fa0a4f95c39926c2e1b784d3d24"+ },+ {+ "name": "@svml/text",+ "version": "0.0.0-dev",+ "digest": "sha256:03985ce5c8bf04fc8dcfc474b4b80133a5bffbb6965604bdc0f9f8fb64ad0524"+ },+ {+ "name": "@svml/validation",+ "version": "0.0.0-dev",+ "digest": "sha256:4322dffd7ea245484a12fb674a0d2f70f25d1287b9f7aa67ed5714431035e9dd"+ },+ {+ "name": "@svml/whisperx",+ "version": "0.0.0-dev",+ "digest": "sha256:9047e6ed3c9d88dcce16f05d273eb2295692e274b68b6d7ea1835031ef55bebf"+ },+ {+ "name": "@swc/helpers",+ "version": "0.5.23",+ "digest": "sha256:214421c9be182a986122710fe7e3a3f6f435a9972eb5ea6c172faaafb73b2d66"+ },+ {+ "name": "@types/node",+ "version": "24.10.1",+ "digest": "sha256:6a669a3423310fae21be2be89f593626f2c9c78a0e0262c13224599953bc4cd7"+ },+ {+ "name": "@types/retry",+ "version": "0.12.0",+ "digest": "sha256:941f2577dd499b89987ea6f2d1d3d9b5f0e34527a9357f551681d6ff3520e2ec"+ },+ {+ "name": "adm-zip",+ "version": "0.6.0",+ "digest": "sha256:13cb7236751a108755ee3e5305ea44c69c78d0c9605ace0f072ac0c536f37f97"+ },+ {+ "name": "agent-base",+ "version": "7.1.4",+ "digest": "sha256:40ec8d2a7b552e0874da733e43ef2cb08353bed9895af6b45e036818dcb4e40c"+ },+ {+ "name": "ansi-regex",+ "version": "6.2.2",+ "digest": "sha256:62301d8f03e735d1d229572aa95ad59bcdee77e489a38a73fc8e4401fdd7cc7e"+ },+ {+ "name": "ansi-styles",+ "version": "6.2.3",+ "digest": "sha256:0dc17a9cb94edba0e52788414fc0ba0e21d8fdbfec928a114be1a94e69abbd59"+ },+ {+ "name": "base64-js",+ "version": "1.5.1",+ "digest": "sha256:4984816098020b94228c9a7946ea80ab4795078d5de3d484e818baa246f77f79"+ },+ {+ "name": "bignumber.js",+ "version": "9.3.1",+ "digest": "sha256:32e6ecaf68aa121da8203fe69aa7e0096de221a0de5fd2bcfbb3de891d675503"+ },+ {+ "name": "boolean",+ "version": "3.2.0",+ "digest": "sha256:36e3dbee991cf3a736740c6a3eaf5d49b85b3e40fe8113a1b763741788616e6f"+ },+ {+ "name": "brotli",+ "version": "1.3.3",+ "digest": "sha256:0ffd76410e1b12c33d8d464b5df349ddb2e2e1de062cda48901824448a84104c"+ },+ {+ "name": "buffer-equal-constant-time",+ "version": "1.0.1",+ "digest": "sha256:7f7ae10c48a0ccc45a8375101ba92708aab7129c66d1918309ed37cea429d0fd"+ },+ {+ "name": "bundle-name",+ "version": "4.1.0",+ "digest": "sha256:eb752be0b969cbebab06b6bb9f46976b6e0032173aefdc179687ebccaa44f94b"+ },+ {+ "name": "chownr",+ "version": "3.0.0",+ "digest": "sha256:7b88dbf0df1f298d83c0849c84aeefc5a396d54ca1fc01a28f244f8c1be025af"+ },+ {+ "name": "chromium-bidi",+ "version": "17.0.2",+ "digest": "sha256:ec8999a0a291d02fe51b7121eb971a35f1e3a1fd2a2d1324629c96f9a75b20a8"+ },+ {+ "name": "citty",+ "version": "0.2.2",+ "digest": "sha256:25a8b490b976cb9292d67c47be01866caa98425a4e33d70ac258db9743a88df6"+ },+ {+ "name": "cliui",+ "version": "9.0.1",+ "digest": "sha256:da1fca6a22fbf931ced1655f040e2b3076adf433e2150dbb5071a69c33e70ba9"+ },+ {+ "name": "clone",+ "version": "2.1.2",+ "digest": "sha256:282ee2f216faaed203b56bd9cfd4da5a18605fe65810757d2a9ea5ecd9500125"+ },+ {+ "name": "compare-versions",+ "version": "6.1.1",+ "digest": "sha256:66cedeff9e100ea3d24eedbf263b076e6baa3c499e4651994fff66f1dea5877e"+ },+ {+ "name": "data-uri-to-buffer",+ "version": "4.0.1",+ "digest": "sha256:0dc22fd9c89bd8380616b2ee17155470f8783b41ba89789b075dc4ba484080df"+ },+ {+ "name": "debug",+ "version": "4.4.3",+ "digest": "sha256:1a7cc10a8613e2472b802c38eaf47c489bd798e9ce0f412184f695107c3fa3a0"+ },+ {+ "name": "default-browser-id",+ "version": "5.0.1",+ "digest": "sha256:b4bdd210d24cb1f62b83c77ae731ab1da073e45245baad0de1d6f5f02c9d466e"+ },+ {+ "name": "default-browser",+ "version": "5.5.0",+ "digest": "sha256:d81632b25bc8f83bb1a14add53d9fb0ee271842b09569169dcef10b92e9a2fa5"+ },+ {+ "name": "define-data-property",+ "version": "1.1.4",+ "digest": "sha256:221f75bd851a964e7942385ada443570929f69196d6c784630639984385fc5ad"+ },+ {+ "name": "define-lazy-prop",+ "version": "3.0.0",+ "digest": "sha256:c3dd5983fde9b61f7808753874e319d0e05f91adf5a55b95c599413a4cf86f93"+ },+ {+ "name": "define-properties",+ "version": "1.2.1",+ "digest": "sha256:eedbb9184b6426f20f1442ed7a62a98015182bffa41bba4fa4dba63471ba7417"+ },+ {+ "name": "detect-libc",+ "version": "2.1.2",+ "digest": "sha256:39e893aa920fb3a1af7ab5e2fac8d037485d6e43a28acc27097e0ddc44977388"+ },+ {+ "name": "detect-node",+ "version": "2.1.0",+ "digest": "sha256:996c11b800375bcbe83c7e3fef5bf22d1a968b70084d044f056d54a2b6d5378c"+ },+ {+ "name": "devtools-protocol",+ "version": "0.0.1653615",+ "digest": "sha256:1378e3705558176026ae9eb2d219ab359032f2a5d5bddeafa530cbe8bc14a7df"+ },+ {+ "name": "dfa",+ "version": "1.2.0",+ "digest": "sha256:9e6dd4727a3c3b8ba07bd03137d6f98ef7103486608131967b45d863b438bd1a"+ },+ {+ "name": "ecdsa-sig-formatter",+ "version": "1.0.11",+ "digest": "sha256:c0abf8e5fedfdc933291df29898bb186dd642cc997b37cfbb8b44f63f65a2574"+ },+ {+ "name": "emoji-regex",+ "version": "10.6.0",+ "digest": "sha256:eb9d30ffe6019e2863afc186ae442367b68e72d4324119953136cc052a8a853d"+ },+ {+ "name": "es-define-property",+ "version": "1.0.1",+ "digest": "sha256:4f1993238f7a037bd0efcc84bd55b144be286b0d5093f9d1d9ba6bd923e8b23b"+ },+ {+ "name": "es-errors",+ "version": "1.3.0",+ "digest": "sha256:0aace4cb4e9b4c30867fcf2ab951b5ba67e74bf0d9ae01e1af44997b88100b0d"+ },+ {+ "name": "es6-error",+ "version": "4.1.1",+ "digest": "sha256:018f98c8351e95bbd0673def8b129d81140abb73bc15d4aff0da457352b19611"+ },+ {+ "name": "esbuild",+ "version": "0.25.12",+ "digest": "sha256:d45f05635279ab74b586ef526256666bf06353c35733ba7265669098f7b0f221"+ },+ {+ "name": "escalade",+ "version": "3.2.0",+ "digest": "sha256:b90bb70c6aefd3efa34f4b7cbabe08ddc3685453fa7de431d8f239e61f14949f"+ },+ {+ "name": "escape-string-regexp",+ "version": "4.0.0",+ "digest": "sha256:cf7484214bba7d92b7520e80e260071e172ccb2bc5980dc546874f9fee41c41c"+ },+ {+ "name": "extend",+ "version": "3.0.2",+ "digest": "sha256:4a27fbfbe686002e72b43f558129c99bb8033c46d34d5ed3ce65579818b120aa"+ },+ {+ "name": "fast-deep-equal",+ "version": "3.1.3",+ "digest": "sha256:a9b29965b98994618171ac2981b88f385f2299bbfc0c3831c5cd259aa8ca999c"+ },+ {+ "name": "fetch-blob",+ "version": "3.2.0",+ "digest": "sha256:c99727d97c6d1d689a0927c8366aa3236fac687f1b32b5a4a6fb50f1a9475ca1"+ },+ {+ "name": "fontkit",+ "version": "2.0.4",+ "digest": "sha256:b600e103edaad329a12b5f391be8e51208493460317dd49ba162a807c854b63f"+ },+ {+ "name": "formdata-polyfill",+ "version": "4.0.10",+ "digest": "sha256:f00e63dcfc33f8409f8dac1c27ce16668955a9649c0cd9660eafbd5133b094f3"+ },+ {+ "name": "gaxios",+ "version": "7.3.0",+ "digest": "sha256:d02991d60ba0d7190905094252a65eea21fc14e3d6d80a263d3640f9b3120c9b"+ },+ {+ "name": "gcp-metadata",+ "version": "8.1.2",+ "digest": "sha256:e5cea6539cb0339595392f03548e2a6550fe494a8b37abd647045cb574b498b3"+ },+ {+ "name": "get-caller-file",+ "version": "2.0.5",+ "digest": "sha256:6941f3900745f48cec5e064bce86d053920ff1bcc26f67847aeaa4466218dc25"+ },+ {+ "name": "get-east-asian-width",+ "version": "1.6.0",+ "digest": "sha256:48e7876000807ad55fa5b5a3d8fdd49b1f56ec6e321532a674b6c33646bcad81"+ },+ {+ "name": "giget",+ "version": "3.3.1",+ "digest": "sha256:ceaa8a1b7b1c1d30bc6d1b90929808c92ada2ec01883bb47f6d6c9bce7322073"+ },+ {+ "name": "global-agent",+ "version": "3.0.0",+ "digest": "sha256:43eb33eb0f491ad69fe8ed6cb589b13d5722292c6ed9119c887ddb030e2b47f3"+ },+ {+ "name": "globalthis",+ "version": "1.0.4",+ "digest": "sha256:e469a050f10ae6e41c118f1e9f948265f5d85fee6e53c141836ec9815cf14324"+ },+ {+ "name": "google-auth-library",+ "version": "10.9.1",+ "digest": "sha256:f693bc5dfb6daa4f3c10f067794a1561b281497b0bb60635b0c915d86e4daa9a"+ },+ {+ "name": "google-logging-utils",+ "version": "1.1.3",+ "digest": "sha256:d9972e61745d9340c9a7268e380b0799e2bfcadc65c650d94c3c0c7cab4b7701"+ },+ {+ "name": "gopd",+ "version": "1.2.0",+ "digest": "sha256:84538a63b1ad06917107969f8f5a7614a69810d5d8deb9ec1ecbc0f7c7d5ca38"+ },+ {+ "name": "has-property-descriptors",+ "version": "1.0.2",+ "digest": "sha256:30760526550c3bf973432235801143320cc22f41e02b79083c765636c72400f6"+ },+ {+ "name": "hono",+ "version": "4.12.32",+ "digest": "sha256:0ef54794c02fe4aaec727b7e44836dfaf91c58c375ff768c846d774e93c4eba8"+ },+ {+ "name": "https-proxy-agent",+ "version": "7.0.6",+ "digest": "sha256:1b462b0f25b3cee2a682b3bbe1b23fe75e52cce450c4648bb234ff4dd3af2408"+ },+ {+ "name": "hyperframes",+ "version": "0.7.84",+ "digest": "sha256:d61bdd821dc513adcddeb339559f6a165ab7a0e8702ace8e97b6494f51d92b6e"+ },+ {+ "name": "ignore",+ "version": "5.3.2",+ "digest": "sha256:d0aaa6cad4117a885aed4794fe66735498437f1c878dbf2ef66ef1ab1c2a660b"+ },+ {+ "name": "is-docker",+ "version": "3.0.0",+ "digest": "sha256:97eb5b5b8156bd00c384fb9fb307a45910aecf095dd6184f111d4b8e0bd666f7"+ },+ {+ "name": "is-inside-container",+ "version": "1.0.0",+ "digest": "sha256:08f265e1b3b219c2952c5b859210a3713bade08013c5b27f96ad36661988342f"+ },+ {+ "name": "is-wsl",+ "version": "3.1.1",+ "digest": "sha256:86436e3a243b5f8271667ea3d022de5c1600ac3cb7d8b2d34668ffa9df3d0ecb"+ },+ {+ "name": "json-bigint",+ "version": "1.0.0",+ "digest": "sha256:c274e017d82fbbbf324909b464ea5442142bb962df9dc6f71ab13ef8e163c491"+ },+ {+ "name": "json-stringify-safe",+ "version": "5.0.1",+ "digest": "sha256:d1db83cd2e4b320c31d6ef03ebf7f325af566a6131016b350b4fbbd3fff12fec"+ },+ {+ "name": "jwa",+ "version": "2.0.1",+ "digest": "sha256:ac936dbe43949b68ffae751c977fef81fd45bb030ce84f0757b921bd7b1d7b0e"+ },+ {+ "name": "jws",+ "version": "4.0.1",+ "digest": "sha256:542221db2029af0e55aa1eed9d420843756437acfa8a97534c5f4c96d6f1306f"+ },+ {+ "name": "long",+ "version": "5.3.2",+ "digest": "sha256:da45a5f60cb1e4dc5384f5c168cd8849944eff998463390386d6459fe10e5aba"+ },+ {+ "name": "matcher",+ "version": "3.0.0",+ "digest": "sha256:9912f19359607c866d9f618d168c50f3b0833a254d2e985eba691fd6bf0e6fbd"+ },+ {+ "name": "minipass",+ "version": "7.1.3",+ "digest": "sha256:f59781ced29dbfc5853800d2d200e7fae7f76bb23c6ea9e1976104000d9dd87f"+ },+ {+ "name": "minizlib",+ "version": "3.1.0",+ "digest": "sha256:8b215413f5f55261d07815e90335340aabd1c48bee5f1b2b20eadbb35541d6e2"+ },+ {+ "name": "mitt",+ "version": "3.0.1",+ "digest": "sha256:f05aee474033331f89fb4e3834c2ee96574fa107232539fa61135a16fe788c9b"+ },+ {+ "name": "modern-tar",+ "version": "0.7.7",+ "digest": "sha256:f99563f38a7ba7212a3ad5592a6967bf69a086457d0321d289c466ab5f6688aa"+ },+ {+ "name": "ms",+ "version": "2.1.3",+ "digest": "sha256:51788e2027fa4e83998d090b3784acc85ccb83543a250426e757b7ac4fd9f3c3"+ },+ {+ "name": "nanoid",+ "version": "3.3.16",+ "digest": "sha256:78922068150a563f9ae6689fe393acd229b74e661a92d5a4a98e1f4e0bd67712"+ },+ {+ "name": "node-domexception",+ "version": "1.0.0",+ "digest": "sha256:aca17999c243a93f48bdba070cb2ac2d0ab8d24c297dfdecb0183556ce8a7b45"+ },+ {+ "name": "node-fetch",+ "version": "3.3.2",+ "digest": "sha256:7d33e270006e72c9480c0d4fe42c78308ee40927929c8673b1f0668ff5a6f7a6"+ },+ {+ "name": "object-keys",+ "version": "1.1.1",+ "digest": "sha256:7a85215ee04e41d0cc498beb263ef7a2f07b15c18983cb520e49e51c38b9dd3c"+ },+ {+ "name": "onnxruntime-common",+ "version": "1.21.1",+ "digest": "sha256:c230c9b0663d360829c4b0ee3499a0282b5fc7c47f382a5003d2119954bea3c2"+ },+ {+ "name": "onnxruntime-node",+ "version": "1.21.1",+ "digest": "sha256:91cbee2cc2ba08b97fea94cc191c025ad9bbe0fdcc5f71f94e0c99ab6b611387"+ },+ {+ "name": "open",+ "version": "10.2.0",+ "digest": "sha256:97cd19c76498bd518d4ee951b0692ba49b5a3371fac07db619538b35797afa57"+ },+ {+ "name": "p-retry",+ "version": "4.6.2",+ "digest": "sha256:1cc6fd01ff96d9710043c74f822a86ea35c9645cf84123cbb716d96298ac6cdc"+ },+ {+ "name": "pako",+ "version": "0.2.9",+ "digest": "sha256:9a4c993683c0c9b1aa01669a2154bac931eecc0f194064f6b5504560ac5e0d55"+ },+ {+ "name": "picocolors",+ "version": "1.1.1",+ "digest": "sha256:be79e912ac3251b3baada9dd6510c98f59bb9d8d0ef70366aba9c760a92e1584"+ },+ {+ "name": "postcss",+ "version": "8.5.25",+ "digest": "sha256:a2996a4d94a0f4d48217455b5a56c5c255a127bb0f7acbb5c61b0d45529340c2"+ },+ {+ "name": "prettier",+ "version": "3.9.6",+ "digest": "sha256:e9878409caf16dffcdb6f3547433bcb9659cca36809e9a82384c726250c3d28d"+ },+ {+ "name": "protobufjs",+ "version": "7.6.5",+ "digest": "sha256:407aa02e41f2a2b955161421650589ee8fa3c12a8c99cd311538c9ffb6bc62ff"+ },+ {+ "name": "puppeteer-core",+ "version": "25.4.0",+ "digest": "sha256:05bbe4cff28c147c6f78aa83edfd1180321d4734ec4180077ab4ac5f8e8c031e"+ },+ {+ "name": "restructure",+ "version": "3.0.2",+ "digest": "sha256:697be69079ad312005d5f42a1eb8d8e90fc0fd4721ecece8cd6089f5b0cee68d"+ },+ {+ "name": "retry",+ "version": "0.13.1",+ "digest": "sha256:7dd16334cc998c2e292625c3db61a03f47d9c35fb1a0217cb5380541b1e59f0e"+ },+ {+ "name": "roarr",+ "version": "2.15.4",+ "digest": "sha256:84e973663fbcd064f7546e5b39ac50017c3435f1186c3fc0ca3e3957f7d8642d"+ },+ {+ "name": "run-applescript",+ "version": "7.1.0",+ "digest": "sha256:502309607976bcc8530d116d33d3d61a5bede9d8b1b4f6f81d88d1b76cc5b95c"+ },+ {+ "name": "safe-buffer",+ "version": "5.2.1",+ "digest": "sha256:57d787833c2ccd7b189cf242bac30e4e3be2ab597559d8113276aade4a860ac3"+ },+ {+ "name": "semver-compare",+ "version": "1.0.0",+ "digest": "sha256:fc913ea3bc4d170b92adfc1e71b75139dd3ff9f39ca46c6e5356b37d6c1f32b5"+ },+ {+ "name": "semver",+ "version": "7.8.5",+ "digest": "sha256:ef73ed8133cddb85ccddd94ef34bb01bb417b4e184747774f30c78c319c84ccc"+ },+ {+ "name": "serialize-error",+ "version": "7.0.1",+ "digest": "sha256:77c0f2fdbcaca5ab782715da3396a6fecb61fda30844daacaeec05d33c2d113e"+ },+ {+ "name": "sharp",+ "version": "0.35.3",+ "digest": "sha256:b943672e75a83d4ce475cfe16c407972840d29dbcc2c9edf8d28511eddd0f996"+ },+ {+ "name": "source-map-js",+ "version": "1.2.1",+ "digest": "sha256:76abd20d0fd81fc684e8b3c0e41177269f09197dea71fa1d50a0364fa280acda"+ },+ {+ "name": "sprintf-js",+ "version": "1.1.3",+ "digest": "sha256:883f379f24694afcb093f47aaafadec3ca1065af1ae652c364a3d7bf25bc9e0c"+ },+ {+ "name": "string-width",+ "version": "7.2.0",+ "digest": "sha256:b85382c244e9fc739740d7bfdca4b539778bf65e713907ea6d3c6d07e4103717"+ },+ {+ "name": "string-width",+ "version": "8.2.2",+ "digest": "sha256:c36ee62911778723e34c511189e61080c218ccb11f4d64b0d6b8d9efb6aa5c10"+ },+ {+ "name": "strip-ansi",+ "version": "7.2.0",+ "digest": "sha256:9bfa39730e152200258d6623078e19aff00644acc6459ecf20aacfc8bc63fa6c"+ },+ {+ "name": "tar",+ "version": "7.5.22",+ "digest": "sha256:8285067e1b8a820fecc8a03b20a9904a288e5d298ba928b4b377edb9b3ef0a41"+ },+ {+ "name": "tiny-inflate",+ "version": "1.0.3",+ "digest": "sha256:fcb3bb3ffe45f8dc5844f3e2c80f06ce91f60866813679d0735de089e09ca233"+ },+ {+ "name": "tslib",+ "version": "2.8.1",+ "digest": "sha256:2db6bb6e55b98eedaeb183f273e1b7fad3c08de082494bf8e8fbc3d4599e8dcb"+ },+ {+ "name": "type-fest",+ "version": "0.13.1",+ "digest": "sha256:31da441957382bff5162a9d6ffdfeb100dce2436a07278ca92743c313d228389"+ },+ {+ "name": "typed-query-selector",+ "version": "2.12.2",+ "digest": "sha256:6aff4c63a83048d09bec7d3702255d5eafbac4a966590f1917c51e7032f69369"+ },+ {+ "name": "undici-types",+ "version": "7.16.0",+ "digest": "sha256:869dec90f6b507a2d71916dbc8d4ef3d75c0dd8d4066548bfbe8d77cc41315bb"+ },+ {+ "name": "unicode-properties",+ "version": "1.4.1",+ "digest": "sha256:a48f8ca2a9a65b41b892be726a9c760d57cef21e60888238744a446727adcf20"+ },+ {+ "name": "unicode-trie",+ "version": "2.0.0",+ "digest": "sha256:0f4491fc7a325bc7399549046667da7c336ad0cf2b5999fcab1650757d2858e4"+ },+ {+ "name": "web-streams-polyfill",+ "version": "3.3.3",+ "digest": "sha256:8cd5924d7a979dfe8364c3261be7293152443167076fa5f170564e6a3222af13"+ },+ {+ "name": "webdriver-bidi-protocol",+ "version": "0.4.2",+ "digest": "sha256:ab82a782e1679affa6248e33acbe4fd1e0651a9eaa9e34d4469a913df64a3ff3"+ },+ {+ "name": "wrap-ansi",+ "version": "9.0.2",+ "digest": "sha256:d2622e49ecb221d551ea0069ffeb684c7c2d4115401d021bfee3e51d89c7eabd"+ },+ {+ "name": "ws",+ "version": "8.21.1",+ "digest": "sha256:484620e51cb5015d111e52294ed54dcfd66ed3284999fc16093a35d58a0af996"+ },+ {+ "name": "wsl-utils",+ "version": "0.1.0",+ "digest": "sha256:b236cc5813fd4493aa17be0792e3b180df65a4ea3907da05dd799bb15804e4fb"+ },+ {+ "name": "y18n",+ "version": "5.0.8",+ "digest": "sha256:54af894eda0fbc193d9e5d289a7af3631dafe2f5fcff4f060e2c9a2c2cb798bf"+ },+ {+ "name": "yallist",+ "version": "5.0.0",+ "digest": "sha256:406bf2ad99d27deda9d73249b4ecacc1bee1a45f33afdf2cd648fe6725207326"+ },+ {+ "name": "yargs-parser",+ "version": "22.0.0",+ "digest": "sha256:ad4401f08168f7c51334eb97b13667bdd3b480c0aa39adc76c3e73e893af82b6"+ },+ {+ "name": "yargs",+ "version": "18.1.0",+ "digest": "sha256:1a9af827f13ab17a8a1a9375359cfdfac0ea7ffd4230ca62b80c300d5c2bf523"+ },+ {+ "name": "zod",+ "version": "3.25.76",+ "digest": "sha256:7c6dc5843a1ea330f776a13cf573ed8f41718bb461bb15fa071ec1abcd801e63"+ }+ ],+ "packages": [+ {+ "specifier": "@svml/provider-google-vertex",+ "package": {+ "name": "@svml/provider-google-vertex",+ "version": "0.0.0-dev"+ },+ "facetsDigest": "sha256:a1fe53038e8c6c126a1325f15a23061263d85ea4ff7067e36fb9855e77cf4a40",+ "closureDigest": "sha256:f52118471c8005e5b78b4d6b58def15de565e26b802483caa78575f7f4537a87"+ },+ {+ "specifier": "@svml/provider-hyperframes-local",+ "package": {+ "name": "@svml/provider-hyperframes-local",+ "version": "0.0.0-dev"+ },+ "facetsDigest": "sha256:6dbd880063eb20cfd7e1eee749184c1935c353a0cdb732b188508a2410e04eb2",+ "closureDigest": "sha256:b17bb01d3712c7b752bff5f859444abf65e1f57509c1b9af4c5b1da2a86a788d"+ },+ {+ "specifier": "@svml/provider-kie",+ "package": {+ "name": "@svml/provider-kie",+ "version": "0.0.0-dev"+ },+ "facetsDigest": "sha256:bfdc56dd5b01deb5da2c8cfe20e039387b0a9ffb1ce66fceae11378f28cb1bdb",+ "closureDigest": "sha256:c35c1115436a626ae1b648bf18ccb70a3890953e3a8214137e1c40c1d1ab4463"+ },+ {+ "specifier": "@svml/provider-media-local",+ "package": {+ "name": "@svml/provider-media-local",+ "version": "0.0.0-dev"+ },+ "facetsDigest": "sha256:e232139c8339387f3404c29d9ea0829b7be78fb742ee48671727d9c7f899a30b",+ "closureDigest": "sha256:45ce17eb0c224ff87017d88e25d2db3ed1a9458757f083432a9ee5db52673d2c"+ },+ {+ "specifier": "@svml/provider-whisperx-local",+ "package": {+ "name": "@svml/provider-whisperx-local",+ "version": "0.0.0-dev"+ },+ "facetsDigest": "sha256:8a1b222a41c2b8a119c973c783f14efb103745f3ff960c1d8f04aaff534918c9",+ "closureDigest": "sha256:898c6e19d015b7958e589673caf895ded9e948bab62465435e293d3133dd7e54"+ }+ ],+ "digest": "sha256:7e91e3d4d3f3c92f6f4dbd10fb871d635287a7c6ad94d5e69892628bb1f1f991"+}diff --git a/examples/echo-pro-aroll/svml.runtime.json b/examples/echo-pro-aroll/svml.runtime.jsonindex 7b30a826..ab686424 100644--- a/examples/echo-pro-aroll/svml.runtime.json+++ b/examples/echo-pro-aroll/svml.runtime.json@@ -1,6 +1,7 @@{"format": "svml.runtime-config@1","packageLock": "./svml.packages.lock",+ "runtimePackageLock": "./svml.runtime-packages.lock","services": [],"endpoints": [{diff --git a/examples/talking-film-graph-check/svml.packages.lock b/examples/talking-film-graph-check/svml.packages.lockindex 1531d193..3a8bb840 100644--- a/examples/talking-film-graph-check/svml.packages.lock+++ b/examples/talking-film-graph-check/svml.packages.lock@@ -9,17 +9,17 @@{"name": "@svml/broll","version": "0.0.0-dev",- "digest": "sha256:210356a344a0f46c8234293d097eeb5a26fb91664ebecb70145114f69a716a57"+ "digest": "sha256:6711c4ff08c681c7d7ab825017808ce2f5ebfbf96aaa5f978aeef387845b30ae"},{"name": "@svml/caption-gemini","version": "0.0.0-dev",- "digest": "sha256:13a61548967a7bfad911bb369719466f4051434c06729c5ab3c154e7aeb898a0"+ "digest": "sha256:9627669c488f9df22fef6a27f74d2bf5d499e3a0ba651eb594a9b47fe82cd21f"},{"name": "@svml/caption","version": "0.0.0-dev",- "digest": "sha256:a713e3b93bc5f1284d98a4a8e586662e1cb009b329eb0394229bf5170f996527"+ "digest": "sha256:a7f225fee5e57574f3f0d874a3ebaaca896126bee9a1ba420a022b560aaffc53"},{"name": "@svml/component-kit",@@ -29,27 +29,27 @@{"name": "@svml/contracts","version": "0.0.0-dev",- "digest": "sha256:3ff4cc952af34cd1a593a7410c688a81ad40ff23ce637b3e427776b1d2e2faa5"+ "digest": "sha256:b3a9eea0f89a6c0a5920fb055f919a123c9a45b268b31f029e466415565059d3"},{"name": "@svml/core","version": "0.0.0-dev",- "digest": "sha256:cfb73d509a819e42cad5490f26e53bf4e28a2df7ed1e47ffa85bb2833e40bd1e"+ "digest": "sha256:7b8af092e472c43f2b990d92cd7f0b0d426e19f4003582f50ca7aaefd3ec6007"},{"name": "@svml/elaborator","version": "0.0.0-dev",- "digest": "sha256:d31db89e8b0b81ec7e26da804500d14447af7fdf90c6af3a0ad95504c39f37a2"+ "digest": "sha256:d5987b778a5bc3c4b2f734140bb8fd520f5abcb86ce85391464643d59c45f78a"},{"name": "@svml/film","version": "0.0.0-dev",- "digest": "sha256:bdb739078b86f66e1b0fed646fbab675ff4875b74b5c1b58c122e5c3feb61515"+ "digest": "sha256:8ff3f93c98fe9c7825e5b47c916f50e0fc76f99331033ddc2ef59d0c71823025"},{"name": "@svml/generation","version": "0.0.0-dev",- "digest": "sha256:e1dd0c788e89989f679ed3f1de3825d3d76df32a1670258922c42fe0b7414940"+ "digest": "sha256:7cbe6e3c8db1bbe3c084bbdac82fe672908f3f8ec7f1585de28349d8711e1843"},{"name": "@svml/host",@@ -59,17 +59,17 @@{"name": "@svml/hyperframes-render","version": "0.0.0-dev",- "digest": "sha256:84fdc643dcfc751fe1c429d6d5ee665f64f0e1de8b3a3208ff64ed12c0986343"+ "digest": "sha256:6f0dcd08108987e1dd9a5701ee5d2f21d42c4559def713539f3103a19b4d5d3b"},{"name": "@svml/hyperframes","version": "0.0.0-dev",- "digest": "sha256:aea7f05d870f84782efe831c09dd729d5303cc9a5b7a54184ac3d1c193bd59fa"+ "digest": "sha256:c121a31f96d6e5c3205040c58a3a5b03d52ceb31ba584975df2d9b8ceb720ebb"},{"name": "@svml/media-pipeline","version": "0.0.0-dev",- "digest": "sha256:05cf1caee616a44c3a2796d93b38fc6022544b751a29aeaf25869d5f7a84f260"+ "digest": "sha256:4bea3929ab3efabda5748ba897bd597bcfd571ce25459cb387630dfa2a23110a"},{"name": "@svml/media",@@ -84,17 +84,17 @@{"name": "@svml/protocol","version": "0.0.0-dev",- "digest": "sha256:849da200db7a4389f114381ac7b4ce64766ed350481d271394cd0c7348e76786"+ "digest": "sha256:cdede72e3612684f37302267a757cdfde7cd7d474c671e738969b10268e2e7fe"},{"name": "@svml/realization","version": "0.0.0-dev",- "digest": "sha256:049aea1333272415b6605c10004d1ca26c72d348bd00c1885927f425cedc60a2"+ "digest": "sha256:49658ecd041f65f5802e8e460c6cd03b96f0f0a455d77a831383bcd4345ccd33"},{"name": "@svml/run-text","version": "0.0.0-dev",- "digest": "sha256:77d70b1e6f8a2144e71412ca5c44ea80209546525c5b0c3db645d0413b4bd5fc"+ "digest": "sha256:f8ed7cb0371c4fee1f4f45512289784b35da303ae256b1ec805f9bba62be66d0"},{"name": "@svml/run",@@ -104,12 +104,12 @@{"name": "@svml/script","version": "0.0.0-dev",- "digest": "sha256:dfde3dd72c7151982e16c8cef39118d1514b5bf0f38543c25b601ae238fd0bfb"+ "digest": "sha256:ab8aaebbf9826330a6c3a5e51f6c2214f8d7043875a46f744987bfab10ccdb4b"},{"name": "@svml/seedance","version": "0.0.0-dev",- "digest": "sha256:f557df859cebe1af12da15890f891ca92af436583234aec694517b82fa6f3bb4"+ "digest": "sha256:495f6a66fecf255ee806c79c37c0c093be3ea3449c7d8bc57e6808b4823cb528"},{"name": "@svml/source",@@ -119,17 +119,17 @@{"name": "@svml/speech-align","version": "0.0.0-dev",- "digest": "sha256:fd66824aeae08e54e7d224cbe151bd8f1ee75e429071cc05aed1fddf52fe9c12"+ "digest": "sha256:1ae65828af4e46e1e8b4065c28451ee08109fe5e5d58e60e457ff0a610c02d90"},{"name": "@svml/speech-program","version": "0.0.0-dev",- "digest": "sha256:154950cc6346aad5b00c22450ca7e346186e3c51247d3fc11b444710d879a70a"+ "digest": "sha256:a5a120a568bcacc7a01594230d44fc0054e9f044085024332ebb15bc5ebecb2e"},{"name": "@svml/speech-take","version": "0.0.0-dev",- "digest": "sha256:67c738aede20b50bcdd748aa46ba0563b01731444eb4de7663b299f1006f863e"+ "digest": "sha256:51109dd455c17efb026f07e38a760952ab132f7c6571b7e0fcc9fd29178941b3"},{"name": "@svml/svs",@@ -139,7 +139,7 @@{"name": "@svml/text-track","version": "0.0.0-dev",- "digest": "sha256:f27d283873344ac62c94383b5e1680948e0956b06e2d1ef3593b45f17a291f9e"+ "digest": "sha256:e9d62df43e2f85b0e791229f2268b38b11f611c062ceb3ea3ea3d2eab1e161d5"},{"name": "@svml/text",@@ -154,7 +154,7 @@{"name": "@svml/whisperx","version": "0.0.0-dev",- "digest": "sha256:e3fe125fbb4ed52ffb6f099674181dda2ae859890c712644402f63745739a7b8"+ "digest": "sha256:9047e6ed3c9d88dcce16f05d273eb2295692e274b68b6d7ea1835031ef55bebf"}],"packages": [@@ -164,7 +164,8 @@"name": "@svml/artifact","version": "0.0.0-dev"},- "facetsDigest": "sha256:ed2ce2db96aff1ca26c03c28fbf3a3b7da9f25d13ea5cf62525ad6a606f952cf"+ "facetsDigest": "sha256:ed2ce2db96aff1ca26c03c28fbf3a3b7da9f25d13ea5cf62525ad6a606f952cf",+ "closureDigest": "sha256:b3a2d87a65dff2fbbb3b2e922a1d12785434a9d549776476e480260f826ddc66"},{"specifier": "@svml/broll",@@ -172,7 +173,8 @@"name": "@svml/broll","version": "0.0.0-dev"},- "facetsDigest": "sha256:0b95ac97d139aa527178b577aa9fadde3dfdc1edc078d0a9f410b8dcfad43478"+ "facetsDigest": "sha256:ea2b9691c302cdd2c8340241921d1f03f0f67974f94de1eeb382f000b59fb2a3",+ "closureDigest": "sha256:de6ceb0d3baaa30f4e994c32757dbc627bf4006c2b1504a33ec718a088817f8d"},{"specifier": "@svml/caption",@@ -180,7 +182,8 @@"name": "@svml/caption","version": "0.0.0-dev"},- "facetsDigest": "sha256:182ddde2b002c4c3bc2013c5e984831aa6d034d1ded3ab17e0e71e4dd307438a"+ "facetsDigest": "sha256:9ec15efda63a1faff4f877e62465398a97a14344ff032665edb92f5d5f2fa383",+ "closureDigest": "sha256:cc5d2da369694203e40f3c818fe80c51b9e9b0e19c8e3dc1a9501c29250c3357"},{"specifier": "@svml/caption-gemini",@@ -188,7 +191,8 @@"name": "@svml/caption-gemini","version": "0.0.0-dev"},- "facetsDigest": "sha256:06d8072364f86102207c0a4bc0b59f126613010636250f53f9d5184d31bb2766"+ "facetsDigest": "sha256:b117ade42802e2b16f133d575697610cec6b48383e55c92d2d2c785a1b54b55f",+ "closureDigest": "sha256:7c5191db9d11a4981fd7db6d73f05a0bd1c9d178ad89f64dd46631e52dcd8e1b"},{"specifier": "@svml/contracts",@@ -196,7 +200,8 @@"name": "@svml/contracts","version": "0.0.0-dev"},- "facetsDigest": "sha256:1bba3b6672c77931cbc0e002d0509c6ba8f8612cb2a4e0c5897831230b3f35a9"+ "facetsDigest": "sha256:470bff823282df679db44f674439f0885a6c24947616a29bbc87ccda16a7d8a4",+ "closureDigest": "sha256:4c6d67219370a7637d19151ab8df0a2ad77647df490e00d2b9d9863e4f094547"},{"specifier": "@svml/film",@@ -204,7 +209,8 @@"name": "@svml/film","version": "0.0.0-dev"},- "facetsDigest": "sha256:3670c3b1093c0d4a1fea763f4fd071a86cae99e1348aee3dbc6cb57d30252dd2"+ "facetsDigest": "sha256:a3354c9ee0a11c8d9a8547cdd79404b1b2913a948caae842487d205f685ec231",+ "closureDigest": "sha256:e2ce2e2a7cca76db2ee101c46f3bf8f74fd5b843121f78767dcd4b68e92cb785"},{"specifier": "@svml/generation",@@ -212,7 +218,8 @@"name": "@svml/generation","version": "0.0.0-dev"},- "facetsDigest": "sha256:fcba65cbdbe1bf8e3df2df7bd96004b98241a2cc577d5e836b1f9640c6204918"+ "facetsDigest": "sha256:7866bcd3cbe7443a581565a4df4b79dec8d5739c29960711657fe77ec97197b6",+ "closureDigest": "sha256:417b253050509e404efda19abe91073ffc8581ed7f900d9df8360e9f0e35c257"},{"specifier": "@svml/hyperframes",@@ -220,7 +227,8 @@"name": "@svml/hyperframes","version": "0.0.0-dev"},- "facetsDigest": "sha256:7ad54eba232aa29e5c7475d798fdfc19f51ae72c0fc49171df84b63cbe0921d5"+ "facetsDigest": "sha256:26523187df5ae9458b0ab8796919fcfb7a596922c0ad594222ff50d463f2c98d",+ "closureDigest": "sha256:c8f8c62fb8d94e2d6086bab1a39858396ed67a236a6fcafcad8eb9fe3c9355eb"},{"specifier": "@svml/hyperframes-render",@@ -228,7 +236,8 @@"name": "@svml/hyperframes-render","version": "0.0.0-dev"},- "facetsDigest": "sha256:7ca59aba36e096f1a088ae4510d59d27ec083295ac08d224eae8bc51e51b5af3"+ "facetsDigest": "sha256:583b662f225a6c900b1b31ea8005e0ad99fbb78c27dd7cb3d708376c9aae06c6",+ "closureDigest": "sha256:2dd184588bb46c6700ec7dd3f4a0d4a6501f2be4d1022d9ea9d0a48d20db33f3"},{"specifier": "@svml/media",@@ -236,7 +245,8 @@"name": "@svml/media","version": "0.0.0-dev"},- "facetsDigest": "sha256:c2b1e3c1fee0315dada7ad9bcc806cd52eb152ef3efd3aca0313c16944e156ad"+ "facetsDigest": "sha256:fc960a6c4d070aee2cb86c7a677c6f00e1938f14c76cdcb0b4a574bfe8ac2aaa",+ "closureDigest": "sha256:5a88335ee71073b5385efca087a523cc5bef1fb8734543ca6bf93c644d60cd64"},{"specifier": "@svml/media-pipeline",@@ -244,7 +254,8 @@"name": "@svml/media-pipeline","version": "0.0.0-dev"},- "facetsDigest": "sha256:b44c81fb191daf1578cf0ba32272b2f7ec8228bb102e8150aebe5851a88e233d"+ "facetsDigest": "sha256:43e8355a979de13d6e192d79978782661bb487fe1ac0e3df42acb442fb519896",+ "closureDigest": "sha256:35b9b8ee38fca121a270aabff9043baf95102c936867e2c996d6ba44a83591c1"},{"specifier": "@svml/run-text",@@ -252,7 +263,8 @@"name": "@svml/run-text","version": "0.0.0-dev"},- "facetsDigest": "sha256:b3ef99ff47151f27a7601586667fff693724bbe50d45b30317da827997d6a6b4"+ "facetsDigest": "sha256:b3ef99ff47151f27a7601586667fff693724bbe50d45b30317da827997d6a6b4",+ "closureDigest": "sha256:32b0798f74a970493da1e811c85eb95d1c82e4b0824a914c3f2c3d7d4820fb1b"},{"specifier": "@svml/script",@@ -260,7 +272,8 @@"name": "@svml/script","version": "0.0.0-dev"},- "facetsDigest": "sha256:e7d80b9059cae0881ee29bfa6e18f96b445c43227ae665b93196aa4eeaeb1f21"+ "facetsDigest": "sha256:6f2278fc4077d7ea2354aa053f509c088344e9ca45141ff67e8695dbb03e8d5e",+ "closureDigest": "sha256:5402b7e2d2673d77d68861080e7c404c16bb0bb3755988478199f80af602a81a"},{"specifier": "@svml/seedance",@@ -268,7 +281,8 @@"name": "@svml/seedance","version": "0.0.0-dev"},- "facetsDigest": "sha256:99a965be70300fe85f53e9cd660efe1a99ce390061f7f1f759e2892ce8965f30"+ "facetsDigest": "sha256:6d4fb9a090fd5c420040ea8ff85016d9871a22179f52fdf22e72753ef28ba3e7",+ "closureDigest": "sha256:fcf996eeb148435f0696e1088f7491057a859b16b39e6c79429b387a142be63c"},{"specifier": "@svml/speech-align",@@ -276,7 +290,8 @@"name": "@svml/speech-align","version": "0.0.0-dev"},- "facetsDigest": "sha256:5a9a50527fb24cb04c3ddef171b180591522a6ac47d8c186ffb74edf9f3dbe55"+ "facetsDigest": "sha256:59e86a0a789c47b0698797cf2cb4ecd4bf95c78cbff7bd89bc029c9515f3ae73",+ "closureDigest": "sha256:bbef092660ea05599a3373271cf0c78663cfab80259c5a3038495d12978d0f52"},{"specifier": "@svml/speech-program",@@ -284,7 +299,8 @@"name": "@svml/speech-program","version": "0.0.0-dev"},- "facetsDigest": "sha256:35fbb339defcbbdf7cd0a117ec6fef71e2b348e750a0448c8fe58a4fe1798c68"+ "facetsDigest": "sha256:1831df9cadb0f843e91f52a9c0a04a8d2e93b7feb9bc537d3aade5e87ca48fa2",+ "closureDigest": "sha256:d6fc5959442c60b91b39f2797edcd6a9463ac6d65dcf7cd3da6e205ad85f887e"},{"specifier": "@svml/speech-take",@@ -292,7 +308,8 @@"name": "@svml/speech-take","version": "0.0.0-dev"},- "facetsDigest": "sha256:58dbc3fe7e419e563bbcdbdd6101c2857fe1e00d1992b2d3cf915803203fca02"+ "facetsDigest": "sha256:a6022935001b262190151d389c83fe5514490a3c4deca99fa1988ca388695e30",+ "closureDigest": "sha256:01f8f9b843e1e3203d14daf5239ad7c6a1187d3cc2426a0c17734b5f1a518aa7"},{"specifier": "@svml/svs",@@ -300,7 +317,8 @@"name": "@svml/svs","version": "0.0.0-dev"},- "facetsDigest": "sha256:40b91f0e3bbaae42fb7bccacb28f49f44a2be37b0506292c49ed98f842371ebe"+ "facetsDigest": "sha256:40b91f0e3bbaae42fb7bccacb28f49f44a2be37b0506292c49ed98f842371ebe",+ "closureDigest": "sha256:ac11397e8eab51d2a44c5d35651943850893571311c7c47ba9251cf1fdf50351"},{"specifier": "@svml/text-track",@@ -308,7 +326,8 @@"name": "@svml/text-track","version": "0.0.0-dev"},- "facetsDigest": "sha256:9cbc834835cd36542ca583ea00781e363db1b3dc1c6b0817813589a065a12342"+ "facetsDigest": "sha256:c5bb2eeaf4e3a95fea1c1d6408ccd4dfcd7160241a64ee7b92f3f7cc17d4b7d1",+ "closureDigest": "sha256:586a1c1fd09701700ca79c8f84ce5db26e6a8e7cdbe5672ed47f42bc4bec522c"},{"specifier": "@svml/whisperx",@@ -316,8 +335,9 @@"name": "@svml/whisperx","version": "0.0.0-dev"},- "facetsDigest": "sha256:8cfd95fd8932a7159a6a1b82a73ad3858aa5e3a99d96e6a793d3c7d02c235b9d"+ "facetsDigest": "sha256:ed95bc93f9d122d1f0c5c5207ec72920ad1a60927b43131e5b5d34124712349f",+ "closureDigest": "sha256:6af6fab9c184eb29acf8993a98a46fe3e2e6c79809172067ad5794054df9bf16"}],- "digest": "sha256:84a9a9aebb102814559b81b765826f3e35cb779506b86813e8dff7e203e08461"+ "digest": "sha256:aa004c580ee3f0ad88c8dc7127264909570909fb4fc8149facccf689c8df072e"}diff --git a/examples/talking-film-live/README.md b/examples/talking-film-live/README.mdindex 76cb9b4c..8519f117 100644--- a/examples/talking-film-live/README.md+++ b/examples/talking-film-live/README.md@@ -31,6 +31,8 @@ Run the complete graph through the explicit Run Graph and declarative local RuntThe checked-in `svml.packages.lock` selects each author, Run and deterministic compute packageindependently; there is no implicit video bundle. Regenerate it after changing one of those packageimplementations with the package list documented in the lock file.+The independent `svml.runtime-packages.lock` selects only KIE, local media, local WhisperX, Vertex+and local HyperFrames deployment adapters; adding another Provider does not change the CLI.```bashpnpm svml:v2 build examples/talking-film-live/build.svrun \diff --git a/examples/talking-film-live/svml.packages.lock b/examples/talking-film-live/svml.packages.lockindex 40679901..924bb9c6 100644--- a/examples/talking-film-live/svml.packages.lock+++ b/examples/talking-film-live/svml.packages.lock@@ -9,12 +9,12 @@{"name": "@svml/caption-gemini","version": "0.0.0-dev",- "digest": "sha256:13a61548967a7bfad911bb369719466f4051434c06729c5ab3c154e7aeb898a0"+ "digest": "sha256:9627669c488f9df22fef6a27f74d2bf5d499e3a0ba651eb594a9b47fe82cd21f"},{"name": "@svml/caption","version": "0.0.0-dev",- "digest": "sha256:a713e3b93bc5f1284d98a4a8e586662e1cb009b329eb0394229bf5170f996527"+ "digest": "sha256:a7f225fee5e57574f3f0d874a3ebaaca896126bee9a1ba420a022b560aaffc53"},{"name": "@svml/component-kit",@@ -24,32 +24,32 @@{"name": "@svml/contracts","version": "0.0.0-dev",- "digest": "sha256:3ff4cc952af34cd1a593a7410c688a81ad40ff23ce637b3e427776b1d2e2faa5"+ "digest": "sha256:b3a9eea0f89a6c0a5920fb055f919a123c9a45b268b31f029e466415565059d3"},{"name": "@svml/core","version": "0.0.0-dev",- "digest": "sha256:cfb73d509a819e42cad5490f26e53bf4e28a2df7ed1e47ffa85bb2833e40bd1e"+ "digest": "sha256:7b8af092e472c43f2b990d92cd7f0b0d426e19f4003582f50ca7aaefd3ec6007"},{"name": "@svml/elaborator","version": "0.0.0-dev",- "digest": "sha256:d31db89e8b0b81ec7e26da804500d14447af7fdf90c6af3a0ad95504c39f37a2"+ "digest": "sha256:d5987b778a5bc3c4b2f734140bb8fd520f5abcb86ce85391464643d59c45f78a"},{"name": "@svml/estimate","version": "0.0.0-dev",- "digest": "sha256:91770660f244539d2d0db49d46000073cca3202c6148c17466c0547001c4f2dc"+ "digest": "sha256:889457c4fce0be6df8e815add53d3ac3accd0836c78269588e3b94b8d86ee908"},{"name": "@svml/film","version": "0.0.0-dev",- "digest": "sha256:bdb739078b86f66e1b0fed646fbab675ff4875b74b5c1b58c122e5c3feb61515"+ "digest": "sha256:8ff3f93c98fe9c7825e5b47c916f50e0fc76f99331033ddc2ef59d0c71823025"},{"name": "@svml/generation","version": "0.0.0-dev",- "digest": "sha256:e1dd0c788e89989f679ed3f1de3825d3d76df32a1670258922c42fe0b7414940"+ "digest": "sha256:7cbe6e3c8db1bbe3c084bbdac82fe672908f3f8ec7f1585de28349d8711e1843"},{"name": "@svml/host",@@ -59,17 +59,17 @@{"name": "@svml/hyperframes-render","version": "0.0.0-dev",- "digest": "sha256:84fdc643dcfc751fe1c429d6d5ee665f64f0e1de8b3a3208ff64ed12c0986343"+ "digest": "sha256:6f0dcd08108987e1dd9a5701ee5d2f21d42c4559def713539f3103a19b4d5d3b"},{"name": "@svml/hyperframes","version": "0.0.0-dev",- "digest": "sha256:aea7f05d870f84782efe831c09dd729d5303cc9a5b7a54184ac3d1c193bd59fa"+ "digest": "sha256:c121a31f96d6e5c3205040c58a3a5b03d52ceb31ba584975df2d9b8ceb720ebb"},{"name": "@svml/media-pipeline","version": "0.0.0-dev",- "digest": "sha256:05cf1caee616a44c3a2796d93b38fc6022544b751a29aeaf25869d5f7a84f260"+ "digest": "sha256:4bea3929ab3efabda5748ba897bd597bcfd571ce25459cb387630dfa2a23110a"},{"name": "@svml/media",@@ -84,17 +84,17 @@{"name": "@svml/protocol","version": "0.0.0-dev",- "digest": "sha256:849da200db7a4389f114381ac7b4ce64766ed350481d271394cd0c7348e76786"+ "digest": "sha256:cdede72e3612684f37302267a757cdfde7cd7d474c671e738969b10268e2e7fe"},{"name": "@svml/realization","version": "0.0.0-dev",- "digest": "sha256:049aea1333272415b6605c10004d1ca26c72d348bd00c1885927f425cedc60a2"+ "digest": "sha256:49658ecd041f65f5802e8e460c6cd03b96f0f0a455d77a831383bcd4345ccd33"},{"name": "@svml/run-text","version": "0.0.0-dev",- "digest": "sha256:77d70b1e6f8a2144e71412ca5c44ea80209546525c5b0c3db645d0413b4bd5fc"+ "digest": "sha256:f8ed7cb0371c4fee1f4f45512289784b35da303ae256b1ec805f9bba62be66d0"},{"name": "@svml/run",@@ -104,12 +104,12 @@{"name": "@svml/script","version": "0.0.0-dev",- "digest": "sha256:dfde3dd72c7151982e16c8cef39118d1514b5bf0f38543c25b601ae238fd0bfb"+ "digest": "sha256:ab8aaebbf9826330a6c3a5e51f6c2214f8d7043875a46f744987bfab10ccdb4b"},{"name": "@svml/seedance","version": "0.0.0-dev",- "digest": "sha256:f557df859cebe1af12da15890f891ca92af436583234aec694517b82fa6f3bb4"+ "digest": "sha256:495f6a66fecf255ee806c79c37c0c093be3ea3449c7d8bc57e6808b4823cb528"},{"name": "@svml/source",@@ -119,17 +119,17 @@{"name": "@svml/speech-align","version": "0.0.0-dev",- "digest": "sha256:fd66824aeae08e54e7d224cbe151bd8f1ee75e429071cc05aed1fddf52fe9c12"+ "digest": "sha256:1ae65828af4e46e1e8b4065c28451ee08109fe5e5d58e60e457ff0a610c02d90"},{"name": "@svml/speech-program","version": "0.0.0-dev",- "digest": "sha256:154950cc6346aad5b00c22450ca7e346186e3c51247d3fc11b444710d879a70a"+ "digest": "sha256:a5a120a568bcacc7a01594230d44fc0054e9f044085024332ebb15bc5ebecb2e"},{"name": "@svml/speech-take","version": "0.0.0-dev",- "digest": "sha256:67c738aede20b50bcdd748aa46ba0563b01731444eb4de7663b299f1006f863e"+ "digest": "sha256:51109dd455c17efb026f07e38a760952ab132f7c6571b7e0fcc9fd29178941b3"},{"name": "@svml/svs",@@ -139,7 +139,7 @@{"name": "@svml/text-track","version": "0.0.0-dev",- "digest": "sha256:f27d283873344ac62c94383b5e1680948e0956b06e2d1ef3593b45f17a291f9e"+ "digest": "sha256:e9d62df43e2f85b0e791229f2268b38b11f611c062ceb3ea3ea3d2eab1e161d5"},{"name": "@svml/text",@@ -154,7 +154,7 @@{"name": "@svml/whisperx","version": "0.0.0-dev",- "digest": "sha256:e3fe125fbb4ed52ffb6f099674181dda2ae859890c712644402f63745739a7b8"+ "digest": "sha256:9047e6ed3c9d88dcce16f05d273eb2295692e274b68b6d7ea1835031ef55bebf"}],"packages": [@@ -164,7 +164,8 @@"name": "@svml/artifact","version": "0.0.0-dev"},- "facetsDigest": "sha256:ed2ce2db96aff1ca26c03c28fbf3a3b7da9f25d13ea5cf62525ad6a606f952cf"+ "facetsDigest": "sha256:ed2ce2db96aff1ca26c03c28fbf3a3b7da9f25d13ea5cf62525ad6a606f952cf",+ "closureDigest": "sha256:b3a2d87a65dff2fbbb3b2e922a1d12785434a9d549776476e480260f826ddc66"},{"specifier": "@svml/caption",@@ -172,7 +173,8 @@"name": "@svml/caption","version": "0.0.0-dev"},- "facetsDigest": "sha256:182ddde2b002c4c3bc2013c5e984831aa6d034d1ded3ab17e0e71e4dd307438a"+ "facetsDigest": "sha256:9ec15efda63a1faff4f877e62465398a97a14344ff032665edb92f5d5f2fa383",+ "closureDigest": "sha256:cc5d2da369694203e40f3c818fe80c51b9e9b0e19c8e3dc1a9501c29250c3357"},{"specifier": "@svml/caption-gemini",@@ -180,7 +182,8 @@"name": "@svml/caption-gemini","version": "0.0.0-dev"},- "facetsDigest": "sha256:06d8072364f86102207c0a4bc0b59f126613010636250f53f9d5184d31bb2766"+ "facetsDigest": "sha256:b117ade42802e2b16f133d575697610cec6b48383e55c92d2d2c785a1b54b55f",+ "closureDigest": "sha256:7c5191db9d11a4981fd7db6d73f05a0bd1c9d178ad89f64dd46631e52dcd8e1b"},{"specifier": "@svml/contracts",@@ -188,7 +191,8 @@"name": "@svml/contracts","version": "0.0.0-dev"},- "facetsDigest": "sha256:1bba3b6672c77931cbc0e002d0509c6ba8f8612cb2a4e0c5897831230b3f35a9"+ "facetsDigest": "sha256:470bff823282df679db44f674439f0885a6c24947616a29bbc87ccda16a7d8a4",+ "closureDigest": "sha256:4c6d67219370a7637d19151ab8df0a2ad77647df490e00d2b9d9863e4f094547"},{"specifier": "@svml/estimate",@@ -196,7 +200,8 @@"name": "@svml/estimate","version": "0.0.0-dev"},- "facetsDigest": "sha256:9ed84b03dc1ff2010dafae78d98be326058d466bdca92d71398bc237b8c239cc"+ "facetsDigest": "sha256:2de426cc4d8dfaf06f2efe62ab8673d37ba736d7470e07014333ce223824aebf",+ "closureDigest": "sha256:0bcd70e29cad16979299b0452c7f158a45e309c62553b7c04edb02643e32c2db"},{"specifier": "@svml/film",@@ -204,7 +209,8 @@"name": "@svml/film","version": "0.0.0-dev"},- "facetsDigest": "sha256:3670c3b1093c0d4a1fea763f4fd071a86cae99e1348aee3dbc6cb57d30252dd2"+ "facetsDigest": "sha256:a3354c9ee0a11c8d9a8547cdd79404b1b2913a948caae842487d205f685ec231",+ "closureDigest": "sha256:e2ce2e2a7cca76db2ee101c46f3bf8f74fd5b843121f78767dcd4b68e92cb785"},{"specifier": "@svml/generation",@@ -212,7 +218,8 @@"name": "@svml/generation","version": "0.0.0-dev"},- "facetsDigest": "sha256:fcba65cbdbe1bf8e3df2df7bd96004b98241a2cc577d5e836b1f9640c6204918"+ "facetsDigest": "sha256:7866bcd3cbe7443a581565a4df4b79dec8d5739c29960711657fe77ec97197b6",+ "closureDigest": "sha256:417b253050509e404efda19abe91073ffc8581ed7f900d9df8360e9f0e35c257"},{"specifier": "@svml/hyperframes",@@ -220,7 +227,8 @@"name": "@svml/hyperframes","version": "0.0.0-dev"},- "facetsDigest": "sha256:7ad54eba232aa29e5c7475d798fdfc19f51ae72c0fc49171df84b63cbe0921d5"+ "facetsDigest": "sha256:26523187df5ae9458b0ab8796919fcfb7a596922c0ad594222ff50d463f2c98d",+ "closureDigest": "sha256:c8f8c62fb8d94e2d6086bab1a39858396ed67a236a6fcafcad8eb9fe3c9355eb"},{"specifier": "@svml/hyperframes-render",@@ -228,7 +236,8 @@"name": "@svml/hyperframes-render","version": "0.0.0-dev"},- "facetsDigest": "sha256:7ca59aba36e096f1a088ae4510d59d27ec083295ac08d224eae8bc51e51b5af3"+ "facetsDigest": "sha256:583b662f225a6c900b1b31ea8005e0ad99fbb78c27dd7cb3d708376c9aae06c6",+ "closureDigest": "sha256:2dd184588bb46c6700ec7dd3f4a0d4a6501f2be4d1022d9ea9d0a48d20db33f3"},{"specifier": "@svml/media",@@ -236,7 +245,8 @@"name": "@svml/media","version": "0.0.0-dev"},- "facetsDigest": "sha256:c2b1e3c1fee0315dada7ad9bcc806cd52eb152ef3efd3aca0313c16944e156ad"+ "facetsDigest": "sha256:fc960a6c4d070aee2cb86c7a677c6f00e1938f14c76cdcb0b4a574bfe8ac2aaa",+ "closureDigest": "sha256:5a88335ee71073b5385efca087a523cc5bef1fb8734543ca6bf93c644d60cd64"},{"specifier": "@svml/media-pipeline",@@ -244,7 +254,8 @@"name": "@svml/media-pipeline","version": "0.0.0-dev"},- "facetsDigest": "sha256:b44c81fb191daf1578cf0ba32272b2f7ec8228bb102e8150aebe5851a88e233d"+ "facetsDigest": "sha256:43e8355a979de13d6e192d79978782661bb487fe1ac0e3df42acb442fb519896",+ "closureDigest": "sha256:35b9b8ee38fca121a270aabff9043baf95102c936867e2c996d6ba44a83591c1"},{"specifier": "@svml/run-text",@@ -252,7 +263,8 @@"name": "@svml/run-text","version": "0.0.0-dev"},- "facetsDigest": "sha256:b3ef99ff47151f27a7601586667fff693724bbe50d45b30317da827997d6a6b4"+ "facetsDigest": "sha256:b3ef99ff47151f27a7601586667fff693724bbe50d45b30317da827997d6a6b4",+ "closureDigest": "sha256:32b0798f74a970493da1e811c85eb95d1c82e4b0824a914c3f2c3d7d4820fb1b"},{"specifier": "@svml/script",@@ -260,7 +272,8 @@"name": "@svml/script","version": "0.0.0-dev"},- "facetsDigest": "sha256:e7d80b9059cae0881ee29bfa6e18f96b445c43227ae665b93196aa4eeaeb1f21"+ "facetsDigest": "sha256:6f2278fc4077d7ea2354aa053f509c088344e9ca45141ff67e8695dbb03e8d5e",+ "closureDigest": "sha256:5402b7e2d2673d77d68861080e7c404c16bb0bb3755988478199f80af602a81a"},{"specifier": "@svml/seedance",@@ -268,7 +281,8 @@"name": "@svml/seedance","version": "0.0.0-dev"},- "facetsDigest": "sha256:99a965be70300fe85f53e9cd660efe1a99ce390061f7f1f759e2892ce8965f30"+ "facetsDigest": "sha256:6d4fb9a090fd5c420040ea8ff85016d9871a22179f52fdf22e72753ef28ba3e7",+ "closureDigest": "sha256:fcf996eeb148435f0696e1088f7491057a859b16b39e6c79429b387a142be63c"},{"specifier": "@svml/speech-align",@@ -276,7 +290,8 @@"name": "@svml/speech-align","version": "0.0.0-dev"},- "facetsDigest": "sha256:5a9a50527fb24cb04c3ddef171b180591522a6ac47d8c186ffb74edf9f3dbe55"+ "facetsDigest": "sha256:59e86a0a789c47b0698797cf2cb4ecd4bf95c78cbff7bd89bc029c9515f3ae73",+ "closureDigest": "sha256:bbef092660ea05599a3373271cf0c78663cfab80259c5a3038495d12978d0f52"},{"specifier": "@svml/speech-program",@@ -284,7 +299,8 @@"name": "@svml/speech-program","version": "0.0.0-dev"},- "facetsDigest": "sha256:35fbb339defcbbdf7cd0a117ec6fef71e2b348e750a0448c8fe58a4fe1798c68"+ "facetsDigest": "sha256:1831df9cadb0f843e91f52a9c0a04a8d2e93b7feb9bc537d3aade5e87ca48fa2",+ "closureDigest": "sha256:d6fc5959442c60b91b39f2797edcd6a9463ac6d65dcf7cd3da6e205ad85f887e"},{"specifier": "@svml/speech-take",@@ -292,7 +308,8 @@"name": "@svml/speech-take","version": "0.0.0-dev"},- "facetsDigest": "sha256:58dbc3fe7e419e563bbcdbdd6101c2857fe1e00d1992b2d3cf915803203fca02"+ "facetsDigest": "sha256:a6022935001b262190151d389c83fe5514490a3c4deca99fa1988ca388695e30",+ "closureDigest": "sha256:01f8f9b843e1e3203d14daf5239ad7c6a1187d3cc2426a0c17734b5f1a518aa7"},{"specifier": "@svml/svs",@@ -300,7 +317,8 @@"name": "@svml/svs","version": "0.0.0-dev"},- "facetsDigest": "sha256:40b91f0e3bbaae42fb7bccacb28f49f44a2be37b0506292c49ed98f842371ebe"+ "facetsDigest": "sha256:40b91f0e3bbaae42fb7bccacb28f49f44a2be37b0506292c49ed98f842371ebe",+ "closureDigest": "sha256:ac11397e8eab51d2a44c5d35651943850893571311c7c47ba9251cf1fdf50351"},{"specifier": "@svml/text-track",@@ -308,7 +326,8 @@"name": "@svml/text-track","version": "0.0.0-dev"},- "facetsDigest": "sha256:9cbc834835cd36542ca583ea00781e363db1b3dc1c6b0817813589a065a12342"+ "facetsDigest": "sha256:c5bb2eeaf4e3a95fea1c1d6408ccd4dfcd7160241a64ee7b92f3f7cc17d4b7d1",+ "closureDigest": "sha256:586a1c1fd09701700ca79c8f84ce5db26e6a8e7cdbe5672ed47f42bc4bec522c"},{"specifier": "@svml/whisperx",@@ -316,8 +335,9 @@"name": "@svml/whisperx","version": "0.0.0-dev"},- "facetsDigest": "sha256:8cfd95fd8932a7159a6a1b82a73ad3858aa5e3a99d96e6a793d3c7d02c235b9d"+ "facetsDigest": "sha256:ed95bc93f9d122d1f0c5c5207ec72920ad1a60927b43131e5b5d34124712349f",+ "closureDigest": "sha256:6af6fab9c184eb29acf8993a98a46fe3e2e6c79809172067ad5794054df9bf16"}],- "digest": "sha256:e579b840a0af15e90123a8d664ff8242b10b7d2881326f98b8e2649e4c7b518d"+ "digest": "sha256:d5a46a7def7a08ecf963c927fb930e7c66b4d16b8f2c8c27bd5e4558d33fcc3d"}diff --git a/examples/talking-film-live/svml.runtime-packages.lock b/examples/talking-film-live/svml.runtime-packages.locknew file mode 100644index 00000000..8599a17f--- /dev/null+++ b/examples/talking-film-live/svml.runtime-packages.lock@@ -0,0 +1,898 @@+{+ "format": "svml.node-package-lock@1",+ "artifacts": [+ {+ "name": "@esbuild/darwin-arm64",+ "version": "0.25.12",+ "digest": "sha256:db9d414d5c92d188d53dd0e100d3e104543f4b272037beb258edc2ead0d28998"+ },+ {+ "name": "@google/genai",+ "version": "1.52.0",+ "digest": "sha256:ccae11f511dd32659ff165bb7f1086574ec919e45b4a72df1756c3464e3f8050"+ },+ {+ "name": "@hono/node-server",+ "version": "2.0.12",+ "digest": "sha256:87fdbb42f820648585a5837efaaeb60ec591224edec033de67a13f2b28eb63eb"+ },+ {+ "name": "@img/colour",+ "version": "1.1.0",+ "digest": "sha256:87ff399e23a6a25336858a0dbd64f7b83720c5e801e05b4c6309af6d12521c45"+ },+ {+ "name": "@isaacs/fs-minipass",+ "version": "4.0.1",+ "digest": "sha256:9004aaba5f83bb21b33ede79ad6420cef93105d4e7347622c2bf778407152b88"+ },+ {+ "name": "@protobufjs/aspromise",+ "version": "1.1.2",+ "digest": "sha256:b26d2da7a85f408d36a1e5cf7653f1b315c7f86e24a94a7ca90adfce78a52259"+ },+ {+ "name": "@protobufjs/base64",+ "version": "1.1.2",+ "digest": "sha256:03d093e51f450fc70ab0d38e5feb3ff3009db4caa1400aa89f77312be60dbd4e"+ },+ {+ "name": "@protobufjs/codegen",+ "version": "2.0.5",+ "digest": "sha256:a51d648a01c9e4b1ce86aeaa7b3580d6736872d85ca2708a265a7a3d5db60e47"+ },+ {+ "name": "@protobufjs/eventemitter",+ "version": "1.1.1",+ "digest": "sha256:9b70b7b43a6dc11270198eddb75e741ffa22aa6ae1e907480d3fb923956d44b6"+ },+ {+ "name": "@protobufjs/fetch",+ "version": "1.1.1",+ "digest": "sha256:9b4fa3a53ebb883c1d711aab0196745351c385eac35dd57aa5e8d943edc621ed"+ },+ {+ "name": "@protobufjs/float",+ "version": "1.0.2",+ "digest": "sha256:6ed05c3181c9ea4a8516b3561541a7b7d32cd6e8e7746fbaadf0aee3ead9804e"+ },+ {+ "name": "@protobufjs/path",+ "version": "1.1.2",+ "digest": "sha256:c90aff98ba0fefc2e509a3e31f87bd8c0d300b5321613281a569a97d336217db"+ },+ {+ "name": "@protobufjs/pool",+ "version": "1.1.0",+ "digest": "sha256:898bf407a5251b1fcacc5ba59d491b465249dcbe985b30b907d6a8efe929e015"+ },+ {+ "name": "@protobufjs/utf8",+ "version": "1.1.2",+ "digest": "sha256:8a0bcf97df0a7807dc0ad71e46fb349b11d3f7f6fbb5d9e4d8227a7361c43fbb"+ },+ {+ "name": "@puppeteer/browsers",+ "version": "3.0.6",+ "digest": "sha256:1fc1212e7cf17104bd0e45e8e63c90b984df83e9a2b11ef8104b162bb140893f"+ },+ {+ "name": "@svml/artifact",+ "version": "0.0.0-dev",+ "digest": "sha256:368270c5c19f9300599a4a1ee9f7525f39b1e3e2c036bf0b03317fa2dc32a303"+ },+ {+ "name": "@svml/caption-gemini",+ "version": "0.0.0-dev",+ "digest": "sha256:9627669c488f9df22fef6a27f74d2bf5d499e3a0ba651eb594a9b47fe82cd21f"+ },+ {+ "name": "@svml/caption",+ "version": "0.0.0-dev",+ "digest": "sha256:a7f225fee5e57574f3f0d874a3ebaaca896126bee9a1ba420a022b560aaffc53"+ },+ {+ "name": "@svml/component-kit",+ "version": "0.0.0-dev",+ "digest": "sha256:789d38bf44d7d40cf13734e09f68c8fd8302807fcd9b20a9ef0439f488af1ae2"+ },+ {+ "name": "@svml/contracts",+ "version": "0.0.0-dev",+ "digest": "sha256:b3a9eea0f89a6c0a5920fb055f919a123c9a45b268b31f029e466415565059d3"+ },+ {+ "name": "@svml/core",+ "version": "0.0.0-dev",+ "digest": "sha256:7b8af092e472c43f2b990d92cd7f0b0d426e19f4003582f50ca7aaefd3ec6007"+ },+ {+ "name": "@svml/elaborator",+ "version": "0.0.0-dev",+ "digest": "sha256:d5987b778a5bc3c4b2f734140bb8fd520f5abcb86ce85391464643d59c45f78a"+ },+ {+ "name": "@svml/endpoint-kit",+ "version": "0.0.0-dev",+ "digest": "sha256:49ba39c758614bba5c473601cbc0d36b7d38e823031b2d3dfdd76f95c6b6702e"+ },+ {+ "name": "@svml/gemini-omni",+ "version": "0.0.0-dev",+ "digest": "sha256:d50e807fac4ebb56d157a871d714d7c1ed33b0825fef9b2612782c4c8d7de81c"+ },+ {+ "name": "@svml/generation",+ "version": "0.0.0-dev",+ "digest": "sha256:7cbe6e3c8db1bbe3c084bbdac82fe672908f3f8ec7f1585de28349d8711e1843"+ },+ {+ "name": "@svml/gpt-image",+ "version": "0.0.0-dev",+ "digest": "sha256:5df4a843ea5421cd32368e1e3c3874d02245efa3d9b46e261b90a267059db5a6"+ },+ {+ "name": "@svml/grok-imagine",+ "version": "0.0.0-dev",+ "digest": "sha256:88113fd6ee317e00a191129c0e44b1c9c08637859a25e01bc4020546b9e7a306"+ },+ {+ "name": "@svml/host",+ "version": "0.0.0-dev",+ "digest": "sha256:a59a3ac2647bebd223b6ebb4d2830a1c86a19d427d49095ae3479de79519f815"+ },+ {+ "name": "@svml/hyperframes-render",+ "version": "0.0.0-dev",+ "digest": "sha256:6f0dcd08108987e1dd9a5701ee5d2f21d42c4559def713539f3103a19b4d5d3b"+ },+ {+ "name": "@svml/hyperframes",+ "version": "0.0.0-dev",+ "digest": "sha256:c121a31f96d6e5c3205040c58a3a5b03d52ceb31ba584975df2d9b8ceb720ebb"+ },+ {+ "name": "@svml/media-pipeline",+ "version": "0.0.0-dev",+ "digest": "sha256:4bea3929ab3efabda5748ba897bd597bcfd571ce25459cb387630dfa2a23110a"+ },+ {+ "name": "@svml/minimax-h3",+ "version": "0.0.0-dev",+ "digest": "sha256:aebb4ccc3d376f5f766dea05132eb30c7bb9dbf71224bfcea1c5d2d53a5293c1"+ },+ {+ "name": "@svml/model-kit",+ "version": "0.0.0-dev",+ "digest": "sha256:51c71bac3365c6811b27d0aa345b63ff64cee26047bd33b524ad6aa969cc02de"+ },+ {+ "name": "@svml/nano-banana",+ "version": "0.0.0-dev",+ "digest": "sha256:0f7de960105c3889ba5a53be86eb0cc9e2c18ab7d8f7047250fd903752f4c0c0"+ },+ {+ "name": "@svml/protocol",+ "version": "0.0.0-dev",+ "digest": "sha256:cdede72e3612684f37302267a757cdfde7cd7d474c671e738969b10268e2e7fe"+ },+ {+ "name": "@svml/provider-google-vertex",+ "version": "0.0.0-dev",+ "digest": "sha256:7084e3278a7a9c987f8c7c58ffabdaa2c908d2a42af2de5d31b590a19a1dbf94"+ },+ {+ "name": "@svml/provider-hyperframes-local",+ "version": "0.0.0-dev",+ "digest": "sha256:f94e3d0e32fe4b43d4e72ddf1a1f3233fc8a470004c0589b7eb7c3b4bac3bbc5"+ },+ {+ "name": "@svml/provider-kie",+ "version": "0.0.0-dev",+ "digest": "sha256:ca7a6cc1ab96011c68ec20d82847e7bb92287735a34c3110181430db34e35035"+ },+ {+ "name": "@svml/provider-media-local",+ "version": "0.0.0-dev",+ "digest": "sha256:8b25af7a32644b6a5c1d168ab487e18ba5f97dc9b148887aac289fc83e5b9242"+ },+ {+ "name": "@svml/provider-whisperx-local",+ "version": "0.0.0-dev",+ "digest": "sha256:fc69b1beb7c726ad93a337365c7e7106c6e23752021118d05fcdf4f9b845285b"+ },+ {+ "name": "@svml/runtime-adapter-node",+ "version": "0.0.0-dev",+ "digest": "sha256:a298036b5c46dd8e2bb4c76db9c9e024e8e8738f0e442176dd36d63a9b24aced"+ },+ {+ "name": "@svml/runtime-adapter",+ "version": "0.0.0-dev",+ "digest": "sha256:d900d18ab1fd68d4b6a1ddcfb84f3c1323092346e6d056fbd67a4ea48cd53c45"+ },+ {+ "name": "@svml/runtime",+ "version": "0.0.0-dev",+ "digest": "sha256:e1c9c6e856d69f3a5a00bda85064a8934320a4f7cfc4d7c962f56eb9d18905ff"+ },+ {+ "name": "@svml/seedance",+ "version": "0.0.0-dev",+ "digest": "sha256:495f6a66fecf255ee806c79c37c0c093be3ea3449c7d8bc57e6808b4823cb528"+ },+ {+ "name": "@svml/seedream",+ "version": "0.0.0-dev",+ "digest": "sha256:5c50cd0e4d015c669f1d398dd46d65cf8eb9f4fcc511f14b7083e55f57446a54"+ },+ {+ "name": "@svml/source",+ "version": "0.0.0-dev",+ "digest": "sha256:2ab24d6e0a392e602f99573166ce3d48a8c561fa55f9ee425a25361077b8c483"+ },+ {+ "name": "@svml/speech-align",+ "version": "0.0.0-dev",+ "digest": "sha256:1ae65828af4e46e1e8b4065c28451ee08109fe5e5d58e60e457ff0a610c02d90"+ },+ {+ "name": "@svml/svs",+ "version": "0.0.0-dev",+ "digest": "sha256:a336db7f075cab5357a96ba0d3b079c213c93fa0a4f95c39926c2e1b784d3d24"+ },+ {+ "name": "@svml/text",+ "version": "0.0.0-dev",+ "digest": "sha256:03985ce5c8bf04fc8dcfc474b4b80133a5bffbb6965604bdc0f9f8fb64ad0524"+ },+ {+ "name": "@svml/validation",+ "version": "0.0.0-dev",+ "digest": "sha256:4322dffd7ea245484a12fb674a0d2f70f25d1287b9f7aa67ed5714431035e9dd"+ },+ {+ "name": "@svml/whisperx",+ "version": "0.0.0-dev",+ "digest": "sha256:9047e6ed3c9d88dcce16f05d273eb2295692e274b68b6d7ea1835031ef55bebf"+ },+ {+ "name": "@swc/helpers",+ "version": "0.5.23",+ "digest": "sha256:214421c9be182a986122710fe7e3a3f6f435a9972eb5ea6c172faaafb73b2d66"+ },+ {+ "name": "@types/node",+ "version": "24.10.1",+ "digest": "sha256:6a669a3423310fae21be2be89f593626f2c9c78a0e0262c13224599953bc4cd7"+ },+ {+ "name": "@types/retry",+ "version": "0.12.0",+ "digest": "sha256:941f2577dd499b89987ea6f2d1d3d9b5f0e34527a9357f551681d6ff3520e2ec"+ },+ {+ "name": "adm-zip",+ "version": "0.6.0",+ "digest": "sha256:13cb7236751a108755ee3e5305ea44c69c78d0c9605ace0f072ac0c536f37f97"+ },+ {+ "name": "agent-base",+ "version": "7.1.4",+ "digest": "sha256:40ec8d2a7b552e0874da733e43ef2cb08353bed9895af6b45e036818dcb4e40c"+ },+ {+ "name": "ansi-regex",+ "version": "6.2.2",+ "digest": "sha256:62301d8f03e735d1d229572aa95ad59bcdee77e489a38a73fc8e4401fdd7cc7e"+ },+ {+ "name": "ansi-styles",+ "version": "6.2.3",+ "digest": "sha256:0dc17a9cb94edba0e52788414fc0ba0e21d8fdbfec928a114be1a94e69abbd59"+ },+ {+ "name": "base64-js",+ "version": "1.5.1",+ "digest": "sha256:4984816098020b94228c9a7946ea80ab4795078d5de3d484e818baa246f77f79"+ },+ {+ "name": "bignumber.js",+ "version": "9.3.1",+ "digest": "sha256:32e6ecaf68aa121da8203fe69aa7e0096de221a0de5fd2bcfbb3de891d675503"+ },+ {+ "name": "boolean",+ "version": "3.2.0",+ "digest": "sha256:36e3dbee991cf3a736740c6a3eaf5d49b85b3e40fe8113a1b763741788616e6f"+ },+ {+ "name": "brotli",+ "version": "1.3.3",+ "digest": "sha256:0ffd76410e1b12c33d8d464b5df349ddb2e2e1de062cda48901824448a84104c"+ },+ {+ "name": "buffer-equal-constant-time",+ "version": "1.0.1",+ "digest": "sha256:7f7ae10c48a0ccc45a8375101ba92708aab7129c66d1918309ed37cea429d0fd"+ },+ {+ "name": "bundle-name",+ "version": "4.1.0",+ "digest": "sha256:eb752be0b969cbebab06b6bb9f46976b6e0032173aefdc179687ebccaa44f94b"+ },+ {+ "name": "chownr",+ "version": "3.0.0",+ "digest": "sha256:7b88dbf0df1f298d83c0849c84aeefc5a396d54ca1fc01a28f244f8c1be025af"+ },+ {+ "name": "chromium-bidi",+ "version": "17.0.2",+ "digest": "sha256:ec8999a0a291d02fe51b7121eb971a35f1e3a1fd2a2d1324629c96f9a75b20a8"+ },+ {+ "name": "citty",+ "version": "0.2.2",+ "digest": "sha256:25a8b490b976cb9292d67c47be01866caa98425a4e33d70ac258db9743a88df6"+ },+ {+ "name": "cliui",+ "version": "9.0.1",+ "digest": "sha256:da1fca6a22fbf931ced1655f040e2b3076adf433e2150dbb5071a69c33e70ba9"+ },+ {+ "name": "clone",+ "version": "2.1.2",+ "digest": "sha256:282ee2f216faaed203b56bd9cfd4da5a18605fe65810757d2a9ea5ecd9500125"+ },+ {+ "name": "compare-versions",+ "version": "6.1.1",+ "digest": "sha256:66cedeff9e100ea3d24eedbf263b076e6baa3c499e4651994fff66f1dea5877e"+ },+ {+ "name": "data-uri-to-buffer",+ "version": "4.0.1",+ "digest": "sha256:0dc22fd9c89bd8380616b2ee17155470f8783b41ba89789b075dc4ba484080df"+ },+ {+ "name": "debug",+ "version": "4.4.3",+ "digest": "sha256:1a7cc10a8613e2472b802c38eaf47c489bd798e9ce0f412184f695107c3fa3a0"+ },+ {+ "name": "default-browser-id",+ "version": "5.0.1",+ "digest": "sha256:b4bdd210d24cb1f62b83c77ae731ab1da073e45245baad0de1d6f5f02c9d466e"+ },+ {+ "name": "default-browser",+ "version": "5.5.0",+ "digest": "sha256:d81632b25bc8f83bb1a14add53d9fb0ee271842b09569169dcef10b92e9a2fa5"+ },+ {+ "name": "define-data-property",+ "version": "1.1.4",+ "digest": "sha256:221f75bd851a964e7942385ada443570929f69196d6c784630639984385fc5ad"+ },+ {+ "name": "define-lazy-prop",+ "version": "3.0.0",+ "digest": "sha256:c3dd5983fde9b61f7808753874e319d0e05f91adf5a55b95c599413a4cf86f93"+ },+ {+ "name": "define-properties",+ "version": "1.2.1",+ "digest": "sha256:eedbb9184b6426f20f1442ed7a62a98015182bffa41bba4fa4dba63471ba7417"+ },+ {+ "name": "detect-libc",+ "version": "2.1.2",+ "digest": "sha256:39e893aa920fb3a1af7ab5e2fac8d037485d6e43a28acc27097e0ddc44977388"+ },+ {+ "name": "detect-node",+ "version": "2.1.0",+ "digest": "sha256:996c11b800375bcbe83c7e3fef5bf22d1a968b70084d044f056d54a2b6d5378c"+ },+ {+ "name": "devtools-protocol",+ "version": "0.0.1653615",+ "digest": "sha256:1378e3705558176026ae9eb2d219ab359032f2a5d5bddeafa530cbe8bc14a7df"+ },+ {+ "name": "dfa",+ "version": "1.2.0",+ "digest": "sha256:9e6dd4727a3c3b8ba07bd03137d6f98ef7103486608131967b45d863b438bd1a"+ },+ {+ "name": "ecdsa-sig-formatter",+ "version": "1.0.11",+ "digest": "sha256:c0abf8e5fedfdc933291df29898bb186dd642cc997b37cfbb8b44f63f65a2574"+ },+ {+ "name": "emoji-regex",+ "version": "10.6.0",+ "digest": "sha256:eb9d30ffe6019e2863afc186ae442367b68e72d4324119953136cc052a8a853d"+ },+ {+ "name": "es-define-property",+ "version": "1.0.1",+ "digest": "sha256:4f1993238f7a037bd0efcc84bd55b144be286b0d5093f9d1d9ba6bd923e8b23b"+ },+ {+ "name": "es-errors",+ "version": "1.3.0",+ "digest": "sha256:0aace4cb4e9b4c30867fcf2ab951b5ba67e74bf0d9ae01e1af44997b88100b0d"+ },+ {+ "name": "es6-error",+ "version": "4.1.1",+ "digest": "sha256:018f98c8351e95bbd0673def8b129d81140abb73bc15d4aff0da457352b19611"+ },+ {+ "name": "esbuild",+ "version": "0.25.12",+ "digest": "sha256:d45f05635279ab74b586ef526256666bf06353c35733ba7265669098f7b0f221"+ },+ {+ "name": "escalade",+ "version": "3.2.0",+ "digest": "sha256:b90bb70c6aefd3efa34f4b7cbabe08ddc3685453fa7de431d8f239e61f14949f"+ },+ {+ "name": "escape-string-regexp",+ "version": "4.0.0",+ "digest": "sha256:cf7484214bba7d92b7520e80e260071e172ccb2bc5980dc546874f9fee41c41c"+ },+ {+ "name": "extend",+ "version": "3.0.2",+ "digest": "sha256:4a27fbfbe686002e72b43f558129c99bb8033c46d34d5ed3ce65579818b120aa"+ },+ {+ "name": "fast-deep-equal",+ "version": "3.1.3",+ "digest": "sha256:a9b29965b98994618171ac2981b88f385f2299bbfc0c3831c5cd259aa8ca999c"+ },+ {+ "name": "fetch-blob",+ "version": "3.2.0",+ "digest": "sha256:c99727d97c6d1d689a0927c8366aa3236fac687f1b32b5a4a6fb50f1a9475ca1"+ },+ {+ "name": "fontkit",+ "version": "2.0.4",+ "digest": "sha256:b600e103edaad329a12b5f391be8e51208493460317dd49ba162a807c854b63f"+ },+ {+ "name": "formdata-polyfill",+ "version": "4.0.10",+ "digest": "sha256:f00e63dcfc33f8409f8dac1c27ce16668955a9649c0cd9660eafbd5133b094f3"+ },+ {+ "name": "gaxios",+ "version": "7.3.0",+ "digest": "sha256:d02991d60ba0d7190905094252a65eea21fc14e3d6d80a263d3640f9b3120c9b"+ },+ {+ "name": "gcp-metadata",+ "version": "8.1.2",+ "digest": "sha256:e5cea6539cb0339595392f03548e2a6550fe494a8b37abd647045cb574b498b3"+ },+ {+ "name": "get-caller-file",+ "version": "2.0.5",+ "digest": "sha256:6941f3900745f48cec5e064bce86d053920ff1bcc26f67847aeaa4466218dc25"+ },+ {+ "name": "get-east-asian-width",+ "version": "1.6.0",+ "digest": "sha256:48e7876000807ad55fa5b5a3d8fdd49b1f56ec6e321532a674b6c33646bcad81"+ },+ {+ "name": "giget",+ "version": "3.3.1",+ "digest": "sha256:ceaa8a1b7b1c1d30bc6d1b90929808c92ada2ec01883bb47f6d6c9bce7322073"+ },+ {+ "name": "global-agent",+ "version": "3.0.0",+ "digest": "sha256:43eb33eb0f491ad69fe8ed6cb589b13d5722292c6ed9119c887ddb030e2b47f3"+ },+ {+ "name": "globalthis",+ "version": "1.0.4",+ "digest": "sha256:e469a050f10ae6e41c118f1e9f948265f5d85fee6e53c141836ec9815cf14324"+ },+ {+ "name": "google-auth-library",+ "version": "10.9.1",+ "digest": "sha256:f693bc5dfb6daa4f3c10f067794a1561b281497b0bb60635b0c915d86e4daa9a"+ },+ {+ "name": "google-logging-utils",+ "version": "1.1.3",+ "digest": "sha256:d9972e61745d9340c9a7268e380b0799e2bfcadc65c650d94c3c0c7cab4b7701"+ },+ {+ "name": "gopd",+ "version": "1.2.0",+ "digest": "sha256:84538a63b1ad06917107969f8f5a7614a69810d5d8deb9ec1ecbc0f7c7d5ca38"+ },+ {+ "name": "has-property-descriptors",+ "version": "1.0.2",+ "digest": "sha256:30760526550c3bf973432235801143320cc22f41e02b79083c765636c72400f6"+ },+ {+ "name": "hono",+ "version": "4.12.32",+ "digest": "sha256:0ef54794c02fe4aaec727b7e44836dfaf91c58c375ff768c846d774e93c4eba8"+ },+ {+ "name": "https-proxy-agent",+ "version": "7.0.6",+ "digest": "sha256:1b462b0f25b3cee2a682b3bbe1b23fe75e52cce450c4648bb234ff4dd3af2408"+ },+ {+ "name": "hyperframes",+ "version": "0.7.84",+ "digest": "sha256:d61bdd821dc513adcddeb339559f6a165ab7a0e8702ace8e97b6494f51d92b6e"+ },+ {+ "name": "ignore",+ "version": "5.3.2",+ "digest": "sha256:d0aaa6cad4117a885aed4794fe66735498437f1c878dbf2ef66ef1ab1c2a660b"+ },+ {+ "name": "is-docker",+ "version": "3.0.0",+ "digest": "sha256:97eb5b5b8156bd00c384fb9fb307a45910aecf095dd6184f111d4b8e0bd666f7"+ },+ {+ "name": "is-inside-container",+ "version": "1.0.0",+ "digest": "sha256:08f265e1b3b219c2952c5b859210a3713bade08013c5b27f96ad36661988342f"+ },+ {+ "name": "is-wsl",+ "version": "3.1.1",+ "digest": "sha256:86436e3a243b5f8271667ea3d022de5c1600ac3cb7d8b2d34668ffa9df3d0ecb"+ },+ {+ "name": "json-bigint",+ "version": "1.0.0",+ "digest": "sha256:c274e017d82fbbbf324909b464ea5442142bb962df9dc6f71ab13ef8e163c491"+ },+ {+ "name": "json-stringify-safe",+ "version": "5.0.1",+ "digest": "sha256:d1db83cd2e4b320c31d6ef03ebf7f325af566a6131016b350b4fbbd3fff12fec"+ },+ {+ "name": "jwa",+ "version": "2.0.1",+ "digest": "sha256:ac936dbe43949b68ffae751c977fef81fd45bb030ce84f0757b921bd7b1d7b0e"+ },+ {+ "name": "jws",+ "version": "4.0.1",+ "digest": "sha256:542221db2029af0e55aa1eed9d420843756437acfa8a97534c5f4c96d6f1306f"+ },+ {+ "name": "long",+ "version": "5.3.2",+ "digest": "sha256:da45a5f60cb1e4dc5384f5c168cd8849944eff998463390386d6459fe10e5aba"+ },+ {+ "name": "matcher",+ "version": "3.0.0",+ "digest": "sha256:9912f19359607c866d9f618d168c50f3b0833a254d2e985eba691fd6bf0e6fbd"+ },+ {+ "name": "minipass",+ "version": "7.1.3",+ "digest": "sha256:f59781ced29dbfc5853800d2d200e7fae7f76bb23c6ea9e1976104000d9dd87f"+ },+ {+ "name": "minizlib",+ "version": "3.1.0",+ "digest": "sha256:8b215413f5f55261d07815e90335340aabd1c48bee5f1b2b20eadbb35541d6e2"+ },+ {+ "name": "mitt",+ "version": "3.0.1",+ "digest": "sha256:f05aee474033331f89fb4e3834c2ee96574fa107232539fa61135a16fe788c9b"+ },+ {+ "name": "modern-tar",+ "version": "0.7.7",+ "digest": "sha256:f99563f38a7ba7212a3ad5592a6967bf69a086457d0321d289c466ab5f6688aa"+ },+ {+ "name": "ms",+ "version": "2.1.3",+ "digest": "sha256:51788e2027fa4e83998d090b3784acc85ccb83543a250426e757b7ac4fd9f3c3"+ },+ {+ "name": "nanoid",+ "version": "3.3.16",+ "digest": "sha256:78922068150a563f9ae6689fe393acd229b74e661a92d5a4a98e1f4e0bd67712"+ },+ {+ "name": "node-domexception",+ "version": "1.0.0",+ "digest": "sha256:aca17999c243a93f48bdba070cb2ac2d0ab8d24c297dfdecb0183556ce8a7b45"+ },+ {+ "name": "node-fetch",+ "version": "3.3.2",+ "digest": "sha256:7d33e270006e72c9480c0d4fe42c78308ee40927929c8673b1f0668ff5a6f7a6"+ },+ {+ "name": "object-keys",+ "version": "1.1.1",+ "digest": "sha256:7a85215ee04e41d0cc498beb263ef7a2f07b15c18983cb520e49e51c38b9dd3c"+ },+ {+ "name": "onnxruntime-common",+ "version": "1.21.1",+ "digest": "sha256:c230c9b0663d360829c4b0ee3499a0282b5fc7c47f382a5003d2119954bea3c2"+ },+ {+ "name": "onnxruntime-node",+ "version": "1.21.1",+ "digest": "sha256:91cbee2cc2ba08b97fea94cc191c025ad9bbe0fdcc5f71f94e0c99ab6b611387"+ },+ {+ "name": "open",+ "version": "10.2.0",+ "digest": "sha256:97cd19c76498bd518d4ee951b0692ba49b5a3371fac07db619538b35797afa57"+ },+ {+ "name": "p-retry",+ "version": "4.6.2",+ "digest": "sha256:1cc6fd01ff96d9710043c74f822a86ea35c9645cf84123cbb716d96298ac6cdc"+ },+ {+ "name": "pako",+ "version": "0.2.9",+ "digest": "sha256:9a4c993683c0c9b1aa01669a2154bac931eecc0f194064f6b5504560ac5e0d55"+ },+ {+ "name": "picocolors",+ "version": "1.1.1",+ "digest": "sha256:be79e912ac3251b3baada9dd6510c98f59bb9d8d0ef70366aba9c760a92e1584"+ },+ {+ "name": "postcss",+ "version": "8.5.25",+ "digest": "sha256:a2996a4d94a0f4d48217455b5a56c5c255a127bb0f7acbb5c61b0d45529340c2"+ },+ {+ "name": "prettier",+ "version": "3.9.6",+ "digest": "sha256:e9878409caf16dffcdb6f3547433bcb9659cca36809e9a82384c726250c3d28d"+ },+ {+ "name": "protobufjs",+ "version": "7.6.5",+ "digest": "sha256:407aa02e41f2a2b955161421650589ee8fa3c12a8c99cd311538c9ffb6bc62ff"+ },+ {+ "name": "puppeteer-core",+ "version": "25.4.0",+ "digest": "sha256:05bbe4cff28c147c6f78aa83edfd1180321d4734ec4180077ab4ac5f8e8c031e"+ },+ {+ "name": "restructure",+ "version": "3.0.2",+ "digest": "sha256:697be69079ad312005d5f42a1eb8d8e90fc0fd4721ecece8cd6089f5b0cee68d"+ },+ {+ "name": "retry",+ "version": "0.13.1",+ "digest": "sha256:7dd16334cc998c2e292625c3db61a03f47d9c35fb1a0217cb5380541b1e59f0e"+ },+ {+ "name": "roarr",+ "version": "2.15.4",+ "digest": "sha256:84e973663fbcd064f7546e5b39ac50017c3435f1186c3fc0ca3e3957f7d8642d"+ },+ {+ "name": "run-applescript",+ "version": "7.1.0",+ "digest": "sha256:502309607976bcc8530d116d33d3d61a5bede9d8b1b4f6f81d88d1b76cc5b95c"+ },+ {+ "name": "safe-buffer",+ "version": "5.2.1",+ "digest": "sha256:57d787833c2ccd7b189cf242bac30e4e3be2ab597559d8113276aade4a860ac3"+ },+ {+ "name": "semver-compare",+ "version": "1.0.0",+ "digest": "sha256:fc913ea3bc4d170b92adfc1e71b75139dd3ff9f39ca46c6e5356b37d6c1f32b5"+ },+ {+ "name": "semver",+ "version": "7.8.5",+ "digest": "sha256:ef73ed8133cddb85ccddd94ef34bb01bb417b4e184747774f30c78c319c84ccc"+ },+ {+ "name": "serialize-error",+ "version": "7.0.1",+ "digest": "sha256:77c0f2fdbcaca5ab782715da3396a6fecb61fda30844daacaeec05d33c2d113e"+ },+ {+ "name": "sharp",+ "version": "0.35.3",+ "digest": "sha256:b943672e75a83d4ce475cfe16c407972840d29dbcc2c9edf8d28511eddd0f996"+ },+ {+ "name": "source-map-js",+ "version": "1.2.1",+ "digest": "sha256:76abd20d0fd81fc684e8b3c0e41177269f09197dea71fa1d50a0364fa280acda"+ },+ {+ "name": "sprintf-js",+ "version": "1.1.3",+ "digest": "sha256:883f379f24694afcb093f47aaafadec3ca1065af1ae652c364a3d7bf25bc9e0c"+ },+ {+ "name": "string-width",+ "version": "7.2.0",+ "digest": "sha256:b85382c244e9fc739740d7bfdca4b539778bf65e713907ea6d3c6d07e4103717"+ },+ {+ "name": "string-width",+ "version": "8.2.2",+ "digest": "sha256:c36ee62911778723e34c511189e61080c218ccb11f4d64b0d6b8d9efb6aa5c10"+ },+ {+ "name": "strip-ansi",+ "version": "7.2.0",+ "digest": "sha256:9bfa39730e152200258d6623078e19aff00644acc6459ecf20aacfc8bc63fa6c"+ },+ {+ "name": "tar",+ "version": "7.5.22",+ "digest": "sha256:8285067e1b8a820fecc8a03b20a9904a288e5d298ba928b4b377edb9b3ef0a41"+ },+ {+ "name": "tiny-inflate",+ "version": "1.0.3",+ "digest": "sha256:fcb3bb3ffe45f8dc5844f3e2c80f06ce91f60866813679d0735de089e09ca233"+ },+ {+ "name": "tslib",+ "version": "2.8.1",+ "digest": "sha256:2db6bb6e55b98eedaeb183f273e1b7fad3c08de082494bf8e8fbc3d4599e8dcb"+ },+ {+ "name": "type-fest",+ "version": "0.13.1",+ "digest": "sha256:31da441957382bff5162a9d6ffdfeb100dce2436a07278ca92743c313d228389"+ },+ {+ "name": "typed-query-selector",+ "version": "2.12.2",+ "digest": "sha256:6aff4c63a83048d09bec7d3702255d5eafbac4a966590f1917c51e7032f69369"+ },+ {+ "name": "undici-types",+ "version": "7.16.0",+ "digest": "sha256:869dec90f6b507a2d71916dbc8d4ef3d75c0dd8d4066548bfbe8d77cc41315bb"+ },+ {+ "name": "unicode-properties",+ "version": "1.4.1",+ "digest": "sha256:a48f8ca2a9a65b41b892be726a9c760d57cef21e60888238744a446727adcf20"+ },+ {+ "name": "unicode-trie",+ "version": "2.0.0",+ "digest": "sha256:0f4491fc7a325bc7399549046667da7c336ad0cf2b5999fcab1650757d2858e4"+ },+ {+ "name": "web-streams-polyfill",+ "version": "3.3.3",+ "digest": "sha256:8cd5924d7a979dfe8364c3261be7293152443167076fa5f170564e6a3222af13"+ },+ {+ "name": "webdriver-bidi-protocol",+ "version": "0.4.2",+ "digest": "sha256:ab82a782e1679affa6248e33acbe4fd1e0651a9eaa9e34d4469a913df64a3ff3"+ },+ {+ "name": "wrap-ansi",+ "version": "9.0.2",+ "digest": "sha256:d2622e49ecb221d551ea0069ffeb684c7c2d4115401d021bfee3e51d89c7eabd"+ },+ {+ "name": "ws",+ "version": "8.21.1",+ "digest": "sha256:484620e51cb5015d111e52294ed54dcfd66ed3284999fc16093a35d58a0af996"+ },+ {+ "name": "wsl-utils",+ "version": "0.1.0",+ "digest": "sha256:b236cc5813fd4493aa17be0792e3b180df65a4ea3907da05dd799bb15804e4fb"+ },+ {+ "name": "y18n",+ "version": "5.0.8",+ "digest": "sha256:54af894eda0fbc193d9e5d289a7af3631dafe2f5fcff4f060e2c9a2c2cb798bf"+ },+ {+ "name": "yallist",+ "version": "5.0.0",+ "digest": "sha256:406bf2ad99d27deda9d73249b4ecacc1bee1a45f33afdf2cd648fe6725207326"+ },+ {+ "name": "yargs-parser",+ "version": "22.0.0",+ "digest": "sha256:ad4401f08168f7c51334eb97b13667bdd3b480c0aa39adc76c3e73e893af82b6"+ },+ {+ "name": "yargs",+ "version": "18.1.0",+ "digest": "sha256:1a9af827f13ab17a8a1a9375359cfdfac0ea7ffd4230ca62b80c300d5c2bf523"+ },+ {+ "name": "zod",+ "version": "3.25.76",+ "digest": "sha256:7c6dc5843a1ea330f776a13cf573ed8f41718bb461bb15fa071ec1abcd801e63"+ }+ ],+ "packages": [+ {+ "specifier": "@svml/provider-google-vertex",+ "package": {+ "name": "@svml/provider-google-vertex",+ "version": "0.0.0-dev"+ },+ "facetsDigest": "sha256:a1fe53038e8c6c126a1325f15a23061263d85ea4ff7067e36fb9855e77cf4a40",+ "closureDigest": "sha256:f52118471c8005e5b78b4d6b58def15de565e26b802483caa78575f7f4537a87"+ },+ {+ "specifier": "@svml/provider-hyperframes-local",+ "package": {+ "name": "@svml/provider-hyperframes-local",+ "version": "0.0.0-dev"+ },+ "facetsDigest": "sha256:6dbd880063eb20cfd7e1eee749184c1935c353a0cdb732b188508a2410e04eb2",+ "closureDigest": "sha256:b17bb01d3712c7b752bff5f859444abf65e1f57509c1b9af4c5b1da2a86a788d"+ },+ {+ "specifier": "@svml/provider-kie",+ "package": {+ "name": "@svml/provider-kie",+ "version": "0.0.0-dev"+ },+ "facetsDigest": "sha256:bfdc56dd5b01deb5da2c8cfe20e039387b0a9ffb1ce66fceae11378f28cb1bdb",+ "closureDigest": "sha256:c35c1115436a626ae1b648bf18ccb70a3890953e3a8214137e1c40c1d1ab4463"+ },+ {+ "specifier": "@svml/provider-media-local",+ "package": {+ "name": "@svml/provider-media-local",+ "version": "0.0.0-dev"+ },+ "facetsDigest": "sha256:e232139c8339387f3404c29d9ea0829b7be78fb742ee48671727d9c7f899a30b",+ "closureDigest": "sha256:45ce17eb0c224ff87017d88e25d2db3ed1a9458757f083432a9ee5db52673d2c"+ },+ {+ "specifier": "@svml/provider-whisperx-local",+ "package": {+ "name": "@svml/provider-whisperx-local",+ "version": "0.0.0-dev"+ },+ "facetsDigest": "sha256:8a1b222a41c2b8a119c973c783f14efb103745f3ff960c1d8f04aaff534918c9",+ "closureDigest": "sha256:898c6e19d015b7958e589673caf895ded9e948bab62465435e293d3133dd7e54"+ }+ ],+ "digest": "sha256:7e91e3d4d3f3c92f6f4dbd10fb871d635287a7c6ad94d5e69892628bb1f1f991"+}diff --git a/examples/talking-film-live/svml.runtime.json b/examples/talking-film-live/svml.runtime.jsonindex 0436abb8..505c61ee 100644--- a/examples/talking-film-live/svml.runtime.json+++ b/examples/talking-film-live/svml.runtime.json@@ -1,6 +1,7 @@{"format": "svml.runtime-config@1","packageLock": "./svml.packages.lock",+ "runtimePackageLock": "./svml.runtime-packages.lock","services": [],"endpoints": [{diff --git a/package.json b/package.jsonindex 66b5287c..eb58370a 100644--- a/package.json+++ b/package.json@@ -15,6 +15,7 @@"test:v1": "node --import tsx --test 'test/**/*.test.ts'","test:v2": "node --import tsx --test 'packages/*/test/**/*.test.ts' 'tools/*.test.mjs'","test:whisperx-service": "uv run --project services/whisperx --frozen python -m unittest discover -s services/whisperx/tests -p 'test_*.py'",+ "test:image-opencv": "SVML_OPENCV_TESTS=1 SVML_OPENCV_PYTHON=services/image-opencv/.venv/bin/python node --import tsx --test packages/provider-image-opencv-local/test/provider.test.ts","smoke:kie": "node --import tsx packages/provider-kie/test/live-smoke.ts","svml": "node --import tsx src/cli.ts","svml:v2": "node --import tsx packages/video-cli/src/cli.ts"@@ -43,16 +44,20 @@"@svml/generation": "workspace:*","@svml/hyperframes": "workspace:*","@svml/hyperframes-render": "workspace:*",+ "@svml/image-transform": "workspace:*","@svml/local": "workspace:*","@svml/media": "workspace:*","@svml/media-pipeline": "workspace:*","@svml/prompt-kit": "workspace:*","@svml/provider-google-vertex": "workspace:*","@svml/provider-hyperframes-local": "workspace:*",+ "@svml/provider-image-opencv-local": "workspace:*","@svml/provider-kie": "workspace:*","@svml/provider-media-local": "workspace:*","@svml/provider-whisperx-local": "workspace:*","@svml/run-text": "workspace:*",+ "@svml/runtime-adapter": "workspace:*",+ "@svml/runtime-adapter-node": "workspace:*","@svml/script": "workspace:*","@svml/seedance": "workspace:*","@svml/seedance-speaker": "workspace:*",diff --git a/packages/artifact-store-fs/src/store.ts b/packages/artifact-store-fs/src/store.tsindex 0ebf4e08..79339178 100644--- a/packages/artifact-store-fs/src/store.ts+++ b/packages/artifact-store-fs/src/store.ts@@ -1,5 +1,12 @@-import { createHash } from "node:crypto";-import { mkdir, readFile, writeFile } from "node:fs/promises";+import { createHash, randomUUID } from "node:crypto";+import {+ link,+ mkdir,+ open as openFile,+ readdir,+ stat,+ unlink,+} from "node:fs/promises";import { dirname, join, resolve } from "node:path";import { digestOf, isDigest } from "@svml/protocol";@@ -42,36 +49,139 @@ export class FileArtifactStore implements ArtifactStore {}async put(bytes: Uint8Array, mediaType: string): Promise<BlobRef> {- if (mediaType.trim().length === 0) throw new Error("Artifact mediaType must not be empty");const copy = Uint8Array.from(bytes);- const digest = `sha256:${createHash("sha256").update(copy).digest("hex")}` as Digest;+ return await this.putStream((async function* () { yield copy; })(), mediaType);+ }++ async putStream(chunks: AsyncIterable<Uint8Array>, mediaType: string): Promise<BlobRef> {+ if (mediaType.trim().length === 0) throw new Error("Artifact mediaType must not be empty");+ const incoming = join(this.root, ".incoming");+ await mkdir(incoming, { recursive: true });+ const temporary = join(incoming, randomUUID());+ const handle = await openFile(temporary, "wx");+ const hash = createHash("sha256");+ let size = 0;+ try {+ try {+ for await (const value of chunks) {+ if (!(value instanceof Uint8Array)) throw new Error("Artifact stream yielded non-bytes");+ const chunk = Uint8Array.from(value);+ hash.update(chunk);+ size += chunk.byteLength;+ if (!Number.isSafeInteger(size)) throw new Error("Artifact stream exceeds the supported size");+ let offset = 0;+ while (offset < chunk.byteLength) {+ const written = await handle.write(chunk, offset, chunk.byteLength - offset);+ offset += written.bytesWritten;+ }+ }+ } finally {+ await handle.close();+ }+ } catch (error) {+ await unlink(temporary).catch(() => undefined);+ throw error;+ }+ const digest = `sha256:${hash.digest("hex")}` as Digest;const path = digestPath(this.root, digest);await mkdir(dirname(path), { recursive: true });try {- await writeFile(path, copy, { flag: "wx" });+ await link(temporary, path);} catch (error) {- if (!isNodeError(error, "EEXIST")) throw error;- // Existing content is not trusted merely because its path has the requested digest.- await this.get(digest);+ if (!isNodeError(error, "EEXIST")) {+ await unlink(temporary).catch(() => undefined);+ throw error;+ }}- return { kind: "blob", digest, size: copy.byteLength, mediaType };+ await unlink(temporary).catch(() => undefined);+ if ((await this.get(digest)) === undefined) {+ throw new Error(`Artifact ${digest} disappeared after storage`);+ }+ return { kind: "blob", digest, size, mediaType };}async get(digest: Digest): Promise<Uint8Array | undefined> {+ const stream = await this.open(digest);+ if (stream === undefined) return undefined;+ const chunks: Uint8Array[] = [];+ let size = 0;+ for await (const chunk of stream) {+ chunks.push(chunk);+ size += chunk.byteLength;+ }+ const bytes = new Uint8Array(size);+ let offset = 0;+ for (const chunk of chunks) {+ bytes.set(chunk, offset);+ offset += chunk.byteLength;+ }+ return bytes;+ }++ async open(digest: Digest): Promise<AsyncIterable<Uint8Array> | undefined> {+ const path = digestPath(this.root, digest);try {- const bytes = Uint8Array.from(await readFile(digestPath(this.root, digest)));- const actual = `sha256:${createHash("sha256").update(bytes).digest("hex")}`;- if (actual !== digest) throw new Error(`Artifact ${digest} content digest differs`);- return bytes;+ if (!(await stat(path)).isFile()) throw new Error(`Artifact ${digest} is not a file`);} catch (error) {if (isNodeError(error, "ENOENT")) return undefined;throw error;}+ return (async function* () {+ const handle = await openFile(path, "r");+ const hash = createHash("sha256");+ try {+ const buffer = new Uint8Array(1024 * 1024);+ let position = 0;+ while (true) {+ const result = await handle.read(buffer, 0, buffer.byteLength, position);+ if (result.bytesRead === 0) break;+ position += result.bytesRead;+ const chunk = buffer.slice(0, result.bytesRead);+ hash.update(chunk);+ yield chunk;+ }+ } finally {+ await handle.close();+ }+ const actual = `sha256:${hash.digest("hex")}`;+ if (actual !== digest) throw new Error(`Artifact ${digest} content digest differs`);+ })();}async has(digest: Digest): Promise<boolean> {return (await this.get(digest)) !== undefined;}++ async list(): Promise<readonly Digest[]> {+ const algorithm = join(this.root, "sha256");+ let prefixes;+ try {+ prefixes = await readdir(algorithm, { withFileTypes: true });+ } catch (error) {+ if (isNodeError(error, "ENOENT")) return [];+ throw error;+ }+ const digests: Digest[] = [];+ for (const prefix of prefixes) {+ if (!prefix.isDirectory() || !/^[0-9a-f]{2}$/u.test(prefix.name)) continue;+ for (const entry of await readdir(join(algorithm, prefix.name), { withFileTypes: true })) {+ if (entry.isFile() && /^[0-9a-f]{64}$/u.test(entry.name) && entry.name.startsWith(prefix.name)) {+ digests.push(`sha256:${entry.name}` as Digest);+ }+ }+ }+ return digests.sort();+ }++ async delete(digest: Digest): Promise<boolean> {+ try {+ await unlink(digestPath(this.root, digest));+ return true;+ } catch (error) {+ if (isNodeError(error, "ENOENT")) return false;+ throw error;+ }+ }}export function createFileArtifactStorePackage(diff --git a/packages/artifact-store-fs/test/store.test.ts b/packages/artifact-store-fs/test/store.test.tsindex 67855519..ea622af2 100644--- a/packages/artifact-store-fs/test/store.test.ts+++ b/packages/artifact-store-fs/test/store.test.ts@@ -27,3 +27,25 @@ test("filesystem artifacts are content-addressed and survive adapter restart", aawait rm(directory, { recursive: true, force: true });}});++test("filesystem artifacts expose optional streaming and explicit retention capabilities", async () => {+ const directory = await mkdtemp(join(tmpdir(), "svml-artifacts-stream-"));+ try {+ const store = new FileArtifactStore(directory);+ const artifact = await store.putStream((async function* () {+ yield new TextEncoder().encode("streamed ");+ yield new TextEncoder().encode("artifact");+ })(), "application/octet-stream");+ assert.deepEqual(await store.list(), [artifact.digest]);+ const opened = await store.open(artifact.digest);+ assert.notEqual(opened, undefined);+ const values: number[] = [];+ for await (const chunk of opened!) values.push(...chunk);+ assert.equal(new TextDecoder().decode(Uint8Array.from(values)), "streamed artifact");+ assert.equal(await store.delete(artifact.digest), true);+ assert.equal(await store.delete(artifact.digest), false);+ assert.deepEqual(await store.list(), []);+ } finally {+ await rm(directory, { recursive: true, force: true });+ }+});diff --git a/packages/artifact-store-s3/package.json b/packages/artifact-store-s3/package.jsonindex eb550da9..a379a4e7 100644--- a/packages/artifact-store-s3/package.json+++ b/packages/artifact-store-s3/package.json@@ -6,9 +6,11 @@"exports": {".": "./src/index.ts"},+ "svml": { "activation": "./src/activation.ts" },"dependencies": {"@aws-sdk/client-s3": "^3.1103.0","@svml/protocol": "workspace:*",- "@svml/runtime": "workspace:*"+ "@svml/runtime": "workspace:*",+ "@svml/runtime-adapter": "workspace:*"}}diff --git a/packages/artifact-store-s3/src/activation.ts b/packages/artifact-store-s3/src/activation.tsnew file mode 100644index 00000000..6641bb1b--- /dev/null+++ b/packages/artifact-store-s3/src/activation.ts@@ -0,0 +1,43 @@+import {+ createRuntimeServiceAdapterFacet,+ runtimeConfigBoolean,+ runtimeConfigExact,+ runtimeConfigObject,+ runtimeConfigString,+} from "@svml/runtime-adapter";++import { createS3ArtifactStorePackage } from "./store.js";++const s3ArtifactStoreRuntimeAdapter = createRuntimeServiceAdapterFacet({+ use: "@svml/artifact-store-s3",+ create(context) {+ const config = runtimeConfigObject(context.config, "S3 ArtifactStore");+ runtimeConfigExact(config, [+ "bucket", "prefix", "expectedBucketOwner", "region", "endpoint", "forcePathStyle",+ ], "S3 ArtifactStore");+ const bucket = runtimeConfigString(config.bucket, "S3 bucket");+ if (bucket === undefined) throw new Error("S3 bucket is required");+ return createS3ArtifactStorePackage({+ instance: context.instance,+ bucket,+ ...(runtimeConfigString(config.prefix, "S3 prefix") === undefined+ ? {} : { prefix: config.prefix as string }),+ ...(runtimeConfigString(config.expectedBucketOwner, "S3 expectedBucketOwner") === undefined+ ? {} : { expectedBucketOwner: config.expectedBucketOwner as string }),+ ...(runtimeConfigString(config.region, "S3 region") === undefined+ ? {} : { region: config.region as string }),+ ...(runtimeConfigString(config.endpoint, "S3 endpoint") === undefined+ ? {} : { endpoint: config.endpoint as string }),+ ...(runtimeConfigBoolean(config.forcePathStyle, "S3 forcePathStyle") === undefined+ ? {} : { forcePathStyle: config.forcePathStyle as boolean }),+ });+ },+});++export const svmlPackage = {+ format: "svml.node-package@1" as const,+ name: "@svml/artifact-store-s3",+ hostFacets: [s3ArtifactStoreRuntimeAdapter],+};++export default svmlPackage;diff --git a/packages/broll/src/author.ts b/packages/broll/src/author.tsindex 12672ccf..082ea93c 100644--- a/packages/broll/src/author.ts+++ b/packages/broll/src/author.ts@@ -7,9 +7,10 @@ import {import type {CompleteSemanticMap,NarrativeSelectionRef,+ ProgramSpace,SynchronizedMedia,} from "@svml/contracts";-import { canonicalize, digestOf, isDigest } from "@svml/protocol";+import { canonicalize, digestOf } from "@svml/protocol";import { sealBrollProgram } from "./program.js";import type {@@ -22,81 +23,58 @@ import type {export const createBrollSetImplementationDigest = digestOf("@svml/broll/create-set@1");export const appendBrollItemImplementationDigest = digestOf("@svml/broll/append-item@1");export const finalizeBrollProgramImplementationDigest = digestOf("@svml/broll/finalize-program@1");-export const projectBrollProgramSpaceImplementationDigest = digestOf("@svml/broll/project-program-space@1");function assert(condition: unknown, message: string): asserts condition {if (!condition) throw new Error(message);}-export function projectBrollProgramSpace(map: CompleteSemanticMap) {- assertCompleteSemanticMapIdentity(map);- return map.programSpace;-}--export function sealBrollItemSpec(value: Omit<BrollItemSpec, "digest">): BrollItemSpec {- const content = canonicalize(value) as unknown as Omit<BrollItemSpec, "digest">;- return { ...content, digest: digestOf(content) };+export function sealBrollItemSpec(value: BrollItemSpec): BrollItemSpec {+ return canonicalize(value) as unknown as BrollItemSpec;}export function assertBrollItemSpec(value: BrollItemSpec): void {assert(value.contract === "svml.broll-item-spec@1" && value.id.length > 0, "BrollItemSpec identity is invalid");- const { digest: _digest, ...content } = value;- assert(isDigest(value.digest) && value.digest === digestOf(canonicalize(content)), "BrollItemSpec digest differs");assert(Number.isSafeInteger(value.z), "BrollItemSpec z must be an integer");assert(value.fit === "contain" || value.fit === "cover", "BrollItemSpec fit is invalid");}-export function sealBrollTrackSpec(value: Omit<BrollTrackSpec, "digest">): BrollTrackSpec {- const content = canonicalize(value) as unknown as Omit<BrollTrackSpec, "digest">;- return { ...content, digest: digestOf(content) };+export function sealBrollTrackSpec(value: BrollTrackSpec): BrollTrackSpec {+ return canonicalize(value) as unknown as BrollTrackSpec;}function assertBrollTrackSpec(value: BrollTrackSpec): void {- const { digest: _digest, ...content } = value;- assert(value.contract === "svml.broll-track-spec@1" && value.id.length > 0- && isDigest(value.digest) && value.digest === digestOf(canonicalize(content)), "BrollTrackSpec is invalid");-}--function setContent(value: Omit<BrollSet, "digest">): Omit<BrollSet, "digest"> {- return canonicalize(value) as unknown as Omit<BrollSet, "digest">;-}--function sealSet(value: Omit<BrollSet, "digest">): BrollSet {- const content = setContent(value);- return { ...content, digest: digestOf(content) };+ assert(value.contract === "svml.broll-track-spec@1" && value.id.length > 0, "BrollTrackSpec is invalid");}export function assertBrollSet(value: BrollSet): void {- assert(value.contract === "svml.broll-set@1" && value.id.length > 0, "BrollSet identity is invalid");- assertCompleteSemanticMapIdentity(value.map);- const { digest: _digest, ...content } = value;- assert(isDigest(value.digest) && value.digest === digestOf(setContent(content)), "BrollSet digest differs");- assert(value.items.length === 0 ? value.lastAddition === undefined : value.lastAddition !== undefined,- "BrollSet last addition is inconsistent");+ assert(value.contract === "svml.broll-set@1", "BrollSet is invalid");}-export function createBrollSet(map: CompleteSemanticMap, spec: BrollTrackSpec): BrollSet {- assertCompleteSemanticMapIdentity(map);- assertBrollTrackSpec(spec);- return sealSet({ contract: "svml.broll-set@1", id: spec.id, map, items: [] });+export function createBrollSet(): BrollSet {+ return { contract: "svml.broll-set@1", items: [] };}export function appendBrollItem(set: BrollSet,+ track: BrollTrackSpec,+ map: CompleteSemanticMap,+ programSpace: ProgramSpace,media: SynchronizedMedia,selection: NarrativeSelectionRef,spec: BrollItemSpec,): BrollSet {assertBrollSet(set);+ assertBrollTrackSpec(track);+ assertCompleteSemanticMapIdentity(map);verifySynchronizedMedia(media);assertNarrativeSelectionIdentity(selection);assertBrollItemSpec(spec);assert(media.visual !== undefined, `B-roll ${spec.id} source has no visual stream`);- assert(media.timeline.frameRate.numerator === set.map.programSpace.frameRate.numerator- && media.timeline.frameRate.denominator === set.map.programSpace.frameRate.denominator,+ assert(media.timeline.frameRate.numerator === programSpace.frameRate.numerator+ && media.timeline.frameRate.denominator === programSpace.frameRate.denominator,`B-roll ${spec.id} media uses another frame rate`);const durationSec = media.timeline.frameCount * media.timeline.frameRate.denominator / media.timeline.frameRate.numerator;- const additions = selectionFrameSpans(set.map, selection).map((span, index) => {+ const additions = selectionFrameSpans(map, selection, programSpace).map((span, index) => {return {id: selection.occurrences.length === 1 ? spec.id : `${spec.id}:${index + 1}`,artifact: {@@ -107,7 +85,7 @@ export function appendBrollItem(},span,z: spec.z,- tieBreak: `${set.id}:${spec.id}:${index + 1}`,+ tieBreak: `${track.id}:${spec.id}:${index + 1}`,box: spec.box,fit: spec.fit,playback: "stretch" as const,@@ -117,27 +95,19 @@ export function appendBrollItem(...(spec.exit === undefined ? {} : { exit: spec.exit }),};});- return sealSet({+ return {contract: "svml.broll-set@1",- id: set.id,- map: set.map,items: [...set.items, ...additions],- lastAddition: {- previousSetDigest: set.digest,- mediaDigest: media.synchronizedMediaDigest,- selectionDigest: selection.selectionDigest,- specDigest: spec.digest,- },- });+ };}-export function finalizeBrollProgram(set: BrollSet): BrollProgram {+export function finalizeBrollProgram(set: BrollSet, track: BrollTrackSpec): BrollProgram {assertBrollSet(set);+ assertBrollTrackSpec(track);assert(set.items.length > 0, "B-roll Track requires at least one Item");return sealBrollProgram({contract: "svml.broll-program@1",- id: set.id,- programSpaceDigest: set.map.programSpace.digest,+ id: track.id,items: set.items,transitions: [],});diff --git a/packages/broll/src/component.ts b/packages/broll/src/component.tsindex ed627982..f487320d 100644--- a/packages/broll/src/component.ts+++ b/packages/broll/src/component.ts@@ -12,8 +12,6 @@ import {createBrollSetImplementationDigest,finalizeBrollProgram,finalizeBrollProgramImplementationDigest,- projectBrollProgramSpace,- projectBrollProgramSpaceImplementationDigest,} from "./author.js";import {compileBrollImplementationDigest,@@ -33,23 +31,11 @@ function inline<T>(value: StoredValue | undefined, subject: string): T {export const brollComponent = {name: "@svml/broll",producers: [- {- producer: brollProducers.projectSpace,- implementationDigest: projectBrollProgramSpaceImplementationDigest,- handler: ({ inputs }) => ({- outputs: { space: { kind: "inline", value: canonicalize(projectBrollProgramSpace(- inline<CompleteSemanticMap>(inputs.map?.value, "CompleteSemanticMap"),- )) } }, needs: {},- }),- },{producer: brollProducers.createSet,implementationDigest: createBrollSetImplementationDigest,- handler: ({ inputs }) => ({- outputs: { set: { kind: "inline", value: canonicalize(createBrollSet(- inline<CompleteSemanticMap>(inputs.map?.value, "CompleteSemanticMap"),- inline<BrollTrackSpec>(inputs.spec?.value, "BrollTrackSpec"),- )) } }, needs: {},+ handler: () => ({+ outputs: { set: { kind: "inline", value: canonicalize(createBrollSet()) } }, needs: {},}),},{@@ -58,6 +44,9 @@ export const brollComponent = {handler: ({ inputs }) => ({outputs: { set: { kind: "inline", value: canonicalize(appendBrollItem(inline<BrollSet>(inputs.set?.value, "BrollSet"),+ inline<BrollTrackSpec>(inputs.track?.value, "BrollTrackSpec"),+ inline<CompleteSemanticMap>(inputs.map?.value, "CompleteSemanticMap"),+ inline<ProgramSpace>(inputs.space?.value, "ProgramSpace"),inline<SynchronizedMedia>(inputs.media?.value, "SynchronizedMedia"),inline<NarrativeSelectionRef>(inputs.selection?.value, "NarrativeSelection"),inline<BrollItemSpec>(inputs.spec?.value, "BrollItemSpec"),@@ -70,6 +59,7 @@ export const brollComponent = {handler: ({ inputs }) => ({outputs: { program: { kind: "inline", value: canonicalize(finalizeBrollProgram(inline<BrollSet>(inputs.set?.value, "BrollSet"),+ inline<BrollTrackSpec>(inputs.track?.value, "BrollTrackSpec"),)) } }, needs: {},}),},diff --git a/packages/broll/src/index.ts b/packages/broll/src/index.tsindex 7dd9db8d..4a24edf3 100644--- a/packages/broll/src/index.ts+++ b/packages/broll/src/index.ts@@ -3,8 +3,6 @@ export {assertBrollProgramIdentity,compileBrollImplementationDigest,compileBrollProduct,- computeBrollProductDigest,- computeBrollProgramDigest,projectBrollAudio,projectBrollAudioImplementationDigest,projectBrollVisual,@@ -21,8 +19,6 @@ export {createBrollSetImplementationDigest,finalizeBrollProgram,finalizeBrollProgramImplementationDigest,- projectBrollProgramSpace,- projectBrollProgramSpaceImplementationDigest,sealBrollItemSpec,sealBrollTrackSpec,} from "./author.js";diff --git a/packages/broll/src/manifest.ts b/packages/broll/src/manifest.tsindex 775c8fdd..70961676 100644--- a/packages/broll/src/manifest.ts+++ b/packages/broll/src/manifest.ts@@ -1,11 +1,9 @@import { artifactDependency } from "@svml/artifact";import {audioTrackSchema,- completeSemanticMapSchema,contractTypes,mediaArtifactSchema,narrativeSelectionSchema,- programSpaceSchema,synchronizedMediaSchema,videoContractDependencies,visualTrackSchema,@@ -19,7 +17,6 @@ import {appendBrollItemImplementationDigest,createBrollSetImplementationDigest,finalizeBrollProgramImplementationDigest,- projectBrollProgramSpaceImplementationDigest,} from "./author.js";import {@@ -40,7 +37,6 @@ export const brollProducers = {createSet: { module: brollModuleRef, name: "create-broll-set" },appendItem: { module: brollModuleRef, name: "append-broll-item" },finalize: { module: brollModuleRef, name: "finalize-broll-program" },- projectSpace: { module: brollModuleRef, name: "project-broll-program-space" },compile: { module: brollModuleRef, name: "compile-broll" },projectVisual: { module: brollModuleRef, name: "project-broll-visual" },projectAudio: { module: brollModuleRef, name: "project-broll-audio" },@@ -50,7 +46,6 @@ const string = { kind: "string", minLength: 1 } as const;const number = { kind: "number" } as const;const unsignedInteger = { kind: "number", integer: true, minimum: 0 } as const;const signedInteger = { kind: "number", integer: true } as const;-const digest = { kind: "string", minLength: 71, maxLength: 71 } as const;const object = (fields: Readonly<Record<string, { readonly schema: ValueSchema; readonly optional?: boolean }>>): ValueSchema => ({kind: "object",fields,@@ -90,7 +85,6 @@ const item = object({});const itemSpec = object({contract: { schema: { kind: "literal", value: "svml.broll-item-spec@1" } },- digest: { schema: digest },id: { schema: string },z: { schema: signedInteger },box: { schema: box },@@ -115,37 +109,25 @@ const transition = object({export const brollProgramSchema: ValueSchema = object({contract: { schema: { kind: "literal", value: "svml.broll-program@1" } },- digest: { schema: digest },id: { schema: string },- programSpaceDigest: { schema: digest },items: { schema: { kind: "array", minItems: 1, items: item } },transitions: { schema: { kind: "array", items: transition } },});export const brollProductSchema: ValueSchema = object({contract: { schema: { kind: "literal", value: "svml.broll-product@1" } },- productDigest: { schema: digest },- programSpace: { schema: programSpaceSchema },visualTrack: { schema: visualTrackSchema },audioTrack: { schema: audioTrackSchema },});export const brollTrackSpecSchema: ValueSchema = object({contract: { schema: { kind: "literal", value: "svml.broll-track-spec@1" } },- digest: { schema: digest },id: { schema: string },});export const brollItemSpecSchema: ValueSchema = itemSpec;export const brollSetSchema: ValueSchema = object({contract: { schema: { kind: "literal", value: "svml.broll-set@1" } },- digest: { schema: digest },- id: { schema: string },- map: { schema: completeSemanticMapSchema },items: { schema: { kind: "array", items: item } },- lastAddition: { schema: object({- previousSetDigest: { schema: digest }, mediaDigest: { schema: digest },- selectionDigest: { schema: digest }, specDigest: { schema: digest },- }), optional: true },});export const brollSurfaceImplementationDigest = digestOf("@svml/broll/track-surface@1");@@ -179,20 +161,9 @@ export const brollManifest: ModuleManifest = {implementation: { kind: "trusted-frontend-surface", locator: "@svml/broll/track-surface", digest: brollSurfaceImplementationDigest },}],producers: [- {- name: brollProducers.projectSpace.name,- inputs: [{ name: "map", type: contractTypes.completeSemanticMap }],- outputs: [{ name: "space", type: contractTypes.programSpace, affinity: [- { resultPointer: "/digest", input: "map", inputPointer: "/programSpace/digest" },- ] }], needs: [],- implementation: { kind: "registered", locator: "@svml/broll/project-program-space", digest: projectBrollProgramSpaceImplementationDigest },- },{name: brollProducers.createSet.name,- inputs: [- { name: "map", type: contractTypes.completeSemanticMap },- { name: "spec", type: brollTypes.trackSpec },- ],+ inputs: [],outputs: [{ name: "set", type: brollTypes.set }], needs: [],implementation: { kind: "registered", locator: "@svml/broll/create-set", digest: createBrollSetImplementationDigest },},@@ -200,24 +171,23 @@ export const brollManifest: ModuleManifest = {name: brollProducers.appendItem.name,inputs: [{ name: "set", type: brollTypes.set },+ { name: "track", type: brollTypes.trackSpec },+ { name: "map", type: contractTypes.completeSemanticMap },+ { name: "space", type: contractTypes.programSpace },{ name: "media", type: contractTypes.synchronizedMedia },{ name: "selection", type: contractTypes.narrativeSelection },{ name: "spec", type: brollTypes.itemSpec },],- outputs: [{ name: "set", type: brollTypes.set, affinity: [- { resultPointer: "/lastAddition/previousSetDigest", input: "set", inputPointer: "/digest" },- { resultPointer: "/lastAddition/mediaDigest", input: "media", inputPointer: "/synchronizedMediaDigest" },- { resultPointer: "/lastAddition/selectionDigest", input: "selection", inputPointer: "/selectionDigest" },- { resultPointer: "/lastAddition/specDigest", input: "spec", inputPointer: "/digest" },- ] }], needs: [],+ outputs: [{ name: "set", type: brollTypes.set }], needs: [],implementation: { kind: "registered", locator: "@svml/broll/append-item", digest: appendBrollItemImplementationDigest },},{name: brollProducers.finalize.name,- inputs: [{ name: "set", type: brollTypes.set }],- outputs: [{ name: "program", type: brollTypes.program, affinity: [- { resultPointer: "/programSpaceDigest", input: "set", inputPointer: "/map/programSpace/digest" },- ] }], needs: [],+ inputs: [+ { name: "set", type: brollTypes.set },+ { name: "track", type: brollTypes.trackSpec },+ ],+ outputs: [{ name: "program", type: brollTypes.program }], needs: [],implementation: { kind: "registered", locator: "@svml/broll/finalize-program", digest: finalizeBrollProgramImplementationDigest },},{@@ -226,13 +196,7 @@ export const brollManifest: ModuleManifest = {{ name: "space", type: contractTypes.programSpace },{ name: "program", type: brollTypes.program },],- outputs: [{- name: "product",- type: brollTypes.product,- affinity: [- { resultPointer: "/programSpace/digest", input: "space", inputPointer: "/digest" },- ],- }],+ outputs: [{ name: "product", type: brollTypes.product }],needs: [],implementation: {kind: "registered",@@ -243,13 +207,7 @@ export const brollManifest: ModuleManifest = {{name: brollProducers.projectVisual.name,inputs: [{ name: "product", type: brollTypes.product }],- outputs: [{- name: "visual",- type: contractTypes.visualTrack,- affinity: [- { resultPointer: "/programSpaceDigest", input: "product", inputPointer: "/programSpace/digest" },- ],- }],+ outputs: [{ name: "visual", type: contractTypes.visualTrack }],needs: [],implementation: {kind: "registered",@@ -260,13 +218,7 @@ export const brollManifest: ModuleManifest = {{name: brollProducers.projectAudio.name,inputs: [{ name: "product", type: brollTypes.product }],- outputs: [{- name: "audio",- type: contractTypes.audioTrack,- affinity: [- { resultPointer: "/programSpaceDigest", input: "product", inputPointer: "/programSpace/digest" },- ],- }],+ outputs: [{ name: "audio", type: contractTypes.audioTrack }],needs: [],implementation: {kind: "registered",diff --git a/packages/broll/src/program.ts b/packages/broll/src/program.tsindex 95661b34..8c57e4be 100644--- a/packages/broll/src/program.ts+++ b/packages/broll/src/program.ts@@ -15,7 +15,6 @@ import type {VisualStyleDeclaration,} from "@svml/contracts";import { digestOf, isDigest } from "@svml/protocol";-import type { Digest } from "@svml/protocol";import type {BrollItem,@@ -41,23 +40,17 @@ type StateMark = MotionState & {const STABLE: MotionState = { opacity: 1, transform: "translate3d(0%,0%,0) scale(1) rotateX(0deg) rotateY(0deg)" };-function normalizeProgram(value: Omit<BrollProgram, "digest">): Omit<BrollProgram, "digest"> {+function normalizeProgram(value: BrollProgram): BrollProgram {return {contract: "svml.broll-program@1",id: value.id,- programSpaceDigest: value.programSpaceDigest,items: [...value.items].map((item) => structuredClone(item)).sort((left, right) => left.id.localeCompare(right.id)),transitions: [...value.transitions].map((transition) => structuredClone(transition)).sort((left, right) => left.id.localeCompare(right.id)),};}-export function computeBrollProgramDigest(value: Omit<BrollProgram, "digest">): Digest {- return digestOf(normalizeProgram(value));-}--export function sealBrollProgram(value: Omit<BrollProgram, "digest">): BrollProgram {- const content = normalizeProgram(value);- return { ...content, digest: digestOf(content) };+export function sealBrollProgram(value: BrollProgram): BrollProgram {+ return normalizeProgram(value);}function assertArtifact(artifact: MediaArtifactRef, label: string, kinds: readonly string[]): void {@@ -190,11 +183,7 @@ function transitionMaps(program: BrollProgram, totalFrames: number) {export function assertBrollProgramIdentity(program: BrollProgram, programSpace: ProgramSpace): void {assertProgramSpaceIdentity(programSpace);if (program.contract !== "svml.broll-program@1") throw new Error("Unsupported BrollProgram contract.");- if (!program.id || program.programSpaceDigest !== programSpace.digest) throw new Error("BrollProgram identity or ProgramSpace affinity is invalid.");- const { digest: _digest, ...content } = program;- if (!isDigest(program.digest) || program.digest !== computeBrollProgramDigest(content)) {- throw new Error("BrollProgram digest does not match its contents.");- }+ if (!program.id) throw new Error("BrollProgram identity is invalid.");if (program.items.length === 0) throw new Error("BrollProgram must contain at least one item.");const totalFrames = programSpaceFrameCount(programSpace);const ids = new Set<string>();@@ -388,19 +377,14 @@ function audioClips(program: BrollProgram, programSpace: ProgramSpace): AudioClireturn clips;}-function productContent(value: Omit<BrollProduct, "productDigest">): Omit<BrollProduct, "productDigest"> {+function productContent(value: BrollProduct): BrollProduct {return {contract: "svml.broll-product@1",- programSpace: structuredClone(value.programSpace),visualTrack: structuredClone(value.visualTrack),audioTrack: structuredClone(value.audioTrack),};}-export function computeBrollProductDigest(value: Omit<BrollProduct, "productDigest">): Digest {- return digestOf(productContent(value));-}-export function compileBrollProduct(programSpace: ProgramSpace, program: BrollProgram): BrollProduct {assertBrollProgramIdentity(program, programSpace);const { incoming, outgoing } = transitionMaps(program, programSpaceFrameCount(programSpace));@@ -408,7 +392,6 @@ export function compileBrollProduct(programSpace: ProgramSpace, program: BrollPrcontract: "svml.visual-track@1",visualIr: "svml.hyperframes-visual-ir@1",id: `${program.id}:visual`,- programSpaceDigest: programSpace.digest,presents: program.items.map((item) => ({id: item.id,span: { ...item.span },@@ -419,51 +402,37 @@ export function compileBrollProduct(programSpace: ProgramSpace, program: BrollPrconst audioTrack = sealAudioTrack({contract: "svml.audio-track@1",id: `${program.id}:audio`,- programSpaceDigest: programSpace.digest,clips: audioClips(program, programSpace),});const content = productContent({contract: "svml.broll-product@1",- programSpace,visualTrack,audioTrack,});- const product = { ...content, productDigest: digestOf(content) };+ const product = content;assertBrollProductIdentity(product, programSpace);return product;}export function assertBrollProductIdentity(product: BrollProduct, programSpace: ProgramSpace): void {assertProgramSpaceIdentity(programSpace);- assertProgramSpaceIdentity(product.programSpace);if (product.contract !== "svml.broll-product@1") throw new Error("Unsupported BrollProduct contract.");- if (- product.programSpace.digest !== programSpace.digest- ) throw new Error("BrollProduct affinity is invalid.");- const { productDigest: _digest, ...content } = product;- if (!isDigest(product.productDigest) || product.productDigest !== computeBrollProductDigest(content)) {- throw new Error("BrollProduct digest does not match its contents.");- }assertVisualTrackIdentity(product.visualTrack, programSpace);assertAudioTrackIdentity(product.audioTrack, programSpace);}-function assertStandaloneProductDigest(product: BrollProduct): void {- const { productDigest: _digest, ...content } = product;- if (!isDigest(product.productDigest) || product.productDigest !== computeBrollProductDigest(content)) {- throw new Error("BrollProduct digest does not match its contents.");- }- assertProgramSpaceIdentity(product.programSpace);- assertVisualTrackIdentity(product.visualTrack, product.programSpace);- assertAudioTrackIdentity(product.audioTrack, product.programSpace);+function assertStandaloneProduct(product: BrollProduct): void {+ if (product.contract !== "svml.broll-product@1") throw new Error("Unsupported BrollProduct contract.");+ assertVisualTrackIdentity(product.visualTrack);+ assertAudioTrackIdentity(product.audioTrack);}export function projectBrollVisual(product: BrollProduct) {- assertStandaloneProductDigest(product);+ assertStandaloneProduct(product);return product.visualTrack;}export function projectBrollAudio(product: BrollProduct) {- assertStandaloneProductDigest(product);+ assertStandaloneProduct(product);return product.audioTrack;}diff --git a/packages/broll/src/surface.ts b/packages/broll/src/surface.tsindex 845ced9e..a0ab1980 100644--- a/packages/broll/src/surface.ts+++ b/packages/broll/src/surface.ts@@ -20,30 +20,30 @@ const operation = (id: string) => ({ kind: "fragment-operation" as const, operatfunction createBrollSurfaceFragment(items: readonly BrollSurfaceItemInput[], name: string) {const operations: FragmentOperation[] = [- { id: "broll:space", producer: brollProducers.projectSpace, inputs: { map: input("map") }, result: { kind: "output", name: "space" } },- { id: "broll:set:empty", producer: brollProducers.createSet, inputs: { map: input("map"), spec: input("track-spec") }, result: { kind: "output", name: "set" } },+ { id: "broll:set:empty", producer: brollProducers.createSet, inputs: {}, result: { kind: "output", name: "set" } },];let current = "broll:set:empty";items.forEach((item, index) => {const id = `broll:set:append:${String(index + 1).padStart(4, "0")}`;operations.push({id, producer: brollProducers.appendItem,- inputs: { set: operation(current), media: input(item.mediaName), selection: input(item.selectionName), spec: input(item.specName) },+ inputs: { set: operation(current), track: input("track-spec"), map: input("map"), space: input("space"), media: input(item.mediaName), selection: input(item.selectionName), spec: input(item.specName) },result: { kind: "output", name: "set" },});current = id;});operations.push(- { id: "broll:program", producer: brollProducers.finalize, inputs: { set: operation(current) }, result: { kind: "output", name: "program" } },- { id: "broll:product", producer: brollProducers.compile, inputs: { space: operation("broll:space"), program: operation("broll:program") }, result: { kind: "output", name: "product" } },+ { id: "broll:program", producer: brollProducers.finalize, inputs: { set: operation(current), track: input("track-spec") }, result: { kind: "output", name: "program" } },+ { id: "broll:product", producer: brollProducers.compile, inputs: { space: input("space"), program: operation("broll:program") }, result: { kind: "output", name: "product" } },{ id: "broll:visual", producer: brollProducers.projectVisual, inputs: { product: operation("broll:product") }, result: { kind: "output", name: "visual" } },{ id: "broll:audio", producer: brollProducers.projectAudio, inputs: { product: operation("broll:product") }, result: { kind: "output", name: "audio" } },);- const semanticInputs = ["map", "track-spec", ...items.flatMap((item) => [item.mediaName, item.selectionName, item.specName])];+ const semanticInputs = ["map", "space", "track-spec", ...items.flatMap((item) => [item.mediaName, item.selectionName, item.specName])];return sealGraphFragment({name,inputs: [{ name: "map", type: contractTypes.completeSemanticMap },+ { name: "space", type: contractTypes.programSpace },{ name: "track-spec", type: brollTypes.trackSpec },...items.flatMap((item) => [{ name: item.mediaName, type: contractTypes.synchronizedMedia },@@ -53,10 +53,8 @@ function createBrollSurfaceFragment(items: readonly BrollSurfaceItemInput[], nam],operations,exports: [- { name: "visual", type: contractTypes.visualTrack, root: operation("broll:visual"), semanticInputs,- affinity: [{ resultPointer: "/programSpaceDigest", source: input("map"), sourcePointer: "/programSpace/digest" }], fidelity: "exact" },- { name: "audio", type: contractTypes.audioTrack, root: operation("broll:audio"), semanticInputs,- affinity: [{ resultPointer: "/programSpaceDigest", source: input("map"), sourcePointer: "/programSpace/digest" }], fidelity: "exact" },+ { name: "visual", type: contractTypes.visualTrack, root: operation("broll:visual"), semanticInputs, fidelity: "exact" },+ { name: "audio", type: contractTypes.audioTrack, root: operation("broll:audio"), semanticInputs, fidelity: "exact" },],});}@@ -100,9 +98,10 @@ function motion(value: string): BrollMotion {}export const decodeBrollTrackSurface: StructuredSurfaceHandler = ({ element, resolveReference }) => {- exact(element, ["id", "map"]);+ exact(element, ["id", "map", "space"]);const id = text(element, "id");const map = ref(element, "map", contractTypes.completeSemanticMap, resolveReference);+ const space = ref(element, "space", contractTypes.programSpace, resolveReference);const trackSpecId = `${id}.spec`;const requestId = `${id}.selection`;const records: Array<{ id: string; type: typeof brollTypes.itemSpec | typeof brollTypes.trackSpec | typeof mediaPipelineTypes.selectionRequest; value: { kind: "inline"; value: ReturnType<typeof sealBrollItemSpec> | ReturnType<typeof sealBrollTrackSpec> | ReturnType<typeof sealMediaSelectionRequest> }; range: typeof element.range }> = [@@ -155,7 +154,7 @@ export const decodeBrollTrackSurface: StructuredSurfaceHandler = ({ element, rescomponents: [...normalization,{ id, fragment: fragment.id, inputs: {- map: map.ref, "track-spec": { kind: "record", id: trackSpecId },+ map: map.ref, space: space.ref, "track-spec": { kind: "record", id: trackSpecId },...Object.fromEntries(declared.flatMap((item, index) => [[item.input.mediaName, { kind: "component-output" as const, component: normalization[index]!.id, output: "media" }],[item.input.selectionName, item.selection.ref],diff --git a/packages/broll/src/types.ts b/packages/broll/src/types.tsindex 49bed3c8..97ce6023 100644--- a/packages/broll/src/types.ts+++ b/packages/broll/src/types.ts@@ -2,10 +2,8 @@ import type {AudioTrack,FrameSpan,MediaArtifactRef,- ProgramSpace,VisualTrack,} from "@svml/contracts";-import type { Digest } from "@svml/protocol";export type BrollBox = {readonly xPercent: number;@@ -57,9 +55,7 @@ export type BrollPairTransition = {/** Official B-roll authoring/lowering value. It is not a Core contract. */export type BrollProgram = {readonly contract: "svml.broll-program@1";- readonly digest: Digest;readonly id: string;- readonly programSpaceDigest: Digest;readonly items: readonly BrollItem[];readonly transitions: readonly BrollPairTransition[];};@@ -67,15 +63,12 @@ export type BrollProgram = {/** One atomic compilation result followed by ordinary deterministic projections. */export type BrollProduct = {readonly contract: "svml.broll-product@1";- readonly productDigest: Digest;- readonly programSpace: ProgramSpace;readonly visualTrack: VisualTrack;readonly audioTrack: AudioTrack;};export type BrollItemSpec = {readonly contract: "svml.broll-item-spec@1";- readonly digest: Digest;readonly id: string;readonly z: number;readonly box: BrollBox;@@ -88,22 +81,12 @@ export type BrollItemSpec = {export type BrollTrackSpec = {readonly contract: "svml.broll-track-spec@1";- readonly digest: Digest;readonly id: string;};export type BrollSet = {readonly contract: "svml.broll-set@1";- readonly digest: Digest;- readonly id: string;- readonly map: import("@svml/contracts").CompleteSemanticMap;readonly items: readonly BrollItem[];- readonly lastAddition?: {- readonly previousSetDigest: Digest;- readonly mediaDigest: Digest;- readonly selectionDigest: Digest;- readonly specDigest: Digest;- };};export type BrollSurfaceItemInput = {diff --git a/packages/broll/test/broll.test.ts b/packages/broll/test/broll.test.tsindex b84e6a5d..cf8e784d 100644--- a/packages/broll/test/broll.test.ts+++ b/packages/broll/test/broll.test.ts@@ -5,7 +5,6 @@ import {assertBrollProductIdentity,assertBrollProgramIdentity,compileBrollProduct,- computeBrollProductDigest,projectBrollAudio,projectBrollVisual,sealBrollProgram,@@ -45,7 +44,6 @@ function program(items: readonly BrollItem[], transitions: readonly BrollPairTrareturn sealBrollProgram({contract: "svml.broll-program@1",id: "story-broll",- programSpaceDigest: programSpace.digest,items,transitions,});@@ -87,7 +85,6 @@ test("B-roll owns local motion while every item remains an independently stackedcontract: "svml.visual-track@1",visualIr: "svml.hyperframes-visual-ir@1",id: "middle-overlay",- programSpaceDigest: programSpace.digest,presents: [{id: "middle",span: { startFrame: 0, endFrameExclusive: 300 },@@ -98,10 +95,9 @@ test("B-roll owns local motion while every item remains an independently stackedconst document = compileHyperframesDocument(sealComposition({contract: "svml.composition@1",id: "interleaved-broll",- programSpace,canvas: { width: 1080, height: 1920, clearColor: "#000000" },tracks: [projectBrollVisual(product), middle, projectBrollAudio(product)],- }));+ }), programSpace);const boardAt = document.html.indexOf('data-svml-present-id="board"');const middleAt = document.html.indexOf('data-svml-present-id="middle"');const cutawayAt = document.html.indexOf('data-svml-present-id="cutaway"');@@ -150,10 +146,9 @@ test("page-turn and transition SFX remain B-roll-owned and lower to generic visuconst document = compileHyperframesDocument(sealComposition({contract: "svml.composition@1",id: "page-turn",- programSpace,canvas: { width: 1080, height: 1920, clearColor: "#000000" },tracks: [product.visualTrack, product.audioTrack],- }));+ }), programSpace);assert.match(document.html, /perspective\(1200px\) rotateY/u);assert.doesNotMatch(document.html, new RegExp(sfx.digest.slice("sha256:".length), "u"),"HyperFrames is visual-only; the media pipeline renders this proven AudioTrack separately");@@ -174,7 +169,7 @@ test("B-roll rejects a pair transition that is not both items' exact shared bounassert.throws(() => compileBrollProduct(programSpace, authored), /must be the outgoing and incoming boundary/);});-test("an Existing BrollProduct cannot recompute its own digest around an out-of-space Present", () => {+test("a BrollProduct is validated against the explicitly connected ProgramSpace", () => {const product = compileBrollProduct(programSpace, program([item({ id: "bounded", span: { startFrame: 0, endFrameExclusive: 120 }, z: 20 }),]));@@ -183,12 +178,10 @@ test("an Existing BrollProduct cannot recompute its own digest around an out-of-...product.visualTrack,presents: [{ ...present, span: { startFrame: 0, endFrameExclusive: 301 } }],});- const content = {+ const tampered = {contract: product.contract,- programSpace: product.programSpace,visualTrack: invalidVisual,audioTrack: product.audioTrack,};- const tampered = { ...content, productDigest: computeBrollProductDigest(content) };- assert.throws(() => projectBrollVisual(tampered), /outside ProgramSpace/);+ assert.throws(() => assertBrollProductIdentity(tampered, programSpace), /outside ProgramSpace/);});diff --git a/packages/caption-gemini/src/fragment.ts b/packages/caption-gemini/src/fragment.tsindex f1cf7e67..fb2ca3fa 100644--- a/packages/caption-gemini/src/fragment.ts+++ b/packages/caption-gemini/src/fragment.ts@@ -33,11 +33,6 @@ export const captionGeminiPlanningFragment = sealGraphFragment({type: captionTypes.plan,root: operation("caption-gemini:plan"),semanticInputs: ["narrative", "captionProgram", "program"],- affinity: [{- resultPointer: "/planningRequestDigest",- source: operation("caption-gemini:compile"),- sourcePointer: "/requestDigest",- }],fidelity: "exact",}],});diff --git a/packages/caption-gemini/src/manifest.ts b/packages/caption-gemini/src/manifest.tsindex 1643e057..284d75d9 100644--- a/packages/caption-gemini/src/manifest.ts+++ b/packages/caption-gemini/src/manifest.ts@@ -24,7 +24,6 @@ export const captionGeminiImplementationDigests = {} as const;const string = { kind: "string", minLength: 1 } as const satisfies ValueSchema;-const digest = { kind: "string", minLength: 71, maxLength: 71 } as const satisfies ValueSchema;const nonNegativeInteger = { kind: "number", integer: true, minimum: 0 } as const satisfies ValueSchema;const object = (fields: Readonly<Record<string, { readonly schema: ValueSchema; readonly optional?: boolean }>>,@@ -56,15 +55,15 @@ const planningRun = object({});export const captionGeminiProgramSchema: ValueSchema = object({contract: { schema: { kind: "literal", value: "svml.caption-gemini-program@1" } },- model: { schema: model }, programDigest: { schema: digest },+ model: { schema: model },});export const captionGeminiRequestSchema: ValueSchema = object({contract: { schema: { kind: "literal", value: "svml.caption-gemini-request@1" } },- model: { schema: model }, narrativeDigest: { schema: digest }, captionProgramDigest: { schema: digest },+ model: { schema: model },atoms: { schema: { kind: "array", minItems: 1, items: object({ id: { schema: string }, text: { schema: string } }) } },runs: { schema: { kind: "array", minItems: 1, items: planningRun } },systemInstruction: { schema: string }, prompt: { schema: string },- temperature: { schema: { kind: "literal", value: 0.2 } }, requestDigest: { schema: digest },+ temperature: { schema: { kind: "literal", value: 0.2 } },});function ownedType(name: string, schema: ValueSchema, digestValue: ReturnType<typeof digestOf>) {@@ -120,10 +119,7 @@ export const captionGeminiManifest: ModuleManifest = {name: captionGeminiProducers.request.name,inputs: [{ name: "request", type: captionGeminiTypes.request }],outputs: [],- needs: [{- name: "plan", capability: captionGeminiCapabilities.plan, returns: captionTypes.plan,- affinity: [{ resultPointer: "/planningRequestDigest", input: "request", inputPointer: "/requestDigest" }],- }],+ needs: [{ name: "plan", capability: captionGeminiCapabilities.plan, returns: captionTypes.plan }],implementation: {kind: "registered", locator: "@svml/caption-gemini/request-plan", digest: captionGeminiImplementationDigests.request,},diff --git a/packages/caption-gemini/src/plan.ts b/packages/caption-gemini/src/plan.tsindex 3ed8b779..9d883b5b 100644--- a/packages/caption-gemini/src/plan.ts+++ b/packages/caption-gemini/src/plan.ts@@ -112,9 +112,6 @@ export function sealCaptionGeminiPlan(});return sealCaptionPlan({contract: "svml.caption-plan@1",- narrativeDigest: request.narrativeDigest,- captionProgramDigest: request.captionProgramDigest,- planningRequestDigest: request.requestDigest,runs,});}diff --git a/packages/caption-gemini/src/program.ts b/packages/caption-gemini/src/program.tsindex b013e966..8cbcc77b 100644--- a/packages/caption-gemini/src/program.ts+++ b/packages/caption-gemini/src/program.ts@@ -1,12 +1,10 @@-import { digestOf, isDigest } from "@svml/protocol";-import type { CaptionGeminiProgram } from "./types.js";function assert(condition: unknown, message: string): asserts condition {if (!condition) throw new Error(message);}-function content(program: Omit<CaptionGeminiProgram, "programDigest">) {+function content(program: CaptionGeminiProgram) {return {contract: "svml.caption-gemini-program@1" as const,model: program.model,@@ -19,16 +17,11 @@ export function verifyCaptionGeminiProgram(value: unknown): asserts value is Capassert(program.contract === "svml.caption-gemini-program@1", "Caption Gemini Program contract is invalid");assert(program.model === "gemini-2.5-flash" || program.model === "gemini-3.1-pro-preview","Caption Gemini model is unsupported");- assert(isDigest(program.programDigest), "Caption Gemini Program digest is invalid");- const { programDigest: _digest, ...withoutDigest } = program;- assert(program.programDigest === digestOf(content(withoutDigest)), "Caption Gemini Program digest does not match its contents");}-export function sealCaptionGeminiProgram(- value: Omit<CaptionGeminiProgram, "programDigest">,-): CaptionGeminiProgram {+export function sealCaptionGeminiProgram(value: CaptionGeminiProgram): CaptionGeminiProgram {const normalized = content(value);- const program = { ...normalized, programDigest: digestOf(normalized) };+ const program = normalized;verifyCaptionGeminiProgram(program);return program;}diff --git a/packages/caption-gemini/src/request.ts b/packages/caption-gemini/src/request.tsindex 9c2cf11d..6606e203 100644--- a/packages/caption-gemini/src/request.ts+++ b/packages/caption-gemini/src/request.ts@@ -1,7 +1,6 @@import { assertCaptionProgramForNarrative } from "@svml/caption";import type { CaptionFieldDeclaration, CaptionProgram } from "@svml/caption";import type { Narrative } from "@svml/contracts";-import { digestOf, isDigest } from "@svml/protocol";import { verifyCaptionGeminiProgram } from "./program.js";import type {@@ -53,12 +52,10 @@ function promptContent(request: Pick<CaptionGeminiRequest, "atoms" | "runs">): s}, null, 2);}-function requestContent(value: Omit<CaptionGeminiRequest, "requestDigest">) {+function requestContent(value: CaptionGeminiRequest) {return {contract: "svml.caption-gemini-request@1" as const,model: value.model,- narrativeDigest: value.narrativeDigest,- captionProgramDigest: value.captionProgramDigest,atoms: value.atoms.map((atom) => ({ ...atom })),runs: value.runs.map((run) => ({id: run.id,@@ -95,15 +92,12 @@ export function compileCaptionGeminiRequest(const base = {contract: "svml.caption-gemini-request@1" as const,model: program.model,- narrativeDigest: captionProgram.narrativeDigest,- captionProgramDigest: captionProgram.digest,atoms: captionProgram.atoms.map((atom) => ({ id: atom.id, text: atom.text })),runs,};const systemInstruction = captionGeminiSystemInstruction(runs);const prompt = promptContent(base);- const content = requestContent({ ...base, systemInstruction, prompt, temperature: 0.2 });- const request = { ...content, requestDigest: digestOf(content) };+ const request = requestContent({ ...base, systemInstruction, prompt, temperature: 0.2 });verifyCaptionGeminiRequest(request);return request;}@@ -113,8 +107,6 @@ export function verifyCaptionGeminiRequest(value: unknown): asserts value is Capconst request = value as CaptionGeminiRequest;assert(request.contract === "svml.caption-gemini-request@1", "Caption Gemini request contract is invalid");assert(request.model === "gemini-2.5-flash" || request.model === "gemini-3.1-pro-preview", "Caption Gemini request model is unsupported");- assert(isDigest(request.narrativeDigest) && isDigest(request.captionProgramDigest) && isDigest(request.requestDigest),- "Caption Gemini request identity is invalid");assert(request.temperature === 0.2, "Caption Gemini temperature is not the package-owned value");assert(Array.isArray(request.atoms) && request.atoms.length > 0, "Caption Gemini request atoms are empty");const atomIds = request.atoms.map((atom) => atom.id);@@ -131,6 +123,4 @@ export function verifyCaptionGeminiRequest(value: unknown): asserts value is Capassert(request.systemInstruction === captionGeminiSystemInstruction(request.runs),"Caption Gemini system instruction differs from the model package");assert(request.prompt === promptContent(request), "Caption Gemini prompt differs from immutable display facts");- const { requestDigest: _digest, ...withoutDigest } = request;- assert(request.requestDigest === digestOf(requestContent(withoutDigest)), "Caption Gemini request digest does not match its contents");}diff --git a/packages/caption-gemini/src/types.ts b/packages/caption-gemini/src/types.tsindex fdc13a3c..e58e190e 100644--- a/packages/caption-gemini/src/types.ts+++ b/packages/caption-gemini/src/types.ts@@ -7,7 +7,6 @@ import type {CaptionPlannedRun,CaptionProgram,} from "@svml/caption";-import type { Digest } from "@svml/protocol";export type {CaptionFieldAssignment,@@ -25,7 +24,6 @@ export type CaptionGeminiModel = "gemini-2.5-flash" | "gemini-3.1-pro-preview";export type CaptionGeminiProgram = {readonly contract: "svml.caption-gemini-program@1";readonly model: CaptionGeminiModel;- readonly programDigest: Digest;};export type CaptionPlanningAtom = {@@ -44,14 +42,11 @@ export type CaptionPlanningRun = {export type CaptionGeminiRequest = {readonly contract: "svml.caption-gemini-request@1";readonly model: CaptionGeminiModel;- readonly narrativeDigest: Digest;- readonly captionProgramDigest: Digest;readonly atoms: readonly CaptionPlanningAtom[];readonly runs: readonly CaptionPlanningRun[];readonly systemInstruction: string;readonly prompt: string;readonly temperature: 0.2;- readonly requestDigest: Digest;};export type RawCaptionGeminiResponse = {diff --git a/packages/caption-gemini/test/planning.test.ts b/packages/caption-gemini/test/planning.test.tsindex 3c02650e..c91fb609 100644--- a/packages/caption-gemini/test/planning.test.ts+++ b/packages/caption-gemini/test/planning.test.ts@@ -82,9 +82,8 @@ test("Gemini sees only immutable display atoms while Role and roleless runs comeassert.equal("whisperx" in request, false);assert.equal("transcript" in request, false);- const { digest: _digest, ...content } = program;const tampered = sealCaptionProgram({- ...content,+ ...program,atoms: program.atoms.map((atom, index) => index === 0 ? { ...atom, text: "TAMPERED" } : atom),});assert.throws(() => compileCaptionGeminiRequest(narrative, tampered, options()),@@ -103,7 +102,6 @@ test("Gemini may only cut each resolved run and assign declared attributes to atconst program = resolveCaptionProgram(narrative, "captions", emphasis, []);const request = compileCaptionGeminiRequest(narrative, program, options());const plan = sealCaptionGeminiPlan(request, validResponse(request));- assert.equal(plan.captionProgramDigest, program.digest);assert.deepEqual(plan.runs.flatMap((run) => run.cues.flatMap((cue) => cue.atomIds)),request.runs.flatMap((run) => run.atomIds),diff --git a/packages/caption/src/component.ts b/packages/caption/src/component.tsindex bfef4207..be16f055 100644--- a/packages/caption/src/component.ts+++ b/packages/caption/src/component.ts@@ -2,6 +2,7 @@ import type { ComponentPackage } from "@svml/component-kit";import type {CompleteSemanticMap,Narrative,+ ProgramSpace,} from "@svml/contracts";import type { StoredValue } from "@svml/protocol";import { canonicalize } from "@svml/protocol";@@ -85,6 +86,7 @@ export const captionComponent = {value: canonicalize(renderCaptionProgram(inline<TimedCaptionProjection>(inputs.caption?.value, "TimedCaptionProjection"),inline<CaptionProgram>(inputs.program?.value, "CaptionProgram"),+ inline<ProgramSpace>(inputs.space?.value, "ProgramSpace"),)),},},@@ -101,6 +103,7 @@ export const captionComponent = {value: canonicalize(renderCaptionTrack(inline<TimedCaptionProjection>(inputs.caption?.value, "TimedCaptionProjection"),inline<CaptionTrackProgram>(inputs.program?.value, "CaptionTrackProgram"),+ inline<ProgramSpace>(inputs.space?.value, "ProgramSpace"),)),},},diff --git a/packages/caption/src/fragment.ts b/packages/caption/src/fragment.tsindex b169b337..2b134561 100644--- a/packages/caption/src/fragment.ts+++ b/packages/caption/src/fragment.ts@@ -13,6 +13,7 @@ export const captionTrackSurfaceFragment = sealGraphFragment({{ name: "narrative", type: contractTypes.narrative },{ name: "map", type: contractTypes.completeSemanticMap },{ name: "program", type: captionTypes.trackProgram },+ { name: "space", type: contractTypes.programSpace },],operations: [{@@ -24,7 +25,7 @@ export const captionTrackSurfaceFragment = sealGraphFragment({{id: "caption:render",producer: captionProducers.renderTrack,- inputs: { caption: operation("caption:temporalize"), program: input("program") },+ inputs: { caption: operation("caption:temporalize"), program: input("program"), space: input("space") },result: { kind: "output", name: "track" },},],@@ -32,8 +33,7 @@ export const captionTrackSurfaceFragment = sealGraphFragment({name: "track",type: contractTypes.visualTrack,root: operation("caption:render"),- semanticInputs: ["narrative", "map", "program"],- affinity: [{ resultPointer: "/programSpaceDigest", source: input("map"), sourcePointer: "/programSpace/digest" }],+ semanticInputs: ["narrative", "map", "program", "space"],fidelity: "exact",}],});@@ -46,6 +46,7 @@ export const plannedCaptionTrackSurfaceFragment = sealGraphFragment({{ name: "map", type: contractTypes.completeSemanticMap },{ name: "plan", type: captionTypes.plan },{ name: "program", type: captionTypes.program },+ { name: "space", type: contractTypes.programSpace },],operations: [{@@ -57,7 +58,7 @@ export const plannedCaptionTrackSurfaceFragment = sealGraphFragment({{id: "caption:render-plan",producer: captionProducers.renderProgram,- inputs: { caption: operation("caption:temporalize-plan"), program: input("program") },+ inputs: { caption: operation("caption:temporalize-plan"), program: input("program"), space: input("space") },result: { kind: "output", name: "track" },},],@@ -65,8 +66,7 @@ export const plannedCaptionTrackSurfaceFragment = sealGraphFragment({name: "track",type: contractTypes.visualTrack,root: operation("caption:render-plan"),- semanticInputs: ["narrative", "map", "plan", "program"],- affinity: [{ resultPointer: "/programSpaceDigest", source: input("map"), sourcePointer: "/programSpace/digest" }],+ semanticInputs: ["narrative", "map", "plan", "program", "space"],fidelity: "exact",}],});diff --git a/packages/caption/src/index.ts b/packages/caption/src/index.tsindex 1228d9ea..55698e3b 100644--- a/packages/caption/src/index.ts+++ b/packages/caption/src/index.ts@@ -39,7 +39,6 @@ export { temporalizeCaption, temporalizeCaptionPlan } from "./temporalize.js";export {assertCaptionTrackProgram,assertTimedCaptionProjection,- computeCaptionTrackProgramDigest,defaultCaptionTrackProgram,renderCaptionTrack,renderCaptionProgram,diff --git a/packages/caption/src/manifest.ts b/packages/caption/src/manifest.tsindex a8f7c172..a3f9e8f7 100644--- a/packages/caption/src/manifest.ts+++ b/packages/caption/src/manifest.ts@@ -1,8 +1,4 @@-import {- contractTypes,- programSpaceSchema,- videoContractDependencies,-} from "@svml/contracts";+import { contractTypes, videoContractDependencies } from "@svml/contracts";import { digestOf } from "@svml/protocol";import type { ModuleManifest, ProducerRef, TypeRef, ValueSchema } from "@svml/protocol";@@ -41,7 +37,6 @@ export const captionProgramSurfaceImplementationDigest = digestOf("@svml/captionconst string = { kind: "string", minLength: 1 } as const;const number = { kind: "number", minimum: 0 } as const;const integer = { kind: "number", integer: true, minimum: 0 } as const;-const digest = { kind: "string", minLength: 71, maxLength: 71 } as const;const object = (fields: Readonly<Record<string, { readonly schema: ValueSchema; readonly optional?: boolean }>>,): ValueSchema => ({ kind: "object", fields });@@ -95,18 +90,12 @@ const captionPlannedRun = object({});export const captionPlanSchema: ValueSchema = object({contract: { schema: { kind: "literal", value: "svml.caption-plan@1" } },- narrativeDigest: { schema: digest },- captionProgramDigest: { schema: digest },- planningRequestDigest: { schema: digest },runs: { schema: { kind: "array", minItems: 1, items: captionPlannedRun } },- planDigest: { schema: digest },});export const timedCaptionProjectionSchema: ValueSchema = object({contract: { schema: { kind: "literal", value: "svml.timed-caption-projection@1" } },- programSpace: { schema: programSpaceSchema },text: { schema: { kind: "string" } },regions: { schema: { kind: "array", items: timedCaptionRegion } },- projectionDigest: { schema: digest },});const captionTrackStyleSchema = object({@@ -129,7 +118,6 @@ const captionTrackStyleSchema = object({export const captionTrackProgramSchema: ValueSchema = object({contract: { schema: { kind: "literal", value: "svml.caption-track-program@1" } },- digest: { schema: digest },id: { schema: string },mode: { schema: { kind: "string", enum: ["whole", "proportional-word", "character-flow"] } },stacking: { schema: object({ order: { schema: integer }, tieBreak: { schema: string } }) },@@ -170,7 +158,6 @@ export const captionStyleSchema: ValueSchema = object({stackingOrder: { schema: integer },style: { schema: captionTrackStyleSchema },}) },- digest: { schema: digest },});const captionDisplayAtom = object({id: { schema: string }, index: { schema: integer }, regionId: { schema: string }, segmentId: { schema: string },@@ -185,11 +172,10 @@ const captionProgramRun = object({});export const captionProgramSchema: ValueSchema = object({contract: { schema: { kind: "literal", value: "svml.caption-program@1" } },- id: { schema: string }, narrativeDigest: { schema: digest }, defaultStyleId: { schema: string },+ id: { schema: string }, defaultStyleId: { schema: string },styles: { schema: { kind: "array", minItems: 1, items: captionStyleSchema } },atoms: { schema: { kind: "array", minItems: 1, items: captionDisplayAtom } },runs: { schema: { kind: "array", minItems: 1, items: captionProgramRun } },- digest: { schema: digest },});export const captionManifest: ModuleManifest = {@@ -277,13 +263,7 @@ export const captionManifest: ModuleManifest = {{ name: "narrative", type: contractTypes.narrative },{ name: "map", type: contractTypes.completeSemanticMap },],- outputs: [{- name: "caption",- type: captionTypes.timedProjection,- affinity: [- { resultPointer: "/programSpace/digest", input: "map", inputPointer: "/programSpace/digest" },- ],- }],+ outputs: [{ name: "caption", type: captionTypes.timedProjection }],needs: [],implementation: {kind: "registered",@@ -299,13 +279,7 @@ export const captionManifest: ModuleManifest = {{ name: "program", type: captionTypes.program },{ name: "plan", type: captionTypes.plan },],- outputs: [{- name: "caption",- type: captionTypes.timedProjection,- affinity: [- { resultPointer: "/programSpace/digest", input: "map", inputPointer: "/programSpace/digest" },- ],- }],+ outputs: [{ name: "caption", type: captionTypes.timedProjection }],needs: [],implementation: {kind: "registered",@@ -318,11 +292,9 @@ export const captionManifest: ModuleManifest = {inputs: [{ name: "caption", type: captionTypes.timedProjection },{ name: "program", type: captionTypes.program },+ { name: "space", type: contractTypes.programSpace },],- outputs: [{- name: "track", type: contractTypes.visualTrack,- affinity: [{ resultPointer: "/programSpaceDigest", input: "caption", inputPointer: "/programSpace/digest" }],- }],+ outputs: [{ name: "track", type: contractTypes.visualTrack }],needs: [],implementation: { kind: "registered", locator: "@svml/caption/render-program", digest: renderCaptionProgramImplementationDigest },},@@ -331,14 +303,9 @@ export const captionManifest: ModuleManifest = {inputs: [{ name: "caption", type: captionTypes.timedProjection },{ name: "program", type: captionTypes.trackProgram },+ { name: "space", type: contractTypes.programSpace },],- outputs: [{- name: "track",- type: contractTypes.visualTrack,- affinity: [- { resultPointer: "/programSpaceDigest", input: "caption", inputPointer: "/programSpace/digest" },- ],- }],+ outputs: [{ name: "track", type: contractTypes.visualTrack }],needs: [],implementation: {kind: "registered",diff --git a/packages/caption/src/plan.ts b/packages/caption/src/plan.tsindex dfb09ddf..3c1257af 100644--- a/packages/caption/src/plan.ts+++ b/packages/caption/src/plan.ts@@ -1,17 +1,12 @@-import { digestOf, isDigest } from "@svml/protocol";-import type { CaptionFieldDeclaration, CaptionPlan, CaptionProgram } from "./types.js";function assert(condition: unknown, message: string): asserts condition {if (!condition) throw new Error(message);}-function content(value: Omit<CaptionPlan, "planDigest">) {+function content(value: CaptionPlan) {return {contract: "svml.caption-plan@1" as const,- narrativeDigest: value.narrativeDigest,- captionProgramDigest: value.captionProgramDigest,- planningRequestDigest: value.planningRequestDigest,runs: value.runs.map((run) => ({id: run.id,styleId: run.styleId,@@ -24,9 +19,9 @@ function content(value: Omit<CaptionPlan, "planDigest">) {};}-export function sealCaptionPlan(value: Omit<CaptionPlan, "planDigest">): CaptionPlan {+export function sealCaptionPlan(value: CaptionPlan): CaptionPlan {const normalized = content(value);- const plan = { ...normalized, planDigest: digestOf(normalized) };+ const plan = normalized;assertCaptionPlan(plan);return plan;}@@ -35,8 +30,6 @@ export function assertCaptionPlan(value: unknown): asserts value is CaptionPlanassert(value !== null && typeof value === "object" && !Array.isArray(value), "CaptionPlan must be an object");const plan = value as CaptionPlan;assert(plan.contract === "svml.caption-plan@1", "Unsupported CaptionPlan contract");- assert(isDigest(plan.narrativeDigest) && isDigest(plan.captionProgramDigest)- && isDigest(plan.planningRequestDigest) && isDigest(plan.planDigest), "CaptionPlan identity is invalid");assert(Array.isArray(plan.runs) && plan.runs.length > 0, "CaptionPlan runs are empty");const runIds = new Set<string>();const atomIds = new Set<string>();@@ -62,8 +55,6 @@ export function assertCaptionPlan(value: unknown): asserts value is CaptionPlan}}}- const { planDigest: _digest, ...withoutDigest } = plan;- assert(plan.planDigest === digestOf(content(withoutDigest)), "CaptionPlan digest does not match its contents");}function assertFieldValue(declaration: CaptionFieldDeclaration, value: string): void {@@ -84,8 +75,6 @@ function assertFieldValue(declaration: CaptionFieldDeclaration, value: string):/** Validate planner freedom against one resolved Program; no Provider-specific assumptions. */export function assertCaptionPlanForProgram(plan: CaptionPlan, program: CaptionProgram): void {assertCaptionPlan(plan);- assert(plan.narrativeDigest === program.narrativeDigest && plan.captionProgramDigest === program.digest,- "CaptionPlan belongs to another Caption Program");assert(plan.runs.length === program.runs.length, "CaptionPlan does not contain the exact Program run set");const styles = new Map(program.styles.map((style) => [style.id, style]));for (let index = 0; index < program.runs.length; index += 1) {diff --git a/packages/caption/src/presentation.ts b/packages/caption/src/presentation.tsindex f6976555..7122daf2 100644--- a/packages/caption/src/presentation.ts+++ b/packages/caption/src/presentation.ts@@ -1,6 +1,3 @@-import { digestOf } from "@svml/protocol";-import type { Digest } from "@svml/protocol";-import type {CaptionPresentationMode,CaptionPresentationPlan,@@ -131,7 +128,7 @@ function characterFlow(region: TimedCaptionRegion): CaptionPresentationUnit[] {}export function planCaptionPresentation(- projection: { readonly projectionDigest: Digest; readonly regions: readonly TimedCaptionRegion[] },+ projection: { readonly regions: readonly TimedCaptionRegion[] },mode: CaptionPresentationMode = "whole",): CaptionPresentationPlan {const units = projection.regions.flatMap((region) =>@@ -140,10 +137,9 @@ export function planCaptionPresentation(: mode === "proportional-word"? proportionalWords(region): characterFlow(region));- const payload = {+ return {contract: "svml.caption-presentation-plan@0" as const,mode,units,};- return { ...payload, planDigest: digestOf(payload) };}diff --git a/packages/caption/src/style.ts b/packages/caption/src/style.tsindex ccd38750..402dbde0 100644--- a/packages/caption/src/style.ts+++ b/packages/caption/src/style.ts@@ -1,5 +1,5 @@import type { Narrative, NarrativeSelectionRef } from "@svml/contracts";-import { canonicalize, digestOf, isDigest } from "@svml/protocol";+import { canonicalize, digestOf } from "@svml/protocol";import { captionDisplayAtoms, displayAtomMatchesSelection } from "./display.js";import type {@@ -43,7 +43,7 @@ function normalizedField(field: CaptionFieldDeclaration): CaptionFieldDeclaratio};}-function styleContent(value: Omit<CaptionStyleIntent, "digest">) {+function styleContent(value: CaptionStyleIntent) {return canonicalize({contract: "svml.caption-style@1",id: value.id,@@ -52,12 +52,11 @@ function styleContent(value: Omit<CaptionStyleIntent, "digest">) {fields: value.planning.fields.map(normalizedField),},presentation: canonicalize(value.presentation),- }) as unknown as Omit<CaptionStyleIntent, "digest">;+ }) as unknown as CaptionStyleIntent;}-export function sealCaptionStyle(value: Omit<CaptionStyleIntent, "digest">): CaptionStyleIntent {- const content = styleContent(value);- const result = { ...content, digest: digestOf(content) };+export function sealCaptionStyle(value: CaptionStyleIntent): CaptionStyleIntent {+ const result = styleContent(value);assertCaptionStyle(result);return result;}@@ -113,9 +112,6 @@ export function assertCaptionStyle(value: CaptionStyleIntent): void {for (const color of [appearance.color, appearance.backgroundColor].filter((item): item is string => item !== undefined)) {assert(/^#[0-9a-f]{6}(?:[0-9a-f]{2})?$/iu.test(color), `Caption Style ${value.id} color ${color} is invalid`);}- assert(isDigest(value.digest), `Caption Style ${value.id} digest is invalid`);- const { digest: _digest, ...withoutDigest } = value;- assert(value.digest === digestOf(styleContent(withoutDigest)), `Caption Style ${value.id} digest differs`);}function matches(@@ -127,20 +123,18 @@ function matches(return displayAtomMatchesSelection(atom, application.selector.selection, narrative.tokens.length);}-function programContent(value: Omit<CaptionProgram, "digest">) {- return canonicalize(value) as unknown as Omit<CaptionProgram, "digest">;+function programContent(value: CaptionProgram) {+ return canonicalize(value) as unknown as CaptionProgram;}-export function sealCaptionProgram(value: Omit<CaptionProgram, "digest">): CaptionProgram {- const content = programContent(value);- const result = { ...content, digest: digestOf(content) };+export function sealCaptionProgram(value: CaptionProgram): CaptionProgram {+ const result = programContent(value);assertCaptionProgram(result);return result;}export function assertCaptionProgram(value: CaptionProgram): void {assert(value.contract === "svml.caption-program@1" && ID.test(value.id), "Caption Program identity is invalid");- assert(isDigest(value.narrativeDigest) && isDigest(value.digest), "Caption Program digest is invalid");assert(value.atoms.length > 0 && value.runs.length > 0 && value.styles.length > 0, "Caption Program is empty");const styles = new Map(value.styles.map((style) => [style.id, style]));assert(styles.size === value.styles.length && styles.has(value.defaultStyleId), "Caption Program styles are invalid");@@ -165,14 +159,11 @@ export function assertCaptionProgram(value: CaptionProgram): void {assert(planned.join("\0") === atomIds.join("\0"),"Caption Program runs must partition every display atom exactly once and in order");assert(value.runs.every((run) => styles.has(run.styleId) && run.atomIds.length > 0), "Caption Program run style is invalid");- const { digest: _digest, ...withoutDigest } = value;- assert(value.digest === digestOf(programContent(withoutDigest)), "Caption Program digest differs");}/** Bind a Program's immutable display universe to the exact Narrative consumed by a Producer. */export function assertCaptionProgramForNarrative(value: CaptionProgram, narrative: Narrative): void {assertCaptionProgram(value);- assert(value.narrativeDigest === digestOf(narrative), "Caption Program belongs to another Narrative");assert(digestOf(value.atoms) === digestOf(captionDisplayAtoms(narrative)),"Caption Program display atoms differ from its Narrative");}@@ -196,7 +187,7 @@ export function resolveCaptionProgram(const styles = new Map<string, CaptionStyleIntent>([[defaultStyle.id, defaultStyle]]);applications.forEach((application) => {const previous = styles.get(application.style.id);- assert(previous === undefined || previous.digest === application.style.digest,+ assert(previous === undefined || digestOf(previous) === digestOf(application.style),`Caption Style ${application.style.id} has conflicting definitions`);styles.set(application.style.id, application.style);});@@ -230,7 +221,6 @@ export function resolveCaptionProgram(return sealCaptionProgram({contract: "svml.caption-program@1",id,- narrativeDigest: digestOf(narrative),defaultStyleId: defaultStyle.id,styles: [...styles.values()],atoms,diff --git a/packages/caption/src/surface.ts b/packages/caption/src/surface.tsindex e239d71a..b5b0f7b7 100644--- a/packages/caption/src/surface.ts+++ b/packages/caption/src/surface.ts@@ -265,7 +265,7 @@ export const decodeCaptionProgramSurface: StructuredSurfaceHandler = ({ element,export const decodeCaptionTrackSurface: StructuredSurfaceHandler = ({ element, resolveReference }) => {if (element.attributes.program !== undefined) {- attributes(element, ["id", "narrative", "map", "program", "plan"]);+ attributes(element, ["id", "narrative", "map", "program", "plan", "space"]);if (element.children.some((child) => child.kind === "element" || child.value.trim())) {throw new Error(`${element.name} with a Caption Program does not accept children`);}@@ -274,25 +274,27 @@ export const decodeCaptionTrackSurface: StructuredSurfaceHandler = ({ element, rconst map = reference(element, "map", contractTypes.completeSemanticMap, resolveReference);const program = reference(element, "program", captionTypes.program, resolveReference);const plan = reference(element, "plan", captionTypes.plan, resolveReference);+ const space = reference(element, "space", contractTypes.programSpace, resolveReference);return {records: [],components: [{id,fragment: plannedCaptionTrackSurfaceFragment.id,- inputs: { narrative: narrative.ref, map: map.ref, program: program.ref, plan: plan.ref },+ inputs: { narrative: narrative.ref, map: map.ref, program: program.ref, plan: plan.ref, space: space.ref },outputs: { track: `${id}.track` },range: element.range,}],fragments: [plannedCaptionTrackSurfaceFragment],};}- attributes(element, ["id", "narrative", "map", "appearance"], ["mode"]);+ attributes(element, ["id", "narrative", "map", "space", "appearance"], ["mode"]);if (element.children.some((child) => child.kind === "element" || child.value.trim())) {throw new Error(`${element.name} provider-free base does not accept Role children`);}const id = stringAttribute(element, "id");const narrative = reference(element, "narrative", contractTypes.narrative, resolveReference);const map = reference(element, "map", contractTypes.completeSemanticMap, resolveReference);+ const space = reference(element, "space", contractTypes.programSpace, resolveReference);const appearance = recipe(reference(element, "appearance", svsRecipeType, resolveReference));const resolvedAppearance = captionAppearance(element, appearance);const program = sealCaptionTrackProgram({@@ -311,6 +313,7 @@ export const decodeCaptionTrackSurface: StructuredSurfaceHandler = ({ element, rinputs: {narrative: narrative.ref,map: map.ref,+ space: space.ref,program: { kind: "record", id: programId },},outputs: { track: `${id}.track` },diff --git a/packages/caption/src/temporalize.ts b/packages/caption/src/temporalize.tsindex 5c3d3614..7fa18ca5 100644--- a/packages/caption/src/temporalize.ts+++ b/packages/caption/src/temporalize.ts@@ -1,4 +1,3 @@-import { digestOf } from "@svml/protocol";import type { CompleteSemanticMap, Narrative, TimingQuality } from "@svml/contracts";import { CaptionProjectionError } from "./error.js";@@ -69,11 +68,10 @@ export function temporalizeCaption(});const payload = {contract: "svml.timed-caption-projection@1" as const,- programSpace: map.programSpace,text: narrative.captionProjection.text,regions,};- return { ...payload, projectionDigest: digestOf(payload) };+ return payload;}function cleanDisplay(value: string): string {@@ -89,12 +87,6 @@ export function temporalizeCaptionPlan(): TimedCaptionProjection {assertCaptionProgramForNarrative(program, narrative);assertCaptionPlanForProgram(plan, program);- if (plan.narrativeDigest !== digestOf(narrative)) {- throw new CaptionProjectionError("CAPTION_PLAN_NARRATIVE", "CaptionPlan belongs to another Narrative.");- }- if (program.narrativeDigest !== plan.narrativeDigest || plan.captionProgramDigest !== program.digest) {- throw new CaptionProjectionError("CAPTION_PLAN_PROGRAM", "CaptionPlan belongs to another Caption Program.");- }const atomById = new Map(program.atoms.map((atom) => [atom.id, atom]));const timingById = new Map(map.tokens.map((token) => [token.tokenId, token]));const regionById = new Map(narrative.captionProjection.regions.map((region) => [region.id, region]));@@ -200,9 +192,8 @@ export function temporalizeCaptionPlan(}const payload = {contract: "svml.timed-caption-projection@1" as const,- programSpace: map.programSpace,text: cleanDisplay(regions.map((region) => region.display).join(" ")),regions,};- return { ...payload, projectionDigest: digestOf(payload) };+ return payload;}diff --git a/packages/caption/src/track.ts b/packages/caption/src/track.tsindex 8fc4bbbf..0ca25d9e 100644--- a/packages/caption/src/track.ts+++ b/packages/caption/src/track.ts@@ -4,9 +4,8 @@ import {programSpaceFrameCount,sealVisualTrack,} from "@svml/contracts";-import type { VisualStyleDeclaration, VisualTrack } from "@svml/contracts";-import { digestOf, isDigest } from "@svml/protocol";-import type { Digest } from "@svml/protocol";+import type { ProgramSpace, VisualStyleDeclaration, VisualTrack } from "@svml/contracts";+import { digestOf } from "@svml/protocol";import { planCaptionPresentation } from "./presentation.js";import { assertCaptionProgram } from "./style.js";@@ -15,7 +14,7 @@ import type { CaptionProgram, CaptionTrackProgram, TimedCaptionProjection } fromexport const renderCaptionTrackImplementationDigest = digestOf("@svml/caption/render-track@1");export const renderCaptionProgramImplementationDigest = digestOf("@svml/caption/render-program@1");-function normalizedProgram(value: Omit<CaptionTrackProgram, "digest">): Omit<CaptionTrackProgram, "digest"> {+function normalizedProgram(value: CaptionTrackProgram): CaptionTrackProgram {return {contract: "svml.caption-track-program@1",id: value.id,@@ -25,13 +24,8 @@ function normalizedProgram(value: Omit<CaptionTrackProgram, "digest">): Omit<Cap};}-export function computeCaptionTrackProgramDigest(value: Omit<CaptionTrackProgram, "digest">): Digest {- return digestOf(normalizedProgram(value));-}--export function sealCaptionTrackProgram(value: Omit<CaptionTrackProgram, "digest">): CaptionTrackProgram {- const content = normalizedProgram(value);- return { ...content, digest: digestOf(content) };+export function sealCaptionTrackProgram(value: CaptionTrackProgram): CaptionTrackProgram {+ return normalizedProgram(value);}export function defaultCaptionTrackProgram(id = "captions"): CaptionTrackProgram {@@ -58,10 +52,6 @@ export function defaultCaptionTrackProgram(id = "captions"): CaptionTrackProgramexport function assertCaptionTrackProgram(program: CaptionTrackProgram): void {if (program.contract !== "svml.caption-track-program@1") throw new Error("Unsupported CaptionTrackProgram contract.");- const { digest: _digest, ...content } = program;- if (!isDigest(program.digest) || program.digest !== computeCaptionTrackProgramDigest(content)) {- throw new Error("CaptionTrackProgram digest does not match its contents.");- }if (!program.id || !program.stacking.tieBreak || !program.style.fontFamily) {throw new Error("CaptionTrackProgram identity and font family must not be empty.");}@@ -97,17 +87,12 @@ export function assertTimedCaptionProjection(projection: TimedCaptionProjection)if (projection.contract !== "svml.timed-caption-projection@1") {throw new Error("Unsupported TimedCaptionProjection contract.");}- assertProgramSpaceIdentity(projection.programSpace);- const { projectionDigest: _digest, ...content } = projection;- if (!isDigest(projection.projectionDigest) || projection.projectionDigest !== digestOf(content)) {- throw new Error("TimedCaptionProjection digest does not match its contents.");- }}-function frameAt(projection: TimedCaptionProjection, seconds: number): number {+function frameAt(programSpace: ProgramSpace, seconds: number): number {return Math.round(seconds- * projection.programSpace.frameRate.numerator- / projection.programSpace.frameRate.denominator);+ * programSpace.frameRate.numerator+ / programSpace.frameRate.denominator);}function textStyle(style: CaptionTrackProgram["style"]): VisualStyleDeclaration[] {@@ -128,19 +113,20 @@ function textStyle(style: CaptionTrackProgram["style"]): VisualStyleDeclaration[export function renderCaptionTrack(projection: TimedCaptionProjection,program: CaptionTrackProgram,+ programSpace: ProgramSpace,): VisualTrack {assertTimedCaptionProjection(projection);assertCaptionTrackProgram(program);- const totalFrames = programSpaceFrameCount(projection.programSpace);+ assertProgramSpaceIdentity(programSpace);+ const totalFrames = programSpaceFrameCount(programSpace);const plan = planCaptionPresentation(projection, program.mode);const track = sealVisualTrack({contract: "svml.visual-track@1",visualIr: "svml.hyperframes-visual-ir@1",id: program.id,- programSpaceDigest: projection.programSpace.digest,presents: plan.units.flatMap((unit) => {- const startFrame = Math.max(0, frameAt(projection, unit.startSec));- const measuredEnd = Math.min(totalFrames, frameAt(projection, unit.endSec));+ const startFrame = Math.max(0, frameAt(programSpace, unit.startSec));+ const measuredEnd = Math.min(totalFrames, frameAt(programSpace, unit.endSec));const endFrameExclusive = Math.min(totalFrames, Math.max(startFrame + 1, measuredEnd));if (!unit.display || startFrame >= totalFrames || endFrameExclusive <= startFrame) return [];return [{@@ -189,7 +175,7 @@ export function renderCaptionTrack(}];}),});- assertVisualTrackIdentity(track, projection.programSpace);+ assertVisualTrackIdentity(track, programSpace);return track;}@@ -197,17 +183,19 @@ export function renderCaptionTrack(export function renderCaptionProgram(projection: TimedCaptionProjection,program: CaptionProgram,+ programSpace: ProgramSpace,): VisualTrack {assertTimedCaptionProjection(projection);assertCaptionProgram(program);const styles = new Map(program.styles.map((style) => [style.id, style]));- const totalFrames = programSpaceFrameCount(projection.programSpace);+ assertProgramSpaceIdentity(programSpace);+ const totalFrames = programSpaceFrameCount(programSpace);const units = projection.regions.flatMap((region) => {const styleId = region.styleId ?? program.defaultStyleId;const style = styles.get(styleId);if (style === undefined) throw new Error(`Caption region ${region.id} references unknown Style ${styleId}`);return planCaptionPresentation(- { projectionDigest: projection.projectionDigest, regions: [region] },+ { regions: [region] },style.presentation.mode,).units.map((unit) => ({ unit, style }));});@@ -215,10 +203,9 @@ export function renderCaptionProgram(contract: "svml.visual-track@1",visualIr: "svml.hyperframes-visual-ir@1",id: program.id,- programSpaceDigest: projection.programSpace.digest,presents: units.flatMap(({ unit, style }) => {- const startFrame = Math.max(0, frameAt(projection, unit.startSec));- const measuredEnd = Math.min(totalFrames, frameAt(projection, unit.endSec));+ const startFrame = Math.max(0, frameAt(programSpace, unit.startSec));+ const measuredEnd = Math.min(totalFrames, frameAt(programSpace, unit.endSec));const endFrameExclusive = Math.min(totalFrames, Math.max(startFrame + 1, measuredEnd));if (!unit.display || startFrame >= totalFrames || endFrameExclusive <= startFrame) return [];const appearance = style.presentation.style;@@ -269,6 +256,6 @@ export function renderCaptionProgram(}];}),});- assertVisualTrackIdentity(track, projection.programSpace);+ assertVisualTrackIdentity(track, programSpace);return track;}diff --git a/packages/caption/src/types.ts b/packages/caption/src/types.tsindex 859ef2b5..6557cdd3 100644--- a/packages/caption/src/types.ts+++ b/packages/caption/src/types.ts@@ -1,5 +1,4 @@-import type { ProgramSpace, TimingQuality } from "@svml/contracts";-import type { Digest } from "@svml/protocol";+import type { TimingQuality } from "@svml/contracts";export type CaptionFieldValueSchema =| { readonly kind: "boolean" }@@ -55,11 +54,7 @@ export type CaptionPlannedRun = {/** Planner-neutral result. Model/provider identity remains in the producing Graph and Receipt. */export type CaptionPlan = {readonly contract: "svml.caption-plan@1";- readonly narrativeDigest: Digest;- readonly captionProgramDigest: Digest;- readonly planningRequestDigest: Digest;readonly runs: readonly CaptionPlannedRun[];- readonly planDigest: Digest;};export type CaptionStyleIntent = {@@ -71,7 +66,6 @@ export type CaptionStyleIntent = {readonly stackingOrder: number;readonly style: CaptionTrackProgram["style"];};- readonly digest: Digest;};export type CaptionProgramRun = {@@ -84,12 +78,10 @@ export type CaptionProgramRun = {export type CaptionProgram = {readonly contract: "svml.caption-program@1";readonly id: string;- readonly narrativeDigest: Digest;readonly defaultStyleId: string;readonly styles: readonly CaptionStyleIntent[];readonly atoms: readonly CaptionDisplayAtom[];readonly runs: readonly CaptionProgramRun[];- readonly digest: Digest;};export type TimedCaptionRefinement = {@@ -123,10 +115,8 @@ export type TimedCaptionRegion = {export type TimedCaptionProjection = {readonly contract: "svml.timed-caption-projection@1";- readonly programSpace: ProgramSpace;readonly text: string;readonly regions: readonly TimedCaptionRegion[];- readonly projectionDigest: Digest;};export type CaptionPresentationMode = "whole" | "proportional-word" | "character-flow";@@ -150,13 +140,11 @@ export type CaptionPresentationPlan = {readonly contract: "svml.caption-presentation-plan@0";readonly mode: CaptionPresentationMode;readonly units: readonly CaptionPresentationUnit[];- readonly planDigest: Digest;};/** Official caption package's author-facing lowering program, not a Core type. */export type CaptionTrackProgram = {readonly contract: "svml.caption-track-program@1";- readonly digest: Digest;readonly id: string;readonly mode: CaptionPresentationMode;readonly stacking: {diff --git a/packages/caption/test/caption.test.ts b/packages/caption/test/caption.test.tsindex e8a085d7..28c1e567 100644--- a/packages/caption/test/caption.test.ts+++ b/packages/caption/test/caption.test.ts@@ -49,12 +49,8 @@ test("the component enumerates every Manifest Producer and owned Type validator"});function locate(narrative: Narrative, durationSec: number, segments: readonly AlignedTranscriptSegment[]) {- const programSpace = sealProgramSpace({- contract: "svml.program-space@0",- durationSec,- frameRate: { numerator: 1_000, denominator: 1 },- });- const audioDigest = digestOf(`caption:audio:${narrative.semanticIndex.digest}`);+ const programSpace = captionSpace(durationSec);+ const audioDigest = digestOf(`caption:audio:${narrative.segments.map((segment) => segment.id).join("+")}`);const basisSegments = narrative.segments.map((segment, index) => ({segmentId: segment.id,startSec: segments[index]!.startSec,@@ -79,8 +75,6 @@ function locate(narrative: Narrative, durationSec: number, segments: readonly Al});const evidence = sealAlignedTranscriptEvidence({contract: "svml.aligned-transcript-evidence@1",- audioArtifactDigest: digestOf("caption:acoustic-evidence"),- programSpaceDigest: basis.programSpace.digest,durationSec,segments,});@@ -93,7 +87,15 @@ function locate(narrative: Narrative, durationSec: number, segments: readonly Alreturn locateSpeechTiming(narrative, audioBasis, evidence);}-test("Caption-owned validators reject digest-preserving shape tampering", () => {+function captionSpace(durationSec: number) {+ return sealProgramSpace({+ contract: "svml.program-space@0",+ durationSec,+ frameRate: { numerator: 1_000, denominator: 1 },+ });+}++test("Caption-owned validators reject semantically invalid values", () => {const narrative = parseScript("validator.svml", "<line>Hello.</line>");const projection = temporalizeCaption(narrative, locate(narrative, 1, [{sourceSegmentId: "line",@@ -112,16 +114,16 @@ test("Caption-owned validators reject digest-preserving shape tampering", () =>assert.throws(() => projectionValidator.handler({type: projectionValidator.type,- value: { kind: "inline", value: { ...projection, text: "tampered" } },+ value: { kind: "inline", value: { ...projection, contract: "invalid" } },}),- /digest does not match/u,+ /Unsupported TimedCaptionProjection/u,);assert.throws(() => programValidator.handler({type: programValidator.type,- value: { kind: "inline", value: { ...program, id: "tampered" } },+ value: { kind: "inline", value: { ...program, id: "" } },}),- /digest does not match/u,+ /identity and font family must not be empty/u,);});@@ -195,9 +197,6 @@ test("multiple Cues inside one display alias receive ordered local estimates, noconst run = program.runs[0]!;const plan = sealCaptionPlan({contract: "svml.caption-plan@1",- narrativeDigest: digestOf(narrative),- captionProgramDigest: program.digest,- planningRequestDigest: digestOf("alias-plan-request"),runs: [{id: run.id,styleId: run.styleId,@@ -250,10 +249,9 @@ test("official caption styling lowers to an ordinary self-contained VisualTrack"}]);const projection = temporalizeCaption(narrative, map);const program = defaultCaptionTrackProgram("primary-caption");- const track = renderCaptionTrack(projection, program);+ const track = renderCaptionTrack(projection, program, captionSpace(1));assert.equal(track.contract, "svml.visual-track@1");- assert.equal(track.programSpaceDigest, map.programSpace.digest);assert.equal(track.presents[0]?.elements.some((element) => element.kind === "text"), true);assert.equal(track.presents.flatMap((present) => present.elements).some((element) => "text" in element && element.text.includes("Hello")),@@ -277,10 +275,10 @@ test("two caption styles become two peer Tracks without mutating one another", (stacking: { order: 101, tieBreak: "speaker-b" },style: { ...first.style, color: "#00ff00", bottomPercent: 20 },});- const firstTrack = renderCaptionTrack(projection, first);- const secondTrack = renderCaptionTrack(projection, second);+ const firstTrack = renderCaptionTrack(projection, first, captionSpace(1));+ const secondTrack = renderCaptionTrack(projection, second, captionSpace(1));- assert.notEqual(firstTrack.digest, secondTrack.digest);+ assert.notDeepEqual(firstTrack, secondTrack);assert.deepEqual(firstTrack.presents.map((present) => present.span),secondTrack.presents.map((present) => present.span),@@ -323,9 +321,6 @@ test("a planner-neutral CaptionPlan joins SemanticMap only after Cue and field pconst ids = program.atoms.map((atom) => atom.id);const plan = sealCaptionPlan({contract: "svml.caption-plan@1",- narrativeDigest: digestOf(narrative),- captionProgramDigest: program.digest,- planningRequestDigest: digestOf("planned-caption-request"),runs: [{id: program.runs[0]!.id,styleId: style.id,@@ -342,7 +337,7 @@ test("a planner-neutral CaptionPlan joins SemanticMap only after Cue and field pconst projection = temporalizeCaptionPlan(narrative, map, program, plan);assert.deepEqual(projection.regions.map((region) => region.display), ["Meaning becomes", "the source."]);assert.deepEqual(projection.regions[0]?.fields?.map((field) => field.declarationId), ["important"]);- const track = renderCaptionProgram(projection, program);+ const track = renderCaptionProgram(projection, program, captionSpace(2));const firstText = track.presents[0]?.elements.find((element) => element.kind === "text");assert.equal(firstText?.attributes?.some((attribute) =>attribute.name === "data-caption-style" && attribute.value === "alice"), true);diff --git a/packages/cli/src/distribution.ts b/packages/cli/src/distribution.tsindex f854b7f8..3e33c70e 100644--- a/packages/cli/src/distribution.ts+++ b/packages/cli/src/distribution.ts@@ -1,5 +1,6 @@import type { NodeCompiler } from "@svml/compiler-node";import type { LocalRuntime } from "@svml/local";+import type { RuntimeConfigDoctorResult } from "@svml/local";import type { NodePackageContribution } from "@svml/package-loader-node";import type { RunFrontend } from "@svml/run";@@ -21,4 +22,5 @@ export type CliDistribution = {readonly runFrontends: readonly RunFrontend[];createCompiler(options: CliCompilerOptions): NodeCompiler;createRuntimeFromConfig(path: string): Promise<LocalRuntime>;+ doctorRuntimeConfig(path: string): Promise<RuntimeConfigDoctorResult>;};diff --git a/packages/cli/src/main.ts b/packages/cli/src/main.tsindex 2dc45de5..e3104afe 100644--- a/packages/cli/src/main.ts+++ b/packages/cli/src/main.ts@@ -45,6 +45,7 @@ type ParsedArgs = {readonly artifact: string | undefined;readonly to: string | undefined;readonly pins: readonly { readonly output: string; readonly build: string }[];+ readonly apply: boolean;};function parseArgs(argv: readonly string[]): ParsedArgs {@@ -66,6 +67,7 @@ function parseArgs(argv: readonly string[]): ParsedArgs {let artifact: string | undefined;let to: string | undefined;const pins: { output: string; build: string }[] = [];+ let apply = false;for (let index = 0; index < rest.length; index += 1) {const item = rest[index];if (item === "--target") {@@ -165,6 +167,10 @@ function parseArgs(argv: readonly string[]): ParsedArgs {follow = true;continue;}+ if (item === "--apply") {+ apply = true;+ continue;+ }if (item === "--max-wait-ms") {const value = rest[index + 1];if (value === undefined || value.startsWith("--")) throw new Error("--max-wait-ms requires milliseconds");@@ -195,6 +201,7 @@ function parseArgs(argv: readonly string[]): ParsedArgs {artifact,to,pins,+ apply,};}@@ -202,6 +209,8 @@ function usage(): string {return ["usage:"," svml-v2 lock-packages <svml.packages.lock> --package installed-name [--package installed-name] [--root directory]",+ " svml-v2 doctor <runtime-profile.json>",+ " svml-v2 gc <runtime-profile.json> [--apply]"," svml-v2 check <self-described-source> [--runtime profile.json] [--package-lock file] [--root directory]"," svml-v2 plan <run-source> [--runtime profile.json] [--package-lock file]"," svml-v2 build <run-source> --runtime profile.json|./svml.runtime.ts [--follow]",@@ -277,7 +286,8 @@ export async function runCli(const args = parseArgs(argv);const known = args.command === "lock-packages" || args.command === "check" || args.command === "plan"|| args.command === "build" || args.command === "status" || args.command === "builds"- || args.command === "inspect" || args.command === "get" || args.command === "cancel";+ || args.command === "inspect" || args.command === "get" || args.command === "cancel"+ || args.command === "doctor" || args.command === "gc";if (!known || (args.command !== "builds" && args.file === undefined)) {throw new Error(usage());}@@ -291,6 +301,40 @@ export async function runCli(io.write(`${JSON.stringify({ ok: true, packageLock: output, digest: lock.digest, packages: lock.packages }, null, 2)}\n`);return;}+ if (args.command === "doctor") {+ if (args.runtime !== undefined || args.packageLock !== undefined || args.packages.length > 0 || args.apply) {+ throw new Error("doctor reads all deployment selection from the Runtime Profile itself");+ }+ const result = await distribution.doctorRuntimeConfig(resolve(args.file!));+ io.write(`${JSON.stringify({+ ok: !result.diagnostics.some((item) => item.severity === "error"),+ root: result.root,+ diagnostics: result.diagnostics,+ }, null, 2)}\n`);+ return;+ }+ if (args.command === "gc") {+ if (args.runtime !== undefined || args.packageLock !== undefined || args.packages.length > 0) {+ throw new Error("gc reads all deployment selection from the Runtime Profile itself");+ }+ const runtime = await loadLocalRuntime(resolve(args.file!), distribution);+ try {+ if (!("garbageCollectArtifacts" in runtime) || typeof runtime.garbageCollectArtifacts !== "function") {+ throw new Error("selected Runtime does not expose Artifact maintenance");+ }+ const report = await runtime.garbageCollectArtifacts({ apply: args.apply });+ io.write(`${JSON.stringify({+ applied: args.apply,+ reachable: report.reachable,+ unreachable: report.unreachable,+ deleted: report.deleted,+ }, null, 2)}\n`);+ } finally {+ await runtime.close();+ }+ return;+ }+ if (args.apply) throw new Error("--apply is only valid for gc");if ((args.record !== undefined || args.output !== undefined || args.name !== undefined|| args.artifact !== undefined || args.to !== undefined)&& args.command !== "get") {diff --git a/packages/contracts/src/component.ts b/packages/contracts/src/component.tsindex a02a0668..71931d8b 100644--- a/packages/contracts/src/component.ts+++ b/packages/contracts/src/component.ts@@ -29,7 +29,7 @@ function inline(value: { readonly kind: string; readonly value?: unknown }, subjreturn value.value;}-/** Semantic refinements for digest-bound public media facts. */+/** Semantic validation for public media facts. Core Records own value integrity. */export const mediaContractsComponent = {name: "@svml/media",validators: [diff --git a/packages/contracts/src/identity.ts b/packages/contracts/src/identity.tsindex 32514a85..3e11d04c 100644--- a/packages/contracts/src/identity.ts+++ b/packages/contracts/src/identity.ts@@ -1,5 +1,4 @@-import { digestOf, isDigest } from "@svml/protocol";-import type { Digest } from "@svml/protocol";+import { isDigest } from "@svml/protocol";import type {AlignedTranscriptEvidence,@@ -10,52 +9,18 @@ import type {SpeechEvidenceAudio,} from "./speech.js";-export function computeSpeechDurationDigest(value: Omit<SpeechDuration, "durationDigest">): Digest {- return digestOf(value);-}--export function sealSpeechDuration(value: Omit<SpeechDuration, "durationDigest">): SpeechDuration {- return { ...value, durationDigest: computeSpeechDurationDigest(value) };+export function sealSpeechDuration(value: SpeechDuration): SpeechDuration {+ return structuredClone(value);}export function assertSpeechDurationIdentity(value: SpeechDuration): void {if (value.contract !== "svml.speech-duration@1") throw new Error("Unsupported SpeechDuration contract.");if (- value.segmentId.length === 0- || !Number.isSafeInteger(value.tokenStart)- || !Number.isSafeInteger(value.tokenEndExclusive)- || value.tokenStart < 0- || value.tokenEndExclusive <= value.tokenStart- || !isDigest(value.sourceSpeechExcerptDigest)- || !Number.isFinite(value.durationSec)+ !Number.isFinite(value.durationSec)|| value.durationSec <= 0) {throw new Error("SpeechDuration is invalid.");}- const { durationDigest: _digest, ...content } = value;- if (!isDigest(value.durationDigest) || value.durationDigest !== computeSpeechDurationDigest(content)) {- throw new Error("SpeechDuration digest does not match its canonical contents.");- }-}--export function computeProgramSpaceDigest(value: Omit<ProgramSpace, "digest">): Digest {- return digestOf(value);-}--export function computeSpeechBasisDigest(value: Omit<SpeechBasis, "basisDigest">): Digest {- return digestOf(value);-}--export function computeAlignedTranscriptEvidenceDigest(- value: Omit<AlignedTranscriptEvidence, "evidenceDigest">,-): Digest {- return digestOf(value);-}--export function computeSpeechEvidenceAudioDigest(- value: Omit<SpeechEvidenceAudio, "evidenceAudioDigest">,-): Digest {- return digestOf(value);}/** Round one 48 kHz master-sample boundary onto the canonical 16 kHz evidence clock. */@@ -70,8 +35,8 @@ export function speechEvidenceSampleBoundary(masterSampleBoundary: number): numbreturn Number(value);}-export function sealProgramSpace(value: Omit<ProgramSpace, "digest">): ProgramSpace {- return { ...value, digest: computeProgramSpaceDigest(value) };+export function sealProgramSpace(value: ProgramSpace): ProgramSpace {+ return structuredClone(value);}export function programSpaceFrameCount(programSpace: ProgramSpace): number {@@ -102,10 +67,6 @@ export function programSpaceSampleFrames(programSpace: ProgramSpace, sampleRate:export function assertProgramSpaceIdentity(programSpace: ProgramSpace): void {if (programSpace.contract !== "svml.program-space@0") throw new Error("Unsupported ProgramSpace contract.");- const { digest: _digest, ...content } = programSpace;- if (!isDigest(programSpace.digest) || programSpace.digest !== computeProgramSpaceDigest(content)) {- throw new Error("ProgramSpace digest does not match its canonical contents.");- }const { numerator, denominator } = programSpace.frameRate;if (!Number.isSafeInteger(numerator)@@ -120,20 +81,20 @@ export function assertProgramSpaceIdentity(programSpace: ProgramSpace): void {programSpaceFrameCount(programSpace);}-export function sealSpeechBasis(value: Omit<SpeechBasis, "basisDigest">): SpeechBasis {- return { ...value, basisDigest: computeSpeechBasisDigest(value) };+export function sealSpeechBasis(value: SpeechBasis): SpeechBasis {+ return structuredClone(value);}export function sealAlignedTranscriptEvidence(- value: Omit<AlignedTranscriptEvidence, "evidenceDigest">,+ value: AlignedTranscriptEvidence,): AlignedTranscriptEvidence {- return { ...value, evidenceDigest: computeAlignedTranscriptEvidenceDigest(value) };+ return structuredClone(value);}export function sealSpeechEvidenceAudio(- value: Omit<SpeechEvidenceAudio, "evidenceAudioDigest">,+ value: SpeechEvidenceAudio,): SpeechEvidenceAudio {- return { ...value, evidenceAudioDigest: computeSpeechEvidenceAudioDigest(value) };+ return structuredClone(value);}export function assertSpeechEvidenceAudioIdentity(value: SpeechEvidenceAudio): void {@@ -141,9 +102,7 @@ export function assertSpeechEvidenceAudioIdentity(value: SpeechEvidenceAudio): vthrow new Error("Unsupported SpeechEvidenceAudio contract.");}if (- !isDigest(value.programSpaceDigest)- || !isDigest(value.sourceAudioArtifactDigest)- || value.artifact.kind !== "blob"+ value.artifact.kind !== "blob"|| !isDigest(value.artifact.digest)|| !Number.isSafeInteger(value.artifact.size)|| value.artifact.size < 0@@ -167,26 +126,16 @@ export function assertSpeechEvidenceAudioIdentity(value: SpeechEvidenceAudio): v|| value.sampleMap.evidenceSampleFrames !== value.sampleFrames|| value.sampleMap.sourceOriginSample !== 0|| value.sampleMap.evidenceOriginSample !== 0- || value.sampleMap.resamplerImplementation.length === 0|| speechEvidenceSampleBoundary(value.sampleMap.sourceSampleFrames) !== value.sampleFrames) {throw new Error("SpeechEvidenceAudio sample map is invalid.");}if (value.segments.length === 0) throw new Error("SpeechEvidenceAudio has no Segment identity.");- const { evidenceAudioDigest: _digest, ...content } = value;- if (!isDigest(value.evidenceAudioDigest)- || value.evidenceAudioDigest !== computeSpeechEvidenceAudioDigest(content)) {- throw new Error("SpeechEvidenceAudio digest does not match its canonical contents.");- }}export function assertSpeechBasisIdentity(basis: SpeechBasis): void {if (basis.contract !== "svml.speech-basis@1") throw new Error("Unsupported SpeechBasis contract.");assertProgramSpaceIdentity(basis.programSpace);- const { basisDigest: _basisDigest, ...basisContent } = basis;- if (!isDigest(basis.basisDigest) || basis.basisDigest !== computeSpeechBasisDigest(basisContent)) {- throw new Error("SpeechBasis digest does not match its canonical contents.");- }if (!Number.isFinite(basis.programSpace.durationSec)|| basis.programSpace.durationSec <= 0@@ -198,11 +147,8 @@ export function assertSpeechBasisIdentity(basis: SpeechBasis): void {}/**- * Validate the self-contained identity claims of an audio projection.- *- * `basisDigest` names the complete SpeechBasis Product, so it intentionally- * cannot be recomputed from this projection after the visual fields have been- * removed. The graph-level affinity constraints prove that relationship.+ * Validate the intrinsic content of an audio projection. Its relationship to+ * a SpeechBasis is an explicit graph edge recorded by Core.*/export function assertSpeechAudioBasisIdentity(basis: SpeechAudioBasis): void {if (basis.contract !== "svml.speech-audio-basis@1") {diff --git a/packages/contracts/src/index.ts b/packages/contracts/src/index.tsindex 64c93d06..9f4856bb 100644--- a/packages/contracts/src/index.ts+++ b/packages/contracts/src/index.ts@@ -11,11 +11,6 @@ export {assertSpeechAudioBasisIdentity,assertSpeechBasisIdentity,assertSpeechEvidenceAudioIdentity,- computeAlignedTranscriptEvidenceDigest,- computeProgramSpaceDigest,- computeSpeechDurationDigest,- computeSpeechBasisDigest,- computeSpeechEvidenceAudioDigest,programSpaceFrameCount,programSpaceSampleFrames,sealAlignedTranscriptEvidence,@@ -121,9 +116,6 @@ export {assertAudioTrackIdentity,assertCompositionIdentity,assertVisualTrackIdentity,- computeAudioTrackDigest,- computeCompositionDigest,- computeVisualTrackDigest,sealAudioTrack,sealComposition,sealVisualTrack,diff --git a/packages/contracts/src/manifest.ts b/packages/contracts/src/manifest.tsindex 69769248..c838ac72 100644--- a/packages/contracts/src/manifest.ts+++ b/packages/contracts/src/manifest.ts@@ -118,7 +118,6 @@ export const narrativeSchema: ValueSchema = object({segmentId: { schema: string }, tokenId: { schema: string, optional: true },segmentTokenIndex: { schema: integer, optional: true },}) } },- digest: { schema: digest },}) },serializations: { schema: object({dialogue: { schema: { kind: "string" } }, speech: { schema: { kind: "string" } },@@ -135,7 +134,6 @@ export const narrativeExcerptSchema: ValueSchema = object({dialogue: { schema: { kind: "string" } },speech: { schema: { kind: "string" } },}) },- excerptDigest: { schema: digest },});export const narrativeDialogueExcerptSchema: ValueSchema = object({@@ -145,7 +143,6 @@ export const narrativeDialogueExcerptSchema: ValueSchema = object({tokenStart: { schema: integer },tokenEndExclusive: { schema: integer },dialogue: { schema: string },- excerptDigest: { schema: digest },});export const narrativeSpeechExcerptSchema: ValueSchema = object({@@ -155,7 +152,6 @@ export const narrativeSpeechExcerptSchema: ValueSchema = object({tokenStart: { schema: integer },tokenEndExclusive: { schema: integer },speech: { schema: string },- excerptDigest: { schema: digest },});export const captionProjectionSchema: ValueSchema = object({@@ -171,7 +167,6 @@ export const captionProjectionSchema: ValueSchema = object({relation: { schema: { kind: "literal", value: "exact" } },}) } },}) } },- projectionDigest: { schema: digest },});export const narrativeSelectionSchema: ValueSchema = object({@@ -180,7 +175,6 @@ export const narrativeSelectionSchema: ValueSchema = object({occurrences: { schema: { kind: "array", minItems: 1, items: object({occurrence: { schema: integer }, open: { schema: markerEdge }, close: { schema: markerEdge },}) } },- selectionDigest: { schema: digest },});export const mediaArtifactSchema = object({@@ -241,7 +235,6 @@ const mediaOtherStreamSchema = object({export const mediaInspectionSchema: ValueSchema = object({contract: { schema: { kind: "literal", value: "svml.media-inspection@1" } },- source: { schema: blobArtifactSchema() },container: { schema: object({formatNames: { schema: { kind: "array", minItems: 1, items: string } },}) },@@ -249,11 +242,6 @@ export const mediaInspectionSchema: ValueSchema = object({kind: "array",items: { kind: "oneOf", variants: [mediaVideoStreamSchema, mediaAudioStreamSchema, mediaOtherStreamSchema] },} },- probe: { schema: object({- algorithm: { schema: { kind: "literal", value: "ffprobe-decoded-units-json@1" } },- implementation: { schema: string },- }) },- inspectionDigest: { schema: digest },});export const mediaStreamSelectionSchema: ValueSchema = object({@@ -264,7 +252,6 @@ export const mediaStreamSelectionSchema: ValueSchema = object({policy: { schema: { kind: "string", enum: ["primary-moving@1", "default-audio@1", "primary-moving-default-audio@1", "explicit-streams@1",] } },- selectionDigest: { schema: digest },});export const synchronizedMediaSchema: ValueSchema = object({@@ -303,17 +290,10 @@ export const synchronizedMediaSchema: ValueSchema = object({sampleFrames: { schema: { kind: "number", integer: true, minimum: 1 } },loudness: { schema: { kind: "literal", value: "preserved" } },}), optional: true },- normalization: { schema: object({- algorithm: { schema: { kind: "literal", value: "shared-presentation-origin@1" } },- implementation: { schema: string },- }) },- synchronizedMediaDigest: { schema: digest },});export const renderedVisualSchema: ValueSchema = object({contract: { schema: { kind: "literal", value: "svml.rendered-visual@1" } },- renderInputDigest: { schema: digest },- programSpaceDigest: { schema: digest },frameRate: { schema: mediaRationalSchema },frameCount: { schema: { kind: "number", integer: true, minimum: 1 } },canvas: { schema: object({@@ -322,27 +302,20 @@ export const renderedVisualSchema: ValueSchema = object({}) },artifact: { schema: blobArtifactSchema() },muted: { schema: { kind: "literal", value: true } },- visualDigest: { schema: digest },});export const timelineAudioSchema: ValueSchema = object({contract: { schema: { kind: "literal", value: "svml.timeline-audio@1" } },- planDigest: { schema: digest },- programSpaceDigest: { schema: digest },artifact: { schema: blobArtifactSchema(["audio/wav"]) },codec: { schema: { kind: "literal", value: "pcm_s16le" } },sampleRate: { schema: { kind: "literal", value: 48_000 } },channels: { schema: { kind: "literal", value: 2 } },sampleFrames: { schema: { kind: "number", integer: true, minimum: 1 } },loudness: { schema: { kind: "literal", value: "planned" } },- audioDigest: { schema: digest },});export const muxedMediaSchema: ValueSchema = object({contract: { schema: { kind: "literal", value: "svml.muxed-media@1" } },- visualDigest: { schema: digest },- audioDigest: { schema: digest },- programSpaceDigest: { schema: digest },frameRate: { schema: mediaRationalSchema },frameCount: { schema: { kind: "number", integer: true, minimum: 1 } },canvas: { schema: object({@@ -351,7 +324,6 @@ export const muxedMediaSchema: ValueSchema = object({}) },presentationSampleFrames: { schema: { kind: "number", integer: true, minimum: 1 } },artifact: { schema: blobArtifactSchema(["video/mp4"]) },- muxDigest: { schema: digest },});export const fontArtifactSchema: ValueSchema = object({contract: { schema: { kind: "literal", value: "svml.font-artifact@1" } },@@ -381,7 +353,7 @@ export const compositableSurfaceSchema: ValueSchema = object({});export const programSpaceSchema = object({contract: { schema: { kind: "literal", value: "svml.program-space@0" } },- digest: { schema: digest }, durationSec: { schema: number },+ durationSec: { schema: number },frameRate: { schema: object({ numerator: { schema: integer }, denominator: { schema: integer } }) },});const basisSegment = object({@@ -390,7 +362,6 @@ const basisSegment = object({export const speechBasisSchema: ValueSchema = object({contract: { schema: { kind: "literal", value: "svml.speech-basis@1" } },- basisDigest: { schema: digest },programSpace: { schema: programSpaceSchema }, audio: { schema: mediaArtifactSchema },visualTrack: { schema: object({ clips: { schema: { kind: "array", items: object({segmentId: { schema: string }, artifact: { schema: mediaArtifactSchema }, startSec: { schema: number }, endSec: { schema: number },@@ -400,12 +371,7 @@ export const speechBasisSchema: ValueSchema = object({export const speechDurationSchema: ValueSchema = object({contract: { schema: { kind: "literal", value: "svml.speech-duration@1" } },- segmentId: { schema: string },- tokenStart: { schema: integer },- tokenEndExclusive: { schema: integer },- sourceSpeechExcerptDigest: { schema: digest },durationSec: { schema: { kind: "number", minimum: 0.000001 } },- durationDigest: { schema: digest },});export const speechAudioBasisSchema: ValueSchema = object({@@ -416,7 +382,6 @@ export const speechAudioBasisSchema: ValueSchema = object({export const speechEvidenceAudioSchema: ValueSchema = object({contract: { schema: { kind: "literal", value: "svml.speech-evidence-audio@1" } },- programSpaceDigest: { schema: digest }, sourceAudioArtifactDigest: { schema: digest },artifact: { schema: blobArtifactSchema(["audio/wav"]) },codec: { schema: { kind: "literal", value: "pcm_s16le" } },sampleRate: { schema: { kind: "literal", value: 16_000 } },@@ -432,9 +397,7 @@ export const speechEvidenceAudioSchema: ValueSchema = object({evidenceSampleFrames: { schema: { kind: "number", integer: true, minimum: 1 } },sourceOriginSample: { schema: { kind: "literal", value: 0 } },evidenceOriginSample: { schema: { kind: "literal", value: 0 } },- resamplerImplementation: { schema: string },}) },- evidenceAudioDigest: { schema: digest },});const wordEvidence = object({@@ -447,8 +410,7 @@ const charEvidence = object({});export const alignedTranscriptEvidenceFields = {contract: { schema: { kind: "literal", value: "svml.aligned-transcript-evidence@1" } },- audioArtifactDigest: { schema: digest }, programSpaceDigest: { schema: digest },- evidenceDigest: { schema: digest }, durationSec: { schema: number },+ durationSec: { schema: number },segments: { schema: { kind: "array", minItems: 1, items: object({sourceSegmentId: { schema: string }, startSec: { schema: number }, endSec: { schema: number },words: { schema: { kind: "array", items: wordEvidence } },@@ -486,12 +448,11 @@ const alignmentGroup = object({export const completeSemanticMapSchema: ValueSchema = object({contract: { schema: { kind: "literal", value: "svml.complete-semantic-map@1" } },- programSpace: { schema: programSpaceSchema },quantizationPolicy: { schema: { kind: "literal", value: "nearest-frame" } }, durationSec: { schema: number },segments: { schema: { kind: "array", items: timedSegment } },tokens: { schema: { kind: "array", items: timedToken } },anchors: { schema: { kind: "array", items: semanticPoint } },- groups: { schema: { kind: "array", items: alignmentGroup } }, mapDigest: { schema: digest },+ groups: { schema: { kind: "array", items: alignmentGroup } },});const styleDeclaration: ValueSchema = {@@ -560,9 +521,7 @@ const visualPresent = object({export const visualTrackSchema: ValueSchema = object({contract: { schema: { kind: "literal", value: "svml.visual-track@1" } },visualIr: { schema: { kind: "literal", value: HYPERFRAMES_VISUAL_IR_V1 } },- digest: { schema: digest },id: { schema: string },- programSpaceDigest: { schema: digest },presents: { schema: { kind: "array", items: visualPresent } },});@@ -580,17 +539,13 @@ const audioClip = object({export const audioTrackSchema: ValueSchema = object({contract: { schema: { kind: "literal", value: "svml.audio-track@1" } },- digest: { schema: digest },id: { schema: string },- programSpaceDigest: { schema: digest },clips: { schema: { kind: "array", items: audioClip } },});export const compositionSchema: ValueSchema = object({contract: { schema: { kind: "literal", value: "svml.composition@1" } },- digest: { schema: digest },id: { schema: string },- programSpace: { schema: programSpaceSchema },canvas: { schema: object({width: { schema: integer },height: { schema: integer },diff --git a/packages/contracts/src/media-identity.ts b/packages/contracts/src/media-identity.tsindex e9d49e7a..713c8c0e 100644--- a/packages/contracts/src/media-identity.ts+++ b/packages/contracts/src/media-identity.ts@@ -1,9 +1,8 @@import {canonicalize,- digestOf,isDigest,} from "@svml/protocol";-import type { BlobRef, Digest } from "@svml/protocol";+import type { BlobRef } from "@svml/protocol";import type {MediaInspection,@@ -109,11 +108,6 @@ function verifyStream(value: unknown, subject: string): asserts value is MediaSt}}-function contentDigest<T extends object, K extends keyof T>(value: T, key: K): Digest {- const { [key]: _digest, ...content } = value;- return digestOf(canonicalize(content));-}-function expectedSampleFrames(frameCount: number, frameRate: MediaRational): number {const numerator = BigInt(frameCount) * 48_000n * BigInt(frameRate.denominator);const denominator = BigInt(frameRate.numerator);@@ -122,15 +116,13 @@ function expectedSampleFrames(frameCount: number, frameRate: MediaRational): numreturn Number(rounded);}-export function sealMediaInspection(value: Omit<MediaInspection, "inspectionDigest">): MediaInspection {- const normalized = canonicalize(value) as unknown as Omit<MediaInspection, "inspectionDigest">;- return { ...normalized, inspectionDigest: digestOf(normalized) };+export function sealMediaInspection(value: MediaInspection): MediaInspection {+ return canonicalize(value) as unknown as MediaInspection;}export function verifyMediaInspection(value: unknown): asserts value is MediaInspection {const item = object(value, "MediaInspection") as unknown as MediaInspection;assert(item.contract === "svml.media-inspection@1", "MediaInspection contract is invalid");- verifyBlob(item.source, "MediaInspection.source");assert(Array.isArray(item.container?.formatNames), "MediaInspection container formats are invalid");item.container.formatNames.forEach((format) => assert(typeof format === "string" && format.length > 0,"MediaInspection container format is invalid"));@@ -138,18 +130,10 @@ export function verifyMediaInspection(value: unknown): asserts value is MediaInsitem.streams.forEach((stream, index) => verifyStream(stream, `MediaInspection.streams[${index}]`));assert(new Set(item.streams.map((stream) => stream.index)).size === item.streams.length,"MediaInspection repeats a stream index");- assert(item.probe?.algorithm === "ffprobe-decoded-units-json@1", "MediaInspection probe algorithm is invalid");- assert(typeof item.probe.implementation === "string" && item.probe.implementation.length > 0,- "MediaInspection probe implementation is invalid");- assert(isDigest(item.inspectionDigest) && item.inspectionDigest === contentDigest(item, "inspectionDigest"),- "MediaInspection digest differs from its canonical contents");}-export function sealMediaStreamSelection(- value: Omit<MediaStreamSelection, "selectionDigest">,-): MediaStreamSelection {- const normalized = canonicalize(value) as unknown as Omit<MediaStreamSelection, "selectionDigest">;- return { ...normalized, selectionDigest: digestOf(normalized) };+export function sealMediaStreamSelection(value: MediaStreamSelection): MediaStreamSelection {+ return canonicalize(value) as unknown as MediaStreamSelection;}export function verifyMediaStreamSelection(value: unknown): asserts value is MediaStreamSelection {@@ -165,15 +149,10 @@ export function verifyMediaStreamSelection(value: unknown): asserts value is Medassert(item.policy === "primary-moving@1" || item.policy === "default-audio@1"|| item.policy === "primary-moving-default-audio@1" || item.policy === "explicit-streams@1","MediaStreamSelection policy is invalid");- assert(isDigest(item.selectionDigest) && item.selectionDigest === contentDigest(item, "selectionDigest"),- "MediaStreamSelection digest differs from its canonical contents");}-export function sealSynchronizedMedia(- value: Omit<SynchronizedMedia, "synchronizedMediaDigest">,-): SynchronizedMedia {- const normalized = canonicalize(value) as unknown as Omit<SynchronizedMedia, "synchronizedMediaDigest">;- return { ...normalized, synchronizedMediaDigest: digestOf(normalized) };+export function sealSynchronizedMedia(value: SynchronizedMedia): SynchronizedMedia {+ return canonicalize(value) as unknown as SynchronizedMedia;}export function verifySynchronizedMedia(value: unknown): asserts value is SynchronizedMedia {@@ -232,25 +211,15 @@ export function verifySynchronizedMedia(value: unknown): asserts value is Synchr"SynchronizedMedia video authority has no visual projection");assert(item.timeline.spanAuthority !== "audio" || item.audio !== undefined,"SynchronizedMedia audio authority has no audio projection");- assert(item.normalization.algorithm === "shared-presentation-origin@1",- "SynchronizedMedia normalization algorithm is invalid");- assert(typeof item.normalization.implementation === "string" && item.normalization.implementation.length > 0,- "SynchronizedMedia normalization implementation is invalid");- assert(isDigest(item.synchronizedMediaDigest)- && item.synchronizedMediaDigest === contentDigest(item, "synchronizedMediaDigest"),- "SynchronizedMedia digest differs from its canonical contents");}-export function sealRenderedVisual(value: Omit<RenderedVisual, "visualDigest">): RenderedVisual {- const normalized = canonicalize(value) as unknown as Omit<RenderedVisual, "visualDigest">;- return { ...normalized, visualDigest: digestOf(normalized) };+export function sealRenderedVisual(value: RenderedVisual): RenderedVisual {+ return canonicalize(value) as unknown as RenderedVisual;}export function verifyRenderedVisual(value: unknown): asserts value is RenderedVisual {const item = object(value, "RenderedVisual") as unknown as RenderedVisual;assert(item.contract === "svml.rendered-visual@1", "RenderedVisual contract is invalid");- assert(isDigest(item.renderInputDigest), "RenderedVisual input digest is invalid");- assert(isDigest(item.programSpaceDigest), "RenderedVisual ProgramSpace digest is invalid");verifyRational(item.frameRate, "RenderedVisual.frameRate");positiveInteger(item.frameCount, "RenderedVisual.frameCount");positiveInteger(item.canvas?.width, "RenderedVisual.canvas.width");@@ -258,41 +227,30 @@ export function verifyRenderedVisual(value: unknown): asserts value is RenderedVverifyBlob(item.artifact, "RenderedVisual.artifact");assert(item.artifact.mediaType.startsWith("video/"), "RenderedVisual Artifact must be video");assert(item.muted === true, "RenderedVisual must be silent");- assert(isDigest(item.visualDigest) && item.visualDigest === contentDigest(item, "visualDigest"),- "RenderedVisual digest differs from its canonical contents");}-export function sealTimelineAudio(value: Omit<TimelineAudio, "audioDigest">): TimelineAudio {- const normalized = canonicalize(value) as unknown as Omit<TimelineAudio, "audioDigest">;- return { ...normalized, audioDigest: digestOf(normalized) };+export function sealTimelineAudio(value: TimelineAudio): TimelineAudio {+ return canonicalize(value) as unknown as TimelineAudio;}export function verifyTimelineAudio(value: unknown): asserts value is TimelineAudio {const item = object(value, "TimelineAudio") as unknown as TimelineAudio;assert(item.contract === "svml.timeline-audio@1", "TimelineAudio contract is invalid");- assert(isDigest(item.planDigest), "TimelineAudio plan digest is invalid");- assert(isDigest(item.programSpaceDigest), "TimelineAudio ProgramSpace digest is invalid");verifyBlob(item.artifact, "TimelineAudio.artifact");assert(item.artifact.mediaType === "audio/wav", "TimelineAudio Artifact must be WAV");assert(item.codec === "pcm_s16le" && item.sampleRate === 48_000 && item.channels === 2,"TimelineAudio PCM shape is invalid");positiveInteger(item.sampleFrames, "TimelineAudio.sampleFrames");assert(item.loudness === "planned", "TimelineAudio loudness claim is invalid");- assert(isDigest(item.audioDigest) && item.audioDigest === contentDigest(item, "audioDigest"),- "TimelineAudio digest differs from its canonical contents");}-export function sealMuxedMedia(value: Omit<MuxedMedia, "muxDigest">): MuxedMedia {- const normalized = canonicalize(value) as unknown as Omit<MuxedMedia, "muxDigest">;- return { ...normalized, muxDigest: digestOf(normalized) };+export function sealMuxedMedia(value: MuxedMedia): MuxedMedia {+ return canonicalize(value) as unknown as MuxedMedia;}export function verifyMuxedMedia(value: unknown): asserts value is MuxedMedia {const item = object(value, "MuxedMedia") as unknown as MuxedMedia;assert(item.contract === "svml.muxed-media@1", "MuxedMedia contract is invalid");- assert(isDigest(item.visualDigest), "MuxedMedia visual digest is invalid");- assert(isDigest(item.audioDigest), "MuxedMedia audio digest is invalid");- assert(isDigest(item.programSpaceDigest), "MuxedMedia ProgramSpace digest is invalid");verifyRational(item.frameRate, "MuxedMedia.frameRate");positiveInteger(item.frameCount, "MuxedMedia.frameCount");positiveInteger(item.canvas?.width, "MuxedMedia.canvas.width");@@ -301,6 +259,4 @@ export function verifyMuxedMedia(value: unknown): asserts value is MuxedMedia {"MuxedMedia presentation sample count differs from its frame domain");verifyBlob(item.artifact, "MuxedMedia.artifact");assert(item.artifact.mediaType === "video/mp4", "MuxedMedia Artifact must be MP4");- assert(isDigest(item.muxDigest) && item.muxDigest === contentDigest(item, "muxDigest"),- "MuxedMedia digest differs from its canonical contents");}diff --git a/packages/contracts/src/media.ts b/packages/contracts/src/media.tsindex 4c42baaa..aecfcc5c 100644--- a/packages/contracts/src/media.ts+++ b/packages/contracts/src/media.ts@@ -1,4 +1,4 @@-import type { BlobRef, Digest } from "@svml/protocol";+import type { BlobRef } from "@svml/protocol";export type MediaRational = {readonly numerator: number;@@ -57,16 +57,10 @@ export type MediaStream = MediaVideoStream | MediaAudioStream | MediaOtherStream/** Immutable observed facts about one exact content-addressed container. */export type MediaInspection = {readonly contract: "svml.media-inspection@1";- readonly source: BlobRef;readonly container: {readonly formatNames: readonly string[];};readonly streams: readonly MediaStream[];- readonly probe: {- readonly algorithm: "ffprobe-decoded-units-json@1";- readonly implementation: string;- };- readonly inspectionDigest: Digest;};export type MediaStreamSelection = {@@ -79,7 +73,6 @@ export type MediaStreamSelection = {| "default-audio@1"| "primary-moving-default-audio@1"| "explicit-streams@1";- readonly selectionDigest: Digest;};export type SynchronizedMedia = {@@ -119,19 +112,11 @@ export type SynchronizedMedia = {/** Media normalization preserves level. Loudness/mastering is a separate author policy. */readonly loudness: "preserved";};- readonly normalization: {- readonly algorithm: "shared-presentation-origin@1";- readonly implementation: string;- };- readonly synchronizedMediaDigest: Digest;};/** Silent, frame-exact visual output from a renderer such as HyperFrames. */export type RenderedVisual = {readonly contract: "svml.rendered-visual@1";- /** Digest of the exact renderer input document/program. */- readonly renderInputDigest: Digest;- readonly programSpaceDigest: Digest;readonly frameRate: MediaRational;readonly frameCount: number;readonly canvas: {@@ -140,29 +125,22 @@ export type RenderedVisual = {};readonly artifact: BlobRef;readonly muted: true;- readonly visualDigest: Digest;};/** Exact 48 kHz stereo PCM result of one explicit timeline-audio plan. */export type TimelineAudio = {readonly contract: "svml.timeline-audio@1";- readonly planDigest: Digest;- readonly programSpaceDigest: Digest;readonly artifact: BlobRef;readonly codec: "pcm_s16le";readonly sampleRate: 48_000;readonly channels: 2;readonly sampleFrames: number;readonly loudness: "planned";- readonly audioDigest: Digest;};/** Final mux result; visual rendering and program-audio preparation remain separate facts. */export type MuxedMedia = {readonly contract: "svml.muxed-media@1";- readonly visualDigest: Digest;- readonly audioDigest: Digest;- readonly programSpaceDigest: Digest;readonly frameRate: MediaRational;readonly frameCount: number;readonly canvas: {@@ -171,5 +149,4 @@ export type MuxedMedia = {};readonly presentationSampleFrames: number;readonly artifact: BlobRef;- readonly muxDigest: Digest;};diff --git a/packages/contracts/src/narrative.ts b/packages/contracts/src/narrative.tsindex 4b80943b..2a39a3a3 100644--- a/packages/contracts/src/narrative.ts+++ b/packages/contracts/src/narrative.ts@@ -48,7 +48,6 @@ export type NarrativeSelection = {/** One explicitly authored semantic window, independently referenceable by graph edges. */export type NarrativeSelectionRef = NarrativeSelection & {readonly contract: "svml.narrative-selection@1";- readonly selectionDigest: Digest;};export type NarrativeMomentOccurrence = {@@ -89,9 +88,7 @@ export type CaptionProjection = {};/** Whole authored display projection. It contains no pronunciation replacement text. */-export type CaptionProjectionRef = CaptionProjection & {- readonly projectionDigest: Digest;-};+export type CaptionProjectionRef = CaptionProjection;export type SemanticAnchor = {readonly id: string;@@ -112,7 +109,6 @@ export type Narrative = {readonly semanticIndex: {readonly contract: "svml.semantic-index@0";readonly anchors: readonly SemanticAnchor[];- readonly digest: Digest;};readonly serializations: {readonly dialogue: string;@@ -135,7 +131,6 @@ export type NarrativeExcerpt = {readonly dialogue: string;readonly speech: string;};- readonly excerptDigest: Digest;};/** The exact dialogue prompt for one Segment, including only explicitly authored Role prefixes. */@@ -146,7 +141,6 @@ export type NarrativeDialogueExcerpt = {readonly tokenStart: number;readonly tokenEndExclusive: number;readonly dialogue: string;- readonly excerptDigest: Digest;};/** The exact spoken wording for one Segment, without Role prefixes. */@@ -157,6 +151,4 @@ export type NarrativeSpeechExcerpt = {readonly tokenStart: number;readonly tokenEndExclusive: number;readonly speech: string;- readonly excerptDigest: Digest;};-import type { Digest } from "@svml/protocol";diff --git a/packages/contracts/src/semantic-location.ts b/packages/contracts/src/semantic-location.tsindex c24f7fdd..abea7e01 100644--- a/packages/contracts/src/semantic-location.ts+++ b/packages/contracts/src/semantic-location.ts@@ -1,19 +1,12 @@-import { canonicalize, digestOf, isDigest } from "@svml/protocol";-import { assertProgramSpaceIdentity, programSpaceFrameCount } from "./identity.js";import type { NarrativeSelectionRef } from "./narrative.js";-import type { CompleteSemanticMap } from "./speech.js";+import type { CompleteSemanticMap, ProgramSpace } from "./speech.js";import type { FrameSpan } from "./track.js";export function assertCompleteSemanticMapIdentity(map: CompleteSemanticMap): void {if (map.contract !== "svml.complete-semantic-map@1") {throw new Error("Unsupported CompleteSemanticMap contract");}- assertProgramSpaceIdentity(map.programSpace);- const { mapDigest: _digest, ...content } = map;- if (!isDigest(map.mapDigest) || map.mapDigest !== digestOf(canonicalize(content))) {- throw new Error("CompleteSemanticMap digest differs from its contents");- }}export function assertNarrativeSelectionIdentity(selection: NarrativeSelectionRef): void {@@ -24,24 +17,21 @@ export function assertNarrativeSelectionIdentity(selection: NarrativeSelectionRe) {throw new Error("NarrativeSelection is invalid");}- const { selectionDigest: _digest, ...content } = selection;- if (!isDigest(selection.selectionDigest) || selection.selectionDigest !== digestOf(canonicalize(content))) {- throw new Error("NarrativeSelection digest differs from its contents");- }}function boundaryFrame(map: CompleteSemanticMap,+ programSpace: ProgramSpace,edge: NarrativeSelectionRef["occurrences"][number]["open"],side: "open" | "close",): number {const index = edge.boundary.tokenIndex;if (side === "open") {if (edge.affinity === "left" && index > 0) return map.tokens[index - 1]?.startFrame ?? 0;- return map.tokens[index]?.startFrame ?? programSpaceFrameCount(map.programSpace);+ return map.tokens[index]?.startFrame ?? programSpaceFrameCount(programSpace);}if (edge.affinity === "right" && index < map.tokens.length) {- return map.tokens[index]?.endFrame ?? programSpaceFrameCount(map.programSpace);+ return map.tokens[index]?.endFrame ?? programSpaceFrameCount(programSpace);}return index > 0 ? map.tokens[index - 1]?.endFrame ?? 0 : 0;}@@ -50,12 +40,14 @@ function boundaryFrame(export function selectionFrameSpans(map: CompleteSemanticMap,selection: NarrativeSelectionRef,+ programSpace: ProgramSpace,): readonly FrameSpan[] {assertCompleteSemanticMapIdentity(map);assertNarrativeSelectionIdentity(selection);+ assertProgramSpaceIdentity(programSpace);return selection.occurrences.map((occurrence) => {- const startFrame = boundaryFrame(map, occurrence.open, "open");- const endFrameExclusive = boundaryFrame(map, occurrence.close, "close");+ const startFrame = boundaryFrame(map, programSpace, occurrence.open, "open");+ const endFrameExclusive = boundaryFrame(map, programSpace, occurrence.close, "close");if (endFrameExclusive <= startFrame) {throw new Error(`NarrativeSelection ${selection.id} contains an empty located occurrence`);}diff --git a/packages/contracts/src/speech.ts b/packages/contracts/src/speech.tsindex 4c817d6f..6c6f531b 100644--- a/packages/contracts/src/speech.ts+++ b/packages/contracts/src/speech.ts@@ -11,17 +11,11 @@ export type TimingQuality = "measured" | "derived" | "estimated";*/export type SpeechDuration = {readonly contract: "svml.speech-duration@1";- readonly segmentId: string;- readonly tokenStart: number;- readonly tokenEndExclusive: number;- readonly sourceSpeechExcerptDigest: Digest;readonly durationSec: number;- readonly durationDigest: Digest;};export type ProgramSpace = {readonly contract: "svml.program-space@0";- readonly digest: Digest;readonly durationSec: number;readonly frameRate: {readonly numerator: number;@@ -44,7 +38,6 @@ export type SpeechBasisSegment = {export type SpeechBasis = {readonly contract: "svml.speech-basis@1";- readonly basisDigest: Digest;readonly programSpace: ProgramSpace;readonly audio: MediaArtifactRef;readonly visualTrack: {@@ -69,9 +62,6 @@ export type SpeechAudioBasis = {/** Canonical 16 kHz mono PCM projection used only for acoustic alignment evidence. */export type SpeechEvidenceAudio = {readonly contract: "svml.speech-evidence-audio@1";- readonly programSpaceDigest: Digest;- /** The 48 kHz speech-master bytes from which this projection was derived. */- readonly sourceAudioArtifactDigest: Digest;readonly artifact: BlobRef;readonly codec: "pcm_s16le";readonly sampleRate: 16_000;@@ -87,9 +77,7 @@ export type SpeechEvidenceAudio = {readonly evidenceSampleFrames: number;readonly sourceOriginSample: 0;readonly evidenceOriginSample: 0;- readonly resamplerImplementation: string;};- readonly evidenceAudioDigest: Digest;};export type SpeechWordEvidence = {@@ -123,10 +111,6 @@ export type AlignedTranscriptSegment = {export type AlignedTranscriptEvidence = {readonly contract: "svml.aligned-transcript-evidence@1";- /** Exact acoustic Artifact measured by the recognizer. */- readonly audioArtifactDigest: Digest;- readonly programSpaceDigest: Digest;- readonly evidenceDigest: Digest;readonly durationSec: number;readonly segments: readonly AlignedTranscriptSegment[];};@@ -178,12 +162,10 @@ export type SemanticTimePoint = {export type CompleteSemanticMap = {readonly contract: "svml.complete-semantic-map@1";- readonly programSpace: ProgramSpace;readonly quantizationPolicy: "nearest-frame";readonly durationSec: number;readonly segments: readonly TimedSpeechSegment[];readonly tokens: readonly TimedSpeechToken[];readonly anchors: readonly SemanticTimePoint[];readonly groups: readonly AlignmentGroup[];- readonly mapDigest: Digest;};diff --git a/packages/contracts/src/track.ts b/packages/contracts/src/track.tsindex 5ef8019d..46a1fd80 100644--- a/packages/contracts/src/track.ts+++ b/packages/contracts/src/track.ts@@ -1,5 +1,4 @@-import { digestOf, isDigest } from "@svml/protocol";-import type { Digest } from "@svml/protocol";+import { isDigest } from "@svml/protocol";import {assertHyperframesVisualStyleV1,@@ -101,9 +100,7 @@ export type VisualTrack = {readonly contract: "svml.visual-track@1";/** The one terminal visual language shared by official video components. */readonly visualIr: typeof HYPERFRAMES_VISUAL_IR_V1;- readonly digest: Digest;readonly id: string;- readonly programSpaceDigest: Digest;/** Author-owned contributions that Composition may interleave by absolute z. */readonly presents: readonly VisualPresent[];};@@ -122,9 +119,7 @@ export type AudioClip = {export type AudioTrack = {readonly contract: "svml.audio-track@1";- readonly digest: Digest;readonly id: string;- readonly programSpaceDigest: Digest;readonly clips: readonly AudioClip[];};@@ -132,9 +127,7 @@ export type Track = VisualTrack | AudioTrack;export type Composition = {readonly contract: "svml.composition@1";- readonly digest: Digest;readonly id: string;- readonly programSpace: ProgramSpace;readonly canvas: {readonly width: number;readonly height: number;@@ -401,12 +394,11 @@ function normalizeElement(element: VisualElement): VisualElement {};}-function visualTrackContent(value: Omit<VisualTrack, "digest">): Omit<VisualTrack, "digest"> {+function visualTrackContent(value: VisualTrack): VisualTrack {return {contract: "svml.visual-track@1",visualIr: value.visualIr,id: value.id,- programSpaceDigest: value.programSpaceDigest,presents: [...value.presents].map((present) => ({id: present.id,@@ -421,11 +413,10 @@ function visualTrackContent(value: Omit<VisualTrack, "digest">): Omit<VisualTrac};}-function audioTrackContent(value: Omit<AudioTrack, "digest">): Omit<AudioTrack, "digest"> {+function audioTrackContent(value: AudioTrack): AudioTrack {return {contract: "svml.audio-track@1",id: value.id,- programSpaceDigest: value.programSpaceDigest,clips: [...value.clips].map((clip) => ({id: clip.id,@@ -442,22 +433,12 @@ function audioTrackContent(value: Omit<AudioTrack, "digest">): Omit<AudioTrack,};}-export function computeVisualTrackDigest(value: Omit<VisualTrack, "digest">): Digest {- return digestOf(visualTrackContent(value));+export function sealVisualTrack(value: VisualTrack): VisualTrack {+ return visualTrackContent(value);}-export function computeAudioTrackDigest(value: Omit<AudioTrack, "digest">): Digest {- return digestOf(audioTrackContent(value));-}--export function sealVisualTrack(value: Omit<VisualTrack, "digest">): VisualTrack {- const content = visualTrackContent(value);- return { ...content, digest: digestOf(content) };-}--export function sealAudioTrack(value: Omit<AudioTrack, "digest">): AudioTrack {- const content = audioTrackContent(value);- return { ...content, digest: digestOf(content) };+export function sealAudioTrack(value: AudioTrack): AudioTrack {+ return audioTrackContent(value);}export function assertVisualTrackIdentity(track: VisualTrack, programSpace?: ProgramSpace): void {@@ -465,14 +446,6 @@ export function assertVisualTrackIdentity(track: VisualTrack, programSpace?: Proif (track.contract !== "svml.visual-track@1") throw new Error("Unsupported VisualTrack contract.");if (track.visualIr !== HYPERFRAMES_VISUAL_IR_V1) throw new Error("Unsupported VisualTrack visual IR.");assertNonEmpty(track.id, "VisualTrack id");- if (!isDigest(track.programSpaceDigest)) throw new Error(`${track.id} has an invalid ProgramSpace digest.`);- if (programSpace !== undefined && track.programSpaceDigest !== programSpace.digest) {- throw new Error(`${track.id} belongs to another ProgramSpace.`);- }- const { digest: _digest, ...content } = track;- if (!isDigest(track.digest) || track.digest !== computeVisualTrackDigest(content)) {- throw new Error(`${track.id} VisualTrack digest does not match its contents.`);- }const presentIds = new Set<string>();for (const present of track.presents) {if (presentIds.has(present.id)) throw new Error(`${track.id} has duplicate Present ${present.id}.`);@@ -485,14 +458,6 @@ export function assertAudioTrackIdentity(track: AudioTrack, programSpace?: Progrif (programSpace !== undefined) assertProgramSpaceIdentity(programSpace);if (track.contract !== "svml.audio-track@1") throw new Error("Unsupported AudioTrack contract.");assertNonEmpty(track.id, "AudioTrack id");- if (!isDigest(track.programSpaceDigest)) throw new Error(`${track.id} has an invalid ProgramSpace digest.`);- if (programSpace !== undefined && track.programSpaceDigest !== programSpace.digest) {- throw new Error(`${track.id} belongs to another ProgramSpace.`);- }- const { digest: _digest, ...content } = track;- if (!isDigest(track.digest) || track.digest !== computeAudioTrackDigest(content)) {- throw new Error(`${track.id} AudioTrack digest does not match its contents.`);- }const totalFrames = programSpace === undefined ? Number.MAX_SAFE_INTEGER : programSpaceFrameCount(programSpace);const clipIds = new Set<string>();for (const clip of track.clips) {@@ -524,33 +489,23 @@ function trackKey(track: Track): string {return `${track.contract}\u0000${track.id}`;}-function compositionContent(value: Omit<Composition, "digest">): Omit<Composition, "digest"> {+function compositionContent(value: Composition): Composition {return {contract: "svml.composition@1",id: value.id,- programSpace: { ...value.programSpace, frameRate: { ...value.programSpace.frameRate } },canvas: { ...value.canvas },tracks: [...value.tracks].map((track) => structuredClone(track)).sort((a, b) => trackKey(a).localeCompare(trackKey(b))),};}-export function computeCompositionDigest(value: Omit<Composition, "digest">): Digest {- return digestOf(compositionContent(value));-}--export function sealComposition(value: Omit<Composition, "digest">): Composition {- const content = compositionContent(value);- return { ...content, digest: digestOf(content) };+export function sealComposition(value: Composition): Composition {+ return compositionContent(value);}-export function assertCompositionIdentity(composition: Composition): void {+export function assertCompositionIdentity(composition: Composition, programSpace?: ProgramSpace): void {if (composition.contract !== "svml.composition@1") throw new Error("Unsupported Composition contract.");assertNonEmpty(composition.id, "Composition id");- assertProgramSpaceIdentity(composition.programSpace);- const { digest: _digest, ...content } = composition;- if (!isDigest(composition.digest) || composition.digest !== computeCompositionDigest(content)) {- throw new Error("Composition digest does not match its contents.");- }+ if (programSpace !== undefined) assertProgramSpaceIdentity(programSpace);if (!Number.isSafeInteger(composition.canvas.width)|| composition.canvas.width <= 0@@ -566,7 +521,7 @@ export function assertCompositionIdentity(composition: Composition): void {if (ids.has(track.id)) throw new Error(`Composition contains duplicate Track id ${track.id}.`);ids.add(track.id);if (track.contract === "svml.visual-track@1") {- assertVisualTrackIdentity(track, composition.programSpace);+ assertVisualTrackIdentity(track, programSpace);for (const present of track.presents) {const key = `${present.stacking.order}\u0000${present.stacking.tieBreak}`;const peers = stacking.get(key) ?? [];@@ -583,7 +538,7 @@ export function assertCompositionIdentity(composition: Composition): void {stacking.set(key, peers);}} else {- assertAudioTrackIdentity(track, composition.programSpace);+ assertAudioTrackIdentity(track, programSpace);}}}diff --git a/packages/contracts/test/render.test.ts b/packages/contracts/test/render.test.tsindex 8825a675..2756e40c 100644--- a/packages/contracts/test/render.test.ts+++ b/packages/contracts/test/render.test.ts@@ -85,7 +85,6 @@ test("exact fonts own font selection and cannot conflict with raw CSS font factscontract: "svml.visual-track@1",visualIr: "svml.hyperframes-visual-ir@1",id: "invalid-font-track",- programSpaceDigest: space.digest,presents: [{id: "title",span: { startFrame: 0, endFrameExclusive: 60 },@@ -104,10 +103,9 @@ test("exact fonts own font selection and cannot conflict with raw CSS font facts() => assertCompositionIdentity(sealComposition({contract: "svml.composition@1",id: "invalid-font-composition",- programSpace: space,canvas: { width: 1080, height: 1920, clearColor: "#000000" },tracks: [invalid],- })),+ }), space),/exact fonts conflict with a raw font style/u,);});@@ -117,7 +115,6 @@ test("animated materialized Surfaces must exactly share the Present frame domaincontract: "svml.visual-track@1",visualIr: "svml.hyperframes-visual-ir@1",id: "surface-track",- programSpaceDigest: space.digest,presents: [{id: "surface",span: { startFrame: 0, endFrameExclusive: 60 },@@ -128,10 +125,9 @@ test("animated materialized Surfaces must exactly share the Present frame domainassert.doesNotThrow(() => assertCompositionIdentity(sealComposition({contract: "svml.composition@1",id: "surface-composition",- programSpace: space,canvas: { width: 1080, height: 1920, clearColor: "#000000" },tracks: [valid],- })));+ }), space));const content = structuredClone(valid) as VisualTrack;const surface = content.presents[0]!.elements[0]!;@@ -153,8 +149,7 @@ test("animated materialized Surfaces must exactly share the Present frame domainassert.throws(() => assertCompositionIdentity(sealComposition({contract: "svml.composition@1",id: "invalid-surface-composition",- programSpace: space,canvas: { width: 1080, height: 1920, clearColor: "#000000" },tracks: [invalid],- })), /must exactly match its Present frame domain/u);+ }), space), /must exactly match its Present frame domain/u);});diff --git a/packages/contracts/test/speech-evidence.test.ts b/packages/contracts/test/speech-evidence.test.tsindex 9448664d..fcc74f58 100644--- a/packages/contracts/test/speech-evidence.test.ts+++ b/packages/contracts/test/speech-evidence.test.ts@@ -23,11 +23,9 @@ test("speech evidence uses integer rational boundary projection rather than floaassert.equal(programSpaceSampleFrames(ntsc, 48_000), 48_048);});-test("SpeechEvidenceAudio binds source bytes, evidence bytes and the complete sample map", () => {+test("SpeechEvidenceAudio records evidence bytes and the complete source-to-evidence sample map", () => {const value = sealSpeechEvidenceAudio({contract: "svml.speech-evidence-audio@1",- programSpaceDigest: digestOf("program"),- sourceAudioArtifactDigest: digestOf("master"),artifact: {kind: "blob",digest: digestOf("evidence"),@@ -48,7 +46,6 @@ test("SpeechEvidenceAudio binds source bytes, evidence bytes and the complete saevidenceSampleFrames: 16_000,sourceOriginSample: 0,evidenceOriginSample: 0,- resamplerImplementation: "fixture",},});assert.doesNotThrow(() => assertSpeechEvidenceAudioIdentity(value));diff --git a/packages/contracts/test/track.test.ts b/packages/contracts/test/track.test.tsindex 3737faa3..6e8079f2 100644--- a/packages/contracts/test/track.test.ts+++ b/packages/contracts/test/track.test.ts@@ -43,7 +43,6 @@ function fixture() {contract: "svml.visual-track@1",visualIr: "svml.hyperframes-visual-ir@1",id: "caption",- programSpaceDigest: programSpace.digest,presents: [{id: "cue-1",span: { startFrame: 0, endFrameExclusive: 60 },@@ -57,7 +56,6 @@ function fixture() {const sound = sealAudioTrack({contract: "svml.audio-track@1",id: "speech",- programSpaceDigest: programSpace.digest,clips: [{ id: "speech", span: { startFrame: 0, endFrameExclusive: 120 }, artifact: audio, bus: "speech" }],});return { programSpace, visual, sound };@@ -69,11 +67,10 @@ test("Composition accepts self-contained peer VisualTrack and AudioTrack values"const composition = sealComposition({contract: "svml.composition@1",id: "main",- programSpace,canvas: { width: 1080, height: 1920, clearColor: "#000000" },tracks: [sound, visual],});- assert.doesNotThrow(() => assertCompositionIdentity(composition));+ assert.doesNotThrow(() => assertCompositionIdentity(composition, programSpace));assert.deepEqual(composition.tracks.map((track) => track.id), ["speech", "caption"]);});@@ -82,11 +79,10 @@ test("Composition accepts case-insensitive hexadecimal canvas colors", () => {const composition = sealComposition({contract: "svml.composition@1",id: "uppercase-color",- programSpace,canvas: { width: 480, height: 854, clearColor: "#09090B" },tracks: [visual],});- assert.doesNotThrow(() => assertCompositionIdentity(composition));+ assert.doesNotThrow(() => assertCompositionIdentity(composition, programSpace));});test("VisualTrack rejects cross-Track pixel sampling styles", () => {@@ -103,11 +99,10 @@ test("VisualTrack rejects cross-Track pixel sampling styles", () => {const composition = sealComposition({contract: "svml.composition@1",id: "invasive",- programSpace,canvas: { width: 1080, height: 1920, clearColor: "#000000" },tracks: [sound, invasive],});- assert.throws(() => assertCompositionIdentity(composition), /cross-Track style backdrop-filter/);+ assert.throws(() => assertCompositionIdentity(composition, programSpace), /cross-Track style backdrop-filter/);});test("VisualTrack style values cannot smuggle a second declaration", () => {@@ -125,10 +120,9 @@ test("VisualTrack style values cannot smuggle a second declaration", () => {() => assertCompositionIdentity(sealComposition({contract: "svml.composition@1",id: "smuggled",- programSpace,canvas: { width: 1080, height: 1920, clearColor: "#000000" },tracks: [smuggled],- })),+ }), programSpace),/escapes its declaration/,);});@@ -147,10 +141,9 @@ test("VisualTrack cannot silently extend the versioned HyperFrames Visual IR", (() => assertCompositionIdentity(sealComposition({contract: "svml.composition@1",id: "unknown-style",- programSpace,canvas: { width: 1080, height: 1920, clearColor: "#000000" },tracks: [unknownStyle],- })),+ }), programSpace),/outside svml\.hyperframes-visual-ir@1/u,);@@ -217,36 +210,35 @@ test("the Type owner rejects an invalid VisualTrack at the shared admission gate);});-test("Composition rejects a Track from another ProgramSpace even when its shape is valid", () => {+test("Composition validates Track frame ranges against the explicitly connected ProgramSpace", () => {const { programSpace, visual } = fixture();const foreign = sealProgramSpace({contract: "svml.program-space@0",- durationSec: 4,+ durationSec: 1,frameRate: { numerator: 24, denominator: 1 },});const composition = sealComposition({contract: "svml.composition@1",id: "foreign",- programSpace: foreign,canvas: { width: 1080, height: 1920, clearColor: "#000000" },tracks: [visual],});- assert.throws(() => assertCompositionIdentity(composition), /belongs to another ProgramSpace/);- assert.notEqual(programSpace.digest, foreign.digest);+ assert.throws(() => assertCompositionIdentity(composition, foreign), /outside ProgramSpace/);+ assert.notDeepEqual(programSpace, foreign);});-test("Composition identity binds every Track digest and rejects tampering", () => {+test("Composition is a plain product value; the enclosing Record binds its integrity", () => {const { programSpace, visual } = fixture();const composition = sealComposition({contract: "svml.composition@1",id: "main",- programSpace,canvas: { width: 1080, height: 1920, clearColor: "#000000" },tracks: [visual],});const tampered = structuredClone(composition);(tampered.tracks[0] as { id: string }).id = "changed";- assert.throws(() => assertCompositionIdentity(tampered), /Composition digest does not match/);+ assert.doesNotThrow(() => assertCompositionIdentity(tampered, programSpace));+ assert.equal(tampered.tracks[0]?.id, "changed");});test("one authoring Track may contribute independently stacked Presents", () => {@@ -267,11 +259,10 @@ test("one authoring Track may contribute independently stacked Presents", () =>const composition = sealComposition({contract: "svml.composition@1",id: "interleaved",- programSpace,canvas: { width: 1080, height: 1920, clearColor: "#000000" },tracks: [interleaved],});- assert.doesNotThrow(() => assertCompositionIdentity(composition));+ assert.doesNotThrow(() => assertCompositionIdentity(composition, programSpace));assert.deepEqual(interleaved.presents.map((present) => present.stacking.order), [30, 80]);});@@ -297,10 +288,9 @@ test("Visual Present animations are frame-exact and cannot animate cross-Track sassert.doesNotThrow(() => assertCompositionIdentity(sealComposition({contract: "svml.composition@1",id: "animated",- programSpace,canvas: { width: 1080, height: 1920, clearColor: "#000000" },tracks: [animated],- })));+ }), programSpace));const invasive = sealVisualTrack({...visual,presents: [{@@ -319,8 +309,7 @@ test("Visual Present animations are frame-exact and cannot animate cross-Track sassert.throws(() => assertCompositionIdentity(sealComposition({contract: "svml.composition@1",id: "animated-invasive",- programSpace,canvas: { width: 1080, height: 1920, clearColor: "#000000" },tracks: [invasive],- })), /cross-Track style backdrop-filter/);+ }), programSpace), /cross-Track style backdrop-filter/);});diff --git a/packages/core/src/affinity.ts b/packages/core/src/affinity.tsdeleted file mode 100644index 8d3d5fe6..00000000--- a/packages/core/src/affinity.ts+++ /dev/null@@ -1,179 +0,0 @@-import type {- BuildPlan,- CompiledGraph,- GraphValueRef,- LinkedProgram,- ProducerStep,- StoredValue,- TypedRecord,-} from "@svml/protocol";--import { canonicalStringify } from "./canonical.js";-import { invariant } from "./error.js";-import {- resolveLogicalOutput,- resolveOperation,-} from "./graph.js";-import { resolveProducer } from "./link.js";--function pointerTokens(pointer: string): string[] {- invariant(- pointer === "" || pointer.startsWith("/"),- "INVALID_AFFINITY_POINTER",- `affinity pointer ${pointer} is not a JSON Pointer`,- );- if (pointer === "") return [];- return pointer.slice(1).split("/").map((token) => {- invariant(- !/~(?:[^01]|$)/u.test(token),- "INVALID_AFFINITY_POINTER",- `affinity pointer ${pointer} has an invalid escape`,- );- return token.replaceAll("~1", "/").replaceAll("~0", "~");- });-}--function atPointer(value: unknown, pointer: string, subject: string): unknown {- let current = value;- for (const token of pointerTokens(pointer)) {- invariant(- current !== null && typeof current === "object",- "AFFINITY_PATH_MISSING",- `${subject}${pointer} does not exist`,- subject,- );- if (Array.isArray(current)) {- invariant(/^0$|^[1-9][0-9]*$/u.test(token), "AFFINITY_PATH_MISSING", `${subject}${pointer} is invalid`);- current = current[Number(token)];- } else {- invariant(Object.hasOwn(current, token), "AFFINITY_PATH_MISSING", `${subject}${pointer} does not exist`);- current = (current as Readonly<Record<string, unknown>>)[token];- }- }- invariant(current !== undefined, "AFFINITY_PATH_MISSING", `${subject}${pointer} is undefined`, subject);- return current;-}--function affinityValue(value: StoredValue): unknown {- // BlobRef is a first-class StoredValue and has stable JSON fields. Treating it- // as its own affinity value lets generic packages prove that a projected- // artifact is the exact member of an inline Product without wrapping bytes in- // a domain-specific object.- return value.kind === "inline" ? value.value : value;-}--function sourceRecordId(graph: CompiledGraph, plan: BuildPlan, source: GraphValueRef): string {- if (source.kind === "record") return source.id;- if (source.kind === "operation-result") return resolveOperation(graph, source.operation).result.record;- const selection = plan.selections.find((item) => item.output === source.id);- invariant(- selection !== undefined,- "UNDEMANDED_AFFINITY_SOURCE",- `${source.id} is required to prove exact affinity but is not demanded`,- source.id,- );- return selection.record;-}--export function verifyRecordAffinity(- graph: CompiledGraph,- plan: BuildPlan,- outputId: string,- record: TypedRecord,- lookup: (id: string) => TypedRecord | undefined,-): void {- if (record.conformance === "substitute") return;- const output = resolveLogicalOutput(graph, outputId);- for (const constraint of output.affinity ?? []) {- const sourceId = sourceRecordId(graph, plan, constraint.source);- const source = lookup(sourceId);- invariant(- source !== undefined,- "UNPROVEN_EXACT_AFFINITY",- `${outputId} cannot prove affinity to ${sourceId}; provide that source or mark this Candidate substitute`,- outputId,- );- const resultValue = atPointer(affinityValue(record.value), constraint.resultPointer, record.id);- const sourceValue = atPointer(affinityValue(source.value), constraint.sourcePointer, source.id);- invariant(- canonicalStringify(resultValue) === canonicalStringify(sourceValue),- "AFFINITY_MISMATCH",- `${record.id}${constraint.resultPointer} does not match ${source.id}${constraint.sourcePointer}`,- record.id,- );- }-}--export function verifyGraphRecordAffinity(- graph: CompiledGraph,- plan: BuildPlan,- record: TypedRecord,- lookup: (id: string) => TypedRecord | undefined,-): void {- for (const selection of plan.selections.filter((item) => item.record === record.id)) {- verifyRecordAffinity(graph, plan, selection.output, record, lookup);- }-}--export function verifyInitialAffinities(- graph: CompiledGraph,- plan: BuildPlan,- authored: readonly TypedRecord[],-): void {- const records = new Map([...authored, ...plan.initialValues].map((record) => [record.id, record]));- for (const record of plan.initialValues) {- verifyGraphRecordAffinity(graph, plan, record, (id) => records.get(id));- }-}--function resultPortForRecord(- program: LinkedProgram,- step: ProducerStep,- recordId: string,-) {- const producer = resolveProducer(program.closure, step.producer);- const output = Object.entries(step.outputs).find(([, id]) => id === recordId);- if (output !== undefined) return producer.outputs.find((port) => port.name === output[0]);- const need = Object.entries(step.needs).find(([, binding]) => binding.result === recordId);- return need === undefined ? undefined : producer.needs.find((port) => port.name === need[0]);-}--/** Verify the result-to-input identity promises declared by the Producer itself. */-export function verifyProducerRecordAffinity(- program: LinkedProgram,- plan: BuildPlan,- record: TypedRecord,- lookup: (id: string) => TypedRecord | undefined,-): void {- if (record.conformance === "substitute") return;- const step = plan.steps.find((item) =>- Object.values(item.outputs).includes(record.id)- || Object.values(item.needs).some((binding) => binding.result === record.id));- if (step === undefined) return;- const port = resultPortForRecord(program, step, record.id);- invariant(port !== undefined, "UNKNOWN_RESULT_PORT", `${record.id} has no Producer result port`, record.id);- for (const affinity of port.affinity ?? []) {- const inputId = step.inputs[affinity.input];- invariant(- inputId !== undefined,- "UNKNOWN_AFFINITY_INPUT",- `${step.id} has no input ${affinity.input}`,- step.id,- );- const input = lookup(inputId);- invariant(- input !== undefined,- "UNPROVEN_EXACT_AFFINITY",- `${record.id} cannot prove affinity to ${inputId}`,- record.id,- );- const resultValue = atPointer(affinityValue(record.value), affinity.resultPointer, record.id);- const inputValue = atPointer(affinityValue(input.value), affinity.inputPointer, input.id);- invariant(- canonicalStringify(resultValue) === canonicalStringify(inputValue),- "AFFINITY_MISMATCH",- `${record.id}${affinity.resultPointer} does not match ${input.id}${affinity.inputPointer}`,- record.id,- );- }-}diff --git a/packages/core/src/graph.ts b/packages/core/src/graph.tsindex cc88d4bd..e5066e79 100644--- a/packages/core/src/graph.ts+++ b/packages/core/src/graph.ts@@ -56,25 +56,13 @@ function normalizeRoot(root: CandidateRoot): CandidateRoot {}function normalizeOutput(output: LogicalOutput): LogicalOutput {- const base = {+ return {id: output.id,type: output.type,primary: output.primary,semanticInputs: [...output.semanticInputs].map(normalizeRef).sort((a, b) =>valueRefKey(a).localeCompare(valueRefKey(b))),};- return output.affinity === undefined- ? base- : {- ...base,- affinity: [...output.affinity]- .map((constraint) => ({- resultPointer: constraint.resultPointer,- source: normalizeRef(constraint.source),- sourcePointer: constraint.sourcePointer,- }))- .sort((a, b) => a.resultPointer.localeCompare(b.resultPointer)),- };}function normalizeCandidate(candidate: Candidate): Candidate {@@ -235,23 +223,6 @@ function graphValueType(program: LinkedProgram, graph: CompiledGraph, ref: Graphreturn operationResultType(program, resolveOperation(graph, ref.operation));}-function verifyAffinityPointer(pointer: string, subject: string): void {- invariant(- pointer === "" || pointer.startsWith("/"),- "INVALID_AFFINITY_POINTER",- `${subject} has invalid JSON Pointer ${pointer}`,- subject,- );- for (const token of pointer === "" ? [] : pointer.slice(1).split("/")) {- invariant(- !/~(?:[^01]|$)/u.test(token),- "INVALID_AFFINITY_POINTER",- `${subject} has invalid JSON Pointer escape in ${pointer}`,- subject,- );- }-}-function exactKeys(actual: Readonly<Record<string, unknown>>,expected: readonly string[],@@ -429,14 +400,6 @@ export function verifyCompiledGraph(program: LinkedProgram, graph: CompiledGraph`${output.id} repeats a Semantic Input`,output.id,);- const pointers = new Set<string>();- for (const constraint of output.affinity ?? []) {- verifyAffinityPointer(constraint.resultPointer, output.id);- verifyAffinityPointer(constraint.sourcePointer, output.id);- invariant(!pointers.has(constraint.resultPointer), "DUPLICATE_AFFINITY", `${output.id} repeats affinity`);- pointers.add(constraint.resultPointer);- graphValueType(program, graph, constraint.source);- }}for (const operation of graph.operations) {diff --git a/packages/core/src/index.ts b/packages/core/src/index.tsindex b4386e0b..7a59cc55 100644--- a/packages/core/src/index.ts+++ b/packages/core/src/index.ts@@ -1,10 +1,4 @@export { canonicalStringify, canonicalize, digestOf, isDigest, recordDigest } from "./canonical.js";-export {- verifyGraphRecordAffinity,- verifyInitialAffinities,- verifyProducerRecordAffinity,- verifyRecordAffinity,-} from "./affinity.js";export { CoreError } from "./error.js";export {computeClosureDigest,diff --git a/packages/core/src/link.ts b/packages/core/src/link.tsindex f5c580b1..e926d92d 100644--- a/packages/core/src/link.ts+++ b/packages/core/src/link.ts@@ -68,23 +68,6 @@ function ensureUniqueNames(names: readonly string[], kind: string, owner: string}}-function verifyPointer(pointer: string, subject: string): void {- invariant(- pointer === "" || pointer.startsWith("/"),- "INVALID_AFFINITY_POINTER",- `${subject} has invalid JSON Pointer ${pointer}`,- subject,- );- for (const token of pointer === "" ? [] : pointer.slice(1).split("/")) {- invariant(- !/~(?:[^01]|$)/u.test(token),- "INVALID_AFFINITY_POINTER",- `${subject} has invalid JSON Pointer escape in ${pointer}`,- subject,- );- }-}-export function verifyClosure(closure: ResolvedModuleClosure): void {invariant(closure.format === "svml.closure@0", "UNSUPPORTED_CLOSURE", "unsupported closure format");invariant(isDigest(closure.digest), "INVALID_DIGEST", "closure digest is invalid");@@ -147,27 +130,6 @@ export function verifyClosure(closure: ResolvedModuleClosure): void {"PRODUCER_RESULT_NORMAL_FORM",`${key}#${producer.name} must declare exactly one public result`,);- const inputNames = new Set(producer.inputs.map((input) => input.name));- for (const result of [...producer.outputs, ...producer.needs]) {- const resultPointers = new Set<string>();- for (const affinity of result.affinity ?? []) {- invariant(- inputNames.has(affinity.input),- "UNKNOWN_AFFINITY_INPUT",- `${key}#${producer.name}.${result.name} references unknown input ${affinity.input}`,- producer.name,- );- verifyPointer(affinity.resultPointer, `${key}#${producer.name}.${result.name}`);- verifyPointer(affinity.inputPointer, `${key}#${producer.name}.${affinity.input}`);- invariant(- !resultPointers.has(affinity.resultPointer),- "DUPLICATE_AFFINITY",- `${key}#${producer.name}.${result.name} repeats ${affinity.resultPointer}`,- producer.name,- );- resultPointers.add(affinity.resultPointer);- }- }invariant(isDigest(producer.implementation.digest),"INVALID_DIGEST",diff --git a/packages/core/src/reducer.ts b/packages/core/src/reducer.tsindex e0cbd441..46bfe36a 100644--- a/packages/core/src/reducer.ts+++ b/packages/core/src/reducer.ts@@ -20,11 +20,6 @@ import type {TypedRecord,} from "@svml/protocol";-import {- verifyGraphRecordAffinity,- verifyInitialAffinities,- verifyProducerRecordAffinity,-} from "./affinity.js";import { canonicalize, digestOf, recordDigest } from "./canonical.js";import { CoreError, invariant } from "./error.js";import { resolveProducer, resolveType, sealRecord, verifyRecord } from "./link.js";@@ -171,11 +166,6 @@ function acceptProducerEvent(...(output.validation === undefined ? {} : { validation: output.validation }),}));outputs.forEach((record) => verifyRecord(state.program.closure, record));- const outputLookup = new Map([...state.records, ...outputs].map((record) => [record.id, record]));- outputs.forEach((record) => {- verifyProducerRecordAffinity(state.program, state.plan, record, (recordId) => outputLookup.get(recordId));- verifyGraphRecordAffinity(state.graph, state.plan, record, (recordId) => outputLookup.get(recordId));- });const needs: Need[] = needDrafts.map((need) => ({ ...need, requestedBy: id }));return {@@ -246,9 +236,6 @@ function acceptNeedEvent(...(event.validation === undefined ? {} : { validation: event.validation }),};verifyRecord(state.program.closure, record);- const recordLookup = new Map([...state.records, record].map((item) => [item.id, item]));- verifyProducerRecordAffinity(state.program, state.plan, record, (recordId) => recordLookup.get(recordId));- verifyGraphRecordAffinity(state.graph, state.plan, record, (recordId) => recordLookup.get(recordId));return {...state,@@ -382,7 +369,6 @@ export function start(request: BuildRequest,): BuildState {const plan: BuildPlan = compileBuild(program, graph, request);- verifyInitialAffinities(graph, plan, program.records);const state: BuildState = {format: "svml.build@2",id: digestOf({diff --git a/packages/core/src/verify.ts b/packages/core/src/verify.tsindex 5ac449d1..266c1388 100644--- a/packages/core/src/verify.ts+++ b/packages/core/src/verify.ts@@ -8,7 +8,6 @@ import type {} from "@svml/protocol";import { digestOf, isDigest } from "./canonical.js";-import { verifyGraphRecordAffinity, verifyProducerRecordAffinity } from "./affinity.js";import { invariant } from "./error.js";import { link, resolveProducer, verifyRecord } from "./link.js";import { producerStep, validatePlan } from "./plan.js";@@ -246,11 +245,6 @@ export function verifyBuildState(state: BuildState): void {invariant(validConformance(record.conformance), "INVALID_CONFORMANCE", record.id);verifyRecord(state.program.closure, record);}- const affinityRecords = new Map(state.records.map((record) => [record.id, record]));- state.records.forEach((record) => {- verifyProducerRecordAffinity(state.program, state.plan, record, (recordId) => affinityRecords.get(recordId));- verifyGraphRecordAffinity(state.graph, state.plan, record, (recordId) => affinityRecords.get(recordId));- });for (const authored of state.program.records) {const record = findRecord(state, authored.id);invariant(record?.digest === authored.digest, "AUTHORED_RECORD_CHANGED", `${authored.id} changed`);diff --git a/packages/core/test/core.test.ts b/packages/core/test/core.test.tsindex b9eea7bd..7be1eeb5 100644--- a/packages/core/test/core.test.ts+++ b/packages/core/test/core.test.ts@@ -9,16 +9,12 @@ import {validateStoredValue,validatePlan,verifyBuildState,- verifyRecordAffinity,} from "@svml/core";import type {BuildEvent,- BuildPlan,BuildState,- CompiledGraph,FulfillNeedCommand,InvokeProducerCommand,- TypedRecord,ValueSchema,} from "@svml/protocol";@@ -171,81 +167,6 @@ test("oneOf literal discrimination preserves exact-one semantics", () => {);});-test("Producer result affinity rejects an exact output that lies about its input", () => {- const current = reachNeed();- const fulfilled = reduce(current.state, {- kind: "need-fulfilled",- id: "event:affinity-fulfill",- command: current.command.id,- value: { kind: "inline", value: "Hello, Ada!" },- requestDigest: current.command.need.requestDigest,- fulfiller: "test:greeting",- conformance: "exact",- delivery: "executed",- metadata: {},- });- const assemble = fulfilled.commands.find(- (command): command is InvokeProducerCommand => command.kind === "invoke-producer",- );- assert.ok(assemble);- assert.throws(- () => reduce(- fulfilled.state,- producerEvent(assemble, "event:affinity-lie", {- document: { kind: "inline", value: { text: "Different text" } },- }),- ),- (error: unknown) => error instanceof CoreError && error.code === "AFFINITY_MISMATCH",- );-});--test("affinity can prove a first-class BlobRef without a domain wrapper", () => {- const selected = {- kind: "blob",- digest: digestOf("selected-image"),- size: 3,- mediaType: "image/png",- } as const;- const source = {- id: "set",- value: { kind: "inline", value: { images: [selected] } },- } as unknown as TypedRecord;- const output = {- id: "image",- conformance: "exact",- value: selected,- } as unknown as TypedRecord;- const graph = {- outputs: [{- id: "primary-image",- affinity: [{- resultPointer: "/digest",- source: { kind: "record", id: source.id },- sourcePointer: "/images/0/digest",- }],- }],- } as unknown as CompiledGraph;- const plan = { selections: [] } as unknown as BuildPlan;-- assert.doesNotThrow(() => verifyRecordAffinity(- graph,- plan,- "primary-image",- output,- (id) => id === source.id ? source : undefined,- ));- assert.throws(- () => verifyRecordAffinity(- graph,- plan,- "primary-image",- { ...output, value: { ...selected, digest: digestOf("different-image") } },- (id) => id === source.id ? source : undefined,- ),- (error: unknown) => error instanceof CoreError && error.code === "AFFINITY_MISMATCH",- );-});-test("an exact Need rejects a substitute fulfillment", () => {const current = reachNeed();assert.throws(diff --git a/packages/core/test/greeting-fixture.ts b/packages/core/test/greeting-fixture.tsindex 793227b9..448e9d31 100644--- a/packages/core/test/greeting-fixture.ts+++ b/packages/core/test/greeting-fixture.ts@@ -115,11 +115,7 @@ export const manifest: ModuleManifest = {{name: producers.assemble.name,inputs: [{ name: "generated", type: types.generated }],- outputs: [{- name: "document",- type: types.document,- affinity: [{ resultPointer: "/text", input: "generated", inputPointer: "" }],- }],+ outputs: [{ name: "document", type: types.document }],needs: [],implementation: {kind: "registered",diff --git a/packages/driver-node/test/validation.test.ts b/packages/driver-node/test/validation.test.tsindex 91d00b2f..d21f3b09 100644--- a/packages/driver-node/test/validation.test.ts+++ b/packages/driver-node/test/validation.test.ts@@ -403,87 +403,6 @@ test("the static Manifest reader discovers validator declarations without execut);});-test("the static Manifest reader preserves Producer and Need result affinity", () => {- const outputAffinity = [{- resultPointer: "/value",- input: "basis",- inputPointer: "/value",- }];- const needAffinity = [{- resultPointer: "",- input: "basis",- inputPointer: "",- }];- const manifest: ModuleManifest = {- ...sensorManifest,- producers: [- {- ...sensorManifest.producers[0]!,- inputs: [{ name: "basis", type: measurementType }],- outputs: [{ name: "measurement", type: measurementType, affinity: outputAffinity }],- },- {- ...sensorManifest.producers[1]!,- inputs: [{ name: "basis", type: measurementType }],- needs: [{- name: "measurement",- capability: measurementCapability,- returns: measurementType,- affinity: needAffinity,- }],- },- ],- };-- const parsed = parseModuleManifestText(JSON.stringify(manifest));- assert.deepEqual(parsed, manifest);- assert.deepEqual(parsed.producers[0]?.outputs[0]?.affinity, outputAffinity);- assert.deepEqual(parsed.producers[1]?.needs[0]?.affinity, needAffinity);- assert.doesNotThrow(() => createResolvedClosure([contractManifest, parsed]));-});--test("the static Manifest reader rejects incomplete result affinity", () => {- assert.throws(- () => parseModuleManifestText(JSON.stringify({- ...sensorManifest,- producers: [{- ...sensorManifest.producers[0],- inputs: [{ name: "basis", type: measurementType }],- outputs: [{- name: "measurement",- type: measurementType,- affinity: [{ resultPointer: "/value", inputPointer: "/value" }],- }],- }],- })),- /affinity\[0\]\.input must be a string/u,- );-});--test("Core sees affinity restored by the static Manifest reader", () => {- const parsed = parseModuleManifestText(JSON.stringify({- ...sensorManifest,- producers: [{- ...sensorManifest.producers[0],- inputs: [{ name: "basis", type: measurementType }],- outputs: [{- name: "measurement",- type: measurementType,- affinity: [{- resultPointer: "/value",- input: "missing-after-json-roundtrip",- inputPointer: "/value",- }],- }],- }],- }));-- assert.throws(- () => createResolvedClosure([contractManifest, parsed]),- /references unknown input missing-after-json-roundtrip/u,- );-});-test("Type validation errors remain machine distinguishable", async () => {await assert.rejects(() => validateValue(diff --git a/packages/elaborator/README.md b/packages/elaborator/README.mdindex 3c26cd87..4eaa786a 100644--- a/packages/elaborator/README.md+++ b/packages/elaborator/README.md@@ -49,8 +49,8 @@ values use the same Type-owner gate as Producer, Provider and provided CandidateA `svml.fragment@1` value may reference only declared Fragment inputs and local Operations. Itcontains no JavaScript callback, ambient file lookup, credential access or Runtime endpoint. Before-expansion the Elaborator verifies producer ports, types, cycles, reachable exports, Semantic Input-Envelopes and affinity sources.+expansion the Elaborator verifies producer ports, types, cycles, reachable exports and Semantic+Input Envelopes.Expansion assigns hygienic identities from `fragment digest + author instance id + local id`.Multiple exports of one instance therefore share internal Operations, while two explicit instancesdiff --git a/packages/elaborator/src/fragment.ts b/packages/elaborator/src/fragment.tsindex 3a25b9be..930aabee 100644--- a/packages/elaborator/src/fragment.ts+++ b/packages/elaborator/src/fragment.ts@@ -5,7 +5,6 @@ import {resolveProducer,} from "@svml/core";import type {- AffinityConstraint,Candidate,Satisfaction,CandidateRoot,@@ -47,18 +46,11 @@ export type FragmentOperation = {readonly result: FragmentOperationResult;};-export type FragmentAffinityConstraint = {- readonly resultPointer: string;- readonly source: FragmentValueRef;- readonly sourcePointer: string;-};-export type FragmentExport = {readonly name: string;readonly type: TypeRef;readonly root: FragmentOperationRef;readonly semanticInputs: readonly string[];- readonly affinity?: readonly FragmentAffinityConstraint[];readonly fidelity: Conformance;};@@ -83,7 +75,6 @@ export type ElaboratedFragmentExport = {readonly type: TypeRef;readonly root: CandidateRoot;readonly semanticInputs: readonly GraphValueRef[];- readonly affinity?: readonly AffinityConstraint[];readonly fidelity: Conformance;};@@ -192,25 +183,13 @@ function normalizeOperation(operation: FragmentOperation): FragmentOperation {}function normalizeExport(item: FragmentExport): FragmentExport {- const base = {+ return {name: item.name,type: item.type,root: normalizeFragmentRef(item.root) as FragmentOperationRef,semanticInputs: [...item.semanticInputs].sort(),fidelity: item.fidelity,};- return item.affinity === undefined- ? base- : {- ...base,- affinity: [...item.affinity]- .map((constraint) => ({- resultPointer: constraint.resultPointer,- source: normalizeFragmentRef(constraint.source),- sourcePointer: constraint.sourcePointer,- }))- .sort((left, right) => left.resultPointer.localeCompare(right.resultPointer)),- };}function fragmentContent(fragment: GraphFragment): Omit<GraphFragment, "id"> {@@ -363,14 +342,6 @@ export function verifyGraphFragment(program: LinkedProgram, fragment: GraphFragmitem.name,);}- for (const constraint of item.affinity ?? []) {- assert(- dependencies.has(fragmentRefKey(constraint.source)),- "FRAGMENT_AFFINITY_NOT_DEMANDED",- `${fragment.name}.${item.name} affinity source is outside its demanded closure`,- item.name,- );- }}for (const id of operations.keys()) {assert(@@ -446,23 +417,13 @@ export function elaborateGraphFragment(const exports: ElaboratedFragmentExport[] = fragment.exports.map((item) => {const root = mapRef(item.root);assert(root.kind === "operation-result", "INVALID_FRAGMENT_EXPORT_ROOT", item.name);- const base = {+ return {name: item.name,type: item.type,root: { kind: "operation" as const, result: root },semanticInputs: item.semanticInputs.map((name) => inputs[name] as GraphValueRef),fidelity: item.fidelity,};- return item.affinity === undefined- ? base- : {- ...base,- affinity: item.affinity.map((constraint) => ({- resultPointer: constraint.resultPointer,- source: mapRef(constraint.source),- sourcePointer: constraint.sourcePointer,- })),- };});const content = {format: "svml.fragment-instance@1" as const,@@ -529,7 +490,6 @@ function bindExports(type: item.type,primary: candidates[index]!.id,semanticInputs: item.semanticInputs,- ...(item.affinity === undefined ? {} : { affinity: item.affinity }),})): [];const reachable = reachableOperationIds(instance, selected);diff --git a/packages/elaborator/src/index.ts b/packages/elaborator/src/index.tsindex eef54e19..e5068306 100644--- a/packages/elaborator/src/index.ts+++ b/packages/elaborator/src/index.ts@@ -59,7 +59,6 @@ export {export type {ElaboratedFragment,ElaboratedFragmentExport,- FragmentAffinityConstraint,FragmentContribution,FragmentExport,FragmentInputRef,diff --git a/packages/elaborator/test/fragment.test.ts b/packages/elaborator/test/fragment.test.tsindex f57255c3..6b4bce93 100644--- a/packages/elaborator/test/fragment.test.ts+++ b/packages/elaborator/test/fragment.test.ts@@ -140,11 +140,6 @@ function speechFragment(): GraphFragment {type: contractTypes.speechAudioBasis,root: operation("audio"),semanticInputs: ["request", "style"],- affinity: [{- resultPointer: "/basisDigest",- source: operation("generate"),- sourcePointer: "/basisDigest",- }],fidelity: "exact",},{@@ -152,11 +147,6 @@ function speechFragment(): GraphFragment {type: contractTypes.visualTrack,root: operation("visual"),semanticInputs: ["request", "style"],- affinity: [{- resultPointer: "/sources/0/digest",- source: operation("generate"),- sourcePointer: "/basisDigest",- }],fidelity: "exact",},],diff --git a/packages/estimate/src/fragment.ts b/packages/estimate/src/fragment.tsindex eb40a709..c243d3f3 100644--- a/packages/estimate/src/fragment.ts+++ b/packages/estimate/src/fragment.ts@@ -23,12 +23,6 @@ export const speechEstimateFragment = sealGraphFragment({type: contractTypes.speechDuration,root: operation("estimate"),semanticInputs: ["speech", "policy"],- affinity: [- { resultPointer: "/sourceSpeechExcerptDigest", source: input("speech"), sourcePointer: "/excerptDigest" },- { resultPointer: "/segmentId", source: input("speech"), sourcePointer: "/id" },- { resultPointer: "/tokenStart", source: input("speech"), sourcePointer: "/tokenStart" },- { resultPointer: "/tokenEndExclusive", source: input("speech"), sourcePointer: "/tokenEndExclusive" },- ],fidelity: "exact",}],});diff --git a/packages/estimate/src/manifest.ts b/packages/estimate/src/manifest.tsindex 2cca1bcb..38172201 100644--- a/packages/estimate/src/manifest.ts+++ b/packages/estimate/src/manifest.ts@@ -18,7 +18,6 @@ export const estimateProducers = {export const estimateSurfaceImplementationDigest = digestOf("@svml/estimate/speech-surface@2");const number = { kind: "number" } as const satisfies ValueSchema;-const digest = { kind: "string", minLength: 71, maxLength: 71 } as const satisfies ValueSchema;const speechEstimatePolicySchema: ValueSchema = {kind: "object",fields: {@@ -29,7 +28,6 @@ const speechEstimatePolicySchema: ValueSchema = {minimumSec: { schema: number },maximumSec: { schema: number },rounding: { schema: { kind: "string", enum: ["none", "round", "ceil"] } },- policyDigest: { schema: digest },},};@@ -61,16 +59,7 @@ export const estimateManifest: ModuleManifest = {{ name: "speech", type: contractTypes.narrativeSpeechExcerpt },{ name: "policy", type: estimateTypes.speechPolicy },],- outputs: [{- name: "duration",- type: contractTypes.speechDuration,- affinity: [- { resultPointer: "/sourceSpeechExcerptDigest", input: "speech", inputPointer: "/excerptDigest" },- { resultPointer: "/segmentId", input: "speech", inputPointer: "/id" },- { resultPointer: "/tokenStart", input: "speech", inputPointer: "/tokenStart" },- { resultPointer: "/tokenEndExclusive", input: "speech", inputPointer: "/tokenEndExclusive" },- ],- }],+ outputs: [{ name: "duration", type: contractTypes.speechDuration }],needs: [],implementation: {kind: "registered",diff --git a/packages/estimate/src/program.ts b/packages/estimate/src/program.tsindex 0637d81e..81b863db 100644--- a/packages/estimate/src/program.ts+++ b/packages/estimate/src/program.ts@@ -6,7 +6,7 @@ import type {NarrativeSpeechExcerpt,SpeechDuration,} from "@svml/contracts";-import { canonicalize, digestOf, isDigest } from "@svml/protocol";+import { digestOf } from "@svml/protocol";import type {ResolvedSpeechEstimateLanguage,@@ -106,15 +106,8 @@ export function countSpeechEstimateUnits(return words(text).reduce((sum, word) => sum + englishSyllables(word), 0);}-function policyContent(value: Omit<SpeechEstimatePolicy, "policyDigest">) {- return canonicalize(value);-}--export function sealSpeechEstimatePolicy(- value: Omit<SpeechEstimatePolicy, "policyDigest">,-): SpeechEstimatePolicy {- const content = policyContent(value);- const policy: SpeechEstimatePolicy = { ...value, policyDigest: digestOf(content) };+export function sealSpeechEstimatePolicy(value: SpeechEstimatePolicy): SpeechEstimatePolicy {+ const policy = structuredClone(value);assertSpeechEstimatePolicy(policy);return policy;}@@ -135,11 +128,6 @@ export function assertSpeechEstimatePolicy(value: SpeechEstimatePolicy): void {) {throw new Error("SpeechEstimatePolicy is invalid");}- const { policyDigest: _digest, ...raw } = value;- const content = policyContent(raw);- if (!isDigest(value.policyDigest) || value.policyDigest !== digestOf(content)) {- throw new Error("SpeechEstimatePolicy digest differs from its contents");- }}function assertSpeechExcerpt(value: NarrativeSpeechExcerpt): void {@@ -154,10 +142,6 @@ function assertSpeechExcerpt(value: NarrativeSpeechExcerpt): void {) {throw new Error("NarrativeSpeechExcerpt is invalid");}- const { excerptDigest: _digest, ...content } = value;- if (!isDigest(value.excerptDigest) || value.excerptDigest !== digestOf(canonicalize(content))) {- throw new Error("NarrativeSpeechExcerpt digest differs from its contents");- }}function rounded(value: number, mode: SpeechEstimatePolicy["rounding"]): number {@@ -180,10 +164,6 @@ export function estimateSpeechDuration(const durationSec = Math.min(policy.maximumSec, Math.max(policy.minimumSec, rounded(firstClamp, policy.rounding)));const duration = sealSpeechDuration({contract: "svml.speech-duration@1",- segmentId: excerpt.id,- tokenStart: excerpt.tokenStart,- tokenEndExclusive: excerpt.tokenEndExclusive,- sourceSpeechExcerptDigest: excerpt.excerptDigest,durationSec,});assertSpeechDurationIdentity(duration);diff --git a/packages/estimate/src/types.ts b/packages/estimate/src/types.tsindex 3c286f6e..d3524a0a 100644--- a/packages/estimate/src/types.ts+++ b/packages/estimate/src/types.ts@@ -1,5 +1,3 @@-import type { Digest } from "@svml/protocol";-export type SpeechEstimateLanguage = "auto" | "en" | "zh" | "ja" | "es";export type ResolvedSpeechEstimateLanguage = Exclude<SpeechEstimateLanguage, "auto">;export type SpeechEstimatePace = "slow" | "normal" | "fast";@@ -13,5 +11,4 @@ export type SpeechEstimatePolicy = {readonly minimumSec: number;readonly maximumSec: number;readonly rounding: SpeechEstimateRounding;- readonly policyDigest: Digest;};diff --git a/packages/estimate/test/estimate.test.ts b/packages/estimate/test/estimate.test.tsindex 770320b6..8378fc0d 100644--- a/packages/estimate/test/estimate.test.ts+++ b/packages/estimate/test/estimate.test.ts@@ -8,10 +8,9 @@ import {sealSpeechEstimatePolicy,speechEstimatePolicyFromRecipe,} from "@svml/estimate";-import { canonicalize, digestOf } from "@svml/protocol";function excerpt(id: string, speech: string): NarrativeSpeechExcerpt {- const content = {+ return {contract: "svml.narrative-speech-excerpt@1" as const,kind: "segment" as const,id,@@ -19,7 +18,6 @@ function excerpt(id: string, speech: string): NarrativeSpeechExcerpt {tokenEndExclusive: speech.trim().split(/\s+/u).length,speech,};- return { ...content, excerptDigest: digestOf(canonicalize(content)) };}const normal = sealSpeechEstimatePolicy({@@ -40,14 +38,11 @@ test("normal English speech estimate preserves the old syllable-rate policy", ()assert.equal(countSpeechEstimateUnits(source.speech, "en"), 21);const result = estimateSpeechDuration(source, normal);assert.equal(result.durationSec, 5);- assert.equal(result.segmentId, source.id);- assert.equal(result.sourceSpeechExcerptDigest, source.excerptDigest);});test("the minimum applies before rounding and the maximum applies after rounding", () => {assert.equal(estimateSpeechDuration(excerpt("short", "Hello."), normal).durationSec, 4);- const { policyDigest: _digest, ...normalContent } = normal;- const bounded = sealSpeechEstimatePolicy({ ...normalContent, maximumSec: 4.5 });+ const bounded = sealSpeechEstimatePolicy({ ...normal, maximumSec: 4.5 });assert.equal(estimateSpeechDuration(excerpt("long", "This sentence intentionally contains far more spoken syllables than the selected model duration allows."), bounded).durationSec, 4.5);});diff --git a/packages/film/src/component.ts b/packages/film/src/component.tsindex 2c7e1267..77bab709 100644--- a/packages/film/src/component.ts+++ b/packages/film/src/component.ts@@ -27,8 +27,8 @@ export const filmComponent = {{producer: filmProducers.createTrackSet,implementationDigest: createFilmTrackSetImplementationDigest,- handler: ({ inputs }) => ({- outputs: { set: { kind: "inline", value: canonicalize(createFilmTrackSet(inline<ProgramSpace>(inputs.space?.value, "ProgramSpace"))) } },+ handler: () => ({+ outputs: { set: { kind: "inline", value: canonicalize(createFilmTrackSet()) } },needs: {},}),},@@ -37,7 +37,9 @@ export const filmComponent = {implementationDigest: appendFilmVisualTrackImplementationDigest,handler: ({ inputs }) => ({outputs: { set: { kind: "inline", value: canonicalize(appendFilmVisualTrack(- inline<FilmTrackSet>(inputs.set?.value, "FilmTrackSet"), inline<VisualTrack>(inputs.track?.value, "VisualTrack"),+ inline<FilmTrackSet>(inputs.set?.value, "FilmTrackSet"),+ inline<ProgramSpace>(inputs.space?.value, "ProgramSpace"),+ inline<VisualTrack>(inputs.track?.value, "VisualTrack"),)) } },needs: {},}),@@ -47,7 +49,9 @@ export const filmComponent = {implementationDigest: appendFilmAudioTrackImplementationDigest,handler: ({ inputs }) => ({outputs: { set: { kind: "inline", value: canonicalize(appendFilmAudioTrack(- inline<FilmTrackSet>(inputs.set?.value, "FilmTrackSet"), inline<AudioTrack>(inputs.track?.value, "AudioTrack"),+ inline<FilmTrackSet>(inputs.set?.value, "FilmTrackSet"),+ inline<ProgramSpace>(inputs.space?.value, "ProgramSpace"),+ inline<AudioTrack>(inputs.track?.value, "AudioTrack"),)) } },needs: {},}),@@ -57,7 +61,9 @@ export const filmComponent = {implementationDigest: compileFilmCompositionImplementationDigest,handler: ({ inputs }) => ({outputs: { composition: { kind: "inline", value: canonicalize(compileFilmComposition(- inline<FilmProgram>(inputs.program?.value, "FilmProgram"), inline<FilmTrackSet>(inputs.set?.value, "FilmTrackSet"),+ inline<FilmProgram>(inputs.program?.value, "FilmProgram"),+ inline<ProgramSpace>(inputs.space?.value, "ProgramSpace"),+ inline<FilmTrackSet>(inputs.set?.value, "FilmTrackSet"),)) } },needs: {},}),diff --git a/packages/film/src/fragment.ts b/packages/film/src/fragment.tsindex 3a0b7dd1..e29ce016 100644--- a/packages/film/src/fragment.ts+++ b/packages/film/src/fragment.ts@@ -31,7 +31,7 @@ export function createFilmAssemblyFragment(options: FilmAssemblyFragmentOptions)const operations: FragmentOperation[] = [{id: "track-set:empty",producer: filmProducers.createTrackSet,- inputs: { space: input("space") },+ inputs: {},result: { kind: "output" as const, name: "set" },}];let current = "track-set:empty";@@ -40,7 +40,7 @@ export function createFilmAssemblyFragment(options: FilmAssemblyFragmentOptions)operations.push({id,producer: track.kind === "visual" ? filmProducers.appendVisualTrack : filmProducers.appendAudioTrack,- inputs: { set: operation(current), track: input(track.name) },+ inputs: { set: operation(current), space: input("space"), track: input(track.name) },result: { kind: "output" as const, name: "set" },});current = id;@@ -48,7 +48,7 @@ export function createFilmAssemblyFragment(options: FilmAssemblyFragmentOptions)operations.push({id: "film:composition",producer: filmProducers.compileComposition,- inputs: { program: input("program"), set: operation(current) },+ inputs: { program: input("program"), space: input("space"), set: operation(current) },result: { kind: "output" as const, name: "composition" },});const semanticInputs = ["program", "space", ...tracks.map((track) => track.name)];@@ -69,13 +69,6 @@ export function createFilmAssemblyFragment(options: FilmAssemblyFragmentOptions)type: contractTypes.composition,root: operation("film:composition"),semanticInputs,- affinity: [- { resultPointer: "/id", source: input("program"), sourcePointer: "/id" },- { resultPointer: "/programSpace/digest", source: input("space"), sourcePointer: "/digest" },- { resultPointer: "/canvas/width", source: input("program"), sourcePointer: "/canvas/width" },- { resultPointer: "/canvas/height", source: input("program"), sourcePointer: "/canvas/height" },- { resultPointer: "/canvas/clearColor", source: input("program"), sourcePointer: "/canvas/clearColor" },- ],fidelity: "exact",},],diff --git a/packages/film/src/index.ts b/packages/film/src/index.tsindex f83b4a77..6d2adbe2 100644--- a/packages/film/src/index.ts+++ b/packages/film/src/index.ts@@ -19,8 +19,6 @@ export {assertFilmTrackSetIdentity,compileFilmComposition,compileFilmCompositionImplementationDigest,- computeFilmProgramDigest,- computeFilmTrackSetDigest,createFilmTrackSet,createFilmTrackSetImplementationDigest,sealFilmProgram,diff --git a/packages/film/src/manifest.ts b/packages/film/src/manifest.tsindex 85ed728e..63e228bc 100644--- a/packages/film/src/manifest.ts+++ b/packages/film/src/manifest.ts@@ -2,7 +2,6 @@ import {audioTrackSchema,compositionSchema,contractTypes,- programSpaceSchema,videoContractDependencies,visualTrackSchema,} from "@svml/contracts";@@ -32,7 +31,6 @@ export const filmProducers = {const string = { kind: "string", minLength: 1 } as const;const integer = { kind: "number", integer: true, minimum: 1 } as const;-const digest = { kind: "string", minLength: 71, maxLength: 71 } as const;const object = (fields: Readonly<Record<string, { readonly schema: ValueSchema; readonly optional?: boolean }>>): ValueSchema => ({kind: "object",fields,@@ -50,7 +48,6 @@ const frameRateSchema = object({export const filmProgramSchema: ValueSchema = object({contract: { schema: { kind: "literal", value: "svml.film-program@1" } },- digest: { schema: digest },id: { schema: string },frameRate: { schema: frameRateSchema },canvas: { schema: canvasSchema },@@ -58,21 +55,12 @@ export const filmProgramSchema: ValueSchema = object({export const filmTrackSetSchema: ValueSchema = object({contract: { schema: { kind: "literal", value: "svml.film-track-set@1" } },- digest: { schema: digest },- programSpace: { schema: programSpaceSchema },tracks: {schema: {kind: "array",items: { kind: "oneOf", variants: [visualTrackSchema, audioTrackSchema] },},},- lastAddition: {- schema: object({- previousSetDigest: { schema: digest },- trackDigest: { schema: digest },- }),- optional: true,- },});export const filmManifest: ModuleManifest = {@@ -103,12 +91,8 @@ export const filmManifest: ModuleManifest = {producers: [{name: filmProducers.createTrackSet.name,- inputs: [{ name: "space", type: contractTypes.programSpace }],- outputs: [{- name: "set",- type: filmTypes.trackSet,- affinity: [{ resultPointer: "/programSpace/digest", input: "space", inputPointer: "/digest" }],- }],+ inputs: [],+ outputs: [{ name: "set", type: filmTypes.trackSet }],needs: [],implementation: {kind: "registered",@@ -120,17 +104,10 @@ export const filmManifest: ModuleManifest = {name: filmProducers.appendVisualTrack.name,inputs: [{ name: "set", type: filmTypes.trackSet },+ { name: "space", type: contractTypes.programSpace },{ name: "track", type: contractTypes.visualTrack },],- outputs: [{- name: "set",- type: filmTypes.trackSet,- affinity: [- { resultPointer: "/programSpace/digest", input: "set", inputPointer: "/programSpace/digest" },- { resultPointer: "/lastAddition/previousSetDigest", input: "set", inputPointer: "/digest" },- { resultPointer: "/lastAddition/trackDigest", input: "track", inputPointer: "/digest" },- ],- }],+ outputs: [{ name: "set", type: filmTypes.trackSet }],needs: [],implementation: {kind: "registered",@@ -142,17 +119,10 @@ export const filmManifest: ModuleManifest = {name: filmProducers.appendAudioTrack.name,inputs: [{ name: "set", type: filmTypes.trackSet },+ { name: "space", type: contractTypes.programSpace },{ name: "track", type: contractTypes.audioTrack },],- outputs: [{- name: "set",- type: filmTypes.trackSet,- affinity: [- { resultPointer: "/programSpace/digest", input: "set", inputPointer: "/programSpace/digest" },- { resultPointer: "/lastAddition/previousSetDigest", input: "set", inputPointer: "/digest" },- { resultPointer: "/lastAddition/trackDigest", input: "track", inputPointer: "/digest" },- ],- }],+ outputs: [{ name: "set", type: filmTypes.trackSet }],needs: [],implementation: {kind: "registered",@@ -164,20 +134,10 @@ export const filmManifest: ModuleManifest = {name: filmProducers.compileComposition.name,inputs: [{ name: "program", type: filmTypes.program },+ { name: "space", type: contractTypes.programSpace },{ name: "set", type: filmTypes.trackSet },],- outputs: [{- name: "composition",- type: contractTypes.composition,- affinity: [- { resultPointer: "/id", input: "program", inputPointer: "/id" },- { resultPointer: "/programSpace/digest", input: "set", inputPointer: "/programSpace/digest" },- { resultPointer: "/canvas/width", input: "program", inputPointer: "/canvas/width" },- { resultPointer: "/canvas/height", input: "program", inputPointer: "/canvas/height" },- { resultPointer: "/canvas/clearColor", input: "program", inputPointer: "/canvas/clearColor" },- { resultPointer: "/programSpace/frameRate", input: "program", inputPointer: "/frameRate" },- ],- }],+ outputs: [{ name: "composition", type: contractTypes.composition }],needs: [],implementation: {kind: "registered",diff --git a/packages/film/src/program.ts b/packages/film/src/program.tsindex d52d6bc7..188efabc 100644--- a/packages/film/src/program.ts+++ b/packages/film/src/program.ts@@ -12,8 +12,7 @@ import type {Track,VisualTrack,} from "@svml/contracts";-import { digestOf, isDigest } from "@svml/protocol";-import type { Digest } from "@svml/protocol";+import { digestOf } from "@svml/protocol";import type { FilmProgram, FilmTrackSet } from "./types.js";@@ -30,7 +29,7 @@ function trackKey(track: Track): string {return `${track.contract}\u0000${track.id}`;}-function filmProgramContent(value: Omit<FilmProgram, "digest">): Omit<FilmProgram, "digest"> {+function filmProgramContent(value: FilmProgram): FilmProgram {return {contract: "svml.film-program@1",id: value.id,@@ -39,27 +38,17 @@ function filmProgramContent(value: Omit<FilmProgram, "digest">): Omit<FilmProgra};}-function filmTrackSetContent(value: Omit<FilmTrackSet, "digest">): Omit<FilmTrackSet, "digest"> {+function filmTrackSetContent(value: FilmTrackSet): FilmTrackSet {return {contract: "svml.film-track-set@1",- programSpace: {- ...value.programSpace,- frameRate: { ...value.programSpace.frameRate },- },tracks: [...value.tracks].map((track) => structuredClone(track)).sort((left, right) => trackKey(left).localeCompare(trackKey(right))),- ...(value.lastAddition === undefined ? {} : { lastAddition: { ...value.lastAddition } }),};}-export function computeFilmProgramDigest(value: Omit<FilmProgram, "digest">): Digest {- return digestOf(filmProgramContent(value));-}--export function sealFilmProgram(value: Omit<FilmProgram, "digest">): FilmProgram {- const content = filmProgramContent(value);- return { ...content, digest: digestOf(content) };+export function sealFilmProgram(value: FilmProgram): FilmProgram {+ return filmProgramContent(value);}export function assertFilmProgramIdentity(program: FilmProgram): void {@@ -82,102 +71,68 @@ export function assertFilmProgramIdentity(program: FilmProgram): void {) {throw new Error("FilmProgram canvas is invalid.");}- const { digest: _digest, ...content } = program;- if (!isDigest(program.digest) || program.digest !== computeFilmProgramDigest(content)) {- throw new Error("FilmProgram digest does not match its contents.");- }}-export function computeFilmTrackSetDigest(value: Omit<FilmTrackSet, "digest">): Digest {- return digestOf(filmTrackSetContent(value));-}--function sealFilmTrackSet(value: Omit<FilmTrackSet, "digest">): FilmTrackSet {- const content = filmTrackSetContent(value);- return { ...content, digest: digestOf(content) };+function sealFilmTrackSet(value: FilmTrackSet): FilmTrackSet {+ return filmTrackSetContent(value);}export function assertFilmTrackSetIdentity(set: FilmTrackSet): void {if (set.contract !== "svml.film-track-set@1") throw new Error("Unsupported FilmTrackSet contract.");- assertProgramSpaceIdentity(set.programSpace);- const { digest: _digest, ...content } = set;- if (!isDigest(set.digest) || set.digest !== computeFilmTrackSetDigest(content)) {- throw new Error("FilmTrackSet digest does not match its contents.");- }const ids = new Set<string>();for (const track of set.tracks) {if (ids.has(track.id)) throw new Error(`FilmTrackSet contains duplicate Track id ${track.id}.`);ids.add(track.id);- if (track.contract === "svml.visual-track@1") assertVisualTrackIdentity(track, set.programSpace);- else assertAudioTrackIdentity(track, set.programSpace);- }- if (set.tracks.length === 0 && set.lastAddition !== undefined) {- throw new Error("An empty FilmTrackSet cannot declare a last addition.");- }- if (set.tracks.length > 0 && set.lastAddition === undefined) {- throw new Error("A non-empty FilmTrackSet must declare its last addition.");- }- if (set.lastAddition !== undefined) {- if (!isDigest(set.lastAddition.previousSetDigest) || !isDigest(set.lastAddition.trackDigest)) {- throw new Error("FilmTrackSet last addition contains an invalid digest.");- }- if (!set.tracks.some((track) => track.digest === set.lastAddition?.trackDigest)) {- throw new Error("FilmTrackSet last addition does not identify one of its Tracks.");- }+ if (track.contract === "svml.visual-track@1") assertVisualTrackIdentity(track);+ else assertAudioTrackIdentity(track);}}-export function createFilmTrackSet(programSpace: ProgramSpace): FilmTrackSet {- assertProgramSpaceIdentity(programSpace);+export function createFilmTrackSet(): FilmTrackSet {return sealFilmTrackSet({contract: "svml.film-track-set@1",- programSpace,tracks: [],});}-function appendTrack(set: FilmTrackSet, track: Track): FilmTrackSet {+function appendTrack(set: FilmTrackSet, programSpace: ProgramSpace, track: Track): FilmTrackSet {assertFilmTrackSetIdentity(set);- if (track.contract === "svml.visual-track@1") assertVisualTrackIdentity(track, set.programSpace);- else assertAudioTrackIdentity(track, set.programSpace);+ assertProgramSpaceIdentity(programSpace);+ if (track.contract === "svml.visual-track@1") assertVisualTrackIdentity(track, programSpace);+ else assertAudioTrackIdentity(track, programSpace);if (set.tracks.some((existing) => existing.id === track.id)) {throw new Error(`FilmTrackSet already contains Track id ${track.id}.`);}return sealFilmTrackSet({contract: "svml.film-track-set@1",- programSpace: set.programSpace,tracks: [...set.tracks, track],- lastAddition: {- previousSetDigest: set.digest,- trackDigest: track.digest,- },});}-export function appendFilmVisualTrack(set: FilmTrackSet, track: VisualTrack): FilmTrackSet {- return appendTrack(set, track);+export function appendFilmVisualTrack(set: FilmTrackSet, programSpace: ProgramSpace, track: VisualTrack): FilmTrackSet {+ return appendTrack(set, programSpace, track);}-export function appendFilmAudioTrack(set: FilmTrackSet, track: AudioTrack): FilmTrackSet {- return appendTrack(set, track);+export function appendFilmAudioTrack(set: FilmTrackSet, programSpace: ProgramSpace, track: AudioTrack): FilmTrackSet {+ return appendTrack(set, programSpace, track);}-export function compileFilmComposition(program: FilmProgram, set: FilmTrackSet): Composition {+export function compileFilmComposition(program: FilmProgram, programSpace: ProgramSpace, set: FilmTrackSet): Composition {assertFilmProgramIdentity(program);+ assertProgramSpaceIdentity(programSpace);assertFilmTrackSetIdentity(set);if (- program.frameRate.numerator !== set.programSpace.frameRate.numerator- || program.frameRate.denominator !== set.programSpace.frameRate.denominator+ program.frameRate.numerator !== programSpace.frameRate.numerator+ || program.frameRate.denominator !== programSpace.frameRate.denominator) {throw new Error("FilmProgram and FilmTrackSet use different frame rates.");}const composition = sealComposition({contract: "svml.composition@1",id: program.id,- programSpace: set.programSpace,canvas: program.canvas,tracks: set.tracks,});- assertCompositionIdentity(composition);+ assertCompositionIdentity(composition, programSpace);return composition;}diff --git a/packages/film/src/types.ts b/packages/film/src/types.tsindex da29f9de..68848568 100644--- a/packages/film/src/types.ts+++ b/packages/film/src/types.ts@@ -1,10 +1,8 @@-import type { ProgramSpace, Track } from "@svml/contracts";-import type { Digest } from "@svml/protocol";+import type { Track } from "@svml/contracts";/** Package-owned authoring value. A future Film Surface may produce this record. */export type FilmProgram = {readonly contract: "svml.film-program@1";- readonly digest: Digest;readonly id: string;readonly frameRate: {readonly numerator: number;@@ -23,13 +21,7 @@ export type FilmProgram = {*/export type FilmTrackSet = {readonly contract: "svml.film-track-set@1";- readonly digest: Digest;- readonly programSpace: ProgramSpace;readonly tracks: readonly Track[];- readonly lastAddition?: {- readonly previousSetDigest: Digest;- readonly trackDigest: Digest;- };};export type FilmTrackInput = {diff --git a/packages/film/test/film.test.ts b/packages/film/test/film.test.tsindex 631e7a6e..b612874b 100644--- a/packages/film/test/film.test.ts+++ b/packages/film/test/film.test.ts@@ -82,7 +82,6 @@ const filmProgram = sealFilmProgram({const textProgram = sealTextTrackProgram({contract: "svml.text-track-program@1",id: "title-track",- programSpaceDigest: space.digest,items: [{id: "title",text: "Semantic Video Markup Language",@@ -97,7 +96,6 @@ const background = sealVisualTrack({contract: "svml.visual-track@1",visualIr: "svml.hyperframes-visual-ir@1",id: "background-track",- programSpaceDigest: space.digest,presents: [{id: "background",span: { startFrame: 0, endFrameExclusive: 120 },@@ -108,7 +106,6 @@ const background = sealVisualTrack({const audio = sealAudioTrack({contract: "svml.audio-track@1",id: "empty-audio-track",- programSpaceDigest: space.digest,clips: [],});@@ -180,6 +177,7 @@ const hyperframesInstance = elaborateGraphFragment(linked, hyperframesDocumentFrfragment: hyperframesDocumentFragment.id,inputs: {composition: { kind: "logical-output", id: "main.composition" },+ space: { kind: "record", id: "space" },},});const hyperframesContribution = bindAuthorFragment(hyperframesInstance, {@@ -229,24 +227,39 @@ test("the Driver folds peer Tracks, then independently compiles the Composition"outputs: { track: stored(renderTextTrack(inline(inputs.space) as typeof space, inline(inputs.program) as typeof textProgram)) },needs: {},}));- registry.registerProducer(filmProducers.createTrackSet, createFilmTrackSetImplementationDigest, ({ inputs }) => ({- outputs: { set: stored(createFilmTrackSet(inline(inputs.space) as typeof space)) },+ registry.registerProducer(filmProducers.createTrackSet, createFilmTrackSetImplementationDigest, () => ({+ outputs: { set: stored(createFilmTrackSet()) },needs: {},}));registry.registerProducer(filmProducers.appendVisualTrack, appendFilmVisualTrackImplementationDigest, ({ inputs }) => ({- outputs: { set: stored(appendFilmVisualTrack(inline(inputs.set) as never, inline(inputs.track) as never)) },+ outputs: { set: stored(appendFilmVisualTrack(+ inline(inputs.set) as never,+ inline(inputs.space) as typeof space,+ inline(inputs.track) as never,+ )) },needs: {},}));registry.registerProducer(filmProducers.appendAudioTrack, appendFilmAudioTrackImplementationDigest, ({ inputs }) => ({- outputs: { set: stored(appendFilmAudioTrack(inline(inputs.set) as never, inline(inputs.track) as never)) },+ outputs: { set: stored(appendFilmAudioTrack(+ inline(inputs.set) as never,+ inline(inputs.space) as typeof space,+ inline(inputs.track) as never,+ )) },needs: {},}));registry.registerProducer(filmProducers.compileComposition, compileFilmCompositionImplementationDigest, ({ inputs }) => ({- outputs: { composition: stored(compileFilmComposition(inline(inputs.program) as never, inline(inputs.set) as never)) },+ outputs: { composition: stored(compileFilmComposition(+ inline(inputs.program) as never,+ inline(inputs.space) as typeof space,+ inline(inputs.set) as never,+ )) },needs: {},}));registry.registerProducer(hyperframesProducers.compile, compileHyperframesImplementationDigest, ({ inputs }) => ({- outputs: { document: stored(compileHyperframesDocument(inline(inputs.composition) as never)) },+ outputs: { document: stored(compileHyperframesDocument(+ inline(inputs.composition) as never,+ inline(inputs.space) as typeof space,+ )) },needs: {},}));@@ -261,7 +274,7 @@ test("the Driver folds peer Tracks, then independently compiles the Composition"});test("Film rejects duplicate Track ids before Composition", () => {- const set = appendFilmVisualTrack(createFilmTrackSet(space), background);+ const set = appendFilmVisualTrack(createFilmTrackSet(), space, background);const duplicate = sealVisualTrack({ ...background });- assert.throws(() => appendFilmVisualTrack(set, duplicate), /already contains Track id/u);+ assert.throws(() => appendFilmVisualTrack(set, space, duplicate), /already contains Track id/u);});diff --git a/packages/film/test/surface.test.ts b/packages/film/test/surface.test.tsindex 33fa0e6d..3a8f8335 100644--- a/packages/film/test/surface.test.ts+++ b/packages/film/test/surface.test.ts@@ -69,13 +69,11 @@ const visual = sealVisualTrack({contract: "svml.visual-track@1",visualIr: "svml.hyperframes-visual-ir@1",id: "visual",- programSpaceDigest: space.digest,presents: [],});const audio = sealAudioTrack({contract: "svml.audio-track@1",id: "audio",- programSpaceDigest: space.digest,clips: [],});@@ -161,9 +159,6 @@ test("the official Film Surface validates SVS and lowers dynamic peer Tracks", aconst program = compiled.module.records.find((record) => record.type.name === filmTypes.program.name);assert.deepEqual(program?.value.kind === "inline" ? program.value.value : undefined, {contract: "svml.film-program@1",- digest: program?.value.kind === "inline"- ? (program.value.value as { readonly digest: string }).digest- : undefined,id: "main",frameRate: { numerator: 30, denominator: 1 },canvas: { width: 1080, height: 1920, clearColor: "#09090B" },diff --git a/packages/gemini-omni/src/index.ts b/packages/gemini-omni/src/index.tsindex 2db7b796..82b2214c 100644--- a/packages/gemini-omni/src/index.ts+++ b/packages/gemini-omni/src/index.ts@@ -1,14 +1,12 @@import {assertGenerationBlobRef,generationBlobRefSchema,- generationDigestSchema,generationObjectSchema,generationPromptSchema,sealGenerationRequest,- verifyGenerationRequestDigest,} from "@svml/generation";import { defineExactModelModule } from "@svml/model-kit";-import type { BlobRef, Digest, ValueSchema } from "@svml/protocol";+import type { BlobRef, ValueSchema } from "@svml/protocol";export const geminiOmniModuleRef = { name: "@svml/gemini-omni", version: "0.0.0-dev" } as const;@@ -32,7 +30,7 @@ export type GeminiOmniRequestContent = {readonly videos?: readonly GeminiOmniVideoReference[];readonly characterIds?: readonly string[];};-export type GeminiOmniRequest = GeminiOmniRequestContent & { readonly requestDigest: Digest };+export type GeminiOmniRequest = GeminiOmniRequestContent;const idSchema = { kind: "string", minLength: 1, maxLength: 255 } as const satisfies ValueSchema;export const geminiOmniRequestSchema = generationObjectSchema({@@ -67,7 +65,6 @@ export const geminiOmniRequestSchema = generationObjectSchema({optional: true,},characterIds: { schema: { kind: "array", minItems: 1, maxItems: 3, items: idSchema }, optional: true },- requestDigest: { schema: generationDigestSchema },});function object(value: unknown, subject: string): Record<string, unknown> {@@ -76,7 +73,6 @@ function object(value: unknown, subject: string): Record<string, unknown> {}export function verifyGeminiOmniRequest(value: unknown): asserts value is GeminiOmniRequest {- verifyGenerationRequestDigest(value);const request = object(value, "Gemini Omni request");if (request.contract !== "svml.gemini-omni-request@1" || request.model !== "gemini-omni-video") {throw new Error("Gemini Omni request identity is invalid");diff --git a/packages/generation/src/identity.ts b/packages/generation/src/identity.tsindex 700d90da..4993cee2 100644--- a/packages/generation/src/identity.ts+++ b/packages/generation/src/identity.ts@@ -1,9 +1,8 @@import {canonicalize,- digestOf,isDigest,} from "@svml/protocol";-import type { BlobRef, CanonicalValue, Digest } from "@svml/protocol";+import type { BlobRef } from "@svml/protocol";import type {GeneratedImageSet,@@ -35,30 +34,18 @@ export function assertGenerationBlobRef(}}-/** Content identity used by every exact model request Type. */+/** Canonical request value; Core supplies the enclosing Need identity. */export function sealGenerationRequest<T extends object>(content: T,-): T & { readonly requestDigest: Digest } {- const normalized = canonicalize(content) as unknown as T;- return { ...normalized, requestDigest: digestOf(normalized) };-}--export function verifyGenerationRequestDigest(value: unknown): asserts value is Record<string, CanonicalValue> & {- readonly requestDigest: Digest;-} {- const object = plainObject(value, "Generation request");- const requestDigest = object.requestDigest;- assert(typeof requestDigest === "string" && isDigest(requestDigest), "Generation request digest is invalid");- const { requestDigest: _requestDigest, ...content } = object;- assert(requestDigest === digestOf(content), "Generation request digest differs from its canonical contents");+): T {+ return canonicalize(content) as unknown as T;}export function sealGeneratedImageSet(content: GeneratedImageSetContent): GeneratedImageSet {assert(content.contract === "svml.generated-image-set@1", "Generated image contract is invalid");assert(content.images.length > 0, "Generated image set is empty");content.images.forEach((artifact) => assertGenerationBlobRef(artifact, "image/"));- const normalized = canonicalize(content) as unknown as GeneratedImageSetContent;- return { ...normalized, resultDigest: digestOf(normalized) };+ return canonicalize(content) as unknown as GeneratedImageSet;}export function verifyGeneratedImageSet(value: unknown): asserts value is GeneratedImageSet {@@ -66,16 +53,13 @@ export function verifyGeneratedImageSet(value: unknown): asserts value is Generaassert(object.contract === "svml.generated-image-set@1", "Generated image contract is invalid");assert(Array.isArray(object.images) && object.images.length > 0, "Generated image set is empty");object.images.forEach((artifact) => assertGenerationBlobRef(artifact, "image/"));- const { resultDigest, ...content } = object;- assert(isDigest(resultDigest) && resultDigest === digestOf(content), "Generated image result digest differs");}export function sealGeneratedVideoSet(content: GeneratedVideoSetContent): GeneratedVideoSet {assert(content.contract === "svml.generated-video-set@1", "Generated video contract is invalid");assert(content.videos.length > 0, "Generated video set is empty");content.videos.forEach((artifact) => assertGenerationBlobRef(artifact, "video/"));- const normalized = canonicalize(content) as unknown as GeneratedVideoSetContent;- return { ...normalized, resultDigest: digestOf(normalized) };+ return canonicalize(content) as unknown as GeneratedVideoSet;}export function verifyGeneratedVideoSet(value: unknown): asserts value is GeneratedVideoSet {@@ -83,6 +67,4 @@ export function verifyGeneratedVideoSet(value: unknown): asserts value is Generaassert(object.contract === "svml.generated-video-set@1", "Generated video contract is invalid");assert(Array.isArray(object.videos) && object.videos.length > 0, "Generated video set is empty");object.videos.forEach((artifact) => assertGenerationBlobRef(artifact, "video/"));- const { resultDigest, ...content } = object;- assert(isDigest(resultDigest) && resultDigest === digestOf(content), "Generated video result digest differs");}diff --git a/packages/generation/src/index.ts b/packages/generation/src/index.tsindex 0bb36c9d..e9af9c40 100644--- a/packages/generation/src/index.ts+++ b/packages/generation/src/index.ts@@ -6,7 +6,6 @@ export {sealGenerationRequest,verifyGeneratedImageSet,verifyGeneratedVideoSet,- verifyGenerationRequestDigest,} from "./identity.js";export {generationManifest,diff --git a/packages/generation/src/manifest.ts b/packages/generation/src/manifest.tsindex 5d7dadec..14dfca7f 100644--- a/packages/generation/src/manifest.ts+++ b/packages/generation/src/manifest.ts@@ -68,7 +68,6 @@ export const generationManifest: ModuleManifest = {outputs: [{name: "image",type: artifactTypes.blob,- affinity: [{ resultPointer: "/digest", input: "set", inputPointer: "/images/0/digest" }],}],needs: [],implementation: {@@ -83,7 +82,6 @@ export const generationManifest: ModuleManifest = {outputs: [{name: "video",type: artifactTypes.blob,- affinity: [{ resultPointer: "/digest", input: "set", inputPointer: "/videos/0/digest" }],}],needs: [],implementation: {diff --git a/packages/generation/src/schema.ts b/packages/generation/src/schema.tsindex f8ac281c..af5803d1 100644--- a/packages/generation/src/schema.ts+++ b/packages/generation/src/schema.ts@@ -38,7 +38,6 @@ export const generatedImageSetSchema = generationObjectSchema({items: generationBlobRefSchema,},},- resultDigest: { schema: generationDigestSchema },});export const generatedVideoSetSchema = generationObjectSchema({@@ -51,5 +50,4 @@ export const generatedVideoSetSchema = generationObjectSchema({items: generationBlobRefSchema,},},- resultDigest: { schema: generationDigestSchema },});diff --git a/packages/generation/src/types.ts b/packages/generation/src/types.tsindex b32919de..8c2dbaa3 100644--- a/packages/generation/src/types.ts+++ b/packages/generation/src/types.ts@@ -1,16 +1,14 @@-import type { BlobRef, Digest } from "@svml/protocol";+import type { BlobRef } from "@svml/protocol";export type GeneratedImageSet = {readonly contract: "svml.generated-image-set@1";readonly images: readonly BlobRef[];- readonly resultDigest: Digest;};export type GeneratedVideoSet = {readonly contract: "svml.generated-video-set@1";readonly videos: readonly BlobRef[];- readonly resultDigest: Digest;};-export type GeneratedImageSetContent = Omit<GeneratedImageSet, "resultDigest">;-export type GeneratedVideoSetContent = Omit<GeneratedVideoSet, "resultDigest">;+export type GeneratedImageSetContent = GeneratedImageSet;+export type GeneratedVideoSetContent = GeneratedVideoSet;diff --git a/packages/gpt-image/src/index.ts b/packages/gpt-image/src/index.tsindex 212c8fc6..085e34ea 100644--- a/packages/gpt-image/src/index.ts+++ b/packages/gpt-image/src/index.ts@@ -1,14 +1,12 @@import {assertGenerationBlobRef,generationBlobRefSchema,- generationDigestSchema,generationObjectSchema,generationPromptSchema,sealGenerationRequest,- verifyGenerationRequestDigest,} from "@svml/generation";import { defineExactModelModule } from "@svml/model-kit";-import type { BlobRef, Digest, ValueSchema } from "@svml/protocol";+import type { BlobRef, ValueSchema } from "@svml/protocol";export const gptImageModuleRef = { name: "@svml/gpt-image", version: "0.0.0-dev" } as const;export type GptImage2Mode = "text" | "image";@@ -24,14 +22,13 @@ export type GptImage2ImageRequestContent = Common & {readonly images: readonly BlobRef[];};export type GptImage2RequestContent = GptImage2TextRequestContent | GptImage2ImageRequestContent;-export type GptImage2Request = GptImage2RequestContent & { readonly requestDigest: Digest };+export type GptImage2Request = GptImage2RequestContent;const commonFields = {contract: { schema: { kind: "literal", value: "svml.gpt-image-2-request@1" } },model: { schema: { kind: "literal", value: "gpt-image-2" } },prompt: { schema: generationPromptSchema },aspectRatio: { schema: { kind: "string", minLength: 3, maxLength: 16 } },- requestDigest: { schema: generationDigestSchema },} as const;const schemas: Record<GptImage2Mode, ValueSchema> = {text: generationObjectSchema({@@ -51,7 +48,6 @@ function object(value: unknown): Record<string, unknown> {}export function verifyGptImage2Request(value: unknown, expectedMode?: GptImage2Mode): asserts value is GptImage2Request {- verifyGenerationRequestDigest(value);const request = object(value);if (request.contract !== "svml.gpt-image-2-request@1" || request.model !== "gpt-image-2") {throw new Error("GPT Image 2 request identity is invalid");@@ -67,7 +63,7 @@ export function verifyGptImage2Request(value: unknown, expectedMode?: GptImage2Mexport function sealGptImage2Request<T extends GptImage2RequestContent>(content: T,-): T & { readonly requestDigest: Digest } {+): T {const request = sealGenerationRequest(content);verifyGptImage2Request(request, content.mode);return request;diff --git a/packages/grok-imagine/src/index.ts b/packages/grok-imagine/src/index.tsindex 174c50e6..8cb733bc 100644--- a/packages/grok-imagine/src/index.ts+++ b/packages/grok-imagine/src/index.ts@@ -1,14 +1,12 @@import {assertGenerationBlobRef,generationBlobRefSchema,- generationDigestSchema,generationObjectSchema,generationPromptSchema,sealGenerationRequest,- verifyGenerationRequestDigest,} from "@svml/generation";import { defineExactModelModule } from "@svml/model-kit";-import type { BlobRef, Digest, ValueSchema } from "@svml/protocol";+import type { BlobRef, ValueSchema } from "@svml/protocol";export const grokImagineModuleRef = { name: "@svml/grok-imagine", version: "0.0.0-dev" } as const;export type GrokImagineMode = "text" | "image" | "preview-1.5";@@ -40,7 +38,7 @@ export type GrokImagineRequestContent =| GrokImagineTextRequestContent| GrokImagineImageRequestContent| GrokImaginePreviewRequestContent;-export type GrokImagineRequest = GrokImagineRequestContent & { readonly requestDigest: Digest };+export type GrokImagineRequest = GrokImagineRequestContent;const aspectSchema = { kind: "string", minLength: 3, maxLength: 16 } as const satisfies ValueSchema;const commonFields = {@@ -49,7 +47,6 @@ const commonFields = {aspectRatio: { schema: aspectSchema },resolution: { schema: { kind: "string", enum: ["480p", "720p"] } },durationSec: { schema: { kind: "number", integer: true, minimum: 1, maximum: 15 } },- requestDigest: { schema: generationDigestSchema },} as const;const schemas: Record<GrokImagineMode, ValueSchema> = {text: generationObjectSchema({@@ -81,7 +78,6 @@ function object(value: unknown): Record<string, unknown> {}export function verifyGrokImagineRequest(value: unknown, expectedMode?: GrokImagineMode): asserts value is GrokImagineRequest {- verifyGenerationRequestDigest(value);const request = object(value);if (request.contract !== "svml.grok-imagine-video-request@1") throw new Error("Grok Imagine request contract is invalid");if (expectedMode !== undefined && request.mode !== expectedMode) throw new Error(`Expected Grok Imagine ${expectedMode}`);@@ -105,7 +101,7 @@ export function verifyGrokImagineRequest(value: unknown, expectedMode?: GrokImagexport function sealGrokImagineRequest<T extends GrokImagineRequestContent>(content: T,-): T & { readonly requestDigest: Digest } {+): T {const request = sealGenerationRequest(content);verifyGrokImagineRequest(request, content.mode);return request;diff --git a/packages/hyperframes-render/src/fragment.ts b/packages/hyperframes-render/src/fragment.tsindex ae4e5d3c..19696b15 100644--- a/packages/hyperframes-render/src/fragment.ts+++ b/packages/hyperframes-render/src/fragment.ts@@ -12,12 +12,15 @@ const operation = (id: string) => ({ kind: "fragment-operation" as const, operatexport const hyperframesRenderFragment = sealGraphFragment({name: "@svml/hyperframes-render/video@1",- inputs: [{ name: "composition", type: contractTypes.composition }],+ inputs: [+ { name: "composition", type: contractTypes.composition },+ { name: "space", type: contractTypes.programSpace },+ ],operations: [{id: "compile-document",producer: hyperframesProducers.compile,- inputs: { composition: input("composition") },+ inputs: { composition: input("composition"), space: input("space") },result: { kind: "output", name: "document" },},{@@ -29,7 +32,7 @@ export const hyperframesRenderFragment = sealGraphFragment({{id: "compile-audio-program",producer: mediaPipelineProducers.planAudio,- inputs: { composition: input("composition") },+ inputs: { composition: input("composition"), space: input("space") },result: { kind: "output", name: "plan" },},{@@ -58,12 +61,7 @@ export const hyperframesRenderFragment = sealGraphFragment({name: "video",type: contractTypes.mediaArtifact,root: operation("project-video"),- semanticInputs: ["composition"],- affinity: [{- resultPointer: "/digest",- source: operation("request-mux"),- sourcePointer: "/artifact/digest",- }],+ semanticInputs: ["composition", "space"],fidelity: "exact",}],});diff --git a/packages/hyperframes-render/src/manifest.ts b/packages/hyperframes-render/src/manifest.tsindex 64c81841..a998d630 100644--- a/packages/hyperframes-render/src/manifest.ts+++ b/packages/hyperframes-render/src/manifest.ts@@ -67,15 +67,6 @@ export const hyperframesRenderManifest: ModuleManifest = {name: "visual",capability: hyperframesRenderCapabilities.renderVisual,returns: contractTypes.renderedVisual,- affinity: [- { resultPointer: "/renderInputDigest", input: "document", inputPointer: "/digest" },- { resultPointer: "/programSpaceDigest", input: "document", inputPointer: "/programSpaceDigest" },- { resultPointer: "/frameRate/numerator", input: "document", inputPointer: "/frameRate/numerator" },- { resultPointer: "/frameRate/denominator", input: "document", inputPointer: "/frameRate/denominator" },- { resultPointer: "/frameCount", input: "document", inputPointer: "/frameCount" },- { resultPointer: "/canvas/width", input: "document", inputPointer: "/canvas/width" },- { resultPointer: "/canvas/height", input: "document", inputPointer: "/canvas/height" },- ],}],implementation: {kind: "registered",diff --git a/packages/hyperframes-render/src/surface.ts b/packages/hyperframes-render/src/surface.tsindex e72125dc..2bd6de56 100644--- a/packages/hyperframes-render/src/surface.ts+++ b/packages/hyperframes-render/src/surface.ts@@ -23,7 +23,7 @@ function referenceAttribute(element: StructuredElement, name: string): string {export const decodeHyperframesRenderSurface: StructuredSurfaceHandler = ({ element, resolveReference }) => {const names = Object.keys(element.attributes).sort();- if (names.join(",") !== "composition,id") throw new Error(`${element.name} requires exactly composition and id`);+ if (names.join(",") !== "composition,id,space") throw new Error(`${element.name} requires exactly composition, id and space`);if (element.children.some((child) => child.kind === "element" || child.value.trim().length > 0)) {throw new Error(`${element.name} does not accept children`);}@@ -36,12 +36,20 @@ export const decodeHyperframesRenderSurface: StructuredSurfaceHandler = ({ eleme|| composition.type.name !== contractTypes.composition.name) {throw new Error(`${element.name}.composition must reference Composition`);}+ const spacePath = referenceAttribute(element, "space");+ const space = resolveReference(spacePath);+ if (space === undefined+ || space.type.module.name !== contractTypes.programSpace.module.name+ || space.type.module.version !== contractTypes.programSpace.module.version+ || space.type.name !== contractTypes.programSpace.name) {+ throw new Error(`${element.name}.space must reference ProgramSpace`);+ }return {records: [],components: [{id,fragment: hyperframesRenderFragment.id,- inputs: { composition: composition.ref },+ inputs: { composition: composition.ref, space: space.ref },outputs: { video: `${id}.video` },range: element.range,}],diff --git a/packages/hyperframes-render/test/render.test.ts b/packages/hyperframes-render/test/render.test.tsindex 63f86704..29892d6c 100644--- a/packages/hyperframes-render/test/render.test.ts+++ b/packages/hyperframes-render/test/render.test.ts@@ -88,7 +88,6 @@ const space = sealProgramSpace({const composition = sealComposition({contract: "svml.composition@1",id: "render-test",- programSpace: space,canvas: { width: 1080, height: 1920, clearColor: "#000000" },tracks: [],});@@ -118,15 +117,25 @@ const compositionRecord = await admitRecord(closure, sealRecord({conformance: "exact",origin,}), validatorRegistry());+const spaceRecord = await admitRecord(closure, sealRecord({+ id: "space",+ type: contractTypes.programSpace,+ value: stored(space),+ conformance: "exact",+ origin,+}), validatorRegistry());const linked = link(closure, [sealTypedModule({id: "author:hyperframes-render-test",closureDigest: closure.digest,- records: [compositionRecord],+ records: [compositionRecord, spaceRecord],})]);const instance = elaborateGraphFragment(linked, hyperframesRenderFragment, {id: "final",fragment: hyperframesRenderFragment.id,- inputs: { composition: { kind: "record", id: compositionRecord.id } },+ inputs: {+ composition: { kind: "record", id: compositionRecord.id },+ space: { kind: "record", id: spaceRecord.id },+ },});const contribution = bindAuthorFragment(instance, { video: "final.video" });const graph = sealCompiledGraph({ program: linked.semanticDigest, ...contribution });@@ -172,7 +181,7 @@ test("HyperFrames rendering is an explicit exact Need after ordinary document coconst visual = result.state.needs.find((need) => need.capability.name === hyperframesRenderCapabilities.renderVisual.name)!;assert.equal(visual.returns.name, contractTypes.renderedVisual.name);assert.equal(visual.accepts, "exact");- assert.deepEqual(visual.constraints, hyperframesVisualRequest(compileHyperframesDocument(composition)));+ assert.deepEqual(visual.constraints, hyperframesVisualRequest(compileHyperframesDocument(composition, space)));const audio = result.state.needs.find((need) => need.capability.name === "render-timeline-audio")!;assert.equal(audio.returns.name, contractTypes.timelineAudio.name);assert.equal(result.blocked.every((item) => item.reason === "missing-endpoint"), true);@@ -211,8 +220,6 @@ test("separate visual, audio and mux Endpoints complete one author-visible rendereturn {value: stored(sealRenderedVisual({contract: "svml.rendered-visual@1",- renderInputDigest: request.document.digest,- programSpaceDigest: request.document.programSpaceDigest,frameRate: request.document.frameRate,frameCount: request.document.frameCount,canvas: request.document.canvas,@@ -234,8 +241,6 @@ test("separate visual, audio and mux Endpoints complete one author-visible rendereturn {value: stored(sealTimelineAudio({contract: "svml.timeline-audio@1",- planDigest: request.plan.planDigest,- programSpaceDigest: request.plan.programSpaceDigest,artifact: audioArtifact,codec: "pcm_s16le",sampleRate: 48_000,@@ -258,9 +263,6 @@ test("separate visual, audio and mux Endpoints complete one author-visible rendereturn {value: stored(sealMuxedMedia({contract: "svml.muxed-media@1",- visualDigest: request.visual.visualDigest,- audioDigest: request.audio.audioDigest,- programSpaceDigest: request.visual.programSpaceDigest,frameRate: request.visual.frameRate,frameCount: request.visual.frameCount,canvas: request.visual.canvas,@@ -294,8 +296,8 @@ test("separate visual, audio and mux Endpoints complete one author-visible rende});});-test("a render Product cannot claim another frame domain while keeping the requested document", async () => {- const document = compileHyperframesDocument(composition);+test("a render Product with another frame domain is rejected by the explicit downstream join", async () => {+ const document = compileHyperframesDocument(composition, space);const endpoints = new EndpointRegistry();endpoints.registerImmediateEndpoint("example.hyperframes.wrong-domain",@@ -304,8 +306,6 @@ test("a render Product cannot claim another frame domain while keeping the reque() => ({value: stored(sealRenderedVisual({contract: "svml.rendered-visual@1",- renderInputDigest: document.digest,- programSpaceDigest: document.programSpaceDigest,frameRate: document.frameRate,frameCount: document.frameCount + 1,canvas: document.canvas,@@ -322,7 +322,35 @@ test("a render Product cannot claim another frame domain while keeping the requemetadata: {},}),);+ endpoints.registerImmediateEndpoint(+ "example.media.audio-for-domain-check",+ mediaPipelineCapabilities.renderAudio,+ contractTypes.timelineAudio,+ ({ need }) => {+ const request = need.constraints as { readonly plan: ReturnType<typeof compileAudioProgramPlan> };+ return {+ value: stored(sealTimelineAudio({+ contract: "svml.timeline-audio@1",+ artifact: {+ kind: "blob",+ digest: digestOf("hyperframes-render:domain-check-audio"),+ size: 1,+ mediaType: "audio/wav",+ },+ codec: "pcm_s16le",+ sampleRate: request.plan.sampleRate,+ channels: 2,+ sampleFrames: request.plan.sampleFrames,+ loudness: "planned",+ })),+ conformance: "exact",+ delivery: "executed",+ metadata: {},+ };+ },+ );endpoints.bind(hyperframesRenderCapabilities.renderVisual, "example.hyperframes.wrong-domain");+ endpoints.bind(mediaPipelineCapabilities.renderAudio, "example.media.audio-for-domain-check");const result = await new NodeDriver({producers: producerRegistry(),@@ -330,8 +358,8 @@ test("a render Product cannot claim another frame domain while keeping the requevalidators: validatorRegistry(),}).run(build());assert.equal(result.status, "paused");- assert.match(result.journal.at(-1)?.message ?? "", /frameCount|does not match/u);- assert.equal(result.state.receipts.length, 0);+ assert.match(result.journal.at(-1)?.message ?? "", /different presentation durations/u);+ assert.equal(result.state.receipts.length, 2);});const fixtureModule = { name: "example.composition-fixture", version: "1" } as const;@@ -340,14 +368,14 @@ const fixtureManifest: ModuleManifest = {format: "svml.module@0",name: fixtureModule.name,version: fixtureModule.version,- dependencies: [videoContractDependencies.composition],+ dependencies: [videoContractDependencies.composition, videoContractDependencies.programSpace],types: [],capabilities: [],surfaces: [{name: "composition",tag: "Composition",mode: "structured",- outputs: [contractTypes.composition],+ outputs: [contractTypes.composition, contractTypes.programSpace],implementation: {kind: "trusted-frontend-surface",locator: "example.composition-fixture/surface",@@ -375,12 +403,10 @@ test("the official render Surface lowers real author source to the same BuildPla]);const surfaces = new TextSurfaceRegistry();surfaces.registerStructured(fixtureModule, "composition", fixtureSurfaceDigest, ({ element }) => ({- records: [{- id: "composition",- type: contractTypes.composition,- value: stored(composition),- range: element.range,- }],+ records: [+ { id: "composition", type: contractTypes.composition, value: stored(composition), range: element.range },+ { id: "space", type: contractTypes.programSpace, value: stored(space), range: element.range },+ ],components: [],fragments: [],}));@@ -404,7 +430,7 @@ test("the official render Surface lowers real author source to the same BuildPla<import as="fixture" from="example.composition-fixture@1"/><import as="render" from="@svml/hyperframes-render@1"/><fixture:Composition/>- <render:Video id="final" composition={composition}/>+ <render:Video id="final" composition={composition} space={space}/></svml>`),closure: sourceClosure,frontends,diff --git a/packages/hyperframes/README.md b/packages/hyperframes/README.mdindex f8fe7076..470bcad1 100644--- a/packages/hyperframes/README.md+++ b/packages/hyperframes/README.md@@ -25,8 +25,9 @@ handing the HTML to HyperFrames. That environment-specific materialization is noRecord and does not change the document digest.The document exposes its render domain directly rather than asking an Endpoint to scrape HTML:-`programSpaceDigest`, exact rational `frameRate`, integer `frameCount`, and canvas dimensions are-all content-addressed. Legal frame addresses are exactly `[0, frameCount)`. A local worker pool or a+exact rational `frameRate`, integer `frameCount`, and canvas dimensions are explicit document+content. The ProgramSpace relationship is an input edge of the Producer and is not copied into the+document as lineage metadata. Legal frame addresses are exactly `[0, frameCount)`. A local worker pool or ahosted renderer may independently evaluate any legal frame or half-open chunk; partition size andworker count are Runtime policy, not author intent and not Core graph nodes. The emitted root alsouses the rational HyperFrames `data-fps` form, so NTSC rates do not drift through a decimal guess.diff --git a/packages/hyperframes/src/component.ts b/packages/hyperframes/src/component.tsindex 847bc26f..02128326 100644--- a/packages/hyperframes/src/component.ts+++ b/packages/hyperframes/src/component.ts@@ -1,5 +1,5 @@import type { ComponentPackage } from "@svml/component-kit";-import type { Composition } from "@svml/contracts";+import type { Composition, ProgramSpace } from "@svml/contracts";import type { CanonicalValue, StoredValue } from "@svml/protocol";import { canonicalize } from "@svml/protocol";@@ -26,6 +26,7 @@ export const hyperframesComponent = {kind: "inline",value: canonicalize(compileHyperframesDocument(inline(inputs.composition!.value, "Composition") as unknown as Composition,+ inline(inputs.space!.value, "ProgramSpace") as unknown as ProgramSpace,)),},},diff --git a/packages/hyperframes/src/document.ts b/packages/hyperframes/src/document.tsindex be0b0d8e..c734e9fc 100644--- a/packages/hyperframes/src/document.ts+++ b/packages/hyperframes/src/document.ts@@ -6,6 +6,7 @@ import {import type {Composition,FontArtifactRef,+ ProgramSpace,Track,VisualAttribute,VisualElement,@@ -213,7 +214,7 @@ function orderedVisualPresents(tracks: readonly Track[]): Array<{ readonly trackfunction collectArtifacts(composition: Composition): BlobRef[] {const artifacts = new Map<Digest, BlobRef>();- const add = (artifact: { readonly digest: Digest; readonly size: number; readonly mediaType: string }): void => {+ const add = (artifact: Pick<BlobRef, "digest" | "size" | "mediaType">): void => {const next: BlobRef = {kind: "blob",digest: artifact.digest,@@ -274,15 +275,15 @@ function renderFontFaces(composition: Composition): string {].join("")).join("\n ");}-function emitHtml(composition: Composition): string {- const { numerator, denominator } = composition.programSpace.frameRate;+function emitHtml(composition: Composition, programSpace: ProgramSpace): string {+ const { numerator, denominator } = programSpace.frameRate;const visuals = orderedVisualPresents(composition.tracks);const visualHtml = visuals.map(({ track, present }, index) => renderVisualPresent(track, present, index, numerator, denominator)).join("\n ");const animationCss = visuals.flatMap(({ track, present }) => renderAnimationRules(track, present)).join("\n ");const fontCss = renderFontFaces(composition);- const duration = frameSeconds(programSpaceFrameCount(composition.programSpace), numerator, denominator);+ const duration = frameSeconds(programSpaceFrameCount(programSpace), numerator, denominator);const fps = fpsRational(numerator, denominator);- const frameCount = programSpaceFrameCount(composition.programSpace);+ const frameCount = programSpaceFrameCount(programSpace);return `<!doctype html><html><head>@@ -297,7 +298,7 @@ function emitHtml(composition: Composition): string {</style></head><body>- <div data-composition-id="${escapeHtml(composition.id)}" data-start="0" data-no-timeline data-width="${composition.canvas.width}" data-height="${composition.canvas.height}" data-duration="${duration}" data-fps="${fps}" data-svml-frame-count="${frameCount}" data-svml-program-space="${composition.programSpace.digest}">+ <div data-composition-id="${escapeHtml(composition.id)}" data-start="0" data-no-timeline data-width="${composition.canvas.width}" data-height="${composition.canvas.height}" data-duration="${duration}" data-fps="${fps}" data-svml-frame-count="${frameCount}">${visualHtml}</div></body>@@ -305,12 +306,10 @@ function emitHtml(composition: Composition): string {`;}-function normalizedDocument(value: Omit<HyperframesDocument, "digest">): Omit<HyperframesDocument, "digest"> {+function normalizedDocument(value: HyperframesDocument): HyperframesDocument {return {contract: "svml.hyperframes-document@4",visualIr: value.visualIr,- compositionDigest: value.compositionDigest,- programSpaceDigest: value.programSpaceDigest,frameRate: { ...value.frameRate },frameCount: value.frameCount,canvas: { ...value.canvas },@@ -321,35 +320,26 @@ function normalizedDocument(value: Omit<HyperframesDocument, "digest">): Omit<Hy};}-export function compileHyperframesDocument(composition: Composition): HyperframesDocument {- assertCompositionIdentity(composition);+export function compileHyperframesDocument(composition: Composition, programSpace: ProgramSpace): HyperframesDocument {+ assertCompositionIdentity(composition, programSpace);const content = normalizedDocument({contract: "svml.hyperframes-document@4",visualIr: HYPERFRAMES_VISUAL_IR_V1,- compositionDigest: composition.digest,- programSpaceDigest: composition.programSpace.digest,- frameRate: { ...composition.programSpace.frameRate },- frameCount: programSpaceFrameCount(composition.programSpace),+ frameRate: { ...programSpace.frameRate },+ frameCount: programSpaceFrameCount(programSpace),canvas: {width: composition.canvas.width,height: composition.canvas.height,},artifacts: collectArtifacts(composition),- html: emitHtml(composition),+ html: emitHtml(composition, programSpace),});- return { ...content, digest: digestOf(content) };+ return content;}export function assertHyperframesDocument(document: HyperframesDocument): void {if (document.contract !== "svml.hyperframes-document@4") throw new Error("Unsupported HyperframesDocument contract.");if (document.visualIr !== HYPERFRAMES_VISUAL_IR_V1) throw new Error("Unsupported HyperframesDocument visual IR.");- if (- !isDigest(document.compositionDigest)- || !isDigest(document.programSpaceDigest)- || !isDigest(document.digest)- ) {- throw new Error("HyperframesDocument digest is invalid.");- }if (!Number.isSafeInteger(document.frameRate.numerator)|| document.frameRate.numerator <= 0@@ -364,8 +354,6 @@ export function assertHyperframesDocument(document: HyperframesDocument): void {) {throw new Error("HyperframesDocument frame domain or canvas is invalid.");}- const { digest, ...content } = document;- if (digest !== digestOf(normalizedDocument(content))) throw new Error("HyperframesDocument digest does not match its contents.");if (!document.html.startsWith("<!doctype html>")) throw new Error("HyperframesDocument HTML is invalid.");const declared = [...document.artifacts];if (declared.some((item) => item.kind !== "blob" || !isDigest(item.digest)diff --git a/packages/hyperframes/src/fragment.ts b/packages/hyperframes/src/fragment.tsindex 14f5d98e..e80666ba 100644--- a/packages/hyperframes/src/fragment.ts+++ b/packages/hyperframes/src/fragment.ts@@ -13,23 +13,21 @@ const operation = (id: string) => ({ kind: "fragment-operation" as const, operat*/export const hyperframesDocumentFragment = sealGraphFragment({name: "@svml/hyperframes/document@1",- inputs: [{ name: "composition", type: contractTypes.composition }],+ inputs: [+ { name: "composition", type: contractTypes.composition },+ { name: "space", type: contractTypes.programSpace },+ ],operations: [{id: "compile-document",producer: hyperframesProducers.compile,- inputs: { composition: input("composition") },+ inputs: { composition: input("composition"), space: input("space") },result: { kind: "output", name: "document" },}],exports: [{name: "document",type: hyperframesTypes.document,root: operation("compile-document"),- semanticInputs: ["composition"],- affinity: [{- resultPointer: "/compositionDigest",- source: input("composition"),- sourcePointer: "/digest",- }],+ semanticInputs: ["composition", "space"],fidelity: "exact",}],});diff --git a/packages/hyperframes/src/manifest.ts b/packages/hyperframes/src/manifest.tsindex 257e8727..35e824f9 100644--- a/packages/hyperframes/src/manifest.ts+++ b/packages/hyperframes/src/manifest.ts@@ -24,9 +24,6 @@ export const hyperframesDocumentSchema: ValueSchema = {fields: {contract: { schema: { kind: "literal", value: "svml.hyperframes-document@4" } },visualIr: { schema: { kind: "literal", value: HYPERFRAMES_VISUAL_IR_V1 } },- digest: { schema: digest },- compositionDigest: { schema: digest },- programSpaceDigest: { schema: digest },frameRate: { schema: {kind: "object",fields: {@@ -59,25 +56,17 @@ export const hyperframesManifest: ModuleManifest = {format: "svml.module@0",name: hyperframesModuleRef.name,version: hyperframesModuleRef.version,- dependencies: [videoContractDependencies.composition],+ dependencies: [videoContractDependencies.composition, videoContractDependencies.programSpace],types: [{ name: hyperframesTypes.document.name, schema: hyperframesDocumentSchema }],capabilities: [],surfaces: [],producers: [{name: hyperframesProducers.compile.name,- inputs: [{ name: "composition", type: contractTypes.composition }],- outputs: [{- name: "document",- type: hyperframesTypes.document,- affinity: [- { resultPointer: "/compositionDigest", input: "composition", inputPointer: "/digest" },- { resultPointer: "/programSpaceDigest", input: "composition", inputPointer: "/programSpace/digest" },- { resultPointer: "/frameRate/numerator", input: "composition", inputPointer: "/programSpace/frameRate/numerator" },- { resultPointer: "/frameRate/denominator", input: "composition", inputPointer: "/programSpace/frameRate/denominator" },- { resultPointer: "/canvas/width", input: "composition", inputPointer: "/canvas/width" },- { resultPointer: "/canvas/height", input: "composition", inputPointer: "/canvas/height" },- ],- }],+ inputs: [+ { name: "composition", type: contractTypes.composition },+ { name: "space", type: contractTypes.programSpace },+ ],+ outputs: [{ name: "document", type: hyperframesTypes.document }],needs: [],implementation: {kind: "registered",diff --git a/packages/hyperframes/src/types.ts b/packages/hyperframes/src/types.tsindex 206fd09a..c2f065a4 100644--- a/packages/hyperframes/src/types.ts+++ b/packages/hyperframes/src/types.ts@@ -2,8 +2,6 @@ import type { HYPERFRAMES_VISUAL_IR_V1 } from "@svml/contracts";import type { BlobRef, Digest } from "@svml/protocol";export type HyperframesFrameDomain = {- /** Exact ProgramSpace whose integer frame domain this document renders. */- readonly programSpaceDigest: Digest;readonly frameRate: {readonly numerator: number;readonly denominator: number;@@ -21,8 +19,6 @@ export type HyperframesCanvas = {export type HyperframesDocument = HyperframesFrameDomain & {readonly contract: "svml.hyperframes-document@4";readonly visualIr: typeof HYPERFRAMES_VISUAL_IR_V1;- readonly digest: Digest;- readonly compositionDigest: Digest;readonly canvas: HyperframesCanvas;/** Every content-addressed byte dependency referenced by the HTML template. */readonly artifacts: readonly BlobRef[];diff --git a/packages/hyperframes/test/browser-visual.test.ts b/packages/hyperframes/test/browser-visual.test.tsindex fd7f3c2b..d3dd512a 100644--- a/packages/hyperframes/test/browser-visual.test.ts+++ b/packages/hyperframes/test/browser-visual.test.ts@@ -111,7 +111,6 @@ test("locked font and straight-alpha Surface survive one real Hyperframes browsecontract: "svml.visual-track@1",visualIr: "svml.hyperframes-visual-ir@1",id: "blue",- programSpaceDigest: space.digest,presents: [{id: "blue",span: { startFrame: 0, endFrameExclusive: 1 },@@ -132,7 +131,6 @@ test("locked font and straight-alpha Surface survive one real Hyperframes browsecontract: "svml.visual-track@1",visualIr: "svml.hyperframes-visual-ir@1",id: "surface",- programSpaceDigest: space.digest,presents: [{id: "surface",span: { startFrame: 0, endFrameExclusive: 1 },@@ -158,7 +156,6 @@ test("locked font and straight-alpha Surface survive one real Hyperframes browsecontract: "svml.visual-track@1",visualIr: "svml.hyperframes-visual-ir@1",id: "text",- programSpaceDigest: space.digest,presents: [{id: "text",span: { startFrame: 0, endFrameExclusive: 1 },@@ -183,10 +180,9 @@ test("locked font and straight-alpha Surface survive one real Hyperframes browseconst document = compileHyperframesDocument(sealComposition({contract: "svml.composition@1",id: "visual-proof",- programSpace: space,canvas: { width: 64, height: 64, clearColor: "#000000" },tracks: [text, lower, surface],- }));+ }), space);await copyFile(localFont, path.join(temp, "font.ttf"));await writeFile(path.join(temp, "surface.png"), surfaceBytes);diff --git a/packages/hyperframes/test/document.test.ts b/packages/hyperframes/test/document.test.tsindex 9c68881d..83a23ac7 100644--- a/packages/hyperframes/test/document.test.ts+++ b/packages/hyperframes/test/document.test.ts@@ -41,7 +41,6 @@ function fixture() {contract: "svml.visual-track@1",visualIr: "svml.hyperframes-visual-ir@1",id: "lower",- programSpaceDigest: programSpace.digest,presents: [{id: "picture",span: { startFrame: 0, endFrameExclusive: 30 },@@ -59,7 +58,6 @@ function fixture() {contract: "svml.visual-track@1",visualIr: "svml.hyperframes-visual-ir@1",id: "upper",- programSpaceDigest: programSpace.digest,presents: [{id: "words",span: { startFrame: 3, endFrameExclusive: 20 },@@ -73,24 +71,21 @@ function fixture() {const audio = sealAudioTrack({contract: "svml.audio-track@1",id: "sound",- programSpaceDigest: programSpace.digest,clips: [{ id: "main", span: { startFrame: 0, endFrameExclusive: 30 }, artifact: sound, bus: "speech" }],});const composition = sealComposition({contract: "svml.composition@1",id: "main",- programSpace,canvas: { width: 1080, height: 1920, clearColor: "#000000" },tracks: [upper, audio, lower],});- return { composition, picture, sound };+ return { composition, picture, sound, programSpace };}test("HyperFrames flattens generic peer visual Track Presents without absorbing audio rendering", () => {- const { composition, picture, sound } = fixture();- const document = compileHyperframesDocument(composition);+ const { composition, picture, sound, programSpace } = fixture();+ const document = compileHyperframesDocument(composition, programSpace);assert.doesNotThrow(() => assertHyperframesDocument(document));- assert.equal(document.compositionDigest, composition.digest);assert.equal(document.visualIr, HYPERFRAMES_VISUAL_IR_V1);assert.deepEqual(document.artifacts, [{kind: "blob",@@ -108,8 +103,8 @@ test("HyperFrames flattens generic peer visual Track Presents without absorbing});test("visual Artifact placeholders are materialized only by the Runtime boundary", () => {- const { composition, picture, sound } = fixture();- const document = compileHyperframesDocument(composition);+ const { composition, picture, sound, programSpace } = fixture();+ const document = compileHyperframesDocument(composition, programSpace);assert.match(document.html, /svml-artifact:\/\/sha256\//u);const resolved = materializeHyperframesHtml(document,(artifact) => `https://assets.example/${artifact.digest}?x=1&y=2`);@@ -119,14 +114,10 @@ test("visual Artifact placeholders are materialized only by the Runtime boundaryassert.equal(document.html.includes("assets.example"), false, "materialization must not mutate the compiled document");});-test("HyperframesDocument binds its HTML and exact frame-to-time projection", () => {- const { composition } = fixture();- const document = compileHyperframesDocument(composition);- const tampered = { ...document, html: document.html.replace("Hello", "Tampered") };- assert.throws(() => assertHyperframesDocument(tampered), /digest does not match/);- const changedDomain = { ...document, frameCount: document.frameCount - 1 };- assert.throws(() => assertHyperframesDocument(changedDomain), /digest does not match/);- assert.equal(document.programSpaceDigest, composition.programSpace.digest);+test("HyperframesDocument carries render facts while its Record binds integrity", () => {+ const { composition, programSpace } = fixture();+ const document = compileHyperframesDocument(composition, programSpace);+ assert.equal("digest" in document, false);assert.deepEqual(document.frameRate, { numerator: 30_000, denominator: 1_001 });assert.equal(document.frameCount, 30);assert.deepEqual(document.canvas, { width: 1080, height: 1920 });@@ -137,7 +128,8 @@ test("HyperframesDocument binds its HTML and exact frame-to-time projection", ()});test("any legal frame and Provider-owned chunk can be addressed without traversing earlier frames", () => {- const document = compileHyperframesDocument(fixture().composition);+ const fixtureValue = fixture();+ const document = compileHyperframesDocument(fixtureValue.composition, fixtureValue.programSpace);assert.doesNotThrow(() => assertHyperframesFrameIndex(document, 0));assert.doesNotThrow(() => assertHyperframesFrameIndex(document, 17));assert.doesNotThrow(() => assertHyperframesFrameIndex(document, 29));@@ -162,7 +154,7 @@ test("any legal frame and Provider-owned chunk can be addressed without traversi});test("HyperFrames emits frame-bound local animation without creating a Track stacking context", () => {- const { composition } = fixture();+ const { composition, programSpace } = fixture();const lower = composition.tracks.find((track) => track.id === "lower");assert(lower?.contract === "svml.visual-track@1");const present = lower.presents[0]!;@@ -186,7 +178,7 @@ test("HyperFrames emits frame-bound local animation without creating a Track staconst document = compileHyperframesDocument(sealComposition({...composition,tracks: composition.tracks.map((track) => track.id === "lower" ? animated : track),- }));+ }), programSpace);assert.match(document.html, /@keyframes svml-/u);assert.match(document.html, /33\.333333333%\{opacity:1;transform:translateY\(0%\)/u);assert.match(document.html, /animation-duration:1\.001s/u);@@ -215,7 +207,6 @@ test("content-bound fonts and typed compositable Surfaces cross the same Artifaccontract: "svml.visual-track@1",visualIr: "svml.hyperframes-visual-ir@1",id: "bound-render-dependencies",- programSpaceDigest: space.digest,presents: [{id: "bound",span: { startFrame: 0, endFrameExclusive: 30 },@@ -257,10 +248,9 @@ test("content-bound fonts and typed compositable Surfaces cross the same Artifacconst document = compileHyperframesDocument(sealComposition({contract: "svml.composition@1",id: "render-dependencies",- programSpace: space,canvas: { width: 1080, height: 1920, clearColor: "#000000" },tracks: [track],- }));+ }), space);assert.doesNotThrow(() => assertHyperframesDocument(document));assert.deepEqual(document.artifacts.map((artifact) => artifact.digest), [font.artifact.digest, surfaceDigest].sort());assert.match(document.html, /@font-face\{/u);diff --git a/packages/hyperframes/test/track-expressiveness.test.ts b/packages/hyperframes/test/track-expressiveness.test.tsindex 4ad79312..467f9567 100644--- a/packages/hyperframes/test/track-expressiveness.test.ts+++ b/packages/hyperframes/test/track-expressiveness.test.ts@@ -29,7 +29,6 @@ function composition(id: string, tracks: readonly VisualTrack[]) {return sealComposition({contract: "svml.composition@1",id,- programSpace,canvas: { width: 1080, height: 1920, clearColor: "#000000" },tracks,});@@ -131,7 +130,6 @@ test("Text three-box and frame/content/line/word paint semantics lower without pcontract: "svml.visual-track@1",visualIr: "svml.hyperframes-visual-ir@1",id: "text-three-box-witness",- programSpaceDigest: programSpace.digest,presents: [textPresent("frame-paint", 0, "frame"),textPresent("content-paint", 1, "content"),@@ -139,7 +137,7 @@ test("Text three-box and frame/content/line/word paint semantics lower without ptextPresent("word-paint", 3, "word"),],});- const document = compileHyperframesDocument(composition("text-three-box", [track]));+ const document = compileHyperframesDocument(composition("text-three-box", [track]), programSpace);assert.doesNotThrow(() => assertHyperframesDocument(document));assert.deepEqual(track.presents[0]!.elements.map((element) => element.id), ["placement",@@ -181,7 +179,6 @@ test("Caption range/cue/content boxes and word-local timing remain an ordinary Vcontract: "svml.visual-track@1",visualIr: "svml.hyperframes-visual-ir@1",id: "caption-three-box-witness",- programSpaceDigest: programSpace.digest,presents: [{id: "cue-1",span: { startFrame: 30, endFrameExclusive: 90 },@@ -243,7 +240,7 @@ test("Caption range/cue/content boxes and word-local timing remain an ordinary V],}],});- const document = compileHyperframesDocument(composition("caption-three-box", [track]));+ const document = compileHyperframesDocument(composition("caption-three-box", [track]), programSpace);assert.doesNotThrow(() => assertHyperframesDocument(document));assert.equal("captionMode" in track, false);assert.match(document.html, /data-svml-element-id="range"/u);@@ -265,7 +262,6 @@ test("one content box lowers independent backdrop and foreground samples of onecontract: "svml.visual-track@1",visualIr: "svml.hyperframes-visual-ir@1",id: "media-two-box-witness",- programSpaceDigest: programSpace.digest,presents: [{id: "media-card",span: { startFrame: 60, endFrameExclusive: 180 },@@ -322,7 +318,7 @@ test("one content box lowers independent backdrop and foreground samples of one],}],});- const document = compileHyperframesDocument(composition("media-two-box", [track]));+ const document = compileHyperframesDocument(composition("media-two-box", [track]), programSpace);assert.doesNotThrow(() => assertHyperframesDocument(document));assert.deepEqual(document.artifacts.map((artifact) => artifact.digest), [media.digest],"two samples must retain one content dependency");@@ -339,7 +335,6 @@ test("Presents from one authoring Track interleave with a peer Track by absolutecontract: "svml.visual-track@1",visualIr: "svml.hyperframes-visual-ir@1",id: "ranking-witness",- programSpaceDigest: programSpace.digest,presents: [{id: "board",@@ -365,7 +360,6 @@ test("Presents from one authoring Track interleave with a peer Track by absolutecontract: "svml.visual-track@1",visualIr: "svml.hyperframes-visual-ir@1",id: "peer-text",- programSpaceDigest: programSpace.digest,presents: [{id: "peer",span: { startFrame: 0, endFrameExclusive: 300 },@@ -373,7 +367,7 @@ test("Presents from one authoring Track interleave with a peer Track by absoluteelements: [{ id: "peer", order: 0, kind: "text", text: "between", style: [] }],}],});- const document = compileHyperframesDocument(composition("interleaved-ranking", [ranking, peer]));+ const document = compileHyperframesDocument(composition("interleaved-ranking", [ranking, peer]), programSpace);const boardAt = document.html.indexOf('data-svml-present-id="board"');const peerAt = document.html.indexOf('data-svml-present-id="peer"');const icon1At = document.html.indexOf('data-svml-present-id="icon-1"');@@ -405,7 +399,6 @@ test("a complex owned visual may materialize as a typed compositable Surface witcontract: "svml.visual-track@1",visualIr: "svml.hyperframes-visual-ir@1",id: "materialized-visual-witness",- programSpaceDigest: programSpace.digest,presents: [{id: "surface",span: { startFrame: 120, endFrameExclusive: 180 },@@ -419,7 +412,7 @@ test("a complex owned visual may materialize as a typed compositable Surface wit}],}],});- const document = compileHyperframesDocument(composition("materialized-visual", [track]));+ const document = compileHyperframesDocument(composition("materialized-visual", [track]), programSpace);assert.doesNotThrow(() => assertHyperframesDocument(document));assert.deepEqual(document.artifacts.map((artifact) => artifact.digest), [materialized.artifact.digest]);assert.match(document.html, /<video/u);diff --git a/packages/image-transform/README.md b/packages/image-transform/README.mdnew file mode 100644index 00000000..b406df91--- /dev/null+++ b/packages/image-transform/README.md@@ -0,0 +1,29 @@+# `@svml/image-transform`++An ordinary graph component with two inputs and one result:++```text+BlobArtifact(image) + ImageTransformProgram -> Need -> BlobArtifact(image)+```++The result is the transformed image itself. It contains no source digest, Provider name,+post-processing report or copied upstream metadata. Core's Derivation records the input edges and+the Need/Receipt records the selected execution endpoint.++`gptImageDenoiseV1` preserves the useful Twinit GPT Image cleanup exactly: YCrCb NLM with luma 2,+chroma 10, 7/21 windows and 1.02 saturation recovery, followed by PNG encoding. It is now an+explicit reusable Program rather than hidden behavior inside GPT Image generation.++The official Text Surface separates declaration from use:++```xml+<image:Program id="clean-gpt-image">+ <image:Denoise/>+ <image:Encode format="png"/>+</image:Program>++<image:Transform id="clean-shot" source={shot.image} program={clean-gpt-image}/>+```++Operation order is author meaning. Geometry, NLM denoise, color, sharpen/blur, alpha handling and+encoding are bounded closed data. OpenCV is only one Runtime realization.diff --git a/packages/image-transform/package.json b/packages/image-transform/package.jsonnew file mode 100644index 00000000..8dbdc084--- /dev/null+++ b/packages/image-transform/package.json@@ -0,0 +1,17 @@+{+ "name": "@svml/image-transform",+ "version": "0.0.0-dev",+ "private": true,+ "type": "module",+ "exports": {+ ".": "./src/index.ts"+ },+ "svml": { "activation": "./src/activation.ts" },+ "dependencies": {+ "@svml/artifact": "workspace:*",+ "@svml/component-kit": "workspace:*",+ "@svml/elaborator": "workspace:*",+ "@svml/protocol": "workspace:*",+ "@svml/text": "workspace:*"+ }+}diff --git a/packages/image-transform/src/activation.ts b/packages/image-transform/src/activation.tsnew file mode 100644index 00000000..40f251f9--- /dev/null+++ b/packages/image-transform/src/activation.ts@@ -0,0 +1,39 @@+import { createTextSurfaceHostFacet } from "@svml/text";++import {+ decodeImageTransformProgramSurface,+ decodeImageTransformSurface,+ imageTransformComponent,+ imageTransformImplementationDigests,+ imageTransformManifest,+ imageTransformModuleRef,+} from "./index.js";++export const svmlPackage = {+ format: "svml.node-package@1" as const,+ name: "@svml/image-transform",+ modules: [{+ manifest: imageTransformManifest,+ specifiers: ["@svml/image-transform", "@svml/image-transform@1"],+ }],+ components: [imageTransformComponent],+ hostFacets: [{+ ...createTextSurfaceHostFacet({+ module: imageTransformModuleRef,+ surface: "program",+ mode: "structured",+ implementationDigest: imageTransformImplementationDigests.programSurface,+ handler: decodeImageTransformProgramSurface,+ }),+ }, {+ ...createTextSurfaceHostFacet({+ module: imageTransformModuleRef,+ surface: "transform",+ mode: "structured",+ implementationDigest: imageTransformImplementationDigests.transformSurface,+ handler: decodeImageTransformSurface,+ }),+ }],+};++export default svmlPackage;diff --git a/packages/image-transform/src/component.ts b/packages/image-transform/src/component.tsnew file mode 100644index 00000000..9dafc0ce--- /dev/null+++ b/packages/image-transform/src/component.ts@@ -0,0 +1,48 @@+import type { ComponentPackage } from "@svml/component-kit";+import type { BlobRef, StoredValue } from "@svml/protocol";+import { canonicalize } from "@svml/protocol";++import {+ imageTransformImplementationDigests,+ imageTransformProducers,+ imageTransformTypes,+} from "./manifest.js";+import { verifyImageTransformProgram } from "./program.js";+import type { ImageTransformProgram, ImageTransformRequest } from "./types.js";++function inline(value: StoredValue | undefined, subject: string): ImageTransformProgram {+ if (value?.kind !== "inline") throw new Error(`${subject} must be inline`);+ return value.value as unknown as ImageTransformProgram;+}++function blob(value: StoredValue | undefined, subject: string): BlobRef {+ if (value?.kind !== "blob") throw new Error(`${subject} must be a BlobArtifact`);+ if (!value.mediaType.startsWith("image/")) throw new Error(`${subject} must be image media`);+ return value;+}++export const imageTransformComponent = {+ name: "@svml/image-transform",+ validators: [{+ type: imageTransformTypes.program,+ implementationDigest: imageTransformImplementationDigests.validator,+ handler: ({ value }) => {+ verifyImageTransformProgram(inline(value, "ImageTransformProgram"));+ },+ }],+ producers: [{+ producer: imageTransformProducers.request,+ implementationDigest: imageTransformImplementationDigests.request,+ handler: ({ inputs }) => {+ const source = blob(inputs.source?.value, "ImageTransform source");+ const program = inline(inputs.program?.value, "ImageTransformProgram");+ verifyImageTransformProgram(program);+ const request: ImageTransformRequest = {+ contract: "svml.image-transform-request@1",+ source,+ program,+ };+ return { outputs: {}, needs: { image: canonicalize(request) } };+ },+ }],+} satisfies ComponentPackage;diff --git a/packages/image-transform/src/fragment.ts b/packages/image-transform/src/fragment.tsnew file mode 100644index 00000000..4bdec194--- /dev/null+++ b/packages/image-transform/src/fragment.ts@@ -0,0 +1,28 @@+import { artifactTypes } from "@svml/artifact";+import { sealGraphFragment } from "@svml/elaborator";++import { imageTransformProducers, imageTransformTypes } from "./manifest.js";++const input = (name: string) => ({ kind: "fragment-input" as const, name });+const operation = (id: string) => ({ kind: "fragment-operation" as const, operation: id });++export const imageTransformFragment = sealGraphFragment({+ name: "@svml/image-transform/transform@1",+ inputs: [+ { name: "source", type: artifactTypes.blob },+ { name: "program", type: imageTransformTypes.program },+ ],+ operations: [{+ id: "image:transform",+ producer: imageTransformProducers.request,+ inputs: { source: input("source"), program: input("program") },+ result: { kind: "need", name: "image", accepts: "exact" },+ }],+ exports: [{+ name: "image",+ type: artifactTypes.blob,+ root: operation("image:transform"),+ semanticInputs: ["source", "program"],+ fidelity: "exact",+ }],+});diff --git a/packages/image-transform/src/index.ts b/packages/image-transform/src/index.tsnew file mode 100644index 00000000..0c703860--- /dev/null+++ b/packages/image-transform/src/index.ts@@ -0,0 +1,22 @@+export { imageTransformComponent } from "./component.js";+export { imageTransformFragment } from "./fragment.js";+export {+ imageTransformCapabilities,+ imageTransformImplementationDigests,+ imageTransformManifest,+ imageTransformManifestDigest,+ imageTransformModuleRef,+ imageTransformProducers,+ imageTransformProgramSchema,+ imageTransformTypes,+} from "./manifest.js";+export {+ gptImageDenoiseV1,+ sealImageTransformProgram,+ verifyImageTransformProgram,+} from "./program.js";+export {+ decodeImageTransformProgramSurface,+ decodeImageTransformSurface,+} from "./surface.js";+export type * from "./types.js";diff --git a/packages/image-transform/src/manifest.ts b/packages/image-transform/src/manifest.tsnew file mode 100644index 00000000..75d7caf2--- /dev/null+++ b/packages/image-transform/src/manifest.ts@@ -0,0 +1,170 @@+import { artifactDependency, artifactTypes } from "@svml/artifact";+import { digestOf } from "@svml/protocol";+import type {+ CapabilityRef,+ ModuleManifest,+ ProducerRef,+ TypeRef,+ ValueSchema,+} from "@svml/protocol";++export const imageTransformModuleRef = { name: "@svml/image-transform", version: "0.0.0-dev" } as const;+export const imageTransformTypes = {+ program: { module: imageTransformModuleRef, name: "ImageTransformProgram" },+} satisfies Record<string, TypeRef>;+export const imageTransformCapabilities = {+ transform: { module: imageTransformModuleRef, name: "transform-image" },+} satisfies Record<string, CapabilityRef>;+export const imageTransformProducers = {+ request: { module: imageTransformModuleRef, name: "request-image-transform" },+} satisfies Record<string, ProducerRef>;+export const imageTransformImplementationDigests = {+ request: digestOf("@svml/image-transform/request-image-transform@1"),+ validator: digestOf("@svml/image-transform/validate-program@1"),+ programSurface: digestOf("@svml/image-transform/program-surface@1"),+ transformSurface: digestOf("@svml/image-transform/transform-surface@1"),+} as const;++const number = (minimum?: number, maximum?: number): ValueSchema => ({+ kind: "number",+ ...(minimum === undefined ? {} : { minimum }),+ ...(maximum === undefined ? {} : { maximum }),+});+const integer = (minimum: number, maximum: number): ValueSchema => ({+ kind: "number", integer: true, minimum, maximum,+});+const stringEnum = (values: readonly string[]): ValueSchema => ({ kind: "string", enum: values });+const object = (fields: Readonly<Record<string, { readonly schema: ValueSchema; readonly optional?: boolean }>>): ValueSchema => ({+ kind: "object", fields,+});+const color: ValueSchema = { kind: "string", minLength: 7, maxLength: 9 };++const operationSchema: ValueSchema = {+ kind: "oneOf",+ variants: [+ object({+ kind: { schema: { kind: "literal", value: "crop" } },+ unit: { schema: stringEnum(["fraction", "pixel"]) },+ x: { schema: number(0) }, y: { schema: number(0) },+ width: { schema: number(Number.EPSILON) }, height: { schema: number(Number.EPSILON) },+ }),+ object({+ kind: { schema: { kind: "literal", value: "resize" } },+ width: { schema: integer(1, 16_384) }, height: { schema: integer(1, 16_384) },+ fit: { schema: stringEnum(["contain", "cover", "stretch"]) },+ interpolation: { schema: stringEnum(["nearest", "linear", "cubic", "area", "lanczos"]) },+ background: { schema: color, optional: true },+ }),+ object({+ kind: { schema: { kind: "literal", value: "rotate" } },+ degrees: { schema: { kind: "oneOf", variants: [+ { kind: "literal", value: 90 },+ { kind: "literal", value: 180 },+ { kind: "literal", value: 270 },+ ] } },+ }),+ object({+ kind: { schema: { kind: "literal", value: "flip" } },+ axis: { schema: stringEnum(["horizontal", "vertical", "both"]) },+ }),+ object({+ kind: { schema: { kind: "literal", value: "denoise" } },+ method: { schema: { kind: "literal", value: "nlm-ycrcb" } },+ lumaStrength: { schema: number(0, 50) }, chromaStrength: { schema: number(0, 50) },+ templateWindow: { schema: integer(1, 31) }, searchWindow: { schema: integer(1, 63) },+ saturationRecovery: { schema: number(0, 4) },+ }),+ object({+ kind: { schema: { kind: "literal", value: "color" } },+ exposureStops: { schema: number(-8, 8) }, contrast: { schema: number(0, 4) },+ saturation: { schema: number(0, 4) }, temperature: { schema: number(-1, 1) },+ tint: { schema: number(-1, 1) }, gamma: { schema: number(0.1, 10) },+ }),+ object({+ kind: { schema: { kind: "literal", value: "sharpen" } },+ amount: { schema: number(0, 5) }, radius: { schema: number(0.1, 20) },+ threshold: { schema: number(0, 255) },+ }),+ object({+ kind: { schema: { kind: "literal", value: "blur" } },+ sigma: { schema: number(0.1, 100) },+ }),+ object({+ kind: { schema: { kind: "literal", value: "alpha" } },+ mode: { schema: stringEnum(["preserve", "flatten"]) },+ background: { schema: color, optional: true },+ }),+ object({+ kind: { schema: { kind: "literal", value: "encode" } },+ format: { schema: stringEnum(["png", "jpeg", "webp"]) },+ quality: { schema: number(1, 100), optional: true },+ background: { schema: color, optional: true },+ }),+ ],+};++export const imageTransformProgramSchema: ValueSchema = object({+ contract: { schema: { kind: "literal", value: "svml.image-transform-program@1" } },+ operations: { schema: { kind: "array", minItems: 1, items: operationSchema } },+});++export const imageTransformManifest: ModuleManifest = {+ format: "svml.module@0",+ name: imageTransformModuleRef.name,+ version: imageTransformModuleRef.version,+ dependencies: [artifactDependency],+ types: [{+ name: imageTransformTypes.program.name,+ schema: imageTransformProgramSchema,+ validator: {+ abi: "svml.type-validator@1",+ implementation: {+ kind: "registered",+ locator: "@svml/image-transform/validate-program",+ digest: imageTransformImplementationDigests.validator,+ },+ },+ }],+ capabilities: [{ name: imageTransformCapabilities.transform.name, returns: artifactTypes.blob }],+ surfaces: [{+ name: "program",+ tag: "Program",+ mode: "structured",+ outputs: [imageTransformTypes.program],+ implementation: {+ kind: "trusted-frontend-surface",+ locator: "@svml/image-transform/program-surface",+ digest: imageTransformImplementationDigests.programSurface,+ },+ }, {+ name: "transform",+ tag: "Transform",+ mode: "structured",+ outputs: [artifactTypes.blob],+ implementation: {+ kind: "trusted-frontend-surface",+ locator: "@svml/image-transform/transform-surface",+ digest: imageTransformImplementationDigests.transformSurface,+ },+ }],+ producers: [{+ name: imageTransformProducers.request.name,+ inputs: [+ { name: "source", type: artifactTypes.blob },+ { name: "program", type: imageTransformTypes.program },+ ],+ outputs: [],+ needs: [{+ name: "image",+ capability: imageTransformCapabilities.transform,+ returns: artifactTypes.blob,+ }],+ implementation: {+ kind: "registered",+ locator: "@svml/image-transform/request-image-transform",+ digest: imageTransformImplementationDigests.request,+ },+ }],+};++export const imageTransformManifestDigest = digestOf(imageTransformManifest);diff --git a/packages/image-transform/src/program.ts b/packages/image-transform/src/program.tsnew file mode 100644index 00000000..44853195--- /dev/null+++ b/packages/image-transform/src/program.ts@@ -0,0 +1,139 @@+import { canonicalize } from "@svml/protocol";++import type {+ ImageTransformOperation,+ ImageTransformProgram,+} from "./types.js";++function assert(condition: unknown, message: string): asserts condition {+ if (!condition) throw new Error(message);+}++function finite(value: number, minimum: number, maximum: number, subject: string): void {+ assert(Number.isFinite(value) && value >= minimum && value <= maximum,+ `${subject} must be between ${minimum} and ${maximum}`);+}++function positiveInteger(value: number, maximum: number, subject: string): void {+ assert(Number.isSafeInteger(value) && value > 0 && value <= maximum,+ `${subject} must be a positive integer no greater than ${maximum}`);+}++function color(value: string | undefined, subject: string): void {+ if (value === undefined) return;+ assert(/^#[0-9a-f]{6}(?:[0-9a-f]{2})?$/iu.test(value), `${subject} must be #RRGGBB or #RRGGBBAA`);+}++function verifyOperation(operation: ImageTransformOperation, index: number): void {+ const subject = `ImageTransform operation ${index + 1}`;+ switch (operation.kind) {+ case "crop": {+ if (operation.unit === "fraction") {+ finite(operation.x, 0, 1, `${subject}.x`);+ finite(operation.y, 0, 1, `${subject}.y`);+ finite(operation.width, Number.EPSILON, 1, `${subject}.width`);+ finite(operation.height, Number.EPSILON, 1, `${subject}.height`);+ assert(operation.x + operation.width <= 1 + 1e-9 && operation.y + operation.height <= 1 + 1e-9,+ `${subject} lies outside the source image`);+ } else {+ assert(operation.unit === "pixel", `${subject}.unit is invalid`);+ assert(Number.isSafeInteger(operation.x) && operation.x >= 0+ && Number.isSafeInteger(operation.y) && operation.y >= 0,+ `${subject} pixel origin is invalid`);+ positiveInteger(operation.width, 65_535, `${subject}.width`);+ positiveInteger(operation.height, 65_535, `${subject}.height`);+ }+ return;+ }+ case "resize":+ positiveInteger(operation.width, 16_384, `${subject}.width`);+ positiveInteger(operation.height, 16_384, `${subject}.height`);+ assert(["contain", "cover", "stretch"].includes(operation.fit), `${subject}.fit is invalid`);+ assert(["nearest", "linear", "cubic", "area", "lanczos"].includes(operation.interpolation),+ `${subject}.interpolation is invalid`);+ color(operation.background, `${subject}.background`);+ return;+ case "rotate":+ assert([90, 180, 270].includes(operation.degrees), `${subject}.degrees is invalid`);+ return;+ case "flip":+ assert(["horizontal", "vertical", "both"].includes(operation.axis), `${subject}.axis is invalid`);+ return;+ case "denoise":+ assert(operation.method === "nlm-ycrcb", `${subject}.method is invalid`);+ finite(operation.lumaStrength, 0, 50, `${subject}.lumaStrength`);+ finite(operation.chromaStrength, 0, 50, `${subject}.chromaStrength`);+ positiveInteger(operation.templateWindow, 31, `${subject}.templateWindow`);+ positiveInteger(operation.searchWindow, 63, `${subject}.searchWindow`);+ assert(operation.templateWindow % 2 === 1 && operation.searchWindow % 2 === 1+ && operation.searchWindow > operation.templateWindow,+ `${subject} NLM windows must be odd and searchWindow must be larger`);+ finite(operation.saturationRecovery, 0, 4, `${subject}.saturationRecovery`);+ return;+ case "color":+ finite(operation.exposureStops, -8, 8, `${subject}.exposureStops`);+ finite(operation.contrast, 0, 4, `${subject}.contrast`);+ finite(operation.saturation, 0, 4, `${subject}.saturation`);+ finite(operation.temperature, -1, 1, `${subject}.temperature`);+ finite(operation.tint, -1, 1, `${subject}.tint`);+ finite(operation.gamma, 0.1, 10, `${subject}.gamma`);+ return;+ case "sharpen":+ finite(operation.amount, 0, 5, `${subject}.amount`);+ finite(operation.radius, 0.1, 20, `${subject}.radius`);+ finite(operation.threshold, 0, 255, `${subject}.threshold`);+ return;+ case "blur":+ finite(operation.sigma, 0.1, 100, `${subject}.sigma`);+ return;+ case "alpha":+ assert(operation.mode === "preserve" || operation.mode === "flatten", `${subject}.mode is invalid`);+ color(operation.background, `${subject}.background`);+ assert(operation.mode !== "flatten" || operation.background !== undefined,+ `${subject}.background is required when flattening alpha`);+ assert(operation.mode !== "preserve" || operation.background === undefined,+ `${subject}.background is unused when preserving alpha`);+ return;+ case "encode":+ assert(["png", "jpeg", "webp"].includes(operation.format), `${subject}.format is invalid`);+ if (operation.quality !== undefined) finite(operation.quality, 1, 100, `${subject}.quality`);+ assert(operation.format !== "png" || operation.quality === undefined,+ `${subject}.quality is not defined for PNG`);+ color(operation.background, `${subject}.background`);+ assert(operation.format === "jpeg" || operation.background === undefined,+ `${subject}.background is only defined for JPEG alpha flattening`);+ return;+ }+}++export function verifyImageTransformProgram(program: ImageTransformProgram): void {+ assert(program.contract === "svml.image-transform-program@1", "Unsupported ImageTransformProgram contract");+ assert(program.operations.length > 0, "ImageTransformProgram requires at least one operation");+ program.operations.forEach(verifyOperation);+ const encodes = program.operations.filter((operation) => operation.kind === "encode");+ assert(encodes.length <= 1, "ImageTransformProgram may encode only once");+ assert(encodes.length === 0 || program.operations.at(-1)?.kind === "encode",+ "ImageTransform encode must be the final operation");+}++export function sealImageTransformProgram(program: ImageTransformProgram): ImageTransformProgram {+ const sealed = canonicalize(program) as unknown as ImageTransformProgram;+ verifyImageTransformProgram(sealed);+ return sealed;+}++export const gptImageDenoiseV1 = sealImageTransformProgram({+ contract: "svml.image-transform-program@1",+ operations: [{+ kind: "denoise",+ method: "nlm-ycrcb",+ lumaStrength: 2,+ chromaStrength: 10,+ templateWindow: 7,+ searchWindow: 21,+ saturationRecovery: 1.02,+ }, {+ kind: "encode",+ format: "png",+ }],+});diff --git a/packages/image-transform/src/surface.ts b/packages/image-transform/src/surface.tsnew file mode 100644index 00000000..8ed0d2d0--- /dev/null+++ b/packages/image-transform/src/surface.ts@@ -0,0 +1,216 @@+import { artifactTypes } from "@svml/artifact";+import type {+ StructuredElement,+ StructuredSurfaceHandler,+ SurfaceResolvedReference,+ TextAttributeValue,+} from "@svml/text";+import type { CanonicalValue } from "@svml/protocol";++import { imageTransformFragment } from "./fragment.js";+import { imageTransformTypes } from "./manifest.js";+import { sealImageTransformProgram } from "./program.js";+import type { ImageTransformOperation } from "./types.js";++function localName(value: string): string {+ return value.includes(":") ? value.slice(value.lastIndexOf(":") + 1) : value;+}++function exact(element: StructuredElement, allowed: readonly string[], required: readonly string[] = []): void {+ const unknown = Object.keys(element.attributes).filter((name) => !allowed.includes(name));+ if (unknown.length > 0) throw new Error(`${element.name} does not accept ${unknown[0]}`);+ const missing = required.filter((name) => element.attributes[name] === undefined);+ if (missing.length > 0) throw new Error(`${element.name} requires ${missing.join(", ")}`);+}++function text(element: StructuredElement, name: string, fallback?: string): string {+ const value: TextAttributeValue | undefined = element.attributes[name];+ if (value === undefined && fallback !== undefined) return fallback;+ if (typeof value !== "string" || value.trim().length === 0) {+ throw new Error(`${element.name}.${name} must be a non-empty string`);+ }+ return value.trim();+}++function numberValue(element: StructuredElement, name: string, fallback?: number): number {+ const value = element.attributes[name];+ if (value === undefined && fallback !== undefined) return fallback;+ if (typeof value !== "string" || value.trim().length === 0) throw new Error(`${element.name}.${name} must be a number`);+ const parsed = Number(value);+ if (!Number.isFinite(parsed)) throw new Error(`${element.name}.${name} must be a finite number`);+ return parsed;+}++function optionalText(element: StructuredElement, name: string): string | undefined {+ return element.attributes[name] === undefined ? undefined : text(element, name);+}++function optionalNumber(element: StructuredElement, name: string): number | undefined {+ return element.attributes[name] === undefined ? undefined : numberValue(element, name);+}++function oneOf<T extends string>(value: string, values: readonly T[], subject: string): T {+ if (!values.includes(value as T)) throw new Error(`${subject} must be one of ${values.join(", ")}`);+ return value as T;+}++function integer(value: number, subject: string): number {+ if (!Number.isSafeInteger(value)) throw new Error(`${subject} must be an integer`);+ return value;+}++function operation(element: StructuredElement): ImageTransformOperation {+ switch (localName(element.name)) {+ case "Crop":+ exact(element, ["unit", "x", "y", "width", "height"], ["x", "y", "width", "height"]);+ return {+ kind: "crop",+ unit: oneOf(text(element, "unit", "fraction"), ["fraction", "pixel"] as const, `${element.name}.unit`),+ x: numberValue(element, "x"), y: numberValue(element, "y"),+ width: numberValue(element, "width"), height: numberValue(element, "height"),+ };+ case "Resize":+ exact(element, ["width", "height", "fit", "interpolation", "background"], ["width", "height"]);+ return {+ kind: "resize",+ width: integer(numberValue(element, "width"), `${element.name}.width`),+ height: integer(numberValue(element, "height"), `${element.name}.height`),+ fit: oneOf(text(element, "fit", "contain"), ["contain", "cover", "stretch"] as const, `${element.name}.fit`),+ interpolation: oneOf(text(element, "interpolation", "lanczos"),+ ["nearest", "linear", "cubic", "area", "lanczos"] as const, `${element.name}.interpolation`),+ ...(optionalText(element, "background") === undefined ? {} : { background: text(element, "background") }),+ };+ case "Rotate": {+ exact(element, ["degrees"], ["degrees"]);+ const degrees = numberValue(element, "degrees");+ if (degrees !== 90 && degrees !== 180 && degrees !== 270) throw new Error(`${element.name}.degrees must be 90, 180 or 270`);+ return { kind: "rotate", degrees };+ }+ case "Flip":+ exact(element, ["axis"]);+ return { kind: "flip", axis: oneOf(text(element, "axis", "horizontal"),+ ["horizontal", "vertical", "both"] as const, `${element.name}.axis`) };+ case "Denoise":+ exact(element, ["method", "luma", "chroma", "template-window", "search-window", "saturation-recovery"]);+ return {+ kind: "denoise",+ method: oneOf(text(element, "method", "nlm-ycrcb"), ["nlm-ycrcb"] as const, `${element.name}.method`),+ lumaStrength: numberValue(element, "luma", 2),+ chromaStrength: numberValue(element, "chroma", 10),+ templateWindow: integer(numberValue(element, "template-window", 7), `${element.name}.template-window`),+ searchWindow: integer(numberValue(element, "search-window", 21), `${element.name}.search-window`),+ saturationRecovery: numberValue(element, "saturation-recovery", 1.02),+ };+ case "Color":+ exact(element, ["exposure-stops", "contrast", "saturation", "temperature", "tint", "gamma"]);+ return {+ kind: "color",+ exposureStops: numberValue(element, "exposure-stops", 0),+ contrast: numberValue(element, "contrast", 1),+ saturation: numberValue(element, "saturation", 1),+ temperature: numberValue(element, "temperature", 0),+ tint: numberValue(element, "tint", 0),+ gamma: numberValue(element, "gamma", 1),+ };+ case "Sharpen":+ exact(element, ["amount", "radius", "threshold"]);+ return {+ kind: "sharpen",+ amount: numberValue(element, "amount", 0.5),+ radius: numberValue(element, "radius", 1),+ threshold: numberValue(element, "threshold", 0),+ };+ case "Blur":+ exact(element, ["sigma"], ["sigma"]);+ return { kind: "blur", sigma: numberValue(element, "sigma") };+ case "Alpha": {+ exact(element, ["mode", "background"]);+ const background = optionalText(element, "background");+ return {+ kind: "alpha",+ mode: oneOf(text(element, "mode", "preserve"), ["preserve", "flatten"] as const, `${element.name}.mode`),+ ...(background === undefined ? {} : { background }),+ };+ }+ case "Encode": {+ exact(element, ["format", "quality", "background"]);+ const quality = optionalNumber(element, "quality");+ const background = optionalText(element, "background");+ return {+ kind: "encode",+ format: oneOf(text(element, "format", "png"), ["png", "jpeg", "webp"] as const, `${element.name}.format`),+ ...(quality === undefined ? {} : { quality }),+ ...(background === undefined ? {} : { background }),+ };+ }+ default:+ throw new Error(`${element.name} is not an ImageTransform operation`);+ }+}++function sameType(left: SurfaceResolvedReference["type"], right: SurfaceResolvedReference["type"]): boolean {+ return left.module.name === right.module.name && left.module.version === right.module.version && left.name === right.name;+}++function ref(+ element: StructuredElement,+ name: string,+ expected: SurfaceResolvedReference["type"],+ resolve: (path: string) => SurfaceResolvedReference | undefined,+): SurfaceResolvedReference {+ const value = element.attributes[name];+ if (typeof value !== "object" || value.kind !== "reference") throw new Error(`${element.name}.${name} must be a reference`);+ const resolved = resolve(value.path);+ if (resolved === undefined || !sameType(resolved.type, expected)) {+ throw new Error(`${element.name}.${name} cannot resolve the required type`);+ }+ return resolved;+}++function onlyTrivia(element: StructuredElement): void {+ for (const child of element.children) {+ if (child.kind === "element" || child.value.trim().length > 0) throw new Error(`${element.name} must be empty`);+ }+}++export const decodeImageTransformProgramSurface: StructuredSurfaceHandler = ({ element }) => {+ exact(element, ["id"], ["id"]);+ const id = text(element, "id");+ const operations = element.children.flatMap((child) => {+ if (child.kind === "text") {+ if (child.value.trim().length > 0) throw new Error(`${element.name} accepts only operation elements`);+ return [];+ }+ return [operation(child)];+ });+ const program = sealImageTransformProgram({ contract: "svml.image-transform-program@1", operations });+ return {+ records: [{+ id,+ type: imageTransformTypes.program,+ value: { kind: "inline", value: program as unknown as CanonicalValue },+ range: element.range,+ }],+ components: [],+ fragments: [],+ };+};++export const decodeImageTransformSurface: StructuredSurfaceHandler = ({ element, resolveReference }) => {+ exact(element, ["id", "source", "program"], ["id", "source", "program"]);+ onlyTrivia(element);+ const id = text(element, "id");+ const source = ref(element, "source", artifactTypes.blob, resolveReference);+ const program = ref(element, "program", imageTransformTypes.program, resolveReference);+ return {+ records: [],+ components: [{+ id,+ fragment: imageTransformFragment.id,+ inputs: { source: source.ref, program: program.ref },+ outputs: { image: `${id}.image` },+ range: element.range,+ }],+ fragments: [imageTransformFragment],+ };+};diff --git a/packages/image-transform/src/types.ts b/packages/image-transform/src/types.tsnew file mode 100644index 00000000..0fe1522a--- /dev/null+++ b/packages/image-transform/src/types.ts@@ -0,0 +1,99 @@+import type { BlobRef } from "@svml/protocol";++export type ImageCropOperation = {+ readonly kind: "crop";+ readonly unit: "fraction" | "pixel";+ readonly x: number;+ readonly y: number;+ readonly width: number;+ readonly height: number;+};++export type ImageResizeOperation = {+ readonly kind: "resize";+ readonly width: number;+ readonly height: number;+ readonly fit: "contain" | "cover" | "stretch";+ readonly interpolation: "nearest" | "linear" | "cubic" | "area" | "lanczos";+ readonly background?: string;+};++export type ImageRotateOperation = {+ readonly kind: "rotate";+ readonly degrees: 90 | 180 | 270;+};++export type ImageFlipOperation = {+ readonly kind: "flip";+ readonly axis: "horizontal" | "vertical" | "both";+};++export type ImageDenoiseOperation = {+ readonly kind: "denoise";+ readonly method: "nlm-ycrcb";+ readonly lumaStrength: number;+ readonly chromaStrength: number;+ readonly templateWindow: number;+ readonly searchWindow: number;+ readonly saturationRecovery: number;+};++export type ImageColorOperation = {+ readonly kind: "color";+ readonly exposureStops: number;+ readonly contrast: number;+ readonly saturation: number;+ readonly temperature: number;+ readonly tint: number;+ readonly gamma: number;+};++export type ImageSharpenOperation = {+ readonly kind: "sharpen";+ readonly amount: number;+ readonly radius: number;+ readonly threshold: number;+};++export type ImageBlurOperation = {+ readonly kind: "blur";+ readonly sigma: number;+};++export type ImageAlphaOperation = {+ readonly kind: "alpha";+ readonly mode: "preserve" | "flatten";+ readonly background?: string;+};++export type ImageEncodeOperation = {+ readonly kind: "encode";+ readonly format: "png" | "jpeg" | "webp";+ readonly quality?: number;+ readonly background?: string;+};++export type ImageTransformOperation =+ | ImageCropOperation+ | ImageResizeOperation+ | ImageRotateOperation+ | ImageFlipOperation+ | ImageDenoiseOperation+ | ImageColorOperation+ | ImageSharpenOperation+ | ImageBlurOperation+ | ImageAlphaOperation+ | ImageEncodeOperation;++/** Authored transformation intent. Operation order is author meaning. */+export type ImageTransformProgram = {+ readonly contract: "svml.image-transform-program@1";+ readonly operations: readonly ImageTransformOperation[];+};++/** Execution request. The accepted output is the BlobArtifact itself, not an envelope. */+export type ImageTransformRequest = {+ readonly contract: "svml.image-transform-request@1";+ readonly source: BlobRef;+ readonly program: ImageTransformProgram;+};diff --git a/packages/image-transform/test/image-transform.test.ts b/packages/image-transform/test/image-transform.test.tsnew file mode 100644index 00000000..3d7a0d55--- /dev/null+++ b/packages/image-transform/test/image-transform.test.ts@@ -0,0 +1,102 @@+import assert from "node:assert/strict";+import test from "node:test";++import {+ decodeImageTransformProgramSurface,+ gptImageDenoiseV1,+ imageTransformComponent,+ imageTransformFragment,+ imageTransformManifest,+ imageTransformTypes,+ sealImageTransformProgram,+} from "@svml/image-transform";+import { artifactTypes } from "@svml/artifact";+import { digestOf } from "@svml/protocol";+import type { CanonicalValue, TypedRecord } from "@svml/protocol";++test("the Twinit GPT Image cleanup is one explicit reusable Program", () => {+ assert.deepEqual(gptImageDenoiseV1.operations, [{+ kind: "denoise",+ method: "nlm-ycrcb",+ lumaStrength: 2,+ chromaStrength: 10,+ templateWindow: 7,+ searchWindow: 21,+ saturationRecovery: 1.02,+ }, { kind: "encode", format: "png" }]);+ assert.throws(() => sealImageTransformProgram({+ contract: "svml.image-transform-program@1",+ operations: [{ kind: "encode", format: "png" }, { kind: "blur", sigma: 1 }],+ }), /encode must be the final/u);+});++test("the official Surface separates Program declaration from Transform use", async () => {+ const output = await decodeImageTransformProgramSurface({+ sourceName: "image.svml",+ element: {+ kind: "element",+ name: "image:Program",+ attributes: { id: "clean-gpt-image" },+ range: { start: 0, end: 100 },+ children: [{+ kind: "element",+ name: "image:Denoise",+ attributes: {},+ children: [],+ range: { start: 10, end: 30 },+ }, {+ kind: "element",+ name: "image:Encode",+ attributes: { format: "png" },+ children: [],+ range: { start: 31, end: 50 },+ }],+ },+ resolveReference: () => undefined,+ resolveAsset: async () => { throw new Error("no asset expected"); },+ });+ assert.equal(output.records.length, 1);+ assert.deepEqual(output.records[0]?.type, imageTransformTypes.program);+ assert.deepEqual(output.records[0]?.value, {+ kind: "inline",+ value: gptImageDenoiseV1 as unknown as CanonicalValue,+ });+});++test("the graph contract is exactly source plus Program to one image Need", async () => {+ assert.deepEqual(imageTransformFragment.inputs.map((input) => input.name).sort(), ["program", "source"]);+ assert.deepEqual(imageTransformFragment.exports.map((output) => output.name), ["image"]);+ assert.equal(imageTransformManifest.capabilities.length, 1);+ const producer = imageTransformComponent.producers[0]!;+ const source = {+ kind: "blob" as const,+ digest: digestOf("image-source"),+ size: 123,+ mediaType: "image/png",+ };+ const record = (id: string, type: TypedRecord["type"], value: TypedRecord["value"]): TypedRecord => ({+ id,+ type,+ value,+ digest: digestOf({ id, value }),+ conformance: "exact",+ origin: {+ kind: "authored",+ sourceDigest: digestOf("source"),+ frontendClosureDigest: digestOf("frontend"),+ },+ });+ const result = await producer.handler({+ inputs: {+ source: record("source", artifactTypes.blob, source),+ program: record("program", imageTransformTypes.program,+ { kind: "inline", value: gptImageDenoiseV1 as unknown as CanonicalValue }),+ },+ } as never);+ assert.deepEqual(result.outputs, {});+ assert.deepEqual(result.needs.image, {+ contract: "svml.image-transform-request@1",+ source,+ program: gptImageDenoiseV1,+ });+});diff --git a/packages/local/README.md b/packages/local/README.mdindex 5e29145a..019ce7b4 100644--- a/packages/local/README.md+++ b/packages/local/README.md@@ -22,6 +22,7 @@ Normal CLI projects may express the same assembly as closed data:```json{"format": "svml.runtime-config@1",+ "runtimePackageLock": "./svml.runtime-packages.lock","services": [],"endpoints": [{@@ -39,10 +40,19 @@ Normal CLI projects may express the same assembly as closed data:}```-`RuntimeConfigRegistry` maps each exact `use` name to a trusted package factory. The data file can-choose instances, non-secret configuration, permissions and concurrency, but it cannot embed code-or secrets. Unknown adapters fail rather than being guessed. `createProjectLocalRuntime(...)`-remains the advanced TypeScript embedding API.+`runtimePackageLock` selects the physical packages allowed to contribute privileged Runtime Adapter+facets. The generic local Host verifies their complete package closure before activation; the video+CLI imports no Provider or Store implementation. Each exact `use` selects one adapter from that+verified inventory. The data file can choose instances, non-secret configuration, permissions and+concurrency, but it cannot embed code or secrets. Unknown adapters fail rather than being guessed.+`createProjectLocalRuntime(...)` remains the advanced trusted TypeScript embedding API.++`packageLock` and `runtimePackageLock` are deliberately different. The former closes deterministic+Producer/Validator code used by the author graph. The latter closes deployment code that may read+credentials, spawn processes or call networks. Source imports can affect neither. Loaded Endpoint+and Store implementation identities are rebound to actual physical package bytes and that package's+transitive dependency closure, rather than trusting a package's development label or unrelated+selected adapters.Deterministic packages implement the host-neutral `@svml/component-kit` contract. `@svml/local`adapts them to `ProducerRegistry`; the component never imports the Node Driver or receives Runtime@@ -81,6 +91,13 @@ change to `@svml/local`. Advanced hosts may still call `createLocalRuntime` withRecord and content identities, not private filesystem layout, so filesystem and S3 stores remaininterchangeable. Egress never determines whether a Build result is retained.+The filesystem ArtifactStore additionally implements optional streaming transfer and explicit+retention capabilities. `svml-v2 gc <runtime-profile.json>` is read-only by default; `--apply`+deletes only objects unreachable from every retained BuildState and Operation. This is Host+maintenance, never a Core transition or automatic cache policy. `svml-v2 doctor+<runtime-profile.json>` verifies package bytes, closed adapter configuration, required environment+credentials and local executable availability without running a Build.+`LocalRuntime.builds()` reads a separate Host `BuildCatalog`. With the default local assembly thecatalog shares the SQLite file physically; deployments with replacement execution Stores defaultto `.svml/catalog.sqlite` or may select `catalogPath`/inject a `BuildCatalog`. This index is kept outdiff --git a/packages/local/package.json b/packages/local/package.jsonindex 383a3c13..86037988 100644--- a/packages/local/package.json+++ b/packages/local/package.json@@ -16,6 +16,7 @@"@svml/protocol": "workspace:*","@svml/endpoint-kit": "workspace:*","@svml/runtime": "workspace:*",+ "@svml/runtime-adapter": "workspace:*","@svml/store-sqlite": "workspace:*","@svml/validation": "workspace:*"},diff --git a/packages/local/src/config.ts b/packages/local/src/config.tsindex 6a83cd97..d40e6ce3 100644--- a/packages/local/src/config.ts+++ b/packages/local/src/config.ts@@ -1,11 +1,15 @@-import { readFile } from "node:fs/promises";+import { readFile, stat } from "node:fs/promises";import { dirname, resolve } from "node:path";import type { ComponentPackage } from "@svml/component-kit";-import type { EndpointPackage } from "@svml/endpoint-kit";+import { loadNodePackageSet } from "@svml/package-loader-node";import { canonicalize } from "@svml/protocol";import type { CanonicalValue } from "@svml/protocol";-import type { RuntimeServicePackage } from "@svml/runtime";+import {+ isRuntimeAdapterHostFacet,+ RuntimeAdapterRegistry,+} from "@svml/runtime-adapter";+import type { RuntimeDoctorDiagnostic } from "@svml/runtime-adapter";import { createProjectLocalRuntime } from "./runtime.js";import type { LocalRuntime } from "./types.js";@@ -25,6 +29,8 @@ export type RuntimeConfigDocument = {readonly catalogPath?: string;readonly artifactPath?: string;readonly packageLock?: string;+ /** Locked physical packages allowed to configure privileged Runtime adapters. */+ readonly runtimePackageLock?: string;readonly services: readonly RuntimeConfigEntry[];readonly endpoints: readonly RuntimeConfigEntry[];readonly selection?: {@@ -44,46 +50,6 @@ export type RuntimeConfigDocument = {};};-export type RuntimeConfigFactoryContext = {- readonly root: string;- readonly instance: string;- readonly lane?: string;- readonly config: CanonicalValue;-};--export type RuntimeEndpointFactory = (- context: RuntimeConfigFactoryContext,-) => Promise<EndpointPackage> | EndpointPackage;--export type RuntimeServiceFactory = (- context: RuntimeConfigFactoryContext,-) => Promise<RuntimeServicePackage> | RuntimeServicePackage;--export class RuntimeConfigRegistry {- readonly #endpoints = new Map<string, RuntimeEndpointFactory>();- readonly #services = new Map<string, RuntimeServiceFactory>();-- registerEndpoint(use: string, factory: RuntimeEndpointFactory): void {- if (use.trim().length === 0) throw new Error("Runtime Endpoint adapter name must not be empty");- if (this.#endpoints.has(use) || this.#services.has(use)) throw new Error(`Runtime adapter ${use} is already registered`);- this.#endpoints.set(use, factory);- }-- registerService(use: string, factory: RuntimeServiceFactory): void {- if (use.trim().length === 0) throw new Error("Runtime service adapter name must not be empty");- if (this.#endpoints.has(use) || this.#services.has(use)) throw new Error(`Runtime adapter ${use} is already registered`);- this.#services.set(use, factory);- }-- endpoint(use: string): RuntimeEndpointFactory | undefined {- return this.#endpoints.get(use);- }-- service(use: string): RuntimeServiceFactory | undefined {- return this.#services.get(use);- }-}-function object(value: unknown, subject: string): Record<string, unknown> {if (value === null || typeof value !== "object" || Array.isArray(value)) throw new Error(`${subject} must be an object`);return value as Record<string, unknown>;@@ -173,7 +139,8 @@ function scheduling(value: unknown): RuntimeConfigDocument["scheduling"] {export function parseRuntimeConfig(value: unknown): RuntimeConfigDocument {const item = object(value, "$runtime");exactKeys(item, [- "format", "root", "statePath", "catalogPath", "artifactPath", "packageLock", "services", "endpoints",+ "format", "root", "statePath", "catalogPath", "artifactPath", "packageLock", "runtimePackageLock",+ "services", "endpoints","selection", "permissions", "scheduling",], "$runtime");if (item.format !== "svml.runtime-config@1") throw new Error("$runtime.format must be svml.runtime-config@1");@@ -196,6 +163,9 @@ export function parseRuntimeConfig(value: unknown): RuntimeConfigDocument {...(optionalString(item.catalogPath, "$runtime.catalogPath") === undefined ? {} : { catalogPath: item.catalogPath as string }),...(optionalString(item.artifactPath, "$runtime.artifactPath") === undefined ? {} : { artifactPath: item.artifactPath as string }),...(optionalString(item.packageLock, "$runtime.packageLock") === undefined ? {} : { packageLock: item.packageLock as string }),+ ...(optionalString(item.runtimePackageLock, "$runtime.runtimePackageLock") === undefined+ ? {}+ : { runtimePackageLock: item.runtimePackageLock as string }),services,endpoints,...(selected === undefined ? {} : { selection: selected }),@@ -205,30 +175,133 @@ export function parseRuntimeConfig(value: unknown): RuntimeConfigDocument {}export type LoadRuntimeConfigOptions = {- readonly registry: RuntimeConfigRegistry;+ /** Trusted embedding adapters. Locked installed adapters are normally selected by runtimePackageLock. */+ readonly registry?: RuntimeAdapterRegistry;readonly components?: readonly ComponentPackage[];};+export type RuntimeConfigDoctorResult = {+ readonly root: string;+ readonly diagnostics: readonly RuntimeDoctorDiagnostic[];+};++async function installLockedRuntimeAdapters(+ registry: RuntimeAdapterRegistry,+ path: string | undefined,+ root: string,+): Promise<void> {+ if (path === undefined) return;+ const loaded = await loadNodePackageSet(resolve(root, path), root);+ const lockedPackages = new Map(loaded.lock.packages.map((item) => [item.package.name, item]));+ const artifacts = new Map(loaded.lock.artifacts.map((item) => [`${item.name}@${item.version}`, item]));+ for (const contribution of loaded.contributions) {+ const locked = lockedPackages.get(contribution.name);+ if (locked === undefined) throw new Error(`Runtime package ${contribution.name} is absent from its verified lock`);+ const artifact = artifacts.get(`${locked.package.name}@${locked.package.version}`);+ if (artifact === undefined) throw new Error(`Runtime package ${contribution.name} has no verified physical Artifact`);+ for (const facet of contribution.hostFacets ?? []) {+ if (!isRuntimeAdapterHostFacet(facet)) continue;+ registry.registerFacet(facet, {+ packageName: contribution.name,+ packageArtifactDigest: artifact.digest,+ packageClosureDigest: locked.closureDigest,+ });+ }+ }+}++function diagnostic(error: unknown, code: string, subject?: string): RuntimeDoctorDiagnostic {+ return {+ severity: "error",+ code,+ message: error instanceof Error ? error.message : String(error),+ ...(subject === undefined ? {} : { subject }),+ };+}++/** Read-only validation of package bytes, adapter config, credentials and local executable prerequisites. */+export async function doctorRuntimeConfig(+ path: string,+ options: LoadRuntimeConfigOptions = {},+): Promise<RuntimeConfigDoctorResult> {+ const absolute = resolve(path);+ const document = parseRuntimeConfig(JSON.parse(await readFile(absolute, "utf8")));+ const root = resolve(dirname(absolute), document.root ?? ".");+ const diagnostics: RuntimeDoctorDiagnostic[] = [];+ try {+ if (!(await stat(root)).isDirectory()) throw new Error(`Runtime root ${root} is not a directory`);+ } catch (error) {+ diagnostics.push(diagnostic(error, "RUNTIME_ROOT_INVALID", root));+ return { root, diagnostics };+ }+ const registry = options.registry ?? new RuntimeAdapterRegistry();+ try {+ await installLockedRuntimeAdapters(registry, document.runtimePackageLock, root);+ } catch (error) {+ diagnostics.push(diagnostic(error, "RUNTIME_PACKAGE_LOCK_INVALID", document.runtimePackageLock));+ return { root, diagnostics };+ }+ if (document.packageLock !== undefined) {+ try {+ await loadNodePackageSet(resolve(root, document.packageLock), root);+ } catch (error) {+ diagnostics.push(diagnostic(error, "IMPLEMENTATION_PACKAGE_LOCK_INVALID", document.packageLock));+ }+ }+ for (const item of document.services) {+ const context = { root, instance: item.instance, config: item.config ?? {} };+ try {+ diagnostics.push(...await registry.doctor(item.use, "service", context));+ } catch (error) {+ diagnostics.push(diagnostic(error, "RUNTIME_ADAPTER_DOCTOR_FAILED", item.instance));+ }+ if (!registry.has(item.use, "service")) continue;+ try {+ await registry.createService(item.use, context);+ } catch (error) {+ diagnostics.push(diagnostic(error, "RUNTIME_SERVICE_CONFIG_INVALID", item.instance));+ }+ }+ for (const item of document.endpoints) {+ const context = {+ root,+ instance: item.instance,+ ...(item.lane === undefined ? {} : { lane: item.lane }),+ config: item.config ?? {},+ };+ try {+ diagnostics.push(...await registry.doctor(item.use, "endpoint", context));+ } catch (error) {+ diagnostics.push(diagnostic(error, "RUNTIME_ADAPTER_DOCTOR_FAILED", item.instance));+ }+ if (!registry.has(item.use, "endpoint")) continue;+ try {+ await registry.createEndpoint(item.use, context);+ } catch (error) {+ diagnostics.push(diagnostic(error, "RUNTIME_ENDPOINT_CONFIG_INVALID", item.instance));+ }+ }+ return { root, diagnostics };+}+export async function createRuntimeFromConfig(path: string,- options: LoadRuntimeConfigOptions,+ options: LoadRuntimeConfigOptions = {},): Promise<LocalRuntime> {const absolute = resolve(path);const document = parseRuntimeConfig(JSON.parse(await readFile(absolute, "utf8")));const root = resolve(dirname(absolute), document.root ?? ".");+ const registry = options.registry ?? new RuntimeAdapterRegistry();+ await installLockedRuntimeAdapters(registry, document.runtimePackageLock, root);const services = await Promise.all(document.services.map(async (item) => {- const factory = options.registry.service(item.use);- if (factory === undefined) throw new Error(`Runtime service adapter ${item.use} is not registered`);- return await factory({+ return await registry.createService(item.use, {root,instance: item.instance,config: item.config ?? {},});}));const endpoints = await Promise.all(document.endpoints.map(async (item) => {- const factory = options.registry.endpoint(item.use);- if (factory === undefined) throw new Error(`Runtime Endpoint adapter ${item.use} is not registered`);- return await factory({+ return await registry.createEndpoint(item.use, {root,instance: item.instance,...(item.lane === undefined ? {} : { lane: item.lane }),diff --git a/packages/local/src/index.ts b/packages/local/src/index.tsindex 8bfd3846..81635eb0 100644--- a/packages/local/src/index.ts+++ b/packages/local/src/index.ts@@ -9,8 +9,12 @@ export {} from "./runtime.js";export {createRuntimeFromConfig,+ doctorRuntimeConfig,parseRuntimeConfig,- RuntimeConfigRegistry,} from "./config.js";+export {+ RuntimeAdapterRegistry,+ RuntimeAdapterRegistry as RuntimeConfigRegistry,+} from "@svml/runtime-adapter";export type * from "./types.js";export type * from "./config.js";diff --git a/packages/local/src/runtime.ts b/packages/local/src/runtime.tsindex 839cf095..94a3c246 100644--- a/packages/local/src/runtime.ts+++ b/packages/local/src/runtime.ts@@ -13,10 +13,14 @@ import {loadNodePackageSet,collectNodePackageComponents,} from "@svml/package-loader-node";+import { isDigest } from "@svml/protocol";import {LocalBuildScheduler,MemoryBuildCatalog,RuntimeModuleRegistry,+ isEnumerableBuildStore,+ isManagedArtifactStore,+ isStreamingArtifactStore,localSchedulerOptionsFromClosure,resolveRuntimeProfile,sealRuntimeProfile,@@ -59,6 +63,25 @@ function nonNegativeInteger(value: number, subject: string): number {return value;}+function collectArtifactDigests(+ value: unknown,+ digests: Set<import("@svml/protocol").Digest>,+ seen = new WeakSet<object>(),+): void {+ if (value === null || typeof value !== "object") return;+ if (seen.has(value)) return;+ seen.add(value);+ if (!Array.isArray(value)) {+ const item = value as Record<string, unknown>;+ if (item.kind === "blob" && typeof item.digest === "string" && isDigest(item.digest)) {+ digests.add(item.digest);+ }+ }+ for (const nested of Array.isArray(value) ? value : Object.values(value)) {+ collectArtifactDigests(nested, digests, seen);+ }+}+async function wait(delayMs: number, signal: AbortSignal | undefined): Promise<void> {if (signal?.aborted === true) throw signal.reason ?? new Error("Local Runtime follow was aborted");await new Promise<void>((resolveWait, reject) => {@@ -247,6 +270,35 @@ export async function createLocalRuntime(async readArtifact(digest) {return await options.artifactStore.get(digest);},+ async openArtifact(digest) {+ if (isStreamingArtifactStore(options.artifactStore)) return await options.artifactStore.open(digest);+ const bytes = await options.artifactStore.get(digest);+ return bytes === undefined ? undefined : (async function* () { yield bytes; })();+ },+ async garbageCollectArtifacts(gc = {}) {+ assert(isManagedArtifactStore(options.artifactStore),+ "selected ArtifactStore does not expose explicit retention management");+ assert(isEnumerableBuildStore(options.buildStore),+ "selected BuildStore does not expose the maintenance index required for Artifact GC");+ const reachable = new Set<import("@svml/protocol").Digest>();+ for (const snapshot of await options.buildStore.list()) collectArtifactDigests(snapshot.state, reachable);+ if (options.operationStore !== undefined) {+ for (const operation of await options.operationStore.list({})) collectArtifactDigests(operation, reachable);+ }+ const stored = await options.artifactStore.list();+ const unreachable = stored.filter((digest) => !reachable.has(digest)).sort();+ const deleted: import("@svml/protocol").Digest[] = [];+ if (gc.apply === true) {+ for (const digest of unreachable) {+ if (await options.artifactStore.delete(digest)) deleted.push(digest);+ }+ }+ return {+ reachable: [...reachable].sort(),+ unreachable,+ deleted,+ };+ },close() {},};}@@ -330,6 +382,8 @@ export async function createProjectLocalRuntime(builds: runtime.builds,cancel: runtime.cancel,readArtifact: runtime.readArtifact,+ openArtifact: runtime.openArtifact,+ garbageCollectArtifacts: runtime.garbageCollectArtifacts,close() {return projectServices.close();},diff --git a/packages/local/src/types.ts b/packages/local/src/types.tsindex c8ab3a67..d916c3bf 100644--- a/packages/local/src/types.ts+++ b/packages/local/src/types.ts@@ -110,6 +110,12 @@ export type LocalRuntimeStatus = {readonly operations: readonly OperationSnapshot[];};+export type ArtifactGarbageCollection = {+ readonly reachable: readonly Digest[];+ readonly unreachable: readonly Digest[];+ readonly deleted: readonly Digest[];+};+export type LocalRuntime = {build(request: LocalBuildRequest, options?: LocalBuildOptions): Promise<ScheduledBuildResult>;buildMany(requests: readonly LocalBuildRequest[]): Promise<readonly ScheduledBuildResult[]>;@@ -117,5 +123,8 @@ export type LocalRuntime = {builds(): Promise<readonly BuildCatalogEntry[]>;cancel(build: string): Promise<ScheduledBuildResult | undefined>;readArtifact(digest: Digest): Promise<Uint8Array | undefined>;+ openArtifact(digest: Digest): Promise<AsyncIterable<Uint8Array> | undefined>;+ /** Explicit maintenance only. apply=false is a read-only reachability report. */+ garbageCollectArtifacts(options?: { readonly apply?: boolean }): Promise<ArtifactGarbageCollection>;close(): Awaitable<void>;};diff --git a/packages/local/test/local.test.ts b/packages/local/test/local.test.tsindex cbcc7594..e8e6f5d8 100644--- a/packages/local/test/local.test.ts+++ b/packages/local/test/local.test.ts@@ -10,19 +10,20 @@ import { tmpdir } from "node:os";import { join } from "node:path";import test from "node:test";+import { FileArtifactStore } from "@svml/artifact-store-fs";import { MemoryArtifactStore } from "@svml/driver-node";import type { RecoverableEndpoint } from "@svml/endpoint-kit";import type {NodeComponentPackage,EndpointPackage,} from "@svml/local";-import { createProjectLocalRuntime } from "@svml/local";+import { createLocalRuntime, createProjectLocalRuntime } from "@svml/local";import { digestOf } from "@svml/core";import {createNodePackageLock,writeNodePackageLock,} from "@svml/package-loader-node";-import { LocalBuildScheduler, defineRuntimeServicePackage } from "@svml/runtime";+import { LocalBuildScheduler, MemoryBuildStore, defineRuntimeServicePackage } from "@svml/runtime";import type { RuntimeModuleManifest } from "@svml/runtime";import {@@ -52,6 +53,27 @@ const providerManifest: RuntimeModuleManifest = {}],};+test("Artifact GC is explicit, dry-run by default, and only removes unreachable managed bytes", async () => {+ const directory = await mkdtemp(join(tmpdir(), "svml-local-artifact-gc-"));+ try {+ const artifacts = new FileArtifactStore(join(directory, "artifacts"));+ const orphan = await artifacts.put(new TextEncoder().encode("orphan"), "application/octet-stream");+ const runtime = await createLocalRuntime({+ buildStore: new MemoryBuildStore(),+ artifactStore: artifacts,+ });+ const preview = await runtime.garbageCollectArtifacts();+ assert.deepEqual(preview.unreachable, [orphan.digest]);+ assert.deepEqual(preview.deleted, []);+ assert.equal(await artifacts.has(orphan.digest), true);+ const applied = await runtime.garbageCollectArtifacts({ apply: true });+ assert.deepEqual(applied.deleted, [orphan.digest]);+ assert.equal(await artifacts.has(orphan.digest), false);+ } finally {+ await rm(directory, { recursive: true, force: true });+ }+});+test("project local runtime resumes durable work while component and endpoint packages stay replaceable", async () => {const directory = await mkdtemp(join(tmpdir(), "svml-local-"));const initial = createGreetingBuild();diff --git a/packages/media-pipeline/src/audio-plan.ts b/packages/media-pipeline/src/audio-plan.tsindex d3e0af6b..9a348510 100644--- a/packages/media-pipeline/src/audio-plan.ts+++ b/packages/media-pipeline/src/audio-plan.ts@@ -2,8 +2,8 @@ import {assertCompositionIdentity,programSpaceFrameCount,} from "@svml/contracts";-import type { Composition } from "@svml/contracts";-import { canonicalize, digestOf, isDigest } from "@svml/protocol";+import type { Composition, ProgramSpace } from "@svml/contracts";+import { canonicalize, isDigest } from "@svml/protocol";import type { AudioProgramPlan } from "./types.js";@@ -26,16 +26,14 @@ function samplesFromSeconds(seconds: number, subject: string): number {return result;}-export function sealAudioProgramPlan(value: Omit<AudioProgramPlan, "planDigest">): AudioProgramPlan {- const normalized = canonicalize(value) as unknown as Omit<AudioProgramPlan, "planDigest">;- return { ...normalized, planDigest: digestOf(normalized) };+export function sealAudioProgramPlan(value: AudioProgramPlan): AudioProgramPlan {+ return canonicalize(value) as unknown as AudioProgramPlan;}export function verifyAudioProgramPlan(value: unknown): asserts value is AudioProgramPlan {assert(value !== null && typeof value === "object" && !Array.isArray(value), "AudioProgramPlan must be an object");const item = value as AudioProgramPlan;assert(item.contract === "svml.audio-program-plan@1", "AudioProgramPlan contract is invalid");- assert(isDigest(item.programSpaceDigest), "AudioProgramPlan ProgramSpace digest is invalid");assert(Number.isSafeInteger(item.frameRate?.numerator) && item.frameRate.numerator > 0&& Number.isSafeInteger(item.frameRate?.denominator) && item.frameRate.denominator > 0,"AudioProgramPlan frame rate is invalid");@@ -73,15 +71,12 @@ export function verifyAudioProgramPlan(value: unknown): asserts value is AudioPr}assert(item.mix?.normalize === false && item.mix?.limiter === "none","AudioProgramPlan cannot hide normalization or limiting");- assert(isDigest(item.planDigest), "AudioProgramPlan digest is invalid");- const { planDigest: _digest, ...content } = item;- assert(item.planDigest === digestOf(canonicalize(content)), "AudioProgramPlan digest differs from its contents");}-export function compileAudioProgramPlan(composition: Composition): AudioProgramPlan {- assertCompositionIdentity(composition);- const frameCount = programSpaceFrameCount(composition.programSpace);- const { numerator, denominator } = composition.programSpace.frameRate;+export function compileAudioProgramPlan(composition: Composition, programSpace: ProgramSpace): AudioProgramPlan {+ assertCompositionIdentity(composition, programSpace);+ const frameCount = programSpaceFrameCount(programSpace);+ const { numerator, denominator } = programSpace.frameRate;const clips = composition.tracks.filter((track) => track.contract === "svml.audio-track@1").flatMap((track) => track.clips.map((clip) => {@@ -110,8 +105,7 @@ export function compileAudioProgramPlan(composition: Composition): AudioProgramP}));return sealAudioProgramPlan({contract: "svml.audio-program-plan@1",- programSpaceDigest: composition.programSpace.digest,- frameRate: { ...composition.programSpace.frameRate },+ frameRate: { ...programSpace.frameRate },frameCount,sampleRate: 48_000,sampleFrames: sampleBoundary(frameCount, numerator, denominator),diff --git a/packages/media-pipeline/src/component.ts b/packages/media-pipeline/src/component.tsindex 4e695bf5..ad370323 100644--- a/packages/media-pipeline/src/component.ts+++ b/packages/media-pipeline/src/component.ts@@ -13,6 +13,7 @@ import {import type {Composition,MuxedMedia,+ ProgramSpace,RenderedVisual,SpeechAudioBasis,TimelineAudio,@@ -107,9 +108,6 @@ export const mediaPipelineComponent = {verifyMediaInspection(inspection);verifyMediaStreamSelection(selection);verifyMediaSelectionRequest(request);- if (inspection.source.digest !== source.digest) {- throw new Error("Media normalization inspection belongs to another source artifact");- }const need: NormalizeMediaNeed = {contract: "svml.normalize-media-request@1",source,@@ -135,7 +133,6 @@ export const mediaPipelineComponent = {}const need: ProjectSpeechEvidenceAudioNeed = {contract: "svml.project-speech-evidence-audio-request@1",- programSpaceDigest: audio.programSpace.digest,source: {kind: "blob",digest: audio.audio.digest,@@ -161,8 +158,9 @@ export const mediaPipelineComponent = {implementationDigest: mediaPipelineImplementationDigests.planAudio,handler: ({ inputs }) => {const composition = inline(inputs.composition!.value, "Composition") as unknown as Composition;+ const space = inline(inputs.space!.value, "ProgramSpace") as unknown as ProgramSpace;return {- outputs: { plan: { kind: "inline", value: canonicalize(compileAudioProgramPlan(composition)) } },+ outputs: { plan: { kind: "inline", value: canonicalize(compileAudioProgramPlan(composition, space)) } },needs: {},};},@@ -185,8 +183,9 @@ export const mediaPipelineComponent = {const audio = inline(inputs.audio!.value, "TimelineAudio");verifyRenderedVisual(visual);verifyTimelineAudio(audio);- if (visual.programSpaceDigest !== audio.programSpaceDigest) {- throw new Error("Rendered visual and TimelineAudio belong to different ProgramSpaces");+ if (visual.frameCount * visual.frameRate.denominator * 48_000+ !== audio.sampleFrames * visual.frameRate.numerator) {+ throw new Error("Rendered visual and TimelineAudio have different presentation durations");}const need: MuxMediaNeed = { contract: "svml.mux-media-request@1", visual, audio };return { outputs: {}, needs: { media: canonicalize(need) } };diff --git a/packages/media-pipeline/src/manifest.ts b/packages/media-pipeline/src/manifest.tsindex 6723c5fb..ac3e141e 100644--- a/packages/media-pipeline/src/manifest.ts+++ b/packages/media-pipeline/src/manifest.ts@@ -73,7 +73,6 @@ export const mediaSelectionRequestSchema: ValueSchema = {denominator: { schema: { kind: "number", integer: true, minimum: 1 } },},} },- requestDigest: { schema: { kind: "string", minLength: 71, maxLength: 71 } },},};@@ -91,7 +90,6 @@ export const audioProgramPlanSchema: ValueSchema = {kind: "object",fields: {contract: { schema: { kind: "literal", value: "svml.audio-program-plan@1" } },- programSpaceDigest: { schema: { kind: "string", minLength: 71, maxLength: 71 } },frameRate: { schema: {kind: "object",fields: {@@ -124,7 +122,6 @@ export const audioProgramPlanSchema: ValueSchema = {limiter: { schema: { kind: "literal", value: "none" } },},} },- planDigest: { schema: { kind: "string", minLength: 71, maxLength: 71 } },},};@@ -136,6 +133,7 @@ export const mediaPipelineManifest: ModuleManifest = {artifactDependency,videoContractDependencies.media,videoContractDependencies.speech,+ videoContractDependencies.programSpace,videoContractDependencies.composition,],types: [@@ -181,7 +179,6 @@ export const mediaPipelineManifest: ModuleManifest = {name: "inspection",capability: mediaPipelineCapabilities.inspect,returns: contractTypes.mediaInspection,- affinity: [{ resultPointer: "/source/digest", input: "source", inputPointer: "/digest" }],}],implementation: {kind: "registered",@@ -234,10 +231,6 @@ export const mediaPipelineManifest: ModuleManifest = {name: "evidenceAudio",capability: mediaPipelineCapabilities.projectSpeechEvidenceAudio,returns: contractTypes.speechEvidenceAudio,- affinity: [- { resultPointer: "/programSpaceDigest", input: "audio", inputPointer: "/programSpace/digest" },- { resultPointer: "/sourceAudioArtifactDigest", input: "audio", inputPointer: "/audio/digest" },- ],}],implementation: {kind: "registered",@@ -247,12 +240,11 @@ export const mediaPipelineManifest: ModuleManifest = {},{name: mediaPipelineProducers.planAudio.name,- inputs: [{ name: "composition", type: contractTypes.composition }],- outputs: [{- name: "plan",- type: mediaPipelineTypes.audioProgramPlan,- affinity: [{ resultPointer: "/programSpaceDigest", input: "composition", inputPointer: "/programSpace/digest" }],- }],+ inputs: [+ { name: "composition", type: contractTypes.composition },+ { name: "space", type: contractTypes.programSpace },+ ],+ outputs: [{ name: "plan", type: mediaPipelineTypes.audioProgramPlan }],needs: [],implementation: {kind: "registered",@@ -268,11 +260,6 @@ export const mediaPipelineManifest: ModuleManifest = {name: "audio",capability: mediaPipelineCapabilities.renderAudio,returns: contractTypes.timelineAudio,- affinity: [- { resultPointer: "/planDigest", input: "plan", inputPointer: "/planDigest" },- { resultPointer: "/programSpaceDigest", input: "plan", inputPointer: "/programSpaceDigest" },- { resultPointer: "/sampleFrames", input: "plan", inputPointer: "/sampleFrames" },- ],}],implementation: {kind: "registered",@@ -291,17 +278,6 @@ export const mediaPipelineManifest: ModuleManifest = {name: "media",capability: mediaPipelineCapabilities.mux,returns: contractTypes.muxedMedia,- affinity: [- { resultPointer: "/visualDigest", input: "visual", inputPointer: "/visualDigest" },- { resultPointer: "/audioDigest", input: "audio", inputPointer: "/audioDigest" },- { resultPointer: "/programSpaceDigest", input: "visual", inputPointer: "/programSpaceDigest" },- { resultPointer: "/frameRate/numerator", input: "visual", inputPointer: "/frameRate/numerator" },- { resultPointer: "/frameRate/denominator", input: "visual", inputPointer: "/frameRate/denominator" },- { resultPointer: "/frameCount", input: "visual", inputPointer: "/frameCount" },- { resultPointer: "/canvas/width", input: "visual", inputPointer: "/canvas/width" },- { resultPointer: "/canvas/height", input: "visual", inputPointer: "/canvas/height" },- { resultPointer: "/presentationSampleFrames", input: "audio", inputPointer: "/sampleFrames" },- ],}],implementation: {kind: "registered",@@ -312,11 +288,7 @@ export const mediaPipelineManifest: ModuleManifest = {{name: mediaPipelineProducers.projectMuxed.name,inputs: [{ name: "media", type: contractTypes.muxedMedia }],- outputs: [{- name: "video",- type: contractTypes.mediaArtifact,- affinity: [{ resultPointer: "/digest", input: "media", inputPointer: "/artifact/digest" }],- }],+ outputs: [{ name: "video", type: contractTypes.mediaArtifact }],needs: [],implementation: {kind: "registered",diff --git a/packages/media-pipeline/src/selection.ts b/packages/media-pipeline/src/selection.tsindex 8b4c9f80..2fe34ff0 100644--- a/packages/media-pipeline/src/selection.ts+++ b/packages/media-pipeline/src/selection.ts@@ -10,8 +10,6 @@ import type {} from "@svml/contracts";import {canonicalize,- digestOf,- isDigest,} from "@svml/protocol";import type { MediaSelectionRequest } from "./types.js";@@ -20,11 +18,8 @@ function assert(condition: unknown, message: string): asserts condition {if (!condition) throw new Error(message);}-export function sealMediaSelectionRequest(- value: Omit<MediaSelectionRequest, "requestDigest">,-): MediaSelectionRequest {- const normalized = canonicalize(value) as unknown as Omit<MediaSelectionRequest, "requestDigest">;- return { ...normalized, requestDigest: digestOf(normalized) };+export function sealMediaSelectionRequest(value: MediaSelectionRequest): MediaSelectionRequest {+ return canonicalize(value) as unknown as MediaSelectionRequest;}export function verifyMediaSelectionRequest(value: unknown): asserts value is MediaSelectionRequest {@@ -49,11 +44,6 @@ export function verifyMediaSelectionRequest(value: unknown): asserts value is Meassert(Number.isSafeInteger(item.frameRate?.numerator) && item.frameRate.numerator > 0&& Number.isSafeInteger(item.frameRate?.denominator) && item.frameRate.denominator > 0,"MediaSelectionRequest frame rate is invalid");- assert(typeof item.requestDigest === "string" && isDigest(item.requestDigest),- "MediaSelectionRequest digest is invalid");- const { requestDigest: _requestDigest, ...content } = item;- assert(item.requestDigest === digestOf(canonicalize(content)),- "MediaSelectionRequest digest differs from its canonical contents");}function selectUniqueDefault<T extends { readonly disposition: { readonly default: boolean }; readonly index: number }>(@@ -104,7 +94,7 @@ function selectedAudio(inspection: MediaInspection, request: MediaSelectionReque/*** Selects container streams only. Choosing an audio stream never claims that it is narrated speech;- * SpeechBasis construction remains a separate semantic Producer with Narrative affinity.+ * SpeechBasis construction remains a separate semantic Producer with an explicit Narrative edge.*/export function selectMediaStreams(inspection: MediaInspection,diff --git a/packages/media-pipeline/src/types.ts b/packages/media-pipeline/src/types.tsindex 69841b3a..010495cd 100644--- a/packages/media-pipeline/src/types.ts+++ b/packages/media-pipeline/src/types.ts@@ -1,4 +1,4 @@-import type { BlobRef, Digest } from "@svml/protocol";+import type { BlobRef } from "@svml/protocol";import type {MediaInspection,MediaRational,@@ -20,7 +20,6 @@ export type MediaSelectionRequest = {| { readonly mode: "none" };readonly spanAuthority: "video" | "audio";readonly frameRate: MediaRational;- readonly requestDigest: Digest;};export type InspectMediaNeed = {@@ -44,7 +43,6 @@ export type NormalizeMediaNeed = {export type ProjectSpeechEvidenceAudioNeed = {readonly contract: "svml.project-speech-evidence-audio-request@1";- readonly programSpaceDigest: Digest;readonly source: BlobRef;readonly sourceSampleRate: 48_000;readonly sourceChannels: 2;@@ -74,7 +72,6 @@ export type AudioProgramClip = {/** Pure, content-addressed plan. Executing it is always a Provider Need. */export type AudioProgramPlan = {readonly contract: "svml.audio-program-plan@1";- readonly programSpaceDigest: Digest;readonly frameRate: MediaRational;readonly frameCount: number;readonly sampleRate: 48_000;@@ -84,7 +81,6 @@ export type AudioProgramPlan = {readonly normalize: false;readonly limiter: "none";};- readonly planDigest: Digest;};export type RenderAudioNeed = {diff --git a/packages/media-pipeline/test/selection.test.ts b/packages/media-pipeline/test/selection.test.tsindex a9d45f81..1a69a1c3 100644--- a/packages/media-pipeline/test/selection.test.ts+++ b/packages/media-pipeline/test/selection.test.ts@@ -25,7 +25,6 @@ const timestamp = (ticks: string) => ({ ticks, timeBase });function grokInspection(): MediaInspection {return sealMediaInspection({contract: "svml.media-inspection@1",- source,container: { formatNames: ["mov", "mp4"] },streams: [{@@ -77,7 +76,6 @@ function grokInspection(): MediaInspection {height: 688,},],- probe: { algorithm: "ffprobe-decoded-units-json@1", implementation: "ffprobe fixture" },});}@@ -102,9 +100,8 @@ test("primary stream selection excludes Grok's MJPEG attached picture and observtest("multiple moving streams without one default fail closed instead of guessing by index or size", () => {const inspection = grokInspection();const primary = inspection.streams.find((stream): stream is MediaVideoStream => stream.kind === "video" && stream.index === 0)!;- const { inspectionDigest: _inspectionDigest, ...inspectionContent } = inspection;const ambiguous = sealMediaInspection({- ...inspectionContent,+ ...inspection,streams: [{ ...primary, disposition: { default: false, attachedPicture: false } },{ ...primary, index: 3, width: 1920, height: 1080, disposition: { default: false, attachedPicture: false } },diff --git a/packages/minimax-h3/src/index.ts b/packages/minimax-h3/src/index.tsindex ae80f50e..b5f233a1 100644--- a/packages/minimax-h3/src/index.ts+++ b/packages/minimax-h3/src/index.ts@@ -1,14 +1,12 @@import {assertGenerationBlobRef,generationBlobRefSchema,- generationDigestSchema,generationObjectSchema,generationPromptSchema,sealGenerationRequest,- verifyGenerationRequestDigest,} from "@svml/generation";import { defineExactModelModule } from "@svml/model-kit";-import type { BlobRef, Digest, ValueSchema } from "@svml/protocol";+import type { BlobRef, ValueSchema } from "@svml/protocol";export const minimaxH3ModuleRef = { name: "@svml/minimax-h3", version: "0.0.0-dev" } as const;export type MinimaxH3Mode = "text" | "frames" | "reference";@@ -42,14 +40,13 @@ export type MinimaxH3RequestContent =| MinimaxH3TextRequestContent| MinimaxH3FramesRequestContent| MinimaxH3ReferenceRequestContent;-export type MinimaxH3Request = MinimaxH3RequestContent & { readonly requestDigest: Digest };+export type MinimaxH3Request = MinimaxH3RequestContent;const commonFields = {contract: { schema: { kind: "literal", value: "svml.minimax-h3-request@1" } },model: { schema: { kind: "literal", value: "minimax-h3" } },prompt: { schema: generationPromptSchema },durationSec: { schema: { kind: "number", integer: true, minimum: 1, maximum: 60 } },- requestDigest: { schema: generationDigestSchema },} as const;const aspect = { kind: "string", minLength: 3, maxLength: 16 } as const satisfies ValueSchema;const referenceSchema: ValueSchema = {@@ -86,7 +83,6 @@ function object(value: unknown, subject: string): Record<string, unknown> {}export function verifyMinimaxH3Request(value: unknown, expectedMode?: MinimaxH3Mode): asserts value is MinimaxH3Request {- verifyGenerationRequestDigest(value);const request = object(value, "MiniMax H3 request");if (request.contract !== "svml.minimax-h3-request@1" || request.model !== "minimax-h3") {throw new Error("MiniMax H3 request identity is invalid");@@ -111,7 +107,7 @@ export function verifyMinimaxH3Request(value: unknown, expectedMode?: MinimaxH3Mexport function sealMinimaxH3Request<T extends MinimaxH3RequestContent>(content: T,-): T & { readonly requestDigest: Digest } {+): T {const request = sealGenerationRequest(content);verifyMinimaxH3Request(request, content.mode);return request;diff --git a/packages/nano-banana/src/index.ts b/packages/nano-banana/src/index.tsindex 6dcb5c2e..9503ddef 100644--- a/packages/nano-banana/src/index.ts+++ b/packages/nano-banana/src/index.ts@@ -1,14 +1,12 @@import {assertGenerationBlobRef,generationBlobRefSchema,- generationDigestSchema,generationObjectSchema,generationPromptSchema,sealGenerationRequest,- verifyGenerationRequestDigest,} from "@svml/generation";import { defineExactModelModule } from "@svml/model-kit";-import type { BlobRef, Digest, ValueSchema } from "@svml/protocol";+import type { BlobRef, ValueSchema } from "@svml/protocol";export const nanoBananaModuleRef = { name: "@svml/nano-banana", version: "0.0.0-dev" } as const;export const nanoBananaModels = ["nano-banana-2", "nano-banana-pro"] as const;@@ -22,9 +20,7 @@ export type NanoBananaRequestContent<M extends NanoBananaModel = NanoBananaModelreadonly resolution: "1K" | "2K" | "4K";readonly outputFormat: "png" | "jpg";};-export type NanoBananaRequest<M extends NanoBananaModel = NanoBananaModel> = NanoBananaRequestContent<M> & {- readonly requestDigest: Digest;-};+export type NanoBananaRequest<M extends NanoBananaModel = NanoBananaModel> = NanoBananaRequestContent<M>;function requestSchema(model: NanoBananaModel): ValueSchema {return generationObjectSchema({@@ -38,7 +34,6 @@ function requestSchema(model: NanoBananaModel): ValueSchema {aspectRatio: { schema: { kind: "string", minLength: 3, maxLength: 16 } },resolution: { schema: { kind: "string", enum: ["1K", "2K", "4K"] } },outputFormat: { schema: { kind: "string", enum: ["png", "jpg"] } },- requestDigest: { schema: generationDigestSchema },});}@@ -48,7 +43,6 @@ function object(value: unknown): Record<string, unknown> {}export function verifyNanoBananaRequest(value: unknown, expectedModel?: NanoBananaModel): asserts value is NanoBananaRequest {- verifyGenerationRequestDigest(value);const request = object(value);if (request.contract !== "svml.nano-banana-request@1"|| !nanoBananaModels.includes(request.model as NanoBananaModel)) {diff --git a/packages/package-loader-node/package.json b/packages/package-loader-node/package.jsonindex ed98a12e..3296362b 100644--- a/packages/package-loader-node/package.json+++ b/packages/package-loader-node/package.json@@ -14,5 +14,8 @@"@svml/protocol": "workspace:*","@svml/run": "workspace:*","@svml/validation": "workspace:*"+ },+ "devDependencies": {+ "@svml/runtime-adapter": "workspace:*"}}diff --git a/packages/package-loader-node/src/lock.ts b/packages/package-loader-node/src/lock.tsindex ee97b5a1..8560a12c 100644--- a/packages/package-loader-node/src/lock.ts+++ b/packages/package-loader-node/src/lock.ts@@ -34,6 +34,7 @@ type PackageJson = {readonly dependencies?: Readonly<Record<string, string>>;readonly optionalDependencies?: Readonly<Record<string, string>>;readonly peerDependencies?: Readonly<Record<string, string>>;+ readonly peerDependenciesMeta?: Readonly<Record<string, { readonly optional?: boolean }>>;readonly svml?: {readonly activation?: string;};@@ -61,6 +62,9 @@ function string(value: unknown, subject: string): string {function parsePackageJson(value: unknown, subject: string): PackageJson {const parsed = object(value, subject);const svml = parsed.svml === undefined ? undefined : object(parsed.svml, `${subject}.svml`);+ const peerDependenciesMeta = parsed.peerDependenciesMeta === undefined+ ? undefined+ : object(parsed.peerDependenciesMeta, `${subject}.peerDependenciesMeta`);return {name: string(parsed.name, `${subject}.name`),version: string(parsed.version, `${subject}.version`),@@ -73,6 +77,14 @@ function parsePackageJson(value: unknown, subject: string): PackageJson {...(parsed.peerDependencies === undefined? {}: { peerDependencies: object(parsed.peerDependencies, `${subject}.peerDependencies`) as Readonly<Record<string, string>> }),+ ...(peerDependenciesMeta === undefined+ ? {}+ : { peerDependenciesMeta: Object.fromEntries(Object.entries(peerDependenciesMeta).map(([name, raw]) => {+ const value = object(raw, `${subject}.peerDependenciesMeta.${name}`);+ assert(value.optional === undefined || typeof value.optional === "boolean",+ `${subject}.peerDependenciesMeta.${name}.optional must be a boolean`);+ return [name, value.optional === undefined ? {} : { optional: value.optional }];+ })) }),...(svml === undefined ? {} : { svml: {...(svml.activation === undefined? {}@@ -105,8 +117,13 @@ async function resolvePhysicalPackage(specifier: string, from: string): Promise<let entry: string;try {entry = resolver.resolve(specifier);- } catch (error) {- throw new Error(`cannot resolve installed package ${specifier} from ${from}: ${error instanceof Error ? error.message : String(error)}`);+ } catch (entryError) {+ try {+ // Type-only and metadata-only packages may intentionally expose no runtime entry.+ entry = resolver.resolve(`${specifier}/package.json`);+ } catch {+ throw new Error(`cannot resolve installed package ${specifier} from ${from}: ${entryError instanceof Error ? entryError.message : String(entryError)}`);+ }}return await packageRootFromEntry(entry, specifier);}@@ -119,6 +136,11 @@ function dependencyNames(json: PackageJson): readonly string[] {])].sort();}+function optionalDependency(json: PackageJson, name: string): boolean {+ return Object.hasOwn(json.optionalDependencies ?? {}, name)+ || json.peerDependenciesMeta?.[name]?.optional === true;+}+async function packageClosure(entries: readonly string[], root: string): Promise<readonly ResolvedPhysicalPackage[]> {const resolved = new Map<string, ResolvedPhysicalPackage>();const visit = async (item: ResolvedPhysicalPackage): Promise<void> => {@@ -133,7 +155,7 @@ async function packageClosure(entries: readonly string[], root: string): Promisetry {await visit(await resolvePhysicalPackage(dependency, item.root));} catch (error) {- if (Object.hasOwn(item.json.optionalDependencies ?? {}, dependency)) continue;+ if (optionalDependency(item.json, dependency)) continue;throw error;}}@@ -275,6 +297,8 @@ function parseLock(value: unknown): NodePackageLock {const physical = object(item.package, `$lock.packages[${index}].package`);const facetsDigest = string(item.facetsDigest, `$lock.packages[${index}].facetsDigest`);assert(isDigest(facetsDigest), `$lock.packages[${index}].facetsDigest is invalid`);+ const closureDigest = string(item.closureDigest, `$lock.packages[${index}].closureDigest`);+ assert(isDigest(closureDigest), `$lock.packages[${index}].closureDigest is invalid`);return {specifier: string(item.specifier, `$lock.packages[${index}].specifier`),package: {@@ -282,6 +306,7 @@ function parseLock(value: unknown): NodePackageLock {version: string(physical.version, `$lock.packages[${index}].package.version`),},facetsDigest,+ closureDigest,};});const digest = string(parsed.digest, "$lock.digest");@@ -316,10 +341,12 @@ export async function createNodePackageLock(for (const specifier of unique) {const physical = await resolvePhysicalPackage(specifier, root);const contribution = await importContribution(physical);+ const ownArtifacts = await resolvedArtifacts(await packageClosure([specifier], root));packages.push({specifier,package: { name: physical.json.name, version: physical.json.version },facetsDigest: digestOf(contributionMetadata(contribution)),+ closureDigest: digestOf({ format: "svml.package-closure@1", artifacts: ownArtifacts }),});}return sealLock({@@ -352,6 +379,9 @@ export async function loadNodePackageSet(const contribution = await importContribution(physical);assert(digestOf(contributionMetadata(contribution)) === expected.facetsDigest,`${expected.specifier} facets do not match the lock`);+ const ownArtifacts = await resolvedArtifacts(await packageClosure([expected.specifier], root));+ assert(digestOf({ format: "svml.package-closure@1", artifacts: ownArtifacts }) === expected.closureDigest,+ `${expected.specifier} dependency closure does not match the lock`);values.push(contribution);}return { lock, contributions: values };diff --git a/packages/package-loader-node/src/types.ts b/packages/package-loader-node/src/types.tsindex 9ea31457..e5001469 100644--- a/packages/package-loader-node/src/types.ts+++ b/packages/package-loader-node/src/types.ts@@ -7,8 +7,8 @@ import type { RunFrontend } from "@svml/run";/*** Trusted executable facets exported by one installed physical package. The Host independently- * grants author registries or deterministic compute registries; this descriptor has no Provider,- * credential, store, queue or Runtime facet.+ * grants each exact Host ABI separately. Runtime Adapter Host facets remain inert unless a Runtime+ * Profile explicitly selects the physical package through its own lock.*/export type NodePackageContribution = {readonly format: "svml.node-package@1";@@ -36,6 +36,8 @@ export type LockedNodePackage = {};/** Digest of declared Module, author and compute facet identities, excluding function objects. */readonly facetsDigest: Digest;+ /** Digest of this package's own transitive physical Artifact closure, excluding unrelated selections. */+ readonly closureDigest: Digest;};export type NodePackageLock = {diff --git a/packages/package-loader-node/test/loader.test.ts b/packages/package-loader-node/test/loader.test.tsindex d7011cd6..f326b60a 100644--- a/packages/package-loader-node/test/loader.test.ts+++ b/packages/package-loader-node/test/loader.test.ts@@ -12,9 +12,11 @@ import test from "node:test";import {createNodePackageLock,installNodePackageComponents,+ loadNodePackageSet,loadNodePackageContributions,writeNodePackageLock,} from "@svml/package-loader-node";+import { RuntimeAdapterRegistry } from "@svml/runtime-adapter";import { TypeValidatorRegistry } from "@svml/validation";import type { ProducerRef } from "@svml/protocol";@@ -31,8 +33,12 @@ async function fixture(): Promise<{const root = await mkdtemp(join(tmpdir(), "svml-package-loader-"));const packageRoot = join(root, "node_modules", "example-card");const dependencyRoot = join(root, "node_modules", "example-helper");+ const typesRoot = join(root, "node_modules", "example-types");+ const extraRoot = join(root, "node_modules", "example-extra");await mkdir(packageRoot, { recursive: true });await mkdir(dependencyRoot, { recursive: true });+ await mkdir(typesRoot, { recursive: true });+ await mkdir(extraRoot, { recursive: true });const activation = join(packageRoot, "activation.mjs");const dependency = join(dependencyRoot, "index.mjs");await writeFile(join(dependencyRoot, "package.json"), JSON.stringify({@@ -42,12 +48,32 @@ async function fixture(): Promise<{exports: "./index.mjs",}, null, 2), "utf8");await writeFile(dependency, "export const helper = true;\n", "utf8");+ await writeFile(join(typesRoot, "package.json"), JSON.stringify({+ name: "example-types",+ version: "1.0.0",+ main: "",+ types: "index.d.ts",+ }, null, 2), "utf8");+ await writeFile(join(typesRoot, "index.d.ts"), "export type Marker = true;\n", "utf8");+ await writeFile(join(extraRoot, "package.json"), JSON.stringify({+ name: "example-extra",+ version: "1.0.0",+ type: "module",+ exports: "./activation.mjs",+ svml: { activation: "./activation.mjs" },+ }, null, 2), "utf8");+ await writeFile(join(extraRoot, "activation.mjs"), `export default {+ format: "svml.node-package@1",+ name: "example-extra",+ };\n`, "utf8");await writeFile(join(packageRoot, "package.json"), JSON.stringify({name: "example-card",version: "1.0.0",type: "module",exports: "./activation.mjs",- dependencies: { "example-helper": "1.0.0" },+ dependencies: { "example-helper": "1.0.0", "example-types": "1.0.0" },+ peerDependencies: { "example-optional-peer": "1.0.0" },+ peerDependenciesMeta: { "example-optional-peer": { optional: true } },svml: { activation: "./activation.mjs" },}, null, 2), "utf8");await writeFile(activation, `@@ -163,7 +189,7 @@ async function fixture(): Promise<{test("an installed locked package carries inert Host facets and activatable compute", async () => {const item = await fixture();const lock = await createNodePackageLock(["example-card"], item.root);- assert.deepEqual(lock.artifacts.map((artifact) => artifact.name), ["example-card", "example-helper"]);+ assert.deepEqual(lock.artifacts.map((artifact) => artifact.name), ["example-card", "example-helper", "example-types"]);await writeNodePackageLock(item.lock, lock);const packages = await loadNodePackageContributions(item.lock, item.root);@@ -194,6 +220,16 @@ test("dependency bytes are rejected before a locked contribution entry is reused);});+test("an unrelated selected package does not contaminate another package's implementation closure", async () => {+ const item = await fixture();+ const alone = await createNodePackageLock(["example-card"], item.root);+ const together = await createNodePackageLock(["example-card", "example-extra"], item.root);+ const left = alone.packages.find((value) => value.specifier === "example-card")!;+ const right = together.packages.find((value) => value.specifier === "example-card")!;+ assert.equal(left.closureDigest, right.closureDigest);+ assert.notEqual(alone.digest, together.digest);+});+test("a compute facet cannot claim another implementation than its static Manifest", async () => {const item = await fixture();const source = await readFile(item.activation, "utf8");@@ -211,3 +247,112 @@ test("a compute facet cannot claim another implementation than its static Manife/Producer .* differs from its Manifest/u,);});++async function runtimeAdapterFixture(marker: string): Promise<{+ readonly root: string;+ readonly lock: string;+}> {+ const root = await mkdtemp(join(tmpdir(), "svml-external-runtime-adapter-"));+ const packageRoot = join(root, "node_modules", "example-runtime-adapter");+ await mkdir(packageRoot, { recursive: true });+ await writeFile(join(packageRoot, "package.json"), JSON.stringify({+ name: "example-runtime-adapter",+ version: "1.0.0",+ type: "module",+ exports: "./activation.mjs",+ svml: { activation: "./activation.mjs" },+ }, null, 2), "utf8");+ await writeFile(join(packageRoot, "activation.mjs"), `+ // Physical implementation marker: ${marker}+ const declared = "sha256:${"7".repeat(64)}";+ const configuration = "sha256:${"8".repeat(64)}";+ const module = { name: "example.runtime", version: "1" };+ const capability = { module, name: "Generate" };+ const returns = { module, name: "Result" };+ const runtimeFacet = {+ abi: "svml.runtime-adapter-host@1",+ identity: {+ contract: "svml.runtime-adapter-facet@1",+ use: "example-runtime-adapter",+ kind: "endpoint",+ },+ implementation: {+ create(context) {+ const facet = { module, name: "endpoint" };+ return {+ name: context.instance,+ manifest: {+ format: "svml.runtime-module@2",+ name: module.name,+ version: module.version,+ facets: [{+ name: facet.name,+ role: "capability-endpoint",+ implementation: { locator: "example-runtime-adapter/endpoint", digest: declared },+ permissions: [],+ fulfills: [{ capability, returns }],+ lifecycle: "immediate",+ defaultConcurrency: 1,+ credentialSlots: [],+ }],+ },+ instance: { id: context.instance, facet, configurationDigest: configuration },+ bindings: [{ capability, returns, endpoint: context.instance }],+ install(registry) {+ registry.registerImmediateEndpoint(+ context.instance,+ capability,+ returns,+ () => ({+ value: { kind: "inline", value: "external" },+ conformance: "exact",+ delivery: { kind: "inline" },+ metadata: null,+ }),+ { runtimeImplementation: { facet, digest: declared, configurationDigest: configuration } },+ );+ },+ };+ },+ },+ };+ export default {+ format: "svml.node-package@1",+ name: "example-runtime-adapter",+ hostFacets: [runtimeFacet],+ };+ `, "utf8");+ return { root, lock: join(root, "runtime.packages.lock") };+}++async function loadedExternalEndpointDigest(marker: string): Promise<string> {+ const item = await runtimeAdapterFixture(marker);+ await writeNodePackageLock(+ item.lock,+ await createNodePackageLock(["example-runtime-adapter"], item.root),+ );+ const loaded = await loadNodePackageSet(item.lock, item.root);+ const contribution = loaded.contributions[0]!;+ const locked = loaded.lock.packages[0]!;+ const artifact = loaded.lock.artifacts.find((value) =>+ value.name === locked.package.name && value.version === locked.package.version)!;+ const registry = new RuntimeAdapterRegistry();+ registry.registerFacet(contribution.hostFacets![0]!, {+ packageName: contribution.name,+ packageArtifactDigest: artifact.digest,+ packageClosureDigest: locked.closureDigest,+ });+ const endpoint = await registry.createEndpoint("example-runtime-adapter", {+ root: item.root,+ instance: "external.fixture",+ config: {},+ });+ return endpoint.manifest.facets[0]!.implementation.digest;+}++test("a third-party Runtime Adapter stays outside the Host and is identified by its actual package bytes", async () => {+ const first = await loadedExternalEndpointDigest("first-build");+ const second = await loadedExternalEndpointDigest("second-build");+ assert.notEqual(first, `sha256:${"7".repeat(64)}`);+ assert.notEqual(first, second);+});diff --git a/packages/prompt-kit/src/manifest.ts b/packages/prompt-kit/src/manifest.tsindex 41a41ec5..ac103012 100644--- a/packages/prompt-kit/src/manifest.ts+++ b/packages/prompt-kit/src/manifest.ts@@ -14,7 +14,6 @@ export const promptKitImplementationDigests = {programValidator: digestOf("@svml/prompt-kit/validate-program@1"),} as const;-const digest: ValueSchema = { kind: "string", minLength: 71, maxLength: 71 };const openObject: ValueSchema = { kind: "object", fields: {}, allowUnknown: true };const block: ValueSchema = { kind: "object", fields: {}, allowUnknown: true };const specSchema: ValueSchema = {@@ -25,30 +24,23 @@ const specSchema: ValueSchema = {separator: { schema: { kind: "literal", value: "\n\n" } },defaults: { schema: openObject },blocks: { schema: { kind: "array", minItems: 1, items: block } },- specDigest: { schema: digest },},};const invocationSchema: ValueSchema = {kind: "object",fields: {contract: { schema: { kind: "literal", value: "svml.prompt-kit-invocation@1" } },- kit: { schema: { kind: "string", minLength: 1 } },parameters: { schema: openObject },selectors: { schema: openObject },slots: { schema: openObject },- invocationDigest: { schema: digest },},};const programSchema: ValueSchema = {kind: "object",fields: {contract: { schema: { kind: "literal", value: "svml.prompt-program@1" } },- kit: { schema: { kind: "string", minLength: 1 } },- specDigest: { schema: digest },- invocationDigest: { schema: digest },separator: { schema: { kind: "literal", value: "\n\n" } },blocks: { schema: { kind: "array", minItems: 1, items: block } },- programDigest: { schema: digest },},};diff --git a/packages/prompt-kit/src/program.ts b/packages/prompt-kit/src/program.tsindex c016d1fc..806a44bc 100644--- a/packages/prompt-kit/src/program.ts+++ b/packages/prompt-kit/src/program.ts@@ -1,4 +1,4 @@-import { canonicalize, digestOf, isDigest } from "@svml/protocol";+import { canonicalize } from "@svml/protocol";import type {PromptKitAxisBlock,@@ -94,12 +94,8 @@ function block(value: unknown, subject: string): asserts value is PromptKitBlockthrow new Error(`${subject}.kind is invalid`);}-function specContent(value: Omit<PromptKitSpec, "specDigest">) {- return canonicalize(value);-}--export function sealPromptKitSpec(value: Omit<PromptKitSpec, "specDigest">): PromptKitSpec {- const result = { ...value, specDigest: digestOf(specContent(value)) };+export function sealPromptKitSpec(value: PromptKitSpec): PromptKitSpec {+ const result = canonicalize(value) as unknown as PromptKitSpec;verifyPromptKitSpec(result);return result;}@@ -112,7 +108,6 @@ export function verifyPromptKitSpec(value: unknown): asserts value is PromptKitS|| spec.separator !== "\n\n"|| !Array.isArray(spec.blocks)|| spec.blocks.length === 0- || !isDigest(spec.specDigest)) {throw new Error("PromptKitSpec header is invalid");}@@ -131,18 +126,12 @@ export function verifyPromptKitSpec(value: unknown): asserts value is PromptKitSthrow new Error(`PromptKitSpec block ${item.id} has duplicate choices`);}}- const { specDigest: _digest, ...content } = spec;- if (spec.specDigest !== digestOf(specContent(content))) throw new Error("PromptKitSpec digest differs from its contents");-}--function invocationContent(value: Omit<PromptKitInvocation, "invocationDigest">) {- return canonicalize(value);}export function sealPromptKitInvocation(- value: Omit<PromptKitInvocation, "invocationDigest">,+ value: PromptKitInvocation,): PromptKitInvocation {- const result = { ...value, invocationDigest: digestOf(invocationContent(value)) };+ const result = canonicalize(value) as unknown as PromptKitInvocation;verifyPromptKitInvocation(result);return result;}@@ -151,50 +140,32 @@ export function verifyPromptKitInvocation(value: unknown): asserts value is Promconst invocation = object(value, "PromptKitInvocation") as PromptKitInvocation;if (invocation.contract !== "svml.prompt-kit-invocation@1"- || !ID.test(invocation.kit)- || !isDigest(invocation.invocationDigest)) {throw new Error("PromptKitInvocation header is invalid");}scalarMap(invocation.parameters, "PromptKitInvocation.parameters");stringMap(invocation.selectors, "PromptKitInvocation.selectors");stringMap(invocation.slots, "PromptKitInvocation.slots");- const { invocationDigest: _digest, ...content } = invocation;- if (invocation.invocationDigest !== digestOf(invocationContent(content))) {- throw new Error("PromptKitInvocation digest differs from its contents");- }-}--function programContent(value: Omit<PromptProgram, "programDigest">) {- return canonicalize(value);}export function verifyPromptProgram(value: unknown): asserts value is PromptProgram {const program = object(value, "PromptProgram") as PromptProgram;if (program.contract !== "svml.prompt-program@1"- || !ID.test(program.kit)- || !isDigest(program.specDigest)- || !isDigest(program.invocationDigest)|| program.separator !== "\n\n"|| !Array.isArray(program.blocks)|| program.blocks.length === 0- || !isDigest(program.programDigest)) {throw new Error("PromptProgram header is invalid");}for (const [index, item] of program.blocks.entries()) {- if (!ID.test(item.id) || typeof item.origin !== "string" || item.origin.length === 0 || typeof item.text !== "string" || item.text.length === 0) {+ if (!ID.test(item.id) || typeof item.text !== "string" || item.text.length === 0) {throw new Error(`PromptProgram.blocks[${index}] is invalid`);}}if (new Set(program.blocks.map((item) => item.id)).size !== program.blocks.length) {throw new Error("PromptProgram block ids must be unique");}- const { programDigest: _digest, ...content } = program;- if (program.programDigest !== digestOf(programContent(content))) {- throw new Error("PromptProgram digest differs from its contents");- }}function conditionsMatch(@@ -231,13 +202,12 @@ function axisBlock(if (value === undefined) throw new Error(`Prompt Kit parameter ${item.parameter} is required`);const selected = item.choices.filter((option) => option.id === String(value));if (selected.length !== 1) throw new Error(`Prompt Kit axis ${item.parameter} has no unique choice for ${String(value)}`);- return { id: item.id, origin: `parameter:${item.parameter}:${String(value)}`, text: selected[0]!.text };+ return { id: item.id, text: selected[0]!.text };}export function compilePromptKit(spec: PromptKitSpec, invocation: PromptKitInvocation): PromptProgram {verifyPromptKitSpec(spec);verifyPromptKitInvocation(invocation);- if (invocation.kit !== spec.id) throw new Error(`Prompt Kit ${invocation.kit} does not match Spec ${spec.id}`);const known = knownInputs(spec);for (const name of Object.keys(invocation.parameters)) {if (!known.parameters.has(name)) throw new Error(`Prompt Kit parameter ${name} is not declared`);@@ -252,7 +222,7 @@ export function compilePromptKit(spec: PromptKitSpec, invocation: PromptKitInvocconst blocks: PromptProgramBlock[] = [];for (const item of spec.blocks) {if (item.kind === "fixed") {- blocks.push({ id: item.id, origin: `kit:${spec.id}:fixed`, text: item.text });+ blocks.push({ id: item.id, text: item.text });continue;}if (item.kind === "axis") {@@ -262,7 +232,7 @@ export function compilePromptKit(spec: PromptKitSpec, invocation: PromptKitInvocif (item.kind === "variant") {const selected = item.choices.filter((option) => conditionsMatch(option, parameters, invocation.selectors));if (selected.length !== 1) throw new Error(`Prompt Kit variant ${item.id} matched ${selected.length} choices`);- blocks.push({ id: item.id, origin: `variant:${item.id}:${selected[0]!.id}`, text: selected[0]!.text });+ blocks.push({ id: item.id, text: selected[0]!.text });continue;}const value = invocation.slots[item.slot]?.trim();@@ -272,19 +242,14 @@ export function compilePromptKit(spec: PromptKitSpec, invocation: PromptKitInvoc}blocks.push({id: item.id,- origin: `slot:${item.slot}`,text: item.label === undefined ? value : `${item.label}\n${value}`,});}- const content: Omit<PromptProgram, "programDigest"> = {+ const program: PromptProgram = {contract: "svml.prompt-program@1",- kit: spec.id,- specDigest: spec.specDigest,- invocationDigest: invocation.invocationDigest,separator: spec.separator,blocks,};- const program = { ...content, programDigest: digestOf(programContent(content)) };verifyPromptProgram(program);return program;}diff --git a/packages/prompt-kit/src/types.ts b/packages/prompt-kit/src/types.tsindex 690e10ee..060ec835 100644--- a/packages/prompt-kit/src/types.ts+++ b/packages/prompt-kit/src/types.ts@@ -1,5 +1,3 @@-import type { Digest } from "@svml/protocol";-export type PromptKitScalar = string | number | boolean;export type PromptKitConditions = {@@ -56,30 +54,22 @@ export type PromptKitSpec = {readonly separator: "\n\n";readonly defaults: Readonly<Record<string, PromptKitScalar>>;readonly blocks: readonly PromptKitBlockSpec[];- readonly specDigest: Digest;};export type PromptKitInvocation = {readonly contract: "svml.prompt-kit-invocation@1";- readonly kit: string;readonly parameters: Readonly<Record<string, PromptKitScalar>>;readonly selectors: Readonly<Record<string, string>>;readonly slots: Readonly<Record<string, string>>;- readonly invocationDigest: Digest;};export type PromptProgramBlock = {readonly id: string;- readonly origin: string;readonly text: string;};export type PromptProgram = {readonly contract: "svml.prompt-program@1";- readonly kit: string;- readonly specDigest: Digest;- readonly invocationDigest: Digest;readonly separator: "\n\n";readonly blocks: readonly PromptProgramBlock[];- readonly programDigest: Digest;};diff --git a/packages/prompt-kit/test/program.test.ts b/packages/prompt-kit/test/program.test.tsindex 7483e943..5e7db11a 100644--- a/packages/prompt-kit/test/program.test.ts+++ b/packages/prompt-kit/test/program.test.ts@@ -39,7 +39,6 @@ const spec = sealPromptKitSpec({function invocation(parameters: Record<string, string> = {}) {return sealPromptKitInvocation({contract: "svml.prompt-kit-invocation@1",- kit: "demo-v1",parameters,selectors: { evidence: "present" },slots: { subject: "a toothbrush" },@@ -52,12 +51,6 @@ test("generic Prompt Kit resolves defaults, finite variants and required slots",assert.deepEqual(program.blocks.map((block) => block.text), ["BASE", "CALM", "USE EVIDENCE", "SUBJECT:\na toothbrush",]);- assert.deepEqual(program.blocks.map((block) => block.origin), [- "kit:demo-v1:fixed",- "parameter:tone:calm",- "variant:evidence:present",- "slot:subject",- ]);});test("Invocation parameters override Spec defaults without changing the Spec", () => {@@ -86,7 +79,6 @@ test("unknown inputs and non-unique finite branches fail closed", () => {});const call = sealPromptKitInvocation({contract: "svml.prompt-kit-invocation@1",- kit: "ambiguous-v1",parameters: {}, selectors: {}, slots: {},});assert.throws(() => compilePromptKit(ambiguous, call), /matched 2 choices/u);diff --git a/packages/protocol/src/build.ts b/packages/protocol/src/build.tsindex f46a3218..ea45ed0c 100644--- a/packages/protocol/src/build.ts+++ b/packages/protocol/src/build.ts@@ -160,20 +160,12 @@ export type OperationResultRef = {export type GraphValueRef = RecordRef | LogicalOutputRef | OperationResultRef;-/** A domain-neutral equality claim between a logical result and one source fact. */-export type AffinityConstraint = {- readonly resultPointer: string;- readonly source: GraphValueRef;- readonly sourcePointer: string;-};-export type LogicalOutput = {readonly id: LogicalOutputId;readonly type: TypeRef;readonly primary: CandidateId;/** Author-visible facts that a Candidate may transitively depend upon. */readonly semanticInputs: readonly GraphValueRef[];- readonly affinity?: readonly AffinityConstraint[];};export type OperationResult =diff --git a/packages/protocol/src/manifest.ts b/packages/protocol/src/manifest.tsindex 1f415301..5a3cd49e 100644--- a/packages/protocol/src/manifest.ts+++ b/packages/protocol/src/manifest.ts@@ -213,36 +213,15 @@ function port(value: unknown, path: string): PortDeclaration {return {name: string(parsed.name, `${path}.name`),type: typeRef(parsed.type, `${path}.type`),- ...(parsed.affinity === undefined- ? {}- : { affinity: resultAffinityList(parsed.affinity, `${path}.affinity`) }),};}-function resultAffinityList(- value: unknown,- path: string,-): NonNullable<PortDeclaration["affinity"]> {- return array(value, path).map((item, index) => {- const itemPath = `${path}[${index}]`;- const parsed = object(item, itemPath);- return {- resultPointer: possiblyEmptyString(parsed.resultPointer, `${itemPath}.resultPointer`),- input: string(parsed.input, `${itemPath}.input`),- inputPointer: possiblyEmptyString(parsed.inputPointer, `${itemPath}.inputPointer`),- };- });-}-function needPort(value: unknown, path: string): NeedPortDeclaration {const parsed = object(value, path);return {name: string(parsed.name, `${path}.name`),capability: capabilityRef(parsed.capability, `${path}.capability`),returns: typeRef(parsed.returns, `${path}.returns`),- ...(parsed.affinity === undefined- ? {}- : { affinity: resultAffinityList(parsed.affinity, `${path}.affinity`) }),};}diff --git a/packages/protocol/src/module.ts b/packages/protocol/src/module.tsindex 9da53fc3..8304e320 100644--- a/packages/protocol/src/module.ts+++ b/packages/protocol/src/module.ts@@ -19,24 +19,15 @@ export type TypeValidatorDeclaration = {readonly implementation: ImplementationRef;};-/** A domain-neutral equality promise from one result field to one Producer input field. */-export type ResultAffinityDeclaration = {- readonly resultPointer: string;- readonly input: string;- readonly inputPointer: string;-};-export type PortDeclaration = {readonly name: string;readonly type: TypeRef;- readonly affinity?: readonly ResultAffinityDeclaration[];};export type NeedPortDeclaration = {readonly name: string;readonly capability: CapabilityRef;readonly returns: TypeRef;- readonly affinity?: readonly ResultAffinityDeclaration[];};export type CapabilityDeclaration = {diff --git a/packages/provider-google-vertex/package.json b/packages/provider-google-vertex/package.jsonindex 6200a24a..f1399a51 100644--- a/packages/provider-google-vertex/package.json+++ b/packages/provider-google-vertex/package.json@@ -6,13 +6,16 @@"exports": {".": "./src/index.ts"},+ "svml": { "activation": "./src/activation.ts" },"dependencies": {"@google/genai": "1.52.0","@svml/caption": "workspace:*","@svml/caption-gemini": "workspace:*","@svml/endpoint-kit": "workspace:*","@svml/protocol": "workspace:*",- "@svml/runtime": "workspace:*"+ "@svml/runtime": "workspace:*",+ "@svml/runtime-adapter": "workspace:*",+ "@svml/runtime-adapter-node": "workspace:*"},"devDependencies": {"@svml/driver-node": "workspace:*",diff --git a/packages/provider-google-vertex/src/activation.ts b/packages/provider-google-vertex/src/activation.tsnew file mode 100644index 00000000..62273fd8--- /dev/null+++ b/packages/provider-google-vertex/src/activation.ts@@ -0,0 +1,65 @@+import { credentialRef } from "@svml/runtime";+import {+ createRuntimeEndpointAdapterFacet,+ runtimeConfigExact,+ runtimeConfigObject,+ runtimeConfigPositiveInteger,+ runtimeConfigString,+} from "@svml/runtime-adapter";+import { diagnoseRuntimeEnvironmentCredential } from "@svml/runtime-adapter-node";++import { createGoogleVertexCaptionProvider } from "./provider.js";++const googleVertexRuntimeAdapter = createRuntimeEndpointAdapterFacet({+ use: "@svml/provider-google-vertex",+ create(context) {+ const config = runtimeConfigObject(context.config, "Google Vertex");+ runtimeConfigExact(config, [+ "project", "projectEnv", "location", "credentialsEnv", "defaultConcurrency",+ "requestTimeoutMs", "maxResponseBytes",+ ], "Google Vertex");+ const projectValue = runtimeConfigString(config.project, "Google Vertex project");+ const projectEnv = runtimeConfigString(config.projectEnv, "Google Vertex projectEnv");+ if (projectValue !== undefined && projectEnv !== undefined) {+ throw new Error("Google Vertex accepts project or projectEnv, not both");+ }+ const project = projectValue ?? (projectEnv === undefined ? undefined : process.env[projectEnv]?.trim());+ if (project === undefined || project.length === 0) throw new Error("Google Vertex project is required");+ const credentialsEnv = runtimeConfigString(config.credentialsEnv, "Google Vertex credentialsEnv");+ return createGoogleVertexCaptionProvider({+ project,+ instance: context.instance,+ ...(context.lane === undefined ? {} : { lane: context.lane }),+ ...(runtimeConfigString(config.location, "Google Vertex location") === undefined+ ? {} : { location: config.location as string }),+ ...(credentialsEnv === undefined ? {} : { credentialsJson: credentialRef("env", credentialsEnv) }),+ ...(runtimeConfigPositiveInteger(config.defaultConcurrency, "Google Vertex defaultConcurrency") === undefined+ ? {} : { defaultConcurrency: config.defaultConcurrency as number }),+ ...(runtimeConfigPositiveInteger(config.requestTimeoutMs, "Google Vertex requestTimeoutMs") === undefined+ ? {} : { requestTimeoutMs: config.requestTimeoutMs as number }),+ ...(runtimeConfigPositiveInteger(config.maxResponseBytes, "Google Vertex maxResponseBytes") === undefined+ ? {} : { maxResponseBytes: config.maxResponseBytes as number }),+ });+ },+ doctor(context) {+ const config = runtimeConfigObject(context.config, "Google Vertex");+ const project = runtimeConfigString(config.project, "Google Vertex project");+ const projectEnv = runtimeConfigString(config.projectEnv, "Google Vertex projectEnv");+ const credentialsEnv = runtimeConfigString(config.credentialsEnv, "Google Vertex credentialsEnv")+ ?? "GOOGLE_APPLICATION_CREDENTIALS_JSON";+ return [+ ...(project !== undefined+ ? []+ : diagnoseRuntimeEnvironmentCredential(projectEnv ?? "GOOGLE_CLOUD_PROJECT", "Google Vertex project")),+ ...diagnoseRuntimeEnvironmentCredential(credentialsEnv, "Google Vertex credentials"),+ ];+ },+});++export const svmlPackage = {+ format: "svml.node-package@1" as const,+ name: "@svml/provider-google-vertex",+ hostFacets: [googleVertexRuntimeAdapter],+};++export default svmlPackage;diff --git a/packages/provider-google-vertex/test/provider.test.ts b/packages/provider-google-vertex/test/provider.test.tsindex a656731e..59dd7041 100644--- a/packages/provider-google-vertex/test/provider.test.ts+++ b/packages/provider-google-vertex/test/provider.test.ts@@ -110,7 +110,6 @@ test("Vertex transports the exact model request while the model package validateassert.equal(result.value.kind, "inline");const plan = result.value.kind === "inline" ? result.value.value as Record<string, unknown> : {};assert.equal(plan.contract, "svml.caption-plan@1");- assert.equal(plan.planningRequestDigest, requestValue.requestDigest);assert.equal((result.metadata as Record<string, unknown>).provider, "google-vertex");});diff --git a/packages/provider-hyperframes-local/package.json b/packages/provider-hyperframes-local/package.jsonindex ea96a517..90345160 100644--- a/packages/provider-hyperframes-local/package.json+++ b/packages/provider-hyperframes-local/package.json@@ -6,12 +6,15 @@"exports": {".": "./src/index.ts"},+ "svml": { "activation": "./src/activation.ts" },"dependencies": {"@svml/contracts": "workspace:*","@svml/endpoint-kit": "workspace:*","@svml/hyperframes": "workspace:*","@svml/hyperframes-render": "workspace:*","@svml/protocol": "workspace:*",+ "@svml/runtime-adapter": "workspace:*",+ "@svml/runtime-adapter-node": "workspace:*","hyperframes": "0.7.84"},"devDependencies": {diff --git a/packages/provider-hyperframes-local/src/activation.ts b/packages/provider-hyperframes-local/src/activation.tsnew file mode 100644index 00000000..6c22eecb--- /dev/null+++ b/packages/provider-hyperframes-local/src/activation.ts@@ -0,0 +1,84 @@+import {+ createRuntimeEndpointAdapterFacet,+ runtimeConfigExact,+ runtimeConfigObject,+ runtimeConfigPositiveInteger,+ runtimeConfigString,+} from "@svml/runtime-adapter";+import {+ diagnoseRuntimeExecutable,+ resolveRuntimeExecutable,+} from "@svml/runtime-adapter-node";++import { createLocalHyperframesProvider } from "./provider.js";+import type { HyperframesBrowserGpu, HyperframesQuality, HyperframesWorkers } from "./provider.js";++const localHyperframesRuntimeAdapter = createRuntimeEndpointAdapterFacet({+ use: "@svml/provider-hyperframes-local",+ create(context) {+ const config = runtimeConfigObject(context.config, "local HyperFrames");+ runtimeConfigExact(config, [+ "nodePath", "hyperframesCliPath", "ffprobePath", "workers", "quality", "browserGpu",+ "defaultConcurrency", "processTimeoutMs", "maxProcessOutputBytes", "maxRenderedBytes",+ ], "local HyperFrames");+ const workers = config.workers;+ if (workers !== undefined && workers !== "auto") runtimeConfigPositiveInteger(workers, "HyperFrames workers");+ const quality = runtimeConfigString(config.quality, "HyperFrames quality");+ if (quality !== undefined && quality !== "draft" && quality !== "standard" && quality !== "high") {+ throw new Error("HyperFrames quality is invalid");+ }+ const browserGpu = runtimeConfigString(config.browserGpu, "HyperFrames browserGpu");+ if (browserGpu !== undefined && browserGpu !== "auto" && browserGpu !== "software" && browserGpu !== "hardware") {+ throw new Error("HyperFrames browserGpu is invalid");+ }+ const configuredNode = runtimeConfigString(config.nodePath, "HyperFrames nodePath");+ const configuredCli = runtimeConfigString(config.hyperframesCliPath, "HyperFrames hyperframesCliPath");+ const configuredFfprobe = runtimeConfigString(config.ffprobePath, "HyperFrames ffprobePath");+ const nodePath = configuredNode === undefined ? undefined : resolveRuntimeExecutable(context.root, configuredNode);+ const hyperframesCliPath = configuredCli === undefined ? undefined : resolveRuntimeExecutable(context.root, configuredCli);+ const ffprobePath = configuredFfprobe === undefined ? undefined : resolveRuntimeExecutable(context.root, configuredFfprobe);+ return createLocalHyperframesProvider({+ instance: context.instance,+ ...(context.lane === undefined ? {} : { lane: context.lane }),+ ...(nodePath === undefined ? {} : { nodePath }),+ ...(hyperframesCliPath === undefined ? {} : { hyperframesCliPath }),+ ...(ffprobePath === undefined ? {} : { ffprobePath }),+ ...(workers === undefined ? {} : { workers: workers as HyperframesWorkers }),+ ...(quality === undefined ? {} : { quality: quality as HyperframesQuality }),+ ...(browserGpu === undefined ? {} : { browserGpu: browserGpu as HyperframesBrowserGpu }),+ ...(runtimeConfigPositiveInteger(config.defaultConcurrency, "HyperFrames defaultConcurrency") === undefined+ ? {} : { defaultConcurrency: config.defaultConcurrency as number }),+ ...(runtimeConfigPositiveInteger(config.processTimeoutMs, "HyperFrames processTimeoutMs") === undefined+ ? {} : { processTimeoutMs: config.processTimeoutMs as number }),+ ...(runtimeConfigPositiveInteger(config.maxProcessOutputBytes, "HyperFrames maxProcessOutputBytes") === undefined+ ? {} : { maxProcessOutputBytes: config.maxProcessOutputBytes as number }),+ ...(runtimeConfigPositiveInteger(config.maxRenderedBytes, "HyperFrames maxRenderedBytes") === undefined+ ? {} : { maxRenderedBytes: config.maxRenderedBytes as number }),+ });+ },+ async doctor(context) {+ const config = runtimeConfigObject(context.config, "local HyperFrames");+ return [+ ...await diagnoseRuntimeExecutable({+ root: context.root,+ configured: runtimeConfigString(config.nodePath, "HyperFrames nodePath"),+ fallback: process.execPath,+ subject: "Node.js",+ }),+ ...await diagnoseRuntimeExecutable({+ root: context.root,+ configured: runtimeConfigString(config.ffprobePath, "HyperFrames ffprobePath"),+ fallback: "ffprobe",+ subject: "FFprobe",+ }),+ ];+ },+});++export const svmlPackage = {+ format: "svml.node-package@1" as const,+ name: "@svml/provider-hyperframes-local",+ hostFacets: [localHyperframesRuntimeAdapter],+};++export default svmlPackage;diff --git a/packages/provider-hyperframes-local/src/provider.ts b/packages/provider-hyperframes-local/src/provider.tsindex 8383aa81..8ef14fb3 100644--- a/packages/provider-hyperframes-local/src/provider.ts+++ b/packages/provider-hyperframes-local/src/provider.ts@@ -345,8 +345,6 @@ export function createLocalHyperframesProvider(config: CreateLocalHyperframesProconst artifact = await context.artifacts.put(await readFile(output), "video/mp4");const value: RenderedVisual = sealRenderedVisual({contract: "svml.rendered-visual@1",- renderInputDigest: document.digest,- programSpaceDigest: document.programSpaceDigest,frameRate: document.frameRate,frameCount: document.frameCount,canvas: document.canvas,diff --git a/packages/provider-hyperframes-local/test/provider.test.ts b/packages/provider-hyperframes-local/test/provider.test.tsindex 6d7851e8..fbfbdc6d 100644--- a/packages/provider-hyperframes-local/test/provider.test.ts+++ b/packages/provider-hyperframes-local/test/provider.test.ts@@ -33,7 +33,6 @@ function documentFixture() {contract: "svml.visual-track@1",visualIr: "svml.hyperframes-visual-ir@1",id: "provider-proof",- programSpaceDigest: programSpace.digest,presents: [{id: "card",span: { startFrame: 0, endFrameExclusive: 12 },@@ -71,10 +70,9 @@ function documentFixture() {return compileHyperframesDocument(sealComposition({contract: "svml.composition@1",id: "local-hyperframes-provider-proof",- programSpace,canvas: { width: 160, height: 96, clearColor: "#000000" },tracks: [track],- }));+ }), programSpace);}function requestNeed(): Need {@@ -148,7 +146,6 @@ test("local HyperFrames Provider really renders a silent frame-exact MP4 with paconst value: CanonicalValue = output.value.kind === "inline" ? output.value.value : canonicalize(null);verifyRenderedVisual(value);const visual = value as unknown as RenderedVisual;- assert.equal(visual.renderInputDigest, documentFixture().digest);assert.equal(visual.frameCount, 12);assert.deepEqual(visual.canvas, { width: 160, height: 96 });assert.equal(visual.muted, true);diff --git a/packages/provider-image-opencv-local/README.md b/packages/provider-image-opencv-local/README.mdnew file mode 100644index 00000000..0ab56578--- /dev/null+++ b/packages/provider-image-opencv-local/README.md@@ -0,0 +1,13 @@+# `@svml/provider-image-opencv-local`++Local OpenCV/NumPy realization of `@svml/image-transform`.++It reads one content-addressed image Artifact, runs the closed-data operation list in a bounded+child process and stores one new image Artifact. Temporary paths, OpenCV details and diagnostics+stay inside the Endpoint/Receipt and never enter the image Product.++The configured Python executable must provide `cv2` and `numpy`. The repository ships the locked+deployment environment in `services/image-opencv`; run+`uv sync --project services/image-opencv --frozen` once, then configure `pythonExecutable` as+`./services/image-opencv/.venv/bin/python`. Runtime admission and inner image work share the+configured Endpoint lane; no separate queue is hidden in this package.diff --git a/packages/provider-image-opencv-local/package.json b/packages/provider-image-opencv-local/package.jsonnew file mode 100644index 00000000..158dd047--- /dev/null+++ b/packages/provider-image-opencv-local/package.json@@ -0,0 +1,21 @@+{+ "name": "@svml/provider-image-opencv-local",+ "version": "0.0.0-dev",+ "private": true,+ "type": "module",+ "exports": {+ ".": "./src/index.ts"+ },+ "svml": { "activation": "./src/activation.ts" },+ "dependencies": {+ "@svml/artifact": "workspace:*",+ "@svml/endpoint-kit": "workspace:*",+ "@svml/image-transform": "workspace:*",+ "@svml/protocol": "workspace:*",+ "@svml/runtime-adapter": "workspace:*",+ "@svml/runtime-adapter-node": "workspace:*"+ },+ "devDependencies": {+ "@svml/driver-node": "workspace:*"+ }+}diff --git a/packages/provider-image-opencv-local/runtime/image_transform.py b/packages/provider-image-opencv-local/runtime/image_transform.pynew file mode 100644index 00000000..7b3e9d70--- /dev/null+++ b/packages/provider-image-opencv-local/runtime/image_transform.py@@ -0,0 +1,217 @@+#!/usr/bin/env python3+"""Bounded closed-data image transforms for @svml/provider-image-opencv-local."""++import json+import sys++import cv2+import numpy as np+++def color(value: str):+ raw = value[1:]+ red, green, blue = int(raw[0:2], 16), int(raw[2:4], 16), int(raw[4:6], 16)+ alpha = int(raw[6:8], 16) if len(raw) == 8 else 255+ return np.array([blue, green, red, alpha], dtype=np.float32)+++def split(image):+ if image.ndim == 2:+ return cv2.cvtColor(image, cv2.COLOR_GRAY2BGR), None+ if image.shape[2] == 4:+ return image[:, :, :3], image[:, :, 3]+ if image.shape[2] == 3:+ return image, None+ raise ValueError("unsupported image channel count")+++def join(bgr, alpha):+ return bgr if alpha is None else cv2.merge([bgr[:, :, 0], bgr[:, :, 1], bgr[:, :, 2], alpha])+++def flatten(image, background):+ bgr, alpha = split(image)+ if alpha is None:+ return bgr+ bg = color(background)[:3]+ weight = alpha.astype(np.float32)[:, :, None] / 255.0+ return np.rint(bgr.astype(np.float32) * weight + bg * (1.0 - weight)).clip(0, 255).astype(np.uint8)+++def crop(image, operation):+ height, width = image.shape[:2]+ if operation["unit"] == "fraction":+ x = int(round(operation["x"] * width))+ y = int(round(operation["y"] * height))+ out_width = int(round(operation["width"] * width))+ out_height = int(round(operation["height"] * height))+ else:+ x, y = int(operation["x"]), int(operation["y"])+ out_width, out_height = int(operation["width"]), int(operation["height"])+ if out_width < 1 or out_height < 1 or x < 0 or y < 0 or x + out_width > width or y + out_height > height:+ raise ValueError("crop lies outside the current image")+ return image[y:y + out_height, x:x + out_width].copy()+++def interpolation(name):+ return {+ "nearest": cv2.INTER_NEAREST,+ "linear": cv2.INTER_LINEAR,+ "cubic": cv2.INTER_CUBIC,+ "area": cv2.INTER_AREA,+ "lanczos": cv2.INTER_LANCZOS4,+ }[name]+++def resize(image, operation):+ target_width, target_height = int(operation["width"]), int(operation["height"])+ mode = operation["fit"]+ method = interpolation(operation["interpolation"])+ if mode == "stretch":+ return cv2.resize(image, (target_width, target_height), interpolation=method)+ height, width = image.shape[:2]+ scale = min(target_width / width, target_height / height) if mode == "contain" else max(+ target_width / width, target_height / height+ )+ scaled_width, scaled_height = max(1, int(round(width * scale))), max(1, int(round(height * scale)))+ scaled = cv2.resize(image, (scaled_width, scaled_height), interpolation=method)+ if mode == "cover":+ x = (scaled_width - target_width) // 2+ y = (scaled_height - target_height) // 2+ return scaled[y:y + target_height, x:x + target_width].copy()+ channels = 4 if scaled.ndim == 3 and scaled.shape[2] == 4 else 3+ default = "#00000000" if channels == 4 else "#000000"+ fill = color(operation.get("background", default))+ canvas = np.empty((target_height, target_width, channels), dtype=np.uint8)+ canvas[:] = fill[:channels]+ x = (target_width - scaled_width) // 2+ y = (target_height - scaled_height) // 2+ canvas[y:y + scaled_height, x:x + scaled_width] = scaled+ return canvas+++def denoise(image, operation):+ bgr, alpha = split(image)+ if bgr.shape[0] < 32 or bgr.shape[1] < 32:+ return image+ y, cr, cb = cv2.split(cv2.cvtColor(bgr, cv2.COLOR_BGR2YCrCb))+ template = int(operation["templateWindow"])+ search = int(operation["searchWindow"])+ y = cv2.fastNlMeansDenoising(y, None, float(operation["lumaStrength"]), template, search)+ cr = cv2.fastNlMeansDenoising(cr, None, float(operation["chromaStrength"]), template, search)+ cb = cv2.fastNlMeansDenoising(cb, None, float(operation["chromaStrength"]), template, search)+ out = cv2.cvtColor(cv2.merge([y, cr, cb]), cv2.COLOR_YCrCb2BGR).astype(np.float32)+ recovery = float(operation["saturationRecovery"])+ gray = (0.0722 * out[:, :, 0] + 0.7152 * out[:, :, 1] + 0.2126 * out[:, :, 2])[:, :, None]+ out = np.rint(gray + (out - gray) * recovery).clip(0, 255).astype(np.uint8)+ return join(out, alpha)+++def adjust_color(image, operation):+ bgr, alpha = split(image)+ out = bgr.astype(np.float32)+ out *= 2.0 ** float(operation["exposureStops"])+ out = (out - 127.5) * float(operation["contrast"]) + 127.5+ gray = (0.0722 * out[:, :, 0] + 0.7152 * out[:, :, 1] + 0.2126 * out[:, :, 2])[:, :, None]+ out = gray + (out - gray) * float(operation["saturation"])+ temperature = float(operation["temperature"]) * 32.0+ tint = float(operation["tint"]) * 32.0+ out[:, :, 2] += temperature+ out[:, :, 0] -= temperature+ out[:, :, 1] += tint+ gamma = float(operation["gamma"])+ out = 255.0 * np.power(np.clip(out, 0, 255) / 255.0, 1.0 / gamma)+ return join(np.rint(out).clip(0, 255).astype(np.uint8), alpha)+++def sharpen(image, operation):+ bgr, alpha = split(image)+ source = bgr.astype(np.float32)+ blurred = cv2.GaussianBlur(source, (0, 0), sigmaX=float(operation["radius"]))+ detail = source - blurred+ threshold = float(operation["threshold"])+ if threshold > 0:+ detail[np.max(np.abs(detail), axis=2) < threshold] = 0+ out = np.rint(source + detail * float(operation["amount"])).clip(0, 255).astype(np.uint8)+ return join(out, alpha)+++def blur(image, operation):+ bgr, alpha = split(image)+ out = cv2.GaussianBlur(bgr, (0, 0), sigmaX=float(operation["sigma"]))+ return join(out, alpha)+++def apply(image, operation):+ kind = operation["kind"]+ if kind == "crop":+ return crop(image, operation)+ if kind == "resize":+ return resize(image, operation)+ if kind == "rotate":+ return {90: cv2.rotate(image, cv2.ROTATE_90_CLOCKWISE),+ 180: cv2.rotate(image, cv2.ROTATE_180),+ 270: cv2.rotate(image, cv2.ROTATE_90_COUNTERCLOCKWISE)}[int(operation["degrees"])]+ if kind == "flip":+ return cv2.flip(image, {"horizontal": 1, "vertical": 0, "both": -1}[operation["axis"]])+ if kind == "denoise":+ return denoise(image, operation)+ if kind == "color":+ return adjust_color(image, operation)+ if kind == "sharpen":+ return sharpen(image, operation)+ if kind == "blur":+ return blur(image, operation)+ if kind == "alpha":+ return image if operation["mode"] == "preserve" else flatten(image, operation["background"])+ if kind == "encode":+ return image+ raise ValueError(f"unknown image operation {kind}")+++def transform(source, program):+ image = cv2.imdecode(np.frombuffer(source, np.uint8), cv2.IMREAD_UNCHANGED)+ if image is None:+ raise ValueError("image decode failed")+ for operation in program["operations"]:+ if operation["kind"] != "encode":+ image = apply(image, operation)+ encode = next((item for item in program["operations"] if item["kind"] == "encode"), {"format": "png"})+ output_format = encode["format"]+ parameters = []+ if output_format == "jpeg":+ if image.ndim == 3 and image.shape[2] == 4:+ if "background" not in encode:+ raise ValueError("JPEG encoding of alpha requires an explicit background")+ image = flatten(image, encode["background"])+ extension = ".jpg"+ parameters = [cv2.IMWRITE_JPEG_QUALITY, int(encode.get("quality", 95))]+ elif output_format == "webp":+ extension = ".webp"+ parameters = [cv2.IMWRITE_WEBP_QUALITY, int(encode.get("quality", 95))]+ else:+ extension = ".png"+ ok, encoded = cv2.imencode(extension, image, parameters)+ if not ok:+ raise ValueError("image encode failed")+ return encoded.tobytes()+++def main():+ if sys.argv[1:] == ["--self-test"]:+ print(json.dumps({"opencv": cv2.__version__, "numpy": np.__version__}))+ return+ if len(sys.argv) != 4:+ raise SystemExit("usage: image_transform.py <input> <program.json> <output>")+ input_path, program_path, output_path = sys.argv[1:]+ with open(input_path, "rb") as source_file:+ source = source_file.read()+ with open(program_path, "r", encoding="utf-8") as program_file:+ program = json.load(program_file)+ result = transform(source, program)+ with open(output_path, "wb") as output_file:+ output_file.write(result)+++if __name__ == "__main__":+ main()diff --git a/packages/provider-image-opencv-local/src/activation.ts b/packages/provider-image-opencv-local/src/activation.tsnew file mode 100644index 00000000..ee4602b8--- /dev/null+++ b/packages/provider-image-opencv-local/src/activation.ts@@ -0,0 +1,57 @@+import {+ createRuntimeEndpointAdapterFacet,+ runtimeConfigExact,+ runtimeConfigObject,+ runtimeConfigPositiveInteger,+ runtimeConfigString,+} from "@svml/runtime-adapter";+import {+ diagnoseRuntimeExecutable,+ resolveRuntimeExecutable,+} from "@svml/runtime-adapter-node";++import { createLocalOpenCvImageProvider } from "./provider.js";++const localOpenCvRuntimeAdapter = createRuntimeEndpointAdapterFacet({+ use: "@svml/provider-image-opencv-local",+ create(context) {+ const config = runtimeConfigObject(context.config, "local OpenCV image");+ runtimeConfigExact(config, [+ "pythonExecutable", "defaultConcurrency", "processTimeoutMs", "maxInputBytes", "maxOutputBytes",+ ], "local OpenCV image");+ const configuredPython = runtimeConfigString(config.pythonExecutable, "OpenCV pythonExecutable");+ const pythonExecutable = configuredPython === undefined+ ? undefined+ : resolveRuntimeExecutable(context.root, configuredPython);+ return createLocalOpenCvImageProvider({+ instance: context.instance,+ ...(context.lane === undefined ? {} : { lane: context.lane }),+ ...(pythonExecutable === undefined ? {} : { pythonExecutable }),+ ...(runtimeConfigPositiveInteger(config.defaultConcurrency, "OpenCV defaultConcurrency") === undefined+ ? {} : { defaultConcurrency: config.defaultConcurrency as number }),+ ...(runtimeConfigPositiveInteger(config.processTimeoutMs, "OpenCV processTimeoutMs") === undefined+ ? {} : { processTimeoutMs: config.processTimeoutMs as number }),+ ...(runtimeConfigPositiveInteger(config.maxInputBytes, "OpenCV maxInputBytes") === undefined+ ? {} : { maxInputBytes: config.maxInputBytes as number }),+ ...(runtimeConfigPositiveInteger(config.maxOutputBytes, "OpenCV maxOutputBytes") === undefined+ ? {} : { maxOutputBytes: config.maxOutputBytes as number }),+ });+ },+ async doctor(context) {+ const config = runtimeConfigObject(context.config, "local OpenCV image");+ return await diagnoseRuntimeExecutable({+ root: context.root,+ configured: runtimeConfigString(config.pythonExecutable, "OpenCV pythonExecutable"),+ fallback: "python3",+ subject: "OpenCV Python",+ });+ },+});++export const svmlPackage = {+ format: "svml.node-package@1" as const,+ name: "@svml/provider-image-opencv-local",+ hostFacets: [localOpenCvRuntimeAdapter],+};++export default svmlPackage;diff --git a/packages/provider-image-opencv-local/src/index.ts b/packages/provider-image-opencv-local/src/index.tsnew file mode 100644index 00000000..c110d994--- /dev/null+++ b/packages/provider-image-opencv-local/src/index.ts@@ -0,0 +1,6 @@+export {+ createLocalOpenCvImageProvider,+ localOpenCvImageProviderImplementationDigest,+ localOpenCvImageProviderModuleRef,+} from "./provider.js";+export type { CreateLocalOpenCvImageProviderOptions } from "./provider.js";diff --git a/packages/provider-image-opencv-local/src/provider.ts b/packages/provider-image-opencv-local/src/provider.tsnew file mode 100644index 00000000..25b7fe27--- /dev/null+++ b/packages/provider-image-opencv-local/src/provider.ts@@ -0,0 +1,169 @@+import { spawn } from "node:child_process";+import { mkdtemp, readFile, rm, stat, writeFile } from "node:fs/promises";+import { tmpdir } from "node:os";+import { join } from "node:path";+import { fileURLToPath } from "node:url";++import { artifactTypes } from "@svml/artifact";+import { defineEndpointPackage } from "@svml/endpoint-kit";+import type { EndpointFulfillment } from "@svml/endpoint-kit";+import {+ imageTransformCapabilities,+ verifyImageTransformProgram,+} from "@svml/image-transform";+import type { ImageTransformRequest } from "@svml/image-transform";+import type { ImageEncodeOperation } from "@svml/image-transform";+import { canonicalize, digestOf } from "@svml/protocol";+import type { CanonicalValue } from "@svml/protocol";++export const localOpenCvImageProviderModuleRef = {+ name: "@svml/provider-image-opencv-local",+ version: "0.0.0-dev",+} as const;+export const localOpenCvImageProviderImplementationDigest = digestOf(+ "@svml/provider-image-opencv-local/opencv@1",+);++export type CreateLocalOpenCvImageProviderOptions = {+ readonly instance?: string;+ readonly lane?: string;+ readonly pythonExecutable?: string;+ readonly processTimeoutMs?: number;+ readonly maxInputBytes?: number;+ readonly maxOutputBytes?: number;+ readonly defaultConcurrency?: number;+};++function assert(condition: unknown, message: string): asserts condition {+ if (!condition) throw new Error(message);+}++function positiveInteger(value: number, subject: string): number {+ assert(Number.isSafeInteger(value) && value > 0, `${subject} must be a positive integer`);+ return value;+}++function request(value: CanonicalValue): ImageTransformRequest {+ assert(value !== null && typeof value === "object" && !Array.isArray(value),+ "Image transform request must be an object");+ const item = value as unknown as ImageTransformRequest;+ assert(item.contract === "svml.image-transform-request@1"+ && item.source?.kind === "blob"+ && item.source.mediaType.startsWith("image/"),+ "Image transform request is invalid");+ verifyImageTransformProgram(item.program);+ return item;+}++function outputMediaType(program: ImageTransformRequest["program"]): string {+ const format = program.operations.find((operation): operation is ImageEncodeOperation =>+ operation.kind === "encode")?.format ?? "png";+ return format === "jpeg" ? "image/jpeg" : format === "webp" ? "image/webp" : "image/png";+}++async function runProcess(options: {+ readonly executable: string;+ readonly args: readonly string[];+ readonly timeoutMs: number;+ readonly maxStderrBytes: number;+}): Promise<void> {+ await new Promise<void>((resolve, reject) => {+ const child = spawn(options.executable, [...options.args], { shell: false, stdio: ["ignore", "ignore", "pipe"] });+ let stderrBytes = 0;+ const stderr: Buffer[] = [];+ let failed: Error | undefined;+ const fail = (error: Error): void => {+ failed ??= error;+ child.kill("SIGKILL");+ };+ const timer = setTimeout(() => fail(new Error(`OpenCV image transform exceeded ${options.timeoutMs}ms`)),+ options.timeoutMs);+ child.stderr.on("data", (chunk: Buffer) => {+ stderrBytes += chunk.byteLength;+ if (stderrBytes > options.maxStderrBytes) {+ fail(new Error("OpenCV image transform stderr exceeded its limit"));+ return;+ }+ stderr.push(chunk);+ });+ child.on("error", fail);+ child.on("close", (code, signal) => {+ clearTimeout(timer);+ if (failed !== undefined) reject(failed);+ else if (code !== 0) {+ const detail = Buffer.concat(stderr).toString("utf8").trim();+ reject(new Error(`OpenCV image transform exited with ${code ?? `signal ${signal ?? "unknown"}`}`+ + (detail.length === 0 ? "" : `: ${detail}`)));+ }+ else resolve();+ });+ });+}++export function createLocalOpenCvImageProvider(config: CreateLocalOpenCvImageProviderOptions = {}) {+ const pythonExecutable = config.pythonExecutable ?? "python3";+ const processTimeoutMs = positiveInteger(config.processTimeoutMs ?? 5 * 60_000, "processTimeoutMs");+ const maxInputBytes = positiveInteger(config.maxInputBytes ?? 128 * 1024 * 1024, "maxInputBytes");+ const maxOutputBytes = positiveInteger(config.maxOutputBytes ?? 256 * 1024 * 1024, "maxOutputBytes");+ const script = fileURLToPath(new URL("../runtime/image_transform.py", import.meta.url));+ return defineEndpointPackage({+ module: localOpenCvImageProviderModuleRef,+ facet: "image-transform",+ instance: config.instance ?? "image.opencv.local",+ ...(config.lane === undefined ? {} : { lane: config.lane }),+ implementation: {+ locator: "@svml/provider-image-opencv-local/opencv",+ digest: localOpenCvImageProviderImplementationDigest,+ },+ permissions: ["process:image"],+ configuration: canonicalize({ pythonExecutable, processTimeoutMs, maxInputBytes, maxOutputBytes }),+ defaultConcurrency: config.defaultConcurrency ?? 1,+ capabilities: [{+ lifecycle: "immediate" as const,+ capability: imageTransformCapabilities.transform,+ returns: artifactTypes.blob,+ supports: (need) => {+ try {+ request(need.constraints);+ return true;+ } catch {+ return false;+ }+ },+ handler: async (context): Promise<EndpointFulfillment> => {+ const need = request(context.need.constraints);+ assert(need.source.size <= maxInputBytes, "Image transform input exceeds its configured byte limit");+ const bytes = await context.artifacts.get(need.source.digest);+ assert(bytes !== undefined, `Image transform source Artifact ${need.source.digest} is unavailable`);+ assert(bytes.byteLength === need.source.size, "Image transform source size differs from its BlobRef");+ const work = await mkdtemp(join(tmpdir(), "svml-image-opencv-"));+ try {+ const input = join(work, "input.bin");+ const program = join(work, "program.json");+ const output = join(work, "output.bin");+ await writeFile(input, bytes);+ await writeFile(program, JSON.stringify(need.program), "utf8");+ await runProcess({+ executable: pythonExecutable,+ args: [script, input, program, output],+ timeoutMs: processTimeoutMs,+ maxStderrBytes: 256 * 1024,+ });+ const info = await stat(output);+ assert(info.isFile() && info.size > 0 && info.size <= maxOutputBytes,+ "OpenCV image transform produced an invalid output size");+ const mediaType = outputMediaType(need.program);+ const artifact = await context.artifacts.put(await readFile(output), mediaType);+ return {+ value: artifact,+ conformance: "exact",+ delivery: "executed",+ metadata: canonicalize({ provider: "opencv.local", operation: "image-transform" }),+ };+ } finally {+ await rm(work, { recursive: true, force: true }).catch(() => {});+ }+ },+ }],+ });+}diff --git a/packages/provider-image-opencv-local/test/provider.test.ts b/packages/provider-image-opencv-local/test/provider.test.tsnew file mode 100644index 00000000..04eb02d0--- /dev/null+++ b/packages/provider-image-opencv-local/test/provider.test.ts@@ -0,0 +1,102 @@+import assert from "node:assert/strict";+import { spawnSync } from "node:child_process";+import test from "node:test";++import { artifactTypes } from "@svml/artifact";+import { EndpointRegistry, MemoryArtifactStore } from "@svml/driver-node";+import {+ gptImageDenoiseV1,+ imageTransformCapabilities,+ sealImageTransformProgram,+} from "@svml/image-transform";+import type { ImageTransformProgram } from "@svml/image-transform";+import {+ createLocalOpenCvImageProvider,+ localOpenCvImageProviderModuleRef,+} from "@svml/provider-image-opencv-local";+import { canonicalize, digestOf } from "@svml/protocol";+import type { BlobRef, Need } from "@svml/protocol";++function need(source: BlobRef, program: ImageTransformProgram = gptImageDenoiseV1): Need {+ const constraints = canonicalize({+ contract: "svml.image-transform-request@1",+ source,+ program,+ });+ return {+ id: "need:image-transform",+ capability: imageTransformCapabilities.transform,+ returns: artifactTypes.blob,+ constraints,+ requestedBy: "derivation:image-transform",+ result: "record:image-transform",+ accepts: "exact",+ conformanceFloor: "exact",+ requestDigest: digestOf({+ capability: imageTransformCapabilities.transform,+ returns: artifactTypes.blob,+ constraints,+ }),+ };+}++test("the OpenCV package is one replaceable Endpoint with no second queue", async () => {+ const provider = createLocalOpenCvImageProvider({ defaultConcurrency: 3 });+ assert.equal(provider.name, "image.opencv.local");+ const facet = provider.manifest.facets[0];+ assert(facet?.role === "capability-endpoint");+ assert.deepEqual(facet.permissions, ["process:image"]);+ assert.equal(facet.defaultConcurrency, 3);+ assert.deepEqual(provider.bindings, [{+ capability: imageTransformCapabilities.transform,+ returns: artifactTypes.blob,+ endpoint: "image.opencv.local",+ }]);+ assert.equal(provider.manifest.name, localOpenCvImageProviderModuleRef.name);+});++const liveEnabled = process.env.SVML_OPENCV_TESTS === "1";+const openCvPython = process.env.SVML_OPENCV_PYTHON ?? "python3";+const hasOpenCv = spawnSync(openCvPython, ["-c", "import cv2, numpy"], { stdio: "ignore" }).status === 0;++test("the local Provider returns only a new image BlobArtifact", {+ skip: !liveEnabled || !hasOpenCv,+}, async () => {+ const artifacts = new MemoryArtifactStore();+ const png = Buffer.from(+ "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mNk+A8AAQUBAScY42YAAAAASUVORK5CYII=",+ "base64",+ );+ const source = await artifacts.put(png, "image/png");+ const program = sealImageTransformProgram({+ contract: "svml.image-transform-program@1",+ operations: [{+ kind: "resize",+ width: 64,+ height: 64,+ fit: "stretch",+ interpolation: "nearest",+ }, ...gptImageDenoiseV1.operations],+ });+ const request = need(source, program);+ const registry = new EndpointRegistry();+ await createLocalOpenCvImageProvider({ pythonExecutable: openCvPython }).install(registry);+ const resolution = registry.resolve(request);+ assert.equal(resolution.status, "resolved");+ assert.equal(resolution.registration.kind, "immediate");+ const result = await resolution.registration.handler({+ command: { kind: "fulfill-need", id: "command:image-transform", need: request },+ need: request,+ artifacts,+ credentials: {},+ });+ assert.equal(result.value.kind, "blob");+ assert.equal(result.value.mediaType, "image/png");+ assert.equal(await artifacts.has(result.value.digest), true);+ assert.deepEqual(Object.keys(result.value).sort(), ["digest", "kind", "mediaType", "size"]);+ const output = await artifacts.get(result.value.digest);+ assert(output !== undefined);+ const encoded = Buffer.from(output);+ assert.equal(encoded.readUInt32BE(16), 64);+ assert.equal(encoded.readUInt32BE(20), 64);+});diff --git a/packages/provider-kie/package.json b/packages/provider-kie/package.jsonindex c06782e0..5a23b1ca 100644--- a/packages/provider-kie/package.json+++ b/packages/provider-kie/package.json@@ -6,6 +6,7 @@"exports": {".": "./src/index.ts"},+ "svml": { "activation": "./src/activation.ts" },"dependencies": {"@svml/endpoint-kit": "workspace:*","@svml/gemini-omni": "workspace:*",@@ -16,6 +17,8 @@"@svml/nano-banana": "workspace:*","@svml/protocol": "workspace:*","@svml/runtime": "workspace:*",+ "@svml/runtime-adapter": "workspace:*",+ "@svml/runtime-adapter-node": "workspace:*","@svml/seedance": "workspace:*","@svml/seedream": "workspace:*"},diff --git a/packages/provider-kie/src/activation.ts b/packages/provider-kie/src/activation.tsnew file mode 100644index 00000000..fc489de3--- /dev/null+++ b/packages/provider-kie/src/activation.ts@@ -0,0 +1,57 @@+import { credentialRef } from "@svml/runtime";+import {+ createRuntimeEndpointAdapterFacet,+ runtimeConfigExact,+ runtimeConfigObject,+ runtimeConfigPositiveInteger,+ runtimeConfigString,+} from "@svml/runtime-adapter";+import { diagnoseRuntimeEnvironmentCredential } from "@svml/runtime-adapter-node";++import { createKieProvider } from "./provider.js";++const kieRuntimeAdapter = createRuntimeEndpointAdapterFacet({+ use: "@svml/provider-kie",+ create(context) {+ const config = runtimeConfigObject(context.config, "KIE");+ runtimeConfigExact(config, [+ "apiBaseUrl", "uploadBaseUrl", "apiKeyEnv", "defaultConcurrency", "pollIntervalMs",+ "submissionIntervalMs", "requestTimeoutMs", "maxOperationMs", "maxArtifactBytes",+ ], "KIE");+ const apiKeyEnv = runtimeConfigString(config.apiKeyEnv, "KIE apiKeyEnv");+ return createKieProvider({+ instance: context.instance,+ ...(context.lane === undefined ? {} : { lane: context.lane }),+ ...(runtimeConfigString(config.apiBaseUrl, "KIE apiBaseUrl") === undefined+ ? {} : { apiBaseUrl: config.apiBaseUrl as string }),+ ...(runtimeConfigString(config.uploadBaseUrl, "KIE uploadBaseUrl") === undefined+ ? {} : { uploadBaseUrl: config.uploadBaseUrl as string }),+ ...(apiKeyEnv === undefined ? {} : { apiKey: credentialRef("env", apiKeyEnv) }),+ ...(runtimeConfigPositiveInteger(config.defaultConcurrency, "KIE defaultConcurrency") === undefined+ ? {} : { defaultConcurrency: config.defaultConcurrency as number }),+ ...(runtimeConfigPositiveInteger(config.pollIntervalMs, "KIE pollIntervalMs") === undefined+ ? {} : { pollIntervalMs: config.pollIntervalMs as number }),+ ...(runtimeConfigPositiveInteger(config.submissionIntervalMs, "KIE submissionIntervalMs") === undefined+ ? {} : { submissionIntervalMs: config.submissionIntervalMs as number }),+ ...(runtimeConfigPositiveInteger(config.requestTimeoutMs, "KIE requestTimeoutMs") === undefined+ ? {} : { requestTimeoutMs: config.requestTimeoutMs as number }),+ ...(runtimeConfigPositiveInteger(config.maxOperationMs, "KIE maxOperationMs") === undefined+ ? {} : { maxOperationMs: config.maxOperationMs as number }),+ ...(runtimeConfigPositiveInteger(config.maxArtifactBytes, "KIE maxArtifactBytes") === undefined+ ? {} : { maxArtifactBytes: config.maxArtifactBytes as number }),+ });+ },+ doctor(context) {+ const config = runtimeConfigObject(context.config, "KIE");+ const apiKeyEnv = runtimeConfigString(config.apiKeyEnv, "KIE apiKeyEnv") ?? "KIE_API_KEY";+ return diagnoseRuntimeEnvironmentCredential(apiKeyEnv, "KIE");+ },+});++export const svmlPackage = {+ format: "svml.node-package@1" as const,+ name: "@svml/provider-kie",+ hostFacets: [kieRuntimeAdapter],+};++export default svmlPackage;diff --git a/packages/provider-kie/src/provider.ts b/packages/provider-kie/src/provider.tsindex de069242..c363a95f 100644--- a/packages/provider-kie/src/provider.ts+++ b/packages/provider-kie/src/provider.ts@@ -112,11 +112,7 @@ function object(value: unknown, subject: string): Record<string, unknown> {}function contentRequestDigest(value: unknown): Digest {- const request = object(value, "KIE request");- if (typeof request.requestDigest !== "string" || !isDigest(request.requestDigest)) {- throw new KieError("KIE_INVALID_REQUEST", "KIE request has no valid content digest");- }- return request.requestDigest;+ return digestOf(object(value, "KIE request"));}function secret(context: EndpointStartContext | EndpointResumeContext): string {diff --git a/packages/provider-kie/test/models.test.ts b/packages/provider-kie/test/models.test.tsindex 6d58b407..d2252f13 100644--- a/packages/provider-kie/test/models.test.ts+++ b/packages/provider-kie/test/models.test.ts@@ -122,7 +122,7 @@ test("Seedream safety policy is explicit author content and contributes to requensfwCheck: true,});assert.equal(unchecked.nsfwCheck, false);- assert.notEqual(unchecked.requestDigest, checked.requestDigest);+ assert.notEqual(digestOf(unchecked), digestOf(checked));});test("all sixteen exact capabilities translate to their documented KIE model slug", async () => {diff --git a/packages/provider-media-local/package.json b/packages/provider-media-local/package.jsonindex 3dc6f29a..e5fcd01d 100644--- a/packages/provider-media-local/package.json+++ b/packages/provider-media-local/package.json@@ -6,11 +6,14 @@"exports": {".": "./src/index.ts"},+ "svml": { "activation": "./src/activation.ts" },"dependencies": {"@svml/contracts": "workspace:*","@svml/endpoint-kit": "workspace:*","@svml/media-pipeline": "workspace:*",- "@svml/protocol": "workspace:*"+ "@svml/protocol": "workspace:*",+ "@svml/runtime-adapter": "workspace:*",+ "@svml/runtime-adapter-node": "workspace:*"},"devDependencies": {"@svml/artifact-store-fs": "workspace:*",diff --git a/packages/provider-media-local/src/activation.ts b/packages/provider-media-local/src/activation.tsnew file mode 100644index 00000000..16621a58--- /dev/null+++ b/packages/provider-media-local/src/activation.ts@@ -0,0 +1,64 @@+import {+ createRuntimeEndpointAdapterFacet,+ runtimeConfigExact,+ runtimeConfigObject,+ runtimeConfigPositiveInteger,+ runtimeConfigString,+} from "@svml/runtime-adapter";+import {+ diagnoseRuntimeExecutable,+ resolveRuntimeExecutable,+} from "@svml/runtime-adapter-node";++import { createLocalMediaProvider } from "./provider.js";++const localMediaRuntimeAdapter = createRuntimeEndpointAdapterFacet({+ use: "@svml/provider-media-local",+ create(context) {+ const config = runtimeConfigObject(context.config, "local media");+ runtimeConfigExact(config, [+ "ffmpegPath", "ffprobePath", "defaultConcurrency", "processTimeoutMs", "maxProbeOutputBytes",+ ], "local media");+ const configuredFfmpeg = runtimeConfigString(config.ffmpegPath, "media ffmpegPath");+ const configuredFfprobe = runtimeConfigString(config.ffprobePath, "media ffprobePath");+ const ffmpegPath = configuredFfmpeg === undefined ? undefined : resolveRuntimeExecutable(context.root, configuredFfmpeg);+ const ffprobePath = configuredFfprobe === undefined ? undefined : resolveRuntimeExecutable(context.root, configuredFfprobe);+ return createLocalMediaProvider({+ instance: context.instance,+ ...(context.lane === undefined ? {} : { lane: context.lane }),+ ...(ffmpegPath === undefined ? {} : { ffmpegPath }),+ ...(ffprobePath === undefined ? {} : { ffprobePath }),+ ...(runtimeConfigPositiveInteger(config.defaultConcurrency, "media defaultConcurrency") === undefined+ ? {} : { defaultConcurrency: config.defaultConcurrency as number }),+ ...(runtimeConfigPositiveInteger(config.processTimeoutMs, "media processTimeoutMs") === undefined+ ? {} : { processTimeoutMs: config.processTimeoutMs as number }),+ ...(runtimeConfigPositiveInteger(config.maxProbeOutputBytes, "media maxProbeOutputBytes") === undefined+ ? {} : { maxProbeOutputBytes: config.maxProbeOutputBytes as number }),+ });+ },+ async doctor(context) {+ const config = runtimeConfigObject(context.config, "local media");+ return [+ ...await diagnoseRuntimeExecutable({+ root: context.root,+ configured: runtimeConfigString(config.ffmpegPath, "media ffmpegPath"),+ fallback: "ffmpeg",+ subject: "FFmpeg",+ }),+ ...await diagnoseRuntimeExecutable({+ root: context.root,+ configured: runtimeConfigString(config.ffprobePath, "media ffprobePath"),+ fallback: "ffprobe",+ subject: "FFprobe",+ }),+ ];+ },+});++export const svmlPackage = {+ format: "svml.node-package@1" as const,+ name: "@svml/provider-media-local",+ hostFacets: [localMediaRuntimeAdapter],+};++export default svmlPackage;diff --git a/packages/provider-media-local/src/probe.ts b/packages/provider-media-local/src/probe.tsindex 5f32679f..dccbe698 100644--- a/packages/provider-media-local/src/probe.ts+++ b/packages/provider-media-local/src/probe.ts@@ -278,12 +278,7 @@ export function parseMediaInspection(args: {: ["unknown"];return sealMediaInspection({contract: "svml.media-inspection@1",- source: args.source,container: { formatNames: formatNames.length === 0 ? ["unknown"] : formatNames },streams: parsed.sort((left, right) => left.index - right.index),- probe: {- algorithm: "ffprobe-decoded-units-json@1",- implementation: args.ffprobeVersion,- },});}diff --git a/packages/provider-media-local/src/provider.ts b/packages/provider-media-local/src/provider.tsindex 931cd2f5..0ad889d5 100644--- a/packages/provider-media-local/src/provider.ts+++ b/packages/provider-media-local/src/provider.ts@@ -351,7 +351,6 @@ function normalizeNeed(value: CanonicalValue): NormalizeMediaNeed {"NormalizeMediaNeed is invalid");verifyMediaInspection(item.inspection);verifyMediaStreamSelection(item.selection);- assert(item.inspection.source.digest === item.source.digest, "NormalizeMediaNeed source is invalid");assert(item.audio.sampleRate === 48_000 && item.audio.channels === 2&& item.audio.codec === "pcm_s16le" && item.audio.loudness === "preserve","NormalizeMediaNeed audio profile is unsupported");@@ -384,8 +383,6 @@ function muxMediaNeed(value: CanonicalValue): MuxMediaNeed {assert(item.contract === "svml.mux-media-request@1", "MuxMediaNeed is invalid");verifyRenderedVisual(item.visual);verifyTimelineAudio(item.audio);- assert(item.visual.programSpaceDigest === item.audio.programSpaceDigest,- "MuxMediaNeed inputs belong to different ProgramSpaces");const expectedSamples = roundPositive(BigInt(item.visual.frameCount) * 48_000n * BigInt(item.visual.frameRate.denominator),BigInt(item.visual.frameRate.numerator),@@ -507,7 +504,6 @@ export function createLocalMediaProvider(config: CreateLocalMediaProviderOptionstry {const input = join(work, "source.bin");await writeFile(input, await sourceBytes(context, need.source));- const ffmpegVersion = await version(ffmpegPath, processTimeoutMs);let visualArtifact: BlobRef | undefined;let visualWidth: number | undefined;let visualHeight: number | undefined;@@ -617,10 +613,6 @@ export function createLocalMediaProvider(config: CreateLocalMediaProviderOptionsloudness: "preserved" as const,},}),- normalization: {- algorithm: "shared-presentation-origin@1",- implementation: `${ffmpegVersion};${need.inspection.probe.implementation}`,- },});return result(canonicalize(media), canonicalize({ provider: "media.local", operation: "normalize",visual: visualArtifact !== undefined, audio: audioArtifact !== undefined }));@@ -650,7 +642,6 @@ export function createLocalMediaProvider(config: CreateLocalMediaProviderOptions});assert(source.decodedSampleFrames === need.sourceSampleFrames,"Speech master sample count differs from its ProgramSpace");- const ffmpegVersion = await version(ffmpegPath, processTimeoutMs);const filter = ["asetpts=N/SR/TB","aresample=16000:async=0:first_pts=0",@@ -683,8 +674,6 @@ export function createLocalMediaProvider(config: CreateLocalMediaProviderOptionsconst artifact = await context.artifacts.put(await readFile(output), "audio/wav");const evidence: SpeechEvidenceAudio = sealSpeechEvidenceAudio({contract: "svml.speech-evidence-audio@1",- programSpaceDigest: need.programSpaceDigest,- sourceAudioArtifactDigest: need.source.digest,artifact,codec: "pcm_s16le",sampleRate: 16_000,@@ -700,7 +689,6 @@ export function createLocalMediaProvider(config: CreateLocalMediaProviderOptionsevidenceSampleFrames: need.evidenceSampleFrames,sourceOriginSample: 0,evidenceOriginSample: 0,- resamplerImplementation: ffmpegVersion,},});assertSpeechEvidenceAudioIdentity(evidence);@@ -783,8 +771,6 @@ export function createLocalMediaProvider(config: CreateLocalMediaProviderOptions"Rendered TimelineAudio sample count differs from its plan");const value: TimelineAudio = sealTimelineAudio({contract: "svml.timeline-audio@1",- planDigest: plan.planDigest,- programSpaceDigest: plan.programSpaceDigest,artifact,codec: "pcm_s16le",sampleRate: 48_000,@@ -883,9 +869,6 @@ export function createLocalMediaProvider(config: CreateLocalMediaProviderOptionsconst artifact = await context.artifacts.put(await readFile(output), "video/mp4");const value: MuxedMedia = sealMuxedMedia({contract: "svml.muxed-media@1",- visualDigest: need.visual.visualDigest,- audioDigest: need.audio.audioDigest,- programSpaceDigest: need.visual.programSpaceDigest,frameRate: need.visual.frameRate,frameCount: need.visual.frameCount,canvas: need.visual.canvas,diff --git a/packages/provider-media-local/test/provider.test.ts b/packages/provider-media-local/test/provider.test.tsindex 5ed896d1..0fd28771 100644--- a/packages/provider-media-local/test/provider.test.ts+++ b/packages/provider-media-local/test/provider.test.ts@@ -268,7 +268,6 @@ test("local media Provider derives one exact 16 kHz mono WhisperX evidence artifconst source = await artifacts.put(await readFile(sourcePath), "audio/wav");const constraints = canonicalize({contract: "svml.project-speech-evidence-audio-request@1",- programSpaceDigest: digestOf("evidence:program-space"),source,sourceSampleRate: 48_000,sourceChannels: 2,@@ -294,7 +293,6 @@ test("local media Provider derives one exact 16 kHz mono WhisperX evidence artifconst value = await fulfillInline(artifacts, request);assertSpeechEvidenceAudioIdentity(value as unknown as SpeechEvidenceAudio);const evidence = value as unknown as SpeechEvidenceAudio;- assert.equal(evidence.sourceAudioArtifactDigest, source.digest);assert.equal(evidence.sampleMap.sourceSampleFrames, 48_001);assert.equal(evidence.sampleMap.evidenceSampleFrames, 16_000);assert.equal(evidence.sampleMap.sourceOriginSample, 0);@@ -439,10 +437,8 @@ test("local media Provider renders one frame-domain audio plan and muxes exactlyartifacts.put(await readFile(secondPath), "audio/wav"),artifacts.put(await readFile(visualPath), "video/mp4"),]);- const programSpaceDigest = digestOf("provider-media-local:one-second-program");const plan = sealAudioProgramPlan({contract: "svml.audio-program-plan@1",- programSpaceDigest,frameRate: { numerator: 30, denominator: 1 },frameCount: 30,sampleRate: 48_000,@@ -489,8 +485,6 @@ test("local media Provider renders one frame-domain audio plan and muxes exactlyconst visual = sealRenderedVisual({contract: "svml.rendered-visual@1",- renderInputDigest: digestOf("provider-media-local:visual-program"),- programSpaceDigest,frameRate: { numerator: 30, denominator: 1 },frameCount: 30,canvas: { width: 160, height: 96 },diff --git a/packages/provider-whisperx-local/package.json b/packages/provider-whisperx-local/package.jsonindex 31969d4e..d65a55a3 100644--- a/packages/provider-whisperx-local/package.json+++ b/packages/provider-whisperx-local/package.json@@ -6,11 +6,13 @@"exports": {".": "./src/index.ts"},+ "svml": { "activation": "./src/activation.ts" },"dependencies": {"@svml/contracts": "workspace:*","@svml/endpoint-kit": "workspace:*","@svml/protocol": "workspace:*",- "@svml/whisperx": "workspace:*"+ "@svml/whisperx": "workspace:*",+ "@svml/runtime-adapter": "workspace:*"},"devDependencies": {"@svml/driver-node": "workspace:*"diff --git a/packages/provider-whisperx-local/src/activation.ts b/packages/provider-whisperx-local/src/activation.tsnew file mode 100644index 00000000..bb623529--- /dev/null+++ b/packages/provider-whisperx-local/src/activation.ts@@ -0,0 +1,55 @@+import {+ createRuntimeEndpointAdapterFacet,+ runtimeConfigExact,+ runtimeConfigObject,+ runtimeConfigPositiveInteger,+ runtimeConfigString,+} from "@svml/runtime-adapter";++import { createLocalWhisperXProvider } from "./provider.js";++const localWhisperXRuntimeAdapter = createRuntimeEndpointAdapterFacet({+ use: "@svml/provider-whisperx-local",+ create(context) {+ const config = runtimeConfigObject(context.config, "local WhisperX");+ runtimeConfigExact(config, [+ "baseUrl", "expectedModel", "expectedDevice", "expectedCompute", "expectedBatchSize",+ "expectedServiceVersion", "expectedWhisperXVersion", "expectedPunktTabDigest",+ "defaultConcurrency", "requestTimeoutMs", "maxResponseBytes",+ ], "local WhisperX");+ return createLocalWhisperXProvider({+ instance: context.instance,+ ...(context.lane === undefined ? {} : { lane: context.lane }),+ ...(runtimeConfigString(config.baseUrl, "WhisperX baseUrl") === undefined+ ? {} : { baseUrl: config.baseUrl as string }),+ ...(runtimeConfigString(config.expectedModel, "WhisperX expectedModel") === undefined+ ? {} : { expectedModel: config.expectedModel as string }),+ ...(runtimeConfigString(config.expectedDevice, "WhisperX expectedDevice") === undefined+ ? {} : { expectedDevice: config.expectedDevice as string }),+ ...(runtimeConfigString(config.expectedCompute, "WhisperX expectedCompute") === undefined+ ? {} : { expectedCompute: config.expectedCompute as string }),+ ...(runtimeConfigPositiveInteger(config.expectedBatchSize, "WhisperX expectedBatchSize") === undefined+ ? {} : { expectedBatchSize: config.expectedBatchSize as number }),+ ...(runtimeConfigString(config.expectedServiceVersion, "WhisperX expectedServiceVersion") === undefined+ ? {} : { expectedServiceVersion: config.expectedServiceVersion as string }),+ ...(runtimeConfigString(config.expectedWhisperXVersion, "WhisperX expectedWhisperXVersion") === undefined+ ? {} : { expectedWhisperXVersion: config.expectedWhisperXVersion as string }),+ ...(runtimeConfigString(config.expectedPunktTabDigest, "WhisperX expectedPunktTabDigest") === undefined+ ? {} : { expectedPunktTabDigest: config.expectedPunktTabDigest as string }),+ ...(runtimeConfigPositiveInteger(config.defaultConcurrency, "WhisperX defaultConcurrency") === undefined+ ? {} : { defaultConcurrency: config.defaultConcurrency as number }),+ ...(runtimeConfigPositiveInteger(config.requestTimeoutMs, "WhisperX requestTimeoutMs") === undefined+ ? {} : { requestTimeoutMs: config.requestTimeoutMs as number }),+ ...(runtimeConfigPositiveInteger(config.maxResponseBytes, "WhisperX maxResponseBytes") === undefined+ ? {} : { maxResponseBytes: config.maxResponseBytes as number }),+ });+ },+});++export const svmlPackage = {+ format: "svml.node-package@1" as const,+ name: "@svml/provider-whisperx-local",+ hostFacets: [localWhisperXRuntimeAdapter],+};++export default svmlPackage;diff --git a/packages/provider-whisperx-local/src/provider.ts b/packages/provider-whisperx-local/src/provider.tsindex bfa3a4ff..93b4ed87 100644--- a/packages/provider-whisperx-local/src/provider.ts+++ b/packages/provider-whisperx-local/src/provider.ts@@ -337,9 +337,6 @@ export function createLocalWhisperXProvider(config: CreateLocalWhisperXProviderOconst rawArtifact = await context.artifacts.put(raw.bytes, "application/json");const evidence: WhisperXAlignmentEvidence = sealWhisperXAlignmentEvidence({contract: "svml.whisperx-alignment-evidence@2",- engine: "whisperx",- audioArtifactDigest: request.audio.digest,- programSpaceDigest: request.programSpaceDigest,durationSec: request.durationSec,segments,});diff --git a/packages/provider-whisperx-local/test/provider.test.ts b/packages/provider-whisperx-local/test/provider.test.tsindex ee22034a..23f1ed97 100644--- a/packages/provider-whisperx-local/test/provider.test.ts+++ b/packages/provider-whisperx-local/test/provider.test.ts@@ -136,8 +136,6 @@ test("local Provider stages canonical evidence bytes unchanged and binds sidecarconst artifact = await artifacts.put(expected, "audio/wav");const evidenceAudio = sealSpeechEvidenceAudio({contract: "svml.speech-evidence-audio@1",- programSpaceDigest: digestOf("loopback:program"),- sourceAudioArtifactDigest: digestOf("loopback:speech-master"),artifact,codec: "pcm_s16le",sampleRate: 16_000,@@ -153,7 +151,6 @@ test("local Provider stages canonical evidence bytes unchanged and binds sidecarevidenceSampleFrames: 32_000,sourceOriginSample: 0,evidenceOriginSample: 0,- resamplerImplementation: "fixture",},});const constraints = whisperXRequestForEvidenceAudio(evidenceAudio, { language: "en" });diff --git a/packages/realization/README.md b/packages/realization/README.mdindex 041a41b0..79aad24c 100644--- a/packages/realization/README.md+++ b/packages/realization/README.md@@ -18,12 +18,12 @@ not mutate Core state or require a database.`createBuildRecordCandidate()` is a Host convenience for this common case. It verifies the completeprior `BuildState` only to extract a trusted typed Record, its type-validation receipt and optionalprovenance. It returns an independent zero-input Candidate; the caller may use a substitute-Satisfaction to map it to any compatible Logical Output. The previous author Graph, prompt, semantic inputs and affinity are not-compatibility evidence and are not compared. No historical Operation, Command or outstanding work-is copied into the new Build.+Satisfaction to map it to any compatible Logical Output. The previous Author Graph, prompt and+semantic inputs are not compatibility evidence and are not compared. No historical Operation,+Command or outstanding work is copied into the new Build.The same model covers an uploaded video, a fixed black clip and any other already materializedvalue. Core checks the Candidate Type/value on graph admission and checks it again against the-selected output. A `substitute` Satisfaction need not prove the current output's author affinity;-the BuildRequest must explicitly declare it and the+selected output. A `substitute` Satisfaction need not prove a semantic relationship to the current+output; the BuildRequest must explicitly declare it and theTarget must explicitly accept substitute fidelity.diff --git a/packages/realization/test/overlay.test.ts b/packages/realization/test/overlay.test.tsindex 6e210005..e036ecb5 100644--- a/packages/realization/test/overlay.test.ts+++ b/packages/realization/test/overlay.test.ts@@ -142,18 +142,11 @@ function providedOverlay(source: CompiledGraph, value: string, label: string) {};}-function completedAffinityBuild(): { readonly program: LinkedProgram; readonly source: CompiledGraph; readonly state: BuildState } {+function completedBuild(): { readonly program: LinkedProgram; readonly source: CompiledGraph; readonly state: BuildState } {const base = fixture();const source = sealCompiledGraph({program: base.source.program,- outputs: base.source.outputs.map((output) => ({- ...output,- affinity: [{- resultPointer: "",- source: { kind: "record" as const, id: "prompt:shot" },- sourcePointer: "",- }],- })),+ outputs: base.source.outputs,candidates: base.source.candidates,operations: base.source.operations,});@@ -204,7 +197,7 @@ test("an attached Existing Value is inert until BuildRequest explicitly selects});test("a historical Record becomes an ordinary substitute zero-edge Candidate", () => {- const { program, source, state: historical } = completedAffinityBuild();+ const { program, source, state: historical } = completedBuild();const candidate = createBuildRecordCandidate({ build: historical, sourceOutput: "shot.visual" });assert.equal(candidate.root.kind, "value");assert.deepEqual(candidate.type, types.media);@@ -221,8 +214,8 @@ test("a historical Record becomes an ordinary substitute zero-edge Candidate", (assert.notEqual(fresh.id, historical.id);});-test("a fixed black value substitutes an affined Output without any history or semantic proof", () => {- const { program, source } = completedAffinityBuild();+test("a fixed black value substitutes an Output without any history or semantic proof", () => {+ const { program, source } = completedBuild();const candidate = createProvidedCandidate({type: types.media,value: { kind: "inline", value: "UNRELATED FIXED BLACK VIDEO" },@@ -243,8 +236,8 @@ test("a fixed black value substitutes an affined Output without any history or sassert.equal(fresh.plan.initialValues[0]?.conformance, "substitute");});-test("a historical Record may substitute another author graph and Output without semantic or affinity proof", () => {- const { program, source, state: historical } = completedAffinityBuild();+test("a historical Record may substitute another author graph and Output without semantic proof", () => {+ const { program, source, state: historical } = completedBuild();const other = sealCompiledGraph({program: source.program,outputs: source.outputs.map((output) => ({ ...output, id: "replacement.visual" })),diff --git a/packages/run-text/README.md b/packages/run-text/README.mdindex 3561c294..e10fcb30 100644--- a/packages/run-text/README.md+++ b/packages/run-text/README.md@@ -27,7 +27,7 @@ declaration with several exports is one instance.The `output` on `<build-record>` may be the prior source's public output alias. The Host resolves itthrough its Build Catalog to the verified logical Record before Run compilation. Core never sees or-trusts the presentation alias, and the historical value receives no automatic semantic-affinity+trusts the presentation alias, and the historical value receives no automatic semantic-relationshipclaim against the output it is selected to satisfy.Imports form the opening prologue. They name Fragment libraries already admitted by the Host; theydiff --git a/packages/runtime-adapter-node/package.json b/packages/runtime-adapter-node/package.jsonnew file mode 100644index 00000000..da7bc373--- /dev/null+++ b/packages/runtime-adapter-node/package.json@@ -0,0 +1,12 @@+{+ "name": "@svml/runtime-adapter-node",+ "version": "0.0.0-dev",+ "private": true,+ "type": "module",+ "exports": {+ ".": "./src/index.ts"+ },+ "dependencies": {+ "@svml/runtime-adapter": "workspace:*"+ }+}diff --git a/packages/runtime-adapter-node/src/index.ts b/packages/runtime-adapter-node/src/index.tsnew file mode 100644index 00000000..0476f51c--- /dev/null+++ b/packages/runtime-adapter-node/src/index.ts@@ -0,0 +1,63 @@+import { access } from "node:fs/promises";+import { constants } from "node:fs";+import { delimiter, isAbsolute, resolve } from "node:path";++import type { RuntimeDoctorDiagnostic } from "@svml/runtime-adapter";++function pathLike(value: string): boolean {+ return isAbsolute(value) || value.includes("/") || value.includes("\\");+}++/** Bare command names remain PATH-resolved; configured relative paths are rooted at the Runtime Profile root. */+export function resolveRuntimeExecutable(root: string, value: string): string {+ return pathLike(value) && !isAbsolute(value) ? resolve(root, value) : value;+}++async function executableExists(value: string): Promise<boolean> {+ if (pathLike(value)) {+ try {+ await access(value, constants.X_OK);+ return true;+ } catch {+ return false;+ }+ }+ for (const directory of (process.env.PATH ?? "").split(delimiter).filter(Boolean)) {+ try {+ await access(resolve(directory, value), constants.X_OK);+ return true;+ } catch {+ // Continue searching PATH.+ }+ }+ return false;+}++export async function diagnoseRuntimeExecutable(options: {+ readonly root: string;+ readonly configured: string | undefined;+ readonly fallback: string;+ readonly subject: string;+}): Promise<readonly RuntimeDoctorDiagnostic[]> {+ const value = resolveRuntimeExecutable(options.root, options.configured ?? options.fallback);+ return await executableExists(value) ? [] : [{+ severity: "error",+ code: "RUNTIME_EXECUTABLE_MISSING",+ message: `${options.subject} executable ${value} is unavailable`,+ subject: value,+ }];+}++export function diagnoseRuntimeEnvironmentCredential(+ variable: string,+ subject: string,+): readonly RuntimeDoctorDiagnostic[] {+ return process.env[variable]?.trim()+ ? []+ : [{+ severity: "error",+ code: "RUNTIME_CREDENTIAL_MISSING",+ message: `${subject} requires environment variable ${variable}`,+ subject: variable,+ }];+}diff --git a/packages/runtime-adapter-node/test/runtime-adapter-node.test.ts b/packages/runtime-adapter-node/test/runtime-adapter-node.test.tsnew file mode 100644index 00000000..3a164cde--- /dev/null+++ b/packages/runtime-adapter-node/test/runtime-adapter-node.test.ts@@ -0,0 +1,29 @@+import assert from "node:assert/strict";+import { chmod, mkdir, mkdtemp, rm, writeFile } from "node:fs/promises";+import { tmpdir } from "node:os";+import { join } from "node:path";+import test from "node:test";++import {+ diagnoseRuntimeExecutable,+ resolveRuntimeExecutable,+} from "@svml/runtime-adapter-node";++test("configured executable paths are rooted at the Runtime Profile project", async () => {+ const root = await mkdtemp(join(tmpdir(), "svml-runtime-adapter-node-"));+ try {+ const path = join(root, "tools", "fixture");+ await mkdir(join(root, "tools"), { recursive: true });+ await writeFile(path, "#!/bin/sh\n", "utf8");+ await chmod(path, 0o755);+ assert.equal(resolveRuntimeExecutable(root, "./tools/fixture"), path);+ assert.deepEqual(await diagnoseRuntimeExecutable({+ root,+ configured: "./tools/fixture",+ fallback: "unused",+ subject: "fixture",+ }), []);+ } finally {+ await rm(root, { recursive: true, force: true });+ }+});diff --git a/packages/runtime-adapter/package.json b/packages/runtime-adapter/package.jsonnew file mode 100644index 00000000..09a765a3--- /dev/null+++ b/packages/runtime-adapter/package.json@@ -0,0 +1,15 @@+{+ "name": "@svml/runtime-adapter",+ "version": "0.0.0-dev",+ "private": true,+ "type": "module",+ "exports": {+ ".": "./src/index.ts"+ },+ "dependencies": {+ "@svml/endpoint-kit": "workspace:*",+ "@svml/host": "workspace:*",+ "@svml/protocol": "workspace:*",+ "@svml/runtime": "workspace:*"+ }+}diff --git a/packages/runtime-adapter/src/index.ts b/packages/runtime-adapter/src/index.tsnew file mode 100644index 00000000..6b7ac853--- /dev/null+++ b/packages/runtime-adapter/src/index.ts@@ -0,0 +1,313 @@+import type {+ EndpointPackage,+ EndpointRegistrar,+ EndpointRegistrationOptions,+} from "@svml/endpoint-kit";+import type { HostFacet } from "@svml/host";+import { canonicalize, digestOf, isDigest } from "@svml/protocol";+import type { CanonicalValue, Digest } from "@svml/protocol";+import type { RuntimeServicePackage } from "@svml/runtime";++export const runtimeAdapterHostAbi = "svml.runtime-adapter-host@1";++export type RuntimeAdapterKind = "endpoint" | "service";++export type RuntimeAdapterIdentity = {+ readonly contract: "svml.runtime-adapter-facet@1";+ readonly use: string;+ readonly kind: RuntimeAdapterKind;+};++export type RuntimeAdapterFactoryContext = {+ /** Absolute project root resolved from the Runtime Profile document. */+ readonly root: string;+ readonly instance: string;+ readonly lane?: string;+ readonly config: CanonicalValue;+};++export type RuntimeDoctorDiagnostic = {+ readonly severity: "error" | "warning" | "info";+ readonly code: string;+ readonly message: string;+ readonly subject?: string;+};++export type RuntimeEndpointAdapterImplementation = {+ create(context: RuntimeAdapterFactoryContext): EndpointPackage | Promise<EndpointPackage>;+ doctor?(context: RuntimeAdapterFactoryContext): readonly RuntimeDoctorDiagnostic[] | Promise<readonly RuntimeDoctorDiagnostic[]>;+};++export type RuntimeServiceAdapterImplementation = {+ create(context: RuntimeAdapterFactoryContext): RuntimeServicePackage | Promise<RuntimeServicePackage>;+ doctor?(context: RuntimeAdapterFactoryContext): readonly RuntimeDoctorDiagnostic[] | Promise<readonly RuntimeDoctorDiagnostic[]>;+};++export type RuntimeAdapterHostFacet = HostFacet & {+ readonly abi: typeof runtimeAdapterHostAbi;+ readonly identity: RuntimeAdapterIdentity;+ readonly implementation: RuntimeEndpointAdapterImplementation | RuntimeServiceAdapterImplementation;+};++export type RuntimeAdapterPackageBinding = {+ readonly packageName: string;+ /** Actual digest of the selected physical package bytes. */+ readonly packageArtifactDigest: Digest;+ /** Actual digest of this physical package's transitive dependency closure. */+ readonly packageClosureDigest: Digest;+};++type RuntimeAdapterRegistration = {+ readonly facet: RuntimeAdapterHostFacet;+ readonly binding?: RuntimeAdapterPackageBinding;+};++function assert(condition: unknown, message: string): asserts condition {+ if (!condition) throw new Error(message);+}++function identity(value: CanonicalValue): RuntimeAdapterIdentity {+ assert(value !== null && typeof value === "object" && !Array.isArray(value),+ "Runtime Adapter identity must be an object");+ const item = value as unknown as RuntimeAdapterIdentity;+ assert(item.contract === "svml.runtime-adapter-facet@1", "Runtime Adapter identity contract is unsupported");+ assert(item.use.trim().length > 0, "Runtime Adapter use name is empty");+ assert(item.kind === "endpoint" || item.kind === "service", "Runtime Adapter kind is invalid");+ return canonicalize(item) as unknown as RuntimeAdapterIdentity;+}++function implementation(value: unknown, subject: string): RuntimeAdapterHostFacet["implementation"] {+ assert(value !== null && typeof value === "object" && typeof (value as { create?: unknown }).create === "function",+ `${subject} does not implement create()`);+ const doctor = (value as { doctor?: unknown }).doctor;+ assert(doctor === undefined || typeof doctor === "function", `${subject}.doctor must be a function`);+ return value as RuntimeAdapterHostFacet["implementation"];+}++export function createRuntimeEndpointAdapterFacet(options: {+ readonly use: string;+ readonly create: RuntimeEndpointAdapterImplementation["create"];+ readonly doctor?: RuntimeEndpointAdapterImplementation["doctor"];+}): RuntimeAdapterHostFacet {+ const facet: RuntimeAdapterHostFacet = {+ abi: runtimeAdapterHostAbi,+ identity: identity(canonicalize({+ contract: "svml.runtime-adapter-facet@1",+ use: options.use,+ kind: "endpoint",+ })),+ implementation: {+ create: options.create,+ ...(options.doctor === undefined ? {} : { doctor: options.doctor }),+ },+ };+ return facet;+}++export function createRuntimeServiceAdapterFacet(options: {+ readonly use: string;+ readonly create: RuntimeServiceAdapterImplementation["create"];+ readonly doctor?: RuntimeServiceAdapterImplementation["doctor"];+}): RuntimeAdapterHostFacet {+ return {+ abi: runtimeAdapterHostAbi,+ identity: identity(canonicalize({+ contract: "svml.runtime-adapter-facet@1",+ use: options.use,+ kind: "service",+ })),+ implementation: {+ create: options.create,+ ...(options.doctor === undefined ? {} : { doctor: options.doctor }),+ },+ };+}++export function isRuntimeAdapterHostFacet(value: HostFacet): value is RuntimeAdapterHostFacet {+ if (value.abi !== runtimeAdapterHostAbi) return false;+ try {+ identity(value.identity);+ implementation(value.implementation, "Runtime Adapter");+ return true;+ } catch {+ return false;+ }+}++function boundImplementationDigest(+ binding: RuntimeAdapterPackageBinding,+ adapter: RuntimeAdapterIdentity,+ facet: string,+ declared: Digest,+): Digest {+ assert(isDigest(binding.packageArtifactDigest), `${binding.packageName} package Artifact digest is invalid`);+ assert(isDigest(binding.packageClosureDigest), `${binding.packageName} package Closure digest is invalid`);+ return digestOf({+ contract: "svml.loaded-runtime-implementation@1",+ package: binding.packageName,+ packageArtifact: binding.packageArtifactDigest,+ packageClosure: binding.packageClosureDigest,+ adapter,+ facet,+ declared,+ });+}++function proxyRegistrar(+ registry: EndpointRegistrar,+ digests: ReadonlyMap<string, Digest>,+): EndpointRegistrar {+ const options = (value: EndpointRegistrationOptions | undefined): EndpointRegistrationOptions | undefined => {+ const implementation = value?.runtimeImplementation;+ if (implementation === undefined) return value;+ const digest = digests.get(implementation.facet.name);+ assert(digest !== undefined, `Endpoint registration uses undeclared Runtime facet ${implementation.facet.name}`);+ return { ...value, runtimeImplementation: { ...implementation, digest } };+ };+ return {+ registerImmediateEndpoint(id, capability, returns, handler, value) {+ registry.registerImmediateEndpoint(id, capability, returns, handler, options(value));+ },+ registerRecoverableEndpoint(id, capability, returns, endpoint, value) {+ registry.registerRecoverableEndpoint(id, capability, returns, endpoint, options(value));+ },+ };+}++function bindEndpointPackage(+ value: EndpointPackage,+ adapter: RuntimeAdapterIdentity,+ binding: RuntimeAdapterPackageBinding | undefined,+): EndpointPackage {+ if (binding === undefined) return value;+ const digests = new Map(value.manifest.facets.map((facet) => [+ facet.name,+ boundImplementationDigest(binding, adapter, facet.name, facet.implementation.digest),+ ]));+ return {+ ...value,+ manifest: {+ ...value.manifest,+ facets: value.manifest.facets.map((facet) => ({+ ...facet,+ implementation: { ...facet.implementation, digest: digests.get(facet.name)! },+ })),+ },+ install(registry) {+ return value.install(proxyRegistrar(registry, digests));+ },+ };+}++function bindServicePackage(+ value: RuntimeServicePackage,+ adapter: RuntimeAdapterIdentity,+ binding: RuntimeAdapterPackageBinding | undefined,+): RuntimeServicePackage {+ if (binding === undefined) return value;+ return {+ ...value,+ manifest: {+ ...value.manifest,+ facets: value.manifest.facets.map((facet) => ({+ ...facet,+ implementation: {+ ...facet.implementation,+ digest: boundImplementationDigest(binding, adapter, facet.name, facet.implementation.digest),+ },+ })),+ },+ };+}++export class RuntimeAdapterRegistry {+ readonly #registrations = new Map<string, RuntimeAdapterRegistration>();++ #register(facet: RuntimeAdapterHostFacet, binding?: RuntimeAdapterPackageBinding): void {+ assert(facet.abi === runtimeAdapterHostAbi, `Runtime Adapter ${facet.abi} ABI is unsupported`);+ const normalized = identity(facet.identity);+ implementation(facet.implementation, `Runtime Adapter ${normalized.use}`);+ assert(!this.#registrations.has(normalized.use), `Runtime Adapter ${normalized.use} is already registered`);+ if (binding !== undefined) {+ assert(binding.packageName.trim().length > 0, "Runtime Adapter physical package name is empty");+ assert(isDigest(binding.packageArtifactDigest), `${binding.packageName} package Artifact digest is invalid`);+ assert(isDigest(binding.packageClosureDigest), `${binding.packageName} package Closure digest is invalid`);+ }+ this.#registrations.set(normalized.use, {+ facet: { ...facet, identity: normalized },+ ...(binding === undefined ? {} : { binding }),+ });+ }++ registerFacet(facet: HostFacet, binding?: RuntimeAdapterPackageBinding): void {+ assert(isRuntimeAdapterHostFacet(facet), `Host facet ${facet.abi} is not a valid Runtime Adapter`);+ this.#register(facet, binding);+ }++ /** Trusted embedding compatibility. Locked installed packages should use registerFacet(). */+ registerEndpoint(use: string, create: RuntimeEndpointAdapterImplementation["create"]): void {+ this.#register(createRuntimeEndpointAdapterFacet({ use, create }));+ }++ /** Trusted embedding compatibility. Locked installed packages should use registerFacet(). */+ registerService(use: string, create: RuntimeServiceAdapterImplementation["create"]): void {+ this.#register(createRuntimeServiceAdapterFacet({ use, create }));+ }++ has(use: string, kind?: RuntimeAdapterKind): boolean {+ const value = this.#registrations.get(use);+ return value !== undefined && (kind === undefined || value.facet.identity.kind === kind);+ }++ async createEndpoint(use: string, context: RuntimeAdapterFactoryContext): Promise<EndpointPackage> {+ const value = this.#registrations.get(use);+ assert(value !== undefined, `Runtime Endpoint adapter ${use} is not registered`);+ assert(value.facet.identity.kind === "endpoint", `Runtime Adapter ${use} is not an Endpoint adapter`);+ const created = await (value.facet.implementation as RuntimeEndpointAdapterImplementation).create(context);+ return bindEndpointPackage(created, value.facet.identity, value.binding);+ }++ async createService(use: string, context: RuntimeAdapterFactoryContext): Promise<RuntimeServicePackage> {+ const value = this.#registrations.get(use);+ assert(value !== undefined, `Runtime service adapter ${use} is not registered`);+ assert(value.facet.identity.kind === "service", `Runtime Adapter ${use} is not a service adapter`);+ const created = await (value.facet.implementation as RuntimeServiceAdapterImplementation).create(context);+ return bindServicePackage(created, value.facet.identity, value.binding);+ }++ async doctor(use: string, kind: RuntimeAdapterKind, context: RuntimeAdapterFactoryContext): Promise<readonly RuntimeDoctorDiagnostic[]> {+ const value = this.#registrations.get(use);+ if (value === undefined) return [{ severity: "error", code: "RUNTIME_ADAPTER_MISSING", message: `Runtime Adapter ${use} is not registered`, subject: use }];+ if (value.facet.identity.kind !== kind) return [{ severity: "error", code: "RUNTIME_ADAPTER_KIND", message: `Runtime Adapter ${use} is ${value.facet.identity.kind}, not ${kind}`, subject: use }];+ const diagnose = (value.facet.implementation as RuntimeEndpointAdapterImplementation).doctor;+ return diagnose === undefined ? [] : await diagnose(context);+ }+}++export function runtimeConfigObject(value: CanonicalValue, subject: string): Record<string, CanonicalValue> {+ assert(value !== null && typeof value === "object" && !Array.isArray(value), `${subject} config must be an object`);+ return value as Record<string, CanonicalValue>;+}++export function runtimeConfigExact(value: Record<string, CanonicalValue>, allowed: readonly string[], subject: string): void {+ const unknown = Object.keys(value).filter((key) => !allowed.includes(key));+ assert(unknown.length === 0, `${subject} config does not accept ${unknown[0]}`);+}++export function runtimeConfigString(value: CanonicalValue | undefined, subject: string): string | undefined {+ if (value === undefined) return undefined;+ assert(typeof value === "string" && value.trim().length > 0, `${subject} must be a non-empty string`);+ return value;+}++export function runtimeConfigPositiveInteger(value: CanonicalValue | undefined, subject: string): number | undefined {+ if (value === undefined) return undefined;+ assert(typeof value === "number" && Number.isSafeInteger(value) && value > 0, `${subject} must be a positive integer`);+ return value;+}++export function runtimeConfigBoolean(value: CanonicalValue | undefined, subject: string): boolean | undefined {+ if (value === undefined) return undefined;+ assert(typeof value === "boolean", `${subject} must be a boolean`);+ return value;+}diff --git a/packages/runtime/README.md b/packages/runtime/README.mdindex 71da6d95..bb539048 100644--- a/packages/runtime/README.md+++ b/packages/runtime/README.md@@ -35,8 +35,9 @@ accepts its Event, the next run reconstructs the same Event from the stored compcall the Endpoint again.This package is an environment-neutral reference, not a durable queue. SQLite/filesystem adapters,-environment credentials, the local follow loop and `@svml/endpoint-kit` live in separate packages;-distributed attempt leases and production Endpoint adapters remain future work. An Endpoint-whose upstream API cannot look up or deduplicate the supplied `submissionKey` cannot promise-exactly-once remote work across the crash window; its `resume(undefined)` must explicitly reconcile-that uncertainty.+environment credentials, the local follow loop, Endpoint implementations and+`@svml/endpoint-kit` live in separate packages. The repository already contains KIE, Vertex and+several local media/service Endpoint packages; distributed attempt leases and additional hosted+adapters remain deployment work. An Endpoint whose upstream API cannot look up or deduplicate the+supplied `submissionKey` cannot promise exactly-once remote work across the crash window; its+`resume(undefined)` must explicitly reconcile that uncertainty.diff --git a/packages/runtime/src/index.ts b/packages/runtime/src/index.tsindex 0cd0b433..8244de97 100644--- a/packages/runtime/src/index.ts+++ b/packages/runtime/src/index.ts@@ -36,4 +36,9 @@ export {} from "./services.js";export type * from "./services.js";export { LocalBuildScheduler } from "./scheduler.js";+export {+ isEnumerableBuildStore,+ isManagedArtifactStore,+ isStreamingArtifactStore,+} from "./types.js";export type * from "./types.js";diff --git a/packages/runtime/src/memory.ts b/packages/runtime/src/memory.tsindex c538a9c7..74edf6c1 100644--- a/packages/runtime/src/memory.ts+++ b/packages/runtime/src/memory.ts@@ -35,6 +35,12 @@ export class MemoryBuildStore implements BuildStore {return snapshot === undefined ? undefined : copy(snapshot);}+ async list(): Promise<readonly BuildSnapshot[]> {+ return [...this.#builds.values()]+ .sort((left, right) => left.build.localeCompare(right.build))+ .map(copy);+ }+async compareAndSwap(build: string,expectedRevision: number,diff --git a/packages/runtime/src/types.ts b/packages/runtime/src/types.tsindex 73f5f4b4..685b48d9 100644--- a/packages/runtime/src/types.ts+++ b/packages/runtime/src/types.ts@@ -56,6 +56,28 @@ export type ArtifactStore = {has(digest: Digest): Promise<boolean>;};+/** Optional transfer capability. Core and components never require storage to expose it. */+export type StreamingArtifactStore = ArtifactStore & {+ putStream(chunks: AsyncIterable<Uint8Array>, mediaType: string): Promise<BlobRef>;+ open(digest: Digest): Promise<AsyncIterable<Uint8Array> | undefined>;+};++/** Optional retention capability used only by explicit deployment maintenance. */+export type ManagedArtifactStore = ArtifactStore & {+ list(): Promise<readonly Digest[]>;+ delete(digest: Digest): Promise<boolean>;+};++export function isStreamingArtifactStore(value: ArtifactStore): value is StreamingArtifactStore {+ return "putStream" in value && typeof value.putStream === "function"+ && "open" in value && typeof value.open === "function";+}++export function isManagedArtifactStore(value: ArtifactStore): value is ManagedArtifactStore {+ return "list" in value && typeof value.list === "function"+ && "delete" in value && typeof value.delete === "function";+}+export type BuildSnapshot = {readonly build: string;readonly revision: number;@@ -73,6 +95,15 @@ export type BuildStore = {compareAndSwap(build: string, expectedRevision: number, state: BuildState): Promise<BuildStoreWrite>;};+/** Optional maintenance index; execution still depends only on BuildStore's three CAS operations. */+export type EnumerableBuildStore = BuildStore & {+ list(): Promise<readonly BuildSnapshot[]>;+};++export function isEnumerableBuildStore(value: BuildStore): value is EnumerableBuildStore {+ return "list" in value && typeof value.list === "function";+}+export type ScheduledBuild = {readonly id: string;readonly state: BuildState;diff --git a/packages/script/src/narrative.ts b/packages/script/src/narrative.tsindex 8871e201..0f99981e 100644--- a/packages/script/src/narrative.ts+++ b/packages/script/src/narrative.ts@@ -1,4 +1,4 @@-import { canonicalize, digestOf } from "@svml/core";+import { canonicalize } from "@svml/core";import type { CanonicalValue } from "@svml/protocol";import type { ParsedNarrative } from "./types.js";@@ -77,7 +77,7 @@ export function narrativeSegmentExcerptValue(tokenEndExclusive: segment.tokenEndExclusive,serializations: segmentSerializations(segment),} as const;- return canonicalize({ ...content, excerptDigest: digestOf(canonicalize(content)) });+ return canonicalize(content);}export function narrativeDialogueExcerptValue(@@ -87,7 +87,7 @@ export function narrativeDialogueExcerptValue(contract: "svml.narrative-dialogue-excerpt@1",...excerptContent(segment, "dialogue"),} as const;- return canonicalize({ ...content, excerptDigest: digestOf(canonicalize(content)) });+ return canonicalize(content);}export function narrativeSpeechExcerptValue(@@ -97,7 +97,7 @@ export function narrativeSpeechExcerptValue(contract: "svml.narrative-speech-excerpt@1",...excerptContent(segment, "speech"),} as const;- return canonicalize({ ...content, excerptDigest: digestOf(canonicalize(content)) });+ return canonicalize(content);}export function captionProjectionValue(parsed: ParsedNarrative): CanonicalValue {@@ -106,7 +106,7 @@ export function captionProjectionValue(parsed: ParsedNarrative): CanonicalValuetext: parsed.captionProjection.text,regions: parsed.captionProjection.regions.map(({ range: _range, ...region }) => region),} as const;- return canonicalize({ ...content, projectionDigest: digestOf(canonicalize(content)) });+ return canonicalize(content);}export function narrativeSelectionValue(selection: ParsedNarrative["selections"][number]): CanonicalValue {@@ -119,7 +119,7 @@ export function narrativeSelectionValue(selection: ParsedNarrative["selections"]close: { affinity: occurrence.close.affinity, boundary: semanticBoundary(occurrence.close.boundary) },})),} as const;- return canonicalize({ ...content, selectionDigest: digestOf(canonicalize(content)) });+ return canonicalize(content);}function semanticBoundary(boundary: {diff --git a/packages/script/src/parser.ts b/packages/script/src/parser.tsindex a6d962d2..288aa791 100644--- a/packages/script/src/parser.ts+++ b/packages/script/src/parser.ts@@ -680,19 +680,6 @@ export function parseScript(if (anchors.length !== 2 * tokens.length + 2 * segments.length) {fail("SCRIPT_ANCHOR_CARDINALITY", "Semantic anchor cardinality is not 2M + 2N.");}- const semanticPayload = {- contract: "svml.semantic-index@0" as const,- anchors,- tokens: tokens.map((token) => ({- id: token.id,- segmentId: token.segmentId,- segmentTokenIndex: token.segmentTokenIndex,- normalized: token.normalized,- startAnchorId: token.startAnchorId,- endAnchorId: token.endAnchorId,- })),- };-return {contract: "svml.narrative@0",segments,@@ -708,7 +695,6 @@ export function parseScript(semanticIndex: {contract: "svml.semantic-index@0",anchors,- digest: digestOf(semanticPayload),},serializations: {dialogue: dialogueTurns.join("\n"),diff --git a/packages/seedance-speaker/src/fragment.ts b/packages/seedance-speaker/src/fragment.tsindex 5d82d945..7b84c477 100644--- a/packages/seedance-speaker/src/fragment.ts+++ b/packages/seedance-speaker/src/fragment.ts@@ -45,11 +45,6 @@ export function createSeedanceSpeakerTakeFragment(type: artifactTypes.blob,root: operation("select-primary-video"),semanticInputs: ["program", "duration"],- affinity: [{- resultPointer: "/digest",- source: operation("generate"),- sourcePointer: "/videos/0/digest",- }],fidelity: "exact",},],diff --git a/packages/seedance-speaker/src/kit.ts b/packages/seedance-speaker/src/kit.tsindex 68e8fad5..fbae75e8 100644--- a/packages/seedance-speaker/src/kit.ts+++ b/packages/seedance-speaker/src/kit.ts@@ -5,7 +5,6 @@ import {verifyPromptProgram,} from "@svml/prompt-kit";import type { PromptKitInvocation, PromptKitScalar, PromptProgram } from "@svml/prompt-kit";-import { canonicalize, digestOf, isDigest } from "@svml/protocol";import {sealSeedanceSpeechProgram,seedanceModels,@@ -21,14 +20,8 @@ export const speakerMethodDefaults = {webSearch: false,} as const;-function intentContent(value: Omit<SpeakerTakeIntent, "intentDigest">) {- return canonicalize(value);-}--export function sealSpeakerTakeIntent(- value: Omit<SpeakerTakeIntent, "intentDigest">,-): SpeakerTakeIntent {- const intent = { ...value, intentDigest: digestOf(intentContent(value)) };+export function sealSpeakerTakeIntent(value: SpeakerTakeIntent): SpeakerTakeIntent {+ const intent = structuredClone(value);verifySpeakerTakeIntent(intent);return intent;}@@ -54,17 +47,10 @@ export function verifySpeakerTakeIntent(value: unknown): asserts value is Speakeif (typeof intent.recipe?.path !== "string"|| intent.recipe.path.length === 0- || !isDigest(intent.recipe.recordDigest)|| intent.promptParameters === null|| typeof intent.promptParameters !== "object"|| Array.isArray(intent.promptParameters)- || typeof intent.segment?.id !== "string"- || intent.segment.id.length === 0- || !Number.isSafeInteger(intent.segment.tokenStart)- || !Number.isSafeInteger(intent.segment.tokenEndExclusive)- || intent.segment.tokenEndExclusive <= intent.segment.tokenStart- || !isDigest(intent.segment.dialogueExcerptDigest)- || typeof intent.segment.dialogue !== "string"+ || typeof intent.segment?.dialogue !== "string"|| intent.segment.dialogue.trim().length === 0) {throw new Error("Speaker TakeIntent identity, parameters or dialogue is invalid");@@ -86,11 +72,6 @@ export function verifySpeakerTakeIntent(value: unknown): asserts value is Speake}assertGenerationBlobRef(item.artifact, `${item.kind}/` as "image/" | "audio/");}- if (!isDigest(intent.intentDigest)) throw new Error("Speaker TakeIntent digest is invalid");- const { intentDigest: _digest, ...content } = intent;- if (intent.intentDigest !== digestOf(intentContent(content))) {- throw new Error("Speaker TakeIntent digest differs from its contents");- }}function audioCount(intent: SpeakerTakeIntent): "zero" | "one" | "many" {@@ -106,7 +87,6 @@ export function bindSpeakerPromptKit(intent: SpeakerTakeIntent): PromptKitInvoca}const invocation = sealPromptKitInvocation({contract: "svml.prompt-kit-invocation@1",- kit: intent.kit,parameters,selectors: {"image-count": intent.references.filter((item) => item.kind === "image").length === 1 ? "one" : "many",@@ -128,11 +108,6 @@ export function renderSpeakerSpeechProgram(): SeedanceSpeechProgram {verifyPromptProgram(program);verifySpeakerTakeIntent(intent);- if (program.kit !== intent.kit) throw new Error("Speaker PromptProgram uses another Kit");- const invocation = bindSpeakerPromptKit(intent);- if (program.invocationDigest !== invocation.invocationDigest) {- throw new Error("Speaker PromptProgram does not bind this TakeIntent");- }return sealSeedanceSpeechProgram({contract: "svml.seedance-speech-program@1",model: intent.model,@@ -145,11 +120,5 @@ export function renderSpeakerSpeechProgram(aspectRatio: intent.aspectRatio,generateAudio: true,webSearch: intent.webSearch,- segment: {- id: intent.segment.id,- tokenStart: intent.segment.tokenStart,- tokenEndExclusive: intent.segment.tokenEndExclusive,- dialogueExcerptDigest: intent.segment.dialogueExcerptDigest,- },});}diff --git a/packages/seedance-speaker/src/surface.ts b/packages/seedance-speaker/src/surface.tsindex addda3af..8160370b 100644--- a/packages/seedance-speaker/src/surface.ts+++ b/packages/seedance-speaker/src/surface.ts@@ -1,6 +1,6 @@import { artifactTypes } from "@svml/artifact";import { contractTypes } from "@svml/contracts";-import type { CanonicalValue, Digest, StoredValue } from "@svml/protocol";+import type { CanonicalValue, StoredValue } from "@svml/protocol";import {compilePromptKit,promptKitTypes,@@ -102,9 +102,7 @@ function recipeValue(}const recipe = inline<SvsRecipe>(reference, `${element.name}.recipe`);if (recipe.contract !== "svml.svs-recipe@1") throw new Error(`${element.name}.recipe is invalid`);- const digest = reference.record?.digest;- if (digest === undefined) throw new Error(`${element.name}.recipe has no Record digest`);- return { recipe, digest };+ return recipe;}function kitValue(@@ -134,7 +132,6 @@ function dialogueValue(readonly tokenStart: number;readonly tokenEndExclusive: number;readonly dialogue: string;- readonly excerptDigest: string;}>(reference, `${element.name}.dialogue`);if (value.contract !== "svml.narrative-dialogue-excerpt@1"@@ -207,8 +204,7 @@ export const decodeSeedanceSpeakerTakeSurface: StructuredSurfaceHandler = ({ eleattributes(element, ["id", "dialogue", "duration", "recipe", "kit"]);const id = stringAttribute(element, "id");const kit = kitValue(element, resolveReference);- const selectedRecipe = recipeValue(element, resolveReference);- const recipe = selectedRecipe.recipe;+ const recipe = recipeValue(element, resolveReference);const reserved = new Set(["kind", "model", "resolution", "aspect-ratio", "web-search", "action", "extra",]);@@ -239,17 +235,13 @@ export const decodeSeedanceSpeakerTakeSurface: StructuredSurfaceHandler = ({ eleconst intent = sealSpeakerTakeIntent({contract: "svml.seedance-speaker-take-intent@1",kit: kit.id,- recipe: { path: recipe.path, recordDigest: selectedRecipe.digest },+ recipe: { path: recipe.path },model: selectedModel,resolution: recipeString(recipe, "resolution", speakerMethodDefaults.resolution) as "480p" | "720p" | "1080p",aspectRatio: recipeString(recipe, "aspect-ratio", speakerMethodDefaults.aspectRatio) as "1:1" | "4:3" | "3:4" | "16:9" | "9:16" | "21:9" | "adaptive",webSearch: recipeBoolean(recipe, "web-search", speakerMethodDefaults.webSearch),promptParameters,segment: {- id: dialogue.id,- tokenStart: dialogue.tokenStart,- tokenEndExclusive: dialogue.tokenEndExclusive,- dialogueExcerptDigest: dialogue.excerptDigest as Digest,dialogue: dialogue.dialogue,},references: refs,diff --git a/packages/seedance-speaker/src/types.ts b/packages/seedance-speaker/src/types.tsindex faffc5b5..781a9f49 100644--- a/packages/seedance-speaker/src/types.ts+++ b/packages/seedance-speaker/src/types.ts@@ -1,4 +1,4 @@-import type { CanonicalValue, BlobRef, Digest } from "@svml/protocol";+import type { CanonicalValue, BlobRef } from "@svml/protocol";import type { SeedanceModel } from "@svml/seedance";export type SpeakerReference = {@@ -10,24 +10,16 @@ export type SpeakerReference = {export type SpeakerTakeIntent = {readonly contract: "svml.seedance-speaker-take-intent@1";readonly kit: string;- readonly recipe: {- readonly path: string;- readonly recordDigest: Digest;- };+ readonly recipe: { readonly path: string };readonly model: SeedanceModel;readonly resolution: "480p" | "720p" | "1080p";readonly aspectRatio: "1:1" | "4:3" | "3:4" | "16:9" | "9:16" | "21:9" | "adaptive";readonly webSearch: boolean;readonly promptParameters: Readonly<Record<string, CanonicalValue>>;readonly segment: {- readonly id: string;- readonly tokenStart: number;- readonly tokenEndExclusive: number;- readonly dialogueExcerptDigest: Digest;readonly dialogue: string;};readonly references: readonly SpeakerReference[];readonly actionPrompt?: string;readonly extraPrompt?: string;- readonly intentDigest: Digest;};diff --git a/packages/seedance-speaker/test/kit.test.ts b/packages/seedance-speaker/test/kit.test.tsindex 10517185..4eae3e4c 100644--- a/packages/seedance-speaker/test/kit.test.ts+++ b/packages/seedance-speaker/test/kit.test.ts@@ -44,17 +44,13 @@ function intent() {return sealSpeakerTakeIntent({contract: "svml.seedance-speaker-take-intent@1",kit: "official-ugc-v1",- recipe: { path: "speaker.default", recordDigest: digestOf("recipe") },+ recipe: { path: "speaker.default" },model: speakerMethodDefaults.model,resolution: speakerMethodDefaults.resolution,aspectRatio: speakerMethodDefaults.aspectRatio,webSearch: speakerMethodDefaults.webSearch,promptParameters: {},segment: {- id: "opening",- tokenStart: 0,- tokenEndExclusive: 4,- dialogueExcerptDigest: digestOf("dialogue"),dialogue: "HOST: Say exactly these words.",},references: [@@ -88,9 +84,7 @@ test("official UGC Kit emits an ordered generic Prompt Program", () => {"visible-text","dialogue",]);- assert.equal(prompt.blocks[3]?.origin, "variant:voice-map:single-with-audio");assert.match(prompt.blocks[3]?.text ?? "", /@audio1/u);- assert.equal(prompt.blocks[4]?.origin, "parameter:composition-stability:soft-locked");});test("rendering the generic Prompt Program preserves exact Seedance method and references", () => {@@ -108,13 +102,12 @@ test("rendering the generic Prompt Program preserves exact Seedance method and rtest("Speaker rejects invalid media while Prompt Kit rejects unknown parameters", () => {const base = intent();- const { intentDigest: _digest, ...content } = base;assert.throws(() => sealSpeakerTakeIntent({- ...content,+ ...base,references: [{ kind: "audio", artifact: audio, role: "voice-timbre" }],}), /requires 1-9 image references/u);- assert.throws(() => sealSpeakerTakeIntent({ ...content, resolution: "1080p" }), /at most 720p/u);- const unknown = sealSpeakerTakeIntent({ ...content, promptParameters: { "imaginary-axis": "value" } });+ assert.throws(() => sealSpeakerTakeIntent({ ...base, resolution: "1080p" }), /at most 720p/u);+ const unknown = sealSpeakerTakeIntent({ ...base, promptParameters: { "imaginary-axis": "value" } });assert.throws(() => compilePromptKit(officialUgcV1KitSpec, bindSpeakerPromptKit(unknown)),/parameter imaginary-axis is not declared/u,diff --git a/packages/seedance/src/fragment.ts b/packages/seedance/src/fragment.tsindex 0025330c..f4f982f7 100644--- a/packages/seedance/src/fragment.ts+++ b/packages/seedance/src/fragment.ts@@ -35,11 +35,6 @@ export function createSeedanceGenerationFragment(endpoint: ExactModelEndpoint) {type: artifactTypes.blob,root: operation("select-primary-video"),semanticInputs: ["request"],- affinity: [{- resultPointer: "/digest",- source: operation("generate"),- sourcePointer: "/videos/0/digest",- }],fidelity: "exact",}],});@@ -80,11 +75,6 @@ export function createSeedanceSpeechGenerationFragment(type: artifactTypes.blob,root: operation("select-primary-video"),semanticInputs: ["program", "duration"],- affinity: [{- resultPointer: "/digest",- source: operation("generate"),- sourcePointer: "/videos/0/digest",- }],fidelity: "exact",}],});diff --git a/packages/seedance/src/index.ts b/packages/seedance/src/index.tsindex ece3d2ff..87bf6d75 100644--- a/packages/seedance/src/index.ts+++ b/packages/seedance/src/index.ts@@ -2,11 +2,9 @@ import { artifactDependency } from "@svml/artifact";import {assertGenerationBlobRef,generationBlobRefSchema,- generationDigestSchema,generationObjectSchema,generationPromptSchema,sealGenerationRequest,- verifyGenerationRequestDigest,} from "@svml/generation";import { defineExactModelModule } from "@svml/model-kit";import {@@ -44,14 +42,11 @@ export type SeedanceRequestContent<M extends SeedanceModel = SeedanceModel> = {readonly webSearch: boolean;};-export type SeedanceRequest<M extends SeedanceModel = SeedanceModel> = SeedanceRequestContent<M> & {- readonly requestDigest: Digest;-};+export type SeedanceRequest<M extends SeedanceModel = SeedanceModel> = SeedanceRequestContent<M>;export type SeedancePrompt = {readonly contract: "svml.seedance-prompt@1";readonly text: string;- readonly promptDigest: Digest;};export type SeedanceSpeechProgram = {@@ -63,13 +58,6 @@ export type SeedanceSpeechProgram = {readonly aspectRatio: "1:1" | "4:3" | "3:4" | "16:9" | "9:16" | "21:9" | "adaptive";readonly generateAudio: true;readonly webSearch: boolean;- readonly segment: {- readonly id: string;- readonly tokenStart: number;- readonly tokenEndExclusive: number;- readonly dialogueExcerptDigest: Digest;- };- readonly programDigest: Digest;};export const seedanceTypes = {@@ -100,7 +88,7 @@ export function sealSeedancePrompt(text: string): SeedancePrompt {throw new Error("Seedance Prompt must contain 1 to 20,000 characters");}const content = { contract: "svml.seedance-prompt@1" as const, text: normalized };- return { ...content, promptDigest: digestOf(canonicalize(content)) };+ return content;}export function verifySeedancePrompt(value: unknown): asserts value is SeedancePrompt {@@ -108,18 +96,10 @@ export function verifySeedancePrompt(value: unknown): asserts value is SeedancePif (value.contract !== "svml.seedance-prompt@1" || typeof value.text !== "string" || value.text.length === 0) {throw new Error("Seedance Prompt is invalid");}- const content = canonicalize({ contract: value.contract, text: value.text });- if (value.promptDigest !== digestOf(content)) throw new Error("Seedance Prompt digest differs");-}--function speechProgramContent(value: Omit<SeedanceSpeechProgram, "programDigest">) {- return canonicalize(value);}-export function sealSeedanceSpeechProgram(- value: Omit<SeedanceSpeechProgram, "programDigest">,-): SeedanceSpeechProgram {- const result: SeedanceSpeechProgram = { ...value, programDigest: digestOf(speechProgramContent(value)) };+export function sealSeedanceSpeechProgram(value: SeedanceSpeechProgram): SeedanceSpeechProgram {+ const result = structuredClone(value);verifySeedanceSpeechProgram(result);return result;}@@ -138,21 +118,6 @@ export function verifySeedanceSpeechProgram(value: unknown): asserts value is Se) {throw new Error("Seedance SpeechProgram is invalid");}- assertObject(value.segment);- if (- typeof value.segment.id !== "string"- || value.segment.id.length === 0- || !Number.isSafeInteger(value.segment.tokenStart)- || !Number.isSafeInteger(value.segment.tokenEndExclusive)- || (value.segment.tokenEndExclusive as number) <= (value.segment.tokenStart as number)- || typeof value.segment.dialogueExcerptDigest !== "string"- ) {- throw new Error("Seedance SpeechProgram Segment identity is invalid");- }- const { programDigest: _digest, ...content } = value as unknown as SeedanceSpeechProgram;- if (value.programDigest !== digestOf(speechProgramContent(content))) {- throw new Error("Seedance SpeechProgram digest differs from its contents");- }const program = value as unknown as SeedanceSpeechProgram;sealSeedanceRequest({contract: "svml.seedance-request@1",@@ -173,13 +138,6 @@ export function compileSeedanceSpeechRequest(): SeedanceRequest {verifySeedanceSpeechProgram(program);assertSpeechDurationIdentity(duration);- if (- duration.segmentId !== program.segment.id- || duration.tokenStart !== program.segment.tokenStart- || duration.tokenEndExclusive !== program.segment.tokenEndExclusive- ) {- throw new Error("Seedance Speech duration belongs to another Narrative Segment");- }if (!Number.isSafeInteger(duration.durationSec) || duration.durationSec < 4 || duration.durationSec > 15) {throw new Error("Seedance Speech duration must be an integer between 4 and 15 seconds");}@@ -234,13 +192,6 @@ const speechProgramSchema: ValueSchema = generationObjectSchema({aspectRatio: { schema: aspectRatioSchema },generateAudio: { schema: { kind: "literal", value: true } },webSearch: { schema: { kind: "boolean" } },- segment: { schema: generationObjectSchema({- id: { schema: generationPromptSchema },- tokenStart: { schema: { kind: "number", integer: true, minimum: 0 } },- tokenEndExclusive: { schema: { kind: "number", integer: true, minimum: 1 } },- dialogueExcerptDigest: { schema: generationDigestSchema },- }) },- programDigest: { schema: generationDigestSchema },});function requestSchema(model: SeedanceModel): ValueSchema {@@ -259,7 +210,6 @@ function requestSchema(model: SeedanceModel): ValueSchema {durationSec: { schema: { kind: "number", integer: true, minimum: 4, maximum: 15 } },generateAudio: { schema: { kind: "boolean" } },webSearch: { schema: { kind: "boolean" } },- requestDigest: { schema: generationDigestSchema },});}@@ -270,7 +220,6 @@ function assertObject(value: unknown): asserts value is Record<string, unknown>}export function verifySeedanceRequest(value: unknown, expectedModel?: SeedanceModel): asserts value is SeedanceRequest {- verifyGenerationRequestDigest(value);assertObject(value);if (value.contract !== "svml.seedance-request@1") throw new Error("Seedance request contract is invalid");if (!seedanceModels.includes(value.model as SeedanceModel)) throw new Error("Seedance model is invalid");@@ -342,7 +291,6 @@ export const seedanceManifest = {schema: generationObjectSchema({contract: { schema: { kind: "literal", value: "svml.seedance-prompt@1" } },text: { schema: generationPromptSchema },- promptDigest: { schema: generationDigestSchema },}),},],@@ -389,11 +337,7 @@ export const seedanceManifest = {{ name: "program", type: seedanceTypes.speechProgram },{ name: "duration", type: contractTypes.speechDuration },],- outputs: [{- name: "request",- type: seedanceEndpointsByModel[model].requestType,- affinity: [{ resultPointer: "/durationSec", input: "duration", inputPointer: "/durationSec" }],- }],+ outputs: [{ name: "request", type: seedanceEndpointsByModel[model].requestType }],needs: [],implementation: {kind: "registered" as const,diff --git a/packages/seedance/src/surface.ts b/packages/seedance/src/surface.tsindex 90cc8577..753d2cfe 100644--- a/packages/seedance/src/surface.ts+++ b/packages/seedance/src/surface.ts@@ -1,6 +1,5 @@import { artifactTypes } from "@svml/artifact";import { contractTypes } from "@svml/contracts";-import { digestOf } from "@svml/protocol";import type { BlobRef, CanonicalValue } from "@svml/protocol";import type {StructuredElement,@@ -219,19 +218,12 @@ function referencePrompt(values: readonly ReferenceInput[]): string {return roles.length === 0 ? "" : `\n\nReference roles:\n${roles.join("\n")}`;}-function dialogueExcerpt(reference: SurfaceResolvedReference, subject: string): {- readonly id: string;- readonly tokenStart: number;- readonly tokenEndExclusive: number;- readonly dialogue: string;- readonly excerptDigest: string;-} {+function dialogueExcerpt(reference: SurfaceResolvedReference, subject: string): { readonly dialogue: string } {if (!sameType(reference.type, contractTypes.narrativeDialogueExcerpt)) {throw new Error(`${subject} must reference a NarrativeDialogueExcerpt such as script.segment.opening.dialogue`);}const value = inline(reference, subject) as unknown as {readonly contract: string;- readonly excerptDigest: string;readonly dialogue?: string;readonly [key: string]: CanonicalValue | undefined;};@@ -244,16 +236,8 @@ function dialogueExcerpt(reference: SurfaceResolvedReference, subject: string):) {throw new Error(`${subject} NarrativeDialogueExcerpt is invalid`);}- const { excerptDigest: _digest, ...content } = value;- if (value.excerptDigest !== digestOf(content)) throw new Error(`${subject} NarrativeDialogueExcerpt digest differs`);if (value.dialogue.trim().length === 0) throw new Error(`${subject} contains no spoken text`);- return {- id: value.id,- tokenStart: value.tokenStart as number,- tokenEndExclusive: value.tokenEndExclusive as number,- dialogue: value.dialogue,- excerptDigest: value.excerptDigest,- };+ return { dialogue: value.dialogue };}function speechDurationReference(@@ -355,12 +339,6 @@ export const decodeSeedanceSpeechSurface: StructuredSurfaceHandler = ({ element,aspectRatio: settings.aspectRatio,generateAudio: true,webSearch: settings.webSearch,- segment: {- id: spoken.id,- tokenStart: spoken.tokenStart,- tokenEndExclusive: spoken.tokenEndExclusive,- dialogueExcerptDigest: spoken.excerptDigest as ReturnType<typeof digestOf>,- },});const id = stringAttribute(element, "id");const programId = `${id}.program`;diff --git a/packages/seedream/src/index.ts b/packages/seedream/src/index.tsindex 4186a953..92ba867c 100644--- a/packages/seedream/src/index.ts+++ b/packages/seedream/src/index.ts@@ -1,14 +1,12 @@import {assertGenerationBlobRef,generationBlobRefSchema,- generationDigestSchema,generationObjectSchema,generationPromptSchema,sealGenerationRequest,- verifyGenerationRequestDigest,} from "@svml/generation";import { defineExactModelModule } from "@svml/model-kit";-import type { BlobRef, Digest, ValueSchema } from "@svml/protocol";+import type { BlobRef, ValueSchema } from "@svml/protocol";export const seedreamModuleRef = { name: "@svml/seedream", version: "0.0.0-dev" } as const;export type SeedreamMode = "text" | "image";@@ -28,7 +26,7 @@ export type SeedreamImageRequestContent = Common & {readonly images: readonly BlobRef[];};export type SeedreamRequestContent = SeedreamTextRequestContent | SeedreamImageRequestContent;-export type SeedreamRequest = SeedreamRequestContent & { readonly requestDigest: Digest };+export type SeedreamRequest = SeedreamRequestContent;const commonFields = {contract: { schema: { kind: "literal", value: "svml.seedream-5-lite-request@1" } },@@ -38,7 +36,6 @@ const commonFields = {quality: { schema: { kind: "literal", value: "basic" } },outputFormat: { schema: { kind: "string", enum: ["png", "jpg"] } },nsfwCheck: { schema: { kind: "boolean" } },- requestDigest: { schema: generationDigestSchema },} as const;const schemas: Record<SeedreamMode, ValueSchema> = {text: generationObjectSchema({@@ -58,7 +55,6 @@ function object(value: unknown): Record<string, unknown> {}export function verifySeedreamRequest(value: unknown, expectedMode?: SeedreamMode): asserts value is SeedreamRequest {- verifyGenerationRequestDigest(value);const request = object(value);if (request.contract !== "svml.seedream-5-lite-request@1" || request.model !== "seedream-5-lite") {throw new Error("Seedream request identity is invalid");@@ -74,7 +70,7 @@ export function verifySeedreamRequest(value: unknown, expectedMode?: SeedreamModexport function sealSeedreamRequest<T extends SeedreamRequestContent>(content: T,-): T & { readonly requestDigest: Digest } {+): T {const request = sealGenerationRequest(content);verifySeedreamRequest(request, content.mode);return request;diff --git a/packages/speech-align/src/locate.ts b/packages/speech-align/src/locate.tsindex 7d7fd4e2..6d308412 100644--- a/packages/speech-align/src/locate.ts+++ b/packages/speech-align/src/locate.ts@@ -14,10 +14,6 @@ import type {TimedSpeechToken,TimingQuality,} from "@svml/contracts";-import {- computeAlignedTranscriptEvidenceDigest,- computeProgramSpaceDigest,-} from "@svml/contracts";import { alignWordGroups } from "./align.js";import { SpeechAlignmentError } from "./error.js";@@ -58,10 +54,6 @@ function validateBasis(narrative: Narrative, basis: SpeechAudioBasis): void {if (basis.contract !== "svml.speech-audio-basis@1") {fail("SPEECH_BASIS_CONTRACT", "Unsupported SpeechAudioBasis contract.");}- const { digest: _programDigest, ...programContent } = basis.programSpace;- if (!isDigest(basis.programSpace.digest) || basis.programSpace.digest !== computeProgramSpaceDigest(programContent)) {- fail("SPEECH_PROGRAM_DIGEST", "ProgramSpace digest does not match its canonical contents.");- }const { numerator, denominator } = basis.programSpace.frameRate;if (!Number.isSafeInteger(numerator) || numerator <= 0 || !Number.isSafeInteger(denominator) || denominator <= 0) {fail("SPEECH_FRAME_RATE", "ProgramSpace frame rate must be a positive rational number.");@@ -102,22 +94,9 @@ function validateEvidence(if (!Number.isFinite(evidence.durationSec) || evidence.durationSec <= 0) {fail("SPEECH_DURATION", "Aligned-transcript duration must be positive and finite.");}- if (!isDigest(evidence.audioArtifactDigest)) {- fail("SPEECH_EVIDENCE_AUDIO", "Aligned transcript has no acoustic Artifact identity.");- }- if (evidence.programSpaceDigest !== basis.programSpace.digest) {- fail("SPEECH_EVIDENCE_PROGRAM", "Aligned transcript uses a different ProgramSpace.");- }if (Math.abs(evidence.durationSec - basis.programSpace.durationSec) > EPSILON) {fail("SPEECH_EVIDENCE_DURATION", "Aligned transcript duration differs from SpeechBasis.");}- const { evidenceDigest: _evidenceDigest, ...evidenceContent } = evidence;- if (- !isDigest(evidence.evidenceDigest)- || evidence.evidenceDigest !== computeAlignedTranscriptEvidenceDigest(evidenceContent)- ) {- fail("SPEECH_EVIDENCE_DIGEST", "Aligned transcript digest does not match its canonical contents.");- }const expected = new Set(narrative.segments.map((segment) => segment.id));const seen = new Set<string>();for (const segment of evidence.segments) {@@ -403,10 +382,6 @@ function assertMonotonic(tokens: readonly TimedSpeechToken[], segmentId: string)}}-function mapDigest(map: Omit<CompleteSemanticMap, "mapDigest">): CompleteSemanticMap["mapDigest"] {- return digestOf(map);-}-function frameFor(basis: SpeechAudioBasis, timeSec: number): number {const { numerator, denominator } = basis.programSpace.frameRate;return Math.round(timeSec * numerator / denominator);@@ -485,7 +460,6 @@ export function locateSpeechTiming(});const payload = {contract: "svml.complete-semantic-map@1" as const,- programSpace: basis.programSpace,quantizationPolicy: "nearest-frame" as const,durationSec: evidence.durationSec,segments: timedSegments,@@ -493,5 +467,5 @@ export function locateSpeechTiming(anchors,groups,};- return { ...payload, mapDigest: mapDigest(payload) };+ return payload;}diff --git a/packages/speech-align/src/manifest.ts b/packages/speech-align/src/manifest.tsindex 760e756a..b07e7133 100644--- a/packages/speech-align/src/manifest.ts+++ b/packages/speech-align/src/manifest.ts@@ -30,13 +30,7 @@ export const speechAlignManifest: ModuleManifest = {{ name: "audio", type: contractTypes.speechAudioBasis },{ name: "evidence", type: contractTypes.alignedTranscriptEvidence },],- outputs: [{- name: "map",- type: contractTypes.completeSemanticMap,- affinity: [- { resultPointer: "/programSpace/digest", input: "audio", inputPointer: "/programSpace/digest" },- ],- }],+ outputs: [{ name: "map", type: contractTypes.completeSemanticMap }],needs: [],implementation: {kind: "registered",diff --git a/packages/speech-align/test/speech-align.test.ts b/packages/speech-align/test/speech-align.test.tsindex 30041b66..43a18b1e 100644--- a/packages/speech-align/test/speech-align.test.ts+++ b/packages/speech-align/test/speech-align.test.ts@@ -33,8 +33,6 @@ function evidence(args: {}): AlignedTranscriptEvidence {return sealAlignedTranscriptEvidence({contract: "svml.aligned-transcript-evidence@1",- audioArtifactDigest: digestOf("fixture:whisperx:acoustic-input"),- programSpaceDigest: args.basis.programSpace.digest,durationSec: args.basis.programSpace.durationSec,segments: [{@@ -59,7 +57,7 @@ function speechBasis(durationSec,frameRate: { numerator: 1_000, denominator: 1 },});- const audioDigest = digestOf(`fixture:audio:${narrative.semanticIndex.digest}:${durationSec}`);+ const audioDigest = digestOf(`fixture:audio:${narrative.segments.map((segment) => segment.id).join("+")}:${durationSec}`);const segments = narrative.segments.map((segment, index) => ({segmentId: segment.id,startSec: windows?.[index]?.startSec ?? durationSec * index / narrative.segments.length,@@ -155,7 +153,7 @@ test("exact transcript words cover every Script and Segment anchor", () => {],);assert.equal(new Set(map.anchors.map((anchor) => anchor.identity)).size, map.anchors.length);- assert.match(map.mapDigest, /^sha256:[a-f0-9]{64}$/u);+ assert.equal(map.contract, "svml.complete-semantic-map@1");});test("M:1 uses evidence character times instead of dividing a merged word by length", () => {@@ -273,8 +271,6 @@ test("multiple Script Segments stay independent even when evidence records arriv]);const map = locateSpeechTiming(narrative, basis, sealAlignedTranscriptEvidence({contract: "svml.aligned-transcript-evidence@1",- audioArtifactDigest: digestOf("fixture:segments:acoustic-input"),- programSpaceDigest: basis.programSpace.digest,durationSec: 2,segments: [{@@ -314,7 +310,7 @@ test("invalid overlapping evidence word windows fail instead of producing a reve);});-test("Evidence is rejected for another coordinate space without replaying hidden provenance", () => {+test("Evidence is interpreted only through the explicitly connected SpeechAudioBasis", () => {const narrative = parseScript("affinity.svml", "<line>Hello world.</line>");const basis = speechBasis(narrative, 2);const mismatched = evidence({@@ -326,10 +322,9 @@ test("Evidence is rejected for another coordinate space without replaying hiddendurationSec: 2,frameRate: { numerator: 30, denominator: 1 },});- assert.throws(- () => locateSpeechTiming(narrative, basis, { ...mismatched, programSpaceDigest: anotherSpace.digest }),- (error: unknown) => error instanceof SpeechAlignmentError && error.code === "SPEECH_EVIDENCE_PROGRAM",- );+ const anotherBasis = { ...basis, programSpace: anotherSpace };+ const map = locateSpeechTiming(narrative, anotherBasis, mismatched);+ assert.equal(map.tokens[0]?.startFrame, 3);});test("the final map is quantized once into the selected ProgramSpace", () => {diff --git a/packages/speech-program/src/component.ts b/packages/speech-program/src/component.tsindex 5ca3dbef..af7a8e52 100644--- a/packages/speech-program/src/component.ts+++ b/packages/speech-program/src/component.ts@@ -31,8 +31,8 @@ export const speechProgramComponent = {{producer: speechProgramProducers.createSet,implementationDigest: createSpeechSpineSetImplementationDigest,- handler: ({ inputs }) => ({- outputs: { set: { kind: "inline", value: canonicalize(createSpeechSpineSet(inline<SpeechSpineProgram>(inputs.program?.value, "SpeechSpineProgram"))) } },+ handler: () => ({+ outputs: { set: { kind: "inline", value: canonicalize(createSpeechSpineSet()) } },needs: {},}),},@@ -42,6 +42,7 @@ export const speechProgramComponent = {handler: ({ inputs }) => ({outputs: { set: { kind: "inline", value: canonicalize(appendSpeechSpineTake(inline<SpeechSpineSet>(inputs.set?.value, "SpeechSpineSet"),+ inline<SpeechSpineProgram>(inputs.program?.value, "SpeechSpineProgram"),inline<SynchronizedMedia>(inputs.media?.value, "SynchronizedMedia"),inline<NarrativeExcerpt>(inputs.segment?.value, "NarrativeExcerpt"),)) } },@@ -52,7 +53,10 @@ export const speechProgramComponent = {producer: speechProgramProducers.compileAudio,implementationDigest: compileSpeechSpineAudioImplementationDigest,handler: ({ inputs }) => ({- outputs: { plan: { kind: "inline", value: canonicalize(compileSpeechSpineAudio(inline<SpeechSpineSet>(inputs.set?.value, "SpeechSpineSet"))) } },+ outputs: { plan: { kind: "inline", value: canonicalize(compileSpeechSpineAudio(+ inline<SpeechSpineProgram>(inputs.program?.value, "SpeechSpineProgram"),+ inline<SpeechSpineSet>(inputs.set?.value, "SpeechSpineSet"),+ )) } },needs: {},}),},@@ -61,6 +65,7 @@ export const speechProgramComponent = {implementationDigest: assembleSpeechBasisImplementationDigest,handler: ({ inputs }) => ({outputs: { basis: { kind: "inline", value: canonicalize(assembleSpeechBasis(+ inline<SpeechSpineProgram>(inputs.program?.value, "SpeechSpineProgram"),inline<SpeechSpineSet>(inputs.set?.value, "SpeechSpineSet"),inline<TimelineAudio>(inputs.audio?.value, "TimelineAudio"),)) } },diff --git a/packages/speech-program/src/fragment.ts b/packages/speech-program/src/fragment.tsindex ab212c87..826c26ac 100644--- a/packages/speech-program/src/fragment.ts+++ b/packages/speech-program/src/fragment.ts@@ -23,7 +23,7 @@ export function createSpeechSpineFragment(options: SpeechSpineFragmentOptions) {const operations: FragmentOperation[] = [{id: "spine:set:empty",producer: speechProgramProducers.createSet,- inputs: { program: input("program") },+ inputs: {},result: { kind: "output", name: "set" },}];let current = "spine:set:empty";@@ -32,7 +32,12 @@ export function createSpeechSpineFragment(options: SpeechSpineFragmentOptions) {operations.push({id,producer: speechProgramProducers.appendTake,- inputs: { set: operation(current), media: input(take.mediaName), segment: input(take.segmentName) },+ inputs: {+ set: operation(current),+ program: input("program"),+ media: input(take.mediaName),+ segment: input(take.segmentName),+ },result: { kind: "output", name: "set" },});current = id;@@ -41,7 +46,7 @@ export function createSpeechSpineFragment(options: SpeechSpineFragmentOptions) {{id: "spine:audio:plan",producer: speechProgramProducers.compileAudio,- inputs: { set: operation(current) },+ inputs: { program: input("program"), set: operation(current) },result: { kind: "output", name: "plan" },},{@@ -53,7 +58,7 @@ export function createSpeechSpineFragment(options: SpeechSpineFragmentOptions) {{id: "spine:basis",producer: speechProgramProducers.assembleBasis,- inputs: { set: operation(current), audio: operation("spine:audio:render") },+ inputs: { program: input("program"), set: operation(current), audio: operation("spine:audio:render") },result: { kind: "output", name: "basis" },},{@@ -96,19 +101,19 @@ export function createSpeechSpineFragment(options: SpeechSpineFragmentOptions) {{ name: "basis", type: contractTypes.speechBasis, root: operation("spine:basis"), semanticInputs, fidelity: "exact" },{name: "space", type: contractTypes.programSpace, root: operation("spine:space"), semanticInputs,- affinity: [{ resultPointer: "/digest", source: operation("spine:basis"), sourcePointer: "/programSpace/digest" }], fidelity: "exact",+ fidelity: "exact",},{name: "audio", type: contractTypes.speechAudioBasis, root: operation("spine:audio-basis"), semanticInputs,- affinity: [{ resultPointer: "/programSpace/digest", source: operation("spine:basis"), sourcePointer: "/programSpace/digest" }], fidelity: "exact",+ fidelity: "exact",},{name: "visual", type: contractTypes.visualTrack, root: operation("spine:visual-track"), semanticInputs,- affinity: [{ resultPointer: "/programSpaceDigest", source: operation("spine:basis"), sourcePointer: "/programSpace/digest" }], fidelity: "exact",+ fidelity: "exact",},{name: "audioTrack", type: contractTypes.audioTrack, root: operation("spine:audio-track"), semanticInputs,- affinity: [{ resultPointer: "/programSpaceDigest", source: operation("spine:basis"), sourcePointer: "/programSpace/digest" }], fidelity: "exact",+ fidelity: "exact",},],});diff --git a/packages/speech-program/src/manifest.ts b/packages/speech-program/src/manifest.tsindex 7fa327ea..91372ffd 100644--- a/packages/speech-program/src/manifest.ts+++ b/packages/speech-program/src/manifest.ts@@ -36,7 +36,6 @@ export const speechProgramProducers = {const string = { kind: "string", minLength: 1 } as const;const integer = { kind: "number", integer: true, minimum: 1 } as const;-const digest = { kind: "string", minLength: 71, maxLength: 71 } as const;const object = (fields: Readonly<Record<string, { readonly schema: ValueSchema; readonly optional?: boolean }>>): ValueSchema => ({kind: "object",fields,@@ -45,24 +44,16 @@ const frameRate = object({ numerator: { schema: integer }, denominator: { schemaexport const speechSpineProgramSchema: ValueSchema = object({contract: { schema: { kind: "literal", value: "svml.speech-spine-program@1" } },- digest: { schema: digest },id: { schema: string },frameRate: { schema: frameRate },});export const speechSpineSetSchema: ValueSchema = object({contract: { schema: { kind: "literal", value: "svml.speech-spine-set@1" } },- digest: { schema: digest },- program: { schema: speechSpineProgramSchema },takes: { schema: { kind: "array", items: object({segment: { schema: narrativeExcerptSchema },media: { schema: synchronizedMediaSchema },}) } },- lastAddition: { schema: object({- previousSetDigest: { schema: digest },- segmentDigest: { schema: digest },- mediaDigest: { schema: digest },- }), optional: true },});export const speechProgramManifest: ModuleManifest = {@@ -100,7 +91,7 @@ export const speechProgramManifest: ModuleManifest = {producers: [{name: speechProgramProducers.createSet.name,- inputs: [{ name: "program", type: speechProgramTypes.spineProgram }],+ inputs: [],outputs: [{ name: "set", type: speechProgramTypes.spineSet }],needs: [],implementation: { kind: "registered", locator: "@svml/speech-program/create-spine-set", digest: createSpeechSpineSetImplementationDigest },@@ -109,24 +100,20 @@ export const speechProgramManifest: ModuleManifest = {name: speechProgramProducers.appendTake.name,inputs: [{ name: "set", type: speechProgramTypes.spineSet },+ { name: "program", type: speechProgramTypes.spineProgram },{ name: "media", type: contractTypes.synchronizedMedia },{ name: "segment", type: contractTypes.narrativeExcerpt },],- outputs: [{- name: "set",- type: speechProgramTypes.spineSet,- affinity: [- { resultPointer: "/lastAddition/previousSetDigest", input: "set", inputPointer: "/digest" },- { resultPointer: "/lastAddition/mediaDigest", input: "media", inputPointer: "/synchronizedMediaDigest" },- { resultPointer: "/lastAddition/segmentDigest", input: "segment", inputPointer: "/excerptDigest" },- ],- }],+ outputs: [{ name: "set", type: speechProgramTypes.spineSet }],needs: [],implementation: { kind: "registered", locator: "@svml/speech-program/append-spine-take", digest: appendSpeechSpineTakeImplementationDigest },},{name: speechProgramProducers.compileAudio.name,- inputs: [{ name: "set", type: speechProgramTypes.spineSet }],+ inputs: [+ { name: "program", type: speechProgramTypes.spineProgram },+ { name: "set", type: speechProgramTypes.spineSet },+ ],outputs: [{ name: "plan", type: mediaPipelineTypes.audioProgramPlan }],needs: [],implementation: { kind: "registered", locator: "@svml/speech-program/compile-spine-audio", digest: compileSpeechSpineAudioImplementationDigest },@@ -134,14 +121,11 @@ export const speechProgramManifest: ModuleManifest = {{name: speechProgramProducers.assembleBasis.name,inputs: [+ { name: "program", type: speechProgramTypes.spineProgram },{ name: "set", type: speechProgramTypes.spineSet },{ name: "audio", type: contractTypes.timelineAudio },],- outputs: [{- name: "basis",- type: contractTypes.speechBasis,- affinity: [{ resultPointer: "/audio/digest", input: "audio", inputPointer: "/artifact/digest" }],- }],+ outputs: [{ name: "basis", type: contractTypes.speechBasis }],needs: [],implementation: { kind: "registered", locator: "@svml/speech-program/assemble-speech-basis", digest: assembleSpeechBasisImplementationDigest },},diff --git a/packages/speech-program/src/program.ts b/packages/speech-program/src/program.tsindex 512c333a..8fe0a93f 100644--- a/packages/speech-program/src/program.ts+++ b/packages/speech-program/src/program.ts@@ -17,8 +17,7 @@ import {verifyAudioProgramPlan,} from "@svml/media-pipeline";import type { AudioProgramPlan } from "@svml/media-pipeline";-import { canonicalize, digestOf, isDigest } from "@svml/protocol";-import type { Digest } from "@svml/protocol";+import { canonicalize, digestOf } from "@svml/protocol";import type {SpeechSpineProgram,@@ -35,7 +34,7 @@ function assert(condition: unknown, message: string): asserts condition {if (!condition) throw new Error(message);}-function programContent(value: Omit<SpeechSpineProgram, "digest">): Omit<SpeechSpineProgram, "digest"> {+function programContent(value: SpeechSpineProgram): SpeechSpineProgram {return {contract: "svml.speech-spine-program@1",id: value.id,@@ -43,9 +42,8 @@ function programContent(value: Omit<SpeechSpineProgram, "digest">): Omit<SpeechS};}-export function sealSpeechSpineProgram(value: Omit<SpeechSpineProgram, "digest">): SpeechSpineProgram {- const content = programContent(value);- return { ...content, digest: digestOf(content) };+export function sealSpeechSpineProgram(value: SpeechSpineProgram): SpeechSpineProgram {+ return programContent(value);}export function assertSpeechSpineProgram(value: SpeechSpineProgram): void {@@ -54,9 +52,6 @@ export function assertSpeechSpineProgram(value: SpeechSpineProgram): void {assert(Number.isSafeInteger(value.frameRate.numerator) && value.frameRate.numerator > 0&& Number.isSafeInteger(value.frameRate.denominator) && value.frameRate.denominator > 0,"SpeechSpineProgram frame rate is invalid");- const { digest: _digest, ...content } = value;- assert(isDigest(value.digest) && value.digest === digestOf(canonicalize(content)),- "SpeechSpineProgram digest differs from its contents");}function verifyExcerpt(value: NarrativeExcerpt): void {@@ -65,23 +60,17 @@ function verifyExcerpt(value: NarrativeExcerpt): void {assert(value.id.length > 0 && Number.isSafeInteger(value.tokenStart)&& Number.isSafeInteger(value.tokenEndExclusive) && value.tokenEndExclusive > value.tokenStart,"Speech Spine Segment excerpt is invalid");- const { excerptDigest: _digest, ...content } = value;- assert(isDigest(value.excerptDigest) && value.excerptDigest === digestOf(canonicalize(content)),- "Speech Spine Segment excerpt digest differs from its contents");}-function setContent(value: Omit<SpeechSpineSet, "digest">): Omit<SpeechSpineSet, "digest"> {+function setContent(value: SpeechSpineSet): SpeechSpineSet {return canonicalize({contract: "svml.speech-spine-set@1",- program: value.program,takes: value.takes,- ...(value.lastAddition === undefined ? {} : { lastAddition: value.lastAddition }),- }) as unknown as Omit<SpeechSpineSet, "digest">;+ }) as unknown as SpeechSpineSet;}-function sealSpeechSpineSet(value: Omit<SpeechSpineSet, "digest">): SpeechSpineSet {- const content = setContent(value);- return { ...content, digest: digestOf(content) };+function sealSpeechSpineSet(value: SpeechSpineSet): SpeechSpineSet {+ return setContent(value);}function assertTake(take: SpeechSpineTake, program: SpeechSpineProgram): void {@@ -96,54 +85,36 @@ function assertTake(take: SpeechSpineTake, program: SpeechSpineProgram): void {export function assertSpeechSpineSet(value: SpeechSpineSet): void {assert(value.contract === "svml.speech-spine-set@1", "Unsupported SpeechSpineSet contract");- assertSpeechSpineProgram(value.program);- const { digest: _digest, ...content } = value;- assert(isDigest(value.digest) && value.digest === digestOf(setContent(content)),- "SpeechSpineSet digest differs from its contents");const segments = new Set<string>();for (const take of value.takes) {- assertTake(take, value.program);+ verifyExcerpt(take.segment);+ verifySynchronizedMedia(take.media);assert(!segments.has(take.segment.id), `Speech Spine repeats Segment ${take.segment.id}`);segments.add(take.segment.id);}- assert(value.takes.length === 0 ? value.lastAddition === undefined : value.lastAddition !== undefined,- "SpeechSpineSet last addition is inconsistent");- if (value.lastAddition !== undefined) {- const last = value.takes.at(-1)!;- assert(isDigest(value.lastAddition.previousSetDigest)- && value.lastAddition.segmentDigest === last.segment.excerptDigest- && value.lastAddition.mediaDigest === last.media.synchronizedMediaDigest,- "SpeechSpineSet last addition is invalid");- }}-export function createSpeechSpineSet(program: SpeechSpineProgram): SpeechSpineSet {- assertSpeechSpineProgram(program);+export function createSpeechSpineSet(): SpeechSpineSet {return sealSpeechSpineSet({contract: "svml.speech-spine-set@1",- program,takes: [],});}export function appendSpeechSpineTake(set: SpeechSpineSet,+ program: SpeechSpineProgram,media: SynchronizedMedia,segment: NarrativeExcerpt,): SpeechSpineSet {assertSpeechSpineSet(set);+ assertSpeechSpineProgram(program);const take = { media, segment } satisfies SpeechSpineTake;- assertTake(take, set.program);+ assertTake(take, program);assert(!set.takes.some((item) => item.segment.id === segment.id), `Speech Spine repeats Segment ${segment.id}`);return sealSpeechSpineSet({contract: "svml.speech-spine-set@1",- program: set.program,takes: [...set.takes, take],- lastAddition: {- previousSetDigest: set.digest,- segmentDigest: segment.excerptDigest,- mediaDigest: media.synchronizedMediaDigest,- },});}@@ -155,28 +126,30 @@ function frameSample(frame: number, frameRate: SpeechSpineProgram["frameRate"]):return Number(rounded);}-function programSpace(set: SpeechSpineSet): ProgramSpace {+function programSpace(program: SpeechSpineProgram, set: SpeechSpineSet): ProgramSpace {+ assertSpeechSpineProgram(program);assertSpeechSpineSet(set);assert(set.takes.length > 0, "Speech Spine must contain at least one Take");+ for (const take of set.takes) assertTake(take, program);const frameCount = set.takes.reduce((sum, take) => sum + take.media.timeline.frameCount, 0);const space = sealProgramSpace({contract: "svml.program-space@0",- durationSec: frameCount * set.program.frameRate.denominator / set.program.frameRate.numerator,- frameRate: { ...set.program.frameRate },+ durationSec: frameCount * program.frameRate.denominator / program.frameRate.numerator,+ frameRate: { ...program.frameRate },});assertProgramSpaceIdentity(space);return space;}-export function compileSpeechSpineAudio(set: SpeechSpineSet): AudioProgramPlan {- const space = programSpace(set);+export function compileSpeechSpineAudio(program: SpeechSpineProgram, set: SpeechSpineSet): AudioProgramPlan {+ const space = programSpace(program, set);let frame = 0;const clips = set.takes.map((take, index) => {const audio = take.media.audio!;const startFrame = frame;frame += take.media.timeline.frameCount;- const targetStartSample = frameSample(startFrame, set.program.frameRate);- const targetEndSampleExclusive = frameSample(frame, set.program.frameRate);+ const targetStartSample = frameSample(startFrame, program.frameRate);+ const targetEndSampleExclusive = frameSample(frame, program.frameRate);assert(targetEndSampleExclusive - targetStartSample === audio.sampleFrames,`Speech Segment ${take.segment.id} audio does not exactly cover its normalized frame span`);return {@@ -194,11 +167,10 @@ export function compileSpeechSpineAudio(set: SpeechSpineSet): AudioProgramPlan {});const plan = sealAudioProgramPlan({contract: "svml.audio-program-plan@1",- programSpaceDigest: space.digest,frameRate: { ...space.frameRate },frameCount: frame,sampleRate: 48_000,- sampleFrames: frameSample(frame, set.program.frameRate),+ sampleFrames: frameSample(frame, program.frameRate),clips,mix: { normalize: false, limiter: "none" },});@@ -206,12 +178,17 @@ export function compileSpeechSpineAudio(set: SpeechSpineSet): AudioProgramPlan {return plan;}-export function assembleSpeechBasis(set: SpeechSpineSet, audio: TimelineAudio): SpeechBasis {- const space = programSpace(set);- const plan = compileSpeechSpineAudio(set);+export function assembleSpeechBasis(+ program: SpeechSpineProgram,+ set: SpeechSpineSet,+ audio: TimelineAudio,+): SpeechBasis {+ const space = programSpace(program, set);verifyTimelineAudio(audio);- assert(audio.planDigest === plan.planDigest && audio.programSpaceDigest === space.digest,- "TimelineAudio does not realize this Speech Spine plan");+ assert(audio.sampleFrames === frameSample(+ set.takes.reduce((sum, take) => sum + take.media.timeline.frameCount, 0),+ program.frameRate,+ ), "TimelineAudio does not cover this Speech Spine");let frame = 0;const seconds = (value: number): number => value * space.frameRate.denominator / space.frameRate.numerator;const segments = set.takes.map((take) => {diff --git a/packages/speech-program/src/speech.ts b/packages/speech-program/src/speech.tsindex f55e9b0b..57d98640 100644--- a/packages/speech-program/src/speech.ts+++ b/packages/speech-program/src/speech.ts@@ -42,7 +42,6 @@ export const speechTakeProjectionFragment = sealGraphFragment({type: contractTypes.programSpace,root: operation("project-program-space"),semanticInputs: ["take"],- affinity: [{ resultPointer: "/digest", source: input("take"), sourcePointer: "/programSpace/digest" }],fidelity: "exact",},{@@ -50,10 +49,6 @@ export const speechTakeProjectionFragment = sealGraphFragment({type: contractTypes.speechAudioBasis,root: operation("project-audio"),semanticInputs: ["take"],- affinity: [- { resultPointer: "/programSpace/digest", source: input("take"), sourcePointer: "/programSpace/digest" },- { resultPointer: "/audio/digest", source: input("take"), sourcePointer: "/audio/digest" },- ],fidelity: "exact",},{@@ -61,9 +56,6 @@ export const speechTakeProjectionFragment = sealGraphFragment({type: contractTypes.visualTrack,root: operation("project-visual"),semanticInputs: ["take"],- affinity: [- { resultPointer: "/programSpaceDigest", source: input("take"), sourcePointer: "/programSpace/digest" },- ],fidelity: "exact",},{@@ -71,9 +63,6 @@ export const speechTakeProjectionFragment = sealGraphFragment({type: contractTypes.audioTrack,root: operation("project-audio-track"),semanticInputs: ["take"],- affinity: [- { resultPointer: "/programSpaceDigest", source: input("take"), sourcePointer: "/programSpace/digest" },- ],fidelity: "exact",},],@@ -96,9 +85,6 @@ export const captionTimingFragment = sealGraphFragment({type: captionTypes.timedProjection,root: operation("temporalize-caption"),semanticInputs: ["narrative", "map"],- affinity: [- { resultPointer: "/programSpace/digest", source: input("map"), sourcePointer: "/programSpace/digest" },- ],fidelity: "exact",}],});@@ -109,21 +95,19 @@ export const captionTrackFragment = sealGraphFragment({inputs: [{ name: "caption", type: captionTypes.timedProjection },{ name: "program", type: captionTypes.trackProgram },+ { name: "space", type: contractTypes.programSpace },],operations: [{id: "render-caption-track",producer: captionProducers.renderTrack,- inputs: { caption: input("caption"), program: input("program") },+ inputs: { caption: input("caption"), program: input("program"), space: input("space") },result: { kind: "output", name: "track" },}],exports: [{name: "track",type: contractTypes.visualTrack,root: operation("render-caption-track"),- semanticInputs: ["caption", "program"],- affinity: [- { resultPointer: "/programSpaceDigest", source: input("caption"), sourcePointer: "/programSpace/digest" },- ],+ semanticInputs: ["caption", "program", "space"],fidelity: "exact",}],});diff --git a/packages/speech-program/src/types.ts b/packages/speech-program/src/types.tsindex ea340b95..d867c972 100644--- a/packages/speech-program/src/types.ts+++ b/packages/speech-program/src/types.ts@@ -2,12 +2,10 @@ import type {NarrativeExcerpt,SynchronizedMedia,} from "@svml/contracts";-import type { Digest } from "@svml/protocol";/** Author-owned policy for one ordered Speech Spine. */export type SpeechSpineProgram = {readonly contract: "svml.speech-spine-program@1";- readonly digest: Digest;readonly id: string;readonly frameRate: {readonly numerator: number;@@ -26,14 +24,7 @@ export type SpeechSpineTake = {*/export type SpeechSpineSet = {readonly contract: "svml.speech-spine-set@1";- readonly digest: Digest;- readonly program: SpeechSpineProgram;readonly takes: readonly SpeechSpineTake[];- readonly lastAddition?: {- readonly previousSetDigest: Digest;- readonly segmentDigest: Digest;- readonly mediaDigest: Digest;- };};export type SpeechSpineInput = {diff --git a/packages/speech-program/test/video-pipeline.test.ts b/packages/speech-program/test/video-pipeline.test.tsindex 63c5558f..60a9bd0d 100644--- a/packages/speech-program/test/video-pipeline.test.ts+++ b/packages/speech-program/test/video-pipeline.test.ts@@ -214,7 +214,6 @@ test("the Speech Program pipeline resumes without repeating paid calls", async (const sourceSampleFrames = Math.round(audio.programSpace.durationSec * 48_000);const need: ProjectSpeechEvidenceAudioNeed = {contract: "svml.project-speech-evidence-audio-request@1",- programSpaceDigest: audio.programSpace.digest,source: {kind: "blob",digest: audio.audio.digest,@@ -328,8 +327,6 @@ test("the Speech Program pipeline resumes without repeating paid calls", async (return {value: { kind: "inline", value: sealSpeechEvidenceAudio({contract: "svml.speech-evidence-audio@1",- programSpaceDigest: request.programSpaceDigest,- sourceAudioArtifactDigest: request.source.digest,artifact: {kind: "blob",digest: digestOf("artifact:evidence-audio"),@@ -350,7 +347,6 @@ test("the Speech Program pipeline resumes without repeating paid calls", async (evidenceSampleFrames: request.evidenceSampleFrames,sourceOriginSample: 0,evidenceOriginSample: 0,- resamplerImplementation: "fixture",},}) },conformance: "exact",@@ -371,14 +367,11 @@ test("the Speech Program pipeline resumes without repeating paid calls", async (() => ({value: {kind: "inline",- value: sealWhisperXAlignmentEvidence({- contract: "svml.whisperx-alignment-evidence@2",- engine: "whisperx",- audioArtifactDigest: digestOf("another-project:audio"),- programSpaceDigest: digestOf("another-project:program-space"),+ value: {+ contract: "invalid-whisperx-evidence",durationSec: 1,segments: [{ sourceSegmentId: "line", startSec: 0, endSec: 1, words: [], chars: [] }],- }),+ },},conformance: "exact",delivery: "executed",@@ -393,7 +386,7 @@ test("the Speech Program pipeline resumes without repeating paid calls", async (parseBuildState(serializeBuildState(atWhisperX.state)),);assert.equal(rejectedEvidence.status, "paused");- assert.match(rejectedEvidence.journal.at(-1)?.message ?? "", /does not match/u);+ assert.match(rejectedEvidence.journal.at(-1)?.message ?? "", /contract/u);const rejectedWhisperNeed = rejectedEvidence.state.needs.find((need) =>sameCapability(need.capability, whisperXCapabilities.alignment));assert(rejectedWhisperNeed);@@ -401,23 +394,19 @@ test("the Speech Program pipeline resumes without repeating paid calls", async (rejectedEvidence.state.records.some((record) =>record.id === rejectedWhisperNeed.result),false,- "Evidence claiming another measured Artifact must not enter BuildState",+ "Invalid Evidence must not enter BuildState",);endpoints.registerImmediateEndpoint("runtime:whisperx-local",whisperXCapabilities.alignment,whisperXTypes.alignmentEvidence,- ({ need }) => {- const request = inlineObject(need.constraints);+ () => {return {value: {kind: "inline",value: sealWhisperXAlignmentEvidence({contract: "svml.whisperx-alignment-evidence@2",- engine: "whisperx",- audioArtifactDigest: (request.audio as { readonly digest: WhisperXAlignmentEvidence["audioArtifactDigest"] }).digest,- programSpaceDigest: request.programSpaceDigest as WhisperXAlignmentEvidence["programSpaceDigest"],durationSec: 1,segments: [{sourceSegmentId: "line",@@ -591,16 +580,10 @@ test("an Existing SpeechTake cuts generation while a visual substitute cuts theassert.equal(producerCount(captionFromExisting, whisperXProducers.request), 1);assert.equal(producerCount(captionFromExisting, captionProducers.temporalize), 1);- const blackProgram = sealProgramSpace({- contract: "svml.program-space@0",- durationSec: 1,- frameRate: { numerator: 30, denominator: 1 },- });const black: VisualTrack = sealVisualTrack({contract: "svml.visual-track@1",visualIr: "svml.hyperframes-visual-ir@1",id: "preview:black",- programSpaceDigest: blackProgram.digest,presents: [],});const blackValue = { kind: "inline" as const, value: black };diff --git a/packages/speech-take/README.md b/packages/speech-take/README.mdindex b52fac03..c9bbbf0a 100644--- a/packages/speech-take/README.md+++ b/packages/speech-take/README.md@@ -2,9 +2,9 @@Reference Product/Projection package for an atomic speech take.-`SpeechBasis` is the indivisible Product that binds audio, visual clips and ProgramSpace; its-`basisDigest` is the Product's own content identity, not an upstream lineage token. Four ordinary-deterministic Producers project it into `ProgramSpace`,+`SpeechBasis` is the indivisible Product that binds audio, visual clips and ProgramSpace. Its+identity belongs to the enclosing Core Record; the domain value does not repeat a self digest or+copy an upstream identity. Four ordinary deterministic Producers project it into `ProgramSpace`,`SpeechAudioBasis`, `VisualTrack` and `AudioTrack`. Core has no Projection primitive and never treatsthese outputs as ports of one mutable workflow node.diff --git a/packages/speech-take/src/manifest.ts b/packages/speech-take/src/manifest.tsindex 0b22e3b0..115350e0 100644--- a/packages/speech-take/src/manifest.ts+++ b/packages/speech-take/src/manifest.ts@@ -37,11 +37,7 @@ export const speechTakeManifest: ModuleManifest = {{name: speechTakeProducers.projectProgramSpace.name,inputs: [{ name: "basis", type: contractTypes.speechBasis }],- outputs: [{- name: "programSpace",- type: contractTypes.programSpace,- affinity: [{ resultPointer: "/digest", input: "basis", inputPointer: "/programSpace/digest" }],- }],+ outputs: [{ name: "programSpace", type: contractTypes.programSpace }],needs: [],implementation: {kind: "registered",@@ -52,14 +48,7 @@ export const speechTakeManifest: ModuleManifest = {{name: speechTakeProducers.projectAudio.name,inputs: [{ name: "basis", type: contractTypes.speechBasis }],- outputs: [{- name: "audio",- type: contractTypes.speechAudioBasis,- affinity: [- { resultPointer: "/programSpace/digest", input: "basis", inputPointer: "/programSpace/digest" },- { resultPointer: "/audio/digest", input: "basis", inputPointer: "/audio/digest" },- ],- }],+ outputs: [{ name: "audio", type: contractTypes.speechAudioBasis }],needs: [],implementation: {kind: "registered",@@ -70,13 +59,7 @@ export const speechTakeManifest: ModuleManifest = {{name: speechTakeProducers.projectVisual.name,inputs: [{ name: "basis", type: contractTypes.speechBasis }],- outputs: [{- name: "visual",- type: contractTypes.visualTrack,- affinity: [- { resultPointer: "/programSpaceDigest", input: "basis", inputPointer: "/programSpace/digest" },- ],- }],+ outputs: [{ name: "visual", type: contractTypes.visualTrack }],needs: [],implementation: {kind: "registered",@@ -87,13 +70,7 @@ export const speechTakeManifest: ModuleManifest = {{name: speechTakeProducers.projectAudioTrack.name,inputs: [{ name: "basis", type: contractTypes.speechBasis }],- outputs: [{- name: "track",- type: contractTypes.audioTrack,- affinity: [- { resultPointer: "/programSpaceDigest", input: "basis", inputPointer: "/programSpace/digest" },- ],- }],+ outputs: [{ name: "track", type: contractTypes.audioTrack }],needs: [],implementation: {kind: "registered",diff --git a/packages/speech-take/src/projection.ts b/packages/speech-take/src/projection.tsindex 35e68e81..6472107c 100644--- a/packages/speech-take/src/projection.ts+++ b/packages/speech-take/src/projection.ts@@ -52,11 +52,11 @@ function frameAt(basis: SpeechBasis, seconds: number): number {export function projectSpeechVisual(basis: SpeechBasis): VisualTrack {assertSpeechBasisIdentity(basis);const totalFrames = programSpaceFrameCount(basis.programSpace);+ const trackId = `speech-visual:${basis.segments.map((segment) => segment.segmentId).join("+")}`;return sealVisualTrack({contract: "svml.visual-track@1",visualIr: "svml.hyperframes-visual-ir@1",- id: `speech-visual:${basis.basisDigest}`,- programSpaceDigest: basis.programSpace.digest,+ id: trackId,presents: basis.visualTrack.clips.map((clip, index) => {const startFrame = frameAt(basis, clip.startSec);const endFrameExclusive = Math.min(totalFrames, frameAt(basis, clip.endSec));@@ -68,7 +68,7 @@ export function projectSpeechVisual(basis: SpeechBasis): VisualTrack {return {id: `${clip.segmentId}:${index + 1}`,span: { startFrame, endFrameExclusive },- stacking: { order: 0, tieBreak: `speech-visual:${basis.basisDigest}:${clip.segmentId}:${index + 1}` },+ stacking: { order: 0, tieBreak: `${trackId}:${clip.segmentId}:${index + 1}` },elements: [{id: "media",order: 0,@@ -91,8 +91,7 @@ export function projectSpeechAudioTrack(basis: SpeechBasis): AudioTrack {assertSpeechBasisIdentity(basis);return sealAudioTrack({contract: "svml.audio-track@1",- id: `speech-audio:${basis.basisDigest}`,- programSpaceDigest: basis.programSpace.digest,+ id: `speech-audio:${basis.segments.map((segment) => segment.segmentId).join("+")}`,clips: [{id: "speech",span: { startFrame: 0, endFrameExclusive: programSpaceFrameCount(basis.programSpace) },diff --git a/packages/speech-take/test/product.test.ts b/packages/speech-take/test/product.test.tsindex 7a793315..d188ffe5 100644--- a/packages/speech-take/test/product.test.ts+++ b/packages/speech-take/test/product.test.ts@@ -160,29 +160,12 @@ function createGraph(program: LinkedProgram): CompiledGraph {type: contractTypes.speechAudioBasis,primary: "opening.audio.project",semanticInputs: [output("opening.take")],- affinity: [- {- resultPointer: "/programSpace/digest",- source: output("opening.take"),- sourcePointer: "/programSpace/digest",- },- {- resultPointer: "/audio/digest",- source: output("opening.take"),- sourcePointer: "/audio/digest",- },- ],},{id: "opening.visual",type: contractTypes.visualTrack,primary: "opening.visual.project",semanticInputs: [output("opening.take")],- affinity: [{- resultPointer: "/programSpaceDigest",- source: output("opening.take"),- sourcePointer: "/programSpace/digest",- }],},],candidates: [@@ -309,9 +292,7 @@ test("SpeechBasis projects to peer generic visual and audio Tracks", () => {const programSpace = projectSpeechProgramSpace(take);assert.equal(visual.contract, "svml.visual-track@1");assert.equal(audio.contract, "svml.audio-track@1");- assert.equal(visual.programSpaceDigest, take.programSpace.digest);- assert.equal(audio.programSpaceDigest, take.programSpace.digest);- assert.equal(programSpace.digest, take.programSpace.digest);+ assert.deepEqual(programSpace, take.programSpace);assert.equal(visual.presents[0]?.span.endFrameExclusive, audio.clips[0]?.span.endFrameExclusive);});diff --git a/packages/store-sqlite/src/store.ts b/packages/store-sqlite/src/store.tsindex 859fab4d..be25dcf3 100644--- a/packages/store-sqlite/src/store.ts+++ b/packages/store-sqlite/src/store.ts@@ -172,6 +172,15 @@ class SqliteBuildStore implements BuildStore {return row === undefined ? undefined : parseBuildSnapshot(row);}+ async list(): Promise<readonly BuildSnapshot[]> {+ const rows = this.#database.prepare(`+ SELECT build_id, revision, state_json+ FROM svml_builds+ ORDER BY build_id ASC+ `).all() as Row[];+ return rows.map(parseBuildSnapshot);+ }+async compareAndSwap(build: string,expectedRevision: number,diff --git a/packages/text-track/src/component.ts b/packages/text-track/src/component.tsindex a30be442..1fdb8f36 100644--- a/packages/text-track/src/component.ts+++ b/packages/text-track/src/component.ts@@ -40,11 +40,8 @@ export const textTrackComponent = {producers: [{producer: textTrackProducers.createSet,implementationDigest: createTextTrackSetImplementationDigest,- handler: ({ inputs }) => ({- outputs: { set: { kind: "inline", value: canonicalize(createTextTrackSet(- inline<ProgramSpace>(inputs.space?.value, "ProgramSpace"),- inline<TextTrackHeader>(inputs.header?.value, "TextTrackHeader"),- )) } }, needs: {},+ handler: () => ({+ outputs: { set: { kind: "inline", value: canonicalize(createTextTrackSet()) } }, needs: {},}),}, {producer: textTrackProducers.appendFull,@@ -52,6 +49,8 @@ export const textTrackComponent = {handler: ({ inputs }) => ({outputs: { set: { kind: "inline", value: canonicalize(appendFullTextItem(inline<TextTrackSet>(inputs.set?.value, "TextTrackSet"),+ inline<TextTrackHeader>(inputs.header?.value, "TextTrackHeader"),+ inline<ProgramSpace>(inputs.space?.value, "ProgramSpace"),inline<TextItemSpec>(inputs.spec?.value, "TextItemSpec"),)) } }, needs: {},}),@@ -61,8 +60,10 @@ export const textTrackComponent = {handler: ({ inputs }) => ({outputs: { set: { kind: "inline", value: canonicalize(appendSelectedTextItem(inline<TextTrackSet>(inputs.set?.value, "TextTrackSet"),+ inline<TextTrackHeader>(inputs.header?.value, "TextTrackHeader"),inline<CompleteSemanticMap>(inputs.map?.value, "CompleteSemanticMap"),inline<NarrativeSelectionRef>(inputs.selection?.value, "NarrativeSelection"),+ inline<ProgramSpace>(inputs.space?.value, "ProgramSpace"),inline<TextItemSpec>(inputs.spec?.value, "TextItemSpec"),)) } }, needs: {},}),@@ -71,6 +72,7 @@ export const textTrackComponent = {implementationDigest: finalizeTextTrackImplementationDigest,handler: ({ inputs }) => ({outputs: { program: { kind: "inline", value: canonicalize(finalizeTextTrack(+ inline<TextTrackHeader>(inputs.header?.value, "TextTrackHeader"),inline<TextTrackSet>(inputs.set?.value, "TextTrackSet"),)) } }, needs: {},}),diff --git a/packages/text-track/src/fragment.ts b/packages/text-track/src/fragment.tsindex 91ad2c28..9e5fc1d7 100644--- a/packages/text-track/src/fragment.ts+++ b/packages/text-track/src/fragment.ts@@ -24,9 +24,6 @@ export const textTrackFragment = sealGraphFragment({type: contractTypes.visualTrack,root: operation("render"),semanticInputs: ["space", "program"],- affinity: [- { resultPointer: "/programSpaceDigest", source: input("space"), sourcePointer: "/digest" },- ],fidelity: "exact",}],});diff --git a/packages/text-track/src/index.ts b/packages/text-track/src/index.tsindex cf459305..3bccb82d 100644--- a/packages/text-track/src/index.ts+++ b/packages/text-track/src/index.ts@@ -26,7 +26,6 @@ export {assertTextTrackSpec,compileTextTrackImplementationDigest,compileTextTrackProgram,- computeTextTrackProgramDigest,renderTextTrack,renderTextTrackImplementationDigest,sealTextTrackProgram,diff --git a/packages/text-track/src/manifest.ts b/packages/text-track/src/manifest.tsindex 994aa684..8e5d23ac 100644--- a/packages/text-track/src/manifest.ts+++ b/packages/text-track/src/manifest.ts@@ -1,6 +1,5 @@import {contractTypes,- programSpaceSchema,videoContractDependencies,visualTrackSchema,} from "@svml/contracts";@@ -38,7 +37,6 @@ const number = { kind: "number" } as const;const positiveNumber = { kind: "number", minimum: 0.000001 } as const;const unsignedInteger = { kind: "number", integer: true, minimum: 0 } as const;const signedInteger = { kind: "number", integer: true } as const;-const digest = { kind: "string", minLength: 71, maxLength: 71 } as const;const object = (fields: Readonly<Record<string, { readonly schema: ValueSchema; readonly optional?: boolean }>>): ValueSchema => ({kind: "object",fields,@@ -78,15 +76,12 @@ const textItemSchema = object({export const textTrackProgramSchema: ValueSchema = object({contract: { schema: { kind: "literal", value: "svml.text-track-program@1" } },- digest: { schema: digest },id: { schema: string },- programSpaceDigest: { schema: digest },items: { schema: { kind: "array", minItems: 1, items: textItemSchema } },});export const textTrackSpecSchema: ValueSchema = object({contract: { schema: { kind: "literal", value: "svml.text-track-spec@1" } },- digest: { schema: digest },id: { schema: string },items: { schema: { kind: "array", minItems: 1, items: object({id: { schema: string },@@ -104,7 +99,6 @@ export const textTrackSpecSchema: ValueSchema = object({const textTrackHeaderSchema: ValueSchema = object({contract: { schema: { kind: "literal", value: "svml.text-track-header@1" } },id: { schema: string },- digest: { schema: digest },});const textItemSpecSchema: ValueSchema = object({@@ -117,21 +111,11 @@ const textItemSpecSchema: ValueSchema = object({widthPercent: { schema: positiveNumber }, heightPercent: { schema: positiveNumber },}) },appearance: { schema: textAppearanceSchema },- digest: { schema: digest },});const textTrackSetSchema: ValueSchema = object({contract: { schema: { kind: "literal", value: "svml.text-track-set@1" } },- id: { schema: string },- programSpace: { schema: programSpaceSchema },items: { schema: { kind: "array", items: textItemSchema } },- lastAddition: { schema: object({- previousSetDigest: { schema: digest },- itemSpecDigest: { schema: digest },- selectionDigest: { schema: digest, optional: true },- mapDigest: { schema: digest, optional: true },- }), optional: true },- digest: { schema: digest },});export const textTrackSurfaceImplementationDigest = digestOf("@svml/text-track/track-surface@2");@@ -162,10 +146,7 @@ export const textTrackManifest: ModuleManifest = {}],producers: [{name: textTrackProducers.createSet.name,- inputs: [- { name: "space", type: contractTypes.programSpace },- { name: "header", type: textTrackTypes.header },- ],+ inputs: [],outputs: [{ name: "set", type: textTrackTypes.set }],needs: [],implementation: { kind: "registered", locator: "@svml/text-track/create-set", digest: createTextTrackSetImplementationDigest },@@ -173,6 +154,8 @@ export const textTrackManifest: ModuleManifest = {name: textTrackProducers.appendFull.name,inputs: [{ name: "set", type: textTrackTypes.set },+ { name: "header", type: textTrackTypes.header },+ { name: "space", type: contractTypes.programSpace },{ name: "spec", type: textTrackTypes.itemSpec },],outputs: [{ name: "set", type: textTrackTypes.set }],@@ -182,8 +165,10 @@ export const textTrackManifest: ModuleManifest = {name: textTrackProducers.appendSelected.name,inputs: [{ name: "set", type: textTrackTypes.set },+ { name: "header", type: textTrackTypes.header },{ name: "map", type: contractTypes.completeSemanticMap },{ name: "selection", type: contractTypes.narrativeSelection },+ { name: "space", type: contractTypes.programSpace },{ name: "spec", type: textTrackTypes.itemSpec },],outputs: [{ name: "set", type: textTrackTypes.set }],@@ -191,11 +176,11 @@ export const textTrackManifest: ModuleManifest = {implementation: { kind: "registered", locator: "@svml/text-track/append-selected", digest: appendSelectedTextItemImplementationDigest },}, {name: textTrackProducers.finalize.name,- inputs: [{ name: "set", type: textTrackTypes.set }],- outputs: [{- name: "program", type: textTrackTypes.program,- affinity: [{ resultPointer: "/programSpaceDigest", input: "set", inputPointer: "/programSpace/digest" }],- }],+ inputs: [+ { name: "header", type: textTrackTypes.header },+ { name: "set", type: textTrackTypes.set },+ ],+ outputs: [{ name: "program", type: textTrackTypes.program }],needs: [],implementation: { kind: "registered", locator: "@svml/text-track/finalize", digest: finalizeTextTrackImplementationDigest },}, {@@ -204,10 +189,7 @@ export const textTrackManifest: ModuleManifest = {{ name: "space", type: contractTypes.programSpace },{ name: "spec", type: textTrackTypes.spec },],- outputs: [{- name: "program", type: textTrackTypes.program,- affinity: [{ resultPointer: "/programSpaceDigest", input: "space", inputPointer: "/digest" }],- }],+ outputs: [{ name: "program", type: textTrackTypes.program }],needs: [],implementation: { kind: "registered", locator: "@svml/text-track/compile", digest: compileTextTrackImplementationDigest },}, {@@ -216,13 +198,7 @@ export const textTrackManifest: ModuleManifest = {{ name: "space", type: contractTypes.programSpace },{ name: "program", type: textTrackTypes.program },],- outputs: [{- name: "track",- type: contractTypes.visualTrack,- affinity: [- { resultPointer: "/programSpaceDigest", input: "space", inputPointer: "/digest" },- ],- }],+ outputs: [{ name: "track", type: contractTypes.visualTrack }],needs: [],implementation: {kind: "registered",diff --git a/packages/text-track/src/program.ts b/packages/text-track/src/program.tsindex 31ea603a..ff6849cb 100644--- a/packages/text-track/src/program.ts+++ b/packages/text-track/src/program.ts@@ -14,8 +14,7 @@ import type {VisualStyleDeclaration,VisualTrack,} from "@svml/contracts";-import { canonicalize, digestOf, isDigest } from "@svml/protocol";-import type { Digest } from "@svml/protocol";+import { canonicalize, digestOf } from "@svml/protocol";import type {TextAppearance,@@ -54,11 +53,10 @@ function normalizeItem(item: TextItem): TextItem {};}-function textTrackProgramContent(value: Omit<TextTrackProgram, "digest">): Omit<TextTrackProgram, "digest"> {+function textTrackProgramContent(value: TextTrackProgram): TextTrackProgram {return {contract: "svml.text-track-program@1",id: value.id,- programSpaceDigest: value.programSpaceDigest,items: [...value.items].map(normalizeItem).sort((left, right) => left.span.startFrame - right.span.startFrame@@ -68,13 +66,8 @@ function textTrackProgramContent(value: Omit<TextTrackProgram, "digest">): Omit<};}-export function computeTextTrackProgramDigest(value: Omit<TextTrackProgram, "digest">): Digest {- return digestOf(textTrackProgramContent(value));-}--export function sealTextTrackProgram(value: Omit<TextTrackProgram, "digest">): TextTrackProgram {- const content = textTrackProgramContent(value);- return { ...content, digest: digestOf(content) };+export function sealTextTrackProgram(value: TextTrackProgram): TextTrackProgram {+ return textTrackProgramContent(value);}function assertAppearance(appearance: TextAppearance, label: string): void {@@ -109,13 +102,6 @@ export function assertTextTrackProgramIdentity(program: TextTrackProgram, prograassertProgramSpaceIdentity(programSpace);if (program.contract !== "svml.text-track-program@1") throw new Error("Unsupported TextTrackProgram contract.");assertNonEmpty(program.id, "TextTrackProgram id");- if (program.programSpaceDigest !== programSpace.digest) {- throw new Error("TextTrackProgram belongs to another ProgramSpace.");- }- const { digest: _digest, ...content } = program;- if (!isDigest(program.digest) || program.digest !== computeTextTrackProgramDigest(content)) {- throw new Error("TextTrackProgram digest does not match its contents.");- }if (program.items.length === 0) throw new Error("TextTrackProgram must contain at least one item.");const totalFrames = programSpaceFrameCount(programSpace);const ids = new Set<string>();@@ -181,12 +167,11 @@ function textStyle(appearance: TextAppearance): VisualStyleDeclaration[] {];}-export function sealTextTrackSpec(value: Omit<TextTrackSpec, "digest">): TextTrackSpec {- const content = canonicalSpec(value);- return { ...content, digest: digestOf(content) };+export function sealTextTrackSpec(value: TextTrackSpec): TextTrackSpec {+ return canonicalSpec(value);}-function canonicalSpec(value: Omit<TextTrackSpec, "digest">): Omit<TextTrackSpec, "digest"> {+function canonicalSpec(value: TextTrackSpec): TextTrackSpec {return {contract: "svml.text-track-spec@1",id: value.id,@@ -205,10 +190,6 @@ export function assertTextTrackSpec(spec: TextTrackSpec): void {if (spec.contract !== "svml.text-track-spec@1" || !spec.id || spec.items.length === 0) {throw new Error("TextTrackSpec identity or items are invalid.");}- const { digest: _digest, ...content } = spec;- if (!isDigest(spec.digest) || spec.digest !== digestOf(canonicalSpec(content))) {- throw new Error("TextTrackSpec digest differs from its contents.");- }const ids = new Set<string>();for (const item of spec.items) {if (!item.id || !item.text || item.during !== "full" || ids.has(item.id) || !Number.isSafeInteger(item.z)) {@@ -226,7 +207,6 @@ export function compileTextTrackProgram(programSpace: ProgramSpace, spec: TextTrreturn sealTextTrackProgram({contract: "svml.text-track-program@1",id: spec.id,- programSpaceDigest: programSpace.digest,items: spec.items.map((item) => ({id: item.id,text: item.text,@@ -245,7 +225,6 @@ export function renderTextTrack(programSpace: ProgramSpace, program: TextTrackPrcontract: "svml.visual-track@1",visualIr: "svml.hyperframes-visual-ir@1",id: program.id,- programSpaceDigest: programSpace.digest,presents: program.items.map((item) => ({id: item.id,span: { ...item.span },@@ -260,70 +239,39 @@ export function renderTextTrack(programSpace: ProgramSpace, program: TextTrackPrreturn track;}-function contentDigest<T extends object>(value: T): Digest {- return digestOf(canonicalize(value));-}--export function sealTextTrackHeader(value: Omit<TextTrackHeader, "digest">): TextTrackHeader {- const content = canonicalize(value) as unknown as Omit<TextTrackHeader, "digest">;- const result = { ...content, digest: digestOf(content) };+export function sealTextTrackHeader(value: TextTrackHeader): TextTrackHeader {+ const result = canonicalize(value) as unknown as TextTrackHeader;assertTextTrackHeader(result);return result;}export function assertTextTrackHeader(value: TextTrackHeader): void {- const { digest: _digest, ...content } = value;if (value.contract !== "svml.text-track-header@1"|| value.id.length === 0- || !isDigest(value.digest)- || value.digest !== contentDigest(content)) throw new Error("TextTrackHeader is invalid");}-export function sealTextItemSpec(value: Omit<TextItemSpec, "digest">): TextItemSpec {- const content = canonicalize(value) as unknown as Omit<TextItemSpec, "digest">;- const result = { ...content, digest: digestOf(content) };+export function sealTextItemSpec(value: TextItemSpec): TextItemSpec {+ const result = canonicalize(value) as unknown as TextItemSpec;assertTextItemSpec(result);return result;}export function assertTextItemSpec(value: TextItemSpec): void {- const { digest: _digest, ...content } = value;if (value.contract !== "svml.text-item-spec@1"|| value.id.length === 0|| value.text.length === 0|| !Number.isSafeInteger(value.z)- || !isDigest(value.digest)- || value.digest !== contentDigest(content)) throw new Error("TextItemSpec is invalid");for (const [name, number] of Object.entries(value.box)) assertFinite(number, `${value.id} box.${name}`);if (value.box.widthPercent <= 0 || value.box.heightPercent <= 0) throw new Error("TextItemSpec box is invalid");assertAppearance(value.appearance, `${value.id} appearance`);}-function setContent(value: Omit<TextTrackSet, "digest">): Omit<TextTrackSet, "digest"> {- return canonicalize(value) as unknown as Omit<TextTrackSet, "digest">;-}--function sealTextTrackSet(value: Omit<TextTrackSet, "digest">): TextTrackSet {- const content = setContent(value);- return { ...content, digest: digestOf(content) };-}-export function assertTextTrackSet(value: TextTrackSet): void {- if (value.contract !== "svml.text-track-set@1" || value.id.length === 0) {- throw new Error("TextTrackSet identity is invalid");- }- assertProgramSpaceIdentity(value.programSpace);- const { digest: _digest, ...content } = value;- if (!isDigest(value.digest) || value.digest !== digestOf(setContent(content))) {- throw new Error("TextTrackSet digest differs from its contents");- }- if (value.items.length === 0 ? value.lastAddition !== undefined : value.lastAddition === undefined) {- throw new Error("TextTrackSet last addition is inconsistent");- }+ if (value.contract !== "svml.text-track-set@1") throw new Error("TextTrackSet is invalid");const ids = new Set<string>();for (const item of value.items) {if (ids.has(item.id)) throw new Error(`TextTrackSet repeats Item ${item.id}`);@@ -331,38 +279,26 @@ export function assertTextTrackSet(value: TextTrackSet): void {}}-export function createTextTrackSet(space: ProgramSpace, header: TextTrackHeader): TextTrackSet {- assertProgramSpaceIdentity(space);- assertTextTrackHeader(header);- return sealTextTrackSet({+export function createTextTrackSet(): TextTrackSet {+ return {contract: "svml.text-track-set@1",- id: header.id,- programSpace: space,items: [],- });+ };}function appendItems(set: TextTrackSet,spec: TextItemSpec,additions: readonly TextItem[],- affinity: { readonly selectionDigest?: Digest; readonly mapDigest?: Digest } = {},): TextTrackSet {assertTextTrackSet(set);assertTextItemSpec(spec);const existing = new Set(set.items.map((item) => item.id));if (additions.some((item) => existing.has(item.id))) throw new Error(`Text Item ${spec.id} is duplicated`);- return sealTextTrackSet({+ return {contract: "svml.text-track-set@1",- id: set.id,- programSpace: set.programSpace,items: [...set.items, ...additions],- lastAddition: {- previousSetDigest: set.digest,- itemSpecDigest: spec.digest,- ...affinity,- },- });+ };}function itemFromSpec(spec: TextItemSpec, id: string, span: TextItem["span"], tieBreak: string): TextItem {@@ -377,46 +313,53 @@ function itemFromSpec(spec: TextItemSpec, id: string, span: TextItem["span"], ti};}-export function appendFullTextItem(set: TextTrackSet, spec: TextItemSpec): TextTrackSet {+export function appendFullTextItem(+ set: TextTrackSet,+ header: TextTrackHeader,+ space: ProgramSpace,+ spec: TextItemSpec,+): TextTrackSet {assertTextTrackSet(set);+ assertTextTrackHeader(header);+ assertProgramSpaceIdentity(space);return appendItems(set, spec, [itemFromSpec(spec,spec.id,- { startFrame: 0, endFrameExclusive: programSpaceFrameCount(set.programSpace) },- `${set.id}:${spec.id}:1`,+ { startFrame: 0, endFrameExclusive: programSpaceFrameCount(space) },+ `${header.id}:${spec.id}:1`,)]);}export function appendSelectedTextItem(set: TextTrackSet,+ header: TextTrackHeader,map: CompleteSemanticMap,selection: NarrativeSelectionRef,+ space: ProgramSpace,spec: TextItemSpec,): TextTrackSet {assertTextTrackSet(set);+ assertTextTrackHeader(header);assertCompleteSemanticMapIdentity(map);assertNarrativeSelectionIdentity(selection);- if (map.programSpace.digest !== set.programSpace.digest) {- throw new Error("Text Selection map belongs to another ProgramSpace");- }- const spans = selectionFrameSpans(map, selection);+ assertProgramSpaceIdentity(space);+ const spans = selectionFrameSpans(map, selection, space);return appendItems(set, spec, spans.map((span, index) => itemFromSpec(spec,spans.length === 1 ? spec.id : `${spec.id}:${index + 1}`,span,- `${set.id}:${spec.id}:${index + 1}`,- )), { selectionDigest: selection.selectionDigest, mapDigest: map.mapDigest });+ `${header.id}:${spec.id}:${index + 1}`,+ )));}-export function finalizeTextTrack(set: TextTrackSet): TextTrackProgram {+export function finalizeTextTrack(header: TextTrackHeader, set: TextTrackSet): TextTrackProgram {+ assertTextTrackHeader(header);assertTextTrackSet(set);if (set.items.length === 0) throw new Error("TextTrack requires at least one Item");const program = sealTextTrackProgram({contract: "svml.text-track-program@1",- id: set.id,- programSpaceDigest: set.programSpace.digest,+ id: header.id,items: set.items,});- assertTextTrackProgramIdentity(program, set.programSpace);return program;}diff --git a/packages/text-track/src/surface.ts b/packages/text-track/src/surface.tsindex 99342527..a73f09df 100644--- a/packages/text-track/src/surface.ts+++ b/packages/text-track/src/surface.ts@@ -23,7 +23,7 @@ function createTextTrackSurfaceFragment(id: string, items: readonly SurfaceItem[const operations: FragmentOperation[] = [{id: "text:set:empty",producer: textTrackProducers.createSet,- inputs: { space: input("space"), header: input("header") },+ inputs: {},result: { kind: "output", name: "set" },}];let current = "text:set:empty";@@ -32,15 +32,17 @@ function createTextTrackSurfaceFragment(id: string, items: readonly SurfaceItem[operations.push(item.selectionName === undefined ? {id: operationId,producer: textTrackProducers.appendFull,- inputs: { set: operation(current), spec: input(item.specName) },+ inputs: { set: operation(current), header: input("header"), space: input("space"), spec: input(item.specName) },result: { kind: "output", name: "set" },} : {id: operationId,producer: textTrackProducers.appendSelected,inputs: {set: operation(current),+ header: input("header"),map: input("map"),selection: input(item.selectionName),+ space: input("space"),spec: input(item.specName),},result: { kind: "output", name: "set" },@@ -48,7 +50,7 @@ function createTextTrackSurfaceFragment(id: string, items: readonly SurfaceItem[current = operationId;});operations.push(- { id: "text:finalize", producer: textTrackProducers.finalize, inputs: { set: operation(current) }, result: { kind: "output", name: "program" } },+ { id: "text:finalize", producer: textTrackProducers.finalize, inputs: { header: input("header"), set: operation(current) }, result: { kind: "output", name: "program" } },{ id: "text:render", producer: textTrackProducers.render, inputs: { space: input("space"), program: operation("text:finalize") }, result: { kind: "output", name: "track" } },);const semanticInputs = ["space", "header", ...(selected.length === 0 ? [] : ["map"]),@@ -66,8 +68,7 @@ function createTextTrackSurfaceFragment(id: string, items: readonly SurfaceItem[],operations,exports: [{- name: "track", type: contractTypes.visualTrack, root: operation("text:render"), semanticInputs,- affinity: [{ resultPointer: "/programSpaceDigest", source: input("space"), sourcePointer: "/digest" }], fidelity: "exact",+ name: "track", type: contractTypes.visualTrack, root: operation("text:render"), semanticInputs, fidelity: "exact",}],});}diff --git a/packages/text-track/src/types.ts b/packages/text-track/src/types.tsindex 5145c36b..f9ec3491 100644--- a/packages/text-track/src/types.ts+++ b/packages/text-track/src/types.ts@@ -1,5 +1,4 @@-import type { FrameSpan, ProgramSpace } from "@svml/contracts";-import type { Digest } from "@svml/protocol";+import type { FrameSpan } from "@svml/contracts";export type TextBox = {readonly xPercent: number;@@ -35,15 +34,12 @@ export type TextItem = {/** Package-owned authoring value. A future Text Surface or SVS recipe may produce it. */export type TextTrackProgram = {readonly contract: "svml.text-track-program@1";- readonly digest: Digest;readonly id: string;- readonly programSpaceDigest: Digest;readonly items: readonly TextItem[];};export type TextTrackSpec = {readonly contract: "svml.text-track-spec@1";- readonly digest: Digest;readonly id: string;readonly items: readonly {readonly id: string;@@ -59,7 +55,6 @@ export type TextTrackSpec = {export type TextTrackHeader = {readonly contract: "svml.text-track-header@1";readonly id: string;- readonly digest: Digest;};/** Appearance and content are authored here; timing remains an explicit graph input. */@@ -70,20 +65,10 @@ export type TextItemSpec = {readonly z: number;readonly box: TextBox;readonly appearance: TextAppearance;- readonly digest: Digest;};/** Package-private immutable fold value for any number of full or selected Items. */export type TextTrackSet = {readonly contract: "svml.text-track-set@1";- readonly id: string;- readonly programSpace: ProgramSpace;readonly items: readonly TextItem[];- readonly lastAddition?: {- readonly previousSetDigest: Digest;- readonly itemSpecDigest: Digest;- readonly selectionDigest?: Digest;- readonly mapDigest?: Digest;- };- readonly digest: Digest;};diff --git a/packages/text-track/test/text-track.test.ts b/packages/text-track/test/text-track.test.tsindex dfc830f2..0a0438e9 100644--- a/packages/text-track/test/text-track.test.ts+++ b/packages/text-track/test/text-track.test.ts@@ -7,7 +7,6 @@ import {sealVisualTrack,} from "@svml/contracts";import { compileHyperframesDocument } from "@svml/hyperframes";-import { digestOf } from "@svml/protocol";import {appendSelectedTextItem,createTextTrackSet,@@ -19,7 +18,6 @@ import {sealTextTrackHeader,} from "@svml/text-track";import type { CompleteSemanticMap, NarrativeSelectionRef } from "@svml/contracts";-import { canonicalize } from "@svml/protocol";const space = sealProgramSpace({contract: "svml.program-space@0",@@ -31,7 +29,6 @@ test("persistent and timed text are ordinary Presents in one VisualTrack", () =>const program = sealTextTrackProgram({contract: "svml.text-track-program@1",id: "editorial-text",- programSpaceDigest: space.digest,items: [{id: "watermark",@@ -71,7 +68,6 @@ test("persistent and timed text are ordinary Presents in one VisualTrack", () =>contract: "svml.visual-track@1",visualIr: "svml.hyperframes-visual-ir@1",id: "lower",- programSpaceDigest: space.digest,presents: [{id: "lower",span: { startFrame: 0, endFrameExclusive: 150 },@@ -82,10 +78,9 @@ test("persistent and timed text are ordinary Presents in one VisualTrack", () =>const document = compileHyperframesDocument(sealComposition({contract: "svml.composition@1",id: "text-film",- programSpace: space,canvas: { width: 1080, height: 1920, clearColor: "#000000" },tracks: [track, lower],- }));+ }), space);assert.match(document.html, /Intent, not timeline/u);assert.match(document.html, /font-family:Inter, sans-serif/u);assert.ok(document.html.indexOf('data-svml-present-id="lower"') < document.html.indexOf('data-svml-present-id="callout"'));@@ -95,7 +90,6 @@ test("TextTrackProgram rejects a frame span outside its ProgramSpace", () => {const program = sealTextTrackProgram({contract: "svml.text-track-program@1",id: "invalid-text",- programSpaceDigest: space.digest,items: [{id: "late",text: "Too late",@@ -112,7 +106,6 @@ test("TextTrackProgram rejects a frame span outside its ProgramSpace", () => {test("a selected Text Item is located only through explicit Selection and SemanticMap edges", () => {const mapContent = {contract: "svml.complete-semantic-map@1" as const,- programSpace: space,quantizationPolicy: "nearest-frame" as const,durationSec: 5,segments: [{@@ -132,10 +125,7 @@ test("a selected Text Item is located only through explicit Selection and Semantanchors: [],groups: [],};- const map: CompleteSemanticMap = {- ...mapContent,- mapDigest: digestOf(canonicalize(mapContent)),- };+ const map: CompleteSemanticMap = mapContent;const selectionContent = {contract: "svml.narrative-selection@1" as const,id: "callout",@@ -145,10 +135,7 @@ test("a selected Text Item is located only through explicit Selection and Semantclose: { affinity: "left" as const, boundary: { tokenIndex: 2, structuralPosition: 2, segmentId: "opening" } },}],};- const selection: NarrativeSelectionRef = {- ...selectionContent,- selectionDigest: digestOf(canonicalize(selectionContent)),- };+ const selection: NarrativeSelectionRef = selectionContent;const header = sealTextTrackHeader({ contract: "svml.text-track-header@1", id: "selected-text" });const spec = sealTextItemSpec({contract: "svml.text-item-spec@1",@@ -158,10 +145,12 @@ test("a selected Text Item is located only through explicit Selection and Semantbox: { xPercent: 10, yPercent: 10, widthPercent: 80, heightPercent: 10 },appearance: { color: "#ffffff", fontSizePx: 48 },});- const program = finalizeTextTrack(appendSelectedTextItem(- createTextTrackSet(space, header),+ const program = finalizeTextTrack(header, appendSelectedTextItem(+ createTextTrackSet(),+ header,map,selection,+ space,spec,));assert.deepEqual(program.items.map((item) => item.span), [{ startFrame: 30, endFrameExclusive: 60 }]);diff --git a/packages/transport-aws-lambda/README.md b/packages/transport-aws-lambda/README.mdindex 83cf5376..d529ef6f 100644--- a/packages/transport-aws-lambda/README.md+++ b/packages/transport-aws-lambda/README.md@@ -8,7 +8,7 @@ Endpoint-specific code owns:- the request/response schema;- whether one call completes work or returns a remote checkpoint;- conversion into `EndpointOutcome`;-- artifact locations and affinity validation;+- artifact locations and intrinsic result validation;- the function name, version/alias and retry semantics included in Endpoint configuration identity.The transport always uses `RequestResponse`. Lambda `Event` invocation has its own at-least-oncediff --git a/packages/video-cli/README.md b/packages/video-cli/README.mdindex 0890a25c..02b880be 100644--- a/packages/video-cli/README.md+++ b/packages/video-cli/README.md@@ -1,7 +1,7 @@# `@svml/video-cli`-Official v2 video command application. It selects the Text compiler Host and the video-Runtime-config adapter registry, but deliberately carries no built-in author or Run package.+Official v2 video command application. It selects the Text compiler Host, but deliberately carries+no built-in author, Run, Provider or Store package.Every Frontend, Surface, deterministic Producer and Validator is activated from an explicit`svml.packages.lock`. Installing a new author package therefore does not require a video CLI or Core@@ -13,6 +13,8 @@ From the repository:```bashpnpm svml:v2 lock-packages ./svml.packages.lock \--package @svml/run-text --package @svml/script --package @example/cards --root .+pnpm svml:v2 lock-packages ./svml.runtime-packages.lock \+ --package @svml/provider-kie --package @svml/provider-media-local --root .pnpm svml:v2 check path/to/main.svml --package-lock ./svml.packages.lock --root .pnpm svml:v2 check path/to/build.svrun --package-lock ./svml.packages.lock --root .pnpm svml:v2 plan path/to/build.svrun --package-lock ./svml.packages.lock --root .@@ -23,6 +25,8 @@ pnpm svml:v2 builds --runtime ./svml.runtime.jsonpnpm svml:v2 inspect <build-id> --runtime ./svml.runtime.jsonpnpm svml:v2 get <build-id> --name final.video --runtime ./svml.runtime.json --to ./final.mp4pnpm svml:v2 cancel <build-id> --runtime ./svml.runtime.json+pnpm svml:v2 doctor ./svml.runtime.json+pnpm svml:v2 gc ./svml.runtime.json````check` is usable for an Author Source or a complete Run Source. `plan` and `build` require a Run@@ -32,9 +36,11 @@ fabricates a Target, Candidate or missing fact.`build` compiles the same locked BuildState and passes it to a trusted local Runtime Profile.The default Build identity is content-derived, so the same invocation resumes durable local state;-`--build-id take-02` names an explicit take. JSON Profiles resolve only adapters registered by the-Host and contain no executable callback. A TypeScript config module remains trusted deployment code-with normal Node authority. Neither form is discovered from a source import.+`--build-id take-02` names an explicit take. JSON Profiles resolve only adapters in their separately+verified `runtimePackageLock` and contain no executable callback. The CLI imports no Provider;+loaded Runtime implementation identity is rebound to the actual package bytes. A TypeScript config+module remains trusted deployment code with normal Node authority. Neither form is discovered from+a source import.Without `--follow`, a pending remote job returns `paused` and a later identical command resumes it.With `--follow`, the CLI stays attached and follows endpoint `wakeAt` hints until completion, a@@ -56,7 +62,7 @@ always resolve the alias back through the verified BuildState before accepting iHistorical Records, fixed files and generated previews are declared as ordinary Candidates in theRun Source and selected by explicit Satisfaction edges. The Host verifies a referenced prior Build-only to extract the declared typed Record; it does not prove semantic affinity with the current+only to extract the declared typed Record; it does not prove a semantic relationship with the currentoutput. Upstream work behind the selected Candidate is pruned by reverse reachability, while everyunbound reachable output follows the ordinary graph. This is a new Build identity and never resumesor copies the prior Build's outstanding Commands.diff --git a/packages/video-cli/package.json b/packages/video-cli/package.jsonindex 6e868965..4c4e7603 100644--- a/packages/video-cli/package.json+++ b/packages/video-cli/package.json@@ -7,16 +7,11 @@".": "./src/index.ts"},"dependencies": {- "@svml/artifact-store-s3": "workspace:*","@svml/cli": "workspace:*","@svml/compiler-text-node": "workspace:*",- "@svml/local": "workspace:*",- "@svml/provider-google-vertex": "workspace:*",- "@svml/provider-hyperframes-local": "workspace:*",- "@svml/provider-kie": "workspace:*",- "@svml/provider-media-local": "workspace:*",- "@svml/provider-whisperx-local": "workspace:*",- "@svml/protocol": "workspace:*",- "@svml/runtime": "workspace:*"+ "@svml/local": "workspace:*"+ },+ "devDependencies": {+ "@svml/package-loader-node": "workspace:*"}}diff --git a/packages/video-cli/src/distribution.ts b/packages/video-cli/src/distribution.tsindex 54377519..824b10ba 100644--- a/packages/video-cli/src/distribution.ts+++ b/packages/video-cli/src/distribution.ts@@ -3,6 +3,7 @@ import {createVideoCompiler,videoBuiltInPackageContributions,} from "./compiler.js";+import { doctorRuntimeConfig } from "@svml/local";import { createVideoRuntimeFromConfig } from "./runtime-config.js";/** Official video authoring and local Runtime-adapter assembly for the generic CLI engine. */@@ -12,4 +13,5 @@ export const videoCliDistribution: CliDistribution = {runFrontends: [],createCompiler: createVideoCompiler,createRuntimeFromConfig: createVideoRuntimeFromConfig,+ doctorRuntimeConfig,};diff --git a/packages/video-cli/src/index.ts b/packages/video-cli/src/index.tsindex e28164ad..2311ca97 100644--- a/packages/video-cli/src/index.ts+++ b/packages/video-cli/src/index.ts@@ -13,7 +13,6 @@ export {videoBuiltInPackageContributions,} from "./compiler.js";export {- createVideoRuntimeConfigRegistry,createVideoRuntimeFromConfig,} from "./runtime-config.js";export { videoCliDistribution } from "./distribution.js";diff --git a/packages/video-cli/src/runtime-config.ts b/packages/video-cli/src/runtime-config.tsindex 4750deb5..fbcb03f1 100644--- a/packages/video-cli/src/runtime-config.ts+++ b/packages/video-cli/src/runtime-config.ts@@ -1,170 +1,9 @@-import { createS3ArtifactStorePackage } from "@svml/artifact-store-s3";-import {- RuntimeConfigRegistry,- createRuntimeFromConfig,-} from "@svml/local";-import type { RuntimeConfigFactoryContext } from "@svml/local";-import { createGoogleVertexCaptionProvider } from "@svml/provider-google-vertex";-import { createLocalHyperframesProvider } from "@svml/provider-hyperframes-local";-import { createKieProvider } from "@svml/provider-kie";-import { createLocalMediaProvider } from "@svml/provider-media-local";-import { createLocalWhisperXProvider } from "@svml/provider-whisperx-local";-import type { CanonicalValue } from "@svml/protocol";-import { credentialRef } from "@svml/runtime";--function object(value: CanonicalValue, subject: string): Record<string, CanonicalValue> {- if (value === null || typeof value !== "object" || Array.isArray(value)) throw new Error(`${subject} config must be an object`);- return value as Record<string, CanonicalValue>;-}--function exact(value: Record<string, CanonicalValue>, allowed: readonly string[], subject: string): void {- const unknown = Object.keys(value).filter((key) => !allowed.includes(key));- if (unknown.length > 0) throw new Error(`${subject} config does not accept ${unknown[0]}`);-}--function string(value: CanonicalValue | undefined, subject: string): string | undefined {- if (value === undefined) return undefined;- if (typeof value !== "string" || value.trim().length === 0) throw new Error(`${subject} must be a non-empty string`);- return value;-}--function number(value: CanonicalValue | undefined, subject: string): number | undefined {- if (value === undefined) return undefined;- if (typeof value !== "number" || !Number.isSafeInteger(value) || value <= 0) throw new Error(`${subject} must be a positive integer`);- return value;-}--function boolean(value: CanonicalValue | undefined, subject: string): boolean | undefined {- if (value === undefined) return undefined;- if (typeof value !== "boolean") throw new Error(`${subject} must be a boolean`);- return value;-}--function common(context: RuntimeConfigFactoryContext): { readonly instance: string; readonly lane?: string } {- return { instance: context.instance, ...(context.lane === undefined ? {} : { lane: context.lane }) };-}--export function createVideoRuntimeConfigRegistry(): RuntimeConfigRegistry {- const registry = new RuntimeConfigRegistry();- registry.registerEndpoint("@svml/provider-kie", (context) => {- const config = object(context.config, "KIE");- exact(config, [- "apiBaseUrl", "uploadBaseUrl", "apiKeyEnv", "defaultConcurrency", "pollIntervalMs",- "submissionIntervalMs", "requestTimeoutMs", "maxOperationMs", "maxArtifactBytes",- ], "KIE");- const apiKeyEnv = string(config.apiKeyEnv, "KIE apiKeyEnv");- return createKieProvider({- ...common(context),- ...(string(config.apiBaseUrl, "KIE apiBaseUrl") === undefined ? {} : { apiBaseUrl: config.apiBaseUrl as string }),- ...(string(config.uploadBaseUrl, "KIE uploadBaseUrl") === undefined ? {} : { uploadBaseUrl: config.uploadBaseUrl as string }),- ...(apiKeyEnv === undefined ? {} : { apiKey: credentialRef("env", apiKeyEnv) }),- ...(number(config.defaultConcurrency, "KIE defaultConcurrency") === undefined ? {} : { defaultConcurrency: config.defaultConcurrency as number }),- ...(number(config.pollIntervalMs, "KIE pollIntervalMs") === undefined ? {} : { pollIntervalMs: config.pollIntervalMs as number }),- ...(number(config.submissionIntervalMs, "KIE submissionIntervalMs") === undefined ? {} : { submissionIntervalMs: config.submissionIntervalMs as number }),- ...(number(config.requestTimeoutMs, "KIE requestTimeoutMs") === undefined ? {} : { requestTimeoutMs: config.requestTimeoutMs as number }),- ...(number(config.maxOperationMs, "KIE maxOperationMs") === undefined ? {} : { maxOperationMs: config.maxOperationMs as number }),- ...(number(config.maxArtifactBytes, "KIE maxArtifactBytes") === undefined ? {} : { maxArtifactBytes: config.maxArtifactBytes as number }),- });- });- registry.registerEndpoint("@svml/provider-media-local", (context) => {- const config = object(context.config, "local media");- exact(config, ["ffmpegPath", "ffprobePath", "defaultConcurrency", "processTimeoutMs", "maxProbeOutputBytes"], "local media");- return createLocalMediaProvider({- ...common(context),- ...(string(config.ffmpegPath, "media ffmpegPath") === undefined ? {} : { ffmpegPath: config.ffmpegPath as string }),- ...(string(config.ffprobePath, "media ffprobePath") === undefined ? {} : { ffprobePath: config.ffprobePath as string }),- ...(number(config.defaultConcurrency, "media defaultConcurrency") === undefined ? {} : { defaultConcurrency: config.defaultConcurrency as number }),- ...(number(config.processTimeoutMs, "media processTimeoutMs") === undefined ? {} : { processTimeoutMs: config.processTimeoutMs as number }),- ...(number(config.maxProbeOutputBytes, "media maxProbeOutputBytes") === undefined ? {} : { maxProbeOutputBytes: config.maxProbeOutputBytes as number }),- });- });- registry.registerEndpoint("@svml/provider-whisperx-local", (context) => {- const config = object(context.config, "local WhisperX");- exact(config, [- "baseUrl", "expectedModel", "expectedDevice", "expectedCompute", "expectedBatchSize",- "expectedServiceVersion", "expectedWhisperXVersion", "expectedPunktTabDigest",- "defaultConcurrency", "requestTimeoutMs", "maxResponseBytes",- ], "local WhisperX");- return createLocalWhisperXProvider({- ...common(context),- ...(string(config.baseUrl, "WhisperX baseUrl") === undefined ? {} : { baseUrl: config.baseUrl as string }),- ...(string(config.expectedModel, "WhisperX expectedModel") === undefined ? {} : { expectedModel: config.expectedModel as string }),- ...(string(config.expectedDevice, "WhisperX expectedDevice") === undefined ? {} : { expectedDevice: config.expectedDevice as string }),- ...(string(config.expectedCompute, "WhisperX expectedCompute") === undefined ? {} : { expectedCompute: config.expectedCompute as string }),- ...(number(config.expectedBatchSize, "WhisperX expectedBatchSize") === undefined ? {} : { expectedBatchSize: config.expectedBatchSize as number }),- ...(string(config.expectedServiceVersion, "WhisperX expectedServiceVersion") === undefined ? {} : { expectedServiceVersion: config.expectedServiceVersion as string }),- ...(string(config.expectedWhisperXVersion, "WhisperX expectedWhisperXVersion") === undefined ? {} : { expectedWhisperXVersion: config.expectedWhisperXVersion as string }),- ...(string(config.expectedPunktTabDigest, "WhisperX expectedPunktTabDigest") === undefined ? {} : { expectedPunktTabDigest: config.expectedPunktTabDigest as string }),- ...(number(config.defaultConcurrency, "WhisperX defaultConcurrency") === undefined ? {} : { defaultConcurrency: config.defaultConcurrency as number }),- ...(number(config.requestTimeoutMs, "WhisperX requestTimeoutMs") === undefined ? {} : { requestTimeoutMs: config.requestTimeoutMs as number }),- ...(number(config.maxResponseBytes, "WhisperX maxResponseBytes") === undefined ? {} : { maxResponseBytes: config.maxResponseBytes as number }),- });- });- registry.registerEndpoint("@svml/provider-hyperframes-local", (context) => {- const config = object(context.config, "local HyperFrames");- exact(config, [- "nodePath", "hyperframesCliPath", "ffprobePath", "workers", "quality", "browserGpu",- "defaultConcurrency", "processTimeoutMs", "maxProcessOutputBytes", "maxRenderedBytes",- ], "local HyperFrames");- const workers = config.workers;- if (workers !== undefined && workers !== "auto") number(workers, "HyperFrames workers");- const quality = string(config.quality, "HyperFrames quality");- if (quality !== undefined && quality !== "draft" && quality !== "standard" && quality !== "high") throw new Error("HyperFrames quality is invalid");- const browserGpu = string(config.browserGpu, "HyperFrames browserGpu");- if (browserGpu !== undefined && browserGpu !== "auto" && browserGpu !== "software" && browserGpu !== "hardware") throw new Error("HyperFrames browserGpu is invalid");- return createLocalHyperframesProvider({- ...common(context),- ...(string(config.nodePath, "HyperFrames nodePath") === undefined ? {} : { nodePath: config.nodePath as string }),- ...(string(config.hyperframesCliPath, "HyperFrames hyperframesCliPath") === undefined ? {} : { hyperframesCliPath: config.hyperframesCliPath as string }),- ...(string(config.ffprobePath, "HyperFrames ffprobePath") === undefined ? {} : { ffprobePath: config.ffprobePath as string }),- ...(workers === undefined ? {} : { workers: workers as number | "auto" }),- ...(quality === undefined ? {} : { quality }),- ...(browserGpu === undefined ? {} : { browserGpu }),- ...(number(config.defaultConcurrency, "HyperFrames defaultConcurrency") === undefined ? {} : { defaultConcurrency: config.defaultConcurrency as number }),- ...(number(config.processTimeoutMs, "HyperFrames processTimeoutMs") === undefined ? {} : { processTimeoutMs: config.processTimeoutMs as number }),- ...(number(config.maxProcessOutputBytes, "HyperFrames maxProcessOutputBytes") === undefined ? {} : { maxProcessOutputBytes: config.maxProcessOutputBytes as number }),- ...(number(config.maxRenderedBytes, "HyperFrames maxRenderedBytes") === undefined ? {} : { maxRenderedBytes: config.maxRenderedBytes as number }),- });- });- registry.registerEndpoint("@svml/provider-google-vertex", (context) => {- const config = object(context.config, "Google Vertex");- exact(config, ["project", "projectEnv", "location", "credentialsEnv", "defaultConcurrency", "requestTimeoutMs", "maxResponseBytes"], "Google Vertex");- const projectValue = string(config.project, "Google Vertex project");- const projectEnv = string(config.projectEnv, "Google Vertex projectEnv");- if (projectValue !== undefined && projectEnv !== undefined) throw new Error("Google Vertex accepts project or projectEnv, not both");- const project = projectValue ?? (projectEnv === undefined ? undefined : process.env[projectEnv]?.trim());- if (project === undefined || project.length === 0) throw new Error("Google Vertex project is required");- const credentialsEnv = string(config.credentialsEnv, "Google Vertex credentialsEnv");- return createGoogleVertexCaptionProvider({- project,- ...common(context),- ...(string(config.location, "Google Vertex location") === undefined ? {} : { location: config.location as string }),- ...(credentialsEnv === undefined ? {} : { credentialsJson: credentialRef("env", credentialsEnv) }),- ...(number(config.defaultConcurrency, "Google Vertex defaultConcurrency") === undefined ? {} : { defaultConcurrency: config.defaultConcurrency as number }),- ...(number(config.requestTimeoutMs, "Google Vertex requestTimeoutMs") === undefined ? {} : { requestTimeoutMs: config.requestTimeoutMs as number }),- ...(number(config.maxResponseBytes, "Google Vertex maxResponseBytes") === undefined ? {} : { maxResponseBytes: config.maxResponseBytes as number }),- });- });- registry.registerService("@svml/artifact-store-s3", (context) => {- const config = object(context.config, "S3 ArtifactStore");- exact(config, ["bucket", "prefix", "expectedBucketOwner", "region", "endpoint", "forcePathStyle"], "S3 ArtifactStore");- const bucket = string(config.bucket, "S3 bucket");- if (bucket === undefined) throw new Error("S3 bucket is required");- return createS3ArtifactStorePackage({- instance: context.instance,- bucket,- ...(string(config.prefix, "S3 prefix") === undefined ? {} : { prefix: config.prefix as string }),- ...(string(config.expectedBucketOwner, "S3 expectedBucketOwner") === undefined ? {} : { expectedBucketOwner: config.expectedBucketOwner as string }),- ...(string(config.region, "S3 region") === undefined ? {} : { region: config.region as string }),- ...(string(config.endpoint, "S3 endpoint") === undefined ? {} : { endpoint: config.endpoint as string }),- ...(boolean(config.forcePathStyle, "S3 forcePathStyle") === undefined ? {} : { forcePathStyle: config.forcePathStyle as boolean }),- });- });- return registry;-}+import { createRuntimeFromConfig } from "@svml/local";+/**+ * Video CLI assembly adds no privileged Provider registry. The Runtime Profile selects+ * locked Runtime Adapter packages, so installing a new adapter never changes this CLI.+ */export async function createVideoRuntimeFromConfig(path: string) {- return await createRuntimeFromConfig(path, {- registry: createVideoRuntimeConfigRegistry(),- });+ return await createRuntimeFromConfig(path);}diff --git a/packages/video-cli/test/cli.test.ts b/packages/video-cli/test/cli.test.tsindex 23982c62..a6899d2a 100644--- a/packages/video-cli/test/cli.test.ts+++ b/packages/video-cli/test/cli.test.ts@@ -5,6 +5,7 @@ import { tmpdir } from "node:os";import { join } from "node:path";import test from "node:test";+import { createNodePackageLock, writeNodePackageLock } from "@svml/package-loader-node";import { materializeRecord, runVideoCli } from "@svml/video-cli";import { videoTestPackages } from "./packages.js";@@ -282,10 +283,10 @@ test(".svrun is the complete human-readable Target graph used by plan", async ()readonly steps: readonly { readonly producer: { readonly name: string } }[];};assert.equal(plan.goals.length, 1);- assert.deepEqual(plan.steps.map((item) => item.producer.name), [+ assert.deepEqual(plan.steps.map((item) => item.producer.name).sort(), ["request-seedance-2-mini","select-primary-video",- ]);+ ].sort());await assert.rejects(async () => await runCli(["plan", run, "--target", "motion.video"], { write() {} }),/belong in a self-described Run Source/u,@@ -295,14 +296,24 @@ test(".svrun is the complete human-readable Target graph used by plan", async ()test("CLI accepts a declarative Runtime Profile without an executable config module", async () => {const root = await mkdtemp(join(tmpdir(), "svml-cli-runtime-profile-"));const profile = join(root, "svml.runtime.json");+ const runtimePackageLock = join(root, "runtime.packages.lock.json");+ await writeNodePackageLock(+ runtimePackageLock,+ await createNodePackageLock(["@svml/provider-kie"], process.cwd()),+ );await writeFile(profile, JSON.stringify({format: "svml.runtime-config@1",+ root: process.cwd(),+ statePath: join(root, "state.sqlite"),+ catalogPath: join(root, "catalog.sqlite"),+ artifactPath: join(root, "artifacts"),+ runtimePackageLock,services: [],endpoints: [{use: "@svml/provider-kie",instance: "kie.cli-test",lane: "generation",- config: { apiKeyEnv: "KIE_API_KEY", defaultConcurrency: 2 },+ config: { apiKeyEnv: "SVML_TEST_MISSING_KIE_KEY", defaultConcurrency: 2 },}],permissions: ["network:api.kie.ai", "network:kieai.redpandaai.co"],scheduling: { lanes: { generation: 2 } },@@ -313,6 +324,15 @@ test("CLI accepts a declarative Runtime Profile without an executable config mod});const status = JSON.parse(output) as { readonly operations: readonly unknown[] };assert.deepEqual(status.operations, []);+ output = "";+ await runCli(["doctor", profile], { write: (text) => { output += text; } });+ const diagnosis = JSON.parse(output) as {+ readonly ok: boolean;+ readonly diagnostics: readonly { readonly code: string; readonly subject?: string }[];+ };+ assert.equal(diagnosis.ok, false);+ assert.equal(diagnosis.diagnostics.some((item) =>+ item.code === "RUNTIME_CREDENTIAL_MISSING" && item.subject === "SVML_TEST_MISSING_KIE_KEY"), true);});test("independent packages lower Speech Spine and explicit WhisperX alignment without provider calls", async () => {@@ -426,10 +446,10 @@ test("Track Surfaces close one complete author graph before any external executi</caption:Style><caption:Program id="caption-program" narrative={story} default={base-caption}/><caption-ai:Planner id="cue-plan" narrative={story} program={caption-program} model="gemini-2.5-flash"/>- <broll:Track id="cards" map={timing.map}>+ <broll:Track id="cards" map={timing.map} space={speech.space}><broll:Item source={motion.video} during={story.selection.demo} appearance={studio.broll.card}/></broll:Track>- <caption:Track id="captions" narrative={story} map={timing.map} plan={cue-plan.plan} program={caption-program}/>+ <caption:Track id="captions" narrative={story} map={timing.map} plan={cue-plan.plan} program={caption-program} space={speech.space}/><text:Track id="titles" space={speech.space}><text:Item text="MEANING" during="full" appearance={studio.text.title}/></text:Track>@@ -437,7 +457,7 @@ test("Track Surfaces close one complete author graph before any external executi<film:Track source={speech.visual}/><film:Track source={speech.audioTrack}/><film:Track source={cards.visual}/><film:Track source={captions.track}/><film:Track source={titles.track}/></film:Film>- <render:Video id="final" composition={main.composition}/>+ <render:Video id="final" composition={main.composition} space={speech.space}/></svml>`, "utf8");let output = "";await runCli(["check", file], { write: (text) => { output += text; } });diff --git a/packages/whisperx/README.md b/packages/whisperx/README.mdindex 3b7a90d4..a3ed0eeb 100644--- a/packages/whisperx/README.md+++ b/packages/whisperx/README.md@@ -11,10 +11,8 @@ then lowers that result to provider-neutral `AlignedTranscriptEvidence`.The request Producer consumes only canonical `SpeechEvidenceAudio`, never the visual SpeechTakeprojection and never an arbitrary container audio stream. `@svml/media-pipeline` first requests theexplicit 48 kHz stereo speech-master → 16 kHz mono evidence projection. That Record binds the-original Artifact, zero-origin rational sample map, resampler implementation and exact evidence-bytes.+zero-origin rational sample map and exact evidence bytes. The Producer Derivation binds the source+SpeechAudioBasis; the Need and Receipt bind the exact evidence-audio request to the accepted result.-Producer result affinity requires returned Basis, original audio Artifact, evidence-audio identity-and ProgramSpace digests to match that exact input before the Evidence can enter BuildState.`@svml/provider-whisperx-local` is the first concrete adapter; it validates and stages those bytesunchanged for a warm loopback sidecar.diff --git a/packages/whisperx/src/evidence.ts b/packages/whisperx/src/evidence.tsindex 89298de4..a298dc4c 100644--- a/packages/whisperx/src/evidence.ts+++ b/packages/whisperx/src/evidence.ts@@ -3,7 +3,6 @@ import {sealAlignedTranscriptEvidence,} from "@svml/contracts";import type { AlignedTranscriptEvidence, SpeechEvidenceAudio } from "@svml/contracts";-import { digestOf } from "@svml/protocol";import type {WhisperXAlignmentEvidence,@@ -18,7 +17,6 @@ export function whisperXRequestForEvidenceAudio(assertSpeechEvidenceAudioIdentity(basis);return {contract: "svml.whisperx-alignment-request@2",- programSpaceDigest: basis.programSpaceDigest,audio: basis.artifact,sampleFrames: basis.sampleFrames,durationSec: basis.durationSec,@@ -32,19 +30,13 @@ export function whisperXRequestForEvidenceAudio(export function sealWhisperXAlignmentEvidence(content: WhisperXEvidenceContent,): WhisperXAlignmentEvidence {- return { ...content, alignmentDigest: digestOf(content) };+ return structuredClone(content);}export function normalizeWhisperXAlignment(evidence: WhisperXAlignmentEvidence,): AlignedTranscriptEvidence {- const { alignmentDigest, ...content } = evidence;- if (alignmentDigest !== digestOf(content)) {- throw new Error("WhisperX alignment digest does not match its canonical contents.");- }const {- alignmentDigest: _alignmentDigest,- engine: _engine,contract: _contract,...shared} = evidence;diff --git a/packages/whisperx/src/fragment.ts b/packages/whisperx/src/fragment.tsindex a32bb9fa..7cb52102 100644--- a/packages/whisperx/src/fragment.ts+++ b/packages/whisperx/src/fragment.ts@@ -47,10 +47,6 @@ export const whisperXSpeechAlignmentFragment = sealGraphFragment({type: whisperXTypes.alignmentEvidence,root: operation("request-whisperx"),semanticInputs: ["audio"],- affinity: [- { resultPointer: "/audioArtifactDigest", source: operation("prepare-evidence-audio"), sourcePointer: "/artifact/digest" },- { resultPointer: "/programSpaceDigest", source: input("audio"), sourcePointer: "/programSpace/digest" },- ],fidelity: "exact",},{@@ -58,10 +54,6 @@ export const whisperXSpeechAlignmentFragment = sealGraphFragment({type: contractTypes.alignedTranscriptEvidence,root: operation("normalize-evidence"),semanticInputs: ["audio"],- affinity: [- { resultPointer: "/audioArtifactDigest", source: operation("prepare-evidence-audio"), sourcePointer: "/artifact/digest" },- { resultPointer: "/programSpaceDigest", source: input("audio"), sourcePointer: "/programSpace/digest" },- ],fidelity: "exact",},{@@ -69,7 +61,6 @@ export const whisperXSpeechAlignmentFragment = sealGraphFragment({type: contractTypes.completeSemanticMap,root: operation("locate-speech"),semanticInputs: ["narrative", "audio"],- affinity: [{ resultPointer: "/programSpace/digest", source: input("audio"), sourcePointer: "/programSpace/digest" }],fidelity: "exact",},],diff --git a/packages/whisperx/src/manifest.ts b/packages/whisperx/src/manifest.tsindex 6954f479..a1676ad6 100644--- a/packages/whisperx/src/manifest.ts+++ b/packages/whisperx/src/manifest.ts@@ -25,15 +25,13 @@ export const whisperXImplementationDigests = {surface: digestOf("@svml/whisperx/alignment-surface@1"),};-const { contract: _commonContract, evidenceDigest: _commonDigest, ...sharedEvidenceFields } =+const { contract: _commonContract, ...sharedEvidenceFields } =alignedTranscriptEvidenceFields;export const whisperXAlignmentEvidenceSchema: ValueSchema = {kind: "object",fields: {contract: { schema: { kind: "literal", value: "svml.whisperx-alignment-evidence@2" } },- engine: { schema: { kind: "literal", value: "whisperx" } },...sharedEvidenceFields,- alignmentDigest: { schema: { kind: "string", minLength: 71, maxLength: 71 } },},};@@ -72,10 +70,6 @@ export const whisperXManifest: ModuleManifest = {name: "alignment",capability: whisperXCapabilities.alignment,returns: whisperXTypes.alignmentEvidence,- affinity: [- { resultPointer: "/audioArtifactDigest", input: "audio", inputPointer: "/artifact/digest" },- { resultPointer: "/programSpaceDigest", input: "audio", inputPointer: "/programSpaceDigest" },- ],}],implementation: {kind: "registered",@@ -86,14 +80,7 @@ export const whisperXManifest: ModuleManifest = {{name: whisperXProducers.normalize.name,inputs: [{ name: "whisperx", type: whisperXTypes.alignmentEvidence }],- outputs: [{- name: "evidence",- type: contractTypes.alignedTranscriptEvidence,- affinity: [- { resultPointer: "/audioArtifactDigest", input: "whisperx", inputPointer: "/audioArtifactDigest" },- { resultPointer: "/programSpaceDigest", input: "whisperx", inputPointer: "/programSpaceDigest" },- ],- }],+ outputs: [{ name: "evidence", type: contractTypes.alignedTranscriptEvidence }],needs: [],implementation: {kind: "registered",diff --git a/packages/whisperx/src/types.ts b/packages/whisperx/src/types.tsindex fdd6657a..d6d16061 100644--- a/packages/whisperx/src/types.ts+++ b/packages/whisperx/src/types.ts@@ -4,11 +4,9 @@ import type {SpeechEvidenceAudio,SpeechBasisSegment,} from "@svml/contracts";-import type { Digest } from "@svml/protocol";export type WhisperXAlignmentRequest = {readonly contract: "svml.whisperx-alignment-request@2";- readonly programSpaceDigest: Digest;readonly audio: SpeechEvidenceAudio["artifact"];readonly sampleFrames: number;readonly durationSec: number;@@ -20,14 +18,9 @@ export type WhisperXAlignmentRequest = {export type WhisperXAlignmentEvidence = {readonly contract: "svml.whisperx-alignment-evidence@2";- readonly engine: "whisperx";- /** Exact acoustic Artifact measured by WhisperX. */- readonly audioArtifactDigest: Digest;- readonly programSpaceDigest: Digest;readonly durationSec: number;readonly segments: readonly AlignedTranscriptSegment[];- readonly alignmentDigest: Digest;};-export type WhisperXEvidenceContent = Omit<WhisperXAlignmentEvidence, "alignmentDigest">;-export type ProviderNeutralEvidenceContent = Omit<AlignedTranscriptEvidence, "evidenceDigest">;+export type WhisperXEvidenceContent = WhisperXAlignmentEvidence;+export type ProviderNeutralEvidenceContent = AlignedTranscriptEvidence;diff --git a/packages/whisperx/test/whisperx.test.ts b/packages/whisperx/test/whisperx.test.tsindex 94ba7a6f..f9bba70c 100644--- a/packages/whisperx/test/whisperx.test.ts+++ b/packages/whisperx/test/whisperx.test.ts@@ -41,8 +41,6 @@ function basis() {function evidenceAudio(basis: SpeechBasis): SpeechEvidenceAudio {return sealSpeechEvidenceAudio({contract: "svml.speech-evidence-audio@1",- programSpaceDigest: basis.programSpace.digest,- sourceAudioArtifactDigest: basis.audio.digest,artifact: {kind: "blob",digest: digestOf("whisperx-test:evidence-audio"),@@ -63,7 +61,6 @@ function evidenceAudio(basis: SpeechBasis): SpeechEvidenceAudio {evidenceSampleFrames: 16_000,sourceOriginSample: 0,evidenceOriginSample: 0,- resamplerImplementation: "fixture",},});}@@ -75,13 +72,9 @@ test("WhisperX consumes only the canonical 16 kHz evidence projection", () => {assert.throws(() => whisperXRequestForEvidenceAudio(tampered), /sample map|digest/u);});-test("WhisperX normalization verifies its model-specific result before lowering to common Evidence", () => {- const source = basis();+test("WhisperX normalization lowers model-specific evidence without leaking provider metadata", () => {const measured = sealWhisperXAlignmentEvidence({contract: "svml.whisperx-alignment-evidence@2",- engine: "whisperx",- audioArtifactDigest: evidenceAudio(source).artifact.digest,- programSpaceDigest: source.programSpace.digest,durationSec: 1,segments: [{sourceSegmentId: "line",@@ -93,14 +86,8 @@ test("WhisperX normalization verifies its model-specific result before lowering});const normalized = normalizeWhisperXAlignment(measured);assert.equal(normalized.contract, "svml.aligned-transcript-evidence@1");- assert.equal(normalized.audioArtifactDigest, evidenceAudio(source).artifact.digest);- assert.throws(- () => normalizeWhisperXAlignment({- ...measured,- segments: [{ ...measured.segments[0]!, words: [{ text: "tampered", startSec: 0.1, endSec: 0.4 }] }],- }),- /alignment digest/u,- );+ assert.equal("engine" in normalized, false);+ assert.deepEqual(normalized.segments, measured.segments);});test("WhisperX installs into the host-neutral compute port without a Node Driver", () => {diff --git a/pnpm-lock.yaml b/pnpm-lock.yamlindex cc2ecdf1..9519f00e 100644--- a/pnpm-lock.yaml+++ b/pnpm-lock.yaml@@ -42,6 +42,9 @@ importers:'@svml/hyperframes-render':specifier: workspace:*version: link:packages/hyperframes-render+ '@svml/image-transform':+ specifier: workspace:*+ version: link:packages/image-transform'@svml/local':specifier: workspace:*version: link:packages/local@@ -60,6 +63,9 @@ importers:'@svml/provider-hyperframes-local':specifier: workspace:*version: link:packages/provider-hyperframes-local+ '@svml/provider-image-opencv-local':+ specifier: workspace:*+ version: link:packages/provider-image-opencv-local'@svml/provider-kie':specifier: workspace:*version: link:packages/provider-kie@@ -72,6 +78,12 @@ importers:'@svml/run-text':specifier: workspace:*version: link:packages/run-text+ '@svml/runtime-adapter':+ specifier: workspace:*+ version: link:packages/runtime-adapter+ '@svml/runtime-adapter-node':+ specifier: workspace:*+ version: link:packages/runtime-adapter-node'@svml/script':specifier: workspace:*version: link:packages/script@@ -135,6 +147,9 @@ importers:'@svml/runtime':specifier: workspace:*version: link:../runtime+ '@svml/runtime-adapter':+ specifier: workspace:*+ version: link:../runtime-adapterpackages/broll:dependencies:@@ -585,6 +600,24 @@ importers:specifier: workspace:*version: link:../validation+ packages/image-transform:+ dependencies:+ '@svml/artifact':+ specifier: workspace:*+ version: link:../artifact+ '@svml/component-kit':+ specifier: workspace:*+ version: link:../component-kit+ '@svml/elaborator':+ specifier: workspace:*+ version: link:../elaborator+ '@svml/protocol':+ specifier: workspace:*+ version: link:../protocol+ '@svml/text':+ specifier: workspace:*+ version: link:../text+packages/local:dependencies:'@svml/artifact-store-fs':@@ -614,6 +647,9 @@ importers:'@svml/runtime':specifier: workspace:*version: link:../runtime+ '@svml/runtime-adapter':+ specifier: workspace:*+ version: link:../runtime-adapter'@svml/store-sqlite':specifier: workspace:*version: link:../store-sqlite@@ -724,6 +760,10 @@ importers:'@svml/validation':specifier: workspace:*version: link:../validation+ devDependencies:+ '@svml/runtime-adapter':+ specifier: workspace:*+ version: link:../runtime-adapterpackages/prompt-kit:dependencies:@@ -765,6 +805,12 @@ importers:'@svml/runtime':specifier: workspace:*version: link:../runtime+ '@svml/runtime-adapter':+ specifier: workspace:*+ version: link:../runtime-adapter+ '@svml/runtime-adapter-node':+ specifier: workspace:*+ version: link:../runtime-adapter-nodedevDependencies:'@svml/driver-node':specifier: workspace:*@@ -790,6 +836,12 @@ importers:'@svml/protocol':specifier: workspace:*version: link:../protocol+ '@svml/runtime-adapter':+ specifier: workspace:*+ version: link:../runtime-adapter+ '@svml/runtime-adapter-node':+ specifier: workspace:*+ version: link:../runtime-adapter-nodehyperframes:specifier: 0.7.84version: 0.7.84(@types/[email protected])@@ -801,6 +853,31 @@ importers:specifier: workspace:*version: link:../driver-node+ packages/provider-image-opencv-local:+ dependencies:+ '@svml/artifact':+ specifier: workspace:*+ version: link:../artifact+ '@svml/endpoint-kit':+ specifier: workspace:*+ version: link:../endpoint-kit+ '@svml/image-transform':+ specifier: workspace:*+ version: link:../image-transform+ '@svml/protocol':+ specifier: workspace:*+ version: link:../protocol+ '@svml/runtime-adapter':+ specifier: workspace:*+ version: link:../runtime-adapter+ '@svml/runtime-adapter-node':+ specifier: workspace:*+ version: link:../runtime-adapter-node+ devDependencies:+ '@svml/driver-node':+ specifier: workspace:*+ version: link:../driver-node+packages/provider-kie:dependencies:'@svml/endpoint-kit':@@ -830,6 +907,12 @@ importers:'@svml/runtime':specifier: workspace:*version: link:../runtime+ '@svml/runtime-adapter':+ specifier: workspace:*+ version: link:../runtime-adapter+ '@svml/runtime-adapter-node':+ specifier: workspace:*+ version: link:../runtime-adapter-node'@svml/seedance':specifier: workspace:*version: link:../seedance@@ -876,6 +959,12 @@ importers:'@svml/protocol':specifier: workspace:*version: link:../protocol+ '@svml/runtime-adapter':+ specifier: workspace:*+ version: link:../runtime-adapter+ '@svml/runtime-adapter-node':+ specifier: workspace:*+ version: link:../runtime-adapter-nodedevDependencies:'@svml/artifact-store-fs':specifier: workspace:*@@ -907,6 +996,9 @@ importers:'@svml/protocol':specifier: workspace:*version: link:../protocol+ '@svml/runtime-adapter':+ specifier: workspace:*+ version: link:../runtime-adapter'@svml/whisperx':specifier: workspace:*version: link:../whisperx@@ -973,6 +1065,27 @@ importers:specifier: workspace:*version: link:../protocol+ packages/runtime-adapter:+ dependencies:+ '@svml/endpoint-kit':+ specifier: workspace:*+ version: link:../endpoint-kit+ '@svml/host':+ specifier: workspace:*+ version: link:../host+ '@svml/protocol':+ specifier: workspace:*+ version: link:../protocol+ '@svml/runtime':+ specifier: workspace:*+ version: link:../runtime++ packages/runtime-adapter-node:+ dependencies:+ '@svml/runtime-adapter':+ specifier: workspace:*+ version: link:../runtime-adapter+packages/script:dependencies:'@svml/contracts':@@ -1265,9 +1378,6 @@ importers:packages/video-cli:dependencies:- '@svml/artifact-store-s3':- specifier: workspace:*- version: link:../artifact-store-s3'@svml/cli':specifier: workspace:*version: link:../cli@@ -1277,27 +1387,10 @@ importers:'@svml/local':specifier: workspace:*version: link:../local- '@svml/protocol':- specifier: workspace:*- version: link:../protocol- '@svml/provider-google-vertex':- specifier: workspace:*- version: link:../provider-google-vertex- '@svml/provider-hyperframes-local':- specifier: workspace:*- version: link:../provider-hyperframes-local- '@svml/provider-kie':- specifier: workspace:*- version: link:../provider-kie- '@svml/provider-media-local':- specifier: workspace:*- version: link:../provider-media-local- '@svml/provider-whisperx-local':- specifier: workspace:*- version: link:../provider-whisperx-local- '@svml/runtime':+ devDependencies:+ '@svml/package-loader-node':specifier: workspace:*- version: link:../runtime+ version: link:../package-loader-nodepackages/whisperx:dependencies:diff --git a/services/image-opencv/.python-version b/services/image-opencv/.python-versionnew file mode 100644index 00000000..24ee5b1b--- /dev/null+++ b/services/image-opencv/.python-version@@ -0,0 +1 @@+3.13diff --git a/services/image-opencv/README.md b/services/image-opencv/README.mdnew file mode 100644index 00000000..81ec1d3e--- /dev/null+++ b/services/image-opencv/README.md@@ -0,0 +1,31 @@+# SVML local OpenCV runtime++This is the locked Python environment used by `@svml/provider-image-opencv-local`. It is deployment+state, not an author-importable SVML package, a queue, a service daemon or part of Core.++Install it once:++```bash+uv python install 3.13+uv sync --project services/image-opencv --frozen+uv run --project services/image-opencv --frozen --no-sync python -c \+ 'import cv2, numpy; print(cv2.__version__, numpy.__version__)'+```++Then configure the Provider with the environment's interpreter:++```json+{+ "use": "@svml/provider-image-opencv-local",+ "instance": "image.opencv.local",+ "config": {+ "pythonExecutable": "./services/image-opencv/.venv/bin/python",+ "defaultConcurrency": 2+ }+}+```++The Provider starts one bounded, shell-free Python process for each admitted Need. The ordinary+SVML Runtime Scheduler owns concurrency. The Python process reads only its explicit temporary input+and Program files and writes one explicit output image; it has no network, artifact-store, author+source or BuildState API.diff --git a/services/image-opencv/pyproject.toml b/services/image-opencv/pyproject.tomlnew file mode 100644index 00000000..4498ecb8--- /dev/null+++ b/services/image-opencv/pyproject.toml@@ -0,0 +1,13 @@+[project]+name = "svml-image-opencv-runtime"+version = "0.1.0"+description = "Locked Python runtime for the SVML local OpenCV image Provider"+requires-python = ">=3.13,<3.14"+license = { text = "Apache-2.0" }+dependencies = [+ "numpy>=2.1,<3",+ "opencv-python-headless>=4.10,<5",+]++[tool.uv]+package = falsediff --git a/services/image-opencv/uv.lock b/services/image-opencv/uv.locknew file mode 100644index 00000000..095f14d7--- /dev/null+++ b/services/image-opencv/uv.lock@@ -0,0 +1,56 @@+version = 1+revision = 3+requires-python = "==3.13.*"++[[package]]+name = "numpy"+version = "2.5.1"+source = { registry = "https://pypi.org/simple" }+sdist = { url = "https://files.pythonhosted.org/packages/22/fd/89965aa4ac08c74998539fcbf24fa3540f3e15237fbeb6bcf9c908f4aade/numpy-2.5.1.tar.gz", hash = "sha256:a48a113e6afea91f5608793bafa7ef2ad481fefbda87ec5069f483de61cb9fa3", size = 20755553, upload-time = "2026-07-04T17:08:00.933Z" }+wheels = [+ { url = "https://files.pythonhosted.org/packages/eb/07/ec2a3f0c91761581d4b7104a740791800025983f9a4dc4e73f91a99aeac4/numpy-2.5.1-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:0bfebd8695f9863592fe744be833a258120b14a9f39da255e8aa8fade2c0ddd1", size = 16796419, upload-time = "2026-07-04T17:06:40.37Z" },+ { url = "https://files.pythonhosted.org/packages/ab/ab/ddb499fc4f8780354395face5b65c7fd107bcd6e1d667a5f07d046956f6f/numpy-2.5.1-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:30b44a6b53a7ae63c54c089a8726e5563ed302716c5b7ccc85afade40b0e7ff6", size = 11765832, upload-time = "2026-07-04T17:06:42.768Z" },+ { url = "https://files.pythonhosted.org/packages/88/b3/3c28c558a09fc72100c646dac6d2fce8e834c471b0edca01a29996706117/numpy-2.5.1-cp313-cp313-macosx_14_0_arm64.whl", hash = "sha256:6165343f81b56ef8f514f396989e529b61d9dc709b99421b07e9f3e698e2287d", size = 5325143, upload-time = "2026-07-04T17:06:45.466Z" },+ { url = "https://files.pythonhosted.org/packages/5e/0e/ce19b985bb15c596f4f05954e76cccc77c845083b3b8f938a6c68e523128/numpy-2.5.1-cp313-cp313-macosx_14_0_x86_64.whl", hash = "sha256:4939237038ada79308dda3204ac6462df056b5672b2e25db1149cf873668b3e1", size = 6659749, upload-time = "2026-07-04T17:06:47.288Z" },+ { url = "https://files.pythonhosted.org/packages/2e/20/1ee6614d64332a1bba6411f38e68cb79eec1b2459e20a623777c5c5492a2/numpy-2.5.1-cp313-cp313-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:1c6759f538fb912fc46de0a6b1758ccf7b57bc7c7ebebc23974fdac3de8db0cd", size = 15164716, upload-time = "2026-07-04T17:06:49.494Z" },+ { url = "https://files.pythonhosted.org/packages/ed/a7/2bcd3fdbb87804755c35b729bf8709d62025c5f4cfd7d5b2415997097515/numpy-2.5.1-cp313-cp313-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:9726558e8db4a5bf7929a70ae50f63abda4daf0efe810e3bfbab95976f75fc1a", size = 16661440, upload-time = "2026-07-04T17:06:52.061Z" },+ { url = "https://files.pythonhosted.org/packages/fc/d7/a41e3310c886fe457d36e670bbf24fae411aca8a7b6ad92a32afd924077c/numpy-2.5.1-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:3935f3b419b244a02732676fa5317a9193cc596a4c0646db07e5b421229ac9f7", size = 16526305, upload-time = "2026-07-04T17:06:54.605Z" },+ { url = "https://files.pythonhosted.org/packages/53/75/4333a9a707c1edd3a4e1a0c58eca52c0f31e55089fa80db02b5565b24df7/numpy-2.5.1-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:dc932a65ded7ce9013d120845a2514dcccb1a67bfc8deb8d37633762951904a6", size = 18423008, upload-time = "2026-07-04T17:06:57.54Z" },+ { url = "https://files.pythonhosted.org/packages/ee/90/e314a32b1c11a2ffe818ddad3a57b50b4b6e1b6c487192eb50cdef0415d0/numpy-2.5.1-cp313-cp313-win32.whl", hash = "sha256:4b4ff1608417eb7a59da7b967bbb798cacfe071d2caf526a24281cd562072ed9", size = 6063885, upload-time = "2026-07-04T17:07:00.14Z" },+ { url = "https://files.pythonhosted.org/packages/10/70/800b3fca480af32df9e8ea9f3d4a0c8feb4b32d7f195d174eabbda4829ad/numpy-2.5.1-cp313-cp313-win_amd64.whl", hash = "sha256:6c3fe51bc6a16453d452997053454f309e8e0ed7b42d6b361ce4ac8c32913d74", size = 12425674, upload-time = "2026-07-04T17:07:02.387Z" },+ { url = "https://files.pythonhosted.org/packages/8b/0b/196350c122f50f6ca56846f2d71efd5e0d24b7b2e07355e019b2e2c7a11e/numpy-2.5.1-cp313-cp313-win_arm64.whl", hash = "sha256:f7feb014281029e628ba2d5a007407443b06e418b6fe451d1e2adcbc8eba0107", size = 10350256, upload-time = "2026-07-04T17:07:04.878Z" },+]++[[package]]+name = "opencv-python-headless"+version = "4.14.0.94"+source = { registry = "https://pypi.org/simple" }+dependencies = [+ { name = "numpy" },+]+sdist = { url = "https://files.pythonhosted.org/packages/67/8a/51ff1c6287be0b6cd3070cf095875da4ff7d6eda38507e6ada5608786a78/opencv_python_headless-4.14.0.94.tar.gz", hash = "sha256:4afa2ea1214453648be88259f035712454faa9039b686de7753569ba8eec1577", size = 96405664, upload-time = "2026-07-28T19:23:48.758Z" }+wheels = [+ { url = "https://files.pythonhosted.org/packages/9a/56/12f9b05628cf4ab6aad54479b9124f7c1f2f92b6a4e47c071beb63d926a2/opencv_python_headless-4.14.0.94-cp37-abi3-macosx_13_0_arm64.whl", hash = "sha256:bc7db37dc234f7bb3190a158fd9dd750357246fc7d8adb23698843ef721a993b", size = 46491231, upload-time = "2026-07-29T03:52:11.902Z" },+ { url = "https://files.pythonhosted.org/packages/23/3b/2f9c42466f62aa27e97aaf6c9d914008895ecde28013ba4beed7f541f593/opencv_python_headless-4.14.0.94-cp37-abi3-macosx_14_0_x86_64.whl", hash = "sha256:1777f43c9fa064f54b916ad70d944b4fde0a644a17e49f04a966bb24a4b5f1e1", size = 33084176, upload-time = "2026-07-28T20:05:59.902Z" },+ { url = "https://files.pythonhosted.org/packages/7d/91/83c51e3fe000b5dfce4f3be5c5d320e07ebab5c1742abc4e45674503f90f/opencv_python_headless-4.14.0.94-cp37-abi3-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:29714d7716dbfddf9fec20ffb878765e94ccaecd7d3ebd6750877420296e2dc5", size = 35405458, upload-time = "2026-07-28T19:19:29.997Z" },+ { url = "https://files.pythonhosted.org/packages/de/06/14c8c5d331bc72738683a9b227966aceaa4c6d08752f33d64578aebcb6f8/opencv_python_headless-4.14.0.94-cp37-abi3-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:5e02669eac0ba67b2a22d7245af1e8ee1a2ef1185ee526a063d8f0555224bd52", size = 57534165, upload-time = "2026-07-28T19:19:52.742Z" },+ { url = "https://files.pythonhosted.org/packages/3f/0e/0b98bd582582253f61c4506f9b465cf5a8aa7fa4f7237dd99e1b5151a159/opencv_python_headless-4.14.0.94-cp37-abi3-manylinux_2_28_aarch64.whl", hash = "sha256:97c6e818c6f71c0cfa214e12293b1d0266d679c38f4e086de08357c8ac6ece0d", size = 38104309, upload-time = "2026-07-28T19:20:08.818Z" },+ { url = "https://files.pythonhosted.org/packages/ae/ce/7f538891722a4f06921419d55bac6f41729258d54442861edb2de0dbdf5e/opencv_python_headless-4.14.0.94-cp37-abi3-manylinux_2_28_x86_64.whl", hash = "sha256:211e581f5a4670acbbe08fff36a35e9946039d2eea28b80394632d036d1be527", size = 61960165, upload-time = "2026-07-28T19:20:33.074Z" },+ { url = "https://files.pythonhosted.org/packages/e9/91/ded03abad74d7264fa6bc7c923d7cade6f94a9023eeb372cfad54c2d0334/opencv_python_headless-4.14.0.94-cp37-abi3-win32.whl", hash = "sha256:f70296aa7ac9d7ade0d925c43fdc006c83e20a23f30e2f40f1b82c74a7a54460", size = 33030271, upload-time = "2026-07-28T18:32:39.447Z" },+ { url = "https://files.pythonhosted.org/packages/ad/8d/db8673846ee53cbb5de4c2b4decc11cf733e203eb7d5146297869f69bd48/opencv_python_headless-4.14.0.94-cp37-abi3-win_amd64.whl", hash = "sha256:cbed65415b8f6a9541c705afe3e64795840524d0ff3bc58f507826284a1dc64b", size = 41028030, upload-time = "2026-07-28T18:32:36.724Z" },+]++[[package]]+name = "svml-image-opencv-runtime"+version = "0.1.0"+source = { virtual = "." }+dependencies = [+ { name = "numpy" },+ { name = "opencv-python-headless" },+]++[package.metadata]+requires-dist = [+ { name = "numpy", specifier = ">=2.1,<3" },+ { name = "opencv-python-headless", specifier = ">=4.10,<5" },+]diff --git a/tools/graph-first-value-boundary.test.mjs b/tools/graph-first-value-boundary.test.mjsnew file mode 100644index 00000000..2e5fe117--- /dev/null+++ b/tools/graph-first-value-boundary.test.mjs@@ -0,0 +1,119 @@+import assert from "node:assert/strict";+import {+ readdir,+ readFile,+} from "node:fs/promises";+import test from "node:test";++const packageRoot = new URL("../packages/", import.meta.url);++async function sourceFiles(root) {+ const files = [];+ for (const entry of await readdir(root, { withFileTypes: true })) {+ const path = new URL(`./${entry.name}${entry.isDirectory() ? "/" : ""}`, root);+ if (entry.isDirectory()) files.push(...await sourceFiles(path));+ else if (entry.isFile() && entry.name.endsWith(".ts")) files.push(path);+ }+ return files;+}++async function contents(packageNames) {+ const result = [];+ for (const name of packageNames) {+ const root = new URL(`./${name}/src/`, packageRoot);+ for (const path of await sourceFiles(root)) {+ result.push({ path, source: await readFile(path, "utf8") });+ }+ }+ return result;+}++const domainValuePackages = [+ "broll",+ "caption",+ "caption-gemini",+ "estimate",+ "film",+ "generation",+ "hyperframes",+ "hyperframes-render",+ "image-transform",+ "media-pipeline",+ "prompt-kit",+ "script",+ "seedance",+ "seedance-speaker",+ "speech-align",+ "speech-program",+ "speech-take",+ "text-track",+ "whisperx",+];++const forbiddenLineageFields = [+ "programSpaceDigest",+ "narrativeDigest",+ "mapDigest",+ "selectionDigest",+ "excerptDigest",+ "basisDigest",+ "resultDigest",+ "productDigest",+ "planDigest",+ "captionProgramDigest",+ "sourceAudioArtifactDigest",+ "renderInputDigest",+ "visualDigest",+ "audioDigest",+ "inspectionDigest",+ "previousSetDigest",+ "trackDigest",+];++test("domain Products do not copy graph lineage into payload fields", async () => {+ for (const { path, source } of await contents(domainValuePackages)) {+ for (const field of forbiddenLineageFields) {+ assert.doesNotMatch(source, new RegExp(`\\b${field}\\b`, "u"), `${path.pathname} reintroduced ${field}`);+ }+ assert.doesNotMatch(+ source,+ /readonly\s+digest\s*:\s*Digest\b/u,+ `${path.pathname} reintroduced a domain Product self-digest`,+ );+ }+});++test("the generic graph stack has no payload-affinity side channel", async () => {+ const genericSources = await contents(["protocol", "core", "elaborator"]);+ const removedApi = [+ "ResultAffinityDeclaration",+ "AffinityConstraint",+ "FragmentAffinityConstraint",+ "verifyRecordAffinity",+ ];+ for (const { path, source } of genericSources) {+ for (const symbol of removedApi) {+ assert.doesNotMatch(source, new RegExp(`\\b${symbol}\\b`, "u"), `${path.pathname} reintroduced ${symbol}`);+ }+ }+});++test("fold values retain members, not hidden identity or policy context", async () => {+ const declarations = [+ ["broll", "types.ts", "BrollSet"],+ ["film", "types.ts", "FilmTrackSet"],+ ["speech-program", "types.ts", "SpeechSpineSet"],+ ["text-track", "types.ts", "TextTrackSet"],+ ];+ for (const [packageName, fileName, typeName] of declarations) {+ const path = new URL(`./${packageName}/src/${fileName}`, packageRoot);+ const source = await readFile(path, "utf8");+ const declaration = new RegExp(`export type ${typeName} = \\{([\\s\\S]*?)\\n\\};`, "u").exec(source)?.[1];+ assert.ok(declaration, `${typeName} declaration is missing`);+ assert.doesNotMatch(+ declaration,+ /readonly\s+(?:id|digest|program|programSpace)\s*:/u,+ `${typeName} carries hidden identity or policy context`,+ );+ }+});diff --git a/tools/package-boundaries.test.mjs b/tools/package-boundaries.test.mjsindex 2f594020..171d4d57 100644--- a/tools/package-boundaries.test.mjs+++ b/tools/package-boundaries.test.mjs@@ -61,6 +61,8 @@ const domainNeutralPackages = new Set(["@svml/workspace-fs-node","@svml/component-kit","@svml/runtime",+ "@svml/runtime-adapter",+ "@svml/runtime-adapter-node","@svml/endpoint-kit","@svml/driver-node","@svml/package-loader-node",@@ -108,18 +110,20 @@ test("Text compilation is one explicit leaf assembly, not a Package Loader or Loassert.ok(!transitive(graph, "@svml/local").has("@svml/text"));});-test("the generic CLI reaches no Endpoint package and video CLI activates no author aggregate", async () => {+test("generic and video CLIs reach no Provider package and video CLI activates no author aggregate", async () => {const graph = productionGraph(await workspacePackages());const dependencies = transitive(graph, "@svml/cli");const videoAssembly = ["@svml/provider-google-vertex","@svml/provider-hyperframes-local",+ "@svml/provider-image-opencv-local","@svml/provider-kie","@svml/provider-media-local","@svml/provider-whisperx-local",];assert.deepEqual(videoAssembly.filter((name) => dependencies.has(name)), []);const videoDependencies = transitive(graph, "@svml/video-cli");+ assert.deepEqual(videoAssembly.filter((name) => videoDependencies.has(name)), []);assert.ok(!videoDependencies.has("@svml/script"));assert.ok(!videoDependencies.has("@svml/seedance-speaker"));assert.ok(!videoDependencies.has("@svml/broll"));diff --git a/tsconfig.v2.json b/tsconfig.v2.jsonindex c39f2403..ead3b398 100644--- a/tsconfig.v2.json+++ b/tsconfig.v2.json@@ -23,6 +23,8 @@"@svml/run": ["packages/run/src/index.ts"],"@svml/run-text": ["packages/run-text/src/index.ts"],"@svml/runtime": ["packages/runtime/src/index.ts"],+ "@svml/runtime-adapter": ["packages/runtime-adapter/src/index.ts"],+ "@svml/runtime-adapter-node": ["packages/runtime-adapter-node/src/index.ts"],"@svml/store-sqlite": ["packages/store-sqlite/src/index.ts"],"@svml/artifact-store-fs": ["packages/artifact-store-fs/src/index.ts"],"@svml/artifact-store-s3": ["packages/artifact-store-s3/src/index.ts"],@@ -44,6 +46,8 @@"@svml/provider-hyperframes-local": ["packages/provider-hyperframes-local/src/index.ts"],"@svml/provider-whisperx-local": ["packages/provider-whisperx-local/src/index.ts"],"@svml/provider-google-vertex": ["packages/provider-google-vertex/src/index.ts"],+ "@svml/image-transform": ["packages/image-transform/src/index.ts"],+ "@svml/provider-image-opencv-local": ["packages/provider-image-opencv-local/src/index.ts"],"@svml/transport-aws-lambda": ["packages/transport-aws-lambda/src/index.ts"],"@svml/transport-process": ["packages/transport-process/src/index.ts"],"@svml/transport": ["packages/transport/src/index.ts"],