feat: add native demo recorder workflow

Author: lezama

bin/demo-recorder.mjs

@@ -98,6 +98,24 @@ wp post create --post_type=page --post_status=publish --post_title='Support FAQ'
 7. Open openclaWP -> Chat and use one generated demo prompt as the customer scenario.
 8. Close with the production checklist: configure connectors, index KB sources, review approval policy, then register the generated agent/workflow.
 
+## Recording The Demo
+
+openclaWP can generate the storyboard and trigger a local recorder through:
+
+- `openclawp/create-demo-recording-plan`
+- `openclawp/record-demo-video`
+- workflow `openclawp/record-agency-demo`
+
+Run the recorder from your laptop or CI worker, not inside Atomic:
+
+```bash
+node bin/demo-recorder.mjs --port=8765
+```
+
+The plan includes captions and a narration script. On macOS, the recorder can
+use `say` for voice-over and `ffmpeg` to produce an MP4 with audio. See
+`docs/demo-recorder.md`.
+
 ## Good Demo Defaults
 
 For a lead-generation agency demo:

docs/atomic-demo.md

@@ -0,0 +1,82 @@
+# Demo Recorder
+
+openclaWP can now generate a demo recording plan from inside WordPress and hand
+that plan to a local recorder service. The browser/video/audio work stays
+outside WordPress, which keeps Atomic installs safe.
+
+## What It Demonstrates
+
+- An existing WordPress site becomes the starting point.
+- openclaWP audits the site for agency automation opportunities.
+- The Agency page generates a client-specific automation package.
+- The Chat page proves live tool calling against WordPress.
+- The generated plan includes captions and a voice-over script.
+- A local Playwright recorder can synthesize voice-over with the macOS `say`
+  command and mux it with `ffmpeg` when available.
+
+## Abilities
+
+- `openclawp/create-demo-recording-plan`
+  - Builds the storyboard, browser steps, captions, narration, viewport, and
+    output naming.
+- `openclawp/record-demo-video`
+  - Sends a plan to a recorder endpoint such as
+    `http://127.0.0.1:8765/record`.
+  - This ability is tagged as `external`, so normal tool confirmation policy
+    can gate it.
+
+The bundled workflow is `openclawp/record-agency-demo`.
+
+## Local Recorder
+
+Start the local recorder from the repo:
+
+```bash
+node bin/demo-recorder.mjs --port=8765
+```
+
+Then run the WordPress ability or workflow with:
+
+```php
+wp_get_ability( 'openclawp/record-demo-video' )->execute(
+	array(
+		'endpoint'    => 'http://127.0.0.1:8765/record',
+		'site_url'    => 'http://localhost:8894/',
+		'login_url'   => 'http://localhost:8894/studio-auto-login?redirect_to=%2Fwp-admin%2F',
+		'client_name' => 'Northstar Clinic',
+		'industry'    => 'clinic',
+		'blueprint'   => 'booking-agent',
+		'voice'       => array(
+			'enabled' => true,
+			'mode'    => 'auto',
+		),
+	)
+);
+```
+
+The recorder writes artifacts to `OPENCLAWP_DEMO_OUT_DIR` when set, otherwise
+to the OS temp directory under `openclawp-demo-artifacts`.
+
+## Atomic Demo Shape
+
+On Atomic, use openclaWP to create the plan. The video recorder should still
+run from your laptop or CI worker and browse the Atomic site remotely. Do not
+try to install Playwright, Chromium, `ffmpeg`, or a TTS stack inside the
+WordPress runtime.
+
+If Atomic cannot reach your laptop recorder endpoint, run the local recorder
+with a saved plan instead:
+
+```bash
+node bin/demo-recorder.mjs --plan=/path/to/openclawp-plan.json
+```
+
+## Voice Behavior
+
+Voice is best-effort:
+
+- `voice.enabled=true` asks the recorder to create narration.
+- `voice.mode=script-only` writes only the narration script.
+- `voice.mode=auto` tries local TTS and falls back to script-only.
+- On macOS, `say` creates the audio file.
+- If `ffmpeg` exists, the recorder also creates an MP4 with audio.

docs/demo-recorder.md

@@ -362,6 +362,13 @@ private static function build_demo( array $workspace, array $blueprint, array $a
 				'Show the internal summary and handoff plan.',
 				'Show required connectors and approvals before production.',
 			),
+			'recording'   => array(
+				'workflow'            => OpenclaWP_Demo_Recorder::WORKFLOW_ID,
+				'plan_ability'        => OpenclaWP_Demo_Recorder::CREATE_PLAN_ABILITY,
+				'record_ability'      => OpenclaWP_Demo_Recorder::RECORD_VIDEO_ABILITY,
+				'voice_over_enabled'  => true,
+				'local_recorder_mode' => 'http-endpoint',
+			),
 			'success_criteria' => (array) ( $blueprint['success_metrics'] ?? array() ),
 			'answers_used' => array_keys( $answers ),
 		);

includes/class-openclawp-agency-generator.php

@@ -45,6 +45,7 @@ public static function init(): void {
 		OpenclaWP_Abilities::register();
 		OpenclaWP_Content_Abilities::register();
 		OpenclaWP_Agency_Abilities::register();
+		OpenclaWP_Demo_Recorder::register();
 		OpenclaWP_Mcp_Client_Bridge::register();
 		OpenclaWP_Custom_Tools_Registrar::register();
 		OpenclaWP_Knowledge_Base_Search::register();