@xpert-ai/plugin-motion
v0.4.0
Published
Motion Agentic App with Motion Anything-derived workflows, native HyperFrames video composition, Player preview, and Producer rendering.
Readme
Motion
Motion is an Xpert-native Agentic App for turning natural-language intent into animated HTML and launch-video compositions. Its product workflows and recipe intelligence continue to derive from Motion Anything; native HyperFrames is the standard engine for new video projects.
It provides:
- Motion Assistant template for recipe routing and artifact creation.
- Motion middleware tools for recipe search, scoped project CRUD, versioning, exports, status updates, and failure reporting.
- Motion Workbench remote component with Projects, Motion Library, HTML Workbench, native HyperFrames storyboard/element editing, Legacy Video Composer, Versions, and Exports.
- HyperFrames SDK persistence/validation and Player preview, without embedding Studio.
- Structured six-scene product-intro generation, including a ready-to-customize Xpert AI launch-film template.
- Managed Queue + Sandbox Jobs production rendering through HyperFrames Producer.
- Imported upstream recipe/spec/template assets under
assets/upstream, pinned byUPSTREAM-BASELINE.mdwith attribution preserved. - Canvas/WebCodecs local preview and browser MP4 export for historical JSON video projects only.
Video engine policy
| Project | Composition | Preview | Render |
|---|---|---|---|
| New video | Native HyperFrames HTML | @hyperframes/player | queued @hyperframes/producer Sandbox Action |
| Historical video | Legacy Motion JSON | Canvas | local WebCodecs compatibility export |
The Workbench uses @hyperframes/sdk + @hyperframes/player; the isolated Action uses @hyperframes/producer. HyperFrames Studio is not included. A null engine discriminator on an existing video row is treated as legacy_canvas, so projects are never migrated from content guessing.
Production rendering requires the platform profile browser/video-playwright-1.61/v1 (Node 22, Chromium, FFmpeg), registered Sandbox Jobs and Workspace Files capabilities, Managed Queue, and a healthy sandbox-browser worker. The UI exposes the capability state and will not queue renders until these dependencies are ready.
Package
pnpm --dir apps/motion build
pnpm --dir apps/motion typecheck
pnpm --dir apps/motion testPublic Interfaces
- Package:
@xpert-ai/plugin-motion - Provider:
motion - View:
motion_workbench - Remote component:
motion-workbench - Assistant template:
Motion Assistant - Capabilities:
motion,motion-workbench,agent-motion,motion-library,motion-assistant-template
Middleware Tools
motion_search_recipesmotion_get_recipemotion_create_projectmotion_create_product_intromotion_get_projectmotion_save_web_artifactmotion_save_video_compositionmotion_save_hyperframes_compositionmotion_finalize_versionmotion_export_artifactmotion_update_project_statusmotion_report_failure
Data Model
MotionProjectMotionProjectVersionMotionStyleMotionExportMotionActionLog
All records are scoped by tenant and organization. Production exports are written through platform Workspace Files with input checksum, Action/runtime evidence, progress, and failure details. Roll out the platform video runtime and worker pool before enabling server HD render in production.
