nominal 1.100.0__py3-none-any.whl → 1.102.0__py3-none-any.whl

CHANGELOG.md

@@ -1,5 +1,37 @@
 # Changelog
 
+## [1.102.0](https://github.com/nominal-io/nominal-client/compare/v1.101.0...v1.102.0) (2026-01-05)
+
+
+### Features
+
+* add run creation on an asset ([#558](https://github.com/nominal-io/nominal-client/issues/558)) ([9c0718a](https://github.com/nominal-io/nominal-client/commit/9c0718ae2706d4192087fb787e99f76d702a18c9))
+* add util to search events by origin type and add clone/copy events ([#555](https://github.com/nominal-io/nominal-client/issues/555)) ([bc427d6](https://github.com/nominal-io/nominal-client/commit/bc427d6b97a777e6802dc8139c8d389582558a77))
+* allow unarchiving a run ([#560](https://github.com/nominal-io/nominal-client/issues/560)) ([0221a56](https://github.com/nominal-io/nominal-client/commit/0221a56c73d133581567cc5183fda237607d79b5))
+* clean up and deprecate old video creation methods in NominalClient ([#561](https://github.com/nominal-io/nominal-client/issues/561)) ([e61919c](https://github.com/nominal-io/nominal-client/commit/e61919ca338a5e0de818471431d750246d87977c))
+
+
+### Bug Fixes
+
+* update how workspaces are selected in migration_utils ([#559](https://github.com/nominal-io/nominal-client/issues/559)) ([4379121](https://github.com/nominal-io/nominal-client/commit/4379121f44411eed19248ee16540672bbed743a0))
+
+## [1.101.0](https://github.com/nominal-io/nominal-client/compare/v1.100.0...v1.101.0) (2025-12-23)
+
+
+### Features
+
+* add search_events to asset ([#553](https://github.com/nominal-io/nominal-client/issues/553)) ([3d291b7](https://github.com/nominal-io/nominal-client/commit/3d291b7e4b851676de882ac88d7695e49e9da0d3))
+* added avi video file type ([#552](https://github.com/nominal-io/nominal-client/issues/552)) ([84bd35f](https://github.com/nominal-io/nominal-client/commit/84bd35ff83aa87cf8f7a718b5d71c1ca1445e9e9))
+* allow adding data directly to runs, assets ([#543](https://github.com/nominal-io/nominal-client/issues/543)) ([6630717](https://github.com/nominal-io/nominal-client/commit/6630717827a35d50ee6008ede14b9c8e355f239c))
+* allow creating events on runs, assets, _create_event helper method ([#540](https://github.com/nominal-io/nominal-client/issues/540)) ([dc84028](https://github.com/nominal-io/nominal-client/commit/dc84028d78df256f50ba58879416bb3b5f8752ed))
+* allow creating events on runs, assets, use helper method ([dc84028](https://github.com/nominal-io/nominal-client/commit/dc84028d78df256f50ba58879416bb3b5f8752ed))
+* reusable helper method for creating runs, create multi-asset runs in client ([#539](https://github.com/nominal-io/nominal-client/issues/539)) ([3118b43](https://github.com/nominal-io/nominal-client/commit/3118b43be4df552eb7418ffed08ed0afafbe88f4))
+
+
+### Bug Fixes
+
+* make rust streaming optional unless supported architecture ([#556](https://github.com/nominal-io/nominal-client/issues/556)) ([24a2b98](https://github.com/nominal-io/nominal-client/commit/24a2b98218d025affb171411a72ad80b2dd2dd87))
+
 ## [1.100.0](https://github.com/nominal-io/nominal-client/compare/v1.99.0...v1.100.0) (2025-12-19)
 
 

nominal/core/__init__.py

@@ -1,3 +1,4 @@
+from nominal.core._event_types import EventType, SearchEventOriginType
 from nominal.core._stream.write_stream import WriteStream
 from nominal.core._utils.api_tools import LinkDict
 from nominal.core.asset import Asset
@@ -19,7 +20,7 @@ from nominal.core.data_review import CheckViolation, DataReview, DataReviewBuild
 from nominal.core.dataset import Dataset, poll_until_ingestion_completed
 from nominal.core.dataset_file import DatasetFile, IngestWaitType, as_files_ingested, wait_for_files_to_ingest
 from nominal.core.datasource import DataSource
-from nominal.core.event import Event, EventType
+from nominal.core.event import Event
 from nominal.core.filetype import FileType, FileTypes
 from nominal.core.log import LogPoint
 from nominal.core.run import Run
@@ -60,6 +61,7 @@ __all__ = [
     "NominalClient",
     "poll_until_ingestion_completed",
     "Run",
+    "SearchEventOriginType",
     "Secret",
     "TagDetails",
     "TimestampMetadata",

nominal/core/_event_types.py

@@ -0,0 +1,100 @@
+from __future__ import annotations
+
+from enum import Enum
+from typing import Iterable, NamedTuple
+
+from nominal_api import event
+
+
+class EventType(Enum):
+    INFO = "INFO"
+    FLAG = "FLAG"
+    ERROR = "ERROR"
+    SUCCESS = "SUCCESS"
+    UNKNOWN = "UNKNOWN"
+
+    @classmethod
+    def from_api_event_type(cls, event: event.EventType) -> EventType:
+        if event.name == "INFO":
+            return cls.INFO
+        elif event.name == "FLAG":
+            return cls.FLAG
+        elif event.name == "ERROR":
+            return cls.ERROR
+        elif event.name == "SUCCESS":
+            return cls.SUCCESS
+        else:
+            return cls.UNKNOWN
+
+    def _to_api_event_type(self) -> event.EventType:
+        if self.name == "INFO":
+            return event.EventType.INFO
+        elif self.name == "FLAG":
+            return event.EventType.FLAG
+        elif self.name == "ERROR":
+            return event.EventType.ERROR
+        elif self.name == "SUCCESS":
+            return event.EventType.SUCCESS
+        else:
+            return event.EventType.UNKNOWN
+
+
+class EventCreationType(Enum):
+    MANUAL = "MANUAL"
+    BY_EXTERNAL_RESOURCE = "BY_EXTERNAL_RESOURCE"
+
+
+class SearchEventOriginType(NamedTuple):
+    name: str
+    creation_type: EventCreationType
+
+    @classmethod
+    def from_api_origin_type(cls, event: event.SearchEventOriginType) -> SearchEventOriginType:
+        if event.name == "WORKBOOK":
+            return SearchEventOriginTypes.WORKBOOK
+        elif event.name == "TEMPLATE":
+            return SearchEventOriginTypes.TEMPLATE
+        elif event.name == "API":
+            return SearchEventOriginTypes.API
+        elif event.name == "DATA_REVIEW":
+            return SearchEventOriginTypes.DATA_REVIEW
+        elif event.name == "PROCEDURE":
+            return SearchEventOriginTypes.PROCEDURE
+        elif event.name == "STREAMING_CHECKLIST":
+            return SearchEventOriginTypes.STREAMING_CHECKLIST
+        else:
+            raise ValueError(f"Unexpected Event Origin {event.name}")
+
+    def _to_api_search_event_origin_type(self) -> event.SearchEventOriginType:
+        if self.name == "WORKBOOK":
+            return event.SearchEventOriginType.WORKBOOK
+        elif self.name == "TEMPLATE":
+            return event.SearchEventOriginType.TEMPLATE
+        elif self.name == "API":
+            return event.SearchEventOriginType.API
+        elif self.name == "DATA_REVIEW":
+            return event.SearchEventOriginType.DATA_REVIEW
+        elif self.name == "PROCEDURE":
+            return event.SearchEventOriginType.PROCEDURE
+        elif self.name == "STREAMING_CHECKLIST":
+            return event.SearchEventOriginType.STREAMING_CHECKLIST
+        else:
+            raise ValueError(f"Unexpected Event Origin {self.name}")
+
+    @classmethod
+    def get_manual_origin_types(cls) -> Iterable[SearchEventOriginType]:
+        """Return all origin types that are manually created."""
+        return [
+            origin_type
+            for origin_type in SearchEventOriginTypes.__dict__.values()
+            if isinstance(origin_type, SearchEventOriginType) and origin_type.creation_type == EventCreationType.MANUAL
+        ]
+
+
+class SearchEventOriginTypes:
+    WORKBOOK = SearchEventOriginType("WORKBOOK", EventCreationType.MANUAL)
+    TEMPLATE = SearchEventOriginType("TEMPLATE", EventCreationType.MANUAL)
+    API = SearchEventOriginType("API", EventCreationType.MANUAL)
+    DATA_REVIEW = SearchEventOriginType("DATA_REVIEW", EventCreationType.BY_EXTERNAL_RESOURCE)
+    PROCEDURE = SearchEventOriginType("PROCEDURE", EventCreationType.BY_EXTERNAL_RESOURCE)
+    STREAMING_CHECKLIST = SearchEventOriginType("STREAMING_CHECKLIST", EventCreationType.BY_EXTERNAL_RESOURCE)

nominal/core/_utils/query_tools.py

@@ -19,7 +19,6 @@ from nominal_api import (
     secrets_api,
 )
 
-from nominal.core.event import EventType
 from nominal.ts import IntegralNanosecondsUTC, _SecondsNanos
 
 
@@ -198,52 +197,6 @@ def create_search_datasets_query(
     return scout_catalog.SearchDatasetsQuery(and_=queries)
 
 
-def create_search_events_query(  # noqa: PLR0912
-    search_text: str | None = None,
-    after: str | datetime | IntegralNanosecondsUTC | None = None,
-    before: str | datetime | IntegralNanosecondsUTC | None = None,
-    assets: Iterable[str] | None = None,
-    labels: Iterable[str] | None = None,
-    properties: Mapping[str, str] | None = None,
-    created_by: str | None = None,
-    workbook: str | None = None,
-    data_review: str | None = None,
-    assignee: str | None = None,
-    event_type: EventType | None = None,
-    workspace_rid: str | None = None,
-) -> event.SearchQuery:
-    queries = []
-    if search_text is not None:
-        queries.append(event.SearchQuery(search_text=search_text))
-    if after is not None:
-        queries.append(event.SearchQuery(after=_SecondsNanos.from_flexible(after).to_api()))
-    if before is not None:
-        queries.append(event.SearchQuery(before=_SecondsNanos.from_flexible(before).to_api()))
-    if assets:
-        for asset in assets:
-            queries.append(event.SearchQuery(asset=asset))
-    if labels:
-        for label in labels:
-            queries.append(event.SearchQuery(label=label))
-    if properties:
-        for name, value in properties.items():
-            queries.append(event.SearchQuery(property=api.Property(name=name, value=value)))
-    if created_by:
-        queries.append(event.SearchQuery(created_by=created_by))
-    if workbook is not None:
-        queries.append(event.SearchQuery(workbook=workbook))
-    if data_review is not None:
-        queries.append(event.SearchQuery(data_review=data_review))
-    if assignee is not None:
-        queries.append(event.SearchQuery(assignee=assignee))
-    if event_type is not None:
-        queries.append(event.SearchQuery(event_type=event_type._to_api_event_type()))
-    if workspace_rid is not None:
-        queries.append(event.SearchQuery(workspace=workspace_rid))
-
-    return event.SearchQuery(and_=queries)
-
-
 def create_search_runs_query(
     start: str | datetime | IntegralNanosecondsUTC | None = None,
     end: str | datetime | IntegralNanosecondsUTC | None = None,
@@ -398,3 +351,53 @@ def create_search_workbook_templates_query(
         queries.append(scout_template_api.SearchTemplatesQuery(is_published=published))
 
     return scout_template_api.SearchTemplatesQuery(and_=queries)
+
+
+def _create_search_events_query(  # noqa: PLR0912
+    search_text: str | None = None,
+    after: str | datetime | IntegralNanosecondsUTC | None = None,
+    before: str | datetime | IntegralNanosecondsUTC | None = None,
+    asset_rids: Iterable[str] | None = None,
+    labels: Iterable[str] | None = None,
+    properties: Mapping[str, str] | None = None,
+    created_by_rid: str | None = None,
+    workbook_rid: str | None = None,
+    data_review_rid: str | None = None,
+    assignee_rid: str | None = None,
+    event_type: event.EventType | None = None,
+    origin_types: Iterable[event.SearchEventOriginType] | None = None,
+    workspace_rid: str | None = None,
+) -> event.SearchQuery:
+    queries = []
+    if search_text is not None:
+        queries.append(event.SearchQuery(search_text=search_text))
+    if after is not None:
+        queries.append(event.SearchQuery(after=_SecondsNanos.from_flexible(after).to_api()))
+    if before is not None:
+        queries.append(event.SearchQuery(before=_SecondsNanos.from_flexible(before).to_api()))
+    if asset_rids:
+        for asset in asset_rids:
+            queries.append(event.SearchQuery(asset=asset))
+    if labels:
+        for label in labels:
+            queries.append(event.SearchQuery(label=label))
+    if properties:
+        for name, value in properties.items():
+            queries.append(event.SearchQuery(property=api.Property(name=name, value=value)))
+    if created_by_rid:
+        queries.append(event.SearchQuery(created_by=created_by_rid))
+    if workbook_rid is not None:
+        queries.append(event.SearchQuery(workbook=workbook_rid))
+    if data_review_rid is not None:
+        queries.append(event.SearchQuery(data_review=data_review_rid))
+    if assignee_rid is not None:
+        queries.append(event.SearchQuery(assignee=assignee_rid))
+    if event_type is not None:
+        queries.append(event.SearchQuery(event_type=event_type))
+    if origin_types is not None:
+        origin_type_filter = event.OriginTypesFilter(api.SetOperator.OR, list(origin_types))
+        queries.append(event.SearchQuery(origin_types=origin_type_filter))
+    if workspace_rid is not None:
+        queries.append(event.SearchQuery(workspace=workspace_rid))
+
+    return event.SearchQuery(and_=queries)

nominal/core/asset.py

@@ -1,11 +1,13 @@
 from __future__ import annotations
 
+import datetime
 import logging
 from dataclasses import dataclass, field
 from types import MappingProxyType
-from typing import Iterable, Literal, Mapping, Protocol, Sequence, TypeAlias, cast
+from typing import Iterable, Literal, Mapping, Protocol, Sequence, TypeAlias
 
 from nominal_api import (
+    event,
     scout,
     scout_asset_api,
     scout_assets,
@@ -14,22 +16,46 @@ from nominal_api import (
 from typing_extensions import Self
 
 from nominal.core._clientsbunch import HasScoutParams
-from nominal.core._utils.api_tools import HasRid, Link, RefreshableMixin, create_links, rid_from_instance_or_string
+from nominal.core._event_types import EventType, SearchEventOriginType
+from nominal.core._utils.api_tools import (
+    HasRid,
+    Link,
+    LinkDict,
+    RefreshableMixin,
+    create_links,
+    rid_from_instance_or_string,
+)
 from nominal.core._utils.pagination_tools import search_runs_by_asset_paginated
 from nominal.core.attachment import Attachment, _iter_get_attachments
 from nominal.core.connection import Connection, _get_connections
-from nominal.core.dataset import Dataset, _create_dataset, _get_datasets
+from nominal.core.dataset import Dataset, _create_dataset, _DatasetWrapper, _get_datasets
 from nominal.core.datasource import DataSource
+from nominal.core.event import Event, _create_event, _search_events
 from nominal.core.video import Video, _create_video, _get_video
-from nominal.ts import IntegralNanosecondsUTC, _SecondsNanos
+from nominal.ts import IntegralNanosecondsDuration, IntegralNanosecondsUTC, _SecondsNanos
 
 ScopeType: TypeAlias = Connection | Dataset | Video
+ScopeTypeSpecifier: TypeAlias = Literal["connection", "dataset", "video"]
 
 logger = logging.getLogger(__name__)
 
 
+def _filter_scopes(
+    scopes: Sequence[scout_asset_api.DataScope], scope_type: ScopeTypeSpecifier
+) -> Sequence[scout_asset_api.DataScope]:
+    return [scope for scope in scopes if scope.data_source.type.lower() == scope_type]
+
+
+def _filter_scope_rids(
+    scopes: Sequence[scout_asset_api.DataScope], scope_type: ScopeTypeSpecifier
+) -> Mapping[str, str]:
+    return {
+        scope.data_scope_name: getattr(scope.data_source, scope_type) for scope in _filter_scopes(scopes, scope_type)
+    }
+
+
 @dataclass(frozen=True)
-class Asset(HasRid, RefreshableMixin[scout_asset_api.Asset]):
+class Asset(_DatasetWrapper, HasRid, RefreshableMixin[scout_asset_api.Asset]):
     rid: str
     name: str
     description: str | None
@@ -43,6 +69,7 @@ class Asset(HasRid, RefreshableMixin[scout_asset_api.Asset]):
         DataSource._Clients,
         Video._Clients,
         Attachment._Clients,
+        Event._Clients,
         HasScoutParams,
         Protocol,
     ):
@@ -50,6 +77,8 @@ class Asset(HasRid, RefreshableMixin[scout_asset_api.Asset]):
         def assets(self) -> scout_assets.AssetService: ...
         @property
         def run(self) -> scout.RunService: ...
+        @property
+        def event(self) -> event.EventService: ...
 
     @property
     def nominal_url(self) -> str:
@@ -64,6 +93,13 @@ class Asset(HasRid, RefreshableMixin[scout_asset_api.Asset]):
             raise ValueError(f"multiple assets found with RID {self.rid!r}: {response!r}")
         return response[self.rid]
 
+    def _list_dataset_scopes(self) -> Sequence[scout_asset_api.DataScope]:
+        return _filter_scopes(self._get_latest_api().data_scopes, "dataset")
+
+    def _scope_rids(self, scope_type: ScopeTypeSpecifier) -> Mapping[str, str]:
+        asset = self._get_latest_api()
+        return _filter_scope_rids(asset.data_scopes, scope_type)
+
     def update(
         self,
         *,
@@ -97,14 +133,6 @@ class Asset(HasRid, RefreshableMixin[scout_asset_api.Asset]):
         api_asset = self._clients.assets.update_asset(self._clients.auth_header, request, self.rid)
         return self._refresh_from_api(api_asset)
 
-    def _scope_rid(self, stype: Literal["dataset", "video", "connection"]) -> dict[str, str]:
-        asset = self._get_latest_api()
-        return {
-            scope.data_scope_name: cast(str, getattr(scope.data_source, stype))
-            for scope in asset.data_scopes
-            if scope.data_source.type.lower() == stype
-        }
-
     def promote(self) -> Self:
         """Promote this asset to be a standard, searchable, and displayable asset.
 
@@ -137,23 +165,25 @@ class Asset(HasRid, RefreshableMixin[scout_asset_api.Asset]):
         """
         return (*self.list_datasets(), *self.list_connections(), *self.list_videos())
 
-    def _remove_data_sources(
+    def remove_data_scopes(
         self,
         *,
-        data_scope_names: Sequence[str] | None = None,
-        data_sources: Sequence[ScopeType | str] | None = None,
+        names: Sequence[str] | None = None,
+        scopes: Sequence[ScopeType | str] | None = None,
     ) -> None:
-        data_scope_names = data_scope_names or []
-        data_sources = data_sources or []
-
-        if isinstance(data_sources, str):
-            raise RuntimeError("Expect `data_sources` to be a sequence, not a string")
+        """Remove data scopes from this asset.
 
-        data_source_rids = {rid_from_instance_or_string(ds) for ds in data_sources}
+        Args:
+            names: Names of datascopes to remove
+            scopes: Rids or instances of scope types (dataset, video, connection) to remove.
+        """
+        scope_names_to_remove = names or []
+        data_scopes_to_remove = scopes or []
 
+        scope_rids_to_remove = {rid_from_instance_or_string(ds) for ds in data_scopes_to_remove}
         conjure_asset = self._get_latest_api()
 
-        data_sources_to_keep = [
+        data_scopes_to_keep = [
             scout_asset_api.CreateAssetDataScope(
                 data_scope_name=ds.data_scope_name,
                 data_source=ds.data_source,
@@ -161,31 +191,21 @@ class Asset(HasRid, RefreshableMixin[scout_asset_api.Asset]):
                 offset=ds.offset,
             )
             for ds in conjure_asset.data_scopes
-            if ds.data_scope_name not in data_scope_names
-            and (ds.data_source.dataset or ds.data_source.connection or ds.data_source.video) not in data_source_rids
+            if ds.data_scope_name not in scope_names_to_remove
+            and all(
+                rid not in scope_rids_to_remove
+                for rid in (ds.data_source.dataset, ds.data_source.connection, ds.data_source.video)
+            )
         ]
 
-        api_asset = self._clients.assets.update_asset(
+        updated_asset = self._clients.assets.update_asset(
             self._clients.auth_header,
             scout_asset_api.UpdateAssetRequest(
-                data_scopes=data_sources_to_keep,
+                data_scopes=data_scopes_to_keep,
             ),
             self.rid,
         )
-        self._refresh_from_api(api_asset)
-
-    def remove_data_scopes(
-        self,
-        *,
-        names: Sequence[str] | None = None,
-        scopes: Sequence[ScopeType | str] | None = None,
-    ) -> None:
-        """Remove data scopes from this asset.
-
-        `names` are scope names.
-        `scopes` are rids or scope objects.
-        """
-        self._remove_data_sources(data_scope_names=names, data_sources=scopes)
+        self._refresh_from_api(updated_asset)
 
     def add_dataset(
         self,
@@ -329,6 +349,83 @@ class Asset(HasRid, RefreshableMixin[scout_asset_api.Asset]):
             self.add_video(data_scope_name, video)
             return video
 
+    def create_event(
+        self,
+        name: str,
+        type: EventType,
+        start: datetime.datetime | IntegralNanosecondsUTC,
+        duration: datetime.timedelta | IntegralNanosecondsDuration = 0,
+        *,
+        description: str | None = None,
+        properties: Mapping[str, str] | None = None,
+        labels: Sequence[str] | None = None,
+    ) -> Event:
+        """Create an event associated with this Asset at a given point in time.
+
+        Args:
+            name: Name of the event
+            type: Verbosity level of the event.
+            start: Starting timestamp of the event
+            duration: Duration of the event, or 0 for an event without duration.
+            description: Optionally, a human readable description of the event to create
+            properties: Key-value pairs to use as properties on the created event
+            labels: Sequence of labels to use on the created event.
+
+        Returns:
+            The created event that is associated with the asset.
+        """
+        return _create_event(
+            self._clients,
+            name=name,
+            type=type,
+            start=start,
+            duration=duration,
+            description=description,
+            assets=[self],
+            properties=properties,
+            labels=labels,
+        )
+
+    def create_run(
+        self,
+        name: str,
+        start: datetime.datetime | IntegralNanosecondsUTC,
+        end: datetime.datetime | IntegralNanosecondsUTC | None,
+        *,
+        description: str | None = None,
+        properties: Mapping[str, str] | None = None,
+        labels: Sequence[str] = (),
+        links: Sequence[str | Link | LinkDict] = (),
+        attachments: Iterable[Attachment] | Iterable[str] = (),
+    ) -> Run:
+        """Create a run associated with this Asset for a given span of time.
+
+        Args:
+            name: Name of the run.
+            start: Starting timestamp of the run.
+            end: Ending timestamp of the run, or None for an unbounded run.
+            description: Optionally, a human readable description of the run to create.
+            properties: Key-value pairs to use as properties on the created run.
+            labels: Sequence of labels to use on the created run.
+            links: Link metadata to add to the created run.
+            attachments: Attachments to associate with the created run.
+
+        Returns:
+            Returns the created run
+        """
+        return _create_run(
+            self._clients,
+            name=name,
+            start=start,
+            end=end,
+            description=description,
+            properties=properties,
+            labels=labels,
+            links=links,
+            attachments=attachments,
+            asset_rids=[self.rid],
+        )
+
     def get_dataset(self, data_scope_name: str) -> Dataset:
         """Retrieve a dataset by data scope name, or raise ValueError if one is not found."""
         dataset = self.get_data_scope(data_scope_name)
@@ -357,7 +454,7 @@ class Asset(HasRid, RefreshableMixin[scout_asset_api.Asset]):
         """List the datasets associated with this asset.
         Returns (data_scope_name, dataset) pairs for each dataset.
         """
-        scope_rid = self._scope_rid(stype="dataset")
+        scope_rid = self._scope_rids(scope_type="dataset")
         if not scope_rid:
             return []
 
@@ -375,7 +472,7 @@ class Asset(HasRid, RefreshableMixin[scout_asset_api.Asset]):
         """List the connections associated with this asset.
         Returns (data_scope_name, connection) pairs for each connection.
         """
-        scope_rid = self._scope_rid(stype="connection")
+        scope_rid = self._scope_rids(scope_type="connection")
         connections_meta = _get_connections(self._clients, list(scope_rid.values()))
         return [
             (scope, Connection._from_conjure(self._clients, connection))
@@ -386,7 +483,7 @@ class Asset(HasRid, RefreshableMixin[scout_asset_api.Asset]):
         """List the videos associated with this asset.
         Returns (data_scope_name, dataset) pairs for each video.
         """
-        scope_rid = self._scope_rid(stype="video")
+        scope_rid = self._scope_rids(scope_type="video")
         return [
             (scope, Video._from_conjure(self._clients, _get_video(self._clients, rid)))
             for (scope, rid) in scope_rid.items()
@@ -411,6 +508,38 @@ class Asset(HasRid, RefreshableMixin[scout_asset_api.Asset]):
             )
         ]
 
+    def search_events(
+        self,
+        *,
+        search_text: str | None = None,
+        after: str | datetime.datetime | IntegralNanosecondsUTC | None = None,
+        before: str | datetime.datetime | IntegralNanosecondsUTC | None = None,
+        labels: Iterable[str] | None = None,
+        properties: Mapping[str, str] | None = None,
+        created_by_rid: str | None = None,
+        workbook_rid: str | None = None,
+        data_review_rid: str | None = None,
+        assignee_rid: str | None = None,
+        event_type: EventType | None = None,
+        origin_types: Iterable[SearchEventOriginType] | None = None,
+    ) -> Sequence[Event]:
+        """Search for events associated with this Asset. See nominal.core.event._search_events for details."""
+        return _search_events(
+            self._clients,
+            search_text=search_text,
+            after=after,
+            before=before,
+            asset_rids=[self.rid],
+            labels=labels,
+            properties=properties,
+            created_by_rid=created_by_rid,
+            workbook_rid=workbook_rid,
+            data_review_rid=data_review_rid,
+            assignee_rid=assignee_rid,
+            event_type=event_type,
+            origin_types=origin_types,
+        )
+
     def remove_attachments(self, attachments: Iterable[Attachment] | Iterable[str]) -> None:
         """Remove attachments from this asset.
         Does not remove the attachments from Nominal.
@@ -445,4 +574,4 @@ class Asset(HasRid, RefreshableMixin[scout_asset_api.Asset]):
 
 
 # Moving to bottom to deal with circular dependencies
-from nominal.core.run import Run  # noqa: E402
+from nominal.core.run import Run, _create_run  # noqa: E402