ExecModules
ExecModules are the execution units inside ValkyrAI tasks. A workflow contains tasks; tasks contain ordered ExecModule chains. Studio users configure those chains visually, Valor can create them by chat, and the backend validates normalized ExecModuleConfig before execution.
Code-Grounded Sources
| Source | Purpose |
|---|---|
valkyrai/src/main/java/com/valkyrlabs/workflow/modules | Java runtime modules. |
valkyrai/src/main/java/com/valkyrlabs/workflow/modules/metadata | Annotation metadata for module docs, schemas, examples, dependencies, and behavior. |
valkyrai/src/main/java/com/valkyrlabs/workflow/modules/core/ModuleMetadataController.java | Metadata API used by Studio. |
valkyrai/src/main/java/com/valkyrlabs/workflow/validation/ExecModuleConfigValidator.java | Normalized config validation. |
web/typescript/valkyr_labs_com/src/components/WorkflowStudio/execModuleCatalog.ts | Current Studio catalog and defaults. |
web/typescript/valkyr_labs_com/src/services/moduleMetadataService.ts | Frontend metadata service for /modules/metadata. |
Studio Catalog
The current Studio catalog groups modules by customer intent:
| Category | Modules |
|---|---|
| Digital Products | Digital Product Manager |
| Social | Instagram Publish, X Post, LinkedIn Company Share, Facebook Page Post, TikTok Publish |
| Meetings | Zoom Meeting, Calendly Scheduling |
| Messaging | Twilio Send, Slack Post, Discord Post, Teams Post, SendGrid Email |
| Payment | MasterCard AgentPay, Crypto Buy/Sell |
| API | REST API, GraphQL, gRPC, WebSocket Client, Webhook Receiver |
| Build & Deploy | Build Java, Build Project, Deploy via SCP, Instance Launch |
| Valkyr Platform | Project |
| Operations | Actuator Read |
| Data Transform | Map, Filter, Sort, Group By, Flatten, Merge, Join, Transpose, Deduplicate |
| Data Mapping | JSON Path Mapper, XML/JSON/CSV converters, Schema Mapper, Type Converter |
| API Connector | API Bridge, SQL to Database Sync, Webhook to API Relay, Database Poller, GraphQL Data Federation, Change Data Capture |
| Analytics | Multi-Source Aggregation, Time Series Aggregation, Statistical Analysis |
| Control Flow | Conditional Branch, Parallel Executor, Loop Iterator, Advanced Looper, Multi-Threader, Retry Policy Manager |
| Data Quality | Data Validator, Data Cleaner, Fuzzy Duplicate Detector |
Backend Module Families
The Java module tree also includes AI, analytics, API, auth, AWS/Azure/GCP, database, deep learning, document, email, ERP, file, integration, marketing, OpenAPI, ops, payment, quality, REST, SCM, social, transform, utility, and Valkyr platform modules. Studio should prefer backend metadata where available, then fall back to the curated frontend catalog.
Valkyr Platform Modules
| Module | Purpose | Primary objects |
|---|---|---|
| Project | Deterministic CRUD and linking for strategy-backed Projects. Workflows can create Projects, advance stages, and connect goals, tasks, workflows, generated applications, deployments, MCP services, memory entries, and typed object links. | Project, ProjectObjectLink, Goal, Task, Workflow, Application, Deployment, Mcp, MemoryEntry |
Configuration ABI
Every module should converge on normalized ExecModuleConfig:
authbinds IntegrationAccounts or explicit credentials.executioncontrols timeout, retries, idempotency, and behavior.iodescribes input/output mappings.observabilityconfigures logs, status, metrics, and traces.rateLimit,payload,resources,transport, andaudienceprovide module-specific controls without adding one-off legacy fields.