runtime

Run inspection, cancellation, retries, audits, and human approval queues.

Source path: libraries/agent/src/controllers/agent.controller.ts

Module file: agent.module.ts

Introduction

The Runtime submodule is the observability and control surface for workflow executions after they have started. It exposes run lists, detailed inspection endpoints, retry/cancel actions, and related audit streams.

Human approvals are treated as part of runtime rather than design time: workflows can pause for approval and then be resumed, approved, or rejected through these endpoints.

HTTP Endpoints

14 endpoints

List pending and historical human approvals.

Get one approval request.

Params: approvalId (int)

Approve a human approval request.

Params: approvalId (int)

Reject a human approval request.

Params: approvalId (int)

List all runs.

Get one run.

Params: runId (int)

Cancel a run.

Params: runId (int)

Retry a run.

Params: runId (int)

List run steps.

Params: runId (int)

List run events.

Params: runId (int)

List run state transitions.

Params: runId (int)

List run decision records.

Params: runId (int)

List tool invocations performed by a run.

Params: runId (int)

Return the audit trail for a run.

Params: runId (int)