Skip to content

Variables Provider

Responsibility

Stateless variable operations for workflows. The orchestrator run context owns values and type declarations; this service does not store them.

Design: ADR 0008 — Stateless variables provider.

Capabilities

Capability Path (typical)
variables.number_add /variables/number-add
variables.numbers_add /variables/numbers-add
variables.string_concat /variables/string-concat
variables.scoped_context (designer / metadata)

Workflows call these via type: service_call with binding fields variable_from, operand, apply, result_to.

Example (demo)

flows/workflows/variable_binding_demo.yaml:

- id: add-two
  type: service_call
  capability_name: variables.number_add
  capability_version: "^1.0"
  path: /variables/number-add
  variable_from: context:int
  apply: add
  operand: 2
  result_to: int

Architecture

  • Registers with capability-registry
  • Orchestrator sends operands in the POST body; may attach X-Scoped-Declarations for type-aware checks
  • See also Context & Variables (flows)

Deploy

  • Deployment: variables
  • Service port: 8094 in cluster manifests

Health

  • GET /healthz
  • GET /readyz
  • GET /internal/capabilities