How gml-mmgroup/adcraft works
AdCraft turns a marketing brief into an editable advertising-production workflow: creative planning and script, product/character/scene design, storyboard, media generation, and final composition. Users can refine work through canvas operations or conversation, while the asset library supports reuse. The graph combines README-documented capabilities with paths in the supplied tree; several feature paths were not sampled, so uncertain internal call wiring is omitted. The shown generation and persistence layers reflect sampled source responsibilities, not a complete call trace.
Main entry points: agent_canvas.py Workflow API · v2_generation_pipeline.py Generation Pipeline · agent_canvas_production_journey.py Creative Planning · canvas_runtime.py Canvas API
Components 20
Creation Experience
- Agent Canvas
apps/web/src/features/agent-canvas/session/useAgentCanvasSession.ts - Conversation
apps/web/src/features/agent-canvas/chat/useComposerContext.ts - Canvas API
apps/api/app/api/v1/endpoints/canvas_runtime.py - Workflow API
apps/api/app/api/v2/endpoints/agent_canvas.py
Creative Workflow
- Creative Planning
apps/api/app/services/agent_canvas_production_journey.py - Script and Designs
apps/api/app/services/agent_canvas_nodes.py - Storyboard
apps/api/app/services/agent_canvas_storyboard_sequences.py - Editable Workflow
apps/api/app/services/agent_canvas_commands.py - Specialist Prompts
apps/api/app/services/v2_specialist_llm_client.py
Media Generation
- Generation Pipeline
apps/api/app/services/v2_generation_pipeline.py - Image Provider
apps/api/app/tools/volcengine_image_generations.py - Music Provider
apps/api/app/tools/volcengine_pure_music.py - Final Composition
apps/api/app/services/final_composition_timeline.py
Assets and State
- Asset Library
apps/api/app/services/asset_library.py - Media Storage
apps/api/app/services/v2_storage_adapter.py - Application State
apps/api/app/persistence/database.py - Browser Storage
apps/web/src/storage/hybridStorage.ts
Agent Runtime
- HTTP Application
apps/api/app/main.py - Agent Service
apps/api/agent/src/server.ts
Other components
- Marketer
Connections 23
- Marketer → Agent Canvas: describes and edits
- Marketer → Conversation: requests changes
- Agent Canvas → Canvas API: submits canvas actions
- Conversation → Workflow API: sends creative context
- Canvas API → Creative Planning: starts guided creation
- Workflow API → Creative Planning: requests workflow work
- Creative Planning → Script and Designs: plans creative stages
- Creative Planning → Storyboard: plans shots
- Creative Planning → Editable Workflow: creates editable flow
- Editable Workflow → Workflow API: returns workflow state
- Workflow API → Specialist Prompts: requests structured prompts
- Generation Pipeline → Image Provider: submits image work
- Generation Pipeline → Music Provider: submits music work
- Generation Pipeline → Media Storage: publishes media
- Generation Pipeline → Asset Library: publishes generated assets
- Generation Pipeline → Final Composition: prepares composition
- Asset Library → Media Storage: stores media objects
- Canvas API → Application State: persists workflow state
- Workflow API → Application State: persists workflow state
- Agent Canvas → Browser Storage: caches project state
- HTTP Application → Canvas API: routes requests
- HTTP Application → Workflow API: routes requests
- Agent Service → HTTP Application: serves internal agent runs