Skip to main content

ValkyrAI

ValkyrAI is the agentic workflow engine inside the Valhalla suite. It runs workflows, tasks, ExecModules, approval steps, schedules, and MCP-published tools over the same ThorAPI-generated objects, RBAC rules, memory controls, and deployment surfaces used by the rest of the platform.

What Is ValkyrAI?​

At its core, ValkyrAI turns business processes into reviewable automation. A workflow can read generated objects, call integrations, branch on formula or data conditions, use configured LLMDetails, write progress back to the project, and publish selected capabilities as MCP tools for ValorIDE or other agents.

How It Fits​

  • ThorAPI generates the REST APIs, Java models, repositories, clients, RBAC-visible objects, and component contracts.
  • ValkyrAI runs workflows against those generated objects and integrations.
  • GrayMatter supplies durable memory, semantic context, and RBAC-scoped object graph access.
  • Valor guides users through chat-driven creation and operational work.
  • ValorIDE owns agentic coding, local workspace edits, tool use, tests, and publish-back workflows.
  • Gridheim Runes and Sheetster bring spreadsheet formulas and data workbooks into generated object workflows.
  • SWARM Ops coordinates agent registration, presence, commands, and telemetry.

Key Capabilities​

  • Agentic workflow runtime – create, schedule, and monitor workflows/tasks/execution modules via REST or ValorIDE-driven commands.
  • ThorAPI code generation – transform OpenAPI specs into secured Spring Boot services and typed React/TypeScript clients with minimal configuration.
  • SecureField & KMS – built-in field-level encryption, key rotation, and helpers for running jobs under system accounts.
  • Model Context Protocol – expose ValkyrAI automation as MCP tools so ValorIDE (and other agents) can delegate work safely.
  • Valhalla control integration – use /v1/graymatter/control so ValorIDE, Valor, CODEX, OpenClaw, Claude adapters, and Sheetster Grid can discover memory, semantic health, RBAC object graph, SwarmOps, and Agent endpoints. Gridheim Runes are generated object behavior inside that RBAC-visible graph, not a separate client.
  • Observability & dashboards – dashboard, Workflow Studio, and run monitoring surfaces keep track of costs, tokens, job health, and outcomes.
  • Cloud connectors – AWS Bedrock/Vertex/Gemini credentials, STS role helpers, and workflow step integrations for enterprise environments.

Documentation Map​

  • Valhalla Suite Atlas – relationship charts for ThorAPI, ValkyrAI, GrayMatter, Valor, ValorIDE, Gridheim Runes, Sheetster, RBAC, workflow, MCP, SWARM, and admin surfaces.
  • App Generation – generated apps, component library, Aurora/design system, bundled app templates, and ValorIDE handoff.
  • Overview – product positioning, architecture diagrams, and high-level capabilities.
  • Getting Started – environment setup (Java 17, Maven, Node), project generation, and local run instructions.
  • Developers Guide – deep dives into modules, security, and operational recipes.
  • Workflow Engine – design of the BPM and agentic runtime.
  • Workflow Studio How-To – creating workflows with ExecModules, IntegrationAccounts, LLMDetails, Valor, and MCP publishing.
  • Persona, RBAC, and Entitlements – how customer type, user preference, RBAC, subscription, and feature gates combine.
  • SecureFieldKMS – encryption patterns and key custody recommendations.
  • Model Context Protocol – MCP server implementation details used by ValorIDE.
  • Deployments – hosted instances, AWS, GCP/Azure, downloadable jars, and ValorIDE publish-back.
  • Quality and Reliability – journey QA, contract tests, screenshots, schema validation, and docs builds.
  • Utilities – helper CLIs, importers, and admin tasks.

ValkyrAI & ValorIDE​

ValorIDE uses ValkyrAI as its workflow engine for long-running tasks, ThorAPI generation workflows, and organization-level approvals. Many extension features call Valhalla api-0 surfaces, invoke the valkyrai workflow module, or read artifacts generated in thorapi/.

ValorIDE is both a GrayMatter client and a SWARM agent. On current builds it should load /v1/graymatter/control, register live presence through /v1/swarm-ops/register, use GrayMatter for durable agentic memory, and use the RBAC-visible OpenAPI schema as its object graph for application generation and system work.

Getting Help​