Queue System

The Queue System manages the execution of automation projects.

How It Works

1. When you run a project, a queue record is created with status pending.
2. The queue processor picks up the record and starts execution.
3. The status changes to running.
4. When execution completes, the status changes to completed, failed, or stopped.

Queue Statuses

Status	Description
pending	Waiting to start
running	Currently executing
completed	Finished successfully
failed	Finished with errors
stopped	Manually stopped by the user
killed	Force-killed

Queue Record Fields

Field	Description
type	project_run or relay_run
status	Current status
args	Command-line arguments for the execution engine
project	Associated project ID
session	Associated session ID
chat	Associated chat ID (if triggered from AI chat)
owner	Owner profile ID
scheduler	Associated scheduler ID (if scheduled)
checkpoint	Checkpoint data for resume
variables	Runtime variables

Monitoring the Queue

The queue is monitored in real-time via PocketBase subscriptions. The Project Runs page shows the current status of all executions.

Stopping a Running Project

1. Go to Automation Projects.
2. Select the running project.
3. Click Run (which opens the Live Monitor).
4. Click Stop Project.
5. The queue record status changes to stopped.

Relay Runs

When a project has triggers configured, a separate relay run is created after the main execution completes. The relay run processes the triggers sequentially.