github.workflow-job

Handle GitHub workflow_job webhook events — confirm runner claim

DAG-based GitHub workflow_job handler.

Routes workflow_job: in_progress events to runner.execution-claim-watch so the system knows the runner agent registered and claimed the job.

Overview

Property	Value
Workflow type	Dag
Library	App-github
Version	1.0

Input Schema

Field	Type	Required	Default	Description
delivery_ref	string	Yes	—	Webhook delivery ID
event_type	string	Yes	—	Webhook event type
action	string	No	—	Webhook action
payload	dict	Yes	—	Webhook payload
organization_uuid	string	No	—	Organization UUID (public)

Output Schema

Field	Type	Required	Default	Description
delivery_ref	string	No	—	—
event_type	string	No	—	—
action	string	No	—	—
payload	dict	No	—	—
organization_uuid	string	No	—	—
workflow_run_uuid	string	No	—	—
validate	dict	No	—	—
handle	dict	No	—	—
failure_reason	string	No	—	—
failure_type	string	No	—	—
failed_action	string	No	—	—
failed_at_state	string	No	—	—
failed_step	string	No	—	—
failed_layer	integer	No	—	—
error	string	No	—	—
error_type	string	No	—	—

DAG Layers

#	Layer	Steps	Compensation
1	validate	github.workflow-job-validate	—
2	handle	github.workflow-job-handle	—

Execution Flow

Sub-workflows

Sub-workflow	Step name
github.workflow-job-validate	validate
github.workflow-job-handle	handle

Business Errors

Code	Message Template
WORKFLOW_JOB_ERROR	An unknown error occurred

API Usage

POST /api/workflows/start
Content-Type: application/json

{
  "workflow_type": "github.workflow-job",
  "initial_data": {
    "delivery_ref": "value",
    "event_type": "value",
    "payload": "value"
  }
}