agentvfx 0.0.0-stage → 0.3.5

package/skills/agentvfx/templates/psychedelic/kaleido-fold/main.frag

@@ -0,0 +1,10 @@
+// kaleido-fold main: saturate the feedback buffer and blend over source.
+// (No builtin mix() calls: `blend` is an input name.)
+void main() {
+  vec3 f = texture(fold, vUv).rgb;
+  float fl = luma(f);
+  f = vec3(fl) + (f - vec3(fl)) * clamp(saturation, 0.0, 3.0);
+  vec3 src = texture(inputImage, vUv).rgb;
+  float m = clamp(blend, 0.0, 1.0);
+  fragColor = vec4(src + (f - src) * m, 1.0);
+}

package/skills/agentvfx/templates/psychedelic/kaleido-fold/pass0.frag

@@ -0,0 +1,34 @@
+// kaleido-fold pass0: mirror-folded kaleidoscope image max-blended over the
+// previous frame sampled with a zoom + spin + hue shift (feedback trails).
+// Generative marble pattern when there is no input.
+void main() {
+  float aspect = RENDERSIZE.x / max(RENDERSIZE.y, 1.0);
+  vec2 p = (vUv - 0.5) * vec2(aspect, 1.0);
+  p = vec2(abs(p.x), p.y);
+  float r = length(p);
+  float seg = 6.2831853 / float(segments);
+  float ang = atan(p.y, p.x);
+  float sec = floor(ang / seg);
+  float a = mod(ang, seg);
+  if (mod(sec, 2.0) > 0.5) {
+    a = seg - a;
+  }
+  vec2 k = vec2(cos(a), sin(a)) * r;
+  vec2 suv = k / vec2(aspect, 1.0) + 0.5;
+  vec3 fresh;
+  float inView = step(0.0, suv.x) * step(suv.x, 1.0) * step(0.0, suv.y) * step(suv.y, 1.0);
+  if (HAS_INPUT) {
+    fresh = texture(inputImage, clamp(suv, 0.0, 1.0)).rgb * inView;
+  } else {
+    float m = fbm(vec2(r * 4.0 - TIME * 0.25, a * 2.0), 3);
+    fresh = paletteCycle(fract(m + TIME * 0.03)) * (0.35 + 0.65 * m);
+  }
+  float sr = spin * 0.0174533;
+  vec2 d = vUv - 0.5;
+  vec2 fuv = vec2(d.x * cos(sr) - d.y * sin(sr), d.x * sin(sr) + d.y * cos(sr)) / zoom + 0.5;
+  vec3 prevImg = texture(fold, fuv).rgb;
+  vec3 hsv = rgb2hsv(prevImg);
+  hsv.x = fract(hsv.x + hueSpin / 360.0);
+  vec3 prevShift = hsv2rgb(hsv) * feedback;
+  fragColor = vec4(max(prevShift, fresh), 1.0);
+}

package/skills/agentvfx/templates/psychedelic/mosh-melt/demo-classic.json

@@ -0,0 +1 @@
+{"version":1,"template":"mosh-melt","preset":"mosh-classic","input":{"video":"test-media/clip-01.mp4"},"durationSec":4,"seed":11,"out":"mosh-classic"}

package/skills/agentvfx/templates/psychedelic/mosh-melt/fx.json

@@ -0,0 +1,38 @@
+{
+  "DESCRIPTION": "Mosh melt: flow-advected accumulating feedback with refresh hits, luma-threshold pixel-sort streaks and hard posterize",
+  "CREDIT": "agentvfx",
+  "ISFVSN": "2",
+  "CATEGORIES": ["psychedelic"],
+  "INPUTS": [
+    { "NAME": "refreshN", "TYPE": "long", "MIN": 2, "MAX": 120, "DEFAULT": 12 },
+    { "NAME": "streakLen", "TYPE": "float", "MIN": 0, "MAX": 64, "DEFAULT": 24 },
+    { "NAME": "threshold", "TYPE": "float", "MIN": 0, "MAX": 1, "DEFAULT": 0.55 },
+    { "NAME": "levels", "TYPE": "long", "MIN": 2, "MAX": 10, "DEFAULT": 5 },
+    { "NAME": "decay", "TYPE": "float", "MIN": 0.5, "MAX": 1, "DEFAULT": 0.97 },
+    { "NAME": "audioRefresh", "TYPE": "bool", "DEFAULT": false },
+    { "NAME": "saturation", "TYPE": "float", "MIN": 0, "MAX": 3, "DEFAULT": 1.8 },
+    { "NAME": "blend", "TYPE": "float", "MIN": 0, "MAX": 1, "DEFAULT": 1 }
+  ],
+  "PASSES": [
+    { "TARGET": "state", "PERSISTENT": true, "FLOAT": true },
+    {}
+  ],
+  "X_AGENTVFX": {
+    "id": "mosh-melt",
+    "family": "psychedelic",
+    "input": "footage",
+    "spdx": "Apache-2.0",
+    "flash": "possible",
+    "fps": 30,
+    "palette": true,
+    "presets": {
+      "mosh-classic": { "refreshN": 12, "streakLen": 24, "threshold": 0.55, "levels": 5 },
+      "mosh-sludge": { "refreshN": 30, "streakLen": 48, "threshold": 0.4, "levels": 4, "decay": 0.985, "saturation": 2 },
+      "mosh-fracture": { "refreshN": 6, "streakLen": 16, "threshold": 0.7, "levels": 3, "decay": 0.94 }
+    },
+    "safeSubstitute": { "params": { "refreshN": 48, "streakLen": 8 } },
+    "credits": [
+      "Horn-Schunck optical flow (Jacobi iteration), https://en.wikipedia.org/wiki/Horn%E2%80%93Schunck_method"
+    ]
+  }
+}

package/skills/agentvfx/templates/psychedelic/mosh-melt/main.frag

@@ -0,0 +1,20 @@
+// mosh-melt main: luma-threshold horizontal pixel-sort streaks over the
+// accumulation buffer, hard posterize, saturate, blend.
+// (No builtin mix() calls: `blend` is an input name.)
+void main() {
+  vec2 texel = vec2(1.0) / vec2(textureSize(state, 0));
+  vec3 m = texture(state, vUv).rgb;
+  float px = max(streakLen / 16.0, 0.0) * texel.x;
+  for (int k = 1; k <= 16; k++) {
+    vec3 s = texture(state, vUv - vec2(float(k) * px, 0.0)).rgb;
+    float w = step(threshold, luma(s));
+    m = max(m, s * w);
+  }
+  float lv = float(levels);
+  m = floor(m * lv + 0.5) / lv;
+  float cl = luma(m);
+  m = vec3(cl) + (m - vec3(cl)) * clamp(saturation, 0.0, 3.0);
+  vec3 src = texture(inputImage, vUv).rgb;
+  float b = clamp(blend, 0.0, 1.0);
+  fragColor = vec4(src + (m - src) * b, 1.0);
+}

package/skills/agentvfx/templates/psychedelic/mosh-melt/pass0.frag

@@ -0,0 +1,22 @@
+// mosh-melt state: flow-advected accumulation with refresh hits.
+// Flow comes from frame difference along the local Sobel gradient.
+// Refresh every refreshN frames (or on an audio beat when audioRefresh
+// is on); otherwise max-blend the advected old state with the current
+// frame. RGB = accumulation, A = this frame's luma for next frame.
+void main() {
+  vec2 texel = vec2(1.0) / vec2(textureSize(inputImage, 0));
+  float lC = luma(texture(inputImage, vUv).rgb);
+  float lx1 = luma(texture(inputImage, vUv - vec2(texel.x, 0.0)).rgb);
+  float lx2 = luma(texture(inputImage, vUv + vec2(texel.x, 0.0)).rgb);
+  float ly1 = luma(texture(inputImage, vUv - vec2(0.0, texel.y)).rgb);
+  float ly2 = luma(texture(inputImage, vUv + vec2(0.0, texel.y)).rgb);
+  vec2 grad = vec2(lx2 - lx1, ly2 - ly1);
+  float it = lC - texture(state, vUv).a;
+  float gm = length(grad) + 1e-4;
+  vec2 shift = (grad / gm) * clamp(-it * 24.0, -6.0, 6.0) * texel;
+  vec3 old = texture(state, vUv - shift).rgb;
+  vec3 cur = texture(inputImage, vUv).rgb;
+  bool hit = (FRAMEINDEX % refreshN == 0) || (audioRefresh && AUDIO_BEAT > 0.5);
+  vec3 acc = hit ? cur : max(old * decay, cur * 0.9);
+  fragColor = vec4(acc, lC);
+}

package/skills/agentvfx/templates/psychedelic/sacred/NOTES.md

@@ -0,0 +1,13 @@
+# Sacred — algorithm and parameters
+
+1. pass0 blurs footage luma (3x3, radius lumaBlur) into smoothLuma; with no input it renders a slow fbm field instead, so the template stays generative.
+2. main maps contrasted luma to a colour phase: phase = luma * bandDensity, giving N saturated bands across dark-to-bright.
+3. A tide of 1-3 travelling sine waves along tideAngle plus fbm drift shifts the phase over space and time, so bands sweep like a tide.
+4. The phase looks up a cyclic palette: rainbow cosine, a thermal blue-to-cyan ramp, or the score palette. Palette 3 (`print`) is a clamped 4-step ink / acid / orange / paper lookup used by sacred-thermal and sacred-halo; `baseDim` darkens the base and `stroke`/`strokeWidth` draw a solid acid line on luma edges (sacred-halo).
+5. Sobel gradients of the smooth luma drive an optional white edge halo (haloAmount) and R/B channel phase split (fringe).
+6. AUDIO_BASS scales the tide speed and AUDIO_BEAT adds a phase kick, both gated by audioKick (0 = off).
+7. Saturation is pushed around the output luma; the result blends over the source by blend (default full effect).
+8. tideSpeed: how fast bands travel. tideScale: spatial frequency of the tide. tideAngle: travel direction in radians.
+9. tideWaves (1-3): wave count, richer motion at 3. bandDensity: band count across the luma range. paletteShift: offset into the palette.
+10. saturation/contrast: stage-grade punch. lumaBlur: smoothness of the luma drive. haloAmount/fringe: edge glow and chroma split, off by default. blend: effect blend over the source.
+11. Print palette flash bounds: tide speed stops at 1, the tide and audio swing stop at +-0.26 of the phase, and pass1 keeps a clock in smoothLuma's g and b so a speed change alters the rate without jumping the bands (with `TIME * speed`, any change moves the phase by `TIME * change`, which flipped the whole frame between ink and paper). sacred-thermal and sacred-halo sit inside both limits; rainbow, thermal and score palettes keep the direct clock.

package/skills/agentvfx/templates/psychedelic/sacred/demo-classic.json

@@ -0,0 +1 @@
+{"version":1,"template":"sacred","preset":"sacred-classic","input":{"video":"test-media/clip-01.mp4"},"durationSec":4,"seed":11,"out":"sacred-classic"}

package/skills/agentvfx/templates/psychedelic/sacred/demo-halo.json

@@ -0,0 +1 @@
+{"version":1,"template":"sacred","preset":"sacred-halo","input":{"video":"test-media/clip-01.mp4"},"durationSec":4,"seed":11,"out":"sacred-halo"}

package/skills/agentvfx/templates/psychedelic/sacred/demo-slow-tide.json

@@ -0,0 +1 @@
+{"version":1,"template":"sacred","preset":"sacred-slow-tide","input":{"video":"test-media/clip-01.mp4"},"durationSec":4,"seed":11,"out":"sacred-slow-tide"}

package/skills/agentvfx/templates/psychedelic/sacred/demo-thermal.json

@@ -0,0 +1 @@
+{"version":1,"template":"sacred","preset":"sacred-thermal","input":{"video":"test-media/clip-01.mp4"},"durationSec":4,"seed":11,"out":"sacred-thermal"}

package/skills/agentvfx/templates/psychedelic/sacred/fx.json

@@ -0,0 +1,263 @@
+{
+  "DESCRIPTION": "Sacred hero: luminance-driven colour tide sweeping rainbow, thermal or hard screenprint bands over footage, with an optional contour stroke",
+  "CREDIT": "agentvfx",
+  "ISFVSN": "2",
+  "CATEGORIES": [
+    "psychedelic"
+  ],
+  "INPUTS": [
+    {
+      "NAME": "tideSpeed",
+      "TYPE": "float",
+      "MIN": 0,
+      "MAX": 3,
+      "DEFAULT": 0.6
+    },
+    {
+      "NAME": "tideScale",
+      "TYPE": "float",
+      "MIN": 0.1,
+      "MAX": 4,
+      "DEFAULT": 1
+    },
+    {
+      "NAME": "tideAngle",
+      "TYPE": "float",
+      "MIN": -3.1416,
+      "MAX": 3.1416,
+      "DEFAULT": 0.6
+    },
+    {
+      "NAME": "tideWaves",
+      "TYPE": "long",
+      "MIN": 1,
+      "MAX": 3,
+      "DEFAULT": 2
+    },
+    {
+      "NAME": "tideAmount",
+      "TYPE": "float",
+      "MIN": 0,
+      "MAX": 3,
+      "DEFAULT": 0.6
+    },
+    {
+      "NAME": "ripple",
+      "TYPE": "float",
+      "MIN": 0,
+      "MAX": 0.06,
+      "DEFAULT": 0.012
+    },
+    {
+      "NAME": "bandDensity",
+      "TYPE": "float",
+      "MIN": 0.5,
+      "MAX": 12,
+      "DEFAULT": 1.6
+    },
+    {
+      "NAME": "palette",
+      "TYPE": "long",
+      "MIN": 0,
+      "MAX": 3,
+      "VALUES": [
+        0,
+        1,
+        2,
+        3
+      ],
+      "LABELS": [
+        "rainbow",
+        "thermal",
+        "score",
+        "print"
+      ],
+      "DEFAULT": 1
+    },
+    {
+      "NAME": "paletteShift",
+      "TYPE": "float",
+      "MIN": 0,
+      "MAX": 1,
+      "DEFAULT": 0
+    },
+    {
+      "NAME": "saturation",
+      "TYPE": "float",
+      "MIN": 0,
+      "MAX": 3,
+      "DEFAULT": 1.05
+    },
+    {
+      "NAME": "contrast",
+      "TYPE": "float",
+      "MIN": 0.5,
+      "MAX": 3,
+      "DEFAULT": 1.2
+    },
+    {
+      "NAME": "lumaBlur",
+      "TYPE": "float",
+      "MIN": 0,
+      "MAX": 8,
+      "DEFAULT": 1.2
+    },
+    {
+      "NAME": "settle",
+      "TYPE": "float",
+      "MIN": 0.05,
+      "MAX": 1,
+      "DEFAULT": 0.5
+    },
+    {
+      "NAME": "keepLuma",
+      "TYPE": "float",
+      "MIN": 0,
+      "MAX": 1,
+      "DEFAULT": 0.55
+    },
+    {
+      "NAME": "detail",
+      "TYPE": "float",
+      "MIN": 0,
+      "MAX": 2,
+      "DEFAULT": 0.7
+    },
+    {
+      "NAME": "haloAmount",
+      "TYPE": "float",
+      "MIN": 0,
+      "MAX": 2,
+      "DEFAULT": 0
+    },
+    {
+      "NAME": "fringe",
+      "TYPE": "float",
+      "MIN": 0,
+      "MAX": 1,
+      "DEFAULT": 0
+    },
+    {
+      "NAME": "audioKick",
+      "TYPE": "float",
+      "MIN": 0,
+      "MAX": 2,
+      "DEFAULT": 0
+    },
+    {
+      "NAME": "baseDim",
+      "TYPE": "float",
+      "MIN": 0,
+      "MAX": 1,
+      "DEFAULT": 0
+    },
+    {
+      "NAME": "stroke",
+      "TYPE": "float",
+      "MIN": 0,
+      "MAX": 1,
+      "DEFAULT": 0
+    },
+    {
+      "NAME": "strokeWidth",
+      "TYPE": "float",
+      "MIN": 0.5,
+      "MAX": 8,
+      "DEFAULT": 3
+    },
+    {
+      "NAME": "blend",
+      "TYPE": "float",
+      "MIN": 0,
+      "MAX": 1,
+      "DEFAULT": 1
+    }
+  ],
+  "PASSES": [
+    {
+      "TARGET": "lumaNow",
+      "FLOAT": true
+    },
+    {
+      "TARGET": "smoothLuma",
+      "PERSISTENT": true,
+      "FLOAT": true
+    },
+    {}
+  ],
+  "X_AGENTVFX": {
+    "id": "sacred",
+    "family": "psychedelic",
+    "input": "either",
+    "spdx": "Apache-2.0",
+    "flash": "none",
+    "fps": 30,
+    "palette": true,
+    "presets": {
+      "sacred-classic": {
+        "palette": 0,
+        "bandDensity": 1.8,
+        "tideAmount": 0.8,
+        "tideSpeed": 0.9,
+        "tideWaves": 2,
+        "saturation": 0.8,
+        "contrast": 1.2,
+        "keepLuma": 0.55,
+        "detail": 0.7,
+        "tideScale": 1.8,
+        "ripple": 0.012
+      },
+      "sacred-thermal": {
+        "palette": 3,
+        "bandDensity": 1.0,
+        "tideAmount": 0.4,
+        "tideSpeed": 0.7,
+        "tideScale": 1.6,
+        "tideWaves": 2,
+        "tideAngle": 1.25,
+        "paletteShift": 0.02,
+        "saturation": 1,
+        "contrast": 1.35,
+        "keepLuma": 0,
+        "detail": 0,
+        "ripple": 0.008
+      },
+      "sacred-slow-tide": {
+        "palette": 0,
+        "bandDensity": 1.2,
+        "tideAmount": 1,
+        "tideSpeed": 0.35,
+        "tideScale": 1.2,
+        "tideWaves": 3,
+        "saturation": 0.8,
+        "contrast": 1.15,
+        "settle": 0.3,
+        "keepLuma": 0.6,
+        "detail": 0.7,
+        "ripple": 0.018
+      },
+      "sacred-halo": {
+        "palette": 3,
+        "bandDensity": 1.0,
+        "tideAmount": 0.5,
+        "tideSpeed": 0.6,
+        "tideScale": 1.4,
+        "tideWaves": 1,
+        "tideAngle": 1.3,
+        "saturation": 0.3,
+        "contrast": 1.3,
+        "keepLuma": 0,
+        "detail": 0.3,
+        "baseDim": 0.55,
+        "stroke": 1,
+        "strokeWidth": 3,
+        "ripple": 0.006
+      }
+    },
+    "credits": [
+      "iq cosine palette, https://iquilezles.org/articles/palettes/",
+      "Sobel-style gradient for the halo, https://en.wikipedia.org/wiki/Sobel_operator",
+      "fbm, The Book of Shaders ch.13, https://thebookofshaders.com/13/"
+    ]
+  }
+}

package/skills/agentvfx/templates/psychedelic/sacred/main.frag

@@ -0,0 +1,109 @@
+// Sacred main pass: luminance -> colour phase, shifted by a travelling tide.
+// phase = contrasted luma * bandDensity + tide + paletteShift (+ audio kick).
+// tide = 1-3 travelling sine waves along tideAngle plus fbm drift.
+// Hard print bands flip whole areas between ink and paper, so palette 3 bounds the tide: its clock comes from pass1
+// (a speed change moves the rate, never the bands) and its swing spans about two band steps. Both limits sit above
+// what sacred-thermal and sacred-halo reach, and the other palettes never touch them.
+const float PRINT_SWING_MAX = 0.26;
+
+vec3 sacredThermal(float t) {
+  t = fract(t);
+  vec3 c = vec3(0.02, 0.05, 1.0) + (vec3(0.55, 0.0, 1.0) - vec3(0.02, 0.05, 1.0)) * smoothstep(0.0, 0.15, t);
+  c = c + (vec3(1.0, 0.0, 1.0) - c) * smoothstep(0.15, 0.30, t);
+  c = c + (vec3(1.0, 0.02, 0.08) - c) * smoothstep(0.30, 0.45, t);
+  c = c + (vec3(1.0, 0.45, 0.0) - c) * smoothstep(0.45, 0.60, t);
+  c = c + (vec3(1.0, 0.92, 0.08) - c) * smoothstep(0.60, 0.75, t);
+  c = c + (vec3(0.05, 1.0, 0.85) - c) * smoothstep(0.75, 0.90, t);
+  c = c + (vec3(0.02, 0.05, 1.0) - c) * smoothstep(0.90, 1.0, t);
+  return c;
+}
+
+// Print palette (mode 3): four hard screenprint steps, ink -> acid -> signal -> paper. Not cyclic:
+// the phase is clamped, so low luma stays ink instead of wrapping to a coloured field.
+vec3 sacredPrint(float t) {
+  int i = int(floor(clamp(t, 0.0, 0.9999) * 4.0));
+  if (i == 0) return vec3(0.01, 0.009, 0.008);
+  if (i == 1) return vec3(0.42, 1.0, 0.0);
+  if (i == 2) return vec3(1.0, 0.55, 0.0);
+  return vec3(0.9, 0.86, 0.74);
+}
+
+vec3 sacredPal(float t, int mode) {
+  if (mode == 3) {
+    return sacredPrint(t);
+  }
+  if (mode == 1) {
+    return sacredThermal(t);
+  }
+  if (mode == 2) {
+    return paletteCycle(fract(t));
+  }
+  return cosPalette(fract(t), vec3(0.5), vec3(0.5), vec3(1.0), vec3(0.0, 0.33, 0.67));
+}
+
+void main() {
+  float aspect = RENDERSIZE.x / max(RENDERSIZE.y, 1.0);
+  vec2 p = vec2(vUv.x * aspect, vUv.y);
+  bool print = palette == 3;
+  float spd = tideSpeed * (1.0 + audioKick * AUDIO_BASS * 1.5);
+  vec2 printClock = texelFetch(smoothLuma, ivec2(0), 0).gb;
+  float clock = print ? TIME * printClock.x + printClock.y : TIME;
+  float rate = print ? 1.0 : spd;
+  // Ripple: the luminance is read through a slowly travelling water-surface displacement, so the
+  // colour shapes undulate like waves instead of sitting still on the footage.
+  float rt = print ? TIME * 0.6 + clock : TIME * (0.6 + tideSpeed);
+  vec2 wob = vec2(sin(p.y * 9.0 + rt * 2.1) + 0.5 * sin(p.y * 17.0 - rt * 1.3 + p.x * 3.0),
+                  cos(p.x * 7.0 - rt * 1.7) + 0.5 * cos(p.x * 13.0 + rt * 1.1 - p.y * 2.0));
+  float L = texture(smoothLuma, vUv + ripple * wob).r;
+  float Lc = clamp((L - 0.5) * contrast + 0.5, 0.0, 1.0);
+
+  vec2 dir = vec2(cos(tideAngle), sin(tideAngle));
+  float s = dot(p, dir) * tideScale;
+  float wsum = 0.0;
+  for (int k = 1; k <= 3; k++) {
+    if (k <= tideWaves) {
+      float fk = float(k);
+      wsum += sin(s * (1.3 + 0.7 * fk) + clock * rate * (1.0 + 0.35 * fk) + fk * 1.7);
+    }
+  }
+  float drift = fbm(p * 0.9 + vec2(clock * rate * 0.12, -clock * rate * 0.07), 3) - 0.5;
+  float tide = wsum / 3.0 * 0.5 + drift * 0.6;
+  float kick = audioKick * AUDIO_BEAT * 0.6;
+  float phase = Lc * bandDensity + tide * tideAmount + paletteShift + kick;
+  if (print) phase = Lc * bandDensity + clamp(tide * tideAmount + kick, -PRINT_SWING_MAX, PRINT_SWING_MAX) + paletteShift;
+
+  vec2 texel = vec2(1.0) / vec2(textureSize(smoothLuma, 0));
+  float gx = texture(smoothLuma, vUv + vec2(texel.x, 0.0)).r - texture(smoothLuma, vUv - vec2(texel.x, 0.0)).r;
+  float gy = texture(smoothLuma, vUv + vec2(0.0, texel.y)).r - texture(smoothLuma, vUv - vec2(0.0, texel.y)).r;
+  float e = clamp(length(vec2(gx, gy)) * 4.0, 0.0, 1.0);
+
+  vec3 col;
+  if (fringe > 0.0001) {
+    float fe = e * fringe;
+    col = vec3(sacredPal(phase + fe, palette).r, sacredPal(phase, palette).g, sacredPal(phase - fe, palette).b);
+  } else {
+    col = sacredPal(phase, palette);
+  }
+  col = col + vec3(1.0) * (e * haloAmount * 0.35);
+  float cl = luma(col);
+  col = vec3(cl) + (col - vec3(cl)) * clamp(saturation, 0.0, 3.0);
+  vec3 src = texture(inputImage, vUv).rgb;
+  // Readability: take part of the brightness from the source itself (faces, folds, text stay legible)
+  // and add back the high-frequency detail the luminance blur removed.
+  float Ls = HAS_INPUT ? luma(src) : L;
+  float target = clamp(Ls * 1.15 + 0.04, 0.0, 1.0);
+  col *= mix(1.0, target / max(luma(col), 0.02), clamp(keepLuma, 0.0, 1.0));
+  col += vec3((Ls - L) * detail * 1.5);
+  col = max(col, vec3(0.0));
+  col *= 1.0 - clamp(baseDim, 0.0, 1.0);
+  // Stroke: a thick, hard, single-colour (acid) line on luma edges. The gradient is taken across
+  // +-strokeWidth px (540p-relative), so the line width follows strokeWidth and holds at any size.
+  if (stroke > 0.0001) {
+    vec2 sr = texel * max(strokeWidth, 0.5) * RENDERSIZE.y / 540.0;
+    float sx = texture(smoothLuma, vUv + vec2(sr.x, 0.0)).r - texture(smoothLuma, vUv - vec2(sr.x, 0.0)).r;
+    float sy = texture(smoothLuma, vUv + vec2(0.0, sr.y)).r - texture(smoothLuma, vUv - vec2(0.0, sr.y)).r;
+    float m = smoothstep(0.07, 0.09, length(vec2(sx, sy)));
+    col = mix(col, vec3(0.42, 1.0, 0.0), m * clamp(stroke, 0.0, 1.0));
+  }
+  fragColor = vec4(mix(src, col, clamp(blend, 0.0, 1.0)), 1.0);
+}

package/skills/agentvfx/templates/psychedelic/sacred/pass0.frag

@@ -0,0 +1,25 @@
+// Sacred pass0: spatially smoothed luminance of the current frame into lumaNow.
+// With footage: 5x5 tent-weighted blur of input luma; the radius scales with the frame height so the
+// look holds at any resolution, and it removes film grain that would otherwise shimmer as fine bands.
+// Generative fallback (!HAS_INPUT): a slow fbm luminance field.
+void main() {
+  if (!HAS_INPUT) {
+    vec2 q = vUv * vec2(RENDERSIZE.x / max(RENDERSIZE.y, 1.0), 1.0);
+    float f = fbm(q * 1.6 + vec2(TIME * 0.03, -TIME * 0.021), 4);
+    f = 0.65 * f + 0.35 * fbm(q * 3.1 - vec2(0.0, TIME * 0.017), 3);
+    fragColor = vec4(vec3(clamp(f, 0.0, 1.0)), 1.0);
+    return;
+  }
+  vec2 px = vec2(1.0) / vec2(textureSize(inputImage, 0));
+  float r = max(lumaBlur, 0.0) * RENDERSIZE.y / 540.0;
+  float acc = 0.0;
+  float wsum = 0.0;
+  for (int i = -2; i <= 2; i++) {
+    for (int j = -2; j <= 2; j++) {
+      float w = (3.0 - abs(float(i))) * (3.0 - abs(float(j)));
+      acc += w * luma(texture(inputImage, vUv + vec2(float(i), float(j)) * r * px).rgb);
+      wsum += w;
+    }
+  }
+  fragColor = vec4(vec3(acc / wsum), 1.0);
+}

package/skills/agentvfx/templates/psychedelic/sacred/pass1.frag

@@ -0,0 +1,23 @@
+// Sacred pass1: temporal smoothing. smoothLuma is persistent; each frame moves toward the new
+// luminance by `settle` (1 = no smoothing), which keeps the colour bands flowing instead of flickering.
+// g and b hold the print palette's tide clock (main reads clock = TIME * g + b): when the speed changes, b takes
+// up the difference, so the tide keeps its position and only its rate changes. The clock is a speed and an offset
+// because a running total would stall in these half-float buffers.
+const float PRINT_SPEED_MAX = 1.0;
+
+void main() {
+  float now = texture(lumaNow, vUv).r;
+  vec4 last = texture(smoothLuma, vUv);
+  float k = FRAMEINDEX == 0 ? 1.0 : clamp(settle, 0.05, 1.0);
+  float speed = min(tideSpeed * (1.0 + audioKick * AUDIO_BASS * 1.5), PRINT_SPEED_MAX);
+  float held = last.g;
+  float offset = last.b;
+  if (FRAMEINDEX == 0) {
+    held = speed;
+    offset = 0.0;
+  } else if (abs(speed - held) > 0.001) {
+    offset += TIME * (held - speed);
+    held = speed;
+  }
+  fragColor = vec4(mix(last.r, now, k), held, offset, 1.0);
+}

package/skills/agentvfx/templates/psychedelic/tidal-bands/demo-classic.json

@@ -0,0 +1 @@
+{"version":1,"template":"tidal-bands","preset":"tidal-classic","input":{"video":"test-media/clip-01.mp4"},"durationSec":4,"seed":11,"out":"tidal-classic"}

package/skills/agentvfx/templates/psychedelic/tidal-bands/fx.json

@@ -0,0 +1,37 @@
+{
+  "DESCRIPTION": "Tidal bands: fbm-warped luma posterized into sweeping saturated colour bands",
+  "CREDIT": "agentvfx",
+  "ISFVSN": "2",
+  "CATEGORIES": ["psychedelic"],
+  "INPUTS": [
+    { "NAME": "flowSpeed", "TYPE": "float", "MIN": 0, "MAX": 3, "DEFAULT": 0.7 },
+    { "NAME": "flowScale", "TYPE": "float", "MIN": 0.2, "MAX": 5, "DEFAULT": 1.4 },
+    { "NAME": "bandCount", "TYPE": "long", "MIN": 2, "MAX": 14, "DEFAULT": 8 },
+    { "NAME": "edgeSharp", "TYPE": "float", "MIN": 0.05, "MAX": 1, "DEFAULT": 0.7 },
+    { "NAME": "ramp", "TYPE": "long", "MIN": 0, "MAX": 2, "VALUES": [0, 1, 2], "LABELS": ["rainbow", "thermal", "score"], "DEFAULT": 0 },
+    { "NAME": "paletteShift", "TYPE": "float", "MIN": 0, "MAX": 1, "DEFAULT": 0 },
+    { "NAME": "saturation", "TYPE": "float", "MIN": 0, "MAX": 3, "DEFAULT": 1.7 },
+    { "NAME": "contrast", "TYPE": "float", "MIN": 0.5, "MAX": 3, "DEFAULT": 1.6 },
+    { "NAME": "audioPush", "TYPE": "float", "MIN": 0, "MAX": 2, "DEFAULT": 0 },
+    { "NAME": "blend", "TYPE": "float", "MIN": 0, "MAX": 1, "DEFAULT": 1 }
+  ],
+  "X_AGENTVFX": {
+    "id": "tidal-bands",
+    "family": "psychedelic",
+    "input": "either",
+    "spdx": "Apache-2.0",
+    "flash": "possible",
+    "fps": 30,
+    "palette": true,
+    "presets": {
+      "tidal-classic": { "ramp": 0, "bandCount": 8, "flowSpeed": 0.7, "flowScale": 1.4, "saturation": 1.8, "contrast": 1.7 },
+      "tidal-abyss": { "ramp": 1, "bandCount": 12, "flowSpeed": 0.9, "flowScale": 1.8, "edgeSharp": 0.85, "saturation": 1.9, "contrast": 1.9 },
+      "tidal-slow": { "ramp": 2, "bandCount": 5, "flowSpeed": 0.22, "flowScale": 0.9, "edgeSharp": 0.45, "saturation": 1.6, "contrast": 1.5 }
+    },
+    "safeSubstitute": { "params": { "flowSpeed": 0.15, "saturation": 1.0 } },
+    "credits": [
+      "iq cosine palette, https://iquilezles.org/articles/palettes/",
+      "fbm, The Book of Shaders ch.13, https://thebookofshaders.com/13/"
+    ]
+  }
+}