Skip to content

Workflow System

A declarative, AI-native workflow orchestration framework for building scalable, composable, and adaptive execution pipelines.

1. Introduction

The Workflow System is a JSON-based Domain Specific Language (DSL) and execution engine designed to orchestrate complex pipelines composed of:

  • Deterministic policies
  • AI agents
  • Nested workflows

Each workflow defines what to execute, how to execute it, and how execution flows between steps.

At runtime, a workflow is interpreted by the executor, which coordinates execution across multiple subsystems such as policy engines, agent delegation services, and sub-workflow runners.

The system supports two execution paradigms:

  • Static Workflows — Predefined DAG-based execution
  • Dynamic Workflows — Runtime decision-making via router agents

This enables use cases ranging from simple pipelines to advanced multi-agent, decision-driven systems.

2. Key Features

Declarative Workflow Definition

Workflows are defined as structured JSON with clear separation of identity (header) and execution logic (body). This ensures portability, validation, and consistency.

Strong Versioning and Identity

Each workflow is uniquely identified using:


{name}:{version}-{release}

This allows: - Immutable workflow versions - Safe upgrades and rollbacks - Reliable referencing across systems

Multiple Execution Primitives

Workflows support three core node types:

  • Policy Nodes — Deterministic logic (rules, APIs, jobs)
  • Agent Nodes — AI-driven execution via delegate APIs
  • Workflow Nodes — Nested workflows for composition

Static and Dynamic Execution Models

Static (DAG-based): - Predefined execution graph - Topological ordering - Parallel execution support

Dynamic (Router-based): - Execution determined at runtime - Controlled by a router agent - Enables conditional branching, loops, and adaptive flows

Parallelism and Dependency Handling

  • Native support for parallel execution
  • Automatic input resolution:
  • Single parent → direct input
  • Multiple parents → aggregated inputs

Progressive Data Enrichment

Execution follows a cumulative data model:

  • Initial input flows through all nodes
  • Each node enriches or transforms the data
  • Final output contains the full execution context

Composability

Workflows can call other workflows as nodes, enabling:

  • Modular design
  • Reusability
  • Hierarchical orchestration

Long-Running Task Support

Using job-based policies: - Asynchronous execution - Polling and retries - External compute integration

AI-Native Orchestration

Agents can: - Execute tasks - Route workflows dynamically - Make decisions based on context

This enables advanced use cases like: - Multi-agent systems - LLM pipelines - Autonomous workflows

End-to-End Lifecycle

Workflows follow a complete lifecycle:

  1. Author workflow JSON
  2. Register workflow
  3. Deploy execution controller
  4. Execute tasks

3. Table of contents

Use the following documents to understand and work with the system:

4. Summary

The Workflow System provides a unified framework for building:

  • Deterministic pipelines
  • AI-driven workflows
  • Adaptive, decision-based execution systems

By combining declarative definitions with dynamic execution capabilities, it enables scalable and flexible orchestration across a wide range of applications.