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.

docs(runtime): document explicit durable execution

kashorin6bf19c7c78b4
diff --git a/docs/guide/providers.md b/docs/guide/providers.md
index bec821e2..b3d46d5a 100644
--- a/docs/guide/providers.md
+++ b/docs/guide/providers.md
@@ -55,7 +55,7 @@ import type { EndpointManifest } from "@narratage/endpoint-kit";
export function createMyServiceProvider(options: {
instance: string;
lane?: string;
- apiKey?: { env: string };
+ apiKey: CredentialRef;
defaultConcurrency?: number;
}) {
// Return an object with:
@@ -80,34 +80,37 @@ Look at existing Providers for reference:
// src/activation.ts
import {
createRuntimeEndpointAdapterFacet,
+ runtimeConfigCredentialRef,
+ runtimeConfigExact,
runtimeConfigObject,
- runtimeConfigString,
runtimeConfigPositiveInteger,
} from "@narratage/runtime-adapter";
-import { diagnoseRuntimeEnvironmentCredential } from "@narratage/runtime-adapter-node";
import { createMyServiceProvider } from "./provider.js";
const adapter = createRuntimeEndpointAdapterFacet({
use: "@narratage/provider-my-service",
+ validate(context) {
+ const config = runtimeConfigObject(context.config, "MyService");
+ runtimeConfigExact(config, ["apiKey", "defaultConcurrency"], "MyService");
+ if (runtimeConfigCredentialRef(config.apiKey, "MyService apiKey") === undefined) {
+ throw new Error("MyService apiKey CredentialRef is required");
+ }
+ runtimeConfigPositiveInteger(config.defaultConcurrency, "concurrency");
+ },
+
create(context) {
const config = runtimeConfigObject(context.config, "MyService");
- const apiKeyEnv = runtimeConfigString(config.apiKeyEnv, "MyService apiKeyEnv");
+ const apiKey = runtimeConfigCredentialRef(config.apiKey, "MyService apiKey");
+ if (apiKey === undefined) throw new Error("MyService apiKey CredentialRef is required");
return createMyServiceProvider({
instance: context.instance,
lane: context.lane,
- ...(apiKeyEnv === undefined ? {} : { apiKey: { env: apiKeyEnv } }),
+ apiKey,
...(runtimeConfigPositiveInteger(config.defaultConcurrency, "concurrency") === undefined
? {} : { defaultConcurrency: config.defaultConcurrency as number }),
});
},
-
- doctor(context) {
- const config = runtimeConfigObject(context.config, "MyService");
- const apiKeyEnv = runtimeConfigString(config.apiKeyEnv, "MyService apiKeyEnv")
- ?? "MY_SERVICE_API_KEY";
- return diagnoseRuntimeEnvironmentCredential(apiKeyEnv, "MyService");
- },
});
export const svmlPackage = {
@@ -119,9 +122,9 @@ export const svmlPackage = {
export default svmlPackage;
```
-The `create` function constructs the Endpoint from Runtime config. The `doctor` function returns
-diagnostics (credential presence, executable availability) without constructing or calling
-anything.
+`validate` is pure and runs before authority is granted. `create` constructs the Endpoint only
+after the profile, lock and permissions pass. Credential presence is diagnosed through the generic
+CredentialStore/Endpoint description path; a Provider must not special-case environment variables.
## 5. Declare an external service (if needed)
@@ -155,9 +158,9 @@ const adapter = createRuntimeEndpointAdapterFacet({
});
```
-`pnpm install` will run `prepare` automatically, and `narratage build` will call `start` and
-`probe` before the first Operation. Providers that call only remote APIs (no local program) omit
-this step entirely — leave `"service"` out of `package.json`.
+`narratage runtime up` prepares, starts and probes declared external programs before starting the
+durable Worker. `build` ensures that Runtime is running before submission. Providers that call only
+remote APIs omit this step entirely—leave `"service"` out of `package.json`.
## 6. Register and lock
@@ -185,7 +188,7 @@ pnpm narratage lock-packages <runtime-lock> \
"instance": "my-service.project",
"lane": "generation",
"config": {
- "apiKeyEnv": "MY_SERVICE_API_KEY",
+ "apiKey": { "store": "keychain", "key": "my-service.api-key" },
"defaultConcurrency": 2
}
}
diff --git a/docs/guide/runtime-profile.md b/docs/guide/runtime-profile.md
index 3b9daaf7..fa6c67f7 100644
--- a/docs/guide/runtime-profile.md
+++ b/docs/guide/runtime-profile.md
@@ -5,9 +5,9 @@ description: Configuring where Builds execute, diagnostics and Build archive.
# Runtime Profile
-The Runtime Profile declares *where* a frozen Build executes: Endpoints, credentials, concurrency,
-permissions. It is deployment configuration, not creative content — it never enters Author or Run
-graph identity.
+The Runtime Profile declares *where* a frozen Build executes: the Scheduler and Worker, all durable
+Stores, Endpoints, credentials, concurrency and permissions. It is deployment configuration, not
+creative content—it never enters Author or Run graph identity.
Two forms are supported:
@@ -23,13 +23,31 @@ Two forms are supported:
"format": "svml.runtime-config@1",
"packageLock": "./svml.packages.lock",
"runtimePackageLock": "./svml.runtime-packages.lock",
+ "runtimeServices": [
+ { "use": "@narratage/local", "instance": "execution" },
+ { "use": "@narratage/store-sqlite", "instance": "state", "config": { "path": ".svml/runtime.sqlite" } },
+ { "use": "@narratage/artifact-store-fs", "instance": "artifacts", "config": { "path": ".svml/artifacts" } },
+ { "use": "@narratage/credential-store-keychain", "instance": "credentials.keychain", "config": { "service": "narratage" } }
+ ],
+ "services": {
+ "scheduler": "execution.scheduler",
+ "worker": "execution.worker",
+ "stores": {
+ "build": "state.builds",
+ "operations": "state.operations",
+ "dispatch": "state.dispatch",
+ "journal": "state.journal",
+ "artifacts": "artifacts",
+ "credentials": ["credentials.keychain"]
+ }
+ },
"endpoints": [
{
"use": "@narratage/provider-kie",
"instance": "kie.production",
"lane": "generation",
"config": {
- "apiKeyEnv": "KIE_API_KEY",
+ "apiKey": { "store": "keychain", "key": "kie.api-key" },
"defaultConcurrency": 2
}
},
@@ -51,7 +69,7 @@ Two forms are supported:
"lane": "planning",
"config": {
"projectEnv": "GOOGLE_CLOUD_PROJECT",
- "credentialsEnv": "GOOGLE_APPLICATION_CREDENTIALS_JSON",
+ "credentials": { "store": "keychain", "key": "google.vertex-json" },
"defaultConcurrency": 1
}
},
@@ -63,6 +81,9 @@ Two forms are supported:
}
],
"permissions": [
+ "process:keychain",
+ "filesystem:artifacts",
+ "filesystem:state",
"filesystem:whisperx-staging",
"network:aiplatform.googleapis.com",
"network:api.kie.ai",
@@ -90,9 +111,18 @@ Two forms are supported:
| `use` | Adapter name, resolved from `runtimePackageLock` |
| `instance` | Unique identifier for this Endpoint instance |
| `lane` | Scheduling lane governing concurrency |
-| `config` | Adapter-specific configuration (credential env vars, concurrency, timeouts) |
+| `config` | Adapter-specific non-secret configuration, CredentialRefs, concurrency and timeouts |
+
+Credentials are addressed as `{ "store": "…", "key": "…" }`; secret bytes never enter the
+Profile. More than one selected CredentialStore may coexist, and each answers only for its own
+store name.
-Credentials are referenced by environment variable name, never stored in the Profile.
+### Runtime service fields
+
+`runtimeServices` activates installed service adapters. `services` selects every required role by
+its exact instance id: Scheduler, Worker, BuildStore, OperationStore, DispatchStore,
+RuntimeJournal, ArtifactStore and one or more CredentialStores. No role is inferred from package
+presence or filled by `@narratage/local`.
### Filesystem fields
@@ -109,8 +139,9 @@ Neither value enters Author or Run graph identity.
### Scheduling
-`maxConcurrency` caps total concurrent Operations across all lanes. Each named `lane` has its own
-sub-cap. Lanes are declared by the Endpoint and enforced by the Scheduler.
+`maxConcurrency` caps admitted Operations across all Workers sharing the DispatchStore. Each named
+`lane` has its own sub-cap. Capacity reservations are durable and fenced by the Build lease rather
+than process-local counters.
### Permissions
@@ -125,15 +156,33 @@ Each permission string grants one specific authority to the locked Endpoints:
For advanced embedding, construct the Runtime programmatically:
```typescript
-import { createProjectLocalRuntime } from "@narratage/local";
+import { join } from "node:path";
+import { createFileArtifactStorePackage } from "@narratage/artifact-store-fs";
+import { createEnvironmentCredentialStorePackage } from "@narratage/credential-store-env";
+import { createLocalExecutionPackage, createProjectLocalRuntime } from "@narratage/local";
import { createKieProvider } from "@narratage/provider-kie";
import { createLocalMediaProvider } from "@narratage/provider-media-local";
+import { credentialRef } from "@narratage/runtime";
+import { createSqliteRuntimeServicePackage } from "@narratage/store-sqlite";
export default async function createRuntime() {
+ const root = import.meta.dirname;
+ const execution = createLocalExecutionPackage("execution");
+ const state = createSqliteRuntimeServicePackage({
+ path: join(root, ".svml/runtime.sqlite"),
+ name: "state",
+ buildInstance: "state.builds",
+ operationInstance: "state.operations",
+ dispatchInstance: "state.dispatch",
+ journalInstance: "state.journal",
+ });
+ const artifacts = createFileArtifactStorePackage({ root: join(root, ".svml/artifacts"), instance: "artifacts" });
+ const credentials = createEnvironmentCredentialStorePackage({ instance: "credentials.env" });
const endpoints = [
createKieProvider({
instance: "kie.prod",
lane: "generation",
+ apiKey: credentialRef("env", "KIE_API_KEY"),
defaultConcurrency: 2,
}),
createLocalMediaProvider({
@@ -144,11 +193,26 @@ export default async function createRuntime() {
];
return await createProjectLocalRuntime({
- root: import.meta.dirname,
+ root,
packageLock: "./svml.packages.lock",
+ runtimeServices: [execution, state, artifacts, credentials],
+ runtimeSelection: {
+ scheduler: "execution.scheduler",
+ worker: "execution.worker",
+ stores: {
+ build: "state.builds",
+ operations: "state.operations",
+ dispatch: "state.dispatch",
+ journal: "state.journal",
+ artifacts: "artifacts",
+ credentials: ["credentials.env"],
+ },
+ },
endpoints,
- allowedPermissions: endpoints.flatMap(e =>
- e.manifest.facets.flatMap(f => f.permissions)),
+ allowedPermissions: [
+ "environment:credentials", "filesystem:artifacts", "filesystem:state",
+ ...endpoints.flatMap(e => e.manifest.facets.flatMap(f => f.permissions)),
+ ],
scheduling: {
maxConcurrency: 4,
lanes: { generation: 2, media: 2 },
@@ -164,6 +228,9 @@ pnpm narratage build build.svrun --runtime ./svml.runtime.json
pnpm narratage build build.svrun --runtime ./svml.runtime.ts
```
+Both forms describe the same explicit assembly. The TypeScript form is trusted embedding code, not
+a source-language escape hatch or a place for author intent.
+
## Diagnostics
### doctor
@@ -178,7 +245,7 @@ Validates:
- Package locks exist and are readable
- Adapter byte digests match
- Configuration keys are valid for each adapter
-- Referenced credentials exist in the environment
+- Referenced credentials resolve from their selected stores
- Required executables (ffmpeg, ffprobe, chrome) are found
- Declared external services are reachable and match the selected profile
@@ -188,6 +255,19 @@ submits work. After configuration passes it may make bounded read-only environme
configuration or prerequisite failure for one instance suppresses diagnostics that merely result
from that same failure.
+## Runtime lifecycle
+
+```bash
+pnpm narratage runtime up svml.runtime.json
+pnpm narratage runtime status svml.runtime.json
+pnpm narratage runtime logs svml.runtime.json
+pnpm narratage runtime down svml.runtime.json
+```
+
+`runtime up` owns the detached Worker plus declared external programs. `services` remains a narrow
+expert command for those external programs only. A Build submission ensures the Runtime is up, but
+the Build terminal never owns execution.
+
### gc (garbage collection)
```bash
diff --git a/docs/guide/services.md b/docs/guide/services.md
index 465f2792..3ae5c303 100644
--- a/docs/guide/services.md
+++ b/docs/guide/services.md
@@ -1,158 +1,112 @@
---
-title: Local Services
-description: Setting up the WhisperX and OpenCV services.
+title: Runtime & External Services
+description: Managing the durable Worker and local programs selected by a Runtime Profile.
---
-# Local Services
+# Runtime & External Services
-Local Builds may depend on managed daemons, prepared tool assets or operator-owned executables.
-They are Runtime deployment concerns, not part of Core or the author language.
+Two lifecycle scopes are deliberately separate.
-This page describes the current pre-Worker command surface. The domain-neutral target separates
-prepared tools, managed daemons, remote dependency probes and the Build Worker beneath one
-`runtime` lifecycle; see [`../runtime-execution-control.md`](../runtime-execution-control.md).
-
-For an installed Runtime Profile, prefer the profile-scoped lifecycle:
+## Runtime execution domain
```bash
-pnpm narratage services up svml.runtime.json
-pnpm narratage doctor svml.runtime.json
-```
-
-Only Providers selected by that Profile are prepared. `services up` may prepare or start deployment
-state; `doctor` is read-only. The commands below are the equivalent manual operations.
-
-## Automatic setup
-
-You normally do not run any of the commands on this page. `pnpm install` prepares every service
-that an installed Provider declares, and `narratage build` starts them:
-
-```bash
-pnpm install # prepares the Python environments
-pnpm narratage build build.svrun --runtime svml.runtime.json --follow
+pnpm narratage runtime up svml.runtime.json
+pnpm narratage runtime status svml.runtime.json
+pnpm narratage runtime logs svml.runtime.json
+pnpm narratage runtime down svml.runtime.json
```
-A Build starts only the services its Runtime Profile declares, leaves them running between Builds
-so a warm model is not reloaded, and stops before its first Operation if one cannot be reached —
-so an unavailable service never costs a paid generation.
+`runtime up` starts or reuses the detached fenced Worker and also prepares/starts the external
+programs declared by selected adapters. The process identity, profile digest and log path are
+project-scoped. Repeating `runtime up` does not create a second Worker for the same domain.
-Manage them directly when you need to:
+`runtime status` combines:
-```bash
-pnpm narratage services status svml.runtime.json # what is running
-pnpm narratage services up svml.runtime.json # start without building
-pnpm narratage services down svml.runtime.json # stop what this project started
-pnpm narratage build … --no-services # build against what is already running
-```
-
-`pnpm install` skips preparation when `uv` is absent and says so; it never fails the install. The
-rest of this page is what those commands run, for when one of them fails or you are deploying
-outside this repository.
-
-## WhisperX
+- Worker process and profile identity;
+- durable queue phase counts and shared capacity reservations;
+- declared external-program health.
-Provides ASR and language-specific alignment for speech timing measurement.
+The Worker record binds an effective Profile revision covering the Profile bytes plus both package
+locks it names. Editing the same Profile path or regenerating either lock makes the old process
+`stale`; the next `runtime up` or `build` replaces it before admitting work under the new
+configuration.
-### Install by hand
+`runtime down` asks the Worker to stop and then stops programs that the Profile owns. It does not
+cancel Builds or remote Provider jobs. Queued Builds remain durable and continue after the Runtime
+is brought up again.
-`pnpm install` runs the first three of these. WhisperX 3.8.6 supports Python 3.10–3.13, and the
-checked-in lock selects 3.13:
+## External programs only
```bash
-uv python install 3.13
-uv sync --project services/whisperx --frozen
-uv run --project services/whisperx --frozen svml-whisperx-prepare
-uv run --project services/whisperx --frozen svml-whisperx-check
+pnpm narratage services up svml.runtime.json
+pnpm narratage services status svml.runtime.json
+pnpm narratage services down svml.runtime.json
```
-`svml-whisperx-prepare` installs NLTK's `punkt_tab` sentence data from a pinned archive after
-SHA-256 verification. This is required by WhisperX alignment and is never downloaded during
-inference.
+`services` is an expert/debugging command. It never starts the Worker and never reads or mutates a
+Build queue. It operates only on adapter-declared programs such as:
-The first model start may download ASR and alignment weights. Production should put the Hugging
-Face cache on persistent storage.
+- the warm local WhisperX HTTP service;
+- the managed OpenCV Python environment probe;
+- HyperFrames browser preparation;
+- local media executable compatibility probes.
-### Run by hand
+Remote-only Endpoints such as KIE have no local service.
-`narratage build` and `narratage services up` run this for you, logging to
-`.svml/services/whisperx.log`. To run it in the foreground instead:
+## Build relationship
```bash
-uv run --project services/whisperx --frozen svml-whisperx-service
-curl http://127.0.0.1:8765/health
+pnpm narratage build build.svrun --runtime svml.runtime.json
+pnpm narratage build build.svrun --runtime svml.runtime.json --follow
```
-### Configuration
-
-| Variable | Default | Meaning |
-|---|---|---|
-| `SVML_WHISPERX_PORT` | `8765` | loopback port |
-| `SVML_WHISPERX_MODEL` | `small` | faster-whisper model |
-| `SVML_WHISPERX_DEVICE` | `cpu` | `cpu` or deployed accelerator |
-| `SVML_WHISPERX_COMPUTE` | `int8` on CPU | CTranslate2 compute type |
-| `SVML_WHISPERX_BATCH_SIZE` | `8` | bounded ASR batch size |
-| `SVML_WHISPERX_INPUT_ROOTS` | OS temp dir | path-separated roots the service may read |
-| `SVML_WHISPERX_NLTK_DATA` | user SVML cache | prepared NLTK data root |
-| `SVML_WHISPERX_MAX_REQUEST_BYTES` | `65536` | HTTP JSON bound |
-| `SVML_WHISPERX_MAX_AUDIO_BYTES` | `536870912` | staged canonical WAV bound |
-
-### Concurrency
-
-The service admits exactly one inference at a time. A second request receives `503 BUSY`.
-Concurrency is governed by the Narratage Runtime Scheduler's lane configuration, not the service
-itself.
+Before submission, `build` validates the profile and ensures its Runtime is up. The Build command
+then stores one verified Build plus dispatch ticket. Without `--follow` it exits immediately after
+submission. `--follow` observes durable state only; Ctrl-C detaches the observer and leaves the
+Worker running.
-The Node Provider (`@narratage/provider-whisperx-local`) must be configured with matching model,
-device, compute and batch size. A mismatch fails before results are accepted.
+`--no-services` skips automatic external-program startup for an operator who already owns those
+programs, but it does not create implicit Runtime services or move execution back into the CLI.
-### Tests
+## Visibility
```bash
-pnpm test:whisperx-service
+pnpm narratage queue --runtime svml.runtime.json
+pnpm narratage queue --runtime svml.runtime.json --watch
+pnpm narratage status <build-id> --runtime svml.runtime.json
+pnpm narratage operations <build-id> --runtime svml.runtime.json
+pnpm narratage operation <operation-id> --runtime svml.runtime.json
```
-## OpenCV image service
+These views expose durable dispatch phase, lease/capacity facts, Operation attempts, checkpoints and
+cancellation state. They do not reconstruct a secret second graph or ask a Provider for creative
+routing.
-Provides one bounded Raster interpreter for both image transforms (e.g. the GPT Image YCrCb denoise
-preset) and explicit ordered Canvas/Layer composition through `@narratage/provider-image-opencv-local`.
+Use `--json` for one versioned result and `--jsonl` for a watch stream.
-OpenCV runs as one bounded process per Need, so there is no program to keep warm — preparing the
-environment is the whole job, and `narratage services status` reports whether the interpreter
-carries a usable `cv2` and `numpy`.
+## WhisperX
-### Install by hand
+`@narratage/provider-whisperx-local` declares the warm service. Its health probe locks protocol,
+package, model, device, compute type and batch size. It accepts only canonical evidence WAVs beneath
+the configured input roots. WhisperX remains one-at-a-time internally; the Runtime lane prevents
+avoidable `BUSY` responses.
-`pnpm install` runs this:
+For service development it may be run directly:
```bash
-uv python install 3.13
-uv sync --project services/image-opencv --frozen
+uv sync --project services/whisperx --frozen
+uv run --project services/whisperx --frozen svml-whisperx-prepare
+uv run --project services/whisperx --frozen svml-whisperx-check
+uv run --project services/whisperx --frozen svml-whisperx-service
```
-With the official Runtime Adapter no `pythonExecutable` is required: `services up` prepares this
-frozen project and the Endpoint, probe and doctor all use its `.venv`. Supplying
-`pythonExecutable` transfers ownership to the operator and disables the unrelated managed prepare.
-
-## HyperFrames browser
-
-`@narratage/provider-hyperframes-local` declares a profile-scoped browser service. `services up`
-runs `hyperframes browser ensure`; its probe resolves the browser, starts `--version`, and verifies
-the configured ffprobe. No globally installed Chrome is required.
-
-## FFmpeg toolchain
+## OpenCV and HyperFrames
-The local media Provider accepts system or explicitly configured `ffmpeg` and `ffprobe`. Its shared
-compatibility probe checks the encoders and filters actually used by `@narratage/media-execution`,
-not one blessed version string. `services up` never mutates Homebrew, apt or another system package
-manager. A managed cross-platform binary remains deferred until its source, checksums, platform
-matrix and redistribution license are frozen.
+The OpenCV adapter owns preparation of its frozen Python environment unless an explicit executable
+transfers lifecycle ownership to the deployment. HyperFrames owns its profile-scoped browser
+preparation. Neither is a central Runtime default; only a selected locked adapter contributes the
+corresponding program.
-### Tests
-
-Tests are gated behind environment variables:
-
-```bash
-SVML_OPENCV_TESTS=1 \
-SVML_OPENCV_PYTHON=services/image-opencv/.venv/bin/python \
-pnpm test:image-opencv
-```
+The local media Endpoint accepts an explicitly configured or system `ffmpeg`/`ffprobe` only after
+its capability probe succeeds. Runtime lifecycle does not mutate Homebrew, apt or another system
+package manager.
diff --git a/docs/quickstart/run.md b/docs/quickstart/run.md
index d0ddceb8..85f9a028 100644
--- a/docs/quickstart/run.md
+++ b/docs/quickstart/run.md
@@ -156,13 +156,31 @@ The Runtime Profile (`svml.runtime.json`) tells the system **where** to run each
"format": "svml.runtime-config@1",
"packageLock": "./svml.packages.lock",
"runtimePackageLock": "./svml.runtime-packages.lock",
+ "runtimeServices": [
+ { "use": "@narratage/local", "instance": "execution" },
+ { "use": "@narratage/store-sqlite", "instance": "state", "config": { "path": ".svml/runtime.sqlite" } },
+ { "use": "@narratage/artifact-store-fs", "instance": "artifacts", "config": { "path": ".svml/artifacts" } },
+ { "use": "@narratage/credential-store-env", "instance": "credentials.env", "config": {} }
+ ],
+ "services": {
+ "scheduler": "execution.scheduler",
+ "worker": "execution.worker",
+ "stores": {
+ "build": "state.builds",
+ "operations": "state.operations",
+ "dispatch": "state.dispatch",
+ "journal": "state.journal",
+ "artifacts": "artifacts",
+ "credentials": ["credentials.env"]
+ }
+ },
"endpoints": [
{
"use": "@narratage/provider-kie",
"instance": "kie.main",
"lane": "generation",
"config": {
- "apiKeyEnv": "KIE_API_KEY",
+ "apiKey": { "store": "env", "key": "KIE_API_KEY" },
"defaultConcurrency": 2
}
},
@@ -184,7 +202,7 @@ The Runtime Profile (`svml.runtime.json`) tells the system **where** to run each
"lane": "planning",
"config": {
"projectEnv": "GOOGLE_CLOUD_PROJECT",
- "credentialsEnv": "GOOGLE_APPLICATION_CREDENTIALS_JSON",
+ "credentials": { "store": "env", "key": "GOOGLE_APPLICATION_CREDENTIALS_JSON" },
"location": "global",
"defaultConcurrency": 1
}
@@ -201,6 +219,9 @@ The Runtime Profile (`svml.runtime.json`) tells the system **where** to run each
}
],
"permissions": [
+ "environment:credentials",
+ "filesystem:artifacts",
+ "filesystem:state",
"filesystem:whisperx-staging",
"network:aiplatform.googleapis.com",
"network:api.kie.ai",
@@ -231,7 +252,7 @@ Each endpoint binds a Provider package to a named instance with a concurrency la
| `use` | Provider package name (e.g. `@narratage/provider-kie`) |
| `instance` | Unique instance identifier |
| `lane` | Scheduling lane for concurrency control |
-| `config` | Provider-specific configuration (API keys, concurrency, etc.) |
+| `config` | Provider-specific non-secret configuration and ordinary CredentialRefs |
### Permissions
@@ -255,8 +276,9 @@ This installs Node dependencies **and** prepares the Python services (WhisperX,
Builds need. When `uv` is not on your PATH the Python step is skipped with a warning — install
[uv](https://docs.astral.sh/uv/) first if you need local alignment or image processing.
-`narratage build` will start the required services automatically; you do not need to launch them
-yourself.
+`narratage runtime up` starts the durable Worker and the external programs declared by the selected
+adapters. `build` also ensures that execution domain is running before it submits, but never owns
+the Worker.
#### Keep production projects outside the Narratage checkout
@@ -290,8 +312,27 @@ Runtime Profile, so the Profile remains portable:
"format": "svml.runtime-config@1",
"packageLock": "./svml.packages.lock",
"runtimePackageLock": "./svml.runtime-packages.lock",
+ "runtimeServices": [
+ { "use": "@narratage/local", "instance": "execution" },
+ { "use": "@narratage/store-sqlite", "instance": "state", "config": { "path": ".svml/runtime.sqlite" } },
+ { "use": "@narratage/artifact-store-fs", "instance": "artifacts", "config": { "path": ".svml/artifacts" } },
+ { "use": "@narratage/credential-store-env", "instance": "credentials.env", "config": {} }
+ ],
+ "services": {
+ "scheduler": "execution.scheduler",
+ "worker": "execution.worker",
+ "stores": {
+ "build": "state.builds",
+ "operations": "state.operations",
+ "dispatch": "state.dispatch",
+ "journal": "state.journal",
+ "artifacts": "artifacts",
+ "credentials": ["credentials.env"]
+ }
+ },
"endpoints": [],
- "permissions": []
+ "permissions": ["environment:credentials", "filesystem:artifacts", "filesystem:state"],
+ "scheduling": { "maxConcurrency": 4 }
}
```
@@ -305,8 +346,8 @@ other than the CLI installation.
pnpm narratage doctor examples/talking-head-aroll/svml.runtime.json
```
-Doctor checks that every endpoint is reachable, credentials are valid, and required executables
-(`ffmpeg`, `ffprobe`, Chrome) are available.
+Doctor validates both locks, every selected Runtime role, Endpoint configuration, credential
+presence and bounded environment probes. It never starts the Worker or performs a paid request.
### 2. Inspect the plan
@@ -329,6 +370,9 @@ pnpm narratage build examples/talking-head-aroll/build.svrun \
--follow
```
+Without `--follow`, `build` returns after durable submission. The detached Worker continues. With
+`--follow`, the terminal is only an observer; interrupting it leaves the Build running.
+
| Flag | Description |
|---|---|
| `--runtime` | Path to the Runtime Profile |
diff --git a/docs/zh/guide/providers.md b/docs/zh/guide/providers.md
index d93ab2c5..abe963b5 100644
--- a/docs/zh/guide/providers.md
+++ b/docs/zh/guide/providers.md
@@ -51,7 +51,7 @@ import type { EndpointManifest } from "@narratage/endpoint-kit";
export function createMyServiceProvider(options: {
instance: string;
lane?: string;
- apiKey?: { env: string };
+ apiKey: CredentialRef;
defaultConcurrency?: number;
}) {
// 返回一个包含以下内容的对象:
@@ -76,34 +76,37 @@ export function createMyServiceProvider(options: {
// src/activation.ts
import {
createRuntimeEndpointAdapterFacet,
+ runtimeConfigCredentialRef,
+ runtimeConfigExact,
runtimeConfigObject,
- runtimeConfigString,
runtimeConfigPositiveInteger,
} from "@narratage/runtime-adapter";
-import { diagnoseRuntimeEnvironmentCredential } from "@narratage/runtime-adapter-node";
import { createMyServiceProvider } from "./provider.js";
const adapter = createRuntimeEndpointAdapterFacet({
use: "@narratage/provider-my-service",
+ validate(context) {
+ const config = runtimeConfigObject(context.config, "MyService");
+ runtimeConfigExact(config, ["apiKey", "defaultConcurrency"], "MyService");
+ if (runtimeConfigCredentialRef(config.apiKey, "MyService apiKey") === undefined) {
+ throw new Error("MyService apiKey CredentialRef is required");
+ }
+ runtimeConfigPositiveInteger(config.defaultConcurrency, "concurrency");
+ },
+
create(context) {
const config = runtimeConfigObject(context.config, "MyService");
- const apiKeyEnv = runtimeConfigString(config.apiKeyEnv, "MyService apiKeyEnv");
+ const apiKey = runtimeConfigCredentialRef(config.apiKey, "MyService apiKey");
+ if (apiKey === undefined) throw new Error("MyService apiKey CredentialRef is required");
return createMyServiceProvider({
instance: context.instance,
lane: context.lane,
- ...(apiKeyEnv === undefined ? {} : { apiKey: { env: apiKeyEnv } }),
+ apiKey,
...(runtimeConfigPositiveInteger(config.defaultConcurrency, "concurrency") === undefined
? {} : { defaultConcurrency: config.defaultConcurrency as number }),
});
},
-
- doctor(context) {
- const config = runtimeConfigObject(context.config, "MyService");
- const apiKeyEnv = runtimeConfigString(config.apiKeyEnv, "MyService apiKeyEnv")
- ?? "MY_SERVICE_API_KEY";
- return diagnoseRuntimeEnvironmentCredential(apiKeyEnv, "MyService");
- },
});
export const svmlPackage = {
@@ -115,7 +118,8 @@ export const svmlPackage = {
export default svmlPackage;
```
-`create` 函数根据 Runtime 配置构造 Endpoint。`doctor` 函数返回诊断信息(凭据是否存在、可执行文件是否可用),不构造也不调用任何东西。
+`validate` 是无副作用的纯校验;通过 Profile、lock 与权限校验后才会调用 `create`。凭据是否
+存在由通用 CredentialStore 与 Endpoint 描述路径诊断,Provider 不得硬编码环境变量 Store。
## 5. 声明外部服务(如需要)
@@ -148,9 +152,8 @@ const adapter = createRuntimeEndpointAdapterFacet({
});
```
-`pnpm install` 会自动执行 `prepare`,`narratage build` 会在第一个 Operation 之前调用 `start`
-和 `probe`。只调用远程 API 的 Provider(没有本地程序)跳过这一步——`package.json` 中不写
-`"service"`。
+`narratage runtime up` 会准备、启动并探测外部程序,然后启动耐久 Worker。`build` 会确保
+Runtime 已运行。只调用远程 API 的 Provider 不声明 service。
## 6. 注册并锁定
@@ -178,7 +181,7 @@ pnpm narratage lock-packages <runtime-lock> \
"instance": "my-service.project",
"lane": "generation",
"config": {
- "apiKeyEnv": "MY_SERVICE_API_KEY",
+ "apiKey": { "store": "keychain", "key": "my-service.api-key" },
"defaultConcurrency": 2
}
}
diff --git a/docs/zh/guide/runtime-profile.md b/docs/zh/guide/runtime-profile.md
index c2c600b8..fd8b1618 100644
--- a/docs/zh/guide/runtime-profile.md
+++ b/docs/zh/guide/runtime-profile.md
@@ -1,232 +1,134 @@
---
title: Runtime Profile
-description: 配置 Build 在哪里执行、诊断与 Build 归档。
+description: 显式配置 Build 的执行环境、状态存储、凭据与并发。
---
# Runtime Profile
-Runtime Profile 声明冻结后的 Build *在哪里*执行:Endpoint、凭据、并发、权限。它属于部署配置,而不是创作内容——它绝不进入 Author Graph 或 Run Graph 的身份。
+Runtime Profile 声明冻结后的 Build *在哪里*执行:Scheduler、Worker、全部 Store、Endpoint、
+凭据、并发和权限。它属于部署配置,绝不进入 Author Graph 或 Run Graph 身份。
-支持两种形式:
-
-| 形式 | 文件 | 适用场景 |
-|---|---|---|
-| 声明式 JSON | `svml.runtime.json` | 标准路径 |
-| 可执行 TypeScript | `svml.runtime.ts` | 高级嵌入 API |
-
-## 声明式 JSON
+## 声明式 Profile
```json
{
"format": "svml.runtime-config@1",
"packageLock": "./svml.packages.lock",
"runtimePackageLock": "./svml.runtime-packages.lock",
+ "runtimeServices": [
+ { "use": "@narratage/local", "instance": "execution" },
+ { "use": "@narratage/store-sqlite", "instance": "state", "config": { "path": ".svml/runtime.sqlite" } },
+ { "use": "@narratage/artifact-store-fs", "instance": "artifacts", "config": { "path": ".svml/artifacts" } },
+ { "use": "@narratage/credential-store-keychain", "instance": "credentials.keychain", "config": { "service": "narratage" } }
+ ],
+ "services": {
+ "scheduler": "execution.scheduler",
+ "worker": "execution.worker",
+ "stores": {
+ "build": "state.builds",
+ "operations": "state.operations",
+ "dispatch": "state.dispatch",
+ "journal": "state.journal",
+ "artifacts": "artifacts",
+ "credentials": ["credentials.keychain"]
+ }
+ },
"endpoints": [
{
"use": "@narratage/provider-kie",
"instance": "kie.production",
"lane": "generation",
"config": {
- "apiKeyEnv": "KIE_API_KEY",
+ "apiKey": { "store": "keychain", "key": "kie.api-key" },
"defaultConcurrency": 2
}
- },
- {
- "use": "@narratage/provider-media-local",
- "instance": "media.local",
- "lane": "media",
- "config": { "defaultConcurrency": 2 }
- },
- {
- "use": "@narratage/provider-whisperx-local",
- "instance": "whisperx.local",
- "lane": "alignment",
- "config": { "defaultConcurrency": 1 }
- },
- {
- "use": "@narratage/provider-google-vertex",
- "instance": "vertex.local",
- "lane": "planning",
- "config": {
- "projectEnv": "GOOGLE_CLOUD_PROJECT",
- "credentialsEnv": "GOOGLE_APPLICATION_CREDENTIALS_JSON",
- "defaultConcurrency": 1
- }
- },
- {
- "use": "@narratage/provider-hyperframes-local",
- "instance": "hyperframes.local",
- "lane": "render",
- "config": { "workers": 2, "quality": "standard", "defaultConcurrency": 1 }
}
],
"permissions": [
- "filesystem:whisperx-staging",
- "network:aiplatform.googleapis.com",
+ "filesystem:artifacts",
+ "filesystem:state",
+ "process:keychain",
"network:api.kie.ai",
- "network:whisperx-loopback",
- "process:hyperframes",
- "process:media"
+ "network:kieai.redpandaai.co"
],
"scheduling": {
"maxConcurrency": 4,
- "lanes": {
- "generation": 2,
- "media": 2,
- "alignment": 1,
- "planning": 1,
- "render": 1
- }
+ "lanes": { "generation": 2 }
}
}
```
-### Endpoint 字段
-
-| 字段 | 含义 |
-|---|---|
-| `use` | 适配器名称,从 `runtimePackageLock` 解析 |
-| `instance` | 该 Endpoint 实例的唯一标识 |
-| `lane` | 管辖并发的调度 lane |
-| `config` | 适配器专属配置(凭据环境变量、并发、超时) |
+`runtimeServices` 激活已安装的实现;`services` 按实例 id 逐项选择 Scheduler、Worker、
+BuildStore、OperationStore、DispatchStore、RuntimeJournal、ArtifactStore 和一个或多个
+CredentialStore。不存在“因为只装了一个所以自动选中”,`@narratage/local` 也不补 SQLite、
+文件系统或凭据默认值。
-凭据通过环境变量名引用,绝不存放在 Profile 里。
+凭据只写地址:`{ "store": "…", "key": "…" }`,秘密字节不进 Profile。多个 Store 可以
+并存,每个 Store 只响应属于自己命名空间的引用。
-### 文件系统字段
+## 文件边界
| 字段 | 含义 |
|---|---|
-| `root` | Runtime 数据根目录;状态数据库、Artifact 存储和相对 lock 路径都以此为基准。默认是 Profile 所在目录。 |
-| `packageRoot` | 为两份 lock 提供 `node_modules` 的可选 Host 覆盖项。官方 CLI 默认使用自身安装位置;直接调用本地 API 时默认等于 `root`。 |
-| `packageLock` | 确定性实现包的 lock;相对 `root` 解析。 |
-| `runtimePackageLock` | 有权限的 Runtime Adapter lock;相对 `root` 解析。 |
-
-`root` 与 `packageRoot` 有意分离。外部视频项目可以把全部数据留在自己的目录,同时从一个
-Narratage 安装目录加载经过校验的可执行包。两者都不进入 Author Graph 或 Run Graph 身份。
-
-### 调度
-
-`maxConcurrency` 限制所有 lane 上并发 Operation 的总量。每个具名 lane 还有自己的子上限。lane 由 Endpoint 声明,并由 Scheduler 强制执行。
-
-### 权限
-
-每个权限字符串向已锁定的 Endpoint 授予一项具体权能:
-
-- `network:<host>` — 到该主机的出站 HTTP
-- `filesystem:<scope>` — 在具名作用域内的文件访问
-- `process:<name>` — 本地进程执行
-
-## 可执行 TypeScript
-
-用于高级嵌入场景,以编程方式构造 Runtime:
-
-```typescript
-import { createProjectLocalRuntime } from "@narratage/local";
-import { createKieProvider } from "@narratage/provider-kie";
-import { createLocalMediaProvider } from "@narratage/provider-media-local";
-
-export default async function createRuntime() {
- const endpoints = [
- createKieProvider({
- instance: "kie.prod",
- lane: "generation",
- defaultConcurrency: 2,
- }),
- createLocalMediaProvider({
- instance: "media.prod",
- lane: "media",
- defaultConcurrency: 2,
- }),
- ];
-
- return await createProjectLocalRuntime({
- root: import.meta.dirname,
- packageLock: "./svml.packages.lock",
- endpoints,
- allowedPermissions: endpoints.flatMap(e =>
- e.manifest.facets.flatMap(f => f.permissions)),
- scheduling: {
- maxConcurrency: 4,
- lanes: { generation: 2, media: 2 },
- },
- });
-}
-```
+| `root` | Runtime 数据与相对 lock 的根目录;默认是 Profile 所在目录 |
+| `packageRoot` | 提供已安装 `node_modules` 的 Host 位置;与项目数据目录无关 |
+| `packageLock` | 确定性 Producer/Validator 包闭包 |
+| `runtimePackageLock` | 有权限的 Runtime Adapter 包闭包 |
-两种形式都可以传给 `--runtime`:
+外部项目可以把源文件、锁、SQLite 和 Artifact 全部留在自己的目录,同时从另一个
+Narratage 安装目录加载校验后的包。
-```bash
-pnpm narratage build build.svrun --runtime ./svml.runtime.json
-pnpm narratage build build.svrun --runtime ./svml.runtime.ts
-```
+## 并发与权限
-## 诊断
+`maxConcurrency` 和每个 lane 的上限由 DispatchStore 在所有共享 Worker 之间执行,不是某个
+CLI 进程里的计数器。容量租约跟随 Build 的 fenced lease;过期 Worker 不能继续准入结果。
-### doctor
+权限仍是显式 allowlist,例如 `network:<host>`、`filesystem:<scope>`、`process:<name>`。
-在不运行 Build、不发出付费请求的前提下检查 Runtime Profile:
+## 生命周期
```bash
pnpm narratage doctor svml.runtime.json
+pnpm narratage runtime up svml.runtime.json
+pnpm narratage runtime status svml.runtime.json
+pnpm narratage runtime logs svml.runtime.json
+pnpm narratage runtime down svml.runtime.json
```
-校验内容:
-- 包锁文件存在且可读
-- 适配器字节摘要匹配
-- 配置键对各适配器有效
-- 引用的凭据在环境中存在
-- 找得到所需的可执行文件(ffmpeg、ffprobe、chrome)
-- 声明的外部服务可达且与当前 Profile 匹配
-
-Runtime Adapter Host ABI `@1` 把必需的纯配置校验与 Adapter 工厂彻底分开。`doctor`
-不会构造 Endpoint 或 Store、启动服务、写入 Runtime 状态或提交任务。配置通过后,它可以执行
-有边界的只读环境探测;同一实例的首个配置或前置条件错误会截断由它连带产生的重复诊断。
-
-### gc(垃圾回收)
-
-```bash
-pnpm narratage gc svml.runtime.json # dry-run
-pnpm narratage gc svml.runtime.json --apply # delete unreachable Artifacts
-```
-
-遍历每个保留的 BuildState 与 Operation,计算可达的 Artifact 摘要,并报告(或删除)不可达的孤儿对象。
-
-## Build 归档与检视
+`runtime up` 管理耐久 Worker 与声明的外部程序。`services up/status/down` 只管理外部程序,
+不会启动 Worker。`build` 会确保 Runtime 已启动,但 Build 所在终端从不拥有执行权。
+后台进程绑定覆盖 Profile 与两份 package lock 的有效修订摘要;任一文件变化后状态变为
+`stale`,下一次启动或提交会按新执行闭包替换进程,而不是继续复用旧装配。
-每次 Build 都会持久归档全部已接受的 Record 与被引用的 Artifact,与任何 `--to` 目标路径无关。
-
-### 列出 Build
-
-```bash
-pnpm narratage builds --runtime svml.runtime.json
-```
-
-### 检视
+## Build、队列与归档
```bash
+pnpm narratage build build.svrun --runtime svml.runtime.json
+pnpm narratage build build.svrun --runtime svml.runtime.json --follow
+pnpm narratage queue --runtime svml.runtime.json --watch
+pnpm narratage status <build-id> --runtime svml.runtime.json
+pnpm narratage operations <build-id> --runtime svml.runtime.json
+pnpm narratage operation <operation-id> --runtime svml.runtime.json
pnpm narratage inspect <build-id> --runtime svml.runtime.json
+pnpm narratage get <build-id> --runtime svml.runtime.json --name final.video --to output.mp4
```
-显示 target 绑定、被请求的 Logical Output、每个已接受的 Record 以及 Operation 状态。
+不带 `--follow` 时,`build` 在耐久提交后退出;Worker 继续执行。`--follow` 只是观察,Ctrl-C
+不会取消任务。所有已接受 Record 与引用的 Artifact 都会归档,`get` 只是可选导出。
-### 取回 Record
+## 取消
```bash
-# By source output name
-pnpm narratage get <build-id> --runtime svml.runtime.json \
- --name final.video --to output.mp4
-
-# By Record id
-pnpm narratage get <build-id> --runtime svml.runtime.json \
- --record <record-id> --to output.json
+pnpm narratage cancel build <build-id> --runtime svml.runtime.json
+pnpm narratage cancel operation <operation-id> --runtime svml.runtime.json
+```
-# By Logical Output id
-pnpm narratage get <build-id> --runtime svml.runtime.json \
- --output <output-id>
+Build 取消先关闭准入;Operation 取消只抑制那个精确实现。`accepted` 只是远端接受停止请求,
+不等于已停止;系统继续协调到 `confirmed`、`unsupported`、`too-late` 或自然结束。迟到的付费
+产物继续归档,但不能进入被抑制的 Core 分支。Runtime 不会因此偷偷换 Candidate 或 Provider。
-# By Artifact digest
-pnpm narratage get <build-id> --runtime svml.runtime.json \
- --artifact <sha256:...> --to file.bin
-```
+## 高级 TypeScript 嵌入
-`--name` 使用 Host-only Build Catalog 中的来源输出别名。Catalog 只是展示层的便利设施,不进入 Core 的 Build 身份。
+`svml.runtime.ts` 仍可用于可信的私有部署代码,但必须构造与选择同样完整的一组 Runtime
+service package。它不是作者语言逃生口,也没有隐藏默认值。仓库中的
+`examples/talking-film-live/svml.runtime.ts` 是可执行参考。
diff --git a/docs/zh/guide/services.md b/docs/zh/guide/services.md
index f2165dfe..134b292f 100644
--- a/docs/zh/guide/services.md
+++ b/docs/zh/guide/services.md
@@ -1,117 +1,89 @@
---
-title: 本地服务
-description: 配置 WhisperX 与 OpenCV 服务。
+title: Runtime 与外部服务
+description: 管理耐久 Worker 与 Profile 明确选择的本地程序。
---
-# 本地服务
+# Runtime 与外部服务
-两个 Python 服务为本地 Build 提供支持。它们属于 Runtime 部署包,不属于 Core,也不属于作者语言。
+这里有两个故意分开的生命周期。
-## 自动配置
-
-通常你不需要手动执行本页的任何命令。`pnpm install` 会准备好所有已安装 Provider 声明的服务,
-`narratage build` 会自动启动它们:
+## 整个执行域
```bash
-pnpm install # 准备 Python 环境
-pnpm narratage build build.svrun --runtime svml.runtime.json --follow
+pnpm narratage runtime up svml.runtime.json
+pnpm narratage runtime status svml.runtime.json
+pnpm narratage runtime logs svml.runtime.json
+pnpm narratage runtime down svml.runtime.json
```
-Build 只启动其 Runtime Profile 声明的服务,并在 Build 之间保持运行以避免重新加载热模型。
-如果某个服务无法连通,Build 会在第一个 Operation 之前停止——不会浪费付费生成。
-
-需要时可以直接管理服务:
+`runtime up` 启动或复用当前 Profile 的后台 Worker,并准备、启动该 Profile 声明的外部程序。
+重复执行不会创建第二个同域 Worker。`runtime status` 同时展示 Worker、耐久队列、共享容量和
+外部程序健康状态。
-```bash
-pnpm narratage services status svml.runtime.json # 查看运行状态
-pnpm narratage services up svml.runtime.json # 只启动,不 Build
-pnpm narratage services down svml.runtime.json # 停止本项目启动的服务
-pnpm narratage build … --no-services # 跳过自动启动,使用已运行的服务
-```
-
-当 `uv` 不在 PATH 中时,`pnpm install` 会跳过准备并给出提示,不会导致安装失败。
-本页下面的内容是这些命令实际执行的操作,供某个步骤失败或在仓库外部署时参考。
-
-## WhisperX
+后台进程同时绑定 Profile 路径,以及覆盖 Profile 与两份 package lock 的有效修订摘要。
+任一文件变化后,旧进程会显示为 `stale`;下一次 `runtime up` 或 `build` 会先替换旧进程,
+不会让新 Dispatch 偷偷进入旧执行闭包。
-提供 ASR 以及针对特定语言的对齐能力,用于测量语音时序。
+`runtime down` 停止 Worker 和由该 Profile 管理的程序,但不会取消 Build 或远端 Provider
+任务。队列仍在 Store 中,下次启动后继续。
-### 手动安装
-
-`pnpm install` 会自动执行前三条命令。WhisperX 3.8.6 支持 Python 3.10–3.13,仓库中的锁文件选定 3.13:
+## 只管理外部程序
```bash
-uv python install 3.13
-uv sync --project services/whisperx --frozen
-uv run --project services/whisperx --frozen svml-whisperx-prepare
-uv run --project services/whisperx --frozen svml-whisperx-check
+pnpm narratage services up svml.runtime.json
+pnpm narratage services status svml.runtime.json
+pnpm narratage services down svml.runtime.json
```
-`svml-whisperx-prepare` 会在完成 SHA-256 校验后,从固定版本的归档中安装 NLTK 的 `punkt_tab`
-句子数据。WhisperX 的对齐流程需要这份数据,推理过程中不会下载。
-
-首次启动模型时可能会下载 ASR 与对齐权重。生产环境应将 Hugging Face 缓存放在持久化存储上。
-
-### 手动运行
+`services` 是调试/运维命令,只处理 Adapter 声明的程序,不启动 Worker、不读取或修改 Build
+队列。例如:
-`narratage build` 和 `narratage services up` 会自动运行此服务,日志写入
-`.svml/services/whisperx.log`。如需前台运行:
+- 常驻的本地 WhisperX HTTP 服务;
+- OpenCV Python 环境探测;
+- HyperFrames 浏览器准备;
+- ffmpeg/ffprobe 兼容性探测。
-```bash
-uv run --project services/whisperx --frozen svml-whisperx-service
-curl http://127.0.0.1:8765/health
-```
-
-### 配置
+KIE 这种纯远端 API Endpoint 没有本地 service。
-| 变量 | 默认值 | 含义 |
-|---|---|---|
-| `SVML_WHISPERX_PORT` | `8765` | 回环端口 |
-| `SVML_WHISPERX_MODEL` | `small` | faster-whisper 模型 |
-| `SVML_WHISPERX_DEVICE` | `cpu` | `cpu` 或已部署的加速器 |
-| `SVML_WHISPERX_COMPUTE` | CPU 上为 `int8` | CTranslate2 计算类型 |
-| `SVML_WHISPERX_BATCH_SIZE` | `8` | 有上界的 ASR 批大小 |
-| `SVML_WHISPERX_INPUT_ROOTS` | 操作系统临时目录 | 以路径分隔符分隔的根目录,服务可读取其中内容 |
-| `SVML_WHISPERX_NLTK_DATA` | 用户 SVML 缓存 | 已准备好的 NLTK 数据根目录 |
-| `SVML_WHISPERX_MAX_REQUEST_BYTES` | `65536` | HTTP JSON 上限 |
-| `SVML_WHISPERX_MAX_AUDIO_BYTES` | `536870912` | 暂存的规范 WAV 上限 |
+## 与 Build 的关系
-### 并发
+`build` 会先验证并确保 Runtime 正在运行,然后耐久写入 Build 与 Dispatch ticket。无
+`--follow` 时立刻退出;`--follow` 只观察。中断观察终端不会中断 Worker。
-该服务同一时刻只接纳一次推理。第二个请求会收到 `503 BUSY`。并发由 Narratage Runtime Scheduler
-的 lane 配置管控,而不是由服务自身管控。
+`--no-services` 只表示外部程序由部署者另行维护,不会把执行塞回 CLI,也不会恢复任何
+隐式 Runtime 默认。
-Node Provider(`@narratage/provider-whisperx-local`)必须配置与之匹配的模型、设备、计算类型和批大小。一旦不匹配,会在结果被接受之前失败。
-
-### 测试
+## 可见性
```bash
-pnpm test:whisperx-service
+pnpm narratage queue --runtime svml.runtime.json --watch
+pnpm narratage status <build-id> --runtime svml.runtime.json
+pnpm narratage operations <build-id> --runtime svml.runtime.json
+pnpm narratage operation <operation-id> --runtime svml.runtime.json
```
-## OpenCV 图像服务
-
-通过 `@narratage/provider-image-opencv-local` 提供有上界的图像变换(例如 GPT Image 的 YCrCb
-降噪预设)。
+这些命令展示 dispatch phase、租约/容量、Operation checkpoint 和取消状态。`--json` 输出
+一次结构化结果,watch 命令可用 `--jsonl`。
-OpenCV 以每个 Need 一个有界进程运行,没有需要保持热加载的程序——准备好环境就是全部工作,
-`narratage services status` 会报告解释器是否携带可用的 `cv2` 和 `numpy`。
+## WhisperX
-### 手动安装
+`@narratage/provider-whisperx-local` 声明热服务及健康探测,锁定协议、包版本、模型、设备、
+计算类型和 batch size。服务只读取允许目录下的规范证据 WAV。Runtime lane 避免无意义的
+并发 `BUSY`。
-`pnpm install` 会自动执行以下命令:
+开发服务本身时仍可前台运行:
```bash
-uv python install 3.13
-uv sync --project services/image-opencv --frozen
+uv sync --project services/whisperx --frozen
+uv run --project services/whisperx --frozen svml-whisperx-prepare
+uv run --project services/whisperx --frozen svml-whisperx-check
+uv run --project services/whisperx --frozen svml-whisperx-service
```
-### 测试
+## OpenCV、HyperFrames 与媒体工具
-测试由环境变量门控:
+OpenCV Adapter 在没有显式外部 Python 时维护冻结环境;HyperFrames Adapter 维护自身浏览器。
+二者都不是中央默认,只有被 Profile 选中的锁定 Adapter 才能贡献程序。
-```bash
-SVML_OPENCV_TESTS=1 \
-SVML_OPENCV_PYTHON=services/image-opencv/.venv/bin/python \
-pnpm test:image-opencv
-```
+本地媒体 Endpoint 只接受通过能力探测的显式或系统 `ffmpeg`/`ffprobe`。Runtime 不会修改
+Homebrew、apt 或其他系统包管理器。
diff --git a/docs/zh/quickstart/run.md b/docs/zh/quickstart/run.md
index c0cb1df7..3079bf03 100644
--- a/docs/zh/quickstart/run.md
+++ b/docs/zh/quickstart/run.md
@@ -146,13 +146,31 @@ Runtime Profile(`svml.runtime.json`)告诉系统**在哪里**执行每种类
"format": "svml.runtime-config@1",
"packageLock": "./svml.packages.lock",
"runtimePackageLock": "./svml.runtime-packages.lock",
+ "runtimeServices": [
+ { "use": "@narratage/local", "instance": "execution" },
+ { "use": "@narratage/store-sqlite", "instance": "state", "config": { "path": ".svml/runtime.sqlite" } },
+ { "use": "@narratage/artifact-store-fs", "instance": "artifacts", "config": { "path": ".svml/artifacts" } },
+ { "use": "@narratage/credential-store-env", "instance": "credentials.env", "config": {} }
+ ],
+ "services": {
+ "scheduler": "execution.scheduler",
+ "worker": "execution.worker",
+ "stores": {
+ "build": "state.builds",
+ "operations": "state.operations",
+ "dispatch": "state.dispatch",
+ "journal": "state.journal",
+ "artifacts": "artifacts",
+ "credentials": ["credentials.env"]
+ }
+ },
"endpoints": [
{
"use": "@narratage/provider-kie",
"instance": "kie.main",
"lane": "generation",
"config": {
- "apiKeyEnv": "KIE_API_KEY",
+ "apiKey": { "store": "env", "key": "KIE_API_KEY" },
"defaultConcurrency": 2
}
},
@@ -174,7 +192,7 @@ Runtime Profile(`svml.runtime.json`)告诉系统**在哪里**执行每种类
"lane": "planning",
"config": {
"projectEnv": "GOOGLE_CLOUD_PROJECT",
- "credentialsEnv": "GOOGLE_APPLICATION_CREDENTIALS_JSON",
+ "credentials": { "store": "env", "key": "GOOGLE_APPLICATION_CREDENTIALS_JSON" },
"location": "global",
"defaultConcurrency": 1
}
@@ -191,6 +209,9 @@ Runtime Profile(`svml.runtime.json`)告诉系统**在哪里**执行每种类
}
],
"permissions": [
+ "environment:credentials",
+ "filesystem:artifacts",
+ "filesystem:state",
"filesystem:whisperx-staging",
"network:aiplatform.googleapis.com",
"network:api.kie.ai",
@@ -221,7 +242,7 @@ Runtime Profile(`svml.runtime.json`)告诉系统**在哪里**执行每种类
| `use` | Provider 包名(例如 `@narratage/provider-kie`) |
| `instance` | 唯一的实例标识符 |
| `lane` | 用于并发控制的调度通道 |
-| `config` | Provider 专属配置(API 密钥、并发数等) |
+| `config` | Provider 专属非秘密配置、CredentialRef 与并发数 |
### 权限
@@ -243,7 +264,8 @@ pnpm install
如果 `uv` 不在 PATH 中,Python 步骤会跳过并给出提示——需要本地对齐或图像处理时请先安装
[uv](https://docs.astral.sh/uv/)。
-`narratage build` 会自动启动所需的服务,无需手动启动。
+`narratage runtime up` 管理后台 Worker 和外部程序;`build` 会确保 Runtime 已运行,但不拥有
+Worker。
#### 把正式视频项目放在 Narratage 仓库之外
@@ -274,8 +296,27 @@ Source Workspace 默认是 `build.svrun` 所在目录;相对引用的 Author S
"format": "svml.runtime-config@1",
"packageLock": "./svml.packages.lock",
"runtimePackageLock": "./svml.runtime-packages.lock",
+ "runtimeServices": [
+ { "use": "@narratage/local", "instance": "execution" },
+ { "use": "@narratage/store-sqlite", "instance": "state", "config": { "path": ".svml/runtime.sqlite" } },
+ { "use": "@narratage/artifact-store-fs", "instance": "artifacts", "config": { "path": ".svml/artifacts" } },
+ { "use": "@narratage/credential-store-env", "instance": "credentials.env", "config": {} }
+ ],
+ "services": {
+ "scheduler": "execution.scheduler",
+ "worker": "execution.worker",
+ "stores": {
+ "build": "state.builds",
+ "operations": "state.operations",
+ "dispatch": "state.dispatch",
+ "journal": "state.journal",
+ "artifacts": "artifacts",
+ "credentials": ["credentials.env"]
+ }
+ },
"endpoints": [],
- "permissions": []
+ "permissions": ["environment:credentials", "filesystem:artifacts", "filesystem:state"],
+ "scheduling": { "maxConcurrency": 4 }
}
```
@@ -288,7 +329,8 @@ Runtime 状态、归档 Artifact 和 lock 仍全部留在 `/work/my-film`。只
pnpm narratage doctor examples/talking-head-aroll/svml.runtime.json
```
-Doctor 检查每个 endpoint 是否可达、凭证是否有效,以及所需的可执行文件(`ffmpeg`、`ffprobe`、Chrome)是否可用。
+Doctor 校验两份 lock、全部显式 Runtime 角色、Endpoint 配置、凭据是否存在和有界环境探测;
+它不启动 Worker,也不发付费请求。
### 2. 检查计划
@@ -310,6 +352,9 @@ pnpm narratage build examples/talking-head-aroll/build.svrun \
--follow
```
+不带 `--follow` 时,Build 在耐久提交后退出,后台 Worker 继续。带 `--follow` 时终端也只是
+观察者;Ctrl-C 不会取消任务。
+
| 标志 | 说明 |
|---|---|
| `--runtime` | Runtime Profile 的路径 |
diff --git a/examples/talking-film-graph-check/svml.packages.lock b/examples/talking-film-graph-check/svml.packages.lock
index 4da609b9..2ce3439a 100644
--- a/examples/talking-film-graph-check/svml.packages.lock
+++ b/examples/talking-film-graph-check/svml.packages.lock
@@ -612,7 +612,7 @@
{
"name": "@narratage/core",
"version": "0.0.0-dev",
- "digest": "sha256:651c4d546708cd8648e1730a906fc3f9f9fc274db421e6374afee83574cecc7d"
+ "digest": "sha256:1c1b9855eb71e7c9472e77edea95885f0b21b54cec9f8d707bd195802158e539"
},
{
"name": "@narratage/elaborator",
@@ -802,7 +802,7 @@
"version": "0.0.0-dev"
},
"facetsDigest": "sha256:6a2991ec75f9fd30e8d286213fc7993aae2c570b85a8faae5d3c2af661c9fdfc",
- "closureDigest": "sha256:d5a53b8b59a4e3975b4f8f72616902d36176f72928a55ab432fc164abafffb03"
+ "closureDigest": "sha256:45c0adc0dbc045f12283db7da9b97a6d230813f508f512f91dfee5aedabdb401"
},
{
"specifier": "@narratage/caption-fine",
@@ -811,7 +811,7 @@
"version": "0.0.0-dev"
},
"facetsDigest": "sha256:c5616408dd56ce9c903523319b2a697ff6b8af5bfe1dc66fe793a11e4629f3cf",
- "closureDigest": "sha256:3ba4088d7e8703f27748b52ba9e4964d799d474c22d9da17afb2c0d7625a8a80"
+ "closureDigest": "sha256:9331f6dcf950a7bd001cf28a4f866f36f9f6a0a97910c5f8355bba9724144c71"
},
{
"specifier": "@narratage/caption-gemini",
@@ -820,7 +820,7 @@
"version": "0.0.0-dev"
},
"facetsDigest": "sha256:22fed1f1748349c11b6f28448be38cbea68b1dd5a51a3dc2d548ae0a376b9c71",
- "closureDigest": "sha256:3007616ccdffcfa1f2a30ee12b60a1be0f46dfd0980af152c52e8110607b1ce6"
+ "closureDigest": "sha256:0206e5a701c6feb1b60a9b73cf8bb74dfed7bc1e321b3e38b495590cdcf4ac24"
},
{
"specifier": "@narratage/composition",
@@ -829,7 +829,7 @@
"version": "0.0.0-dev"
},
"facetsDigest": "sha256:0a988b665baf0846246e309d9faf39ffb3ef6ec455bf37f7c438eb30429ff46e",
- "closureDigest": "sha256:b904e092569db800eb5db96eaf77065bd481149fa5f492bcf38d27bf4aff387a"
+ "closureDigest": "sha256:37f34e3ddef9f2e86c8a9d062fd5a4523874841db3a5a51444b5c516a0c63817"
},
{
"specifier": "@narratage/film",
@@ -838,7 +838,7 @@
"version": "0.0.0-dev"
},
"facetsDigest": "sha256:8e58b5630b9a68a8ce7314620f5f1c7cda973a05c179c18d61e10d68002964f0",
- "closureDigest": "sha256:f78c843e6e47e0571f922caecb294c60dd5b423658a0b98fc7377db3cbdafbd0"
+ "closureDigest": "sha256:2d0ca309cdfb053c6fc47d3f3464c8cb3e50ee601e3c6951484e34529aeab8a6"
},
{
"specifier": "@narratage/fonts-open",
@@ -847,7 +847,7 @@
"version": "0.0.0-dev"
},
"facetsDigest": "sha256:31b51352edcb4f34beccc9d9ac8cf7397125a840971a72c912df3d34d1f3feda",
- "closureDigest": "sha256:d44aae7128f285ed94fcdf56478fa43f7b302cb5dd0fe3b57818482ebc90f8e9"
+ "closureDigest": "sha256:6c3f7a28db8159c5ba03528fd4c85f1b97718fe719d3a087312f1a1d8f18b160"
},
{
"specifier": "@narratage/generation",
@@ -856,7 +856,7 @@
"version": "0.0.0-dev"
},
"facetsDigest": "sha256:d74a57a3210267e665366513324db5c313b3ca0f770da66e74cc38aee5048efb",
- "closureDigest": "sha256:0a3093f555ce7e80832dd1fec8a5d575fcf2b3b86a0ecf4e840babd7d9080120"
+ "closureDigest": "sha256:d8c63f5908ba26809179c0e1ccf04b87b9c945270733947d11262bb2b0f7916c"
},
{
"specifier": "@narratage/hyperframes",
@@ -865,7 +865,7 @@
"version": "0.0.0-dev"
},
"facetsDigest": "sha256:b8b8773d03f19844cdc8d714650380145056649245e33c607f30220fff194157",
- "closureDigest": "sha256:b13912b26ac52dfd5738ab839a153c1be534414fde923d9ecefe969df790fc69"
+ "closureDigest": "sha256:9077ffd048007617708b988f285dcef6241b277cabc1ba472ccf30ac20b2356f"
},
{
"specifier": "@narratage/media",
@@ -874,7 +874,7 @@
"version": "0.0.0-dev"
},
"facetsDigest": "sha256:6c7cf563a92aa8e48db6da224697fd5f56c50b636b0327efc17fbbc264502b3f",
- "closureDigest": "sha256:736fbdf2f67babf6a0ec2a091d40b70569d55d15a72ebfaa9e95e2d553c6860a"
+ "closureDigest": "sha256:2d56835dce5d6c4018cb8b6499771bba422f2e95ab67aa62500ca59f53672e23"
},
{
"specifier": "@narratage/media-pipeline",
@@ -883,7 +883,7 @@
"version": "0.0.0-dev"
},
"facetsDigest": "sha256:21f817f8e6eea9e9e4361005ed5ab9e69117fd77ec237fd467fb11afe9965019",
- "closureDigest": "sha256:cc1dd03e28bcf668800f0356e6b9414bef88c9b54f20b98236855813838990ed"
+ "closureDigest": "sha256:b5462108e446bc5a22c3888a24bf0f99652115cc3d69f3cb868b6c7305b8e324"
},
{
"specifier": "@narratage/media-track",
@@ -892,7 +892,7 @@
"version": "0.0.0-dev"
},
"facetsDigest": "sha256:bb26c54c0ad8802ee8c7cd6f13314c90dd7de7e937ded1c501367e19693fe3b1",
- "closureDigest": "sha256:feab5487260d97a8ed806c0b18aa78c6898a230f3045e462900d69ee7e4c9e92"
+ "closureDigest": "sha256:1619d3e8c8ec147e6ac1355f409e0c81f0ee66db46d876fc78cea925593e95d0"
},
{
"specifier": "@narratage/narrative",
@@ -919,7 +919,7 @@
"version": "0.0.0-dev"
},
"facetsDigest": "sha256:aa47f04cf0652ee3fa2e114eb6d9a80b0522828a47869103ca33e95027b21634",
- "closureDigest": "sha256:dd57f6b3547fab69e23f0a66f91c03d91e3453d7075fdc2d5c5125f51cb71dbc"
+ "closureDigest": "sha256:b1c4fd45e70759f2597a980c1ca2097d44fc0a0c8e596b35317be04fa96fa7ba"
},
{
"specifier": "@narratage/run-markup",
@@ -928,7 +928,7 @@
"version": "0.0.0-dev"
},
"facetsDigest": "sha256:fb3a8a5be9a0ef0aa914026a199be641f4e20df27f9b284be196f52fd260be55",
- "closureDigest": "sha256:3f22b01f207599d4b848adffe915b4b34cc6dfb6f98d7230d2d8a54cbd588252"
+ "closureDigest": "sha256:e1a5faf90e0925ff8100b2e32c188d1741aac3bc376fbc94183c5c9eeafc195b"
},
{
"specifier": "@narratage/script",
@@ -937,7 +937,7 @@
"version": "0.0.0-dev"
},
"facetsDigest": "sha256:69e1c08a5f07c73a506ca8286426a0386485738649e86463cca0b291f319ee4e",
- "closureDigest": "sha256:5031128c71900c50b7ca9527bbbfabc85b0f310a9fc84034959df8b4b35c65d2"
+ "closureDigest": "sha256:070562efce768b46aca3960561b2bc3a592997192f7a8e9214bf8ec289df83b9"
},
{
"specifier": "@narratage/seedance",
@@ -946,7 +946,7 @@
"version": "0.0.0-dev"
},
"facetsDigest": "sha256:e889ca3808a19f544e7aa5e27453beb5a09464c645633b0b1b1d9a4b7ce6591a",
- "closureDigest": "sha256:193c1f9937adbd21bc0dbac47cbfb18a0f5cc15d7748de3d7717fb1683739004"
+ "closureDigest": "sha256:55d4043e4ca8f85cd5eea781eb07801f1869443541d260f2ab427c78e93f5b2b"
},
{
"specifier": "@narratage/semantic-map",
@@ -955,7 +955,7 @@
"version": "0.0.0-dev"
},
"facetsDigest": "sha256:a9d81ddfa09dfa23c9c3c0817b60299431ca9ec640252a659d490be55d92ba68",
- "closureDigest": "sha256:27033537e1afecfdfb6571a87e0383f1f2aae7068c36b7c7ceb7543926646d7b"
+ "closureDigest": "sha256:658b7ef5306d5ec68c172ce19543eb05fd8e1f616a10223acfb87223012e440e"
},
{
"specifier": "@narratage/spatial",
@@ -964,7 +964,7 @@
"version": "0.0.0-dev"
},
"facetsDigest": "sha256:5062281ffadb46495ec12e1a67185b57fe13879e90f03bcf544e93fd1d273716",
- "closureDigest": "sha256:3c2704b4e613dc23d94a1e842a7bd58f0248ee53dcc3395be0fadcde2013f311"
+ "closureDigest": "sha256:0bfb0066a25c344a6e74aa8e2439300179e55ffbf6a8d13e84e526d4123a59ce"
},
{
"specifier": "@narratage/speech",
@@ -973,7 +973,7 @@
"version": "0.0.0-dev"
},
"facetsDigest": "sha256:75b1537c9b9729c2e9197445c34b295bc9f72dbef754a4702e1ca792dceea472",
- "closureDigest": "sha256:f4e2a84a6f67760c29c76b3be0810d51b0240c357707b556bfca9c1516ad1801"
+ "closureDigest": "sha256:e9a563703c2f7c72777c617067444ef4cb036ff857fbbe65161314255fb102f1"
},
{
"specifier": "@narratage/speech-alignment",
@@ -982,7 +982,7 @@
"version": "0.0.0-dev"
},
"facetsDigest": "sha256:bdfe219081310041d11c6d54440e6ccb80398bfb97f93afc28e9d1ed101b4a79",
- "closureDigest": "sha256:c5efeb3c100e661863356a652665b0b0f496176422979fd0e6e274b62456cd0f"
+ "closureDigest": "sha256:400256232c983f05e8ceec145ea790e2ec15b5dad91d10ca340f15514b6067ff"
},
{
"specifier": "@narratage/speech-basis",
@@ -991,7 +991,7 @@
"version": "0.0.0-dev"
},
"facetsDigest": "sha256:f01f21badb0ccdd5cc62b131be05f46030bffee96042c7323a0c572786d012ef",
- "closureDigest": "sha256:725bd1a8411596f0ad284260e7f3c189eaa9d20bd46706ee824b0848eadc019e"
+ "closureDigest": "sha256:bd0ad1414559f1b6da7c8c5aa60c16c3f3b2634b9151d7281bc4ebb274abd82b"
},
{
"specifier": "@narratage/speech-evidence",
@@ -1000,7 +1000,7 @@
"version": "0.0.0-dev"
},
"facetsDigest": "sha256:60f366de074a7fba20c71dcbd825083fddc54ea7de602a903eb144eab5555425",
- "closureDigest": "sha256:62afdde64e3f0b0fc31a679b4c58a7c0d844067d9677fed1195fe92526b76bd1"
+ "closureDigest": "sha256:319c2bc5bcda4734e4c975304ae9d24796e011c4dabe245dfedb96e4b06228b0"
},
{
"specifier": "@narratage/speech-spine",
@@ -1009,7 +1009,7 @@
"version": "0.0.0-dev"
},
"facetsDigest": "sha256:a27dd4349d6bb1aaa7f382ad09f883e9894157579e48285b00e8fa24456190f7",
- "closureDigest": "sha256:af643b38d811656e465a06d24eaebe7d0de7c184f86a13db56b244a4463373b8"
+ "closureDigest": "sha256:8c2c4fe30acea7d039e53aac7cc512c765e81e92cb210b538afe0cc3c2c253a5"
},
{
"specifier": "@narratage/svs",
@@ -1018,7 +1018,7 @@
"version": "0.0.0-dev"
},
"facetsDigest": "sha256:9cc7c397d2cd97b5a3e814886b6553b6d236fd8825df0d056e328b7f0cf20163",
- "closureDigest": "sha256:4c93cdef1bbace70ff11792777622049b5262a593a2b4d7b890afc9543955ba2"
+ "closureDigest": "sha256:2be69621b66211f48f0f7181bda377dd9e6f9a90067e1d0640fa2d762a0f19d1"
},
{
"specifier": "@narratage/temporal",
@@ -1027,7 +1027,7 @@
"version": "0.0.0-dev"
},
"facetsDigest": "sha256:2e9c4804f142e08e87b2e11af79aa17770109fb573e865397bed14ed7a4f1d0e",
- "closureDigest": "sha256:33152a303d1bed40d1309d776e3e687df37a02ec3b34f18401e28054e71be9da"
+ "closureDigest": "sha256:5762aa27d8add5f1dcf8f18f368d83e53cd26ee50480071e67b1e31924458fc3"
},
{
"specifier": "@narratage/text",
@@ -1036,7 +1036,7 @@
"version": "0.0.0-dev"
},
"facetsDigest": "sha256:4435dd4bd38e5e017013f775e28e379e3e235211649ee8f3913378f7f9e60b58",
- "closureDigest": "sha256:9d50fa2a214341b4af403dbf3e89332ac4b35aefc234ff35e0b066b32ee20243"
+ "closureDigest": "sha256:82d2119cfc67634753bafcdb26003953f5d85519fbada9a5ce88b5a312e31a28"
},
{
"specifier": "@narratage/typography-track",
@@ -1045,7 +1045,7 @@
"version": "0.0.0-dev"
},
"facetsDigest": "sha256:cc8349fec027f43e01a8832ba8a7050490e924851cee3325d3568cb5bc5fd57f",
- "closureDigest": "sha256:cb8f564bad8252f0e369e9ecc0e0255b1086edd229b93be0ef3b0b54bb234526"
+ "closureDigest": "sha256:2ca5685baa5d2fabd12ca79f86f7c2b79c8fa74c8d32f7d664bc4d5af3627c35"
},
{
"specifier": "@narratage/visual-ir",
@@ -1063,8 +1063,8 @@
"version": "0.0.0-dev"
},
"facetsDigest": "sha256:c8cb487d25e567a081c74a7abc97ce2b94dc0c47c36c90ba6b44d2ec21a9e80b",
- "closureDigest": "sha256:100c9aef680d5cba8ebf6abe9e51bf1c6cdf7ae092144fbed3e35857ad8d88b9"
+ "closureDigest": "sha256:afc3d88b322d8c5aeebd520d5d691531d5314db0e87b19f0564941c3477f9e8a"
}
],
- "digest": "sha256:2dfa17718e21be3060ff4a39c7c612b2f28de6c595f0667a23188adf78a478a7"
+ "digest": "sha256:3df2354df92469461a8107654dc5319637f8f05be7ce89fca17a22c89694db87"
}
diff --git a/examples/talking-film-live/README.md b/examples/talking-film-live/README.md
index ec24fa8f..10ad16b3 100644
--- a/examples/talking-film-live/README.md
+++ b/examples/talking-film-live/README.md
@@ -31,10 +31,13 @@ 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.
+The independent `svml.runtime-packages.lock` selects Local execution, SQLite state, filesystem
+Artifacts, environment credentials, KIE, local media, local WhisperX, Vertex and local HyperFrames
+adapters; adding another implementation does not change the CLI.
```bash
+pnpm narratage runtime up examples/talking-film-live/svml.runtime.json
+
pnpm narratage build examples/talking-film-live/build.svrun \
--runtime examples/talking-film-live/svml.runtime.json \
--package-lock examples/talking-film-live/svml.packages.lock \
@@ -51,6 +54,9 @@ pnpm narratage get talking-film-live \
--to examples/talking-film-live/output/final.mp4
```
+`build` is a durable submission. `--follow` only observes the detached Worker; closing this terminal
+does not cancel the Build.
+
`build.svrun` owns the selected Target and fidelity. `svml.runtime.json` owns Provider instances,
permissions and concurrency. The Build archives all accepted intermediate Records and referenced
Artifacts even when no destination path is requested. `get` only makes an optional copy of the
diff --git a/examples/talking-film-live/svml.packages.lock b/examples/talking-film-live/svml.packages.lock
index 03be73dd..dab0c538 100644
--- a/examples/talking-film-live/svml.packages.lock
+++ b/examples/talking-film-live/svml.packages.lock
@@ -613,7 +613,7 @@
{
"name": "@narratage/core",
"version": "0.0.0-dev",
- "digest": "sha256:651c4d546708cd8648e1730a906fc3f9f9fc274db421e6374afee83574cecc7d"
+ "digest": "sha256:1c1b9855eb71e7c9472e77edea95885f0b21b54cec9f8d707bd195802158e539"
},
{
"name": "@narratage/elaborator",
@@ -813,7 +813,7 @@
"version": "0.0.0-dev"
},
"facetsDigest": "sha256:6a2991ec75f9fd30e8d286213fc7993aae2c570b85a8faae5d3c2af661c9fdfc",
- "closureDigest": "sha256:d5a53b8b59a4e3975b4f8f72616902d36176f72928a55ab432fc164abafffb03"
+ "closureDigest": "sha256:45c0adc0dbc045f12283db7da9b97a6d230813f508f512f91dfee5aedabdb401"
},
{
"specifier": "@narratage/caption-fine",
@@ -822,7 +822,7 @@
"version": "0.0.0-dev"
},
"facetsDigest": "sha256:c5616408dd56ce9c903523319b2a697ff6b8af5bfe1dc66fe793a11e4629f3cf",
- "closureDigest": "sha256:3ba4088d7e8703f27748b52ba9e4964d799d474c22d9da17afb2c0d7625a8a80"
+ "closureDigest": "sha256:9331f6dcf950a7bd001cf28a4f866f36f9f6a0a97910c5f8355bba9724144c71"
},
{
"specifier": "@narratage/caption-gemini",
@@ -831,7 +831,7 @@
"version": "0.0.0-dev"
},
"facetsDigest": "sha256:22fed1f1748349c11b6f28448be38cbea68b1dd5a51a3dc2d548ae0a376b9c71",
- "closureDigest": "sha256:3007616ccdffcfa1f2a30ee12b60a1be0f46dfd0980af152c52e8110607b1ce6"
+ "closureDigest": "sha256:0206e5a701c6feb1b60a9b73cf8bb74dfed7bc1e321b3e38b495590cdcf4ac24"
},
{
"specifier": "@narratage/composition",
@@ -840,7 +840,7 @@
"version": "0.0.0-dev"
},
"facetsDigest": "sha256:0a988b665baf0846246e309d9faf39ffb3ef6ec455bf37f7c438eb30429ff46e",
- "closureDigest": "sha256:b904e092569db800eb5db96eaf77065bd481149fa5f492bcf38d27bf4aff387a"
+ "closureDigest": "sha256:37f34e3ddef9f2e86c8a9d062fd5a4523874841db3a5a51444b5c516a0c63817"
},
{
"specifier": "@narratage/estimate",
@@ -849,7 +849,7 @@
"version": "0.0.0-dev"
},
"facetsDigest": "sha256:9975815b3109520eb6bba276554a90767a9aebff6498c2768d9faf4763219bef",
- "closureDigest": "sha256:811be87579f5934cdcf1289253cc31e835b3fc9f97a4911ad88fc01a387f7d65"
+ "closureDigest": "sha256:811c0d891e6754d5553f6e3f7f04f5a77a6bc0134fdb8803319b9502a7073bad"
},
{
"specifier": "@narratage/film",
@@ -858,7 +858,7 @@
"version": "0.0.0-dev"
},
"facetsDigest": "sha256:8e58b5630b9a68a8ce7314620f5f1c7cda973a05c179c18d61e10d68002964f0",
- "closureDigest": "sha256:f78c843e6e47e0571f922caecb294c60dd5b423658a0b98fc7377db3cbdafbd0"
+ "closureDigest": "sha256:2d0ca309cdfb053c6fc47d3f3464c8cb3e50ee601e3c6951484e34529aeab8a6"
},
{
"specifier": "@narratage/fonts-open",
@@ -867,7 +867,7 @@
"version": "0.0.0-dev"
},
"facetsDigest": "sha256:31b51352edcb4f34beccc9d9ac8cf7397125a840971a72c912df3d34d1f3feda",
- "closureDigest": "sha256:d44aae7128f285ed94fcdf56478fa43f7b302cb5dd0fe3b57818482ebc90f8e9"
+ "closureDigest": "sha256:6c3f7a28db8159c5ba03528fd4c85f1b97718fe719d3a087312f1a1d8f18b160"
},
{
"specifier": "@narratage/generation",
@@ -876,7 +876,7 @@
"version": "0.0.0-dev"
},
"facetsDigest": "sha256:d74a57a3210267e665366513324db5c313b3ca0f770da66e74cc38aee5048efb",
- "closureDigest": "sha256:0a3093f555ce7e80832dd1fec8a5d575fcf2b3b86a0ecf4e840babd7d9080120"
+ "closureDigest": "sha256:d8c63f5908ba26809179c0e1ccf04b87b9c945270733947d11262bb2b0f7916c"
},
{
"specifier": "@narratage/hyperframes",
@@ -885,7 +885,7 @@
"version": "0.0.0-dev"
},
"facetsDigest": "sha256:b8b8773d03f19844cdc8d714650380145056649245e33c607f30220fff194157",
- "closureDigest": "sha256:b13912b26ac52dfd5738ab839a153c1be534414fde923d9ecefe969df790fc69"
+ "closureDigest": "sha256:9077ffd048007617708b988f285dcef6241b277cabc1ba472ccf30ac20b2356f"
},
{
"specifier": "@narratage/media",
@@ -894,7 +894,7 @@
"version": "0.0.0-dev"
},
"facetsDigest": "sha256:6c7cf563a92aa8e48db6da224697fd5f56c50b636b0327efc17fbbc264502b3f",
- "closureDigest": "sha256:736fbdf2f67babf6a0ec2a091d40b70569d55d15a72ebfaa9e95e2d553c6860a"
+ "closureDigest": "sha256:2d56835dce5d6c4018cb8b6499771bba422f2e95ab67aa62500ca59f53672e23"
},
{
"specifier": "@narratage/media-pipeline",
@@ -903,7 +903,7 @@
"version": "0.0.0-dev"
},
"facetsDigest": "sha256:21f817f8e6eea9e9e4361005ed5ab9e69117fd77ec237fd467fb11afe9965019",
- "closureDigest": "sha256:cc1dd03e28bcf668800f0356e6b9414bef88c9b54f20b98236855813838990ed"
+ "closureDigest": "sha256:b5462108e446bc5a22c3888a24bf0f99652115cc3d69f3cb868b6c7305b8e324"
},
{
"specifier": "@narratage/media-track",
@@ -912,7 +912,7 @@
"version": "0.0.0-dev"
},
"facetsDigest": "sha256:bb26c54c0ad8802ee8c7cd6f13314c90dd7de7e937ded1c501367e19693fe3b1",
- "closureDigest": "sha256:feab5487260d97a8ed806c0b18aa78c6898a230f3045e462900d69ee7e4c9e92"
+ "closureDigest": "sha256:1619d3e8c8ec147e6ac1355f409e0c81f0ee66db46d876fc78cea925593e95d0"
},
{
"specifier": "@narratage/narrative",
@@ -939,7 +939,7 @@
"version": "0.0.0-dev"
},
"facetsDigest": "sha256:aa47f04cf0652ee3fa2e114eb6d9a80b0522828a47869103ca33e95027b21634",
- "closureDigest": "sha256:dd57f6b3547fab69e23f0a66f91c03d91e3453d7075fdc2d5c5125f51cb71dbc"
+ "closureDigest": "sha256:b1c4fd45e70759f2597a980c1ca2097d44fc0a0c8e596b35317be04fa96fa7ba"
},
{
"specifier": "@narratage/run-markup",
@@ -948,7 +948,7 @@
"version": "0.0.0-dev"
},
"facetsDigest": "sha256:fb3a8a5be9a0ef0aa914026a199be641f4e20df27f9b284be196f52fd260be55",
- "closureDigest": "sha256:3f22b01f207599d4b848adffe915b4b34cc6dfb6f98d7230d2d8a54cbd588252"
+ "closureDigest": "sha256:e1a5faf90e0925ff8100b2e32c188d1741aac3bc376fbc94183c5c9eeafc195b"
},
{
"specifier": "@narratage/script",
@@ -957,7 +957,7 @@
"version": "0.0.0-dev"
},
"facetsDigest": "sha256:69e1c08a5f07c73a506ca8286426a0386485738649e86463cca0b291f319ee4e",
- "closureDigest": "sha256:5031128c71900c50b7ca9527bbbfabc85b0f310a9fc84034959df8b4b35c65d2"
+ "closureDigest": "sha256:070562efce768b46aca3960561b2bc3a592997192f7a8e9214bf8ec289df83b9"
},
{
"specifier": "@narratage/seedance",
@@ -966,7 +966,7 @@
"version": "0.0.0-dev"
},
"facetsDigest": "sha256:e889ca3808a19f544e7aa5e27453beb5a09464c645633b0b1b1d9a4b7ce6591a",
- "closureDigest": "sha256:193c1f9937adbd21bc0dbac47cbfb18a0f5cc15d7748de3d7717fb1683739004"
+ "closureDigest": "sha256:55d4043e4ca8f85cd5eea781eb07801f1869443541d260f2ab427c78e93f5b2b"
},
{
"specifier": "@narratage/semantic-map",
@@ -975,7 +975,7 @@
"version": "0.0.0-dev"
},
"facetsDigest": "sha256:a9d81ddfa09dfa23c9c3c0817b60299431ca9ec640252a659d490be55d92ba68",
- "closureDigest": "sha256:27033537e1afecfdfb6571a87e0383f1f2aae7068c36b7c7ceb7543926646d7b"
+ "closureDigest": "sha256:658b7ef5306d5ec68c172ce19543eb05fd8e1f616a10223acfb87223012e440e"
},
{
"specifier": "@narratage/spatial",
@@ -984,7 +984,7 @@
"version": "0.0.0-dev"
},
"facetsDigest": "sha256:5062281ffadb46495ec12e1a67185b57fe13879e90f03bcf544e93fd1d273716",
- "closureDigest": "sha256:3c2704b4e613dc23d94a1e842a7bd58f0248ee53dcc3395be0fadcde2013f311"
+ "closureDigest": "sha256:0bfb0066a25c344a6e74aa8e2439300179e55ffbf6a8d13e84e526d4123a59ce"
},
{
"specifier": "@narratage/speech",
@@ -993,7 +993,7 @@
"version": "0.0.0-dev"
},
"facetsDigest": "sha256:75b1537c9b9729c2e9197445c34b295bc9f72dbef754a4702e1ca792dceea472",
- "closureDigest": "sha256:f4e2a84a6f67760c29c76b3be0810d51b0240c357707b556bfca9c1516ad1801"
+ "closureDigest": "sha256:e9a563703c2f7c72777c617067444ef4cb036ff857fbbe65161314255fb102f1"
},
{
"specifier": "@narratage/speech-alignment",
@@ -1002,7 +1002,7 @@
"version": "0.0.0-dev"
},
"facetsDigest": "sha256:bdfe219081310041d11c6d54440e6ccb80398bfb97f93afc28e9d1ed101b4a79",
- "closureDigest": "sha256:c5efeb3c100e661863356a652665b0b0f496176422979fd0e6e274b62456cd0f"
+ "closureDigest": "sha256:400256232c983f05e8ceec145ea790e2ec15b5dad91d10ca340f15514b6067ff"
},
{
"specifier": "@narratage/speech-basis",
@@ -1011,7 +1011,7 @@
"version": "0.0.0-dev"
},
"facetsDigest": "sha256:f01f21badb0ccdd5cc62b131be05f46030bffee96042c7323a0c572786d012ef",
- "closureDigest": "sha256:725bd1a8411596f0ad284260e7f3c189eaa9d20bd46706ee824b0848eadc019e"
+ "closureDigest": "sha256:bd0ad1414559f1b6da7c8c5aa60c16c3f3b2634b9151d7281bc4ebb274abd82b"
},
{
"specifier": "@narratage/speech-evidence",
@@ -1020,7 +1020,7 @@
"version": "0.0.0-dev"
},
"facetsDigest": "sha256:60f366de074a7fba20c71dcbd825083fddc54ea7de602a903eb144eab5555425",
- "closureDigest": "sha256:62afdde64e3f0b0fc31a679b4c58a7c0d844067d9677fed1195fe92526b76bd1"
+ "closureDigest": "sha256:319c2bc5bcda4734e4c975304ae9d24796e011c4dabe245dfedb96e4b06228b0"
},
{
"specifier": "@narratage/speech-spine",
@@ -1029,7 +1029,7 @@
"version": "0.0.0-dev"
},
"facetsDigest": "sha256:a27dd4349d6bb1aaa7f382ad09f883e9894157579e48285b00e8fa24456190f7",
- "closureDigest": "sha256:af643b38d811656e465a06d24eaebe7d0de7c184f86a13db56b244a4463373b8"
+ "closureDigest": "sha256:8c2c4fe30acea7d039e53aac7cc512c765e81e92cb210b538afe0cc3c2c253a5"
},
{
"specifier": "@narratage/svs",
@@ -1038,7 +1038,7 @@
"version": "0.0.0-dev"
},
"facetsDigest": "sha256:9cc7c397d2cd97b5a3e814886b6553b6d236fd8825df0d056e328b7f0cf20163",
- "closureDigest": "sha256:4c93cdef1bbace70ff11792777622049b5262a593a2b4d7b890afc9543955ba2"
+ "closureDigest": "sha256:2be69621b66211f48f0f7181bda377dd9e6f9a90067e1d0640fa2d762a0f19d1"
},
{
"specifier": "@narratage/temporal",
@@ -1047,7 +1047,7 @@
"version": "0.0.0-dev"
},
"facetsDigest": "sha256:2e9c4804f142e08e87b2e11af79aa17770109fb573e865397bed14ed7a4f1d0e",
- "closureDigest": "sha256:33152a303d1bed40d1309d776e3e687df37a02ec3b34f18401e28054e71be9da"
+ "closureDigest": "sha256:5762aa27d8add5f1dcf8f18f368d83e53cd26ee50480071e67b1e31924458fc3"
},
{
"specifier": "@narratage/text",
@@ -1056,7 +1056,7 @@
"version": "0.0.0-dev"
},
"facetsDigest": "sha256:4435dd4bd38e5e017013f775e28e379e3e235211649ee8f3913378f7f9e60b58",
- "closureDigest": "sha256:9d50fa2a214341b4af403dbf3e89332ac4b35aefc234ff35e0b066b32ee20243"
+ "closureDigest": "sha256:82d2119cfc67634753bafcdb26003953f5d85519fbada9a5ce88b5a312e31a28"
},
{
"specifier": "@narratage/typography-track",
@@ -1065,7 +1065,7 @@
"version": "0.0.0-dev"
},
"facetsDigest": "sha256:cc8349fec027f43e01a8832ba8a7050490e924851cee3325d3568cb5bc5fd57f",
- "closureDigest": "sha256:cb8f564bad8252f0e369e9ecc0e0255b1086edd229b93be0ef3b0b54bb234526"
+ "closureDigest": "sha256:2ca5685baa5d2fabd12ca79f86f7c2b79c8fa74c8d32f7d664bc4d5af3627c35"
},
{
"specifier": "@narratage/visual-ir",
@@ -1083,8 +1083,8 @@
"version": "0.0.0-dev"
},
"facetsDigest": "sha256:c8cb487d25e567a081c74a7abc97ce2b94dc0c47c36c90ba6b44d2ec21a9e80b",
- "closureDigest": "sha256:100c9aef680d5cba8ebf6abe9e51bf1c6cdf7ae092144fbed3e35857ad8d88b9"
+ "closureDigest": "sha256:afc3d88b322d8c5aeebd520d5d691531d5314db0e87b19f0564941c3477f9e8a"
}
],
- "digest": "sha256:3174f8a8c8590dbdbdd0352c34b46133ee53d5217cc5212d0a8ad917736401a2"
+ "digest": "sha256:bcd2e047a42c40e065bbb8d444e8f88f8c28888c6315572dabd7a569c6e2371e"
}
diff --git a/examples/talking-film-live/svml.runtime-packages.lock b/examples/talking-film-live/svml.runtime-packages.lock
index 5f6f9306..7092057f 100644
--- a/examples/talking-film-live/svml.runtime-packages.lock
+++ b/examples/talking-film-live/svml.runtime-packages.lock
@@ -1,11 +1,15 @@
{
"format": "svml.node-package-lock@1",
"selected": [
+ "@narratage/artifact-store-fs",
+ "@narratage/credential-store-env",
+ "@narratage/local",
"@narratage/provider-google-vertex",
"@narratage/provider-hyperframes-local",
"@narratage/provider-kie",
"@narratage/provider-media-local",
- "@narratage/provider-whisperx-local"
+ "@narratage/provider-whisperx-local",
+ "@narratage/store-sqlite"
],
"artifacts": [
{
@@ -33,6 +37,11 @@
"version": "4.0.1",
"digest": "sha256:9004aaba5f83bb21b33ede79ad6420cef93105d4e7347622c2bf778407152b88"
},
+ {
+ "name": "@narratage/artifact-store-fs",
+ "version": "0.0.0-dev",
+ "digest": "sha256:a9d1cd5699df848cf89887897ece565cedd25af1eef1cac453e5b35caa52c3f2"
+ },
{
"name": "@narratage/artifact",
"version": "0.0.0-dev",
@@ -53,6 +62,11 @@
"version": "0.0.0-dev",
"digest": "sha256:d365d74d385b56d25bbe9fa08e0d70a58dafaef3cc51683a43821d9cf8da08de"
},
+ {
+ "name": "@narratage/compiler-node",
+ "version": "0.0.0-dev",
+ "digest": "sha256:019d7603c28d726e9fc8127e5786c2cd22575a8faa84d91dfd77139fda0927af"
+ },
{
"name": "@narratage/component-kit",
"version": "0.0.0-dev",
@@ -66,7 +80,17 @@
{
"name": "@narratage/core",
"version": "0.0.0-dev",
- "digest": "sha256:651c4d546708cd8648e1730a906fc3f9f9fc274db421e6374afee83574cecc7d"
+ "digest": "sha256:1c1b9855eb71e7c9472e77edea95885f0b21b54cec9f8d707bd195802158e539"
+ },
+ {
+ "name": "@narratage/credential-store-env",
+ "version": "0.0.0-dev",
+ "digest": "sha256:b60d7d7b54b5c63cc4fc5e503c69ed8c49d9a6b8251ddc2d4e5763e24c8889ac"
+ },
+ {
+ "name": "@narratage/driver-node",
+ "version": "0.0.0-dev",
+ "digest": "sha256:9f7df9d719422b91ac6d51995a6657d2b01cc32f80204a98240c9102ac278791"
},
{
"name": "@narratage/elaborator",
@@ -76,7 +100,7 @@
{
"name": "@narratage/endpoint-kit",
"version": "0.0.0-dev",
- "digest": "sha256:2f377c58c0dbec426d90adcb4794356507b3b4c55eb3d2533f54b44fcc20be03"
+ "digest": "sha256:94b455390d37d675a55c1888cc4b665d777f017e279510852cb5033436aee3ed"
},
{
"name": "@narratage/generation",
@@ -93,6 +117,11 @@
"version": "0.0.0-dev",
"digest": "sha256:dde9143aed4fa8731a1a91f860bb2a8a9f426c7515b5c12bed8b2fac24c0a416"
},
+ {
+ "name": "@narratage/local",
+ "version": "0.0.0-dev",
+ "digest": "sha256:f833c604b93c46f7596951d41e89ddb630dad1404bee6029c44ed541c437d151"
+ },
{
"name": "@narratage/markup",
"version": "0.0.0-dev",
@@ -118,6 +147,11 @@
"version": "0.0.0-dev",
"digest": "sha256:04a9e9aaf2005e9a12befea7a29d24ab0aa74fda87e4ff39eb149342c6f8a256"
},
+ {
+ "name": "@narratage/package-loader-node",
+ "version": "0.0.0-dev",
+ "digest": "sha256:1296c0ef3170e77cfdaa8cde0e1753fad2822b254507e0978429498d84c73ed0"
+ },
{
"name": "@narratage/program-space",
"version": "0.0.0-dev",
@@ -131,7 +165,7 @@
{
"name": "@narratage/provider-google-vertex",
"version": "0.0.0-dev",
- "digest": "sha256:64e7d806f93eafc73312af93515d65d0f8116ec42c6167de671ccd0a5907d363"
+ "digest": "sha256:b9de2ae61195991b65626a51053e71d79747b37274dd24dfbfdd0b855df455bd"
},
{
"name": "@narratage/provider-hyperframes-local",
@@ -141,12 +175,12 @@
{
"name": "@narratage/provider-kie",
"version": "0.0.0-dev",
- "digest": "sha256:e3d5b5752f13d8069a54c6157b1cbcec0a90ba0c22bbf54c6f6b8bf97fe8af5e"
+ "digest": "sha256:22612e3da4f12a5b780bcca5de5bf5585370772343aea749329715afe1988a88"
},
{
"name": "@narratage/provider-media-local",
"version": "0.0.0-dev",
- "digest": "sha256:afedec770515f6cf0e06d42321406a1ecdf9e06c249c0575791518f924381480"
+ "digest": "sha256:241bfaeacef8ec59694c127bc2dacf8cbac4fd48d10cbe04d1f2d0aa25f84d36"
},
{
"name": "@narratage/provider-whisperx-local",
@@ -158,6 +192,11 @@
"version": "0.0.0-dev",
"digest": "sha256:5f30fd4c9ce4de8984408d125498f58b06899011d6e07b43bea6ff3498490fe1"
},
+ {
+ "name": "@narratage/run",
+ "version": "0.0.0-dev",
+ "digest": "sha256:d734eb7ef18623d279d7176ce3fb1ed8b9c3a457aec7fcec2d439129815efaff"
+ },
{
"name": "@narratage/runtime-adapter-node",
"version": "0.0.0-dev",
@@ -166,12 +205,12 @@
{
"name": "@narratage/runtime-adapter",
"version": "0.0.0-dev",
- "digest": "sha256:277ce723c443f2e29bf60ca98dc33113cf11824ecba25868f159c9b597a1d6b9"
+ "digest": "sha256:357fc3c81876d25e553eaa555dd3308ff3db51715d230e6dd44573667058add2"
},
{
"name": "@narratage/runtime",
"version": "0.0.0-dev",
- "digest": "sha256:8e1e15aaed7ee09ac2aa51d9be0484706caae6481a4eaa1dc2e96bcc2d38be00"
+ "digest": "sha256:0f383c247e08abb30ab69ef6ce9d6bbf8b0f8fabc72b057ac97970c7f99ed4b2"
},
{
"name": "@narratage/semantic-map",
@@ -203,6 +242,11 @@
"version": "0.0.0-dev",
"digest": "sha256:ad66df5763802600b43d5df3538e5dc43bfe52cb7f1dabe63497e79834cfbe09"
},
+ {
+ "name": "@narratage/store-sqlite",
+ "version": "0.0.0-dev",
+ "digest": "sha256:cf7e739e38b5d7094488cd3da0aaae16f66cdb229ed48ec59999ccbe381aedcd"
+ },
{
"name": "@narratage/svs",
"version": "0.0.0-dev",
@@ -228,6 +272,11 @@
"version": "0.0.0-dev",
"digest": "sha256:7ee7f559fdc0508b6a7447838eb0a121cbe60c03522c6969638e0e8d3c04068f"
},
+ {
+ "name": "@narratage/workspace-fs-node",
+ "version": "0.0.0-dev",
+ "digest": "sha256:3ed827c6a586ccb5a9bc023ccea5c05a1fbe1a317a79df88314073c18cfa8ea3"
+ },
{
"name": "@protobufjs/aspromise",
"version": "1.1.2",
@@ -870,6 +919,33 @@
}
],
"packages": [
+ {
+ "specifier": "@narratage/artifact-store-fs",
+ "package": {
+ "name": "@narratage/artifact-store-fs",
+ "version": "0.0.0-dev"
+ },
+ "facetsDigest": "sha256:914018276b9218afc13940ca5c362dc95fa19d574fc07b06b6fe005c5eb30315",
+ "closureDigest": "sha256:486228772cda98bfe09c6262bc6f06f6cc5601928856c184087d1719d7497e49"
+ },
+ {
+ "specifier": "@narratage/credential-store-env",
+ "package": {
+ "name": "@narratage/credential-store-env",
+ "version": "0.0.0-dev"
+ },
+ "facetsDigest": "sha256:ee33ba638bbf2f88eee8f34a2f3179f435a0af9ccbae3fbb7d2a81bd6aeac612",
+ "closureDigest": "sha256:dee6b5e342b981185fce3dd86112d7a30bc11e0aa7132f4c4cbfa9ccfd086dda"
+ },
+ {
+ "specifier": "@narratage/local",
+ "package": {
+ "name": "@narratage/local",
+ "version": "0.0.0-dev"
+ },
+ "facetsDigest": "sha256:6689aed79b0947c7315aef65e46806ce73da01de3d73b454e1497b8d847ffa61",
+ "closureDigest": "sha256:4a22531c658b24975a7b1c083102bc90bd107d97c20286da818a9f964c6bbc86"
+ },
{
"specifier": "@narratage/provider-google-vertex",
"package": {
@@ -877,7 +953,7 @@
"version": "0.0.0-dev"
},
"facetsDigest": "sha256:b2636492ab0b0b500d674899ab2ff14fc61c7f2b22ef44eb8f816f141b21ec4d",
- "closureDigest": "sha256:4de4e5316cdb31753efd871fc1cc443661f7cf4788645082e00de84a762d7bda"
+ "closureDigest": "sha256:8b92e7871fa616ed3a6adce14a6bb7d705532dc0807e453492cd8a878558d9a7"
},
{
"specifier": "@narratage/provider-hyperframes-local",
@@ -886,7 +962,7 @@
"version": "0.0.0-dev"
},
"facetsDigest": "sha256:b14b721bdc0c9d5d9ced1c345107c92a3a5878f3383dea2ecd3e310442c2a40c",
- "closureDigest": "sha256:47a45ecf94238c7e06bbd87e28ec17b74ac2421293b03ad77936a41728948089"
+ "closureDigest": "sha256:1102b66d7613c516cbd67ded83961b8bd96ad0d45772fe185c28962084692daf"
},
{
"specifier": "@narratage/provider-kie",
@@ -895,7 +971,7 @@
"version": "0.0.0-dev"
},
"facetsDigest": "sha256:e61ebb911a33d4c5d0e4e4ee4fb69cdb790f4ced050ef35f7472bfbd72013d9b",
- "closureDigest": "sha256:c7526eb040617e45080b72a4f50f8f32ae6dc33fcc08ebaefecccd478b23d8c7"
+ "closureDigest": "sha256:b6d39b1697767893f05c27d7d3c2b5e683e9c559d020c8de0a412ec76226cea0"
},
{
"specifier": "@narratage/provider-media-local",
@@ -904,7 +980,7 @@
"version": "0.0.0-dev"
},
"facetsDigest": "sha256:701abcc923bf8a711c20b6e308d8cc8be27bf560f249b8c5a801e1dbd9cb3979",
- "closureDigest": "sha256:4382ac1151fd841cd673bfd49ba1c64df7e1a0ae6ed5610f6b4ecd26aa98f241"
+ "closureDigest": "sha256:8704836ca23624ca38023f5a3b0d7427e817a38412880e97dc5932fb7268d493"
},
{
"specifier": "@narratage/provider-whisperx-local",
@@ -913,8 +989,17 @@
"version": "0.0.0-dev"
},
"facetsDigest": "sha256:3686b84c42cc2b1bcaccf57cbdcda25a15c7d9d3778fb92d25437f9880ed8f5d",
- "closureDigest": "sha256:1f4387ca08d77d88c2a02faa0a40ba0d5c76f676f6128a94215ab39010112266"
+ "closureDigest": "sha256:7ff51a768a942fbe72ec4ef11b2d19c3066cc38c77f1a94261aa3cacd6a8e56d"
+ },
+ {
+ "specifier": "@narratage/store-sqlite",
+ "package": {
+ "name": "@narratage/store-sqlite",
+ "version": "0.0.0-dev"
+ },
+ "facetsDigest": "sha256:5bccf73cd953710fc31ef44672fef1bfc396fd4aa2eff4b53108e8ff87e749c3",
+ "closureDigest": "sha256:46d6044b5fee1777c27718094480b5b6e2606d35bfe8347a4f9c0a5034419bb8"
}
],
- "digest": "sha256:e635b2789745d90ddb8e32b30dd3261f738d44d62a508f33ceaca97629d0a898"
+ "digest": "sha256:a7d0d90fe7ab45a8a8bf113e08f7348ab53d91396f7e08955cb90b7db6444524"
}
diff --git a/examples/talking-film-live/svml.runtime.json b/examples/talking-film-live/svml.runtime.json
index 37d46da0..99a51ce0 100644
--- a/examples/talking-film-live/svml.runtime.json
+++ b/examples/talking-film-live/svml.runtime.json
@@ -2,13 +2,31 @@
"format": "svml.runtime-config@1",
"packageLock": "./svml.packages.lock",
"runtimePackageLock": "./svml.runtime-packages.lock",
+ "runtimeServices": [
+ { "use": "@narratage/local", "instance": "execution" },
+ { "use": "@narratage/store-sqlite", "instance": "state", "config": { "path": ".svml/runtime.sqlite" } },
+ { "use": "@narratage/artifact-store-fs", "instance": "artifacts", "config": { "path": ".svml/artifacts" } },
+ { "use": "@narratage/credential-store-env", "instance": "credentials.env", "config": {} }
+ ],
+ "services": {
+ "scheduler": "execution.scheduler",
+ "worker": "execution.worker",
+ "stores": {
+ "build": "state.builds",
+ "operations": "state.operations",
+ "dispatch": "state.dispatch",
+ "journal": "state.journal",
+ "artifacts": "artifacts",
+ "credentials": ["credentials.env"]
+ }
+ },
"endpoints": [
{
"use": "@narratage/provider-kie",
"instance": "kie.talking-film",
"lane": "generation",
"config": {
- "apiKeyEnv": "KIE_API_KEY",
+ "apiKey": { "store": "env", "key": "KIE_API_KEY" },
"defaultConcurrency": 2
}
},
@@ -34,7 +52,7 @@
"lane": "planning",
"config": {
"projectEnv": "GOOGLE_CLOUD_PROJECT",
- "credentialsEnv": "GOOGLE_APPLICATION_CREDENTIALS_JSON",
+ "credentials": { "store": "env", "key": "GOOGLE_APPLICATION_CREDENTIALS_JSON" },
"defaultConcurrency": 1
}
},
@@ -50,6 +68,9 @@
}
],
"permissions": [
+ "environment:credentials",
+ "filesystem:artifacts",
+ "filesystem:state",
"filesystem:whisperx-staging",
"network:aiplatform.googleapis.com",
"network:api.kie.ai",
diff --git a/examples/talking-film-live/svml.runtime.ts b/examples/talking-film-live/svml.runtime.ts
index 40419786..60ace792 100644
--- a/examples/talking-film-live/svml.runtime.ts
+++ b/examples/talking-film-live/svml.runtime.ts
@@ -1,13 +1,19 @@
import { fileURLToPath } from "node:url";
+import { join } from "node:path";
-import { createProjectLocalRuntime } from "@narratage/local";
+import { createFileArtifactStorePackage } from "@narratage/artifact-store-fs";
+import { createEnvironmentCredentialStorePackage } from "@narratage/credential-store-env";
+import { createLocalExecutionPackage, createProjectLocalRuntime } from "@narratage/local";
import { createGoogleVertexCaptionProvider } from "@narratage/provider-google-vertex";
import { createLocalHyperframesProvider } from "@narratage/provider-hyperframes-local";
import { createKieProvider } from "@narratage/provider-kie";
import { createLocalMediaProvider } from "@narratage/provider-media-local";
import { createLocalWhisperXProvider } from "@narratage/provider-whisperx-local";
+import { credentialRef } from "@narratage/runtime";
+import { createSqliteRuntimeServicePackage } from "@narratage/store-sqlite";
export default async function createTalkingFilmRuntime() {
+ const root = fileURLToPath(new URL(".", import.meta.url));
const project = process.env.GOOGLE_CLOUD_PROJECT?.trim();
if (!project) throw new Error("GOOGLE_CLOUD_PROJECT is required for the explicit Vertex Gemini Caption Provider");
@@ -15,6 +21,7 @@ export default async function createTalkingFilmRuntime() {
createKieProvider({
instance: "kie.talking-film",
lane: "generation",
+ apiKey: credentialRef("env", "KIE_API_KEY"),
defaultConcurrency: 2,
}),
createLocalMediaProvider({
@@ -31,6 +38,7 @@ export default async function createTalkingFilmRuntime() {
project,
instance: "vertex.talking-film",
lane: "planning",
+ credentialsJson: credentialRef("env", "GOOGLE_APPLICATION_CREDENTIALS_JSON"),
defaultConcurrency: 1,
}),
createLocalHyperframesProvider({
@@ -42,12 +50,44 @@ export default async function createTalkingFilmRuntime() {
}),
];
+ const execution = createLocalExecutionPackage("execution");
+ const state = createSqliteRuntimeServicePackage({
+ path: join(root, ".svml", "runtime.sqlite"),
+ name: "state",
+ buildInstance: "state.builds",
+ operationInstance: "state.operations",
+ dispatchInstance: "state.dispatch",
+ journalInstance: "state.journal",
+ });
+ const artifacts = createFileArtifactStorePackage({
+ root: join(root, ".svml", "artifacts"),
+ instance: "artifacts",
+ });
+ const credentials = createEnvironmentCredentialStorePackage({ instance: "credentials.env" });
+
return await createProjectLocalRuntime({
- root: fileURLToPath(new URL(".", import.meta.url)),
+ root,
packageLock: "./svml.packages.lock",
+ runtimeServices: [execution, state, artifacts, credentials],
+ runtimeSelection: {
+ scheduler: "execution.scheduler",
+ worker: "execution.worker",
+ stores: {
+ build: "state.builds",
+ operations: "state.operations",
+ dispatch: "state.dispatch",
+ journal: "state.journal",
+ artifacts: "artifacts",
+ credentials: ["credentials.env"],
+ },
+ },
endpoints,
- allowedPermissions: [...new Set(endpoints.flatMap((endpoint) =>
- endpoint.manifest.facets.flatMap((facet) => facet.permissions)))],
+ allowedPermissions: [...new Set([
+ "filesystem:state",
+ "filesystem:artifacts",
+ "environment:credentials",
+ ...endpoints.flatMap((endpoint) => endpoint.manifest.facets.flatMap((facet) => facet.permissions)),
+ ])],
scheduling: {
maxConcurrency: 4,
lanes: {
diff --git a/examples/talking-head-aroll/README.md b/examples/talking-head-aroll/README.md
index 9f9dbf9d..12fda6ab 100644
--- a/examples/talking-head-aroll/README.md
+++ b/examples/talking-head-aroll/README.md
@@ -59,6 +59,10 @@ pnpm narratage lock-packages examples/talking-head-aroll/svml.packages.lock \
--package-root .
pnpm narratage lock-packages examples/talking-head-aroll/svml.runtime-packages.lock \
+ --package @narratage/local \
+ --package @narratage/store-sqlite \
+ --package @narratage/artifact-store-fs \
+ --package @narratage/credential-store-env \
--package @narratage/provider-kie \
--package @narratage/provider-media-local \
--package @narratage/provider-whisperx-local \
@@ -87,6 +91,8 @@ Build the complete film after preparing the managed local WhisperX service and e
`GOOGLE_CLOUD_PROJECT` and `GOOGLE_APPLICATION_CREDENTIALS_JSON`:
```sh
+pnpm narratage runtime up examples/talking-head-aroll/svml.runtime.json
+
pnpm narratage build examples/talking-head-aroll/build.svrun \
--runtime examples/talking-head-aroll/svml.runtime.json \
--package-lock examples/talking-head-aroll/svml.packages.lock \
@@ -100,6 +106,9 @@ pnpm narratage get talking-head-film-001 \
--to examples/talking-head-aroll/output/final.mp4
```
+`build` returns after durable submission unless `--follow` is present. Even with `--follow`, the
+terminal remains an observer; interrupting it leaves the Worker and Build running.
+
Run the same downstream film from the four archived generated shots without another Seedance
submission:
diff --git a/examples/talking-head-aroll/svml.packages.lock b/examples/talking-head-aroll/svml.packages.lock
index cc62dfb0..ed137ccd 100644
--- a/examples/talking-head-aroll/svml.packages.lock
+++ b/examples/talking-head-aroll/svml.packages.lock
@@ -610,7 +610,7 @@
{
"name": "@narratage/core",
"version": "0.0.0-dev",
- "digest": "sha256:651c4d546708cd8648e1730a906fc3f9f9fc274db421e6374afee83574cecc7d"
+ "digest": "sha256:1c1b9855eb71e7c9472e77edea95885f0b21b54cec9f8d707bd195802158e539"
},
{
"name": "@narratage/elaborator",
@@ -805,7 +805,7 @@
"version": "0.0.0-dev"
},
"facetsDigest": "sha256:6a2991ec75f9fd30e8d286213fc7993aae2c570b85a8faae5d3c2af661c9fdfc",
- "closureDigest": "sha256:d5a53b8b59a4e3975b4f8f72616902d36176f72928a55ab432fc164abafffb03"
+ "closureDigest": "sha256:45c0adc0dbc045f12283db7da9b97a6d230813f508f512f91dfee5aedabdb401"
},
{
"specifier": "@narratage/caption-fine",
@@ -814,7 +814,7 @@
"version": "0.0.0-dev"
},
"facetsDigest": "sha256:c5616408dd56ce9c903523319b2a697ff6b8af5bfe1dc66fe793a11e4629f3cf",
- "closureDigest": "sha256:3ba4088d7e8703f27748b52ba9e4964d799d474c22d9da17afb2c0d7625a8a80"
+ "closureDigest": "sha256:9331f6dcf950a7bd001cf28a4f866f36f9f6a0a97910c5f8355bba9724144c71"
},
{
"specifier": "@narratage/caption-gemini",
@@ -823,7 +823,7 @@
"version": "0.0.0-dev"
},
"facetsDigest": "sha256:22fed1f1748349c11b6f28448be38cbea68b1dd5a51a3dc2d548ae0a376b9c71",
- "closureDigest": "sha256:3007616ccdffcfa1f2a30ee12b60a1be0f46dfd0980af152c52e8110607b1ce6"
+ "closureDigest": "sha256:0206e5a701c6feb1b60a9b73cf8bb74dfed7bc1e321b3e38b495590cdcf4ac24"
},
{
"specifier": "@narratage/composition",
@@ -832,7 +832,7 @@
"version": "0.0.0-dev"
},
"facetsDigest": "sha256:0a988b665baf0846246e309d9faf39ffb3ef6ec455bf37f7c438eb30429ff46e",
- "closureDigest": "sha256:b904e092569db800eb5db96eaf77065bd481149fa5f492bcf38d27bf4aff387a"
+ "closureDigest": "sha256:37f34e3ddef9f2e86c8a9d062fd5a4523874841db3a5a51444b5c516a0c63817"
},
{
"specifier": "@narratage/estimate",
@@ -841,7 +841,7 @@
"version": "0.0.0-dev"
},
"facetsDigest": "sha256:9975815b3109520eb6bba276554a90767a9aebff6498c2768d9faf4763219bef",
- "closureDigest": "sha256:811be87579f5934cdcf1289253cc31e835b3fc9f97a4911ad88fc01a387f7d65"
+ "closureDigest": "sha256:811c0d891e6754d5553f6e3f7f04f5a77a6bc0134fdb8803319b9502a7073bad"
},
{
"specifier": "@narratage/film",
@@ -850,7 +850,7 @@
"version": "0.0.0-dev"
},
"facetsDigest": "sha256:8e58b5630b9a68a8ce7314620f5f1c7cda973a05c179c18d61e10d68002964f0",
- "closureDigest": "sha256:f78c843e6e47e0571f922caecb294c60dd5b423658a0b98fc7377db3cbdafbd0"
+ "closureDigest": "sha256:2d0ca309cdfb053c6fc47d3f3464c8cb3e50ee601e3c6951484e34529aeab8a6"
},
{
"specifier": "@narratage/fonts-open",
@@ -859,7 +859,7 @@
"version": "0.0.0-dev"
},
"facetsDigest": "sha256:31b51352edcb4f34beccc9d9ac8cf7397125a840971a72c912df3d34d1f3feda",
- "closureDigest": "sha256:d44aae7128f285ed94fcdf56478fa43f7b302cb5dd0fe3b57818482ebc90f8e9"
+ "closureDigest": "sha256:6c3f7a28db8159c5ba03528fd4c85f1b97718fe719d3a087312f1a1d8f18b160"
},
{
"specifier": "@narratage/generation",
@@ -868,7 +868,7 @@
"version": "0.0.0-dev"
},
"facetsDigest": "sha256:d74a57a3210267e665366513324db5c313b3ca0f770da66e74cc38aee5048efb",
- "closureDigest": "sha256:0a3093f555ce7e80832dd1fec8a5d575fcf2b3b86a0ecf4e840babd7d9080120"
+ "closureDigest": "sha256:d8c63f5908ba26809179c0e1ccf04b87b9c945270733947d11262bb2b0f7916c"
},
{
"specifier": "@narratage/hyperframes",
@@ -877,7 +877,7 @@
"version": "0.0.0-dev"
},
"facetsDigest": "sha256:b8b8773d03f19844cdc8d714650380145056649245e33c607f30220fff194157",
- "closureDigest": "sha256:b13912b26ac52dfd5738ab839a153c1be534414fde923d9ecefe969df790fc69"
+ "closureDigest": "sha256:9077ffd048007617708b988f285dcef6241b277cabc1ba472ccf30ac20b2356f"
},
{
"specifier": "@narratage/media",
@@ -886,7 +886,7 @@
"version": "0.0.0-dev"
},
"facetsDigest": "sha256:6c7cf563a92aa8e48db6da224697fd5f56c50b636b0327efc17fbbc264502b3f",
- "closureDigest": "sha256:736fbdf2f67babf6a0ec2a091d40b70569d55d15a72ebfaa9e95e2d553c6860a"
+ "closureDigest": "sha256:2d56835dce5d6c4018cb8b6499771bba422f2e95ab67aa62500ca59f53672e23"
},
{
"specifier": "@narratage/media-pipeline",
@@ -895,7 +895,7 @@
"version": "0.0.0-dev"
},
"facetsDigest": "sha256:21f817f8e6eea9e9e4361005ed5ab9e69117fd77ec237fd467fb11afe9965019",
- "closureDigest": "sha256:cc1dd03e28bcf668800f0356e6b9414bef88c9b54f20b98236855813838990ed"
+ "closureDigest": "sha256:b5462108e446bc5a22c3888a24bf0f99652115cc3d69f3cb868b6c7305b8e324"
},
{
"specifier": "@narratage/narrative",
@@ -922,7 +922,7 @@
"version": "0.0.0-dev"
},
"facetsDigest": "sha256:aa47f04cf0652ee3fa2e114eb6d9a80b0522828a47869103ca33e95027b21634",
- "closureDigest": "sha256:dd57f6b3547fab69e23f0a66f91c03d91e3453d7075fdc2d5c5125f51cb71dbc"
+ "closureDigest": "sha256:b1c4fd45e70759f2597a980c1ca2097d44fc0a0c8e596b35317be04fa96fa7ba"
},
{
"specifier": "@narratage/run-markup",
@@ -931,7 +931,7 @@
"version": "0.0.0-dev"
},
"facetsDigest": "sha256:fb3a8a5be9a0ef0aa914026a199be641f4e20df27f9b284be196f52fd260be55",
- "closureDigest": "sha256:3f22b01f207599d4b848adffe915b4b34cc6dfb6f98d7230d2d8a54cbd588252"
+ "closureDigest": "sha256:e1a5faf90e0925ff8100b2e32c188d1741aac3bc376fbc94183c5c9eeafc195b"
},
{
"specifier": "@narratage/script",
@@ -940,7 +940,7 @@
"version": "0.0.0-dev"
},
"facetsDigest": "sha256:69e1c08a5f07c73a506ca8286426a0386485738649e86463cca0b291f319ee4e",
- "closureDigest": "sha256:5031128c71900c50b7ca9527bbbfabc85b0f310a9fc84034959df8b4b35c65d2"
+ "closureDigest": "sha256:070562efce768b46aca3960561b2bc3a592997192f7a8e9214bf8ec289df83b9"
},
{
"specifier": "@narratage/seedance",
@@ -949,7 +949,7 @@
"version": "0.0.0-dev"
},
"facetsDigest": "sha256:e889ca3808a19f544e7aa5e27453beb5a09464c645633b0b1b1d9a4b7ce6591a",
- "closureDigest": "sha256:193c1f9937adbd21bc0dbac47cbfb18a0f5cc15d7748de3d7717fb1683739004"
+ "closureDigest": "sha256:55d4043e4ca8f85cd5eea781eb07801f1869443541d260f2ab427c78e93f5b2b"
},
{
"specifier": "@narratage/semantic-map",
@@ -958,7 +958,7 @@
"version": "0.0.0-dev"
},
"facetsDigest": "sha256:a9d81ddfa09dfa23c9c3c0817b60299431ca9ec640252a659d490be55d92ba68",
- "closureDigest": "sha256:27033537e1afecfdfb6571a87e0383f1f2aae7068c36b7c7ceb7543926646d7b"
+ "closureDigest": "sha256:658b7ef5306d5ec68c172ce19543eb05fd8e1f616a10223acfb87223012e440e"
},
{
"specifier": "@narratage/spatial",
@@ -967,7 +967,7 @@
"version": "0.0.0-dev"
},
"facetsDigest": "sha256:5062281ffadb46495ec12e1a67185b57fe13879e90f03bcf544e93fd1d273716",
- "closureDigest": "sha256:3c2704b4e613dc23d94a1e842a7bd58f0248ee53dcc3395be0fadcde2013f311"
+ "closureDigest": "sha256:0bfb0066a25c344a6e74aa8e2439300179e55ffbf6a8d13e84e526d4123a59ce"
},
{
"specifier": "@narratage/speech",
@@ -976,7 +976,7 @@
"version": "0.0.0-dev"
},
"facetsDigest": "sha256:75b1537c9b9729c2e9197445c34b295bc9f72dbef754a4702e1ca792dceea472",
- "closureDigest": "sha256:f4e2a84a6f67760c29c76b3be0810d51b0240c357707b556bfca9c1516ad1801"
+ "closureDigest": "sha256:e9a563703c2f7c72777c617067444ef4cb036ff857fbbe65161314255fb102f1"
},
{
"specifier": "@narratage/speech-alignment",
@@ -985,7 +985,7 @@
"version": "0.0.0-dev"
},
"facetsDigest": "sha256:bdfe219081310041d11c6d54440e6ccb80398bfb97f93afc28e9d1ed101b4a79",
- "closureDigest": "sha256:c5efeb3c100e661863356a652665b0b0f496176422979fd0e6e274b62456cd0f"
+ "closureDigest": "sha256:400256232c983f05e8ceec145ea790e2ec15b5dad91d10ca340f15514b6067ff"
},
{
"specifier": "@narratage/speech-basis",
@@ -994,7 +994,7 @@
"version": "0.0.0-dev"
},
"facetsDigest": "sha256:f01f21badb0ccdd5cc62b131be05f46030bffee96042c7323a0c572786d012ef",
- "closureDigest": "sha256:725bd1a8411596f0ad284260e7f3c189eaa9d20bd46706ee824b0848eadc019e"
+ "closureDigest": "sha256:bd0ad1414559f1b6da7c8c5aa60c16c3f3b2634b9151d7281bc4ebb274abd82b"
},
{
"specifier": "@narratage/speech-evidence",
@@ -1003,7 +1003,7 @@
"version": "0.0.0-dev"
},
"facetsDigest": "sha256:60f366de074a7fba20c71dcbd825083fddc54ea7de602a903eb144eab5555425",
- "closureDigest": "sha256:62afdde64e3f0b0fc31a679b4c58a7c0d844067d9677fed1195fe92526b76bd1"
+ "closureDigest": "sha256:319c2bc5bcda4734e4c975304ae9d24796e011c4dabe245dfedb96e4b06228b0"
},
{
"specifier": "@narratage/speech-spine",
@@ -1012,7 +1012,7 @@
"version": "0.0.0-dev"
},
"facetsDigest": "sha256:a27dd4349d6bb1aaa7f382ad09f883e9894157579e48285b00e8fa24456190f7",
- "closureDigest": "sha256:af643b38d811656e465a06d24eaebe7d0de7c184f86a13db56b244a4463373b8"
+ "closureDigest": "sha256:8c2c4fe30acea7d039e53aac7cc512c765e81e92cb210b538afe0cc3c2c253a5"
},
{
"specifier": "@narratage/svs",
@@ -1021,7 +1021,7 @@
"version": "0.0.0-dev"
},
"facetsDigest": "sha256:9cc7c397d2cd97b5a3e814886b6553b6d236fd8825df0d056e328b7f0cf20163",
- "closureDigest": "sha256:4c93cdef1bbace70ff11792777622049b5262a593a2b4d7b890afc9543955ba2"
+ "closureDigest": "sha256:2be69621b66211f48f0f7181bda377dd9e6f9a90067e1d0640fa2d762a0f19d1"
},
{
"specifier": "@narratage/text",
@@ -1030,7 +1030,7 @@
"version": "0.0.0-dev"
},
"facetsDigest": "sha256:4435dd4bd38e5e017013f775e28e379e3e235211649ee8f3913378f7f9e60b58",
- "closureDigest": "sha256:9d50fa2a214341b4af403dbf3e89332ac4b35aefc234ff35e0b066b32ee20243"
+ "closureDigest": "sha256:82d2119cfc67634753bafcdb26003953f5d85519fbada9a5ce88b5a312e31a28"
},
{
"specifier": "@narratage/visual-ir",
@@ -1048,8 +1048,8 @@
"version": "0.0.0-dev"
},
"facetsDigest": "sha256:c8cb487d25e567a081c74a7abc97ce2b94dc0c47c36c90ba6b44d2ec21a9e80b",
- "closureDigest": "sha256:100c9aef680d5cba8ebf6abe9e51bf1c6cdf7ae092144fbed3e35857ad8d88b9"
+ "closureDigest": "sha256:afc3d88b322d8c5aeebd520d5d691531d5314db0e87b19f0564941c3477f9e8a"
}
],
- "digest": "sha256:ea6a07f8606486b61fc6422b8104a3047f9039ed7a99107d8734299f9ea60509"
+ "digest": "sha256:2832029345fa93fdc3e49662f8bda2a313fb5a61609e5477c7f964b9178ddad7"
}
diff --git a/examples/talking-head-aroll/svml.runtime-packages.lock b/examples/talking-head-aroll/svml.runtime-packages.lock
index 5f6f9306..7092057f 100644
--- a/examples/talking-head-aroll/svml.runtime-packages.lock
+++ b/examples/talking-head-aroll/svml.runtime-packages.lock
@@ -1,11 +1,15 @@
{
"format": "svml.node-package-lock@1",
"selected": [
+ "@narratage/artifact-store-fs",
+ "@narratage/credential-store-env",
+ "@narratage/local",
"@narratage/provider-google-vertex",
"@narratage/provider-hyperframes-local",
"@narratage/provider-kie",
"@narratage/provider-media-local",
- "@narratage/provider-whisperx-local"
+ "@narratage/provider-whisperx-local",
+ "@narratage/store-sqlite"
],
"artifacts": [
{
@@ -33,6 +37,11 @@
"version": "4.0.1",
"digest": "sha256:9004aaba5f83bb21b33ede79ad6420cef93105d4e7347622c2bf778407152b88"
},
+ {
+ "name": "@narratage/artifact-store-fs",
+ "version": "0.0.0-dev",
+ "digest": "sha256:a9d1cd5699df848cf89887897ece565cedd25af1eef1cac453e5b35caa52c3f2"
+ },
{
"name": "@narratage/artifact",
"version": "0.0.0-dev",
@@ -53,6 +62,11 @@
"version": "0.0.0-dev",
"digest": "sha256:d365d74d385b56d25bbe9fa08e0d70a58dafaef3cc51683a43821d9cf8da08de"
},
+ {
+ "name": "@narratage/compiler-node",
+ "version": "0.0.0-dev",
+ "digest": "sha256:019d7603c28d726e9fc8127e5786c2cd22575a8faa84d91dfd77139fda0927af"
+ },
{
"name": "@narratage/component-kit",
"version": "0.0.0-dev",
@@ -66,7 +80,17 @@
{
"name": "@narratage/core",
"version": "0.0.0-dev",
- "digest": "sha256:651c4d546708cd8648e1730a906fc3f9f9fc274db421e6374afee83574cecc7d"
+ "digest": "sha256:1c1b9855eb71e7c9472e77edea95885f0b21b54cec9f8d707bd195802158e539"
+ },
+ {
+ "name": "@narratage/credential-store-env",
+ "version": "0.0.0-dev",
+ "digest": "sha256:b60d7d7b54b5c63cc4fc5e503c69ed8c49d9a6b8251ddc2d4e5763e24c8889ac"
+ },
+ {
+ "name": "@narratage/driver-node",
+ "version": "0.0.0-dev",
+ "digest": "sha256:9f7df9d719422b91ac6d51995a6657d2b01cc32f80204a98240c9102ac278791"
},
{
"name": "@narratage/elaborator",
@@ -76,7 +100,7 @@
{
"name": "@narratage/endpoint-kit",
"version": "0.0.0-dev",
- "digest": "sha256:2f377c58c0dbec426d90adcb4794356507b3b4c55eb3d2533f54b44fcc20be03"
+ "digest": "sha256:94b455390d37d675a55c1888cc4b665d777f017e279510852cb5033436aee3ed"
},
{
"name": "@narratage/generation",
@@ -93,6 +117,11 @@
"version": "0.0.0-dev",
"digest": "sha256:dde9143aed4fa8731a1a91f860bb2a8a9f426c7515b5c12bed8b2fac24c0a416"
},
+ {
+ "name": "@narratage/local",
+ "version": "0.0.0-dev",
+ "digest": "sha256:f833c604b93c46f7596951d41e89ddb630dad1404bee6029c44ed541c437d151"
+ },
{
"name": "@narratage/markup",
"version": "0.0.0-dev",
@@ -118,6 +147,11 @@
"version": "0.0.0-dev",
"digest": "sha256:04a9e9aaf2005e9a12befea7a29d24ab0aa74fda87e4ff39eb149342c6f8a256"
},
+ {
+ "name": "@narratage/package-loader-node",
+ "version": "0.0.0-dev",
+ "digest": "sha256:1296c0ef3170e77cfdaa8cde0e1753fad2822b254507e0978429498d84c73ed0"
+ },
{
"name": "@narratage/program-space",
"version": "0.0.0-dev",
@@ -131,7 +165,7 @@
{
"name": "@narratage/provider-google-vertex",
"version": "0.0.0-dev",
- "digest": "sha256:64e7d806f93eafc73312af93515d65d0f8116ec42c6167de671ccd0a5907d363"
+ "digest": "sha256:b9de2ae61195991b65626a51053e71d79747b37274dd24dfbfdd0b855df455bd"
},
{
"name": "@narratage/provider-hyperframes-local",
@@ -141,12 +175,12 @@
{
"name": "@narratage/provider-kie",
"version": "0.0.0-dev",
- "digest": "sha256:e3d5b5752f13d8069a54c6157b1cbcec0a90ba0c22bbf54c6f6b8bf97fe8af5e"
+ "digest": "sha256:22612e3da4f12a5b780bcca5de5bf5585370772343aea749329715afe1988a88"
},
{
"name": "@narratage/provider-media-local",
"version": "0.0.0-dev",
- "digest": "sha256:afedec770515f6cf0e06d42321406a1ecdf9e06c249c0575791518f924381480"
+ "digest": "sha256:241bfaeacef8ec59694c127bc2dacf8cbac4fd48d10cbe04d1f2d0aa25f84d36"
},
{
"name": "@narratage/provider-whisperx-local",
@@ -158,6 +192,11 @@
"version": "0.0.0-dev",
"digest": "sha256:5f30fd4c9ce4de8984408d125498f58b06899011d6e07b43bea6ff3498490fe1"
},
+ {
+ "name": "@narratage/run",
+ "version": "0.0.0-dev",
+ "digest": "sha256:d734eb7ef18623d279d7176ce3fb1ed8b9c3a457aec7fcec2d439129815efaff"
+ },
{
"name": "@narratage/runtime-adapter-node",
"version": "0.0.0-dev",
@@ -166,12 +205,12 @@
{
"name": "@narratage/runtime-adapter",
"version": "0.0.0-dev",
- "digest": "sha256:277ce723c443f2e29bf60ca98dc33113cf11824ecba25868f159c9b597a1d6b9"
+ "digest": "sha256:357fc3c81876d25e553eaa555dd3308ff3db51715d230e6dd44573667058add2"
},
{
"name": "@narratage/runtime",
"version": "0.0.0-dev",
- "digest": "sha256:8e1e15aaed7ee09ac2aa51d9be0484706caae6481a4eaa1dc2e96bcc2d38be00"
+ "digest": "sha256:0f383c247e08abb30ab69ef6ce9d6bbf8b0f8fabc72b057ac97970c7f99ed4b2"
},
{
"name": "@narratage/semantic-map",
@@ -203,6 +242,11 @@
"version": "0.0.0-dev",
"digest": "sha256:ad66df5763802600b43d5df3538e5dc43bfe52cb7f1dabe63497e79834cfbe09"
},
+ {
+ "name": "@narratage/store-sqlite",
+ "version": "0.0.0-dev",
+ "digest": "sha256:cf7e739e38b5d7094488cd3da0aaae16f66cdb229ed48ec59999ccbe381aedcd"
+ },
{
"name": "@narratage/svs",
"version": "0.0.0-dev",
@@ -228,6 +272,11 @@
"version": "0.0.0-dev",
"digest": "sha256:7ee7f559fdc0508b6a7447838eb0a121cbe60c03522c6969638e0e8d3c04068f"
},
+ {
+ "name": "@narratage/workspace-fs-node",
+ "version": "0.0.0-dev",
+ "digest": "sha256:3ed827c6a586ccb5a9bc023ccea5c05a1fbe1a317a79df88314073c18cfa8ea3"
+ },
{
"name": "@protobufjs/aspromise",
"version": "1.1.2",
@@ -870,6 +919,33 @@
}
],
"packages": [
+ {
+ "specifier": "@narratage/artifact-store-fs",
+ "package": {
+ "name": "@narratage/artifact-store-fs",
+ "version": "0.0.0-dev"
+ },
+ "facetsDigest": "sha256:914018276b9218afc13940ca5c362dc95fa19d574fc07b06b6fe005c5eb30315",
+ "closureDigest": "sha256:486228772cda98bfe09c6262bc6f06f6cc5601928856c184087d1719d7497e49"
+ },
+ {
+ "specifier": "@narratage/credential-store-env",
+ "package": {
+ "name": "@narratage/credential-store-env",
+ "version": "0.0.0-dev"
+ },
+ "facetsDigest": "sha256:ee33ba638bbf2f88eee8f34a2f3179f435a0af9ccbae3fbb7d2a81bd6aeac612",
+ "closureDigest": "sha256:dee6b5e342b981185fce3dd86112d7a30bc11e0aa7132f4c4cbfa9ccfd086dda"
+ },
+ {
+ "specifier": "@narratage/local",
+ "package": {
+ "name": "@narratage/local",
+ "version": "0.0.0-dev"
+ },
+ "facetsDigest": "sha256:6689aed79b0947c7315aef65e46806ce73da01de3d73b454e1497b8d847ffa61",
+ "closureDigest": "sha256:4a22531c658b24975a7b1c083102bc90bd107d97c20286da818a9f964c6bbc86"
+ },
{
"specifier": "@narratage/provider-google-vertex",
"package": {
@@ -877,7 +953,7 @@
"version": "0.0.0-dev"
},
"facetsDigest": "sha256:b2636492ab0b0b500d674899ab2ff14fc61c7f2b22ef44eb8f816f141b21ec4d",
- "closureDigest": "sha256:4de4e5316cdb31753efd871fc1cc443661f7cf4788645082e00de84a762d7bda"
+ "closureDigest": "sha256:8b92e7871fa616ed3a6adce14a6bb7d705532dc0807e453492cd8a878558d9a7"
},
{
"specifier": "@narratage/provider-hyperframes-local",
@@ -886,7 +962,7 @@
"version": "0.0.0-dev"
},
"facetsDigest": "sha256:b14b721bdc0c9d5d9ced1c345107c92a3a5878f3383dea2ecd3e310442c2a40c",
- "closureDigest": "sha256:47a45ecf94238c7e06bbd87e28ec17b74ac2421293b03ad77936a41728948089"
+ "closureDigest": "sha256:1102b66d7613c516cbd67ded83961b8bd96ad0d45772fe185c28962084692daf"
},
{
"specifier": "@narratage/provider-kie",
@@ -895,7 +971,7 @@
"version": "0.0.0-dev"
},
"facetsDigest": "sha256:e61ebb911a33d4c5d0e4e4ee4fb69cdb790f4ced050ef35f7472bfbd72013d9b",
- "closureDigest": "sha256:c7526eb040617e45080b72a4f50f8f32ae6dc33fcc08ebaefecccd478b23d8c7"
+ "closureDigest": "sha256:b6d39b1697767893f05c27d7d3c2b5e683e9c559d020c8de0a412ec76226cea0"
},
{
"specifier": "@narratage/provider-media-local",
@@ -904,7 +980,7 @@
"version": "0.0.0-dev"
},
"facetsDigest": "sha256:701abcc923bf8a711c20b6e308d8cc8be27bf560f249b8c5a801e1dbd9cb3979",
- "closureDigest": "sha256:4382ac1151fd841cd673bfd49ba1c64df7e1a0ae6ed5610f6b4ecd26aa98f241"
+ "closureDigest": "sha256:8704836ca23624ca38023f5a3b0d7427e817a38412880e97dc5932fb7268d493"
},
{
"specifier": "@narratage/provider-whisperx-local",
@@ -913,8 +989,17 @@
"version": "0.0.0-dev"
},
"facetsDigest": "sha256:3686b84c42cc2b1bcaccf57cbdcda25a15c7d9d3778fb92d25437f9880ed8f5d",
- "closureDigest": "sha256:1f4387ca08d77d88c2a02faa0a40ba0d5c76f676f6128a94215ab39010112266"
+ "closureDigest": "sha256:7ff51a768a942fbe72ec4ef11b2d19c3066cc38c77f1a94261aa3cacd6a8e56d"
+ },
+ {
+ "specifier": "@narratage/store-sqlite",
+ "package": {
+ "name": "@narratage/store-sqlite",
+ "version": "0.0.0-dev"
+ },
+ "facetsDigest": "sha256:5bccf73cd953710fc31ef44672fef1bfc396fd4aa2eff4b53108e8ff87e749c3",
+ "closureDigest": "sha256:46d6044b5fee1777c27718094480b5b6e2606d35bfe8347a4f9c0a5034419bb8"
}
],
- "digest": "sha256:e635b2789745d90ddb8e32b30dd3261f738d44d62a508f33ceaca97629d0a898"
+ "digest": "sha256:a7d0d90fe7ab45a8a8bf113e08f7348ab53d91396f7e08955cb90b7db6444524"
}
diff --git a/examples/talking-head-aroll/svml.runtime.json b/examples/talking-head-aroll/svml.runtime.json
index 747e9eba..c9c2e702 100644
--- a/examples/talking-head-aroll/svml.runtime.json
+++ b/examples/talking-head-aroll/svml.runtime.json
@@ -2,13 +2,31 @@
"format": "svml.runtime-config@1",
"packageLock": "./svml.packages.lock",
"runtimePackageLock": "./svml.runtime-packages.lock",
+ "runtimeServices": [
+ { "use": "@narratage/local", "instance": "execution" },
+ { "use": "@narratage/store-sqlite", "instance": "state", "config": { "path": ".svml/runtime.sqlite" } },
+ { "use": "@narratage/artifact-store-fs", "instance": "artifacts", "config": { "path": ".svml/artifacts" } },
+ { "use": "@narratage/credential-store-env", "instance": "credentials.env", "config": {} }
+ ],
+ "services": {
+ "scheduler": "execution.scheduler",
+ "worker": "execution.worker",
+ "stores": {
+ "build": "state.builds",
+ "operations": "state.operations",
+ "dispatch": "state.dispatch",
+ "journal": "state.journal",
+ "artifacts": "artifacts",
+ "credentials": ["credentials.env"]
+ }
+ },
"endpoints": [
{
"use": "@narratage/provider-kie",
"instance": "kie.talking-head-aroll",
"lane": "generation",
"config": {
- "apiKeyEnv": "KIE_API_KEY",
+ "apiKey": { "store": "env", "key": "KIE_API_KEY" },
"defaultConcurrency": 2
}
},
@@ -34,7 +52,7 @@
"lane": "planning",
"config": {
"projectEnv": "GOOGLE_CLOUD_PROJECT",
- "credentialsEnv": "GOOGLE_APPLICATION_CREDENTIALS_JSON",
+ "credentials": { "store": "env", "key": "GOOGLE_APPLICATION_CREDENTIALS_JSON" },
"location": "global",
"defaultConcurrency": 1
}
@@ -51,6 +69,9 @@
}
],
"permissions": [
+ "environment:credentials",
+ "filesystem:artifacts",
+ "filesystem:state",
"filesystem:whisperx-staging",
"network:aiplatform.googleapis.com",
"network:api.kie.ai",
diff --git a/packages/artifact-store-s3/README.md b/packages/artifact-store-s3/README.md
index f1f865e6..4edef404 100644
--- a/packages/artifact-store-s3/README.md
+++ b/packages/artifact-store-s3/README.md
@@ -27,14 +27,12 @@ const artifacts = createS3ArtifactStorePackage({
expectedBucketOwner: "123456789012",
});
-export default createProjectLocalRuntime({
- root: import.meta.dirname,
- runtimeServices: [artifacts],
- allowedPermissions: ["network:aws:s3"],
- endpoints: [],
-});
+// Supply this package beside explicit Scheduler/Worker, state and CredentialStore packages,
+// then select `artifacts.team` as runtimeSelection.stores.artifacts.
```
+`createProjectLocalRuntime()` never infers the other required services from this package.
+
The AWS SDK default credential chain or an explicitly injected trusted client owns AWS
authentication. Secret bytes never enter the package contribution or Runtime Closure; bucket,
prefix, region, endpoint and account constraint do.
diff --git a/packages/credential-store-env/README.md b/packages/credential-store-env/README.md
index 7d7d130d..4ad99b12 100644
--- a/packages/credential-store-env/README.md
+++ b/packages/credential-store-env/README.md
@@ -11,6 +11,9 @@ serializes the environment. Secret values are handed only to that Endpoint call
BuildState, Runtime Closure, Operation checkpoints, logs or SQLite through framework code.
`createEnvironmentCredentialStorePackage()` exposes it through the same generic Runtime service
-package ABI as every other CredentialStore. `createProjectLocalRuntime()` activates it by default.
-Production deployments may replace
-it with a keychain, Vault, KMS or tenant-scoped implementation of the same `CredentialStore` port.
+package ABI as every other CredentialStore. A Runtime Profile must activate and select it
+explicitly; `@narratage/local` supplies no credential default. Several selected Stores may coexist,
+and this one declines every reference whose `store` is not `env`.
+
+The environment facet is intentionally read-only. Interactive `auth login/logout` requires a
+selected Store with the optional bounded writable facet, such as the macOS Keychain adapter.
diff --git a/packages/credential-store-keychain/README.md b/packages/credential-store-keychain/README.md
index b1f116b4..2c021177 100644
--- a/packages/credential-store-keychain/README.md
+++ b/packages/credential-store-keychain/README.md
@@ -1,6 +1,7 @@
# `@narratage/credential-store-keychain`
-macOS Keychain-backed implementation of the domain-neutral Runtime `CredentialStore` port.
+macOS Keychain-backed implementation of the domain-neutral Runtime `CredentialStore` port, including
+its optional writable facet.
It resolves only explicit `{ store: "keychain", key }` references and cannot enumerate credentials.
Secrets never enter Runtime Profile, Runtime Closure or BuildState. The package invokes the bounded
@@ -10,7 +11,11 @@ failure.
The Runtime Profile adapter accepts one optional `service` name. Selecting this package requires the
explicit `process:keychain` permission. Merely installing it grants no credential authority.
-Add a value where the default store will find it with:
+`narratage auth login <endpoint> --runtime <profile>` writes only when an Endpoint's configured
+`CredentialRef.store` is `keychain` and this exact Store instance was selected. `auth status` is
+read-only; `auth logout` removes only that exact account. The CLI contains no Provider-name switch.
+
+Add a value under the service/account pair selected by the Runtime Profile with:
```bash
security add-generic-password -s narratage -a KIE_API_KEY -w
diff --git a/packages/local/README.md b/packages/local/README.md
index 799add2f..99fae7eb 100644
--- a/packages/local/README.md
+++ b/packages/local/README.md
@@ -1,119 +1,80 @@
# `@narratage/local`
-The in-process developer assembly. It keeps Core and the authoritative Build Scheduler in the
-current Node process while allowing every capability Endpoint to run in a different place. Loaded
-implementation packages are trusted and byte-locked; that trust boundary describes code execution,
-not a special class of user.
+Node-hosted assembly and process lifecycle for an explicitly selected Runtime. It is not a bundle of
+default Stores and it contains no authoring, video, Provider or package-routing policy.
-The convenience assembly uses:
+`@narratage/local` contributes two replaceable Runtime services:
-- `@narratage/store-sqlite` for durable Build and Operation facts;
-- `@narratage/artifact-store-fs` for content-addressed project bytes;
-- optional replacement of Scheduler, BuildStore, OperationStore, ArtifactStore or CredentialStore
- by permission-checked Runtime service packages;
-- an in-process, queue-free Scheduler whose ready work always comes from Core;
-- an exact implementation package lock for deterministic component packages;
-- separately selected external Endpoint packages.
+- `scheduler`: regenerates ready Core commands from verified BuildState;
+- `worker`: claims durable Build dispatches, maintains fenced leases and advances them.
-Package loading is syntax-neutral. The local Runtime activates only locked deterministic Producer
-and Validator facets; it neither depends on `@narratage/markup` nor installs any package Host facet.
-
-Normal CLI projects may express the same assembly as closed data:
+A Runtime Profile must separately select every service:
```json
{
"format": "svml.runtime-config@1",
+ "packageLock": "./svml.packages.lock",
"runtimePackageLock": "./svml.runtime-packages.lock",
- "services": [],
- "endpoints": [
- {
- "use": "@narratage/provider-kie",
- "instance": "kie.project",
- "lane": "generation",
- "config": { "apiKeyEnv": "KIE_API_KEY", "defaultConcurrency": 2 }
- }
+ "runtimeServices": [
+ { "use": "@narratage/local", "instance": "execution" },
+ { "use": "@narratage/store-sqlite", "instance": "state", "config": { "path": ".svml/runtime.sqlite" } },
+ { "use": "@narratage/artifact-store-fs", "instance": "artifacts", "config": { "path": ".svml/artifacts" } },
+ { "use": "@narratage/credential-store-keychain", "instance": "credentials", "config": {} }
],
- "permissions": [
- "network:api.kie.ai",
- "network:kieai.redpandaai.co"
- ],
- "scheduling": { "maxConcurrency": 4, "lanes": { "generation": 2 } }
+ "services": {
+ "scheduler": "execution.scheduler",
+ "worker": "execution.worker",
+ "stores": {
+ "build": "state.builds",
+ "operations": "state.operations",
+ "dispatch": "state.dispatch",
+ "journal": "state.journal",
+ "artifacts": "artifacts",
+ "credentials": ["credentials"]
+ }
+ },
+ "endpoints": [],
+ "permissions": ["filesystem:state", "filesystem:artifacts", "process:keychain"],
+ "scheduling": { "maxConcurrency": 4 }
}
```
-`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.
+No role is inferred by uniqueness. An empty or incomplete selection fails before work starts.
+`@narratage/local` has no production dependency on SQLite, the filesystem ArtifactStore, an
+environment credential source, or any Provider.
-`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.
+## Execution law
-Deterministic packages implement the host-neutral `@narratage/component-kit` contract. `@narratage/local`
-adapts them to `ProducerRegistry`; the component never imports the Node Driver or receives Runtime
-services.
+`LocalRuntime.build()` stages source attachments, creates verified BuildState and one durable
+dispatch, then returns. A Worker process owns execution. `--follow` polls that dispatch and never
+becomes its executor; interrupting the observer does not cancel the Build.
-```ts
-export default await createProjectLocalRuntime({
- root: import.meta.dirname,
- // May point at a separate Narratage installation when this project owns no node_modules.
- packageRoot: "/opt/narratage",
- packageLock: "./svml.packages.lock",
- runtimeServices: [createS3ArtifactStorePackage({
- bucket: "team-svml-artifacts",
- prefix: "development",
- region: "us-east-1",
- })],
- endpoints: [createKieProvider({ apiKey: credentialRef("env", "KIE_API_KEY") })],
- allowedPermissions: ["network:aws:s3", "network:api.kie.ai", "network:kieai.redpandaai.co"],
- scheduling: {
- maxConcurrency: 8,
- lanes: { "endpoint:kie.personal": 2 },
- },
-});
-```
+The Worker stores no serialized Core command. After every restart it reopens verified BuildState and
+asks the selected Scheduler to regenerate the current commands. Recoverable Provider checkpoints
+remain in `OperationStore`; dispatch lease, heartbeat, admission and shared lane capacity remain in
+`BuildDispatchStore`; operational history remains in `RuntimeJournal`.
+
+Cancellation first closes admission. Existing Operations keep their own execution fact and a
+separate cancellation-control fact. Provider acceptance is not reported as cancellation; unsupported
+or too-late requests continue reconciling the same Operation and never select another Candidate.
-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 Endpoint remains an independently selected privileged endpoint; swapping it changes an
-Endpoint implementation and lane, not the `.svml` author document.
-`createProjectLocalRuntime` infers a role when exactly one configured service package supplies it.
-When several instances provide the same role, `runtimeSelection` must name the exact instance.
-The same mechanism covers Postgres, S3, keychains and replacement Schedulers; none requires a
-change to `@narratage/local`. Advanced hosts may still call `createLocalRuntime` with raw ports.
+## Boundaries
-`LocalRuntime.status(build)` exposes the verified durable Build archive, and
-`LocalRuntime.readArtifact(digest)` is the generic byte-egress seam used by CLI `get`. They expose
-Record and content identities, not private filesystem layout, so filesystem and S3 stores remain
-interchangeable. Egress never determines whether a Build result is retained.
+- `svml.packages.lock` closes deterministic Producer and Validator code used by the graph.
+- `svml.runtime-packages.lock` closes privileged Runtime adapters that may access files, credentials,
+ processes or networks.
+- `.svml` and `.svrun` source can affect neither lock.
+- loaded implementation identities are rebound to actual package and dependency bytes.
+- Runtime credentials are resolved only from explicitly selected `CredentialStore` instances.
-The filesystem ArtifactStore additionally implements optional streaming transfer and explicit
-retention capabilities. `narratage 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. `narratage doctor
-<runtime-profile.json>` verifies package bytes, closed adapter configuration, required environment
-credentials, executables and declared service health without running a Build. Runtime Adapter Host
-ABI `@1` requires a pure configuration gate separate from construction: `doctor` never invokes an
-adapter factory, starts a service, writes Runtime state or submits work. Valid instances may perform
-bounded read-only environment probes.
+`LocalBuildRequest.attachments` is explicit Host ingress into the selected ArtifactStore. The Store's
+returned digest, media type and size must equal the claimed `BlobRef` before Core execution. Artifact
+retention is explicit maintenance: `narratage gc` previews by default and `--apply` removes only bytes
+unreachable from retained Build and Operation facts.
-`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
-of Runtime service selection and Closure identity because changing a source path or display alias
-must not invalidate or resume a different execution.
+`BuildCatalog` is optional Host presentation metadata. SQLite may expose one beside its execution
+facets, but Local never creates a second hidden database or treats aliases and source paths as Build
+truth.
-`LocalBuildRequest.attachments` is the explicit ingress from a trusted Host into the selected
-ArtifactStore. Each attachment carries claimed `BlobRef` metadata plus bytes; Local Runtime copies
-the bytes, stores them content-addressably and requires the Store's returned digest, size and media
-type to match before any Core command can consume the reference. Attachments never enter
-BuildState, SQLite or author source, and Runtime does not know whether they came from source assets,
-an upload, a provided Candidate, Git or an API. Reusing a Build after restart needs no reattachment when the
-chosen durable ArtifactStore still contains those digests.
+Advanced embeddings may call `createProjectLocalRuntime()` with explicitly constructed service and
+Endpoint packages. That TypeScript API has the same selection laws as the JSON Profile.
diff --git a/packages/provider-google-vertex/README.md b/packages/provider-google-vertex/README.md
index 2089d99e..26b1948e 100644
--- a/packages/provider-google-vertex/README.md
+++ b/packages/provider-google-vertex/README.md
@@ -11,13 +11,14 @@ Run, Cue endpoint, atom assignment, field value and per-Cue cardinality.
createGoogleVertexCaptionProvider({
project: "my-google-cloud-project",
location: "global",
+ credentialsJson: credentialRef("keychain", "google.vertex.credentials"),
});
```
-The default credential reference is the explicit environment key
-`GOOGLE_APPLICATION_CREDENTIALS_JSON`, whose value is the JSON contents rather than a path. This
-keeps filesystem authority out of the Provider. A deployment may bind another `CredentialStore`
-and pass its `CredentialRef`. Credentials never enter author source, Runtime Closure, BuildState,
+The Runtime Profile must provide an ordinary `{ store, key }` credential reference. The referenced
+value is the JSON contents rather than a path, keeping filesystem authority out of the Provider.
+The low-level TypeScript factory retains an environment-reference convenience for embeddings;
+declarative Runtime activation has no implicit credential source. Credentials never enter author source, Runtime Closure, BuildState,
Operation state, Prompt or Receipt metadata.
The legacy implementation used `GOOGLE_APPLICATION_CREDENTIALS` as an ADC file path. A host
diff --git a/packages/provider-kie/README.md b/packages/provider-kie/README.md
index 4402b610..adaeccb3 100644
--- a/packages/provider-kie/README.md
+++ b/packages/provider-kie/README.md
@@ -37,48 +37,39 @@ requests, not in Provider routing.
## Local Runtime
+Declarative activation names an ordinary CredentialRef, not an environment-specific Provider field:
+
+```json
+{
+ "use": "@narratage/provider-kie",
+ "instance": "kie.personal",
+ "lane": "generation",
+ "config": {
+ "apiKey": { "store": "keychain", "key": "kie.api-key" },
+ "defaultConcurrency": 2
+ }
+}
+```
+
+The selected writable CredentialStore then enables `narratage auth login kie.personal --runtime
+svml.runtime.json`; KIE contributes the credential description and the generic CLI contains no KIE
+branch.
+
```ts
-import { geminiOmniComponent } from "@narratage/gemini-omni";
-import { generationComponent } from "@narratage/generation";
-import { gptImageComponent } from "@narratage/gpt-image";
-import { grokImagineComponent } from "@narratage/grok-imagine";
-import { createProjectLocalRuntime } from "@narratage/local";
-import { minimaxH3Component } from "@narratage/minimax-h3";
-import { nanoBananaComponent } from "@narratage/nano-banana";
import { createKieProvider } from "@narratage/provider-kie";
import { credentialRef } from "@narratage/runtime";
-import { seedanceComponent } from "@narratage/seedance";
-import { seedreamComponent } from "@narratage/seedream";
-
-export default await createProjectLocalRuntime({
- components: [
- generationComponent,
- seedanceComponent,
- minimaxH3Component,
- geminiOmniComponent,
- grokImagineComponent,
- gptImageComponent,
- nanoBananaComponent,
- seedreamComponent,
- ],
- endpoints: [createKieProvider({
- instance: "kie.personal",
- apiKey: credentialRef("env", "KIE_API_KEY"),
- defaultConcurrency: 2,
- })],
- allowedPermissions: [
- "network:api.kie.ai",
- "network:kieai.redpandaai.co",
- ],
+
+const kie = createKieProvider({
+ instance: "kie.personal",
+ apiKey: credentialRef("env", "KIE_API_KEY"),
+ defaultConcurrency: 2,
});
```
-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. Each
-model 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 the
-author document; installing Runtime code does not implicitly add author intent.
+An advanced embedding adds `kie` to its Endpoint list beside a complete, explicit set of Runtime
+service packages and selections. A reproducible project normally activates deterministic model
+components through `packageLock`. The `.svml` Module Closure separately contains only the model
+Manifests actually imported by the author document; installing KIE does not add author intent.
## Paid-operation law
@@ -91,8 +82,9 @@ author document; installing Runtime code does not implicitly add author intent.
4. Successful result URLs are converted to short-lived download URLs, bounded while streaming,
immediately written to the configured content-addressed ArtifactStore, and removed from durable
result metadata.
-5. `@narratage/local` owns Build concurrency. This Provider contributes one KIE lane and a conservative
- create-task interval; it does not introduce Redis or another source of Build truth.
+5. The selected `BuildDispatchStore` owns shared Build capacity. This Provider contributes one KIE
+ lane and a conservative create-task interval; it does not introduce Redis or another source of
+ Build truth.
The automated suite uses an adversarial fake KIE service. The credentialed smoke command is a paid
deployment test and is intentionally not run by the public repository test suite. It must be enabled
diff --git a/packages/provider-media-local/README.md b/packages/provider-media-local/README.md
index 920bdeb9..68c9f0a6 100644
--- a/packages/provider-media-local/README.md
+++ b/packages/provider-media-local/README.md
@@ -4,16 +4,14 @@ Trusted local ffprobe/ffmpeg implementation of `@narratage/media-pipeline`'s eig
capabilities. It is Runtime configuration and is never imported by author `.svml`.
```ts
-import { createProjectLocalRuntime } from "@narratage/local";
import { createLocalMediaProvider } from "@narratage/provider-media-local";
-const runtime = await createProjectLocalRuntime({
- packageLock: "./svml.packages.lock",
- endpoints: [createLocalMediaProvider({ defaultConcurrency: 1 })],
- allowedPermissions: ["process:media"],
-});
+const media = createLocalMediaProvider({ instance: "media.local", defaultConcurrency: 1 });
```
+An embedding adds `media` to a complete explicit Runtime assembly and grants `process:media`; the
+declarative form selects this package from `runtimePackageLock`.
+
The Endpoint:
- bounds subprocess duration and ffprobe JSON size;
diff --git a/packages/provider-xiaomi-mimo/README.md b/packages/provider-xiaomi-mimo/README.md
index 31551cb1..2d5588f5 100644
--- a/packages/provider-xiaomi-mimo/README.md
+++ b/packages/provider-xiaomi-mimo/README.md
@@ -15,7 +15,7 @@ Runtime Profile example:
"instance": "mimo.official",
"lane": "xiaomi-mimo",
"config": {
- "apiKeyEnv": "MIMO_API_KEY",
+ "apiKey": { "store": "keychain", "key": "xiaomi-mimo.api-key" },
"defaultConcurrency": 2
}
}
@@ -29,7 +29,7 @@ Add the Provider independently to the Runtime package lock:
```sh
pnpm narratage lock-packages svml.runtime-packages.lock \
--package @narratage/provider-xiaomi-mimo \
- --root .
+ --package-root .
```
The Provider declares a default concurrency limit on its selected Runtime lane. The shared
diff --git a/packages/video-cli/README.md b/packages/video-cli/README.md
index 46917738..ed262845 100644
--- a/packages/video-cli/README.md
+++ b/packages/video-cli/README.md
@@ -14,6 +14,8 @@ From the repository:
pnpm narratage lock-packages ./svml.packages.lock \
--package @narratage/run-markup --package @narratage/script --package @example/cards --package-root .
pnpm narratage lock-packages ./svml.runtime-packages.lock \
+ --package @narratage/local --package @narratage/store-sqlite \
+ --package @narratage/artifact-store-fs --package @narratage/credential-store-env \
--package @narratage/provider-kie --package @narratage/provider-media-local --package-root .
pnpm narratage check path/to/main.svml --package-lock ./svml.packages.lock --root .
pnpm narratage check path/to/build.svrun --package-lock ./svml.packages.lock --root .
@@ -24,7 +26,8 @@ pnpm narratage status <build-id> --runtime ./svml.runtime.json
pnpm narratage builds --runtime ./svml.runtime.json
pnpm narratage inspect <build-id> --runtime ./svml.runtime.json
pnpm narratage get <build-id> --name final.video --runtime ./svml.runtime.json --to ./final.mp4
-pnpm narratage cancel <build-id> --runtime ./svml.runtime.json
+pnpm narratage cancel build <build-id> --runtime ./svml.runtime.json
+pnpm narratage cancel operation <operation-id> --runtime ./svml.runtime.json
pnpm narratage doctor ./svml.runtime.json
pnpm narratage gc ./svml.runtime.json
```
@@ -49,11 +52,12 @@ loaded Runtime implementation identity is rebound to the actual package bytes. A
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
-non-retryable failure, cancellation or `--max-wait-ms`. `status` reads durable verified state;
-`cancel` invokes active endpoints and then records the resulting terminal Build failure. None of
-these commands creates a second ready-command queue.
+Without `--follow`, `build` returns after durable submission and the detached Worker continues.
+With `--follow`, the CLI observes dispatch and Operation facts until terminal state or
+`--max-wait-ms`; Ctrl-C only detaches that observer. `status` reads durable verified state. Scoped
+Build/Operation cancellation records control separately from execution, continues reconciliation
+after `accepted` or `unsupported`, and never selects another Candidate. None of these commands
+creates or stores a ready-Command queue.
`build` archives every accepted Record in the demanded closure and every referenced byte Artifact,
whether or not the user wants a conventional filesystem copy. `inspect` lists Targets, demanded