@norskvideo/ctl-product-template-schema 0.1.8 → 0.1.10

package/index.d.ts

@@ -23,8 +23,8 @@ export declare const ProductTemplateAdvancedSchema: z.ZodObject<{
     shmSize: z.ZodOptional<z.ZodObject<{
         default: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>;
-    shmGroup: z.ZodOptional<z.ZodObject<{
-        default: z.ZodOptional<z.ZodString>;
+    sharedMemory: z.ZodOptional<z.ZodObject<{
+        default: z.ZodOptional<z.ZodArray<z.ZodString>>;
     }, z.core.$strip>>;
     openFileLimit: z.ZodOptional<z.ZodObject<{
         default: z.ZodOptional<z.ZodNumber>;
@@ -43,6 +43,9 @@ export declare const ProductTemplateAllocatedPortSchema: z.ZodObject<{
 export type ProductTemplateAllocatedPort = z.infer<typeof ProductTemplateAllocatedPortSchema>;
 export declare const ProductTemplateSideloadSchema: z.ZodObject<{
     gpuInference: z.ZodOptional<z.ZodBoolean>;
+    models: z.ZodOptional<z.ZodBoolean>;
+    modelsReasoning: z.ZodOptional<z.ZodBoolean>;
+    llmVenv: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>;
 export type ProductTemplateSideload = z.infer<typeof ProductTemplateSideloadSchema>;
 export declare const ProductTemplateManifestSchema: z.ZodObject<{
@@ -73,6 +76,9 @@ export declare const ProductTemplateManifestSchema: z.ZodObject<{
     requiresWorkingDirectory: z.ZodOptional<z.ZodBoolean>;
     sideload: z.ZodOptional<z.ZodObject<{
         gpuInference: z.ZodOptional<z.ZodBoolean>;
+        models: z.ZodOptional<z.ZodBoolean>;
+        modelsReasoning: z.ZodOptional<z.ZodBoolean>;
+        llmVenv: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strip>>;
     advanced: z.ZodOptional<z.ZodObject<{
         networkMode: z.ZodOptional<z.ZodObject<{
@@ -93,8 +99,8 @@ export declare const ProductTemplateManifestSchema: z.ZodObject<{
         shmSize: z.ZodOptional<z.ZodObject<{
             default: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>;
-        shmGroup: z.ZodOptional<z.ZodObject<{
-            default: z.ZodOptional<z.ZodString>;
+        sharedMemory: z.ZodOptional<z.ZodObject<{
+            default: z.ZodOptional<z.ZodArray<z.ZodString>>;
         }, z.core.$strip>>;
         openFileLimit: z.ZodOptional<z.ZodObject<{
             default: z.ZodOptional<z.ZodNumber>;
@@ -188,6 +194,9 @@ export declare const ProductTemplateMaterialsSchema: z.ZodObject<{
         requiresWorkingDirectory: z.ZodOptional<z.ZodBoolean>;
         sideload: z.ZodOptional<z.ZodObject<{
             gpuInference: z.ZodOptional<z.ZodBoolean>;
+            models: z.ZodOptional<z.ZodBoolean>;
+            modelsReasoning: z.ZodOptional<z.ZodBoolean>;
+            llmVenv: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$strip>>;
         advanced: z.ZodOptional<z.ZodObject<{
             networkMode: z.ZodOptional<z.ZodObject<{
@@ -208,8 +217,8 @@ export declare const ProductTemplateMaterialsSchema: z.ZodObject<{
             shmSize: z.ZodOptional<z.ZodObject<{
                 default: z.ZodOptional<z.ZodString>;
             }, z.core.$strip>>;
-            shmGroup: z.ZodOptional<z.ZodObject<{
-                default: z.ZodOptional<z.ZodString>;
+            sharedMemory: z.ZodOptional<z.ZodObject<{
+                default: z.ZodOptional<z.ZodArray<z.ZodString>>;
             }, z.core.$strip>>;
             openFileLimit: z.ZodOptional<z.ZodObject<{
                 default: z.ZodOptional<z.ZodNumber>;

package/index.js

@@ -78,16 +78,14 @@ export const ProductTemplateAdvancedSchema = z
     // exclusive and a second instance needs a different one. Hard pinning is
     // a future product-template-pins concern, not this knob.
     hostPorts: z.object({ default: z.array(z.string()).optional() }).optional(),
-    // Shared memory. `shmSize` sizes media's private /dev/shm — or, under a
-    // group, the shared IPC namespace every member of that group joins.
-    // `shmGroup` opts the instance out of privacy altogether and into a named
-    // namespace shared with every other member on the host — what a zero-copy
-    // cross-instance transport (MXL) needs, and meaningless without one. A
-    // product that requires the shared namespace supplies the group name as its
-    // `default`, so an operator gets it without knowing the transport's
-    // mechanics.
+    // Shared memory: `shmSize` sizes media's private /dev/shm — always private
+    // to the instance (ADR-0011). Cross-instance sharing is `sharedMemory`:
+    // operator-created host tmpfs paths bind-mounted into media (e.g. an MXL
+    // domain). A product built around a domain suggests the conventional path
+    // as its `default`; the operator still owns creating the mount, and can
+    // override or decline at launch.
     shmSize: z.object({ default: z.string().optional() }).optional(),
-    shmGroup: z.object({ default: z.string().optional() }).optional(),
+    sharedMemory: z.object({ default: z.array(z.string()).optional() }).optional(),
     // Open file descriptors per container. The runner already states a ceiling
     // for every instance (unset, containers inherit the host daemon's limit,
     // which is how a media graph at ~1000 handles dies of EMFILE on some hosts
@@ -117,15 +115,26 @@ export const ProductTemplateAllocatedPortSchema = z
     label: z.string().optional().meta({ description: "Human label, e.g. 'MoQ preview (WebTransport)'" }),
 })
     .meta({ id: "ProductTemplateAllocatedPort", outputId: "ProductTemplateAllocatedPort" });
-// CUDA sideload bundle needs (docker/SIDELOAD.md). Only `gpuInference` is
-// declared: `gpu-video` (NVENC/NVDEC) follows the GPU reservation automatically,
-// so it needs no declaration. The runner mounts the matching bundle only when
-// the image is slimmed AND the GPU is reserved; otherwise this is inert (a stock
-// image needs no bundle; inference without a bundle falls back to CPU).
+// Sideload bundle needs (docker/SIDELOAD.md). `gpu-video` (NVENC/NVDEC) follows
+// the GPU reservation automatically, so it needs no declaration. `gpuInference`
+// gates the 1.58 GB CUDA bundle and is inert without a GPU reservation
+// (inference falls back to CPU). The two model-weight declarations are
+// GPU-independent: the weights ARE the feature, so a declaration is honoured on
+// CPU-only hosts too. All of it is inert on a fat image (no `.refs`, nothing to
+// mount).
 export const ProductTemplateSideloadSchema = z
     .object({
     gpuInference: z.boolean().optional().meta({
-        description: "Deployment uses GPU-accelerated inference (ONNX NR-IQA/detection/VAD, GPU whisper). When the GPU is reserved on the host the runner mounts the gpu-inference CUDA bundle; otherwise inference falls back to CPU. gpu-video (NVENC/NVDEC) follows the GPU reservation automatically and needs no declaration.",
+        description: "Deployment uses GPU-accelerated inference (ONNX NR-IQA/reasoning local analysis/VAD, GPU whisper). When the GPU is reserved on the host the runner mounts the gpu-inference CUDA bundle; otherwise inference falls back to CPU. gpu-video (NVENC/NVDEC) follows the GPU reservation automatically and needs no declaration.",
+    }),
+    models: z.boolean().optional().meta({
+        description: "Deployment uses quality monitoring (NR-IQA). The runner mounts the arch-independent models bundle (the NR-IQA ONNX weights) — needed with or without a GPU; on a slimmed image the feature is unavailable without it.",
+    }),
+    modelsReasoning: z.boolean().optional().meta({
+        description: "Deployment uses AI reasoning local analysis (object detection, scene semantics, face identity, speaker identity, OCR). The runner mounts the arch-independent models-reasoning bundle (those ONNX weights) — needed with or without a GPU; on a slimmed image those tools are unavailable without it.",
+    }),
+    llmVenv: z.boolean().optional().meta({
+        description: "Deployment uses the remote LLM providers (OpenAI/Gemini/Claude — AI reasoning plan/evaluate, live evaluate). The runner mounts the per-arch llm-venv bundle (the provider Python SDKs) — needed with or without a GPU; on a slimmed image LLM provider nodes are unavailable without it.",
     }),
 })
     .meta({ id: "ProductTemplateSideload", outputId: "ProductTemplateSideload" });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@norskvideo/ctl-product-template-schema",
-  "version": "0.1.8",
+  "version": "0.1.10",
   "type": "module",
   "exports": {
     ".": {