sift-stack-py 0.18.0__tar.gz → 0.19.1__tar.gz

{sift_stack_py-0.18.0 → sift_stack_py-0.19.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: sift_stack_py
-Version: 0.18.0
+Version: 0.19.1
 Summary: Python client library for the Sift API
 Maintainer-email: Sift Software Engineers <engineering@siftstack.com>
 License: Copyright (c) 2024 Azimuth Industries Inc.
@@ -38,6 +38,7 @@ Requires-Dist: pydantic_core~=2.3
 Requires-Dist: requests~=2.25
 Requires-Dist: requests-toolbelt~=1.0
 Requires-Dist: alive-progress~=3.0
+Requires-Dist: diskcache~=5.6
 Requires-Dist: pandas-stubs<4.0,>=2.0
 Requires-Dist: types-PyYAML~=6.0
 Requires-Dist: types-protobuf>=5.0
@@ -54,6 +55,7 @@ Requires-Dist: npTDMS~=1.9; extra == "all"
 Requires-Dist: polars~=1.8; extra == "all"
 Requires-Dist: pyOpenSSL<24.0.0; extra == "all"
 Requires-Dist: pyarrow>=17.0.0; extra == "all"
+Requires-Dist: pyulog~=1.2.2; extra == "all"
 Requires-Dist: rosbags~=0.0; python_full_version >= "3.8.2" and extra == "all"
 Requires-Dist: sift-stream-bindings==0.4.1; extra == "all"
 Requires-Dist: types-pyOpenSSL<24.0.0; extra == "all"
@@ -92,6 +94,7 @@ Requires-Dist: pytest-dotenv==0.5.2; extra == "dev-all"
 Requires-Dist: pytest-mock==3.14.0; extra == "dev-all"
 Requires-Dist: pytest-randomly==3.15.0; extra == "dev-all"
 Requires-Dist: pytest==8.2.2; extra == "dev-all"
+Requires-Dist: pyulog~=1.2.2; extra == "dev-all"
 Requires-Dist: rosbags~=0.0; python_full_version >= "3.8.2" and extra == "dev-all"
 Requires-Dist: ruff~=0.12.10; extra == "dev-all"
 Requires-Dist: sift-stream-bindings==0.4.1; extra == "dev-all"
@@ -144,6 +147,7 @@ Requires-Dist: pytest-dotenv==0.5.2; extra == "docs-build"
 Requires-Dist: pytest-mock==3.14.0; extra == "docs-build"
 Requires-Dist: pytest-randomly==3.15.0; extra == "docs-build"
 Requires-Dist: pytest==8.2.2; extra == "docs-build"
+Requires-Dist: pyulog~=1.2.2; extra == "docs-build"
 Requires-Dist: rosbags~=0.0; python_full_version >= "3.8.2" and extra == "docs-build"
 Requires-Dist: ruff~=0.12.10; extra == "docs-build"
 Requires-Dist: sift-stream-bindings==0.4.1; extra == "docs-build"
@@ -153,6 +157,7 @@ Provides-Extra: file-imports
 Requires-Dist: h5py~=3.11; extra == "file-imports"
 Requires-Dist: npTDMS~=1.9; extra == "file-imports"
 Requires-Dist: polars~=1.8; extra == "file-imports"
+Requires-Dist: pyulog~=1.2.2; extra == "file-imports"
 Requires-Dist: rosbags~=0.0; python_full_version >= "3.8.2" and extra == "file-imports"
 Provides-Extra: hdf5
 Requires-Dist: h5py~=3.11; extra == "hdf5"
@@ -169,6 +174,8 @@ Provides-Extra: sift-stream-bindings
 Requires-Dist: sift-stream-bindings==0.4.1; extra == "sift-stream-bindings"
 Provides-Extra: tdms
 Requires-Dist: npTDMS~=1.9; extra == "tdms"
+Provides-Extra: ulog
+Requires-Dist: pyulog~=1.2.2; extra == "ulog"
 
 # Sift Python
 [![pypi](https://img.shields.io/pypi/v/sift-stack-py)](https://pypi.org/project/sift-stack-py/)

{sift_stack_py-0.18.0 → sift_stack_py-0.19.1}/lib/sift/calculated_channels/v2/calculated_channels_pb2.pyi

@@ -425,6 +425,10 @@ class ListCalculatedChannelsRequest(google.protobuf.message.Message):
     Available fields to filter by are `calculated_channel_id`, `organization_id`, `client_key`, `name`, `description`,
     `asset_id`, `asset_name`, `tag_id`, `tag_name`, `units`, `calculated_channel_version_id`,
     `created_date`, `modified_date`, `created_by_user_id`, `modified_by_user_id`, `is_archived`, and `archived_date`.
+    Folder membership is filterable via the `folders` and `activeFolders` fields. Both contain the ids of the folders
+    the calculated channel belongs to; `activeFolders` excludes archived folders. Use `"<folder_id>" in folders` to
+    return calculated channels in the given folder, and `size(activeFolders) == 0` to return uncategorized calculated
+    channels (calculated channels whose only memberships are in archived folders count as uncategorized).
     For further information about how to use CELs, please refer to [this guide](https://github.com/google/cel-spec/blob/master/doc/langdef.md#standard-definitions).
     For more information about the fields used for filtering, please refer to [this definition](/docs/api/grpc/protocol-buffers/calculated_channels#calculated_channel). Optional.
     """

sift_stack_py-0.19.1/lib/sift/canvas/v1/canvas_pb2.py

@@ -0,0 +1,27 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: sift/canvas/v1/canvas.proto
+# Protobuf Python Version: 5.26.1
+"""Generated protocol buffer code."""
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import descriptor_pool as _descriptor_pool
+from google.protobuf import symbol_database as _symbol_database
+from google.protobuf.internal import builder as _builder
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+
+
+DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n\x1bsift/canvas/v1/canvas.proto\x12\x0esift.canvas.v1*\xe1\x03\n\x19\x43\x61nvasCellExecutionStatus\x12,\n(CANVAS_CELL_EXECUTION_STATUS_UNSPECIFIED\x10\x00\x12,\n(CANVAS_CELL_EXECUTION_STATUS_IN_PROGRESS\x10\x01\x12,\n(CANVAS_CELL_EXECUTION_STATUS_AUTO_PASSED\x10\x02\x12,\n(CANVAS_CELL_EXECUTION_STATUS_AUTO_FAILED\x10\x03\x12.\n*CANVAS_CELL_EXECUTION_STATUS_MANUAL_PASSED\x10\x04\x12.\n*CANVAS_CELL_EXECUTION_STATUS_MANUAL_FAILED\x10\x05\x12&\n\"CANVAS_CELL_EXECUTION_STATUS_ERROR\x10\x06\x12(\n$CANVAS_CELL_EXECUTION_STATUS_SKIPPED\x10\x07\x12%\n!CANVAS_CELL_EXECUTION_STATUS_OPEN\x10\x08\x12\x33\n/CANVAS_CELL_EXECUTION_STATUS_MANUALLY_CANCELLED\x10\tB{\n\x12\x63om.sift.canvas.v1B\x0b\x43\x61nvasProtoP\x01\xa2\x02\x03SCX\xaa\x02\x0eSift.Canvas.V1\xca\x02\x0eSift\\Canvas\\V1\xe2\x02\x1aSift\\Canvas\\V1\\GPBMetadata\xea\x02\x10Sift::Canvas::V1b\x06proto3')
+
+_globals = globals()
+_builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, _globals)
+_builder.BuildTopDescriptorsAndMessages(DESCRIPTOR, 'sift.canvas.v1.canvas_pb2', _globals)
+if not _descriptor._USE_C_DESCRIPTORS:
+  _globals['DESCRIPTOR']._loaded_options = None
+  _globals['DESCRIPTOR']._serialized_options = b'\n\022com.sift.canvas.v1B\013CanvasProtoP\001\242\002\003SCX\252\002\016Sift.Canvas.V1\312\002\016Sift\\Canvas\\V1\342\002\032Sift\\Canvas\\V1\\GPBMetadata\352\002\020Sift::Canvas::V1'
+  _globals['_CANVASCELLEXECUTIONSTATUS']._serialized_start=48
+  _globals['_CANVASCELLEXECUTIONSTATUS']._serialized_end=529
+# @@protoc_insertion_point(module_scope)

sift_stack_py-0.19.1/lib/sift/canvas/v1/canvas_pb2.pyi

@@ -0,0 +1,52 @@
+"""
+@generated by mypy-protobuf.  Do not edit manually!
+isort:skip_file
+"""
+
+import builtins
+import google.protobuf.descriptor
+import google.protobuf.internal.enum_type_wrapper
+import sys
+import typing
+
+if sys.version_info >= (3, 10):
+    import typing as typing_extensions
+else:
+    import typing_extensions
+
+DESCRIPTOR: google.protobuf.descriptor.FileDescriptor
+
+class _CanvasCellExecutionStatus:
+    ValueType = typing.NewType("ValueType", builtins.int)
+    V: typing_extensions.TypeAlias = ValueType
+
+class _CanvasCellExecutionStatusEnumTypeWrapper(google.protobuf.internal.enum_type_wrapper._EnumTypeWrapper[_CanvasCellExecutionStatus.ValueType], builtins.type):
+    DESCRIPTOR: google.protobuf.descriptor.EnumDescriptor
+    CANVAS_CELL_EXECUTION_STATUS_UNSPECIFIED: _CanvasCellExecutionStatus.ValueType  # 0
+    CANVAS_CELL_EXECUTION_STATUS_IN_PROGRESS: _CanvasCellExecutionStatus.ValueType  # 1
+    CANVAS_CELL_EXECUTION_STATUS_AUTO_PASSED: _CanvasCellExecutionStatus.ValueType  # 2
+    CANVAS_CELL_EXECUTION_STATUS_AUTO_FAILED: _CanvasCellExecutionStatus.ValueType  # 3
+    CANVAS_CELL_EXECUTION_STATUS_MANUAL_PASSED: _CanvasCellExecutionStatus.ValueType  # 4
+    CANVAS_CELL_EXECUTION_STATUS_MANUAL_FAILED: _CanvasCellExecutionStatus.ValueType  # 5
+    CANVAS_CELL_EXECUTION_STATUS_ERROR: _CanvasCellExecutionStatus.ValueType  # 6
+    CANVAS_CELL_EXECUTION_STATUS_SKIPPED: _CanvasCellExecutionStatus.ValueType  # 7
+    CANVAS_CELL_EXECUTION_STATUS_OPEN: _CanvasCellExecutionStatus.ValueType  # 8
+    CANVAS_CELL_EXECUTION_STATUS_MANUALLY_CANCELLED: _CanvasCellExecutionStatus.ValueType  # 9
+
+class CanvasCellExecutionStatus(_CanvasCellExecutionStatus, metaclass=_CanvasCellExecutionStatusEnumTypeWrapper):
+    """Status of a single canvas cell execution. Also used as the status of the
+    parent CanvasExecution: the parent rolls up its cells' statuses into a
+    single value (e.g. any AUTO_FAILED cell yields an AUTO_FAILED execution).
+    """
+
+CANVAS_CELL_EXECUTION_STATUS_UNSPECIFIED: CanvasCellExecutionStatus.ValueType  # 0
+CANVAS_CELL_EXECUTION_STATUS_IN_PROGRESS: CanvasCellExecutionStatus.ValueType  # 1
+CANVAS_CELL_EXECUTION_STATUS_AUTO_PASSED: CanvasCellExecutionStatus.ValueType  # 2
+CANVAS_CELL_EXECUTION_STATUS_AUTO_FAILED: CanvasCellExecutionStatus.ValueType  # 3
+CANVAS_CELL_EXECUTION_STATUS_MANUAL_PASSED: CanvasCellExecutionStatus.ValueType  # 4
+CANVAS_CELL_EXECUTION_STATUS_MANUAL_FAILED: CanvasCellExecutionStatus.ValueType  # 5
+CANVAS_CELL_EXECUTION_STATUS_ERROR: CanvasCellExecutionStatus.ValueType  # 6
+CANVAS_CELL_EXECUTION_STATUS_SKIPPED: CanvasCellExecutionStatus.ValueType  # 7
+CANVAS_CELL_EXECUTION_STATUS_OPEN: CanvasCellExecutionStatus.ValueType  # 8
+CANVAS_CELL_EXECUTION_STATUS_MANUALLY_CANCELLED: CanvasCellExecutionStatus.ValueType  # 9
+global___CanvasCellExecutionStatus = CanvasCellExecutionStatus

sift_stack_py-0.19.1/lib/sift/common/v1/filter_field_pb2.py

@@ -0,0 +1,31 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: sift/common/v1/filter_field.proto
+# Protobuf Python Version: 5.26.1
+"""Generated protocol buffer code."""
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import descriptor_pool as _descriptor_pool
+from google.protobuf import symbol_database as _symbol_database
+from google.protobuf.internal import builder as _builder
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+
+
+DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n!sift/common/v1/filter_field.proto\x12\x0esift.common.v1\"\x86\x04\n\x0b\x46ilterField\x12\x1d\n\nfield_name\x18\x01 \x01(\tR\tfieldName\x12\x33\n\x04type\x18\x02 \x01(\x0e\x32\x1f.sift.common.v1.FilterFieldTypeR\x04type\x12\x1f\n\x0b\x65num_values\x18\x03 \x03(\tR\nenumValues\x12 \n\x0b\x64\x65scription\x18\x04 \x01(\tR\x0b\x64\x65scription\x12!\n\x0c\x64isplay_name\x18\x05 \x01(\tR\x0b\x64isplayName\x12\x1c\n\toperators\x18\x06 \x03(\tR\toperators\x12\x1c\n\tfunctions\x18\x07 \x03(\tR\tfunctions\x12\x1f\n\x08nullable\x18\x08 \x01(\x08H\x00R\x08nullable\x88\x01\x01\x12\x16\n\x06\x65ntity\x18\t \x01(\tR\x06\x65ntity\x12\x12\n\x04name\x18\n \x01(\tR\x04name\x12\x10\n\x03key\x18\x0b \x01(\tR\x03key\x12>\n\nfield_kind\x18\x0c \x01(\x0e\x32\x1f.sift.common.v1.FilterFieldKindR\tfieldKind\x12\x33\n\x06\x66ields\x18\r \x03(\x0b\x32\x1b.sift.common.v1.FilterFieldR\x06\x66ields\x12 \n\x0bquantifiers\x18\x0e \x03(\tR\x0bquantifiersB\x0b\n\t_nullable*\xa0\x02\n\x0f\x46ilterFieldType\x12!\n\x1d\x46ILTER_FIELD_TYPE_UNSPECIFIED\x10\x00\x12\x1c\n\x18\x46ILTER_FIELD_TYPE_STRING\x10\x01\x12\x1f\n\x1b\x46ILTER_FIELD_TYPE_TIMESTAMP\x10\x02\x12\x19\n\x15\x46ILTER_FIELD_TYPE_INT\x10\x03\x12\x1a\n\x16\x46ILTER_FIELD_TYPE_BOOL\x10\x04\x12\x1e\n\x1a\x46ILTER_FIELD_TYPE_DURATION\x10\x05\x12\x1c\n\x18\x46ILTER_FIELD_TYPE_DOUBLE\x10\x06\x12\x1a\n\x16\x46ILTER_FIELD_TYPE_ENUM\x10\x07\x12\x1a\n\x16\x46ILTER_FIELD_TYPE_UUID\x10\x08*\xae\x01\n\x0f\x46ilterFieldKind\x12!\n\x1d\x46ILTER_FIELD_KIND_UNSPECIFIED\x10\x00\x12\x1c\n\x18\x46ILTER_FIELD_KIND_SCALAR\x10\x01\x12\x19\n\x15\x46ILTER_FIELD_KIND_MAP\x10\x02\x12\x1e\n\x1a\x46ILTER_FIELD_KIND_RELATION\x10\x03\x12\x1f\n\x1b\x46ILTER_FIELD_KIND_DIRECTIVE\x10\x04\x42\x80\x01\n\x12\x63om.sift.common.v1B\x10\x46ilterFieldProtoP\x01\xa2\x02\x03SCX\xaa\x02\x0eSift.Common.V1\xca\x02\x0eSift\\Common\\V1\xe2\x02\x1aSift\\Common\\V1\\GPBMetadata\xea\x02\x10Sift::Common::V1b\x06proto3')
+
+_globals = globals()
+_builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, _globals)
+_builder.BuildTopDescriptorsAndMessages(DESCRIPTOR, 'sift.common.v1.filter_field_pb2', _globals)
+if not _descriptor._USE_C_DESCRIPTORS:
+  _globals['DESCRIPTOR']._loaded_options = None
+  _globals['DESCRIPTOR']._serialized_options = b'\n\022com.sift.common.v1B\020FilterFieldProtoP\001\242\002\003SCX\252\002\016Sift.Common.V1\312\002\016Sift\\Common\\V1\342\002\032Sift\\Common\\V1\\GPBMetadata\352\002\020Sift::Common::V1'
+  _globals['_FILTERFIELDTYPE']._serialized_start=575
+  _globals['_FILTERFIELDTYPE']._serialized_end=863
+  _globals['_FILTERFIELDKIND']._serialized_start=866
+  _globals['_FILTERFIELDKIND']._serialized_end=1040
+  _globals['_FILTERFIELD']._serialized_start=54
+  _globals['_FILTERFIELD']._serialized_end=572
+# @@protoc_insertion_point(module_scope)

sift_stack_py-0.19.1/lib/sift/common/v1/filter_field_pb2.pyi

@@ -0,0 +1,220 @@
+"""
+@generated by mypy-protobuf.  Do not edit manually!
+isort:skip_file
+"""
+
+import builtins
+import collections.abc
+import google.protobuf.descriptor
+import google.protobuf.internal.containers
+import google.protobuf.internal.enum_type_wrapper
+import google.protobuf.message
+import sys
+import typing
+
+if sys.version_info >= (3, 10):
+    import typing as typing_extensions
+else:
+    import typing_extensions
+
+DESCRIPTOR: google.protobuf.descriptor.FileDescriptor
+
+class _FilterFieldType:
+    ValueType = typing.NewType("ValueType", builtins.int)
+    V: typing_extensions.TypeAlias = ValueType
+
+class _FilterFieldTypeEnumTypeWrapper(google.protobuf.internal.enum_type_wrapper._EnumTypeWrapper[_FilterFieldType.ValueType], builtins.type):
+    DESCRIPTOR: google.protobuf.descriptor.EnumDescriptor
+    FILTER_FIELD_TYPE_UNSPECIFIED: _FilterFieldType.ValueType  # 0
+    FILTER_FIELD_TYPE_STRING: _FilterFieldType.ValueType  # 1
+    FILTER_FIELD_TYPE_TIMESTAMP: _FilterFieldType.ValueType  # 2
+    FILTER_FIELD_TYPE_INT: _FilterFieldType.ValueType  # 3
+    FILTER_FIELD_TYPE_BOOL: _FilterFieldType.ValueType  # 4
+    FILTER_FIELD_TYPE_DURATION: _FilterFieldType.ValueType  # 5
+    FILTER_FIELD_TYPE_DOUBLE: _FilterFieldType.ValueType  # 6
+    FILTER_FIELD_TYPE_ENUM: _FilterFieldType.ValueType  # 7
+    FILTER_FIELD_TYPE_UUID: _FilterFieldType.ValueType  # 8
+
+class FilterFieldType(_FilterFieldType, metaclass=_FilterFieldTypeEnumTypeWrapper):
+    """Describes the type of a filter field."""
+
+FILTER_FIELD_TYPE_UNSPECIFIED: FilterFieldType.ValueType  # 0
+FILTER_FIELD_TYPE_STRING: FilterFieldType.ValueType  # 1
+FILTER_FIELD_TYPE_TIMESTAMP: FilterFieldType.ValueType  # 2
+FILTER_FIELD_TYPE_INT: FilterFieldType.ValueType  # 3
+FILTER_FIELD_TYPE_BOOL: FilterFieldType.ValueType  # 4
+FILTER_FIELD_TYPE_DURATION: FilterFieldType.ValueType  # 5
+FILTER_FIELD_TYPE_DOUBLE: FilterFieldType.ValueType  # 6
+FILTER_FIELD_TYPE_ENUM: FilterFieldType.ValueType  # 7
+FILTER_FIELD_TYPE_UUID: FilterFieldType.ValueType  # 8
+global___FilterFieldType = FilterFieldType
+
+class _FilterFieldKind:
+    ValueType = typing.NewType("ValueType", builtins.int)
+    V: typing_extensions.TypeAlias = ValueType
+
+class _FilterFieldKindEnumTypeWrapper(google.protobuf.internal.enum_type_wrapper._EnumTypeWrapper[_FilterFieldKind.ValueType], builtins.type):
+    DESCRIPTOR: google.protobuf.descriptor.EnumDescriptor
+    FILTER_FIELD_KIND_UNSPECIFIED: _FilterFieldKind.ValueType  # 0
+    """Unset. Treated as FILTER_FIELD_KIND_SCALAR for backward compatibility."""
+    FILTER_FIELD_KIND_SCALAR: _FilterFieldKind.ValueType  # 1
+    """A typed column: one operator plus one value editor. `type` is the value
+    type and the grammar resolves operators/functions from it.
+    """
+    FILTER_FIELD_KIND_MAP: _FilterFieldKind.ValueType  # 2
+    """A dynamic key/value family (e.g. metadata). `name` is the map namespace and
+    `key` the chosen index. `type` is UNSPECIFIED because the value type is the
+    chosen key's type, resolved per key via the grammar.
+    """
+    FILTER_FIELD_KIND_RELATION: _FilterFieldKind.ValueType  # 3
+    """A has-many collection filtered by a CEL comprehension
+    (e.g. measurements.exists(m, m.name == "humidity" && m.numeric_value > 50)).
+    See the recursive `fields` and `quantifiers` below.
+    """
+    FILTER_FIELD_KIND_DIRECTIVE: _FilterFieldKind.ValueType  # 4
+    """A pseudo-field (e.g. include_archived) that resolves to query shape rather
+    than a column.
+    """
+
+class FilterFieldKind(_FilterFieldKind, metaclass=_FilterFieldKindEnumTypeWrapper):
+    """Describes the structural shape of a filter field: how a client builds a
+    predicate for it. This is orthogonal to FilterFieldType (the value's data
+    type) and to the entity/name/key identity (which field it is).
+    """
+
+FILTER_FIELD_KIND_UNSPECIFIED: FilterFieldKind.ValueType  # 0
+"""Unset. Treated as FILTER_FIELD_KIND_SCALAR for backward compatibility."""
+FILTER_FIELD_KIND_SCALAR: FilterFieldKind.ValueType  # 1
+"""A typed column: one operator plus one value editor. `type` is the value
+type and the grammar resolves operators/functions from it.
+"""
+FILTER_FIELD_KIND_MAP: FilterFieldKind.ValueType  # 2
+"""A dynamic key/value family (e.g. metadata). `name` is the map namespace and
+`key` the chosen index. `type` is UNSPECIFIED because the value type is the
+chosen key's type, resolved per key via the grammar.
+"""
+FILTER_FIELD_KIND_RELATION: FilterFieldKind.ValueType  # 3
+"""A has-many collection filtered by a CEL comprehension
+(e.g. measurements.exists(m, m.name == "humidity" && m.numeric_value > 50)).
+See the recursive `fields` and `quantifiers` below.
+"""
+FILTER_FIELD_KIND_DIRECTIVE: FilterFieldKind.ValueType  # 4
+"""A pseudo-field (e.g. include_archived) that resolves to query shape rather
+than a column.
+"""
+global___FilterFieldKind = FilterFieldKind
+
+@typing.final
+class FilterField(google.protobuf.message.Message):
+    """Describes a single field available for CEL filtering on a resource."""
+
+    DESCRIPTOR: google.protobuf.descriptor.Descriptor
+
+    FIELD_NAME_FIELD_NUMBER: builtins.int
+    TYPE_FIELD_NUMBER: builtins.int
+    ENUM_VALUES_FIELD_NUMBER: builtins.int
+    DESCRIPTION_FIELD_NUMBER: builtins.int
+    DISPLAY_NAME_FIELD_NUMBER: builtins.int
+    OPERATORS_FIELD_NUMBER: builtins.int
+    FUNCTIONS_FIELD_NUMBER: builtins.int
+    NULLABLE_FIELD_NUMBER: builtins.int
+    ENTITY_FIELD_NUMBER: builtins.int
+    NAME_FIELD_NUMBER: builtins.int
+    KEY_FIELD_NUMBER: builtins.int
+    FIELD_KIND_FIELD_NUMBER: builtins.int
+    FIELDS_FIELD_NUMBER: builtins.int
+    QUANTIFIERS_FIELD_NUMBER: builtins.int
+    field_name: builtins.str
+    """The field name to use in CEL filter expressions (e.g., "run_id", "created_date")."""
+    type: global___FilterFieldType.ValueType
+    """The data type of the field. UUID and ENUM are first-class types, so no
+    separate boolean flags are needed.
+    """
+    description: builtins.str
+    """Human-readable description of the field (e.g., "When the run was created")."""
+    display_name: builtins.str
+    """Human-friendly display name (e.g., "Asset Name" for field_name "asset_name")."""
+    nullable: builtins.bool
+    """Whether the field can compare against null. For a metadata key this is true:
+    a key that is not set on an entity reads as null, so `field == null` matches
+    entities missing the key and `field != null` matches those that have it.
+    (There is no separate "set but null" state, since an assigned metadata value
+    always holds a concrete value.) Optional so that an unset value means
+    "unknown" rather than implicitly "not nullable".
+    """
+    entity: builtins.str
+    """The owning scope of the field (e.g. "report", "test_step"). Together with
+    `name` and `key` this is the structured identity of the field; `field_name`
+    is its deterministic CEL serialization, so the client never assembles or
+    parses it. Optional; empty when the field carries no structured identity.
+    """
+    name: builtins.str
+    """The fixed field on the entity: a column, a map namespace (e.g. "metadata"),
+    or a relation (e.g. "measurements"). Optional.
+
+    When the field corresponds to a field on the resource's own message, `name`
+    matches that field's name (e.g. `run_id` or `is_archived` on a run), so it
+    maps directly to the resource schema you already know. Fields that are
+    derived or computed and have no direct counterpart on the message
+    (e.g. `duration_string`) carry a descriptive name instead.
+    """
+    key: builtins.str
+    """The dynamic map index when `name` is a map (e.g. the metadata key). Empty
+    when `name` is not a map. Optional.
+    """
+    field_kind: global___FilterFieldKind.ValueType
+    """The structural shape of the field. Unset is treated as SCALAR."""
+    @property
+    def enum_values(self) -> google.protobuf.internal.containers.RepeatedScalarFieldContainer[builtins.str]:
+        """If type is FILTER_FIELD_TYPE_ENUM, these are the valid string values."""
+
+    @property
+    def operators(self) -> google.protobuf.internal.containers.RepeatedScalarFieldContainer[builtins.str]:
+        """CEL infix operator tokens valid for this field, e.g. "==", "in". Usually the
+        default set for the field's type, but narrower when the field restricts it.
+        Display copy for each token comes from FilterGrammarService.
+        """
+
+    @property
+    def functions(self) -> google.protobuf.internal.containers.RepeatedScalarFieldContainer[builtins.str]:
+        """CEL member function names valid for this field, e.g. "contains", "getFullYear".
+        Display copy for each name comes from FilterGrammarService.
+        """
+
+    @property
+    def fields(self) -> google.protobuf.internal.containers.RepeatedCompositeFieldContainer[global___FilterField]:
+        """For a RELATION field, the relation's filterable columns, each a full
+        FilterField (e.g. "name", "numeric_value", "passed" for measurements).
+        Empty for non-relation kinds.
+        """
+
+    @property
+    def quantifiers(self) -> google.protobuf.internal.containers.RepeatedScalarFieldContainer[builtins.str]:
+        """For a RELATION field, the comprehension macros that apply
+        (e.g. "exists", "all", "exists_one"). The client picks one, then composes
+        inner predicates over `fields`. Empty for non-relation kinds.
+        """
+
+    def __init__(
+        self,
+        *,
+        field_name: builtins.str = ...,
+        type: global___FilterFieldType.ValueType = ...,
+        enum_values: collections.abc.Iterable[builtins.str] | None = ...,
+        description: builtins.str = ...,
+        display_name: builtins.str = ...,
+        operators: collections.abc.Iterable[builtins.str] | None = ...,
+        functions: collections.abc.Iterable[builtins.str] | None = ...,
+        nullable: builtins.bool | None = ...,
+        entity: builtins.str = ...,
+        name: builtins.str = ...,
+        key: builtins.str = ...,
+        field_kind: global___FilterFieldKind.ValueType = ...,
+        fields: collections.abc.Iterable[global___FilterField] | None = ...,
+        quantifiers: collections.abc.Iterable[builtins.str] | None = ...,
+    ) -> None: ...
+    def HasField(self, field_name: typing.Literal["_nullable", b"_nullable", "nullable", b"nullable"]) -> builtins.bool: ...
+    def ClearField(self, field_name: typing.Literal["_nullable", b"_nullable", "description", b"description", "display_name", b"display_name", "entity", b"entity", "enum_values", b"enum_values", "field_kind", b"field_kind", "field_name", b"field_name", "fields", b"fields", "functions", b"functions", "key", b"key", "name", b"name", "nullable", b"nullable", "operators", b"operators", "quantifiers", b"quantifiers", "type", b"type"]) -> None: ...
+    def WhichOneof(self, oneof_group: typing.Literal["_nullable", b"_nullable"]) -> typing.Literal["nullable"] | None: ...
+
+global___FilterField = FilterField