.NET API
IWorkflowRunner
Tracon.Abstractions.dllReads the workflow catalog and runs workflows.
public interface IWorkflowRunnerRemarks
Section titled “Remarks”The abstraction lives in Tracon.Abstractions because the HTTP
layer runs workflows but does not depend on the
Tracon.Workflows package. This is the same pattern established
with IMcpToolRefresher in MCP: the workflow engine stays an
optional package, and a consumer who does not use it does not pull in a
130-type execution engine.
The contract carries no Microsoft Agent Framework type. Events flow
through Tracon’s own RunEvent type; the conversion from
MAF events happens inside Tracon.Workflows.
Delivery guarantee — AT-LEAST-ONCE, on IWorkflowRunner.ResumeStreamingAsync
specifically. Resuming from a run’s LATEST checkpoint after it has
already completed does not re-run anything — there is nothing left to do. But
resuming from an EARLIER checkpoint (the shape a real crash recovery takes)
replays every super-step from that point forward, including any
AddWorkflowFunction<T> handler node in them, with the SAME
input — this is exactly the reason a workflow function handler with a real
side effect must be idempotent (see AddWorkflowFunction<T>’s
own remarks, where this was originally documented). IWorkflowRunner.RunStreamingAsync
and IWorkflowRunner.RespondStreamingAsync carry no such guarantee of their own:
each opens a fresh run and does not replay prior work.
Methods
Section titled “Methods”GetAsync(string, CancellationToken)
Section titled “ GetAsync(string, CancellationToken)”Fetches a single workflow’s summary.
ValueTask<WorkflowDescriptor?> GetAsync(string name, CancellationToken cancellationToken = default)Parameters
Section titled “Parameters”name string
The workflow name.
cancellationToken CancellationToken
The cancellation token.
Returns
Section titled “Returns”ValueTask<WorkflowDescriptor?>
The summary; null if it does not exist.
GetGraphAsync(string, CancellationToken)
Section titled “ GetGraphAsync(string, CancellationToken)”Compiles a workflow and extracts its graph.
ValueTask<WorkflowGraph?> GetGraphAsync(string name, CancellationToken cancellationToken = default)Parameters
Section titled “Parameters”name string
The workflow name.
cancellationToken CancellationToken
The cancellation token.
Returns
Section titled “Returns”The graph; null if the workflow is not in the catalog.
Remarks
Section titled “Remarks”The graph is actually compiled: the helper nodes added by prebuilt patterns are visible only after compilation, and the executor identifiers in run events come from there too. Compilation makes no agent call, it only wires up the wrappers.
ListAsync(CancellationToken)
Section titled “ ListAsync(CancellationToken)”Lists the workflows in the catalog (defined in code + database).
ValueTask<IReadOnlyList<WorkflowDescriptor>> ListAsync(CancellationToken cancellationToken = default)Parameters
Section titled “Parameters”cancellationToken CancellationToken
The cancellation token.
Returns
Section titled “Returns”ValueTask<IReadOnlyList<WorkflowDescriptor>>
The summaries.
ListPendingRequestsAsync(Guid, CancellationToken)
Section titled “ ListPendingRequestsAsync(Guid, CancellationToken)”Lists a run’s pending human-input requests.
ValueTask<IReadOnlyList<WorkflowPendingRequest>> ListPendingRequestsAsync(Guid runId, CancellationToken cancellationToken = default)Parameters
Section titled “Parameters”runId Guid
The run identifier.
cancellationToken CancellationToken
The cancellation token.
Returns
Section titled “Returns”ValueTask<IReadOnlyList<WorkflowPendingRequest>>
The pending requests; an empty list if none.
Exceptions
Section titled “Exceptions”The run does not exist or belongs to another tenant.
RespondStreamingAsync(WorkflowRespondRequest, CancellationToken)
Section titled “ RespondStreamingAsync(WorkflowRespondRequest, CancellationToken)”Responds to a pending request and resumes the run from its checkpoint.
IAsyncEnumerable<RunEvent> RespondStreamingAsync(WorkflowRespondRequest request, CancellationToken cancellationToken = default)Parameters
Section titled “Parameters”request WorkflowRespondRequest
The response.
cancellationToken CancellationToken
The cancellation token.
Returns
Section titled “Returns”The ordered event stream.
Remarks
Section titled “Remarks”Resuming opens a new run record; the same rule as IWorkflowRunner.ResumeStreamingAsync. The response is matched to the request republished from the checkpoint by identifier.
ResumeStreamingAsync(WorkflowResumeRequest, CancellationToken)
Section titled “ ResumeStreamingAsync(WorkflowResumeRequest, CancellationToken)”Resumes from a checkpoint and streams its events.
IAsyncEnumerable<RunEvent> ResumeStreamingAsync(WorkflowResumeRequest request, CancellationToken cancellationToken = default)Parameters
Section titled “Parameters”request WorkflowResumeRequest
The resume request.
cancellationToken CancellationToken
The cancellation token.
Returns
Section titled “Returns”The ordered event stream.
Remarks
Section titled “Remarks”Resuming opens a new run record. Reopening the same row would break the event stream’s append-only rule and would leave “when did this run end” unanswered.
RunStreamingAsync(WorkflowRunRequest, CancellationToken)
Section titled “ RunStreamingAsync(WorkflowRunRequest, CancellationToken)”Runs a workflow and streams its events.
IAsyncEnumerable<RunEvent> RunStreamingAsync(WorkflowRunRequest request, CancellationToken cancellationToken = default)Parameters
Section titled “Parameters”request WorkflowRunRequest
The run request.
cancellationToken CancellationToken
The cancellation token.
Returns
Section titled “Returns”The ordered event stream.
Remarks
Section titled “Remarks”The first event is always RunEventType.RunStarted, and its RunEvent.RunId field carries the run identifier; the caller learns the identifier from the stream’s first frame.