Workflow Packages

Platform packages publish from the vyuh_workflow repository to https://pub.vyuh.tech. CDX keeps cdx_feature_workflows and product integration. A workflow server does not need Flutter. A Flutter inbox does not embed the runtime.

Authenticate with pub.vyuh.tech first

Workflow packages is hosted on the private pub.vyuh.tech registry. Before running pub get, register a Bearer token issued by Vyuh Technologies based on your plan.

Run the one-time setup:

dart pub token add https://pub.vyuh.tech

Don't have a token yet? Email [email protected] to request one. For full details (CI, Docker, rotation, troubleshooting), see the Pub Token Setup guide.

Packages

Package	Version	Role
vyuh_workflow_engine	3.5.1	Durable WorkflowRuntime: definitions, replay, history, commands, activities, user tasks, signals, timers, joins, and WorkflowStorage contracts.
vyuh_workflow_storage_supabase	3.4.2	PostgreSQL adapter and installer for the durable runtime schema: versions, runs, events, commands, user tasks, and signals.
vyuh_workflow_service	0.1.3	Transport-neutral product API plus WorkflowServerApplication: runs, tasks, signals, cancel/redrive/retry, and operations.
vyuh_workflow_testkit	0.1.3	In-process harness plus load, soak, and chaos campaigns against the public HTTP surface.
vyuh_workflow_inspector	0.1.4	Embeddable inspector for run history, commands, and audited operator actions.
cdx_workflow_types	0.4.3+5	Shared approval, user-task action, activity, and entity-status contracts used by templates and Flutter inboxes.
cdx_workflow_templates	0.4.9+11	Canonical approval family with a durable Dart definition and a legacy graph definition for parity.
cdx_feature_workflows	0.3.22+23	Flutter inbox primitives, action bar, status card, and timeline. Lives in the CDX repo; consumes published workflow packages.
vyuh_workflow_protocol	2.2.2	Editor and inspector transport for watching runs. Product mutations go through the workflow service.
vyuh_workflow_editor	2.1.2	Visual authoring and simulation for constrained workflow documents.

• vyuh_workflow_engine3.5.1

  Durable WorkflowRuntime: definitions, replay, history, commands, activities, user tasks, signals, timers, joins, and WorkflowStorage contracts.

• vyuh_workflow_storage_supabase3.4.2

  PostgreSQL adapter and installer for the durable runtime schema: versions, runs, events, commands, user tasks, and signals.

• vyuh_workflow_service0.1.3

  Transport-neutral product API plus WorkflowServerApplication: runs, tasks, signals, cancel/redrive/retry, and operations.

• vyuh_workflow_testkit0.1.3

  In-process harness plus load, soak, and chaos campaigns against the public HTTP surface.

• vyuh_workflow_inspector0.1.4

  Embeddable inspector for run history, commands, and audited operator actions.

• cdx_workflow_types0.4.3+5

  Shared approval, user-task action, activity, and entity-status contracts used by templates and Flutter inboxes.

• cdx_workflow_templates0.4.9+11

  Canonical approval family with a durable Dart definition and a legacy graph definition for parity.

• cdx_feature_workflows0.3.22+23

  Flutter inbox primitives, action bar, status card, and timeline. Lives in the CDX repo; consumes published workflow packages.

• vyuh_workflow_protocol2.2.2

  Editor and inspector transport for watching runs. Product mutations go through the workflow service.

• vyuh_workflow_editor2.1.2

  Visual authoring and simulation for constrained workflow documents.

How They Fit Together

Product Flutter UI
  cdx_feature_workflows
    -> authenticated product API
      -> vyuh_workflow_service
        -> WorkflowRuntime + workers
          -> WorkflowStorage (Supabase/PostgreSQL)

cdx_workflow_templates
  durable ApprovalWorkflowDefinition
  plus a legacy graph definition for in-flight runs

cdx_workflow_types
  shared approval and inbox contracts

vyuh_workflow_inspector
  reads runs, events, and commands

Package Order

Step	Package	Decision
1	vyuh_workflow_engine	Define and execute durable workflows
2	vyuh_workflow_storage_supabase	Install the runtime schema and persist history
3	vyuh_workflow_service	Expose the product and operations HTTP API
4	cdx_workflow_types	Share approval and inbox contracts
5	cdx_workflow_templates	Register the canonical approval definition
6	cdx_feature_workflows	Render inbox rows, actions, status, and timeline
7	vyuh_workflow_inspector	Inspect history and take audited recovery actions
8	vyuh_workflow_testkit	Drive the same runtime in tests and campaigns

Workflow Server

dependencies:
  vyuh_workflow_engine:
    hosted: https://pub.vyuh.tech
    version: ^3.5.1
  vyuh_workflow_storage_supabase:
    hosted: https://pub.vyuh.tech
    version: ^3.4.2
  vyuh_workflow_service:
    hosted: https://pub.vyuh.tech
    version: ^0.1.3
  cdx_workflow_templates:
    hosted: https://pub.vyuh.tech
    version: ^0.4.9

Import the durable surface:

import 'package:vyuh_workflow_engine/vyuh_workflow_runtime.dart';

Flutter Inbox

dependencies:
  cdx_workflow_types:
    hosted: https://pub.vyuh.tech
    version: ^0.4.3
  cdx_feature_workflows:
    hosted: https://pub.vyuh.tech
    version: ^0.3.22

cdx_feature_workflows renders tasks. It does not start runs or talk to workflow tables. The product API calls the workflow service.

Package Boundaries

Package	Boundary
vyuh_workflow_engine	No Flutter, no product domain, no SQL.
vyuh_workflow_storage_supabase	Schema, RPCs, and row mapping only.
vyuh_workflow_service	Trusted product API and workers.
cdx_workflow_types	Contracts only.
cdx_workflow_templates	Canonical definitions and activity refs.
cdx_feature_workflows	Flutter inbox UI.
vyuh_workflow_inspector	Observation and audited operator actions.

See Also

• Installation
• Quick Start
• CDX Integration