@indreamai/openclaw-plugin 0.1.0

package/skills/indream-editor-json/references/templates/subtitle-promo.json

@@ -0,0 +1,341 @@
+{
+  "compositionWidth": 1080,
+  "compositionHeight": 1920,
+  "timebaseTicksPerSecond": 240000,
+  "outputRatio": "9:16",
+  "tracks": [
+    {
+      "id": "track-media",
+      "hidden": false,
+      "muted": false,
+      "items": [
+        "item-bg-image"
+      ]
+    },
+    {
+      "id": "track-copy",
+      "hidden": false,
+      "muted": false,
+      "items": [
+        "item-title",
+        "item-cta"
+      ]
+    },
+    {
+      "id": "track-captions",
+      "hidden": false,
+      "muted": false,
+      "items": [
+        "item-captions"
+      ]
+    }
+  ],
+  "assets": {
+    "asset-bg-image": {
+      "id": "asset-bg-image",
+      "type": "image",
+      "filename": "vertical-bg.png",
+      "size": 0,
+      "remoteUrl": "https://r.indream.ai/system/presets/154c197a-92c3-4bef-8560-4b9b70688a57.png",
+      "remoteKey": null,
+      "mimeType": "image/png",
+      "width": 1024,
+      "height": 1024
+    },
+    "asset-captions": {
+      "id": "asset-captions",
+      "type": "caption",
+      "filename": "asset-captions.json",
+      "size": 0,
+      "remoteUrl": null,
+      "remoteKey": null,
+      "mimeType": "application/json",
+      "timingGranularity": "line",
+      "captions": [
+        {
+          "text": "Build faster scenes.",
+          "startMs": 0,
+          "endMs": 900
+        },
+        {
+          "text": "Validate before export.",
+          "startMs": 900,
+          "endMs": 2100
+        },
+        {
+          "text": "Keep subtitle timing readable.",
+          "startMs": 2100,
+          "endMs": 3300
+        },
+        {
+          "text": "Ship a clean final render.",
+          "startMs": 3300,
+          "endMs": 4500
+        }
+      ]
+    }
+  },
+  "items": {
+    "item-bg-image": {
+      "id": "item-bg-image",
+      "type": "image",
+      "startTicks": 0,
+      "durationTicks": 1200000,
+      "top": {
+        "value": 0,
+        "keyframes": []
+      },
+      "left": {
+        "value": 0,
+        "keyframes": []
+      },
+      "width": {
+        "value": 1080,
+        "keyframes": []
+      },
+      "height": {
+        "value": 1920,
+        "keyframes": []
+      },
+      "scaleX": {
+        "value": 1,
+        "keyframes": []
+      },
+      "scaleY": {
+        "value": 1,
+        "keyframes": []
+      },
+      "opacity": {
+        "value": 1,
+        "keyframes": []
+      },
+      "isDraggingInTimeline": false,
+      "assetId": "asset-bg-image",
+      "keepAspectRatio": true,
+      "borderRadius": {
+        "value": 0,
+        "keyframes": []
+      },
+      "rotation": {
+        "value": 0,
+        "keyframes": []
+      },
+      "cropLeft": {
+        "value": 0,
+        "keyframes": []
+      },
+      "cropTop": {
+        "value": 0,
+        "keyframes": []
+      },
+      "cropRight": {
+        "value": 0,
+        "keyframes": []
+      },
+      "cropBottom": {
+        "value": 0,
+        "keyframes": []
+      }
+    },
+    "item-title": {
+      "id": "item-title",
+      "type": "text",
+      "startTicks": 0,
+      "durationTicks": 336000,
+      "top": {
+        "value": 120,
+        "keyframes": []
+      },
+      "left": {
+        "value": 88,
+        "keyframes": []
+      },
+      "width": {
+        "value": 904,
+        "keyframes": []
+      },
+      "height": {
+        "value": 180,
+        "keyframes": []
+      },
+      "scaleX": {
+        "value": 1,
+        "keyframes": []
+      },
+      "scaleY": {
+        "value": 1,
+        "keyframes": []
+      },
+      "opacity": {
+        "value": 1,
+        "keyframes": []
+      },
+      "isDraggingInTimeline": false,
+      "text": "Subtitle Promo",
+      "color": "#ffffff",
+      "align": "center",
+      "fontFamily": "TikTok Sans",
+      "fontStyle": {
+        "variant": "normal",
+        "weight": "700"
+      },
+      "fontSize": 84,
+      "lineHeight": 1.1,
+      "letterSpacing": 0,
+      "resizeOnEdit": true,
+      "direction": "ltr",
+      "strokeWidth": 0,
+      "strokeColor": "#000000",
+      "background": null,
+      "rotation": {
+        "value": 0,
+        "keyframes": []
+      },
+      "animations": {
+        "in": {
+          "type": "slide-up",
+          "durationTicks": 80000,
+          "easing": "ease-out"
+        }
+      }
+    },
+    "item-cta": {
+      "id": "item-cta",
+      "type": "text",
+      "startTicks": 816000,
+      "durationTicks": 384000,
+      "top": {
+        "value": 1650,
+        "keyframes": []
+      },
+      "left": {
+        "value": 110,
+        "keyframes": []
+      },
+      "width": {
+        "value": 860,
+        "keyframes": []
+      },
+      "height": {
+        "value": 110,
+        "keyframes": []
+      },
+      "scaleX": {
+        "value": 1,
+        "keyframes": []
+      },
+      "scaleY": {
+        "value": 1,
+        "keyframes": []
+      },
+      "opacity": {
+        "value": 1,
+        "keyframes": []
+      },
+      "isDraggingInTimeline": false,
+      "text": "Use line-timed captions when subtitle animations are needed.",
+      "color": "#f8fafc",
+      "align": "center",
+      "fontFamily": "TikTok Sans",
+      "fontStyle": {
+        "variant": "normal",
+        "weight": "500"
+      },
+      "fontSize": 28,
+      "lineHeight": 1.1,
+      "letterSpacing": 0,
+      "resizeOnEdit": true,
+      "direction": "ltr",
+      "strokeWidth": 0,
+      "strokeColor": "#000000",
+      "background": {
+        "color": "#00000088",
+        "horizontalPadding": 20,
+        "borderRadius": 28
+      },
+      "rotation": {
+        "value": 0,
+        "keyframes": []
+      }
+    },
+    "item-captions": {
+      "id": "item-captions",
+      "type": "captions",
+      "startTicks": 96000,
+      "durationTicks": 1104000,
+      "top": {
+        "value": 1320,
+        "keyframes": []
+      },
+      "left": {
+        "value": 120,
+        "keyframes": []
+      },
+      "width": {
+        "value": 840,
+        "keyframes": []
+      },
+      "height": {
+        "value": 220,
+        "keyframes": []
+      },
+      "scaleX": {
+        "value": 1,
+        "keyframes": []
+      },
+      "scaleY": {
+        "value": 1,
+        "keyframes": []
+      },
+      "opacity": {
+        "value": 1,
+        "keyframes": []
+      },
+      "isDraggingInTimeline": false,
+      "assetId": "asset-captions",
+      "fontFamily": "TikTok Sans",
+      "fontStyle": {
+        "variant": "normal",
+        "weight": "600"
+      },
+      "lineHeight": 1.2,
+      "letterSpacing": 0,
+      "fontSize": 80,
+      "align": "center",
+      "color": "#ffffff",
+      "highlightColor": "#39E508",
+      "strokeWidth": 4,
+      "strokeColor": "#000000",
+      "direction": "ltr",
+      "pageDurationInMilliseconds": 2000,
+      "captionStartInSeconds": 0,
+      "maxLines": 2,
+      "source": "manual",
+      "captionGroupId": "caption-group-1",
+      "background": null,
+      "rotation": {
+        "value": 0,
+        "keyframes": []
+      },
+      "animations": {
+        "in": {
+          "type": "fade",
+          "durationTicks": 48000,
+          "easing": "ease-out"
+        }
+      },
+      "captionAnimations": {
+        "in": {
+          "type": "converge",
+          "durationTicks": 48000
+        }
+      }
+    }
+  },
+  "transitions": {},
+  "globalBackground": {
+    "type": "color",
+    "color": "#020617",
+    "gradient": "linear-gradient(135deg, #020617 0%, #1d4ed8 100%)"
+  }
+}

package/skills/indream-editor-json/references/text-and-captions.md

@@ -0,0 +1,211 @@
+# Text, Captions, and Templates
+
+## Text item
+
+Use `text` for normal titles, lower thirds, bullet callouts, labels, quote cards, and simple animated copy.
+
+Required fields:
+
+- `type: "text"`
+- `text`
+- `color`
+- `align`
+- `fontFamily`
+- `fontStyle`
+- `fontSize`
+- `lineHeight`
+- `letterSpacing`
+- `resizeOnEdit`
+- `direction`
+- `strokeWidth`
+- `strokeColor`
+- full base geometry fields
+
+Common optional fields:
+
+- `background`
+- `rotation`
+- `animations`
+- `captionAnimations`
+
+Practical defaults:
+
+- `align`: `left` for blocks of copy, `center` for hero text
+- `direction`: `ltr` unless the content is actually right-to-left
+- `resizeOnEdit`: `true` for editable text overlays
+- `strokeWidth`: `0` unless the user asked for outline text
+- `background`: `null` unless the text needs a pill, chip, or readable subtitle box
+
+## Caption animation support on text
+
+Text items can use subtitle-style animation types through `captionAnimations`.
+Supported schema values:
+
+- `converge`
+- `elastic-pop`
+- `typewriter`
+- `lay-down`
+- `center-type-out`
+- `curtain-close`
+- `jitter`
+- `rainbow`
+- `sweep-shine`
+
+Use them when the user wants:
+
+- kinetic lyric text
+- punchy social captions
+- animated slogans
+- text-only subtitle effects
+
+Avoid stacking too many different caption animation types in one short clip unless the user clearly wants a flashy style.
+
+## Captions item
+
+Use `captions` when the user has a real subtitle asset and wants timed subtitle playback.
+
+Required fields:
+
+- `type: "captions"`
+- `assetId`
+- `fontFamily`
+- `fontStyle`
+- `lineHeight`
+- `letterSpacing`
+- `fontSize`
+- `align`
+- `color`
+- `highlightColor`
+- `strokeWidth`
+- `strokeColor`
+- `direction`
+- `pageDurationInMilliseconds`
+- `captionStartInSeconds`
+- `maxLines`
+- `source`
+- `captionGroupId`
+- `background`
+- full base geometry fields
+
+Important subtitle rules:
+
+- `source` must be one of `manual`, `auto`, or `upload`.
+- `captionGroupId` can be `null`.
+- `background` can be `null` or an object with:
+  - `color`
+  - `horizontalPadding`
+  - `borderRadius`
+- `captionAnimations` is not allowed when the linked caption asset uses `timingGranularity: "word"`.
+  If the user wants subtitle animation, prefer `timingGranularity: "line"` for the caption asset.
+- For production authoring, start with one short `captionAnimations.in` on `captions` items and add more layers only after a real export probe.
+  Dense combinations can validate but still be a worse default for renderer stability.
+
+Practical guidance:
+
+- Use `captions` for real subtitle timing.
+- Use `text` for static or manually timed overlay copy.
+- Use `highlightColor` only when the subtitle style calls for word or phrase emphasis.
+- Keep `pageDurationInMilliseconds` aligned with the intended subtitle pagination behavior.
+- Make sure the `captions` item duration fully covers the subtitle asset timing window after applying `captionStartInSeconds`.
+  A validation pass may still succeed when the subtitle data slightly overruns the clip, but real export can fail at render time.
+
+## Caption asset and captions item pairing
+
+The clean subtitle workflow is:
+
+1. store subtitle timing data in a `caption` asset under `assets`
+2. reference that asset from a `captions` item
+3. style the `captions` item for readability and animation
+
+This is better than manually creating one text item per subtitle line unless the user explicitly wants handcrafted timing.
+
+## Text-template item
+
+Use `text-template` only when you have a real template contract.
+
+Required fields:
+
+- `type: "text-template"`
+- `schemaVersion: 2`
+- `templateId`
+- `templateCategory`
+- `nodes`
+- full base geometry fields
+
+Notes:
+
+- `nodes` must contain at least two entries.
+- Each node must have a `type` of `image` or `text`.
+- The schema keeps nodes intentionally flexible, but that does not mean you should invent arbitrary template contracts.
+
+When to avoid `text-template`:
+
+- the request is just "make a bold title card"
+- the template ID is unknown
+- the node structure is not supplied by a product system
+- the same result can be achieved with normal `text`, `image`, and `solid` items
+
+## Subtitle styling patterns
+
+### Clean spoken subtitles
+
+Use:
+
+- medium or semibold weight
+- centered alignment
+- modest background pill or dark translucent box
+- minimal outline
+- one gentle caption animation or none
+
+### Emphasized social captions
+
+Use:
+
+- larger font size
+- stronger highlight color
+- short `captionAnimations.in`
+- optional extra motion only after a real export check confirms the composition is stable
+
+### Title-card text
+
+Use:
+
+- `text` item, not `captions`
+- optional `captionAnimations` for headline motion
+- optional `animations` for clip-level entry and exit
+
+## Text snippet
+
+```json
+{
+  "id": "item-title-1",
+  "type": "text",
+  "text": "Launch title",
+  "color": "#ffffff",
+  "align": "center",
+  "fontFamily": "TikTok Sans",
+  "fontStyle": {
+    "variant": "normal",
+    "weight": "600"
+  },
+  "fontSize": 72,
+  "lineHeight": 1.1,
+  "letterSpacing": 0,
+  "resizeOnEdit": true,
+  "direction": "ltr",
+  "strokeWidth": 0,
+  "strokeColor": "#000000",
+  "background": null,
+  "rotation": { "value": 0, "keyframes": [] },
+  "startTicks": 0,
+  "durationTicks": 120,
+  "top": { "value": 160, "keyframes": [] },
+  "left": { "value": 160, "keyframes": [] },
+  "width": { "value": 960, "keyframes": [] },
+  "height": { "value": 240, "keyframes": [] },
+  "scaleX": { "value": 1, "keyframes": [] },
+  "scaleY": { "value": 1, "keyframes": [] },
+  "opacity": { "value": 1, "keyframes": [] },
+  "isDraggingInTimeline": false
+}
+```

package/skills/indream-editor-json/references/validation-repair.md

@@ -0,0 +1,134 @@
+# Validation and Repair Guide
+
+## Repair priorities
+
+1. Preserve the user's intent.
+2. Change the minimum number of fields needed to satisfy validation.
+3. Prefer supported replacements over deleting creative features.
+4. Validate again after each meaningful repair pass.
+5. Do not export until validation returns `valid: true`.
+
+## Common failures
+
+### Unsupported effect value
+
+Symptoms:
+
+- `EDITOR_EFFECT_TYPE_INVALID`
+- validation path points at `items.*.effectType`
+
+Fix:
+
+- call `indream_editor_capabilities`
+- replace the invalid value with a supported effect type
+- preserve the original timing window unless the user asked to remove the effect
+
+### Unsupported filter value
+
+Symptoms:
+
+- `EDITOR_FILTER_TYPE_INVALID`
+- validation path points at `items.*.filterType`
+
+Fix:
+
+- call `indream_editor_capabilities`
+- replace the invalid value with a supported filter type
+- preserve `intensity` and any valid `params`
+
+### Unsupported transition
+
+Symptoms:
+
+- `EDITOR_TRANSITION_TYPE_INVALID`
+- validation path points at `transitions.*.type`
+
+Fix:
+
+- replace the transition type with a capability-supported value
+- keep `fromClipId`, `toClipId`, and `durationTicks` if they are otherwise valid
+
+### Transition clips are not adjacent
+
+Symptoms:
+
+- `EDITOR_TRANSITION_CLIP_NOT_ADJACENT`
+- the transition references clips that exist but skip over another clip
+
+Fix:
+
+- ensure `fromClipId` and `toClipId` are neighbors in the same `track.items[]`
+- if the clips are intentionally separate scenes, move the transition to the actual neighboring pair or remove it
+
+### Missing asset
+
+Symptoms:
+
+- validation path points to `assetId`
+- item references an asset key that does not exist
+
+Fix:
+
+- ensure the referenced asset key exists under `assets`
+- ensure the nested `assets[*].id` matches that key
+- ensure the asset type matches the item type
+
+### Missing required geometry or playback fields
+
+Symptoms:
+
+- validator points at `top`, `left`, `width`, `height`, `scaleX`, `scaleY`, `opacity`, `rotation`, `playbackRate`, or fade fields
+
+Fix:
+
+- restore the missing required properties with a valid static animated-number-track or scalar value
+- remember that audio items still require the base geometry fields
+
+### Invalid text or subtitle style object
+
+Symptoms:
+
+- validator points at `fontStyle`, `background`, `captionAnimations`, or alignment fields
+
+Fix:
+
+- ensure `fontStyle` contains both `variant` and `weight`
+- ensure `align` is one of `left`, `center`, `right`
+- ensure `direction` is `ltr` or `rtl`
+- ensure background objects include `color`, `horizontalPadding`, and `borderRadius`
+- ensure caption animation names are supported
+
+### Template item mismatch
+
+Symptoms:
+
+- validator points at `schemaVersion`, `templateId`, `templateCategory`, or `nodes`
+
+Fix:
+
+- confirm `schemaVersion` is exactly `2`
+- ensure `nodes` has at least two entries
+- ensure each node has a `type`
+- if the real template contract is unknown, replace the `text-template` item with standard `text` and `image` items
+
+## Schema troubleshooting workflow
+
+When the validator output is not enough:
+
+1. Open `references/editor-state.v1.schema.json`.
+2. Search for the item or asset definition that matches the failing path, such as:
+   - `imageItem`
+   - `videoItem`
+   - `captionsItem`
+   - `transition`
+   - `globalBackground`
+3. Confirm the required fields and enum values.
+4. Compare the failing payload against a known-good pattern in the other references.
+5. Re-run `indream_editor_validate`.
+
+## Safe repair habits
+
+- Keep IDs stable while repairing.
+- Do not regenerate the entire JSON when only one field is invalid.
+- Preserve timing and track order unless the failure is caused by timing or adjacency.
+- Preserve optional design choices such as crop, border radius, subtitle styling, and animation when they are already valid.