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	4.0.0	Schemas, workflows, operations, work, events, timers, structured composition, replay, history, commands, and WorkflowStorage.
vyuh_workflow_storage_supabase	4.0.2	PostgreSQL adapter and installer for durable versions, runs, history, commands, work items, and pending events.
vyuh_workflow_service	0.1.6	Transport-neutral product API plus WorkflowServerApplication: runs, work, events, cancel/redrive/retry, and operations.
vyuh_workflow_testkit	0.1.6	In-process harness plus load, soak, and chaos campaigns against the public HTTP surface.
vyuh_workflow_inspector	0.1.6	Embeddable inspector for run history, commands, and audited operator actions.
cdx_workflow_types	0.4.3+5	Shared approval, work-action, operation, and entity-status contracts used by templates and Flutter inboxes.
cdx_workflow_templates	1.0.0	Canonical approval workflow family exposed through ApprovalWorkflowHandlerFactory.
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.4	Editor and inspector transport for watching runs. Product mutations go through the workflow service.
vyuh_workflow_editor	2.1.4	Visual authoring and simulation for constrained workflow documents.

• vyuh_workflow_engine4.0.0

  Schemas, workflows, operations, work, events, timers, structured composition, replay, history, commands, and WorkflowStorage.

• vyuh_workflow_storage_supabase4.0.2

  PostgreSQL adapter and installer for durable versions, runs, history, commands, work items, and pending events.

• vyuh_workflow_service0.1.6

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

• vyuh_workflow_testkit0.1.6

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

• vyuh_workflow_inspector0.1.6

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

• cdx_workflow_types0.4.3+5

  Shared approval, work-action, operation, and entity-status contracts used by templates and Flutter inboxes.

• cdx_workflow_templates1.0.0

  Canonical approval workflow family exposed through ApprovalWorkflowHandlerFactory.

• 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.4

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

• vyuh_workflow_editor2.1.4

  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 ApprovalWorkflowHandlerFactory

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: ^4.0.0
  vyuh_workflow_storage_supabase:
    hosted: https://pub.vyuh.tech
    version: ^4.0.2
  vyuh_workflow_service:
    hosted: https://pub.vyuh.tech
    version: ^0.1.6
  cdx_workflow_templates:
    hosted: https://pub.vyuh.tech
    version: ^1.0.0

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 work items. 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 operation contracts.
cdx_feature_workflows	Flutter inbox UI.
vyuh_workflow_inspector	Observation and audited operator actions.

See Also

• Installation
• Quick Start
• CDX Integration