@spec list(
  ArchAstro.Client.t(),
  ArchAstro.Types.Operations.GetApiV1AgentRoutineRuns.Params.t()
) ::
  {:ok, ArchAstro.Types.AgentRoutineRunListResponse.t()}
  | {:error, ArchAstro.Error.reason()}

List agent routine runs

Returns a paginated list of agent routine runs across all routines visible to the authenticated app scope. Results are ordered by creation time descending (most recent first).

Use the agent parameter to filter runs to one or more specific agents. Use status to narrow results to runs in a particular state. Pagination is bidirectional: supply after_cursor to page forward through newer runs or before_cursor to page backward through older runs.

This endpoint requires an app scope. Requests without a valid app credential return 403.

Paginated list of agent routine runs.

@spec stream(ArchAstro.Client.t(), String.t()) ::
  ArchAstro.SSE.Stream.t(
    ArchAstro.Types.Operations.GetApiV1AgentRoutineRunsAgentRoutineRunStream.StreamEvent.t()
  )

Stream agent routine run status

Opens a long-lived Server-Sent Events connection that emits a run_update event whenever the routine run's status changes, replaying the current status immediately on connect. The stream closes when the run reaches a terminal status (completed, failed, skipped, cancelled) or the maximum stream duration elapses (a terminal error event with stream_timeout is sent). Keepalive comments are emitted on an interval to hold the connection open.

Server-Sent Events stream