Skip to main content

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​

SourcePurpose
valkyrai/src/main/java/com/valkyrlabs/workflow/modulesJava runtime modules.
valkyrai/src/main/java/com/valkyrlabs/workflow/modules/metadataAnnotation metadata for module docs, schemas, examples, dependencies, and behavior.
valkyrai/src/main/java/com/valkyrlabs/workflow/modules/core/ModuleMetadataController.javaMetadata API used by Studio.
valkyrai/src/main/java/com/valkyrlabs/workflow/validation/ExecModuleConfigValidator.javaNormalized config validation.
web/typescript/valkyr_labs_com/src/components/WorkflowStudio/execModuleCatalog.tsCurrent Studio catalog and defaults.
web/typescript/valkyr_labs_com/src/services/moduleMetadataService.tsFrontend metadata service for /modules/metadata.

Studio Catalog​

The current Studio catalog groups modules by customer intent:

CategoryModules
Digital ProductsDigital Product Manager
AI & ContentFunnel Generator, AI Chat, Agent Decision, Agent Completion; retired direct ValorIDE Executor migration
AI & MemoryGrayMatter, Omega Retrieval; retired MemoryIndex migration
SocialInstagram Publish, X Post, LinkedIn Company Share, Facebook Page Post, TikTok Publish
MeetingsZoom Meeting, Calendly Scheduling
MessagingEmail Recipients, Twilio Send, Slack Post, Discord Post, Teams Post, SendGrid Email, Mailtrap Send, MailerSend Send
CRM & SalesHubSpot CRM, Zoho CRM, Salesforce
PaymentStripe Payments; retired Mastercard AgentPay migration; Crypto Buy/Sell
APIREST API, GraphQL, gRPC, WebSocket Client, Webhook Receiver, Webhook Relay; retired OpenAPI Import migration
Inbound DataWebhook Ingest
Build & DeployBuild Java, Engineering Project Command, Deployment Runner, AWS Fargate Launch, Instance Launch; retired Bash Script Exec, Build Project, and Deploy via SCP migrations
File / ProjectWorkspace File Read; retired arbitrary File System migration
Valkyr PlatformProject
OperationsActuator Read
CacheRedis Cache
DatabaseMongoDB
Data TransformMap, Filter, Sort, Group By, Flatten, Merge, Join, Transpose, Deduplicate
Data MappingJSON Path Mapper, XML/JSON/CSV converters, Schema Mapper, Type Converter
API ConnectorGoverned REST + Schema Mapper composition; retired arbitrary API Bridge and generic SQL-to-database migrations; Webhook to API Relay, Database Poller, GraphQL Data Federation, Change Data Capture
AnalyticsMulti-Source Aggregation, Time Series Aggregation, Statistical Analysis
Control FlowAdaptive Cadence, Conditional Branch, Parallel Executor, Loop Iterator, Advanced Looper, Multi-Threader, Retry Policy Manager; retired PipelineModule migration
BasicMap Inject for bounded, non-secret fixture state.
Data QualityData 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​

ModulePurposePrimary objects
ProjectDeterministic 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:

  • auth binds IntegrationAccounts or explicit credentials.
  • execution controls timeout, retries, idempotency, and behavior.
  • io describes input/output mappings.
  • observability configures logs, status, metrics, and traces.
  • rateLimit, payload, resources, transport, and audience provide module-specific controls without adding one-off legacy fields.