Setyenv · Docs
  • English
  • Spanish
  • Chinese
  • Japanese
  • Arabic
  • German
  • French
  • Hindi
  • Indonesian
  • Italian
  • Dutch
  • Portuguese
  • Russian
  • Turkish

Cross-plugin integration

How the four pieces of the suite work together. While each plugin is useful on its own, they compound when installed together.

Architecture

Cross-plugin architecture: PFA designs PFM entities and PFW workflows; PFW reads PFM records and publishes jobs to wp-executor running off-host

What each piece does

  • WP-PFManagement (PFM) — the data layer. Defines entities, fields, forms and lists; emits record events.
  • WP-PFWorkflow (PFW) — the logic layer. Subscribes to PFM events, runs workflow graphs, business rules and the action queue.
  • WP-PFAgent (PFA) — the natural-language interface. Designs PFM entities and PFW workflows from a brief, using the plugins' public REST surfaces.
  • wp-executor — the off-host runner (open-source binary). Polls PFW's HMAC-signed remote queue from outside and reports results back. PFW never initiates a connection to the executor.

End-to-end example. A single brief: "When a support ticket is created, assign it and send an email."

  1. PFA reads PFM's current entity catalog and PFW's node catalog, then proposes the workflow. Every change pauses at the side-effect confirmation gate for your approval before anything is written.
  2. PFW registers the trigger (Ticket created) and the two actions (Send email, Assign user), and runs them when the trigger fires.
  3. PFM stores the Ticket record and fires record.created; PFW reacts and writes back the assignment.
  4. If any action is a long-running or off-host job, PFW enqueues it on the remote queue. wp-executor, running on a host you operate, polls that queue, claims the job, runs it under its local capability allowlist, and posts the result back.

Integration points

IntegrationHow it works
Agent ↔ WorkflowAgent uses the workflow plugin's public REST surface to read the node catalog and propose new workflows; every write goes through the confirmation gate.
Agent ↔ ManagementAgent reads the entity catalog and proposes new entities, fields, or record changes through the management plugin's public REST surface; every write goes through the gate.
Workflow ← ManagementManagement record events (pfm.record.created, etc.) are first-class Workflow triggers. Workflow nodes can read and write Management records.
Management → WorkflowPer-record actions (buttons) trigger workflows. Business Rules dispatch workflows on conditions.
Workflow → wp-executorWorkflow enqueues host-side jobs (shell, file system, outbound HTTP) on the remote queue. The executor polls it and runs jobs under its own capability allowlist.

Using all three together

The most powerful use case: describe a business process in natural language, and the agent builds it end-to-end:

  1. You: "Create a ticket system where high-priority tickets auto-assign to the support team and send a Slack notification".
  2. The agent proposes a Ticket entity in Management (fields: title, description, priority, status, assigned_to) — you confirm.
  3. It proposes a form for ticket creation — you confirm.
  4. It proposes a workflow that triggers on ticket creation, checks priority, assigns the user, and posts to Slack — you confirm.
  5. The system goes live with every change explicitly approved by you.

Licensing

Each commercial plugin is licensed separately. wp-executor is open source.

ComponentWhat you can do aloneWhat you need the others for
WP-PFWorkflow onlyBuild workflow automations with the visual editor.No agent assistance; no structured-data triggers.
WP-PFAgent onlyNothing useful — the agent designs workflows that the engine runs.Requires WP-PFWorkflow installed.
WP-PFManagement onlyBuild structured-data apps with forms and lists. Event system fires but nothing reacts.No workflow automation reacting to record events.
wp-executor onlyRun host-side jobs published by a Workflow install you connect it to.Requires WP-PFWorkflow as the controller.