How chadowsaln/shadow-studio works
Shadow Studio is a local-first desktop video editor with an optional AI-agent workflow. A user edits a timeline and media through the desktop UI; editing commands update the project model, which can be saved locally or rendered through the render pipeline. The agent can plan and execute edits using tools, permissions, and optional provider access. The README documents these capabilities and boundaries, but most Dart implementation files were not sampled; edges below reflect documented relationships, not a source-level call trace. Desktop preview and export are described as simulated.
Main entry points: agent_controller.dart Agent Controller · tool_executor.dart Tool Executor · editor_controller.dart Editor Controller · src Editing Core
Components 19
Desktop Editing
- Desktop App
apps/desktop/lib/src/app.dart - Editing UI
apps/desktop/lib/src/ui - Editor Controller
apps/desktop/lib/src/controller/editor_controller.dart
Editing and Media
- Editing Core
packages/editing_core/lib/src - Project Model
packages/editing_core/lib/src/model/project_document.dart - Media Library
packages/media_core/lib/src/service/media_library_service.dart - Media Worker
packages/media_core/lib/src/worker
Agent and Safety
- Agent Controller
packages/agent_runtime/lib/src/agent_controller.dart - Context Assembly
packages/agent_runtime/lib/src/agent_context_assembler.dart - Agent Planning
packages/agent_runtime/lib/src/planner.dart - Tool Registry
packages/tool_system/lib/src/tool_registry.dart - Tool Executor
packages/tool_system/lib/src/tool_executor.dart - Permission Engine
packages/permissions/lib/src/permission_manager.dart - Provider Gateway
packages/provider_gateway/lib/src/provider_router.dart - Context Engine
packages/context_engine/lib/src/context_builder.dart
Render and Storage
- Render Pipeline
packages/render_pipeline/lib/src/render_queue.dart - Local Storage
packages/local_storage/lib/src
Other components
- Editor
- AI Provider
Connections 21
- Editor → Desktop App: uses
- Desktop App → Editing UI: presents
- Editing UI → Editor Controller: edits through
- Editor Controller → Editing Core: issues commands
- Editing Core → Project Model: updates
- Media Library → Media Worker: delegates media work
- Editor → Media Library: imports media
- Editor → Agent Controller: requests assistance
- Agent Controller → Context Assembly: assembles context
- Agent Controller → Agent Planning: plans tasks
- Agent Controller → Tool Executor: runs tools
- Tool Executor → Tool Registry: dispatches tools
- Tool Executor → Permission Engine: checks permissions
- Tool Executor → Editing Core: applies edits
- Agent Controller → Provider Gateway: requests provider
- Provider Gateway → AI Provider: sends requests
- Context Assembly → Context Engine: builds context
- Editor → Render Pipeline: exports project
- Render Pipeline → Media Worker: renders media
- Editor Controller → Local Storage: saves project
- Agent Controller → Local Storage: stores checkpoints