Interface ISandboxWatchClient

Namespace

OpenShell

Assembly

OpenShell.Sdk.dll

Sandbox watch streams and log retrieval.

public interface ISandboxWatchClient

Methods

GetLogsAsync(string, LogOptions?, CancellationToken)

Fetches buffered log lines once.

ValueTask<LogResult> GetLogsAsync(string sandbox, LogOptions? options = null, CancellationToken cancellationToken = default)

Parameters

sandbox string

options LogOptions

cancellationToken CancellationToken

Returns

ValueTask<LogResult>

WatchAsync(string, WatchOptions?, CancellationToken)

Streams sandbox status, logs, platform events and draft policy updates. The stream reconnects with exponential backoff when the gateway becomes unavailable and resumes from the last cursor it saw. A trimmed cursor is terminal and throws; start a new watch with an empty cursor to recover.

IAsyncEnumerable<WatchEvent> WatchAsync(string sandbox, WatchOptions? options = null, CancellationToken cancellationToken = default)

Parameters

sandbox string

options WatchOptions

cancellationToken CancellationToken

Returns

IAsyncEnumerable<WatchEvent>

WatchLogsAsync(string, WatchOptions?, CancellationToken)

Streams only logs, platform events and warnings; status is never followed. Set FollowLogs and FollowEvents to choose what to receive.

IAsyncEnumerable<WatchEvent> WatchLogsAsync(string sandbox, WatchOptions? options = null, CancellationToken cancellationToken = default)

Parameters

sandbox string

options WatchOptions

cancellationToken CancellationToken

Returns

IAsyncEnumerable<WatchEvent>