Scripted Media Pipeline

Scripted Media Pipeline (Ring Media Conductor)

Provider-neutral, schema-driven pipeline for marketing and explainer reels. A creative agent authors one scripted-video-generation-request-<id>.json; ring-video-create chains:

First-frame still (firstFramePrompt → ImageConductor)
I2V video (grok-imagine-video-1.5 @ 480p when draft + image)
Optional thumbnail (deterministic text overlays via next/og)

ring-video-create

MCP tool reference (overloaded scene path).

Generative videos

VideoConductor presets and remaster modes.

Architecture

text


Creative agent → scripted-video-generation-request.json
  → run-scripted-video.mjs (CLI) OR ring-video-create (MCP)
    → VideoConductor.generate
      → ImageConductor (firstFramePrompt)
      → xAI I2V (compiled ACTION/DIALOGUE prompt)
      → thumbnail compositor (optional)
    → manifest v3 + ring-filebase URLs

Artifact	Path
JSON Schema	`lib/media/scripted-video-generation.schema.json`
Zod validation	`lib/media/schemas.ts`
Prompt compiler	`lib/media/prompt-compiler.ts`
Thumbnail	`lib/media/thumbnail.tsx`
Example request	`scripts/ring-viral-video/scripted-video-generation-request-hoa-nightclub.json`
CLI runner	`scripts/ring-viral-video/run-scripted-video.mjs`
Director lens	`AI-LEGIOX/legiox-truth-lens/scripted-video-director.nodus.json`

Request file shape

Cast placeholders: {{guy}}, {{girl}} resolve to cast[].description at compile time.

Clip types

Type	firstFrame	scene.dialogue	Video mode
Montage / UI	omit	optional	T2V `grok-imagine-video` @ 480p
Dialogue	`imagePrompt` required	required	I2V `grok-imagine-video-1.5` @ 480p

CLI

Manifest v3 tracks firstFrameUrl, thumbnailUrl, pipelineRequestId, clipId per upsert key id::qualityMode.

MCP (single clip)

With thumbnail.enabled in body — see ring-video-create.

Agent workflow

Consult scripted-video-director truth lens when authoring requests. Validate with:

Environment

Legacy

xai-video-jobs.json + generate-xai-videos.mjs remain for direct xAI batch runs without gateway. Prefer the scripted request file for new campaigns.

Scripted Media Pipeline (Ring Media Conductor)

Provider-neutral, schema-driven pipeline for marketing and explainer reels. A creative agent authors one scripted-video-generation-request-<id>.json; ring-video-create chains:

First-frame still (firstFramePrompt → ImageConductor)
I2V video (grok-imagine-video-1.5 @ 480p when draft + image)
Optional thumbnail (deterministic text overlays via next/og)

ring-video-create

MCP tool reference (overloaded scene path).

Generative videos

VideoConductor presets and remaster modes.

Architecture

text


Creative agent → scripted-video-generation-request.json
  → run-scripted-video.mjs (CLI) OR ring-video-create (MCP)
    → VideoConductor.generate
      → ImageConductor (firstFramePrompt)
      → xAI I2V (compiled ACTION/DIALOGUE prompt)
      → thumbnail compositor (optional)
    → manifest v3 + ring-filebase URLs

Artifact	Path
JSON Schema	`lib/media/scripted-video-generation.schema.json`
Zod validation	`lib/media/schemas.ts`
Prompt compiler	`lib/media/prompt-compiler.ts`
Thumbnail	`lib/media/thumbnail.tsx`
Example request	`scripts/ring-viral-video/scripted-video-generation-request-hoa-nightclub.json`
CLI runner	`scripts/ring-viral-video/run-scripted-video.mjs`
Director lens	`AI-LEGIOX/legiox-truth-lens/scripted-video-director.nodus.json`

Request file shape

Cast placeholders: {{guy}}, {{girl}} resolve to cast[].description at compile time.

Clip types

Type	firstFrame	scene.dialogue	Video mode
Montage / UI	omit	optional	T2V `grok-imagine-video` @ 480p
Dialogue	`imagePrompt` required	required	I2V `grok-imagine-video-1.5` @ 480p

CLI

Manifest v3 tracks firstFrameUrl, thumbnailUrl, pipelineRequestId, clipId per upsert key id::qualityMode.

MCP (single clip)

With thumbnail.enabled in body — see ring-video-create.

Agent workflow

Consult scripted-video-director truth lens when authoring requests. Validate with:

Environment

Legacy

xai-video-jobs.json + generate-xai-videos.mjs remain for direct xAI batch runs without gateway. Prefer the scripted request file for new campaigns.

Scripted Media Pipeline (Ring Media Conductor)

Provider-neutral, schema-driven pipeline for marketing and explainer reels. A creative agent authors one scripted-video-generation-request-<id>.json; ring-video-create chains:

First-frame still (firstFramePrompt → ImageConductor)
I2V video (grok-imagine-video-1.5 @ 480p when draft + image)
Optional thumbnail (deterministic text overlays via next/og)

ring-video-create

MCP tool reference (overloaded scene path).

Generative videos

VideoConductor presets and remaster modes.

Architecture

text


Creative agent → scripted-video-generation-request.json
  → run-scripted-video.mjs (CLI) OR ring-video-create (MCP)
    → VideoConductor.generate
      → ImageConductor (firstFramePrompt)
      → xAI I2V (compiled ACTION/DIALOGUE prompt)
      → thumbnail compositor (optional)
    → manifest v3 + ring-filebase URLs

Artifact	Path
JSON Schema	`lib/media/scripted-video-generation.schema.json`
Zod validation	`lib/media/schemas.ts`
Prompt compiler	`lib/media/prompt-compiler.ts`
Thumbnail	`lib/media/thumbnail.tsx`
Example request	`scripts/ring-viral-video/scripted-video-generation-request-hoa-nightclub.json`
CLI runner	`scripts/ring-viral-video/run-scripted-video.mjs`
Director lens	`AI-LEGIOX/legiox-truth-lens/scripted-video-director.nodus.json`

Request file shape

Cast placeholders: {{guy}}, {{girl}} resolve to cast[].description at compile time.

Clip types

Type	firstFrame	scene.dialogue	Video mode
Montage / UI	omit	optional	T2V `grok-imagine-video` @ 480p
Dialogue	`imagePrompt` required	required	I2V `grok-imagine-video-1.5` @ 480p

CLI

Manifest v3 tracks firstFrameUrl, thumbnailUrl, pipelineRequestId, clipId per upsert key id::qualityMode.

MCP (single clip)

With thumbnail.enabled in body — see ring-video-create.

Agent workflow

Consult scripted-video-director truth lens when authoring requests. Validate with:

Environment

Legacy

xai-video-jobs.json + generate-xai-videos.mjs remain for direct xAI batch runs without gateway. Prefer the scripted request file for new campaigns.

json


{
  "schemaVersion": "1.0",
  "requestId": "hoa-nightclub-viral-2026-06",
  "purpose": "viral-ad",
  "defaults": { "qualityMode": "draft", "aspectRatio": "16:9", "imageResolution": "2k" },
  "cast": [{ "id": "guy", "description": "…" }],
  "setting": "San Francisco nightclub at night…",
  "clips": [{
    "id": "03_sf_nightclub_ring_opener",
    "duration": 12,
    "firstFrame": { "imagePrompt": "{{girl}} and {{guy}} at bar…" },
    "scene": {
      "action": "{{guy}} gestures warmly…",
      "dialogue": [{ "speaker": "guy", "line": "So your HOA uses Ring?", "tone": "warmly" }]
    },
    "thumbnail": { "enabled": true, "overlays": [{ "text": "Your HOA on Ring", "role": "title" }] }
  }]
}

bash


cd ring-platform.org/scripts/ring-viral-video

# Full pipeline via MCP gateway (needs RING_MCP_ACCESS_KEY + dev server)
node run-scripted-video.mjs scripted-video-generation-request-hoa-nightclub.json --download

# Single clip
node run-scripted-video.mjs scripted-video-generation-request-hoa-nightclub.json --clip=03_sf_nightclub_ring_opener

# Remaster from manifest URL
node run-scripted-video.mjs request.json --remaster --clip=03_sf_nightclub_ring_opener --source-url=https://...

text


ring-video-create \
  prompt "ACTION: … DIALOGUE: …" \
  firstFramePrompt "Cinematic still {{guy}} and {{girl}} at bar…" \
  qualityMode draft duration 12 purpose viral-ad clipId 03_sf_nightclub_ring_opener

json


{
  "schemaVersion": "1.0",
  "requestId": "hoa-nightclub-viral-2026-06",
  "purpose": "viral-ad",
  "defaults": { "qualityMode": "draft", "aspectRatio": "16:9", "imageResolution": "2k" },
  "cast": [{ "id": "guy", "description": "…" }],
  "setting": "San Francisco nightclub at night…",
  "clips": [{
    "id": "03_sf_nightclub_ring_opener",
    "duration": 12,
    "firstFrame": { "imagePrompt": "{{girl}} and {{guy}} at bar…" },
    "scene": {
      "action": "{{guy}} gestures warmly…",
      "dialogue": [{ "speaker": "guy", "line": "So your HOA uses Ring?", "tone": "warmly" }]
    },
    "thumbnail": { "enabled": true, "overlays": [{ "text": "Your HOA on Ring", "role": "title" }] }
  }]
}

bash


cd ring-platform.org/scripts/ring-viral-video

# Full pipeline via MCP gateway (needs RING_MCP_ACCESS_KEY + dev server)
node run-scripted-video.mjs scripted-video-generation-request-hoa-nightclub.json --download

# Single clip
node run-scripted-video.mjs scripted-video-generation-request-hoa-nightclub.json --clip=03_sf_nightclub_ring_opener

# Remaster from manifest URL
node run-scripted-video.mjs request.json --remaster --clip=03_sf_nightclub_ring_opener --source-url=https://...

text


ring-video-create \
  prompt "ACTION: … DIALOGUE: …" \
  firstFramePrompt "Cinematic still {{guy}} and {{girl}} at bar…" \
  qualityMode draft duration 12 purpose viral-ad clipId 03_sf_nightclub_ring_opener

json


{
  "schemaVersion": "1.0",
  "requestId": "hoa-nightclub-viral-2026-06",
  "purpose": "viral-ad",
  "defaults": { "qualityMode": "draft", "aspectRatio": "16:9", "imageResolution": "2k" },
  "cast": [{ "id": "guy", "description": "…" }],
  "setting": "San Francisco nightclub at night…",
  "clips": [{
    "id": "03_sf_nightclub_ring_opener",
    "duration": 12,
    "firstFrame": { "imagePrompt": "{{girl}} and {{guy}} at bar…" },
    "scene": {
      "action": "{{guy}} gestures warmly…",
      "dialogue": [{ "speaker": "guy", "line": "So your HOA uses Ring?", "tone": "warmly" }]
    },
    "thumbnail": { "enabled": true, "overlays": [{ "text": "Your HOA on Ring", "role": "title" }] }
  }]
}

bash


cd ring-platform.org/scripts/ring-viral-video

# Full pipeline via MCP gateway (needs RING_MCP_ACCESS_KEY + dev server)
node run-scripted-video.mjs scripted-video-generation-request-hoa-nightclub.json --download

# Single clip
node run-scripted-video.mjs scripted-video-generation-request-hoa-nightclub.json --clip=03_sf_nightclub_ring_opener

# Remaster from manifest URL
node run-scripted-video.mjs request.json --remaster --clip=03_sf_nightclub_ring_opener --source-url=https://...

text


ring-video-create \
  prompt "ACTION: … DIALOGUE: …" \
  firstFramePrompt "Cinematic still {{guy}} and {{girl}} at bar…" \
  qualityMode draft duration 12 purpose viral-ad clipId 03_sf_nightclub_ring_opener

Documentation

Quick entry (CTOs · auditors · agents)

Documentation

Quick entry (CTOs · auditors · agents)

Documentation

Quick entry (CTOs · auditors · agents)

Loading documentation...

Documentation

Quick entry (CTOs · auditors · agents)

Loading documentation...

Documentation

Quick entry (CTOs · auditors · agents)

Loading documentation...

Documentation

Quick entry (CTOs · auditors · agents)

Loading documentation...

Loading documentation...

Loading documentation...

Scripted Media Pipeline (Ring Media Conductor)

ring-video-create

Generative videos

Architecture

Request file shape

Clip types

CLI

MCP (single clip)

Agent workflow

Environment

Legacy

Scripted Media Pipeline (Ring Media Conductor)

ring-video-create

Generative videos

Architecture

Request file shape

Clip types

CLI

MCP (single clip)

Agent workflow

Environment

Legacy

Scripted Media Pipeline (Ring Media Conductor)

ring-video-create

Generative videos

Architecture

Request file shape

Clip types

CLI

MCP (single clip)

Agent workflow

Environment

Legacy