Skip to content

armgit / hypit

Public Imported from GitHub
0

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.

refactor(v2): complete graph-first runtime foundation

kashorin2855fd2a8065
diff --git a/.gitignore b/.gitignore
index 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.md
index 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.md
index 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 implementati
locking, contributions and Host-selected facet activation.
- [`local-developer-runtime-v1.md`](./local-developer-runtime-v1.md) — local SQLite/filesystem
Runtime, 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-take
diff --git a/examples/composite-speech-program/README.md b/examples/composite-speech-program/README.md
index 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.md
index 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.lock
index 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.lock
new file mode 100644
index 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.json
index 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.lock
index 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.md
index 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 Runt
The checked-in `svml.packages.lock` selects each author, Run and deterministic compute package
independently; there is no implicit video bundle. Regenerate it after changing one of those package
implementations 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.
```bash
pnpm 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.lock
index 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.lock
new file mode 100644
index 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.json
index 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.json
index 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.ts
index 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.ts
index 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", a
await 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.json
index 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.ts
new file mode 100644
index 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.ts
index 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.ts
index 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.ts
index 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.ts
index 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.ts
index 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): AudioCli
return 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: BrollPr
contract: "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: BrollPr
const 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.ts
index 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, operat
function 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, res
components: [
...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.ts
index 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.ts
index 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 BrollPairTra
return 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 stacked
contract: "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 stacked
const 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 visu
const 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 boun
assert.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.ts
index 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.ts
index 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.ts
index 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.ts
index 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 Cap
assert(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.ts
index 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 Cap
const 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 Cap
assert(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.ts
index 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.ts
index 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 come
assert.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 at
const 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.ts
index 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.ts
index 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.ts
index 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.ts
index 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/caption
const 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.ts
index 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 CaptionPlan
assert(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.ts
index 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.ts
index 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.ts
index 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, r
const 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, r
inputs: {
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.ts
index 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.ts
index 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 } from
export 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"): CaptionTrackProgram
export 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.ts
index 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.ts
index 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 Al
return 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, no
const 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 p
const 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 p
const 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.ts
index 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.ts
index 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.ts
index 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 }, subj
return 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.ts
index 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): numb
return 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): v
throw 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.ts
index 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.ts
index 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.ts
index 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): num
return 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 MediaIns
item.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 Med
assert(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 RenderedV
verifyBlob(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.ts
index 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.ts
index 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.ts
index 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.ts
index 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.ts
index 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?: Pro
if (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?: Progr
if (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.ts
index 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 facts
contract: "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 domain
contract: "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 domain
assert.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 domain
assert.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.ts
index 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 floa
assert.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 sa
evidenceSampleFrames: 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.ts
index 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 s
assert.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 s
assert.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.ts
deleted file mode 100644
index 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.ts
index 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: Graph
return 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.ts
index 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.ts
index 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.ts
index 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.ts
index 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.ts
index 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.ts
index 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.ts
index 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.md
index 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 Candidate
A `svml.fragment@1` value may reference only declared Fragment inputs and local Operations. It
contains 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 instances
diff --git a/packages/elaborator/src/fragment.ts b/packages/elaborator/src/fragment.ts
index 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: GraphFragm
item.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.ts
index 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.ts
index 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.ts
index 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.ts
index 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.ts
index 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.ts
index 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.ts
index 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.ts
index 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.ts
index 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.ts
index 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.ts
index 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.ts
index 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.ts
index 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.ts
index 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, hyperframesDocumentFr
fragment: 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.ts
index 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", a
const 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.ts
index 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.ts
index 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 Genera
assert(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 Genera
assert(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.ts
index 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.ts
index 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.ts
index 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.ts
index 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.ts
index 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?: GptImage2M
export 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.ts
index 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?: GrokImag
export 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.ts
index 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, operat
export 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.ts
index 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.ts
index 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.ts
index 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 co
const 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 rende
return {
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 rende
return {
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 rende
return {
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 reque
metadata: {},
}),
);
+ 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 reque
validators: 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.md
index 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 no
Record 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 a
hosted renderer may independently evaluate any legal frame or half-open chunk; partition size and
worker count are Runtime policy, not author intent and not Core graph nodes. The emitted root also
uses 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.ts
index 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.ts
index 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 track
function 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.ts
index 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.ts
index 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.ts
index 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.ts
index 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 browse
contract: "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 browse
contract: "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 browse
contract: "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 browse
const 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.ts
index 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 boundary
assert.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 sta
const 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 Artifac
contract: "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 Artifac
const 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.ts
index 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 p
contract: "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 p
textPresent("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 V
contract: "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 one
contract: "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 absolute
contract: "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 absolute
contract: "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 absolute
elements: [{ 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 wit
contract: "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.md
new file mode 100644
index 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.json
new file mode 100644
index 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.ts
new file mode 100644
index 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.ts
new file mode 100644
index 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.ts
new file mode 100644
index 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.ts
new file mode 100644
index 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.ts
new file mode 100644
index 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.ts
new file mode 100644
index 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.ts
new file mode 100644
index 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.ts
new file mode 100644
index 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.ts
new file mode 100644
index 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.md
index 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` with
Record and content identities, not private filesystem layout, so filesystem and S3 stores remain
interchangeable. 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 the
catalog shares the SQLite file physically; deployments with replacement execution Stores default
to `.svml/catalog.sqlite` or may select `catalogPath`/inject a `BuildCatalog`. This index is kept out
diff --git a/packages/local/package.json b/packages/local/package.json
index 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.ts
index 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.ts
index 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.ts
index 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.ts
index 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.ts
index 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.ts
index 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.ts
index 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.ts
index 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.ts
index 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 Me
assert(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.ts
index 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.ts
index 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 observ
test("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.ts
index 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?: MinimaxH3M
export 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.ts
index 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 = NanoBananaModel
readonly 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.json
index 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.ts
index 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): Promise
try {
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.ts
index 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.ts
index 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.ts
index 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.ts
index 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 PromptKitBlock
throw 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 PromptKitS
throw 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 Prom
const 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: PromptKitInvoc
const 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: PromptKitInvoc
if (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.ts
index 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.ts
index 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.ts
index 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.ts
index 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.ts
index 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.json
index 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.ts
new file mode 100644
index 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.ts
index 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 validate
assert.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.json
index 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.ts
new file mode 100644
index 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.ts
index 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: CreateLocalHyperframesPro
const 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.ts
index 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 pa
const 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.md
new file mode 100644
index 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.json
new file mode 100644
index 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.py
new file mode 100644
index 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.ts
new file mode 100644
index 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.ts
new file mode 100644
index 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.ts
new file mode 100644
index 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.ts
new file mode 100644
index 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.json
index 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.ts
new file mode 100644
index 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.ts
index 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.ts
index 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 reque
nsfwCheck: 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.json
index 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.ts
new file mode 100644
index 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.ts
index 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.ts
index 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: CreateLocalMediaProviderOptions
try {
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: CreateLocalMediaProviderOptions
loudness: "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: CreateLocalMediaProviderOptions
const 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: CreateLocalMediaProviderOptions
evidenceSampleFrames: 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: CreateLocalMediaProviderOptions
const 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.ts
index 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 artif
const 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 artif
const 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 exactly
artifacts.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 exactly
const 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.json
index 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.ts
new file mode 100644
index 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.ts
index 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: CreateLocalWhisperXProviderO
const 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.ts
index 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 sidecar
const 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 sidecar
evidenceSampleFrames: 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.md
index 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 complete
prior `BuildState` only to extract a trusted typed Record, its type-validation receipt and optional
provenance. 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 materialized
value. 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 the
Target must explicitly accept substitute fidelity.
diff --git a/packages/realization/test/overlay.test.ts b/packages/realization/test/overlay.test.ts
index 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 s
assert.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.md
index 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 it
through 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-relationship
claim against the output it is selected to satisfy.
Imports form the opening prologue. They name Fragment libraries already admitted by the Host; they
diff --git a/packages/runtime-adapter-node/package.json b/packages/runtime-adapter-node/package.json
new file mode 100644
index 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.ts
new file mode 100644
index 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.ts
new file mode 100644
index 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.json
new file mode 100644
index 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.ts
new file mode 100644
index 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.md
index 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 comp
call 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.ts
index 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.ts
index 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.ts
index 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.ts
index 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): CanonicalValue
text: 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.ts
index 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.ts
index 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.ts
index 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 Speake
if (
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.ts
index 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 = ({ ele
attributes(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 = ({ ele
const 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.ts
index 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.ts
index 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 r
test("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.ts
index 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.ts
index 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 SeedanceP
if (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.ts
index 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.ts
index 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?: SeedreamMod
export 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.ts
index 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.ts
index 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.ts
index 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 hidden
durationSec: 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.ts
index 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.ts
index 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.ts
index 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: { schema
export 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.ts
index 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.ts
index 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.ts
index 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.ts
index 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 the
assert.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.md
index 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 treats
these outputs as ports of one mutable workflow node.
diff --git a/packages/speech-take/src/manifest.ts b/packages/speech-take/src/manifest.ts
index 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.ts
index 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.ts
index 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.ts
index 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.ts
index 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.ts
index 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.ts
index 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.ts
index 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.ts
index 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, progra
assertProgramSpaceIdentity(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: TextTr
return 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: TextTrackPr
contract: "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: TextTrackPr
return 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.ts
index 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.ts
index 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.ts
index 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 Semant
anchors: [],
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 Semant
close: { 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 Semant
box: { 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.md
index 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-once
diff --git a/packages/video-cli/README.md b/packages/video-cli/README.md
index 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:
```bash
pnpm 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.json
pnpm svml:v2 inspect <build-id> --runtime ./svml.runtime.json
pnpm svml:v2 get <build-id> --name final.video --runtime ./svml.runtime.json --to ./final.mp4
pnpm 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 i
Historical Records, fixed files and generated previews are declared as ordinary Candidates in the
Run 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 current
output. Upstream work behind the selected Candidate is pruned by reverse reachability, while every
unbound reachable output follows the ordinary graph. This is a new Build identity and never resumes
or copies the prior Build's outstanding Commands.
diff --git a/packages/video-cli/package.json b/packages/video-cli/package.json
index 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.ts
index 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.ts
index 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.ts
index 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.ts
index 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.md
index 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 SpeechTake
projection and never an arbitrary container audio stream. `@svml/media-pipeline` first requests the
explicit 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 bytes
unchanged for a warm loopback sidecar.
diff --git a/packages/whisperx/src/evidence.ts b/packages/whisperx/src/evidence.ts
index 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.ts
index 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.ts
index 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.ts
index 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.ts
index 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.yaml
index 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-adapter
packages/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-adapter
packages/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-node
devDependencies:
'@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-node
hyperframes:
specifier: 0.7.84
version: 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-node
devDependencies:
'@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-node
packages/whisperx:
dependencies:
diff --git a/services/image-opencv/.python-version b/services/image-opencv/.python-version
new file mode 100644
index 00000000..24ee5b1b
--- /dev/null
+++ b/services/image-opencv/.python-version
@@ -0,0 +1 @@
+3.13
diff --git a/services/image-opencv/README.md b/services/image-opencv/README.md
new file mode 100644
index 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.toml
new file mode 100644
index 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 = false
diff --git a/services/image-opencv/uv.lock b/services/image-opencv/uv.lock
new file mode 100644
index 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.mjs
new file mode 100644
index 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.mjs
index 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 Lo
assert.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.json
index 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"],