@happyvertical/smrt-video 0.57.36 → 0.57.37

package/dist/smrt-knowledge.json

@@ -3,13 +3,13 @@
   "sensitiveFieldsExcluded": true,
   "generatedAt": "1970-01-01T00:00:00.000Z",
   "packageName": "@happyvertical/smrt-video",
-  "packageVersion": "0.57.36",
+  "packageVersion": "0.57.37",
   "sourceManifestPath": "dist/manifest.json",
   "agentDocPath": "AGENTS.md",
   "sourceHashes": {
-    "manifest": "65b880ebc2109a7875285a7507e4842aae9161ba5bdf43721defb681fe8b2cf6",
-    "packageJson": "1f8f7b79445b59c5880f7323d8f8a83099bf45ed49d4e16a59bc4204e91b61aa",
-    "agents": "01c6489f21d949868550deecb68d3a1e264b9dee396ef437330aa3eb81c6a0c9"
+    "manifest": "33e4318f0f600f2a46ad71766c442d1c631c96c788bc3435a7ad745aa310d806",
+    "packageJson": "ca27918b687d6db2d26c4987d3af45bcd7c3e8b86a42fc41f37ce9808d01805e",
+    "agents": "f76ec652c71a7eba28ad59245020fa5df132e724f7d5b5a8612de6b126ccf4cf"
   },
   "exports": [
     ".",
@@ -914,20 +914,23 @@
           "type": "text",
           "required": false,
           "columnType": "TEXT",
-          "default": ""
+          "default": "",
+          "description": "What the character is called."
         },
         {
           "name": "description",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "Who this character is and how they come across on screen."
         },
         {
           "name": "imageAssetId",
           "type": "crossPackageRef",
           "required": false,
           "related": "@happyvertical/smrt-assets:Asset",
-          "columnType": "UUID"
+          "columnType": "UUID",
+          "description": "The picture the character is built from."
         },
         {
           "name": "baseMotionAssetId",
@@ -941,7 +944,8 @@
           "type": "crossPackageRef",
           "required": false,
           "related": "@happyvertical/smrt-voice:VoiceProfile",
-          "columnType": "UUID"
+          "columnType": "UUID",
+          "description": "The voice the character speaks with."
         },
         {
           "name": "brandingKit",
@@ -954,7 +958,8 @@
           "type": "text",
           "required": false,
           "columnType": "TEXT",
-          "default": "pending"
+          "default": "pending",
+          "description": "Whether the character is ready to appear in shots."
         },
         {
           "name": "performerId",
@@ -968,7 +973,8 @@
           "type": "foreignKey",
           "required": false,
           "related": "Scene",
-          "columnType": "UUID"
+          "columnType": "UUID",
+          "description": "The scene the character usually appears in."
         },
         {
           "name": "sceneConfigs",
@@ -3523,27 +3529,31 @@
           "type": "text",
           "required": false,
           "columnType": "TEXT",
-          "default": ""
+          "default": "",
+          "description": "What the scene is called."
         },
         {
           "name": "description",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "What the scene shows."
         },
         {
           "name": "sourceAssetId",
           "type": "crossPackageRef",
           "required": false,
           "related": "@happyvertical/smrt-assets:Asset",
-          "columnType": "UUID"
+          "columnType": "UUID",
+          "description": "The picture or video the scene is made from."
         },
         {
           "name": "sourceType",
           "type": "text",
           "required": false,
           "columnType": "TEXT",
-          "default": "image"
+          "default": "image",
+          "description": "What kind of file the scene is made from: a picture, a video or a wrap-around panorama."
         },
         {
           "name": "projection",
@@ -3583,7 +3593,8 @@
           "type": "text",
           "required": false,
           "columnType": "TEXT",
-          "default": "pending"
+          "default": "pending",
+          "description": "Whether the scene is ready to be used in shots."
         }
       ],
       "relationships": [
@@ -4455,7 +4466,8 @@
           "name": "type",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "What kind of piece this is, such as an article or a document."
         },
         {
           "name": "variant",
@@ -4473,32 +4485,37 @@
           "name": "author",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "Who wrote this piece."
         },
         {
           "name": "name",
           "type": "text",
           "required": true,
           "columnType": "TEXT",
-          "default": ""
+          "default": "",
+          "description": "A short name used to find this piece in lists."
         },
         {
           "name": "title",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "The headline readers see."
         },
         {
           "name": "description",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "A one or two sentence summary of the piece."
         },
         {
           "name": "body",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "The full text of the piece."
         },
         {
           "name": "bodyFormat",
@@ -4510,7 +4527,8 @@
           "name": "publish_date",
           "type": "datetime",
           "required": false,
-          "columnType": "TIMESTAMP"
+          "columnType": "TIMESTAMP",
+          "description": "The date the piece went out, or is due to go out."
         },
         {
           "name": "url",
@@ -4541,20 +4559,23 @@
           "type": "json",
           "required": false,
           "columnType": "JSON",
-          "default": []
+          "default": [],
+          "description": "Words that group pieces by subject."
         },
         {
           "name": "category",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "The one section the piece belongs to, such as news or local."
         },
         {
           "name": "status",
           "type": "text",
           "required": false,
           "columnType": "TEXT",
-          "default": "draft"
+          "default": "draft",
+          "description": "Where the piece stands: draft, in review, published or archived."
         },
         {
           "name": "state",
@@ -4582,42 +4603,48 @@
           "type": "integer",
           "required": false,
           "columnType": "INTEGER",
-          "default": 30
+          "default": 30,
+          "description": "How many frames of video play each second, usually 30."
         },
         {
           "name": "width",
           "type": "integer",
           "required": false,
           "columnType": "INTEGER",
-          "default": 1920
+          "default": 1920,
+          "description": "The width of the finished video in pixels, such as 1920."
         },
         {
           "name": "height",
           "type": "integer",
           "required": false,
           "columnType": "INTEGER",
-          "default": 1080
+          "default": 1080,
+          "description": "The height of the finished video in pixels, such as 1080."
         },
         {
           "name": "durationInFrames",
           "type": "integer",
           "required": false,
           "columnType": "INTEGER",
-          "default": 0
+          "default": 0,
+          "description": "How long the whole video runs, counted in frames. It adds up from the sequences."
         },
         {
           "name": "renderStatus",
           "type": "text",
           "required": false,
           "columnType": "TEXT",
-          "default": "draft"
+          "default": "draft",
+          "description": "Where the finished video stands: draft, rendering, ready or failed."
         },
         {
           "name": "renderProgress",
           "type": "integer",
           "required": false,
           "columnType": "INTEGER",
-          "default": 0
+          "default": 0,
+          "description": "How far along the render is, from 0 to 100."
         }
       ],
       "relationships": [
@@ -6908,7 +6935,8 @@
           "name": "type",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "What kind of piece this is, such as an article or a document."
         },
         {
           "name": "variant",
@@ -6926,32 +6954,37 @@
           "name": "author",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "Who wrote this piece."
         },
         {
           "name": "name",
           "type": "text",
           "required": true,
           "columnType": "TEXT",
-          "default": ""
+          "default": "",
+          "description": "A short name used to find this piece in lists."
         },
         {
           "name": "title",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "The headline readers see."
         },
         {
           "name": "description",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "A one or two sentence summary of the piece."
         },
         {
           "name": "body",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "The full text of the piece."
         },
         {
           "name": "bodyFormat",
@@ -6963,7 +6996,8 @@
           "name": "publish_date",
           "type": "datetime",
           "required": false,
-          "columnType": "TIMESTAMP"
+          "columnType": "TIMESTAMP",
+          "description": "The date the piece went out, or is due to go out."
         },
         {
           "name": "url",
@@ -6994,20 +7028,23 @@
           "type": "json",
           "required": false,
           "columnType": "JSON",
-          "default": []
+          "default": [],
+          "description": "Words that group pieces by subject."
         },
         {
           "name": "category",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "The one section the piece belongs to, such as news or local."
         },
         {
           "name": "status",
           "type": "text",
           "required": false,
           "columnType": "TEXT",
-          "default": "draft"
+          "default": "draft",
+          "description": "Where the piece stands: draft, in review, published or archived."
         },
         {
           "name": "state",
@@ -7035,35 +7072,40 @@
           "type": "foreignKey",
           "required": false,
           "related": "VideoComposition",
-          "columnType": "UUID"
+          "columnType": "UUID",
+          "description": "The video this sequence is part of."
         },
         {
           "name": "position",
           "type": "integer",
           "required": false,
           "columnType": "INTEGER",
-          "default": 0
+          "default": 0,
+          "description": "The order of this sequence within its video, counting from the start."
         },
         {
           "name": "durationInFrames",
           "type": "integer",
           "required": false,
           "columnType": "INTEGER",
-          "default": 0
+          "default": 0,
+          "description": "How long the sequence runs in frames. It adds up from its shots."
         },
         {
           "name": "transitionType",
           "type": "text",
           "required": false,
           "columnType": "TEXT",
-          "default": "none"
+          "default": "none",
+          "description": "How this sequence hands over to the next one: a straight cut, a fade, a slide or a wipe."
         },
         {
           "name": "transitionDurationFrames",
           "type": "integer",
           "required": false,
           "columnType": "INTEGER",
-          "default": 0
+          "default": 0,
+          "description": "How many frames the hand-over to the next sequence overlaps."
         }
       ],
       "relationships": [
@@ -9597,7 +9639,8 @@
           "name": "type",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "What kind of piece this is, such as an article or a document."
         },
         {
           "name": "variant",
@@ -9615,32 +9658,37 @@
           "name": "author",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "Who wrote this piece."
         },
         {
           "name": "name",
           "type": "text",
           "required": true,
           "columnType": "TEXT",
-          "default": ""
+          "default": "",
+          "description": "A short name used to find this piece in lists."
         },
         {
           "name": "title",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "The headline readers see."
         },
         {
           "name": "description",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "A one or two sentence summary of the piece."
         },
         {
           "name": "body",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "The full text of the piece."
         },
         {
           "name": "bodyFormat",
@@ -9652,7 +9700,8 @@
           "name": "publish_date",
           "type": "datetime",
           "required": false,
-          "columnType": "TIMESTAMP"
+          "columnType": "TIMESTAMP",
+          "description": "The date the piece went out, or is due to go out."
         },
         {
           "name": "url",
@@ -9683,20 +9732,23 @@
           "type": "json",
           "required": false,
           "columnType": "JSON",
-          "default": []
+          "default": [],
+          "description": "Words that group pieces by subject."
         },
         {
           "name": "category",
           "type": "text",
           "required": false,
-          "columnType": "TEXT"
+          "columnType": "TEXT",
+          "description": "The one section the piece belongs to, such as news or local."
         },
         {
           "name": "status",
           "type": "text",
           "required": false,
           "columnType": "TEXT",
-          "default": "draft"
+          "default": "draft",
+          "description": "Where the piece stands: draft, in review, published or archived."
         },
         {
           "name": "state",
@@ -9724,28 +9776,32 @@
           "type": "foreignKey",
           "required": false,
           "related": "VideoSequence",
-          "columnType": "UUID"
+          "columnType": "UUID",
+          "description": "The sequence this shot belongs to."
         },
         {
           "name": "sceneId",
           "type": "foreignKey",
           "required": false,
           "related": "Scene",
-          "columnType": "UUID"
+          "columnType": "UUID",
+          "description": "The background scene this shot is filmed in."
         },
         {
           "name": "position",
           "type": "integer",
           "required": false,
           "columnType": "INTEGER",
-          "default": 0
+          "default": 0,
+          "description": "The order of this shot within its sequence, counting from the start."
         },
         {
           "name": "durationInFrames",
           "type": "integer",
           "required": false,
           "columnType": "INTEGER",
-          "default": 0
+          "default": 0,
+          "description": "How long the finished clip runs in frames."
         },
         {
           "name": "trimBeforeFrames",
@@ -9766,7 +9822,8 @@
           "type": "text",
           "required": false,
           "columnType": "TEXT",
-          "default": ""
+          "default": "",
+          "description": "The words spoken in this shot."
         },
         {
           "name": "scriptWordCount",
@@ -9780,14 +9837,16 @@
           "type": "integer",
           "required": false,
           "columnType": "INTEGER",
-          "default": 30
+          "default": 30,
+          "description": "How long you want the shot to be, in seconds."
         },
         {
           "name": "shotStatus",
           "type": "text",
           "required": false,
           "columnType": "TEXT",
-          "default": "draft"
+          "default": "draft",
+          "description": "Where the shot stands: draft, queued, processing, ready, failed or published."
         },
         {
           "name": "progress",
@@ -14849,7 +14908,515 @@
     "polymorphicAssociations": 0,
     "uuidColumns": 189
   },
-  "agentDoc": "# @happyvertical/smrt-video\n\nAI video production pipeline: characters, performers, scenes, shots, sequences, compositions, and ComfyUI workflow integration.\n\n## Models\n\n- **Character** (renamed from PersonalityProfile): visual + voice identity. `imageAssetId`, `voiceProfileId` FK, branding config (logo, colors, fonts, lower-thirds). Scene-specific position/scale configs.\n- **Performer**: physical likeness for IP-Adapter FaceID. `faceEmbedding` (512-dim), `referenceAssetIds`, `ipAdapterWeight`.\n- **Scene**: virtual background. `sourceType` (image/video/panorama_360/panorama_180), `projection`, `viewpoints` array (pan/tilt/fov), `lightingProfile`, `anchorPoints`.\n- **VideoShot** (extends Content): atomic generation unit. `durationInFrames`, `scriptText`, `scriptWordCount`. Estimated duration: `scriptWordCount / 2.7` words/sec (±15% tolerance). `videoMetadata` includes `wordTimings` for lip-sync.\n- **VideoSequence** (extends Content): thematic section with `transitionType` (none/fade/slide/wipe), position ordering.\n- **VideoComposition** (extends Content): top-level container — `fps`, `width`, `height`, `durationInFrames`, `renderStatus`/`renderProgress`.\n- **VideoShotCharacter**: junction (shot ↔ character) with role (primary/secondary/background), position, duration.\n- **VideoWorkflow**: ComfyUI template. `workflowJson`, `nodeMapping` (maps semantic names → node IDs), `workflowType` (prebake/broadcast/lipsync/postprod/custom). `injectParameters()` deep-clones workflow + overwrites `node.inputs`.\n\n## Design Principles\n\n- **Store frames, compute seconds**: `durationInFrames` everywhere; seconds = frames / fps\n- **Content inheritance**: VideoShot, VideoSequence, VideoComposition all extend Content from smrt-content\n- **Hierarchy**: Composition → Sequence → Shot → ShotCharacter\n- **Owned asset normalization**: `CharacterOwnedAsset`, `PerformerOwnedAsset`, and `SceneOwnedAsset` are canonical noun joins; `VideoShot`/`VideoSequence`/`VideoComposition` use inherited `content_assets`\n\n## Gotchas\n\n- **PersonalityProfile → Character rename**: old name still exported for backwards compatibility\n- **Legacy video STI asset rows**: reads still union canonical joins with legacy STI asset records during migration, but new writes go through the model helpers / join tables\n- **Schema rollout**: run `smrt db:migrate` before relying on `character_assets` / `performer_assets` / `scene_assets` writes; reads still tolerate those tables being absent during migration\n- **ComfyUI injectParameters()**: assumes `node.inputs` exists; warnings logged in dev mode\n- **Frame arithmetic**: `trimBeforeFrames`/`trimAfterFrames` require manual effective frame calculation\n- **Word timings from external TTS**: `wordTimings` array not generated by framework — requires external provider\n- **IP-Adapter weights**: `faceEmbedding` upload not handled; weight is metadata-only (0.5-1.0)\n- **Optional tenancy** on all core models\n",
+  "agentDoc": "# @happyvertical/smrt-video\n\nAI video production pipeline: characters, performers, scenes, shots, sequences, compositions, and ComfyUI workflow integration.\n\n## Models\n\n- **Character** (renamed from PersonalityProfile): visual + voice identity. `imageAssetId`, `voiceProfileId` FK, branding config (logo, colors, fonts, lower-thirds). Scene-specific position/scale configs.\n- **Performer**: physical likeness for IP-Adapter FaceID. `faceEmbedding` (512-dim), `referenceAssetIds`, `ipAdapterWeight`.\n- **Scene**: virtual background. `sourceType` (image/video/panorama_360/panorama_180), `projection`, `viewpoints` array (pan/tilt/fov), `lightingProfile`, `anchorPoints`.\n- **VideoShot** (extends Content): atomic generation unit. `durationInFrames`, `scriptText`, `scriptWordCount`. Estimated duration: `scriptWordCount / 2.7` words/sec (±15% tolerance). `videoMetadata` includes `wordTimings` for lip-sync.\n- **VideoSequence** (extends Content): thematic section with `transitionType` (none/fade/slide/wipe), position ordering.\n- **VideoComposition** (extends Content): top-level container — `fps`, `width`, `height`, `durationInFrames`, `renderStatus`/`renderProgress`.\n- **VideoShotCharacter**: junction (shot ↔ character) with role (primary/secondary/background), position, duration.\n- **VideoWorkflow**: ComfyUI template. `workflowJson`, `nodeMapping` (maps semantic names → node IDs), `workflowType` (prebake/broadcast/lipsync/postprod/custom). `injectParameters()` deep-clones workflow + overwrites `node.inputs`.\n- **Recipe `video.library`** (`src/recipes.ts`, help in `src/library.recipe.md`): lists videos, sequences, shots, characters and scenes for the planner and other catalog hosts. Fields it shows carry `@field({ description })` in plain words; keep them when editing the models. Performer, VideoWorkflow, CompositeJob and the owned-asset joins are left out on purpose.\n\n## Design Principles\n\n- **Store frames, compute seconds**: `durationInFrames` everywhere; seconds = frames / fps\n- **Content inheritance**: VideoShot, VideoSequence, VideoComposition all extend Content from smrt-content\n- **Hierarchy**: Composition → Sequence → Shot → ShotCharacter\n- **Owned asset normalization**: `CharacterOwnedAsset`, `PerformerOwnedAsset`, and `SceneOwnedAsset` are canonical noun joins; `VideoShot`/`VideoSequence`/`VideoComposition` use inherited `content_assets`\n\n## Gotchas\n\n- **PersonalityProfile → Character rename**: old name still exported for backwards compatibility\n- **Legacy video STI asset rows**: reads still union canonical joins with legacy STI asset records during migration, but new writes go through the model helpers / join tables\n- **Schema rollout**: run `smrt db:migrate` before relying on `character_assets` / `performer_assets` / `scene_assets` writes; reads still tolerate those tables being absent during migration\n- **ComfyUI injectParameters()**: assumes `node.inputs` exists; warnings logged in dev mode\n- **Frame arithmetic**: `trimBeforeFrames`/`trimAfterFrames` require manual effective frame calculation\n- **Word timings from external TTS**: `wordTimings` array not generated by framework — requires external provider\n- **IP-Adapter weights**: `faceEmbedding` upload not handled; weight is metadata-only (0.5-1.0)\n- **Optional tenancy** on all core models\n",
+  "recipes": [
+    {
+      "id": "video.library",
+      "className": "VideoLibraryRecipe",
+      "label": "Video",
+      "summary": "Plan each video as sequences and shots, with the characters and scenes that appear in it.",
+      "synonyms": [
+        "videos",
+        "video production",
+        "video scripts",
+        "shots",
+        "storyboard",
+        "characters and scenes"
+      ],
+      "models": [
+        "@happyvertical/smrt-video:VideoComposition",
+        "@happyvertical/smrt-video:VideoSequence",
+        "@happyvertical/smrt-video:VideoShot",
+        "@happyvertical/smrt-video:Character",
+        "@happyvertical/smrt-video:Scene"
+      ],
+      "nav": [
+        {
+          "label": "Videos",
+          "model": "@happyvertical/smrt-video:VideoComposition",
+          "icon": "layers",
+          "description": "Each finished video you are putting together.",
+          "noun": "video"
+        },
+        {
+          "label": "Sequences",
+          "model": "@happyvertical/smrt-video:VideoSequence",
+          "icon": "folder",
+          "description": "The parts of a video, in the order they play.",
+          "noun": "sequence"
+        },
+        {
+          "label": "Shots",
+          "model": "@happyvertical/smrt-video:VideoShot",
+          "icon": "fileText",
+          "description": "Each clip in a sequence, with the words spoken in it.",
+          "noun": "shot"
+        },
+        {
+          "label": "Characters",
+          "model": "@happyvertical/smrt-video:Character",
+          "icon": "users",
+          "description": "The on-screen presenters, with their look and voice.",
+          "noun": "character"
+        },
+        {
+          "label": "Scenes",
+          "model": "@happyvertical/smrt-video:Scene",
+          "icon": "home",
+          "description": "The backgrounds your characters appear in front of.",
+          "noun": "scene"
+        }
+      ],
+      "requires": [],
+      "section": {
+        "id": "publish",
+        "label": "Publish",
+        "icon": "fileText",
+        "description": "What you write, record and put out."
+      },
+      "options": {
+        "@happyvertical/smrt-video:VideoComposition": {
+          "fields": {
+            "name": {
+              "order": 1
+            },
+            "description": {
+              "order": 2
+            },
+            "fps": {
+              "label": "Frames per second",
+              "order": 3
+            },
+            "width": {
+              "order": 4
+            },
+            "height": {
+              "order": 5
+            },
+            "durationInFrames": {
+              "label": "Length in frames",
+              "order": 6
+            },
+            "renderStatus": {
+              "label": "Render status",
+              "order": 7
+            },
+            "renderProgress": {
+              "label": "Render progress",
+              "order": 8
+            },
+            "title": {
+              "visibility": "advanced"
+            },
+            "body": {
+              "label": "Notes",
+              "visibility": "advanced"
+            },
+            "author": {
+              "visibility": "advanced"
+            },
+            "publish_date": {
+              "label": "Publish date",
+              "visibility": "advanced"
+            },
+            "url": {
+              "label": "Web address",
+              "visibility": "advanced"
+            },
+            "language": {
+              "visibility": "advanced"
+            },
+            "tags": {
+              "visibility": "advanced"
+            },
+            "category": {
+              "visibility": "advanced"
+            },
+            "status": {
+              "label": "Publishing status",
+              "visibility": "advanced"
+            },
+            "thumbnailAssetId": {
+              "label": "Thumbnail",
+              "visibility": "advanced"
+            },
+            "tenantId": {
+              "visibility": "hidden"
+            },
+            "type": {
+              "visibility": "hidden"
+            },
+            "variant": {
+              "visibility": "hidden"
+            },
+            "fileKey": {
+              "visibility": "hidden"
+            },
+            "bodyFormat": {
+              "visibility": "hidden"
+            },
+            "source": {
+              "visibility": "hidden"
+            },
+            "original_url": {
+              "visibility": "hidden"
+            },
+            "state": {
+              "visibility": "hidden"
+            },
+            "metadata": {
+              "visibility": "hidden"
+            }
+          }
+        },
+        "@happyvertical/smrt-video:VideoSequence": {
+          "fields": {
+            "name": {
+              "order": 1
+            },
+            "compositionId": {
+              "label": "Video",
+              "order": 2
+            },
+            "position": {
+              "label": "Order",
+              "order": 3
+            },
+            "description": {
+              "order": 4
+            },
+            "durationInFrames": {
+              "label": "Length in frames",
+              "order": 5
+            },
+            "transitionType": {
+              "label": "Transition to next",
+              "order": 6
+            },
+            "transitionDurationFrames": {
+              "label": "Transition length in frames",
+              "visibility": "advanced"
+            },
+            "title": {
+              "visibility": "advanced"
+            },
+            "body": {
+              "label": "Notes",
+              "visibility": "advanced"
+            },
+            "author": {
+              "visibility": "advanced"
+            },
+            "publish_date": {
+              "label": "Publish date",
+              "visibility": "advanced"
+            },
+            "url": {
+              "label": "Web address",
+              "visibility": "advanced"
+            },
+            "language": {
+              "visibility": "advanced"
+            },
+            "tags": {
+              "visibility": "advanced"
+            },
+            "category": {
+              "visibility": "advanced"
+            },
+            "status": {
+              "label": "Publishing status",
+              "visibility": "advanced"
+            },
+            "thumbnailAssetId": {
+              "label": "Thumbnail",
+              "visibility": "advanced"
+            },
+            "tenantId": {
+              "visibility": "hidden"
+            },
+            "type": {
+              "visibility": "hidden"
+            },
+            "variant": {
+              "visibility": "hidden"
+            },
+            "fileKey": {
+              "visibility": "hidden"
+            },
+            "bodyFormat": {
+              "visibility": "hidden"
+            },
+            "source": {
+              "visibility": "hidden"
+            },
+            "original_url": {
+              "visibility": "hidden"
+            },
+            "state": {
+              "visibility": "hidden"
+            },
+            "metadata": {
+              "visibility": "hidden"
+            }
+          }
+        },
+        "@happyvertical/smrt-video:VideoShot": {
+          "fields": {
+            "name": {
+              "order": 1
+            },
+            "sequenceId": {
+              "label": "Sequence",
+              "order": 2
+            },
+            "position": {
+              "label": "Order",
+              "order": 3
+            },
+            "scriptText": {
+              "label": "Script",
+              "order": 4
+            },
+            "sceneId": {
+              "label": "Scene",
+              "order": 5
+            },
+            "targetDuration": {
+              "label": "Target length in seconds",
+              "order": 6
+            },
+            "durationInFrames": {
+              "label": "Length in frames",
+              "order": 7
+            },
+            "shotStatus": {
+              "label": "Status",
+              "order": 8
+            },
+            "description": {
+              "visibility": "advanced"
+            },
+            "progress": {
+              "visibility": "advanced"
+            },
+            "statusMessage": {
+              "label": "Status message",
+              "visibility": "advanced"
+            },
+            "errorMessage": {
+              "label": "Error message",
+              "visibility": "advanced"
+            },
+            "scriptWordCount": {
+              "label": "Words in script",
+              "visibility": "advanced"
+            },
+            "trimBeforeFrames": {
+              "label": "Trim from start in frames",
+              "visibility": "advanced"
+            },
+            "trimAfterFrames": {
+              "label": "Trim from end in frames",
+              "visibility": "advanced"
+            },
+            "videoMetadata": {
+              "visibility": "hidden"
+            },
+            "title": {
+              "visibility": "advanced"
+            },
+            "body": {
+              "label": "Notes",
+              "visibility": "advanced"
+            },
+            "author": {
+              "visibility": "advanced"
+            },
+            "publish_date": {
+              "label": "Publish date",
+              "visibility": "advanced"
+            },
+            "url": {
+              "label": "Web address",
+              "visibility": "advanced"
+            },
+            "language": {
+              "visibility": "advanced"
+            },
+            "tags": {
+              "visibility": "advanced"
+            },
+            "category": {
+              "visibility": "advanced"
+            },
+            "status": {
+              "label": "Publishing status",
+              "visibility": "advanced"
+            },
+            "thumbnailAssetId": {
+              "label": "Thumbnail",
+              "visibility": "advanced"
+            },
+            "tenantId": {
+              "visibility": "hidden"
+            },
+            "type": {
+              "visibility": "hidden"
+            },
+            "variant": {
+              "visibility": "hidden"
+            },
+            "fileKey": {
+              "visibility": "hidden"
+            },
+            "bodyFormat": {
+              "visibility": "hidden"
+            },
+            "source": {
+              "visibility": "hidden"
+            },
+            "original_url": {
+              "visibility": "hidden"
+            },
+            "state": {
+              "visibility": "hidden"
+            },
+            "metadata": {
+              "visibility": "hidden"
+            }
+          }
+        },
+        "@happyvertical/smrt-video:Character": {
+          "fields": {
+            "name": {
+              "order": 1
+            },
+            "description": {
+              "order": 2
+            },
+            "imageAssetId": {
+              "label": "Picture",
+              "order": 3
+            },
+            "voiceProfileId": {
+              "label": "Voice",
+              "order": 4
+            },
+            "defaultSceneId": {
+              "label": "Usual scene",
+              "order": 5
+            },
+            "status": {
+              "order": 6
+            },
+            "performerId": {
+              "label": "Performer",
+              "visibility": "advanced"
+            },
+            "baseMotionAssetId": {
+              "label": "Base motion video",
+              "visibility": "advanced"
+            },
+            "profileId": {
+              "label": "Profile",
+              "visibility": "advanced"
+            },
+            "brandingKit": {
+              "visibility": "hidden"
+            },
+            "sceneConfigs": {
+              "visibility": "hidden"
+            },
+            "tenantId": {
+              "visibility": "hidden"
+            }
+          }
+        },
+        "@happyvertical/smrt-video:Scene": {
+          "fields": {
+            "name": {
+              "order": 1
+            },
+            "description": {
+              "order": 2
+            },
+            "sourceType": {
+              "label": "Kind of background",
+              "order": 3
+            },
+            "sourceAssetId": {
+              "label": "Background picture or video",
+              "order": 4
+            },
+            "status": {
+              "order": 5
+            },
+            "projection": {
+              "visibility": "advanced"
+            },
+            "location": {
+              "visibility": "hidden"
+            },
+            "viewpoints": {
+              "visibility": "hidden"
+            },
+            "lightingProfile": {
+              "visibility": "hidden"
+            },
+            "anchorPoints": {
+              "visibility": "hidden"
+            },
+            "tenantId": {
+              "visibility": "hidden"
+            }
+          }
+        }
+      },
+      "help": {
+        "markdown": "## Overview\n\nVideo is where you plan a video before it is made. A video is built from\nsequences, the parts that play one after another, and each sequence is built\nfrom shots, the single clips with the words spoken in them. Characters are the\npresenters who appear on screen, each with a picture and a voice, and scenes\nare the backgrounds they stand in front of.\n\nYou write and arrange everything here. Making the clips and putting the\nfinished video together is done by a rendering service, so the screens show\nwhere each shot and video stands rather than letting you set that by hand.\n\n## Tasks\n\n### Start a new video\n\n1. Open the list of videos and choose **New**.\n2. Give it a **{field:VideoComposition.name}** and a short **{field:VideoComposition.description}**.\n3. Set the **{field:VideoComposition.fps}** and the picture size with **{field:VideoComposition.width}** and **{field:VideoComposition.height}**.\n4. Save. The **{field:VideoComposition.durationInFrames}** fills in as you add sequences, and **{field:VideoComposition.renderStatus}** shows whether the finished video is still a draft, being rendered, ready or failed.\n\n### Break a video into sequences\n\n1. Open the list of sequences and choose **New**.\n2. Give the sequence a **{field:VideoSequence.name}** and pick the **{field:VideoSequence.compositionId}** it belongs to.\n3. Set the **{field:VideoSequence.position}** so the sequences play in the order you want.\n4. Choose a **{field:VideoSequence.transitionType}** if you want a fade, slide or wipe into the next sequence instead of a straight cut.\n5. Save. The **{field:VideoSequence.durationInFrames}** adds up from the shots you put in it.\n\n### Write a shot\n\n1. Open the list of shots and choose **New**.\n2. Give the shot a **{field:VideoShot.name}**, then pick the **{field:VideoShot.sequenceId}** it belongs to and its **{field:VideoShot.position}** within it.\n3. Type the words to be spoken in **{field:VideoShot.scriptText}**.\n4. Pick the **{field:VideoShot.sceneId}** the shot is filmed in.\n5. Set the **{field:VideoShot.targetDuration}** you are aiming for. Roughly two to three words fill a second.\n6. Save. Once the clip is made, **{field:VideoShot.durationInFrames}** shows its real length and **{field:VideoShot.shotStatus}** shows where it stands.\n\n### Change or remove a shot\n\n1. Open the shot from the list of shots.\n2. Edit the **{field:VideoShot.scriptText}** or any other detail and save. Edit a sequence or a video the same way.\n3. To take a shot out, remove it. Removing a sequence or a video is done from its own list.\n\n### Add a character\n\n1. Open the list of characters and choose **New**.\n2. Give the character a **{field:Character.name}** and describe them in **{field:Character.description}**.\n3. Choose the **{field:Character.imageAssetId}** they are built from and the **{field:Character.voiceProfileId}** they speak with.\n4. Pick the **{field:Character.defaultSceneId}** they usually appear in.\n5. Save. **{field:Character.status}** shows when the character is ready to use in shots.\n\n### Add a scene\n\n1. Open the list of scenes and choose **New**.\n2. Give the scene a **{field:Scene.name}** and say what it shows in **{field:Scene.description}**.\n3. Choose the **{field:Scene.sourceType}** and pick the **{field:Scene.sourceAssetId}** it is made from.\n4. Save. **{field:Scene.status}** shows when the scene is ready to be used in shots.\n",
+        "fieldRefs": [
+          "Character.defaultSceneId",
+          "Character.description",
+          "Character.imageAssetId",
+          "Character.name",
+          "Character.status",
+          "Character.voiceProfileId",
+          "Scene.description",
+          "Scene.name",
+          "Scene.sourceAssetId",
+          "Scene.sourceType",
+          "Scene.status",
+          "VideoComposition.description",
+          "VideoComposition.durationInFrames",
+          "VideoComposition.fps",
+          "VideoComposition.height",
+          "VideoComposition.name",
+          "VideoComposition.renderStatus",
+          "VideoComposition.width",
+          "VideoSequence.compositionId",
+          "VideoSequence.durationInFrames",
+          "VideoSequence.name",
+          "VideoSequence.position",
+          "VideoSequence.transitionType",
+          "VideoShot.durationInFrames",
+          "VideoShot.name",
+          "VideoShot.position",
+          "VideoShot.sceneId",
+          "VideoShot.scriptText",
+          "VideoShot.sequenceId",
+          "VideoShot.shotStatus",
+          "VideoShot.targetDuration"
+        ]
+      },
+      "demo": {
+        "mode": "server",
+        "reasons": [
+          "Needs a server because its package does not build for a browser: documents/spider SDK graph; CJS parse error; and its package depends on @happyvertical/smrt-agents, @happyvertical/smrt-chat, @happyvertical/smrt-content, @happyvertical/smrt-images, @happyvertical/smrt-jobs, @happyvertical/smrt-profiles, @happyvertical/smrt-reports, @happyvertical/smrt-secrets, @happyvertical/smrt-tenancy, @happyvertical/smrt-users, @happyvertical/smrt-voice, which do not build for a browser (#3615, #3617, #3624, #3625, #3626, #3627, #3628)."
+        ]
+      }
+    }
+  ],
   "browser": {
     "status": "server-only",
     "issues": [