Clone any viral video with AI agents. Not just a script, the whole workflow: swap the face, the words, the B-roll, ship 100 variants in one command, and get your 100M views.
TypeScript agentic-aiaiai-agentsai-videocompilerdslffmpeggenerative-aillmmarkup-languagemonorepoplugin-systemprogramming-languagetext-to-videotypescriptvideovideo-automationvideo-clonevideo-editingvideo-generation
feat: lock deterministic compute facets
kashorin0a813794e433
diff --git a/docs/README.md b/docs/README.mdindex 79bd9626..62151d83 100644--- a/docs/README.md+++ b/docs/README.md@@ -44,9 +44,9 @@ inside a historical design record does not make that record normative.and implemented local Providers.17. [`../services/whisperx/README.md`](../services/whisperx/README.md) — installation, runtimeidentity, path confinement and queue boundary for the implemented warm local WhisperX service.-18. [`node-author-package-activation-v1.md`](./node-author-package-activation-v1.md) — implemented- lock-aware activation for trusted installed Module, Frontend and Text Surface facets, including- the exact boundary that keeps source imports away from Provider and Runtime authority.+18. [`node-package-activation-v1.md`](./node-package-activation-v1.md) — implemented trusted author+ and deterministic compute facet locking, with the exact boundary that keeps source imports away+ from Provider and Runtime authority.The executable v2 Node entrypoints are documented in[`../packages/compiler-node/README.md`](../packages/compiler-node/README.md),diff --git a/packages/cli/README.md b/packages/cli/README.mdindex e4f585c6..62e74309 100644--- a/packages/cli/README.md+++ b/packages/cli/README.md@@ -43,8 +43,9 @@ non-retryable failure, cancellation or `--max-wait-ms`. `status` reads durable v`cancel` invokes active endpoints and then records the resulting terminal Build failure. None ofthese commands creates a second ready-command queue.-`@svml/package-loader-node` now supports explicitly trusted installed author packages. It verifies-the complete physical dependency closure before executing an activation entry, then checks exact-Module, Frontend and Surface identities. It never installs a package because source requested it and-does not activate Provider or Runtime facets. Arbitrary untrusted community execution remains-absent until an isolated Worker and real permission boundary exist.+`@svml/package-loader-node` supports explicitly trusted installed implementation packages. It+verifies the complete physical dependency closure before executing an activation entry, then checks+exact Module, Frontend, Surface, Producer and Validator identities. `plan` and `build` bind the lock+digest into `BuildRequest.implementationClosure`. It never installs a package because source+requested it and does not activate Provider or privileged Runtime facets. Arbitrary untrusted+community execution remains absent until an isolated Worker and real permission boundary exist.diff --git a/packages/cli/src/host.ts b/packages/cli/src/host.tsindex aec20315..9ffec6b6 100644--- a/packages/cli/src/host.ts+++ b/packages/cli/src/host.ts@@ -2,13 +2,13 @@ import type { NodeCompiler } from "@svml/compiler-node";import {createActivatedNodeCompiler,} from "@svml/package-loader-node";-import type { NodeAuthorPackage } from "@svml/package-loader-node";-import { svmlAuthorPackage as videoPrelude } from "@svml/prelude-video";+import type { NodePackageActivation } from "@svml/package-loader-node";+import { svmlPackage as videoPrelude } from "@svml/prelude-video";export type OfficialCompilerOptions = {readonly root?: string;/** Replaces the ordinary official prelude with an exact trusted package activation set. */- readonly packages?: readonly NodeAuthorPackage[];+ readonly packages?: readonly NodePackageActivation[];};/** The CLI names only an ordinary replaceable prelude; no domain package is registered here. */diff --git a/packages/cli/src/main.ts b/packages/cli/src/main.tsindex fd31e57a..e800a40d 100644--- a/packages/cli/src/main.ts+++ b/packages/cli/src/main.ts@@ -3,9 +3,9 @@ import { pathToFileURL } from "node:url";import type { LocalRuntime } from "@svml/local";import {- createNodeAuthorPackageLock,- loadNodeAuthorPackages,- writeNodeAuthorPackageLock,+ createNodePackageLock,+ loadNodePackageSet,+ writeNodePackageLock,} from "@svml/package-loader-node";import { createOfficialNodeCompiler } from "./host.js";@@ -166,8 +166,8 @@ export async function runCli(argv: readonly string[], io: CliIo): Promise<void>if (args.packageLock !== undefined) throw new Error("lock-packages does not accept --package-lock");const output = resolve(args.file);const root = args.root ?? dirname(output);- const lock = await createNodeAuthorPackageLock(args.packages, root);- await writeNodeAuthorPackageLock(output, lock);+ const lock = await createNodePackageLock(args.packages, root);+ await writeNodePackageLock(output, lock);io.write(`${JSON.stringify({ ok: true, packageLock: output, digest: lock.digest, packages: lock.packages }, null, 2)}\n`);return;}@@ -212,10 +212,10 @@ export async function runCli(argv: readonly string[], io: CliIo): Promise<void>if (args.packages.length > 0) throw new Error("--package is only valid for lock-packages");const activated = args.packageLock === undefined? undefined- : await loadNodeAuthorPackages(args.packageLock, args.root ?? dirname(args.packageLock));+ : await loadNodePackageSet(args.packageLock, args.root ?? dirname(args.packageLock));const compiler = createOfficialNodeCompiler({...(args.root === undefined ? {} : { root: args.root }),- ...(activated === undefined ? {} : { packages: activated }),+ ...(activated === undefined ? {} : { packages: activated.packages }),});if (args.command === "check") {const result = await compiler.compileFile(args.file);@@ -233,6 +233,7 @@ export async function runCli(argv: readonly string[], io: CliIo): Promise<void>const result = await compiler.planFile(args.file, {targets: args.targets,accepts: args.substitute ? "substitute" : "exact",+ ...(activated === undefined ? {} : { implementationClosure: activated.lock.digest }),});if (args.command === "build") {if (args.runtime === undefined) throw new Error("build requires --runtime with a trusted local config module");diff --git a/packages/cli/test/cli.test.ts b/packages/cli/test/cli.test.tsindex 425ef8a0..1626a40e 100644--- a/packages/cli/test/cli.test.ts+++ b/packages/cli/test/cli.test.ts@@ -82,13 +82,13 @@ test("CLI package lock activates an installed package without changing the officversion: "1.0.0",type: "module",exports: "./activation.mjs",- svml: { authorActivation: "./activation.mjs" },+ svml: { activation: "./activation.mjs" },}), "utf8");await writeFile(join(packageRoot, "activation.mjs"), `const module = { name: "example.empty", version: "1" };const digest = ${JSON.stringify(implementationDigest)};export default {- format: "svml.node-author-package@1",+ format: "svml.node-package@1",name: "example-empty",modules: [{ manifest: {format: "svml.module@0", name: module.name, version: module.version,diff --git a/packages/compiler-node/src/compiler.ts b/packages/compiler-node/src/compiler.tsindex 592478d7..da5ac21f 100644--- a/packages/compiler-node/src/compiler.ts+++ b/packages/compiler-node/src/compiler.ts@@ -84,6 +84,7 @@ export type PlanFileOptions = {readonly targets: readonly string[];readonly accepts?: NeedAcceptance;readonly bindings?: readonly CandidateBinding[];+ readonly implementationClosure?: import("@svml/protocol").Digest;};export type PlannedSource = {@@ -151,6 +152,9 @@ export class NodeCompiler {});const request = sealBuildRequest({graph: compilation.elaboration.graph.id,+ ...(options.implementationClosure === undefined+ ? {}+ : { implementationClosure: options.implementationClosure }),targets,bindings: options.bindings ?? [],});diff --git a/packages/component-kit/README.md b/packages/component-kit/README.mdindex 022772d8..4da5b558 100644--- a/packages/component-kit/README.md+++ b/packages/component-kit/README.md@@ -1,10 +1,10 @@# `@svml/component-kit`The minimal host-neutral SDK for trusted deterministic compute components. A package exports-enumerable Producer installation and Type-owner validator facets. Validator identity is data-(`TypeRef` plus implementation digest), so package locks and Hosts can inspect it without serializing-the handler. Producer handlers receive only the Core command, Producer identity and immutable typed-inputs.+enumerable Producer and Type-owner Validator facets. Both identities are data: an exact nominal+reference plus implementation digest and handler. Package locks and Hosts can inspect and compare+the identities without running an opaque `install()` callback. Producer handlers receive only the+Core command, Producer identity and immutable typed inputs.They receive no ArtifactStore, credentials, network client, queue or Runtime service. Work thatneeds those authorities must emit an explicit Need and be implemented by a separately selecteddiff --git a/packages/component-kit/src/index.ts b/packages/component-kit/src/index.tsindex 1b1b584c..b024f191 100644--- a/packages/component-kit/src/index.ts+++ b/packages/component-kit/src/index.ts@@ -42,6 +42,22 @@ export interface ProducerRegistrar {): void;}+/** Enumerable deterministic Producer identity and its trusted implementation. */+export type ProducerFacet = {+ readonly producer: ProducerRef;+ readonly implementationDigest: Digest;+ readonly handler: ProducerHandler;+};++export function registerProducerFacets(+ registry: ProducerRegistrar,+ facets: readonly ProducerFacet[],+): void {+ for (const facet of facets) {+ registry.registerProducer(facet.producer, facet.implementationDigest, facet.handler);+ }+}+/** Enumerable validator identity. Package locks can bind this without serializing its handler. */export type TypeValidatorFacet = {readonly type: TypeRef;@@ -61,6 +77,6 @@ export function registerTypeValidatorFacets(/** Trusted deterministic implementation package; it selects no Provider or Runtime service. */export type ComponentPackage = {readonly name: string;+ readonly producers?: readonly ProducerFacet[];readonly validators?: readonly TypeValidatorFacet[];- install?(registry: ProducerRegistrar): Awaitable<void>;};diff --git a/packages/core/src/graph.ts b/packages/core/src/graph.tsindex efe56c2b..77013392 100644--- a/packages/core/src/graph.ts+++ b/packages/core/src/graph.ts@@ -145,6 +145,9 @@ export function sealBuildRequest(const content = {format: "svml.build-request@1" as const,graph: request.graph,+ ...(request.implementationClosure === undefined+ ? {}+ : { implementationClosure: request.implementationClosure }),targets,bindings,};@@ -481,6 +484,11 @@ export function verifyBuildRequest();invariant(isDigest(request.digest), "INVALID_DIGEST", "BuildRequest digest is invalid");invariant(request.graph === graph.id, "BUILD_REQUEST_GRAPH_MISMATCH", "BuildRequest belongs to another graph");+ invariant(+ request.implementationClosure === undefined || isDigest(request.implementationClosure),+ "INVALID_IMPLEMENTATION_CLOSURE_DIGEST",+ "BuildRequest implementation closure digest is invalid",+ );const { digest: _digest, ...content } = request;invariant(request.digest === digestOf(content), "BUILD_REQUEST_DIGEST_MISMATCH", "BuildRequest digest differs");invariant(request.targets.length > 0, "EMPTY_BUILD_TARGETS", "BuildRequest has no Targets");diff --git a/packages/core/test/greeting-fixture.ts b/packages/core/test/greeting-fixture.tsindex 31aaf257..3391314c 100644--- a/packages/core/test/greeting-fixture.ts+++ b/packages/core/test/greeting-fixture.ts@@ -194,6 +194,7 @@ export function greetingGraph(program: LinkedProgram): CompiledGraph {export function createGreetingBuild(options?: {readonly generationRealization?: "primary" | "placeholder";readonly goalAccepts?: "exact" | "substitute";+ readonly implementationClosure?: import("@svml/protocol").Digest;}): BuildState {const closure = createResolvedClosure([manifest]);const authored = sealRecord({@@ -217,6 +218,9 @@ export function createGreetingBuild(options?: {const graph = greetingGraph(program);const request = sealBuildRequest({graph: graph.id,+ ...(options?.implementationClosure === undefined+ ? {}+ : { implementationClosure: options.implementationClosure }),targets: [{output: "document",accepts: options?.goalAccepts ?? "exact",diff --git a/packages/driver-node/src/driver.ts b/packages/driver-node/src/driver.tsindex 9b883025..c9d009e9 100644--- a/packages/driver-node/src/driver.ts+++ b/packages/driver-node/src/driver.ts@@ -4,6 +4,7 @@ import type {BuildEvent,BuildState,CoreCommand,+ Digest,FulfillNeedCommand,InvokeProducerCommand,TypedRecord,@@ -53,6 +54,7 @@ export type NodeDriverOptions = {readonly credentials?: CredentialStore;readonly maxEvents?: number;readonly validators?: TypeValidatorRegistryLike;+ readonly implementationClosure?: Digest;};type Executable =@@ -78,6 +80,7 @@ export class NodeDriver {readonly credentials: CredentialStore | undefined;readonly maxEvents: number;readonly validators: TypeValidatorRegistryLike;+ readonly implementationClosure: Digest | undefined;constructor(options: NodeDriverOptions = {}) {this.registry = options.registry ?? new HostRegistry();@@ -87,6 +90,19 @@ export class NodeDriver {this.credentials = options.credentials;this.maxEvents = options.maxEvents ?? 1_000;this.validators = options.validators ?? new TypeValidatorRegistry();+ this.implementationClosure = options.implementationClosure;+ }++ #verifyImplementationClosure(state: BuildState): void {+ if (state.request.implementationClosure !== this.implementationClosure) {+ if (state.request.implementationClosure === undefined) {+ throw new Error("BuildRequest does not bind this Host's implementation package closure");+ }+ if (this.implementationClosure === undefined) {+ throw new Error("BuildRequest requires an implementation package closure that this Host did not load");+ }+ throw new Error("BuildRequest implementation package closure differs from this Host");+ }}async #providerCredentials(@@ -468,6 +484,7 @@ export class NodeDriver {/** Regenerate Core commands, then classify only what this Host can execute. */prepare(initial: BuildState): RuntimePreparation {+ this.#verifyImplementationClosure(initial);const transition = reduce(initial);const state = transition.state;if (state.status === "complete" || state.status === "failed") {@@ -555,6 +572,7 @@ export class NodeDriver {}async run(initial: BuildState, context?: RuntimeExecutionContext): Promise<DriverRunResult> {+ this.#verifyImplementationClosure(initial);let state = initial;const journal: DriverJournalEntry[] = [];diff --git a/packages/hyperframes-render/src/component.ts b/packages/hyperframes-render/src/component.tsindex 2a098452..c7157081 100644--- a/packages/hyperframes-render/src/component.ts+++ b/packages/hyperframes-render/src/component.ts@@ -1,3 +1,4 @@+import type { ComponentPackage } from "@svml/component-kit";import type { StoredValue } from "@svml/protocol";import {@@ -9,19 +10,17 @@ import { hyperframesRenderProducers } from "./manifest.js";/** Declares the visual Need. It contains no renderer, queue, credentials or deployment choice. */export const hyperframesRenderComponent = {name: "@svml/hyperframes-render",- install(registry: import("@svml/component-kit").ProducerRegistrar): void {- registry.registerProducer(- hyperframesRenderProducers.requestVisual,- requestHyperframesVisualImplementationDigest,- ({ inputs }) => ({- outputs: {},- needs: {- visual: hyperframesVisualRequest(inline(inputs.document!.value, "HyperframesDocument") as never),- },- }),- );- },-};+ producers: [{+ producer: hyperframesRenderProducers.requestVisual,+ implementationDigest: requestHyperframesVisualImplementationDigest,+ handler: ({ inputs }) => ({+ outputs: {},+ needs: {+ visual: hyperframesVisualRequest(inline(inputs.document!.value, "HyperframesDocument") as never),+ },+ }),+ }],+} satisfies ComponentPackage;function inline(value: StoredValue, subject: string): unknown {if (value.kind !== "inline") throw new Error(`${subject} must be inline`);diff --git a/packages/hyperframes-render/test/render.test.ts b/packages/hyperframes-render/test/render.test.tsindex d3325d58..18f3ef59 100644--- a/packages/hyperframes-render/test/render.test.ts+++ b/packages/hyperframes-render/test/render.test.ts@@ -1,7 +1,10 @@import assert from "node:assert/strict";import test from "node:test";-import { registerTypeValidatorFacets } from "@svml/component-kit";+import {+ registerProducerFacets,+ registerTypeValidatorFacets,+} from "@svml/component-kit";import {compositionContractsComponent,contractTypes,@@ -139,9 +142,9 @@ function build() {function producerRegistry(): HostRegistry {const registry = new HostRegistry();- mediaPipelineComponent.install(registry);- hyperframesComponent.install(registry);- hyperframesRenderComponent.install(registry);+ registerProducerFacets(registry, mediaPipelineComponent.producers);+ registerProducerFacets(registry, hyperframesComponent.producers);+ registerProducerFacets(registry, hyperframesRenderComponent.producers);return registry;}diff --git a/packages/hyperframes/src/component.ts b/packages/hyperframes/src/component.tsindex d3a72098..847bc26f 100644--- a/packages/hyperframes/src/component.ts+++ b/packages/hyperframes/src/component.ts@@ -1,3 +1,4 @@+import type { ComponentPackage } from "@svml/component-kit";import type { Composition } from "@svml/contracts";import type { CanonicalValue, StoredValue } from "@svml/protocol";import { canonicalize } from "@svml/protocol";@@ -16,21 +17,19 @@ function inline(value: StoredValue, subject: string): CanonicalValue {/** Trusted deterministic lowering only; this component never renders frames or reads Artifacts. */export const hyperframesComponent = {name: "@svml/hyperframes",- install(registry: import("@svml/component-kit").ProducerRegistrar): void {- registry.registerProducer(- hyperframesProducers.compile,- compileHyperframesImplementationDigest,- ({ inputs }) => ({- outputs: {- document: {- kind: "inline",- value: canonicalize(compileHyperframesDocument(- inline(inputs.composition!.value, "Composition") as unknown as Composition,- )),- },+ producers: [{+ producer: hyperframesProducers.compile,+ implementationDigest: compileHyperframesImplementationDigest,+ handler: ({ inputs }) => ({+ outputs: {+ document: {+ kind: "inline",+ value: canonicalize(compileHyperframesDocument(+ inline(inputs.composition!.value, "Composition") as unknown as Composition,+ )),},- needs: {},- }),- );- },-};+ },+ needs: {},+ }),+ }],+} satisfies ComponentPackage;diff --git a/packages/local/README.md b/packages/local/README.mdindex 2f8335d4..99a65d51 100644--- a/packages/local/README.md+++ b/packages/local/README.md@@ -11,7 +11,8 @@ The convenience assembly uses:- optional replacement by any permission-checked ArtifactStore contribution, including`@svml/artifact-store-s3`;- an in-process, queue-free Scheduler whose ready work always comes from Core;-- separately installed deterministic component packages and external Provider packages.+- an exact implementation package lock for deterministic component packages;+- separately selected external Provider packages.Deterministic packages implement the host-neutral `@svml/component-kit` contract. `@svml/local`adapts them to `HostRegistry`; the component never imports the Node Driver or receives Runtime@@ -20,12 +21,12 @@ services.```tsexport default await createProjectLocalRuntime({root: import.meta.dirname,+ packageLock: "./svml.packages.lock",artifacts: createS3ArtifactStorePackage({bucket: "hypit-svml-artifacts",prefix: "development",region: "us-east-1",}),- components: [generationComponent, seedanceComponent],providers: [createKieProvider({ apiKey: credentialRef("env", "KIE_API_KEY") })],allowedPermissions: ["network:aws:s3", "network:api.kie.ai", "network:kieai.redpandaai.co"],scheduling: {@@ -35,9 +36,11 @@ export default await createProjectLocalRuntime({});```-The KIE Provider shown above is implemented; `generationComponent` owns common result validators-and `seedanceComponent` owns exact request validators and deterministic Need Producers. Swapping a-Provider package changes an Endpoint implementation and its lane, not the `.svml` author document.+The implementation lock may contain `generationComponent`, exact-model components and media+pipeline Producers without adding imports to this deployment source. Its digest is bound into the+BuildRequest, so a persisted Build cannot resume under another deterministic component closure.+The KIE Provider remains an independently selected privileged endpoint; swapping it changes an+Endpoint implementation and lane, not the `.svml` author document.`createProjectLocalRuntime` accepts a configured ArtifactStore package directly;advanced hosts may call `createLocalRuntime` with Postgres or other implementations of the sameports instead of using the project defaults.diff --git a/packages/local/package.json b/packages/local/package.jsonindex 45828939..bdd59b3d 100644--- a/packages/local/package.json+++ b/packages/local/package.json@@ -11,6 +11,7 @@"@svml/component-kit": "workspace:*","@svml/credential-store-env": "workspace:*","@svml/driver-node": "workspace:*",+ "@svml/package-loader-node": "workspace:*","@svml/protocol": "workspace:*","@svml/provider-kit": "workspace:*","@svml/runtime": "workspace:*",diff --git a/packages/local/src/runtime.ts b/packages/local/src/runtime.tsindex 454cbf03..90e0d98b 100644--- a/packages/local/src/runtime.ts+++ b/packages/local/src/runtime.ts@@ -1,6 +1,7 @@import { resolve } from "node:path";import {+ registerProducerFacets,registerTypeValidatorFacets,} from "@svml/component-kit";import {@@ -18,6 +19,10 @@ import {NodeDriver,ProviderRegistry,} from "@svml/driver-node";+import {+ loadNodePackageSet,+ nodePackageComponents,+} from "@svml/package-loader-node";import {LocalBuildScheduler,RuntimeModuleRegistry,@@ -150,9 +155,13 @@ export async function createLocalRuntime(const hosts = new HostRegistry();const providers = new ProviderRegistry();const validators = options.validators ?? new TypeValidatorRegistry();+ const componentNames = new Set<string>();for (const component of options.components ?? []) {+ assert(component.name.trim().length > 0, "Component package name must not be empty");+ assert(!componentNames.has(component.name), `Component package ${component.name} is configured twice`);+ componentNames.add(component.name);registerTypeValidatorFacets(validators, component.validators ?? []);- await component.install?.(hosts);+ registerProducerFacets(hosts, component.producers ?? []);}for (const provider of options.providers ?? []) await provider.install(providers);if (options.closure !== undefined) {@@ -169,6 +178,9 @@ export async function createLocalRuntime(...(options.credentialStore === undefined ? {} : { credentials: options.credentialStore }),...(options.operationStore === undefined ? {} : { operations: options.operationStore }),validators,+ ...(options.implementationClosure === undefined+ ? {}+ : { implementationClosure: options.implementationClosure }),});const closureScheduling = options.closure === undefined? {}@@ -235,6 +247,13 @@ export async function createProjectLocalRuntime(throw new Error("artifactPath configures the default filesystem store and cannot accompany artifacts");}const root = resolve(options.root ?? process.cwd());+ const lockedPackageSet = options.packageLock === undefined+ ? undefined+ : await loadNodePackageSet(resolve(root, options.packageLock), root);+ const lockedComponents = lockedPackageSet === undefined+ ? []+ : nodePackageComponents(lockedPackageSet.packages);+ const configuredComponents = [...lockedComponents, ...(options.components ?? [])];const state = new SqliteRuntimeState(resolve(root, options.statePath ?? ".svml/runtime.sqlite"));const defaultArtifacts: NodeArtifactStorePackage = {name: "@svml/artifact-store-fs",@@ -294,7 +313,9 @@ export async function createProjectLocalRuntime(operationStore: state.operations,artifactStore: artifacts.store,credentialStore: new EnvironmentCredentialStore(),- ...(options.components === undefined ? {} : { components: options.components }),+ ...(configuredComponents.length === 0+ ? {}+ : { components: configuredComponents }),providers: providerPackages,closure: { modules, value: closure, allowedPermissions },scheduling: {@@ -303,6 +324,7 @@ export async function createProjectLocalRuntime(: { maxEventsPerBuild: options.scheduling.maxEventsPerBuild }),},...(options.validators === undefined ? {} : { validators: options.validators }),+ ...(lockedPackageSet === undefined ? {} : { implementationClosure: lockedPackageSet.lock.digest }),});return {build: runtime.build,diff --git a/packages/local/src/types.ts b/packages/local/src/types.tsindex 4620341d..0d2aec4b 100644--- a/packages/local/src/types.ts+++ b/packages/local/src/types.ts@@ -51,6 +51,8 @@ export type CreateLocalRuntimeOptions = {readonly closure?: LocalRuntimeClosureOptions;readonly scheduling?: Omit<LocalBuildSchedulerOptions, "buildStore" | "runtimeClosure">;readonly validators?: LocalTypeValidatorRegistry;+ /** Expected implementation package closure already bound into BuildRequest. */+ readonly implementationClosure?: import("@svml/protocol").Digest;};export type ProjectLocalRuntimeOptions = {@@ -58,6 +60,8 @@ export type ProjectLocalRuntimeOptions = {readonly root?: string;readonly statePath?: string;readonly artifactPath?: string;+ /** Exact installed implementation package lock. Source imports cannot change this selection. */+ readonly packageLock?: string;/** Replaces the default project filesystem ArtifactStore without changing Scheduler/Core. */readonly artifacts?: NodeArtifactStorePackage;readonly components?: readonly ComponentPackage[];diff --git a/packages/local/test/local.test.ts b/packages/local/test/local.test.tsindex 14273eaf..b54150a2 100644--- a/packages/local/test/local.test.ts+++ b/packages/local/test/local.test.ts@@ -1,5 +1,10 @@import assert from "node:assert/strict";-import { mkdtemp, rm } from "node:fs/promises";+import {+ mkdir,+ mkdtemp,+ rm,+ writeFile,+} from "node:fs/promises";import { tmpdir } from "node:os";import { join } from "node:path";import test from "node:test";@@ -13,12 +18,17 @@ import type {} from "@svml/local";import { createProjectLocalRuntime } from "@svml/local";import { digestOf } from "@svml/core";+import {+ createNodePackageLock,+ writeNodePackageLock,+} from "@svml/package-loader-node";import type { RuntimeModuleManifest } from "@svml/runtime";import {capabilities,createGreetingBuild,implementationDigests,+ manifest as greetingManifest,producers,types,} from "../../core/test/greeting-fixture.js";@@ -51,28 +61,40 @@ test("project local runtime resumes durable work while component and provider palet cancels = 0;const components: NodeComponentPackage = {name: "example.components",- install(registry) {- registry.registerProducer(producers.makePrompt, implementationDigests.makePrompt, ({ inputs }) => {+ producers: [+ {+ producer: producers.makePrompt,+ implementationDigest: implementationDigests.makePrompt,+ handler: ({ inputs }) => {promptCalls += 1;const intent = inputs.intent;assert.equal(intent?.value.kind, "inline");const name = (intent.value.value as { readonly name: string }).name;return { outputs: { prompt: { kind: "inline", value: `Greet ${name}` } }, needs: {} };- });- registry.registerProducer(producers.requestText, implementationDigests.requestText, ({ inputs }) => {+ },+ },+ {+ producer: producers.requestText,+ implementationDigest: implementationDigests.requestText,+ handler: ({ inputs }) => {requestCalls += 1;assert.equal(inputs.prompt?.value.kind, "inline");return { outputs: {}, needs: { generation: { prompt: inputs.prompt.value.value } } };- });- registry.registerProducer(producers.assemble, implementationDigests.assemble, ({ inputs }) => {+ },+ },+ {+ producer: producers.assemble,+ implementationDigest: implementationDigests.assemble,+ handler: ({ inputs }) => {assembleCalls += 1;assert.equal(inputs.generated?.value.kind, "inline");return {outputs: { document: { kind: "inline", value: { text: inputs.generated.value.value } } },needs: {},};- });- },+ },+ },+ ],};const endpoint: ProviderEndpoint = {start({ operation }) {@@ -169,6 +191,86 @@ test("project local runtime resumes durable work while component and provider pa}});+test("project local runtime activates locked compute facets without deployment source registration", async () => {+ const directory = await mkdtemp(join(tmpdir(), "svml-local-locked-components-"));+ const packageRoot = join(directory, "node_modules", "example-greeting-components");+ const lockPath = join(directory, "svml.packages.lock");+ await mkdir(packageRoot, { recursive: true });+ await writeFile(join(packageRoot, "package.json"), JSON.stringify({+ name: "example-greeting-components",+ version: "1.0.0",+ type: "module",+ exports: "./activation.mjs",+ svml: { activation: "./activation.mjs" },+ }), "utf8");+ await writeFile(join(packageRoot, "activation.mjs"), `+ const manifest = ${JSON.stringify(greetingManifest)};+ const module = { name: manifest.name, version: manifest.version };+ const producer = (name) => ({ module, name });+ export default {+ format: "svml.node-package@1",+ name: "example-greeting-components",+ modules: [{ manifest }],+ components: [{+ name: "example-greeting-components/compute",+ producers: [+ {+ producer: producer("make-prompt"),+ implementationDigest: ${JSON.stringify(implementationDigests.makePrompt)},+ handler({ inputs }) {+ const intent = inputs.intent.value.value;+ return { outputs: { prompt: { kind: "inline", value: "Greet " + intent.name } }, needs: {} };+ },+ },+ {+ producer: producer("placeholder-text"),+ implementationDigest: ${JSON.stringify(implementationDigests.placeholderText)},+ handler() {+ return { outputs: { generated: { kind: "inline", value: "Preview greeting" } }, needs: {} };+ },+ },+ {+ producer: producer("assemble"),+ implementationDigest: ${JSON.stringify(implementationDigests.assemble)},+ handler({ inputs }) {+ return { outputs: { document: { kind: "inline", value: { text: inputs.generated.value.value } } }, needs: {} };+ },+ },+ ],+ }],+ };+ `, "utf8");++ try {+ const lock = await createNodePackageLock(["example-greeting-components"], directory);+ await writeNodePackageLock(lockPath, lock);+ const runtime = await createProjectLocalRuntime({+ root: directory,+ packageLock: "svml.packages.lock",+ });+ await assert.rejects(+ async () => await runtime.build({+ id: "unlocked-preview",+ state: createGreetingBuild({ generationRealization: "placeholder", goalAccepts: "substitute" }),+ }),+ /does not bind this Host's implementation package closure/u,+ );+ const result = await runtime.build({+ id: "locked-preview",+ state: createGreetingBuild({+ generationRealization: "placeholder",+ goalAccepts: "substitute",+ implementationClosure: lock.digest,+ }),+ });+ assert.equal(result.status, "complete");+ assert.equal(result.state.records.some((record) => record.id === "document:root"), true);+ await runtime.close();+ } finally {+ await rm(directory, { recursive: true, force: true });+ }+});+test("project local runtime accepts a permission-checked replacement ArtifactStore package", async () => {const directory = await mkdtemp(join(tmpdir(), "svml-local-artifacts-"));const module = { name: "example.remote-artifacts", version: "1" } as const;diff --git a/packages/media-pipeline/src/component.ts b/packages/media-pipeline/src/component.tsindex 3ee436a9..da79bdd2 100644--- a/packages/media-pipeline/src/component.ts+++ b/packages/media-pipeline/src/component.ts@@ -70,20 +70,20 @@ export const mediaPipelineComponent = {},},],- install(registry: import("@svml/component-kit").ProducerRegistrar): void {- registry.registerProducer(- mediaPipelineProducers.inspect,- mediaPipelineImplementationDigests.inspect,- ({ inputs }) => {+ producers: [+ {+ producer: mediaPipelineProducers.inspect,+ implementationDigest: mediaPipelineImplementationDigests.inspect,+ handler: ({ inputs }) => {const source = blob(inputs.source!.value, "Media inspection source");const need: InspectMediaNeed = { contract: "svml.inspect-media-request@1", source };return { outputs: {}, needs: { inspection: canonicalize(need) } };},- );- registry.registerProducer(- mediaPipelineProducers.select,- mediaPipelineImplementationDigests.select,- ({ inputs }) => {+ },+ {+ producer: mediaPipelineProducers.select,+ implementationDigest: mediaPipelineImplementationDigests.select,+ handler: ({ inputs }) => {const inspection = inline(inputs.inspection!.value, "MediaInspection");const request = inline(inputs.request!.value, "MediaSelectionRequest");verifyMediaInspection(inspection);@@ -95,11 +95,11 @@ export const mediaPipelineComponent = {needs: {},};},- );- registry.registerProducer(- mediaPipelineProducers.normalize,- mediaPipelineImplementationDigests.normalize,- ({ inputs }) => {+ },+ {+ producer: mediaPipelineProducers.normalize,+ implementationDigest: mediaPipelineImplementationDigests.normalize,+ handler: ({ inputs }) => {const source = blob(inputs.source!.value, "Media normalization source");const inspection = inline(inputs.inspection!.value, "MediaInspection");const selection = inline(inputs.selection!.value, "MediaStreamSelection");@@ -123,11 +123,11 @@ export const mediaPipelineComponent = {};return { outputs: {}, needs: { media: canonicalize(need) } };},- );- registry.registerProducer(- mediaPipelineProducers.projectSpeechEvidenceAudio,- mediaPipelineImplementationDigests.projectSpeechEvidenceAudio,- ({ inputs }) => {+ },+ {+ producer: mediaPipelineProducers.projectSpeechEvidenceAudio,+ implementationDigest: mediaPipelineImplementationDigests.projectSpeechEvidenceAudio,+ handler: ({ inputs }) => {const audio = inline(inputs.audio!.value, "SpeechAudioBasis") as unknown as SpeechAudioBasis;assertSpeechAudioBasisIdentity(audio);const sourceSampleFrames = programSpaceSampleFrames(audio.programSpace, 48_000);@@ -160,32 +160,32 @@ export const mediaPipelineComponent = {};return { outputs: {}, needs: { evidenceAudio: canonicalize(need) } };},- );- registry.registerProducer(- mediaPipelineProducers.planAudio,- mediaPipelineImplementationDigests.planAudio,- ({ inputs }) => {+ },+ {+ producer: mediaPipelineProducers.planAudio,+ implementationDigest: mediaPipelineImplementationDigests.planAudio,+ handler: ({ inputs }) => {const composition = inline(inputs.composition!.value, "Composition") as unknown as Composition;return {outputs: { plan: { kind: "inline", value: canonicalize(compileAudioProgramPlan(composition)) } },needs: {},};},- );- registry.registerProducer(- mediaPipelineProducers.renderAudio,- mediaPipelineImplementationDigests.renderAudio,- ({ inputs }) => {+ },+ {+ producer: mediaPipelineProducers.renderAudio,+ implementationDigest: mediaPipelineImplementationDigests.renderAudio,+ handler: ({ inputs }) => {const plan = inline(inputs.plan!.value, "AudioProgramPlan");verifyAudioProgramPlan(plan);const need: RenderAudioNeed = { contract: "svml.render-audio-request@1", plan };return { outputs: {}, needs: { audio: canonicalize(need) } };},- );- registry.registerProducer(- mediaPipelineProducers.mux,- mediaPipelineImplementationDigests.mux,- ({ inputs }) => {+ },+ {+ producer: mediaPipelineProducers.mux,+ implementationDigest: mediaPipelineImplementationDigests.mux,+ handler: ({ inputs }) => {const visual = inline(inputs.visual!.value, "RenderedVisual");const audio = inline(inputs.audio!.value, "TimelineAudio");verifyRenderedVisual(visual);@@ -196,11 +196,11 @@ export const mediaPipelineComponent = {const need: MuxMediaNeed = { contract: "svml.mux-media-request@1", visual, audio };return { outputs: {}, needs: { media: canonicalize(need) } };},- );- registry.registerProducer(- mediaPipelineProducers.projectMuxed,- mediaPipelineImplementationDigests.projectMuxed,- ({ inputs }) => {+ },+ {+ producer: mediaPipelineProducers.projectMuxed,+ implementationDigest: mediaPipelineImplementationDigests.projectMuxed,+ handler: ({ inputs }) => {const media = inline(inputs.media!.value, "MuxedMedia");verifyMuxedMedia(media);const durationSec = media.frameCount * media.frameRate.denominator / media.frameRate.numerator;@@ -219,8 +219,8 @@ export const mediaPipelineComponent = {needs: {},};},- );- },+ },+ ],} satisfies ComponentPackage;/** Convenience set: public media validators must accompany the pipeline Producers. */diff --git a/packages/model-kit/src/index.ts b/packages/model-kit/src/index.tsindex d5c4429e..719c6783 100644--- a/packages/model-kit/src/index.ts+++ b/packages/model-kit/src/index.ts@@ -1,6 +1,6 @@import type {ComponentPackage,- ProducerRegistrar,+ ProducerFacet,TypeValidatorFacet,} from "@svml/component-kit";import { sealGraphFragment } from "@svml/elaborator";@@ -53,7 +53,7 @@ export type ExactModelModule = {readonly endpoints: Readonly<Record<string, ExactModelEndpoint>>;readonly component: ComponentPackage & {readonly validators: readonly TypeValidatorFacet[];- install(registry: ProducerRegistrar): void;+ readonly producers: readonly ProducerFacet[];};};@@ -185,21 +185,17 @@ export function defineExactModelModule(options: DefineExactModelModuleOptions):item.spec.verifyRequest(inlineRequest(value, item.spec.key));},})),- install(registry) {- for (const item of endpointData) {- registry.registerProducer(- item.producer,- item.implementationDigest,- ({ inputs }) => {- const requestRecord = inputs.request;- assert(requestRecord !== undefined, `${item.spec.key} request input is missing`);- const request = inlineRequest(requestRecord.value, item.spec.key);- item.spec.verifyRequest(request);- return { outputs: {}, needs: { generation: request } };- },- );- }- },+ producers: endpointData.map((item) => ({+ producer: item.producer,+ implementationDigest: item.implementationDigest,+ handler: ({ inputs }) => {+ const requestRecord = inputs.request;+ assert(requestRecord !== undefined, `${item.spec.key} request input is missing`);+ const request = inlineRequest(requestRecord.value, item.spec.key);+ item.spec.verifyRequest(request);+ return { outputs: {}, needs: { generation: request } };+ },+ })),},};}diff --git a/packages/package-loader-node/README.md b/packages/package-loader-node/README.mdindex 0916c6d9..e90a2443 100644--- a/packages/package-loader-node/README.md+++ b/packages/package-loader-node/README.md@@ -1,19 +1,19 @@# `@svml/package-loader-node`-Trusted installed-package activation for the Node author compiler. A package lock binds the bytes-of every selected physical package and declared dependency, plus the public identities of its Module,-Frontend, Text Surface and Type Validator facets. Loading verifies all artifact bytes before-executing any activation entry. Authored Records emitted by activated Surfaces pass the same-Manifest-locked Type admission gate used later for provided, Producer and Provider values.+Trusted installed-package activation for the Node Compiler and deterministic compute Host. One+package lock binds every selected physical package and declared dependency byte plus Module,+Frontend, Text Surface, Producer and Type Validator identities. Loading verifies all artifacts and+checks compute facets against their static Manifests before granting a Host registry.-This package is deliberately not an npm client and not a Runtime loader. Source `<import>` can-select only an already activated author module; it cannot activate Providers, credentials, stores,-queues, processes or network access.+This package is deliberately not an npm client and does not activate Provider or privileged Runtime+services. Source `<import>` can select only an already activated author module; trusted deployment+configuration independently chooses whether to grant author or deterministic compute registries.+Executable plans bind the package-lock digest as `BuildRequest.implementationClosure`.```bashsvml-v2 lock-packages ./svml.packages.lock --package @example/cards --root .svml-v2 check ./main.svml --package-lock ./svml.packages.lock --root .```-See [`../../docs/node-author-package-activation-v1.md`](../../docs/node-author-package-activation-v1.md)+See [`../../docs/node-package-activation-v1.md`](../../docs/node-package-activation-v1.md)for the lock, trust and restart laws.diff --git a/packages/package-loader-node/src/activation.ts b/packages/package-loader-node/src/activation.tsindex ee573ea5..3f63bbfd 100644--- a/packages/package-loader-node/src/activation.ts+++ b/packages/package-loader-node/src/activation.ts@@ -1,10 +1,16 @@import {+ registerProducerFacets,registerTypeValidatorFacets,} from "@svml/component-kit";+import type {+ ComponentPackage,+ ProducerRegistrar,+} from "@svml/component-kit";import {ModulePackageRegistry,NodeCompiler,} from "@svml/compiler-node";+import type { RegisteredModulePackage } from "@svml/compiler-node";import { AuthorFrontendRegistry } from "@svml/elaborator";import { isDigest } from "@svml/protocol";import {@@ -13,23 +19,98 @@ import {textAuthorFrontendId,} from "@svml/text";import { TypeValidatorRegistry } from "@svml/validation";+import type { TypeValidatorRegistrar } from "@svml/validation";-import type { NodeAuthorPackage } from "./types.js";+import type { NodePackageActivation } from "./types.js";export type CreateActivatedNodeCompilerOptions = {readonly root?: string;};-function assertPackage(value: NodeAuthorPackage): void {- if (value.format !== "svml.node-author-package@1") {- throw new Error(`${value.name || "author package"} has an unsupported format`);+function assertPackage(value: NodePackageActivation): void {+ if (value.format !== "svml.node-package@1") {+ throw new Error(`${value.name || "Node package"} has an unsupported format`);+ }+ if (value.name.trim().length === 0) throw new Error("Node package name must not be empty");+}++function facetKey(+ ref: { readonly module: { readonly name: string; readonly version: string }; readonly name: string },+): string {+ return `${ref.module.name}@${ref.module.version}#${ref.name}`;+}++/** Verify package-local facet identities before any Host registry receives executable handlers. */+export function nodePackageComponents(+ packages: readonly NodePackageActivation[],+): readonly ComponentPackage[] {+ const packageNames = new Set<string>();+ const moduleRegistry = new ModulePackageRegistry();+ const manifests = new Map<string, RegisteredModulePackage>();+ const components = new Map<string, ComponentPackage>();+ const producers = new Set<string>();+ const validators = new Set<string>();+ for (const item of packages) {+ assertPackage(item);+ if (packageNames.has(item.name)) throw new Error(`Node package ${item.name} is activated twice`);+ packageNames.add(item.name);+ for (const module of item.modules ?? []) {+ const key = `${module.manifest.name}@${module.manifest.version}`;+ if (manifests.has(key)) throw new Error(`Node packages repeat Module ${key}`);+ moduleRegistry.register(module);+ manifests.set(key, module);+ }+ for (const component of item.components ?? []) {+ if (component.name.trim().length === 0) throw new Error(`${item.name} has an empty Component name`);+ if (components.has(component.name)) throw new Error(`Node packages repeat Component ${component.name}`);+ components.set(component.name, component);+ for (const producer of component.producers ?? []) {+ const key = facetKey(producer.producer);+ if (producers.has(key)) throw new Error(`Node packages repeat Producer facet ${key}`);+ producers.add(key);+ }+ for (const validator of component.validators ?? []) {+ const key = facetKey(validator.type);+ if (validators.has(key)) throw new Error(`Node packages repeat Type Validator facet ${key}`);+ validators.add(key);+ }+ }+ }+ for (const component of components.values()) {+ for (const facet of component.producers ?? []) {+ const manifest = manifests.get(`${facet.producer.module.name}@${facet.producer.module.version}`)?.manifest;+ const declaration = manifest?.producers.find((item) => item.name === facet.producer.name);+ if (declaration === undefined) throw new Error(`${component.name} implements undeclared Producer ${facetKey(facet.producer)}`);+ if (declaration.implementation.digest !== facet.implementationDigest) {+ throw new Error(`${component.name} Producer ${facetKey(facet.producer)} differs from its Manifest`);+ }+ }+ for (const facet of component.validators ?? []) {+ const manifest = manifests.get(`${facet.type.module.name}@${facet.type.module.version}`)?.manifest;+ const declaration = manifest?.types.find((item) => item.name === facet.type.name);+ if (declaration?.validator === undefined) throw new Error(`${component.name} validates undeclared Type ${facetKey(facet.type)}`);+ if (declaration.validator.implementation.digest !== facet.implementationDigest) {+ throw new Error(`${component.name} Type Validator ${facetKey(facet.type)} differs from its Manifest`);+ }+ }+ }+ return [...components.values()];+}++export function activateNodeComponents(+ packages: readonly NodePackageActivation[],+ producers: ProducerRegistrar,+ validators: TypeValidatorRegistrar,+): void {+ for (const component of nodePackageComponents(packages)) {+ registerTypeValidatorFacets(validators, component.validators ?? []);+ registerProducerFacets(producers, component.producers ?? []);}- if (value.name.trim().length === 0) throw new Error("author package name must not be empty");}-/** Assemble already trusted author packages without knowing any domain component by name. */+/** Assemble already trusted author facets without knowing any domain component by name. */export function createActivatedNodeCompiler(- packages: readonly NodeAuthorPackage[],+ packages: readonly NodePackageActivation[],options: CreateActivatedNodeCompilerOptions = {},): NodeCompiler {const names = new Set<string>();@@ -40,9 +121,9 @@ export function createActivatedNodeCompiler(for (const item of packages) {assertPackage(item);- if (names.has(item.name)) throw new Error(`author package ${item.name} is activated twice`);+ if (names.has(item.name)) throw new Error(`Node package ${item.name} is activated twice`);names.add(item.name);- for (const module of item.modules) modules.register(module);+ for (const module of item.modules ?? []) modules.register(module);for (const surface of item.textSurfaces ?? []) {if (!isDigest(surface.implementationDigest)) {throw new Error(`${item.name} Surface ${surface.surface} has an invalid implementation digest`);@@ -64,7 +145,10 @@ export function createActivatedNodeCompiler(}}for (const frontend of item.frontends ?? []) frontends.register(frontend);- registerTypeValidatorFacets(validators, item.validators ?? []);+ }++ for (const component of nodePackageComponents(packages)) {+ registerTypeValidatorFacets(validators, component.validators ?? []);}frontends.register(createTextAuthorFrontend({diff --git a/packages/package-loader-node/src/index.ts b/packages/package-loader-node/src/index.tsindex ae6e7a34..a632d7bf 100644--- a/packages/package-loader-node/src/index.ts+++ b/packages/package-loader-node/src/index.ts@@ -1,8 +1,13 @@-export { createActivatedNodeCompiler } from "./activation.js";+export {+ activateNodeComponents,+ createActivatedNodeCompiler,+ nodePackageComponents,+} from "./activation.js";export type { CreateActivatedNodeCompilerOptions } from "./activation.js";export {- createNodeAuthorPackageLock,- loadNodeAuthorPackages,- writeNodeAuthorPackageLock,+ createNodePackageLock,+ loadNodePackageSet,+ loadNodePackages,+ writeNodePackageLock,} from "./lock.js";export type * from "./types.js";diff --git a/packages/package-loader-node/src/lock.ts b/packages/package-loader-node/src/lock.tsindex 5bdfc3ba..46810b20 100644--- a/packages/package-loader-node/src/lock.ts+++ b/packages/package-loader-node/src/lock.ts@@ -19,11 +19,13 @@ import { pathToFileURL } from "node:url";import { digestOf, isDigest } from "@svml/protocol";+import { nodePackageComponents } from "./activation.js";import type {- LockedAuthorPackage,+ LockedNodePackage,LockedPackageArtifact,- NodeAuthorPackage,- NodeAuthorPackageLock,+ LoadedNodePackageSet,+ NodePackageActivation,+ NodePackageLock,} from "./types.js";type PackageJson = {@@ -33,7 +35,7 @@ type PackageJson = {readonly optionalDependencies?: Readonly<Record<string, string>>;readonly peerDependencies?: Readonly<Record<string, string>>;readonly svml?: {- readonly authorActivation?: string;+ readonly activation?: string;};};@@ -71,9 +73,11 @@ function parsePackageJson(value: unknown, subject: string): PackageJson {...(parsed.peerDependencies === undefined? {}: { peerDependencies: object(parsed.peerDependencies, `${subject}.peerDependencies`) as Readonly<Record<string, string>> }),- ...(svml?.authorActivation === undefined- ? {}- : { svml: { authorActivation: string(svml.authorActivation, `${subject}.svml.authorActivation`) } }),+ ...(svml === undefined ? {} : { svml: {+ ...(svml.activation === undefined+ ? {}+ : { activation: string(svml.activation, `${subject}.svml.activation`) }),+ } }),};}@@ -167,22 +171,22 @@ async function artifactDigest(root: string): Promise<LockedPackageArtifact["dige}function activationPath(item: ResolvedPhysicalPackage): string {- const path = item.json.svml?.authorActivation;- assert(path !== undefined, `${item.json.name} does not declare svml.authorActivation`);- assert(!isAbsolute(path), `${item.json.name} authorActivation must be package-relative`);+ const path = item.json.svml?.activation;+ assert(path !== undefined, `${item.json.name} does not declare svml.activation`);+ assert(!isAbsolute(path), `${item.json.name} activation must be package-relative`);const target = resolve(item.root, path);const within = relative(item.root, target);- assert(within !== "" && within !== ".." && !within.startsWith(`..${sep}`), `${item.json.name} authorActivation escapes its package`);+ assert(within !== "" && within !== ".." && !within.startsWith(`..${sep}`), `${item.json.name} activation escapes its package`);return target;}-function activationMetadata(value: NodeAuthorPackage): unknown {- assert(value.format === "svml.node-author-package@1", "author activation has an unsupported format");- assert(value.name.trim().length > 0, "author activation name is empty");+function activationMetadata(value: NodePackageActivation): unknown {+ assert(value.format === "svml.node-package@1", "Node package activation has an unsupported format");+ assert(value.name.trim().length > 0, "Node package activation name is empty");return {format: value.format,name: value.name,- modules: value.modules.map((item) => ({+ modules: (value.modules ?? []).map((item) => ({manifestDigest: digestOf(item.manifest),specifiers: [...(item.specifiers ?? [])].sort(),})).sort((left, right) => left.manifestDigest.localeCompare(right.manifestDigest)),@@ -199,32 +203,43 @@ function activationMetadata(value: NodeAuthorPackage): unknown {`${left.module.name}@${left.module.version}#${left.surface}`.localeCompare(`${right.module.name}@${right.module.version}#${right.surface}`),),- validators: [...(value.validators ?? [])].map((item) => ({- type: item.type,- implementationDigest: item.implementationDigest,- })).sort((left, right) =>- `${left.type.module.name}@${left.type.module.version}#${left.type.name}`- .localeCompare(`${right.type.module.name}@${right.type.module.version}#${right.type.name}`),- ),+ components: [...(value.components ?? [])].map((component) => ({+ name: component.name,+ producers: [...(component.producers ?? [])].map((item) => ({+ producer: item.producer,+ implementationDigest: item.implementationDigest,+ })).sort((left, right) =>+ `${left.producer.module.name}@${left.producer.module.version}#${left.producer.name}`+ .localeCompare(`${right.producer.module.name}@${right.producer.module.version}#${right.producer.name}`),+ ),+ validators: [...(component.validators ?? [])].map((item) => ({+ type: item.type,+ implementationDigest: item.implementationDigest,+ })).sort((left, right) =>+ `${left.type.module.name}@${left.type.module.version}#${left.type.name}`+ .localeCompare(`${right.type.module.name}@${right.type.module.version}#${right.type.name}`),+ ),+ })).sort((left, right) => left.name.localeCompare(right.name)),};}-async function importActivation(item: ResolvedPhysicalPackage): Promise<NodeAuthorPackage> {+async function importActivation(item: ResolvedPhysicalPackage): Promise<NodePackageActivation> {const target = activationPath(item);- assert((await stat(target)).isFile(), `${item.json.name} authorActivation is not a file`);+ assert((await stat(target)).isFile(), `${item.json.name} activation is not a file`);const imported = await import(pathToFileURL(target).href) as {readonly default?: unknown;- readonly svmlAuthorPackage?: unknown;+ readonly svmlPackage?: unknown;};- const value = imported.default ?? imported.svmlAuthorPackage;- assert(value !== null && typeof value === "object", `${item.json.name} authorActivation exports no package`);- const activation = value as NodeAuthorPackage;+ const value = imported.default ?? imported.svmlPackage;+ assert(value !== null && typeof value === "object", `${item.json.name} activation exports no package`);+ const activation = value as NodePackageActivation;assert(activation.name === item.json.name,- `${item.json.name} authorActivation claims physical package ${activation.name}`);+ `${item.json.name} activation claims physical package ${activation.name}`);+ nodePackageComponents([activation]);return activation;}-function lockContent(lock: Omit<NodeAuthorPackageLock, "digest">): Omit<NodeAuthorPackageLock, "digest"> {+function lockContent(lock: Omit<NodePackageLock, "digest">): Omit<NodePackageLock, "digest"> {return {format: lock.format,artifacts: [...lock.artifacts].sort((left, right) =>@@ -234,14 +249,14 @@ function lockContent(lock: Omit<NodeAuthorPackageLock, "digest">): Omit<NodeAuth};}-function sealLock(content: Omit<NodeAuthorPackageLock, "digest">): NodeAuthorPackageLock {+function sealLock(content: Omit<NodePackageLock, "digest">): NodePackageLock {const normalized = lockContent(content);return { ...normalized, digest: digestOf(normalized) };}-function parseLock(value: unknown): NodeAuthorPackageLock {+function parseLock(value: unknown): NodePackageLock {const parsed = object(value, "$lock");- assert(parsed.format === "svml.node-author-lock@1", "$lock.format must be svml.node-author-lock@1");+ assert(parsed.format === "svml.node-package-lock@1", "$lock.format must be svml.node-package-lock@1");assert(Array.isArray(parsed.artifacts), "$lock.artifacts must be an array");assert(Array.isArray(parsed.packages), "$lock.packages must be an array");const artifacts = parsed.artifacts.map((raw, index) => {@@ -270,8 +285,8 @@ function parseLock(value: unknown): NodeAuthorPackageLock {});const digest = string(parsed.digest, "$lock.digest");assert(isDigest(digest), "$lock.digest is invalid");- const lock = sealLock({ format: "svml.node-author-lock@1", artifacts, packages });- assert(lock.digest === digest, "Node author package lock digest is invalid");+ const lock = sealLock({ format: "svml.node-package-lock@1", artifacts, packages });+ assert(lock.digest === digest, "Node package lock digest is invalid");return lock;}@@ -289,14 +304,14 @@ function sameArtifacts(left: readonly LockedPackageArtifact[], right: readonly L}/** Lock creation is the explicit trust action and therefore may inspect the selected package exports. */-export async function createNodeAuthorPackageLock(+export async function createNodePackageLock(specifiers: readonly string[],root: string,-): Promise<NodeAuthorPackageLock> {+): Promise<NodePackageLock> {const unique = [...new Set(specifiers)].sort();- assert(unique.length > 0, "at least one author package is required");+ assert(unique.length > 0, "at least one Node package is required");const closure = await packageClosure(unique, root);- const packages: LockedAuthorPackage[] = [];+ const packages: LockedNodePackage[] = [];for (const specifier of unique) {const physical = await resolvePhysicalPackage(specifier, root);const activation = await importActivation(physical);@@ -307,36 +322,43 @@ export async function createNodeAuthorPackageLock(});}return sealLock({- format: "svml.node-author-lock@1",+ format: "svml.node-package-lock@1",artifacts: await resolvedArtifacts(closure),packages,});}-export async function writeNodeAuthorPackageLock(path: string, lock: NodeAuthorPackageLock): Promise<void> {+export async function writeNodePackageLock(path: string, lock: NodePackageLock): Promise<void> {await writeFile(path, `${JSON.stringify(lock, null, 2)}\n`, { encoding: "utf8", flag: "w" });}/** Verify every selected physical artifact before executing any package activation code. */-export async function loadNodeAuthorPackages(+export async function loadNodePackageSet(path: string,root = dirname(resolve(path)),-): Promise<readonly NodeAuthorPackage[]> {+): Promise<LoadedNodePackageSet> {const lock = parseLock(JSON.parse(await readFile(path, "utf8")));const specifiers = lock.packages.map((item) => item.specifier);const closure = await packageClosure(specifiers, root);const artifacts = await resolvedArtifacts(closure);- assert(sameArtifacts(artifacts, lock.artifacts), "installed author package bytes do not match the lock");+ assert(sameArtifacts(artifacts, lock.artifacts), "installed Node package bytes do not match the lock");const byName = new Map(closure.map((item) => [`${item.json.name}@${item.json.version}`, item]));- const values: NodeAuthorPackage[] = [];+ const values: NodePackageActivation[] = [];for (const expected of lock.packages) {const physical = byName.get(`${expected.package.name}@${expected.package.version}`);assert(physical !== undefined, `${expected.package.name}@${expected.package.version} is not installed`);assert(physical.json.name === expected.specifier, `${expected.specifier} resolved to another package`);const activation = await importActivation(physical);assert(digestOf(activationMetadata(activation)) === expected.facetsDigest,- `${expected.specifier} author facets do not match the lock`);+ `${expected.specifier} facets do not match the lock`);values.push(activation);}- return values;+ return { lock, packages: values };+}++export async function loadNodePackages(+ path: string,+ root = dirname(resolve(path)),+): Promise<readonly NodePackageActivation[]> {+ return (await loadNodePackageSet(path, root)).packages;}diff --git a/packages/package-loader-node/src/types.ts b/packages/package-loader-node/src/types.tsindex b923fa95..1bed7b4f 100644--- a/packages/package-loader-node/src/types.ts+++ b/packages/package-loader-node/src/types.ts@@ -1,6 +1,6 @@import type { RegisteredModulePackage } from "@svml/compiler-node";+import type { ComponentPackage } from "@svml/component-kit";import type { AuthorFrontend } from "@svml/elaborator";-import type { TypeValidatorFacet } from "@svml/component-kit";import type { Digest, ModuleRef } from "@svml/protocol";import type {RawSurfaceHandler,@@ -24,16 +24,17 @@ export type NodeTextSurfaceFacet =};/**- * Trusted executable author-compiler facets exported by one installed physical package.- * It intentionally has no Provider, credential, store, queue or Runtime facet.+ * 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.*/-export type NodeAuthorPackage = {- readonly format: "svml.node-author-package@1";+export type NodePackageActivation = {+ readonly format: "svml.node-package@1";readonly name: string;- readonly modules: readonly RegisteredModulePackage[];+ readonly modules?: readonly RegisteredModulePackage[];readonly frontends?: readonly AuthorFrontend[];readonly textSurfaces?: readonly NodeTextSurfaceFacet[];- readonly validators?: readonly TypeValidatorFacet[];+ readonly components?: readonly ComponentPackage[];};export type LockedPackageArtifact = {@@ -42,20 +43,25 @@ export type LockedPackageArtifact = {readonly digest: Digest;};-export type LockedAuthorPackage = {+export type LockedNodePackage = {/** Node package name used only for installed-package resolution. */readonly specifier: string;readonly package: {readonly name: string;readonly version: string;};- /** Digest of declared module/frontend/surface identities, excluding executable functions. */+ /** Digest of declared Module, author and compute facet identities, excluding function objects. */readonly facetsDigest: Digest;};-export type NodeAuthorPackageLock = {- readonly format: "svml.node-author-lock@1";+export type NodePackageLock = {+ readonly format: "svml.node-package-lock@1";readonly digest: Digest;readonly artifacts: readonly LockedPackageArtifact[];- readonly packages: readonly LockedAuthorPackage[];+ readonly packages: readonly LockedNodePackage[];+};++export type LoadedNodePackageSet = {+ readonly lock: NodePackageLock;+ readonly packages: readonly NodePackageActivation[];};diff --git a/packages/package-loader-node/test/loader.test.ts b/packages/package-loader-node/test/loader.test.tsindex 9eda9bb5..b9e89d07 100644--- a/packages/package-loader-node/test/loader.test.ts+++ b/packages/package-loader-node/test/loader.test.ts@@ -10,13 +10,17 @@ import { join } from "node:path";import test from "node:test";import {+ activateNodeComponents,createActivatedNodeCompiler,- createNodeAuthorPackageLock,- loadNodeAuthorPackages,- writeNodeAuthorPackageLock,+ createNodePackageLock,+ loadNodePackages,+ writeNodePackageLock,} from "@svml/package-loader-node";+import { TypeValidatorRegistry } from "@svml/validation";+import type { ProducerRef } from "@svml/protocol";const implementationDigest = `sha256:${"1".repeat(64)}`;+const producerDigest = `sha256:${"3".repeat(64)}`;async function fixture(): Promise<{readonly root: string;@@ -45,14 +49,16 @@ async function fixture(): Promise<{type: "module",exports: "./activation.mjs",dependencies: { "example-helper": "1.0.0" },- svml: { authorActivation: "./activation.mjs" },+ svml: { activation: "./activation.mjs" },}, null, 2), "utf8");await writeFile(activation, `const module = { name: "example.card", version: "1" };const digest = ${JSON.stringify(implementationDigest)};+ const producerDigest = ${JSON.stringify(producerDigest)};const resultType = { module, name: "CardResult" };+ const producer = { module, name: "make-card" };export default {- format: "svml.node-author-package@1",+ format: "svml.node-package@1",name: "example-card",modules: [{manifest: {@@ -84,7 +90,17 @@ async function fixture(): Promise<{digest,},}],- producers: [],+ producers: [{+ name: producer.name,+ inputs: [],+ outputs: [{ name: "result", type: resultType }],+ needs: [],+ implementation: {+ kind: "registered",+ locator: "example-card/make-card",+ digest: producerDigest,+ },+ }],},specifiers: ["example.card@1"],}],@@ -106,15 +122,30 @@ async function fixture(): Promise<{};},}],- validators: [{- type: resultType,- implementationDigest: digest,- handler({ value }) {- if (value.kind !== "inline" || value.value !== "accepted") {- throw new Error("CardResult is not accepted");- }+ components: [+ {+ name: "example-card/contracts",+ validators: [{+ type: resultType,+ implementationDigest: digest,+ handler({ value }) {+ if (value.kind !== "inline" || value.value !== "accepted") {+ throw new Error("CardResult is not accepted");+ }+ },+ }],},- }],+ {+ name: "example-card/compute",+ producers: [{+ producer,+ implementationDigest: producerDigest,+ handler() {+ return { outputs: { result: { kind: "inline", value: "accepted" } }, needs: {} };+ },+ }],+ },+ ],};`, "utf8");const source = join(root, "main.svml");@@ -127,10 +158,10 @@ async function fixture(): Promise<{test("an installed locked package adds a Surface without an official CLI registration", async () => {const item = await fixture();- const lock = await createNodeAuthorPackageLock(["example-card"], item.root);+ const lock = await createNodePackageLock(["example-card"], item.root);assert.deepEqual(lock.artifacts.map((artifact) => artifact.name), ["example-card", "example-helper"]);- await writeNodeAuthorPackageLock(item.lock, lock);- const packages = await loadNodeAuthorPackages(item.lock, item.root);+ await writeNodePackageLock(item.lock, lock);+ const packages = await loadNodePackages(item.lock, item.root);const compiler = createActivatedNodeCompiler(packages, { root: item.root });const result = await compiler.compileFile(item.source);@@ -141,16 +172,45 @@ test("an installed locked package adds a Surface without an official CLI registrassert.equal(result.module.records[0]?.value.kind, "inline");assert.equal(result.module.records[0]?.validation?.validatorDigest, implementationDigest);assert.equal(result.elaboration.graph.operations.length, 0);++ const registered: Array<{ readonly producer: ProducerRef; readonly digest: string }> = [];+ activateNodeComponents(packages, {+ registerProducer(producer, digest) {+ registered.push({ producer, digest });+ },+ }, new TypeValidatorRegistry());+ assert.deepEqual(registered, [{+ producer: { module: { name: "example.card", version: "1" }, name: "make-card" },+ digest: producerDigest,+ }]);});test("dependency bytes are rejected before a locked activation is reused", async () => {const item = await fixture();- const lock = await createNodeAuthorPackageLock(["example-card"], item.root);- await writeNodeAuthorPackageLock(item.lock, lock);+ const lock = await createNodePackageLock(["example-card"], item.root);+ await writeNodePackageLock(item.lock, lock);await writeFile(item.dependency, `${await readFile(item.dependency, "utf8")}\n// changed bytes\n`, "utf8");await assert.rejects(- async () => await loadNodeAuthorPackages(item.lock, item.root),- /installed author package bytes do not match the lock/,+ async () => await loadNodePackages(item.lock, item.root),+ /installed Node package bytes do not match the lock/,+ );+});++test("a compute facet cannot claim another implementation than its static Manifest", async () => {+ const item = await fixture();+ const source = await readFile(item.activation, "utf8");+ await writeFile(+ item.activation,+ source.replace(+ "implementationDigest: producerDigest,\n handler()",+ `implementationDigest: ${JSON.stringify(`sha256:${"4".repeat(64)}`)},\n handler()`,+ ),+ "utf8",+ );++ await assert.rejects(+ async () => await createNodePackageLock(["example-card"], item.root),+ /Producer .* differs from its Manifest/u,);});diff --git a/packages/prelude-video/README.md b/packages/prelude-video/README.mdindex 168118b9..daad5b4e 100644--- a/packages/prelude-video/README.md+++ b/packages/prelude-video/README.md@@ -1,8 +1,9 @@# `@svml/prelude-video`-Ordinary author-package aggregate for the official video language. It contributes Module-Manifests, the SVS Frontend and official Text Surfaces. It has no Provider, credential, store,-queue, network or rendering authority.+Ordinary multi-facet package aggregate for the official video language. It contributes Module+Manifests, the SVS Frontend, official Text Surfaces and the deterministic compute facets currently+owned by those modules. Compiler and Runtime Hosts grant those facets independently. The package+has no Provider, credential, store, queue, network or rendering authority.The CLI depends only on this replaceable prelude rather than enumerating Script, Film orHyperFrames packages itself.diff --git a/packages/prelude-video/package.json b/packages/prelude-video/package.jsonindex bef211ce..70ed1bf0 100644--- a/packages/prelude-video/package.json+++ b/packages/prelude-video/package.json@@ -7,7 +7,7 @@".": "./src/index.ts"},"svml": {- "authorActivation": "./src/index.ts"+ "activation": "./src/index.ts"},"dependencies": {"@svml/contracts": "workspace:*",diff --git a/packages/prelude-video/src/index.ts b/packages/prelude-video/src/index.tsindex 10a50f15..05796241 100644--- a/packages/prelude-video/src/index.ts+++ b/packages/prelude-video/src/index.ts@@ -1,7 +1,6 @@import {- compositionContractsComponent,- mediaContractsComponent,videoContractManifests,+ videoContractsComponents,} from "@svml/contracts";import {decodeFilmSurface,@@ -9,9 +8,13 @@ import {filmModuleRef,filmSurfaceImplementationDigest,} from "@svml/film";-import { hyperframesManifest } from "@svml/hyperframes";+import {+ hyperframesComponent,+ hyperframesManifest,+} from "@svml/hyperframes";import {decodeHyperframesRenderSurface,+ hyperframesRenderComponent,hyperframesRenderManifest,hyperframesRenderModuleRef,hyperframesRenderSurfaceImplementationDigest,@@ -20,7 +23,7 @@ import {mediaPipelineComponent,mediaPipelineManifest,} from "@svml/media-pipeline";-import type { NodeAuthorPackage } from "@svml/package-loader-node";+import type { NodePackageActivation } from "@svml/package-loader-node";import {decodeScriptSurface,scriptManifest,@@ -29,8 +32,8 @@ import {} from "@svml/script";import { svsFrontend, svsManifest } from "@svml/svs";-export const svmlAuthorPackage: NodeAuthorPackage = {- format: "svml.node-author-package@1",+export const svmlPackage: NodePackageActivation = {+ format: "svml.node-package@1",name: "@svml/prelude-video",modules: [...videoContractManifests.map((manifest) => ({ manifest })),@@ -45,10 +48,11 @@ export const svmlAuthorPackage: NodeAuthorPackage = {},],frontends: [svsFrontend],- validators: [- ...mediaContractsComponent.validators,- ...compositionContractsComponent.validators,- ...mediaPipelineComponent.validators,+ components: [+ ...videoContractsComponents,+ mediaPipelineComponent,+ hyperframesComponent,+ hyperframesRenderComponent,],textSurfaces: [{@@ -75,4 +79,4 @@ export const svmlAuthorPackage: NodeAuthorPackage = {],};-export default svmlAuthorPackage;+export default svmlPackage;diff --git a/packages/protocol/src/build.ts b/packages/protocol/src/build.tsindex 342e76d5..5234c2c0 100644--- a/packages/protocol/src/build.ts+++ b/packages/protocol/src/build.ts@@ -243,6 +243,8 @@ export type CandidateBinding = {export type BuildRequest = {readonly format: "svml.build-request@1";readonly graph: Digest;+ /** Exact trusted implementation-package closure selected outside author source. */+ readonly implementationClosure?: Digest;readonly targets: readonly BuildTarget[];readonly bindings: readonly CandidateBinding[];readonly digest: Digest;diff --git a/packages/provider-kie/README.md b/packages/provider-kie/README.mdindex 65fc655c..bd6d57ca 100644--- a/packages/provider-kie/README.md+++ b/packages/provider-kie/README.md@@ -62,7 +62,9 @@ export default await createProjectLocalRuntime({});```-The shared `generationComponent` installs semantic validators for generated-media Products. Each+The explicit `components` list above is the low-level embedding form; a reproducible project should+publish the same set through an installed aggregate and select it with `packageLock`. The shared+`generationComponent` publishes semantic validators for generated-media Products. Eachmodel component installs its exact request validators and deterministic request-to-Need Producers.The `.svml` Module Closure separately contains only the model Manifests actually imported by theauthor document; installing Runtime code does not implicitly add author intent.diff --git a/packages/provider-media-local/README.md b/packages/provider-media-local/README.mdindex 93cdc9a6..0f672c05 100644--- a/packages/provider-media-local/README.md+++ b/packages/provider-media-local/README.md@@ -5,11 +5,10 @@ capabilities. It is Runtime configuration and is never imported by author `.svml```tsimport { createProjectLocalRuntime } from "@svml/local";-import { mediaPipelineComponents } from "@svml/media-pipeline";import { createLocalMediaProvider } from "@svml/provider-media-local";const runtime = await createProjectLocalRuntime({- components: mediaPipelineComponents,+ packageLock: "./svml.packages.lock",providers: [createLocalMediaProvider({ defaultConcurrency: 1 })],allowedPermissions: ["process:media"],});diff --git a/packages/whisperx/src/component.ts b/packages/whisperx/src/component.tsindex c33aeb78..5d2c129c 100644--- a/packages/whisperx/src/component.ts+++ b/packages/whisperx/src/component.ts@@ -1,3 +1,4 @@+import type { ComponentPackage } from "@svml/component-kit";import type { SpeechEvidenceAudio } from "@svml/contracts";import type { CanonicalValue, StoredValue } from "@svml/protocol";import { canonicalize } from "@svml/protocol";@@ -19,22 +20,22 @@ function inline(value: StoredValue, subject: string): CanonicalValue {export const whisperXComponent = {name: "@svml/whisperx",- install(registry: import("@svml/component-kit").ProducerRegistrar): void {- registry.registerProducer(- whisperXProducers.request,- whisperXImplementationDigests.request,- ({ inputs }) => {+ producers: [+ {+ producer: whisperXProducers.request,+ implementationDigest: whisperXImplementationDigests.request,+ handler: ({ inputs }) => {const audio = inline(inputs.audio!.value, "SpeechEvidenceAudio") as unknown as SpeechEvidenceAudio;return {outputs: {},needs: { alignment: canonicalize(whisperXRequestForEvidenceAudio(audio)) },};},- );- registry.registerProducer(- whisperXProducers.normalize,- whisperXImplementationDigests.normalize,- ({ inputs }) => {+ },+ {+ producer: whisperXProducers.normalize,+ implementationDigest: whisperXImplementationDigests.normalize,+ handler: ({ inputs }) => {const evidence = inline(inputs.whisperx!.value, "WhisperXAlignmentEvidence") as unknown as WhisperXAlignmentEvidence;return {outputs: {@@ -43,6 +44,6 @@ export const whisperXComponent = {needs: {},};},- );- },-};+ },+ ],+} satisfies ComponentPackage;diff --git a/packages/whisperx/test/whisperx.test.ts b/packages/whisperx/test/whisperx.test.tsindex 3c85ade4..b84a977b 100644--- a/packages/whisperx/test/whisperx.test.ts+++ b/packages/whisperx/test/whisperx.test.ts@@ -1,6 +1,9 @@import assert from "node:assert/strict";import test from "node:test";+import {+ registerProducerFacets,+} from "@svml/component-kit";import type { ProducerRegistrar } from "@svml/component-kit";import { sealProgramSpace, sealSpeechBasis, sealSpeechEvidenceAudio } from "@svml/contracts";import type { SpeechBasis, SpeechEvidenceAudio } from "@svml/contracts";@@ -114,7 +117,7 @@ test("WhisperX installs into the host-neutral compute port without a Node Driver},};- whisperXComponent.install(registrar);+ registerProducerFacets(registrar, whisperXComponent.producers);assert.deepEqual(registrations.map((item) => item.producer), [whisperXProducers.request,diff --git a/pnpm-lock.yaml b/pnpm-lock.yamlindex a987f9a8..350cfbf1 100644--- a/pnpm-lock.yaml+++ b/pnpm-lock.yaml@@ -345,6 +345,9 @@ importers:'@svml/driver-node':specifier: workspace:*version: link:../driver-node+ '@svml/package-loader-node':+ specifier: workspace:*+ version: link:../package-loader-node'@svml/protocol':specifier: workspace:*version: link:../protocol