Skip to main content

Events & the Workflow Engine

Subscriberbot is designed to be event-driven. Meaningful changes in the Relationship Graph are published as events, and a Workflow Engine turns those events into automated actions.

The event bus

Every significant change emits an event. Core event types include:

EventEmitted when
SubscriptionCreatedA new Relationship is detected or created.
RenewalDetectedAn upcoming or recurring renewal is identified.
InvoiceReceivedA new invoice arrives for a Relationship.
TrialStartedA free trial begins.
TrialEndingA trial is about to convert to paid.
ChurnPredictedThe AI Brain predicts likely cancellation.

The Workflow Engine

Workflows subscribe to events and run a sequence of steps. They are how "data changes" become "things that happen". Examples of workflows:

When an invoice arrives → classify it → update the subscription → notify finance.

When a renewal is due in 30 days → create an approval task.

When a subscription is cancelled → revoke access and archive its assets.

A workflow, illustrated

name: invoice-to-finance
on: InvoiceReceived
steps:
- classify: { using: ai-brain }
- update: { relationship: $event.relationshipId }
- notify:
channel: slack
audience: finance

How events relate to automations

The Autonomous Subscription Management policies and the agent framework are both consumers of this event bus. A policy such as "auto-cancel unused trials" is, under the hood, a workflow that listens for TrialEnding and evaluates usage before acting. See the Automations guide for how to build these.

Data platform

Events also flow into the Data Platform, which includes a subscription data lake, an analytics warehouse, the knowledge graph, an embedding store, and an AI memory store. Together these give the AI Brain both the history and the context it needs to reason well.