viam-sdk 0.3.0__py3-none-linux_armv6l.whl → 0.66.0__py3-none-linux_armv6l.whl

viam/components/switch/client.py

@@ -0,0 +1,83 @@
+from typing import Any, Mapping, Optional, Sequence, Tuple
+
+from grpclib.client import Channel
+
+from viam.gen.component.switch.v1.switch_pb2 import (
+    GetNumberOfPositionsRequest,
+    GetNumberOfPositionsResponse,
+    GetPositionRequest,
+    GetPositionResponse,
+    SetPositionRequest,
+)
+from viam.proto.common import (
+    DoCommandRequest,
+    DoCommandResponse,
+)
+from viam.proto.component.switch import SwitchServiceStub
+from viam.resource.rpc_client_base import ReconfigurableResourceRPCClientBase
+from viam.utils import (
+    ValueTypes,
+    dict_to_struct,
+    struct_to_dict,
+)
+
+from .switch import Switch
+
+
+class SwitchClient(Switch, ReconfigurableResourceRPCClientBase):
+    """
+    gRPC client for Switch component
+    """
+
+    def __init__(self, name: str, channel: Channel):
+        self.channel = channel
+        self.client = SwitchServiceStub(channel)
+        super().__init__(name)
+
+    async def get_position(
+        self,
+        *,
+        extra: Optional[Mapping[str, Any]] = None,
+        timeout: Optional[float] = None,
+        **kwargs,
+    ) -> int:
+        md = kwargs.get("metadata", self.Metadata()).proto
+        request = GetPositionRequest(name=self.name, extra=dict_to_struct(extra))
+        response: GetPositionResponse = await self.client.GetPosition(request, timeout=timeout, metadata=md)
+        return response.position
+
+    async def set_position(
+        self,
+        position: int,
+        *,
+        extra: Optional[Mapping[str, Any]] = None,
+        timeout: Optional[float] = None,
+        **kwargs,
+    ) -> None:
+        md = kwargs.get("metadata", self.Metadata()).proto
+        request = SetPositionRequest(name=self.name, position=position, extra=dict_to_struct(extra))
+        await self.client.SetPosition(request, timeout=timeout, metadata=md)
+
+    async def get_number_of_positions(
+        self,
+        *,
+        extra: Optional[Mapping[str, Any]] = None,
+        timeout: Optional[float] = None,
+        **kwargs,
+    ) -> Tuple[int, Sequence[str]]:
+        md = kwargs.get("metadata", self.Metadata()).proto
+        request = GetNumberOfPositionsRequest(name=self.name, extra=dict_to_struct(extra))
+        response: GetNumberOfPositionsResponse = await self.client.GetNumberOfPositions(request, timeout=timeout, metadata=md)
+        return response.number_of_positions, response.labels
+
+    async def do_command(
+        self,
+        command: Mapping[str, ValueTypes],
+        *,
+        timeout: Optional[float] = None,
+        **kwargs,
+    ) -> Mapping[str, ValueTypes]:
+        md = kwargs.get("metadata", self.Metadata()).proto
+        request = DoCommandRequest(name=self.name, command=dict_to_struct(command))
+        response: DoCommandResponse = await self.client.DoCommand(request, timeout=timeout, metadata=md)
+        return struct_to_dict(response.result)

viam/components/switch/service.py

@@ -0,0 +1,72 @@
+from grpclib.server import Stream
+
+from viam.gen.component.switch.v1.switch_pb2 import (
+    GetNumberOfPositionsRequest,
+    GetNumberOfPositionsResponse,
+    GetPositionRequest,
+    GetPositionResponse,
+    SetPositionRequest,
+    SetPositionResponse,
+)
+from viam.proto.common import (
+    DoCommandRequest,
+    DoCommandResponse,
+)
+from viam.proto.component.switch import SwitchServiceBase
+from viam.resource.rpc_service_base import ResourceRPCServiceBase
+from viam.utils import dict_to_struct, struct_to_dict
+
+from .switch import Switch
+
+
+class SwitchRPCService(SwitchServiceBase, ResourceRPCServiceBase[Switch]):
+    """
+    gRPC Service for a generic Switch
+    """
+
+    RESOURCE_TYPE = Switch
+
+    async def GetPosition(self, stream: Stream[GetPositionRequest, GetPositionResponse]) -> None:
+        request = await stream.recv_message()
+        assert request is not None
+        name = request.name
+        switch = self.get_resource(name)
+        timeout = stream.deadline.time_remaining() if stream.deadline else None
+        position = await switch.get_position(extra=struct_to_dict(request.extra), timeout=timeout, metadata=stream.metadata)
+        response = GetPositionResponse(position=position)
+        await stream.send_message(response)
+
+    async def SetPosition(self, stream: Stream[SetPositionRequest, SetPositionResponse]) -> None:
+        request = await stream.recv_message()
+        assert request is not None
+        name = request.name
+        switch = self.get_resource(name)
+        timeout = stream.deadline.time_remaining() if stream.deadline else None
+        await switch.set_position(position=request.position, extra=struct_to_dict(request.extra), timeout=timeout, metadata=stream.metadata)
+        await stream.send_message(SetPositionResponse())
+
+    async def GetNumberOfPositions(self, stream: Stream[GetNumberOfPositionsRequest, GetNumberOfPositionsResponse]) -> None:
+        request = await stream.recv_message()
+        assert request is not None
+        name = request.name
+        switch = self.get_resource(name)
+        timeout = stream.deadline.time_remaining() if stream.deadline else None
+        number_of_positions, labels = await switch.get_number_of_positions(
+            extra=struct_to_dict(request.extra), timeout=timeout, metadata=stream.metadata
+        )
+        response = GetNumberOfPositionsResponse(number_of_positions=number_of_positions, labels=labels)
+        await stream.send_message(response)
+
+    async def DoCommand(self, stream: Stream[DoCommandRequest, DoCommandResponse]) -> None:
+        request = await stream.recv_message()
+        assert request is not None
+        name = request.name
+        switch = self.get_resource(name)
+        timeout = stream.deadline.time_remaining() if stream.deadline else None
+        result = await switch.do_command(
+            command=struct_to_dict(request.command),
+            timeout=timeout,
+            metadata=stream.metadata,
+        )
+        response = DoCommandResponse(result=dict_to_struct(result))
+        await stream.send_message(response)

viam/components/switch/switch.py

@@ -0,0 +1,98 @@
+import abc
+from typing import Any, Final, Mapping, Optional, Sequence, Tuple
+
+from viam.components.component_base import ComponentBase
+from viam.resource.types import API, RESOURCE_NAMESPACE_RDK, RESOURCE_TYPE_COMPONENT
+
+
+class Switch(ComponentBase):
+    """
+    Switch represents a device with two or more finite states (or positions) than can be set and retrieved.
+
+    This acts as an abstract base class for any drivers representing specific
+    switch implementations. This cannot be used on its own. If the ``__init__()`` function is
+    overridden, it must call the ``super().__init__()`` function.
+
+    ::
+
+        from viam.components.switch import Switch
+
+    For more information, see `Switch component <https://docs.viam.com/dev/reference/apis/components/switch/>`_.
+    """
+
+    API: Final = API(  # pyright: ignore [reportIncompatibleVariableOverride]
+        RESOURCE_NAMESPACE_RDK, RESOURCE_TYPE_COMPONENT, "switch"
+    )
+
+    @abc.abstractmethod
+    async def get_position(self, *, extra: Optional[Mapping[str, Any]] = None, timeout: Optional[float] = None, **kwargs) -> int:
+        """
+        Get the current position of the switch
+
+        ::
+
+            my_switch = Switch.from_robot(robot=machine, name="my_switch")
+
+            # Update the switch from its current position to the desired position of 1.
+            await my_switch.set_position(1)
+
+            # Get the current set position of the switch.
+            pos1 = await my_switch.get_position()
+
+            # Update the switch from its current position to the desired position.
+            await my_switch.set_position(0)
+
+            # Get the current set position of the switch.
+            pos2 = await my_switch.get_position()
+
+        Returns:
+            int: The current position of the switch within the range of available positions.
+
+        For more information, see `Switch component <https://docs.viam.com/dev/reference/apis/components/Switch/#getposition>`_.
+        """
+        ...
+
+    @abc.abstractmethod
+    async def set_position(
+        self, position: int, *, extra: Optional[Mapping[str, Any]] = None, timeout: Optional[float] = None, **kwargs
+    ) -> None:
+        """
+        Sets the current position of the switch.
+
+        ::
+
+            my_switch = Switch.from_robot(robot=machine, name="my_switch")
+
+            # Update the switch from its current position to the desired position of 1.
+            await my_switch.set_position(1)
+
+            # Update the switch from its current position to the desired position of 0.
+            await my_switch.set_position(0)
+
+        Args:
+            position (int): The position of the switch within the range of available positions.
+
+        For more information, see `Switch component <https://docs.viam.com/dev/reference/apis/components/switch/#setposition>`_.
+        """
+        ...
+
+    @abc.abstractmethod
+    async def get_number_of_positions(
+        self, *, extra: Optional[Mapping[str, Any]] = None, timeout: Optional[float] = None, **kwargs
+    ) -> Tuple[int, Sequence[str]]:
+        """
+        Get the number of available positions on the switch.
+
+        ::
+
+            my_switch = Switch.from_robot(robot=machine, name="my_switch")
+
+            print(await my_switch.get_number_of_positions())
+
+        Returns:
+            Tuple[int, Sequence[str]]: The number of available positions and their labels
+
+
+        For more information, see `Switch component <https://docs.viam.com/dev/reference/apis/components/switch/#getnumberofpositions>`_.
+        """
+        ...

viam/errors.py

@@ -93,3 +93,13 @@ class ValidationError(ViamGRPCError):
     def __init__(self, message: str):
         self.message = message
         self.grpc_code = Status.INVALID_ARGUMENT
+
+
+class NoCaptureToStoreError(ViamGRPCError):
+    """
+    Exception raised in filter module to signal that data capture should not be stored
+    """
+
+    def __init__(self):
+        self.message = "no capture from filter module"  # Do not change the contents of this string
+        self.grpc_code = Status.FAILED_PRECONDITION

viam/gen/app/agent/v1/agent_grpc.py

@@ -0,0 +1,29 @@
+import abc
+import typing
+import grpclib.const
+import grpclib.client
+import grpclib.exceptions
+if typing.TYPE_CHECKING:
+    import grpclib.server
+import google.protobuf.duration_pb2
+import google.protobuf.struct_pb2
+from .... import app
+
+class AgentDeviceServiceBase(abc.ABC):
+
+    @abc.abstractmethod
+    async def DeviceAgentConfig(self, stream: 'grpclib.server.Stream[app.agent.v1.agent_pb2.DeviceAgentConfigRequest, app.agent.v1.agent_pb2.DeviceAgentConfigResponse]') -> None:
+        pass
+
+    def __mapping__(self) -> typing.Dict[str, grpclib.const.Handler]:
+        return {'/viam.app.agent.v1.AgentDeviceService/DeviceAgentConfig': grpclib.const.Handler(self.DeviceAgentConfig, grpclib.const.Cardinality.UNARY_UNARY, app.agent.v1.agent_pb2.DeviceAgentConfigRequest, app.agent.v1.agent_pb2.DeviceAgentConfigResponse)}
+
+class UnimplementedAgentDeviceServiceBase(AgentDeviceServiceBase):
+
+    async def DeviceAgentConfig(self, stream: 'grpclib.server.Stream[app.agent.v1.agent_pb2.DeviceAgentConfigRequest, app.agent.v1.agent_pb2.DeviceAgentConfigResponse]') -> None:
+        raise grpclib.exceptions.GRPCError(grpclib.const.Status.UNIMPLEMENTED)
+
+class AgentDeviceServiceStub:
+
+    def __init__(self, channel: grpclib.client.Channel) -> None:
+        self.DeviceAgentConfig = grpclib.client.UnaryUnaryMethod(channel, '/viam.app.agent.v1.AgentDeviceService/DeviceAgentConfig', app.agent.v1.agent_pb2.DeviceAgentConfigRequest, app.agent.v1.agent_pb2.DeviceAgentConfigResponse)

viam/gen/app/agent/v1/agent_pb2.py

@@ -0,0 +1,47 @@
+"""Generated protocol buffer code."""
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import descriptor_pool as _descriptor_pool
+from google.protobuf import runtime_version as _runtime_version
+from google.protobuf import symbol_database as _symbol_database
+from google.protobuf.internal import builder as _builder
+_runtime_version.ValidateProtobufRuntimeVersion(_runtime_version.Domain.PUBLIC, 5, 29, 2, '', 'app/agent/v1/agent.proto')
+_sym_db = _symbol_database.Default()
+from google.protobuf import duration_pb2 as google_dot_protobuf_dot_duration__pb2
+from google.protobuf import struct_pb2 as google_dot_protobuf_dot_struct__pb2
+DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n\x18app/agent/v1/agent.proto\x12\x11viam.app.agent.v1\x1a\x1egoogle/protobuf/duration.proto\x1a\x1cgoogle/protobuf/struct.proto"\xe4\x02\n\x18DeviceAgentConfigRequest\x12\x0e\n\x02id\x18\x01 \x01(\tR\x02id\x128\n\thost_info\x18\x02 \x01(\x0b2\x1b.viam.app.agent.v1.HostInfoR\x08hostInfo\x12u\n\x12subsystem_versions\x18\x03 \x03(\x0b2B.viam.app.agent.v1.DeviceAgentConfigRequest.SubsystemVersionsEntryB\x02\x18\x01R\x11subsystemVersions\x12A\n\x0cversion_info\x18\x04 \x01(\x0b2\x1e.viam.app.agent.v1.VersionInfoR\x0bversionInfo\x1aD\n\x16SubsystemVersionsEntry\x12\x10\n\x03key\x18\x01 \x01(\tR\x03key\x12\x14\n\x05value\x18\x02 \x01(\tR\x05value:\x028\x01"\x8c\x06\n\x19DeviceAgentConfigResponse\x12s\n\x11subsystem_configs\x18\x01 \x03(\x0b2B.viam.app.agent.v1.DeviceAgentConfigResponse.SubsystemConfigsEntryB\x02\x18\x01R\x10subsystemConfigs\x12@\n\x0echeck_interval\x18\x02 \x01(\x0b2\x19.google.protobuf.DurationR\rcheckInterval\x12I\n\x11agent_update_info\x18\x03 \x01(\x0b2\x1d.viam.app.agent.v1.UpdateInfoR\x0fagentUpdateInfo\x12T\n\x17viam_server_update_info\x18\x04 \x01(\x0b2\x1d.viam.app.agent.v1.UpdateInfoR\x14viamServerUpdateInfo\x12D\n\x11advanced_settings\x18\x05 \x01(\x0b2\x17.google.protobuf.StructR\x10advancedSettings\x12L\n\x15network_configuration\x18\x06 \x01(\x0b2\x17.google.protobuf.StructR\x14networkConfiguration\x12H\n\x13additional_networks\x18\x07 \x01(\x0b2\x17.google.protobuf.StructR\x12additionalNetworks\x12J\n\x14system_configuration\x18\x08 \x01(\x0b2\x17.google.protobuf.StructR\x13systemConfiguration\x1am\n\x15SubsystemConfigsEntry\x12\x10\n\x03key\x18\x01 \x01(\tR\x03key\x12>\n\x05value\x18\x02 \x01(\x0b2(.viam.app.agent.v1.DeviceSubsystemConfigR\x05value:\x028\x01"\xd3\x01\n\x15DeviceSubsystemConfig\x12>\n\x0bupdate_info\x18\x01 \x01(\x0b2\x1d.viam.app.agent.v1.UpdateInfoR\nupdateInfo\x12\x18\n\x07disable\x18\x02 \x01(\x08R\x07disable\x12#\n\rforce_restart\x18\x03 \x01(\x08R\x0cforceRestart\x127\n\nattributes\x18\x04 \x01(\x0b2\x17.google.protobuf.StructR\nattributes:\x02\x18\x01"\xbf\x01\n\x0bVersionInfo\x12#\n\ragent_running\x18\x01 \x01(\tR\x0cagentRunning\x12\'\n\x0fagent_installed\x18\x02 \x01(\tR\x0eagentInstalled\x12.\n\x13viam_server_running\x18\x03 \x01(\tR\x11viamServerRunning\x122\n\x15viam_server_installed\x18\x04 \x01(\tR\x13viamServerInstalled"R\n\x08HostInfo\x12\x1a\n\x08platform\x18\x01 \x01(\tR\x08platform\x12\x16\n\x06distro\x18\x02 \x01(\tR\x06distro\x12\x12\n\x04tags\x18\x03 \x03(\tR\x04tags"\xa6\x01\n\nUpdateInfo\x12\x1a\n\x08filename\x18\x01 \x01(\tR\x08filename\x12\x10\n\x03url\x18\x02 \x01(\tR\x03url\x12\x18\n\x07version\x18\x03 \x01(\tR\x07version\x12\x16\n\x06sha256\x18\x04 \x01(\x0cR\x06sha256\x128\n\x06format\x18\x05 \x01(\x0e2 .viam.app.agent.v1.PackageFormatR\x06format*\x9f\x01\n\rPackageFormat\x12\x1e\n\x1aPACKAGE_FORMAT_UNSPECIFIED\x10\x00\x12\x16\n\x12PACKAGE_FORMAT_RAW\x10\x01\x12\x15\n\x11PACKAGE_FORMAT_XZ\x10\x02\x12\x1d\n\x19PACKAGE_FORMAT_EXECUTABLE\x10\x03\x12 \n\x1cPACKAGE_FORMAT_XZ_EXECUTABLE\x10\x042\x84\x01\n\x12AgentDeviceService\x12n\n\x11DeviceAgentConfig\x12+.viam.app.agent.v1.DeviceAgentConfigRequest\x1a,.viam.app.agent.v1.DeviceAgentConfigResponseB\x1eZ\x1cgo.viam.com/api/app/agent/v1b\x06proto3')
+_globals = globals()
+_builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, _globals)
+_builder.BuildTopDescriptorsAndMessages(DESCRIPTOR, 'app.agent.v1.agent_pb2', _globals)
+if not _descriptor._USE_C_DESCRIPTORS:
+    _globals['DESCRIPTOR']._loaded_options = None
+    _globals['DESCRIPTOR']._serialized_options = b'Z\x1cgo.viam.com/api/app/agent/v1'
+    _globals['_DEVICEAGENTCONFIGREQUEST_SUBSYSTEMVERSIONSENTRY']._loaded_options = None
+    _globals['_DEVICEAGENTCONFIGREQUEST_SUBSYSTEMVERSIONSENTRY']._serialized_options = b'8\x01'
+    _globals['_DEVICEAGENTCONFIGREQUEST'].fields_by_name['subsystem_versions']._loaded_options = None
+    _globals['_DEVICEAGENTCONFIGREQUEST'].fields_by_name['subsystem_versions']._serialized_options = b'\x18\x01'
+    _globals['_DEVICEAGENTCONFIGRESPONSE_SUBSYSTEMCONFIGSENTRY']._loaded_options = None
+    _globals['_DEVICEAGENTCONFIGRESPONSE_SUBSYSTEMCONFIGSENTRY']._serialized_options = b'8\x01'
+    _globals['_DEVICEAGENTCONFIGRESPONSE'].fields_by_name['subsystem_configs']._loaded_options = None
+    _globals['_DEVICEAGENTCONFIGRESPONSE'].fields_by_name['subsystem_configs']._serialized_options = b'\x18\x01'
+    _globals['_DEVICESUBSYSTEMCONFIG']._loaded_options = None
+    _globals['_DEVICESUBSYSTEMCONFIG']._serialized_options = b'\x18\x01'
+    _globals['_PACKAGEFORMAT']._serialized_start = 1913
+    _globals['_PACKAGEFORMAT']._serialized_end = 2072
+    _globals['_DEVICEAGENTCONFIGREQUEST']._serialized_start = 110
+    _globals['_DEVICEAGENTCONFIGREQUEST']._serialized_end = 466
+    _globals['_DEVICEAGENTCONFIGREQUEST_SUBSYSTEMVERSIONSENTRY']._serialized_start = 398
+    _globals['_DEVICEAGENTCONFIGREQUEST_SUBSYSTEMVERSIONSENTRY']._serialized_end = 466
+    _globals['_DEVICEAGENTCONFIGRESPONSE']._serialized_start = 469
+    _globals['_DEVICEAGENTCONFIGRESPONSE']._serialized_end = 1249
+    _globals['_DEVICEAGENTCONFIGRESPONSE_SUBSYSTEMCONFIGSENTRY']._serialized_start = 1140
+    _globals['_DEVICEAGENTCONFIGRESPONSE_SUBSYSTEMCONFIGSENTRY']._serialized_end = 1249
+    _globals['_DEVICESUBSYSTEMCONFIG']._serialized_start = 1252
+    _globals['_DEVICESUBSYSTEMCONFIG']._serialized_end = 1463
+    _globals['_VERSIONINFO']._serialized_start = 1466
+    _globals['_VERSIONINFO']._serialized_end = 1657
+    _globals['_HOSTINFO']._serialized_start = 1659
+    _globals['_HOSTINFO']._serialized_end = 1741
+    _globals['_UPDATEINFO']._serialized_start = 1744
+    _globals['_UPDATEINFO']._serialized_end = 1910
+    _globals['_AGENTDEVICESERVICE']._serialized_start = 2075
+    _globals['_AGENTDEVICESERVICE']._serialized_end = 2207

viam/gen/app/agent/v1/agent_pb2.pyi

@@ -0,0 +1,280 @@
+"""
+@generated by mypy-protobuf.  Do not edit manually!
+isort:skip_file
+"""
+import builtins
+import collections.abc
+import google.protobuf.descriptor
+import google.protobuf.duration_pb2
+import google.protobuf.internal.containers
+import google.protobuf.internal.enum_type_wrapper
+import google.protobuf.message
+import google.protobuf.struct_pb2
+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 _PackageFormat:
+    ValueType = typing.NewType('ValueType', builtins.int)
+    V: typing_extensions.TypeAlias = ValueType
+
+class _PackageFormatEnumTypeWrapper(google.protobuf.internal.enum_type_wrapper._EnumTypeWrapper[_PackageFormat.ValueType], builtins.type):
+    DESCRIPTOR: google.protobuf.descriptor.EnumDescriptor
+    PACKAGE_FORMAT_UNSPECIFIED: _PackageFormat.ValueType
+    'unknown/unset (autodetection may be attempted)'
+    PACKAGE_FORMAT_RAW: _PackageFormat.ValueType
+    'do nothing'
+    PACKAGE_FORMAT_XZ: _PackageFormat.ValueType
+    'decompress .xz file'
+    PACKAGE_FORMAT_EXECUTABLE: _PackageFormat.ValueType
+    'set executable permissions'
+    PACKAGE_FORMAT_XZ_EXECUTABLE: _PackageFormat.ValueType
+    'decompress and set executable'
+
+class PackageFormat(_PackageFormat, metaclass=_PackageFormatEnumTypeWrapper):
+    ...
+PACKAGE_FORMAT_UNSPECIFIED: PackageFormat.ValueType
+'unknown/unset (autodetection may be attempted)'
+PACKAGE_FORMAT_RAW: PackageFormat.ValueType
+'do nothing'
+PACKAGE_FORMAT_XZ: PackageFormat.ValueType
+'decompress .xz file'
+PACKAGE_FORMAT_EXECUTABLE: PackageFormat.ValueType
+'set executable permissions'
+PACKAGE_FORMAT_XZ_EXECUTABLE: PackageFormat.ValueType
+'decompress and set executable'
+global___PackageFormat = PackageFormat
+
+@typing.final
+class DeviceAgentConfigRequest(google.protobuf.message.Message):
+    """Device side"""
+    DESCRIPTOR: google.protobuf.descriptor.Descriptor
+
+    @typing.final
+    class SubsystemVersionsEntry(google.protobuf.message.Message):
+        DESCRIPTOR: google.protobuf.descriptor.Descriptor
+        KEY_FIELD_NUMBER: builtins.int
+        VALUE_FIELD_NUMBER: builtins.int
+        key: builtins.str
+        value: builtins.str
+
+        def __init__(self, *, key: builtins.str=..., value: builtins.str=...) -> None:
+            ...
+
+        def ClearField(self, field_name: typing.Literal['key', b'key', 'value', b'value']) -> None:
+            ...
+    ID_FIELD_NUMBER: builtins.int
+    HOST_INFO_FIELD_NUMBER: builtins.int
+    SUBSYSTEM_VERSIONS_FIELD_NUMBER: builtins.int
+    VERSION_INFO_FIELD_NUMBER: builtins.int
+    id: builtins.str
+    'robot partID'
+
+    @property
+    def host_info(self) -> global___HostInfo:
+        """info about the host system"""
+
+    @property
+    def subsystem_versions(self) -> google.protobuf.internal.containers.ScalarMap[builtins.str, builtins.str]:
+        """current subsystems and versions
+        DEPRECATED in favor of version_info
+        """
+
+    @property
+    def version_info(self) -> global___VersionInfo:
+        """Currently installed versions for agent and viam-server"""
+
+    def __init__(self, *, id: builtins.str=..., host_info: global___HostInfo | None=..., subsystem_versions: collections.abc.Mapping[builtins.str, builtins.str] | None=..., version_info: global___VersionInfo | None=...) -> None:
+        ...
+
+    def HasField(self, field_name: typing.Literal['host_info', b'host_info', 'version_info', b'version_info']) -> builtins.bool:
+        ...
+
+    def ClearField(self, field_name: typing.Literal['host_info', b'host_info', 'id', b'id', 'subsystem_versions', b'subsystem_versions', 'version_info', b'version_info']) -> None:
+        ...
+global___DeviceAgentConfigRequest = DeviceAgentConfigRequest
+
+@typing.final
+class DeviceAgentConfigResponse(google.protobuf.message.Message):
+    DESCRIPTOR: google.protobuf.descriptor.Descriptor
+
+    @typing.final
+    class SubsystemConfigsEntry(google.protobuf.message.Message):
+        DESCRIPTOR: google.protobuf.descriptor.Descriptor
+        KEY_FIELD_NUMBER: builtins.int
+        VALUE_FIELD_NUMBER: builtins.int
+        key: builtins.str
+
+        @property
+        def value(self) -> global___DeviceSubsystemConfig:
+            ...
+
+        def __init__(self, *, key: builtins.str=..., value: global___DeviceSubsystemConfig | None=...) -> None:
+            ...
+
+        def HasField(self, field_name: typing.Literal['value', b'value']) -> builtins.bool:
+            ...
+
+        def ClearField(self, field_name: typing.Literal['key', b'key', 'value', b'value']) -> None:
+            ...
+    SUBSYSTEM_CONFIGS_FIELD_NUMBER: builtins.int
+    CHECK_INTERVAL_FIELD_NUMBER: builtins.int
+    AGENT_UPDATE_INFO_FIELD_NUMBER: builtins.int
+    VIAM_SERVER_UPDATE_INFO_FIELD_NUMBER: builtins.int
+    ADVANCED_SETTINGS_FIELD_NUMBER: builtins.int
+    NETWORK_CONFIGURATION_FIELD_NUMBER: builtins.int
+    ADDITIONAL_NETWORKS_FIELD_NUMBER: builtins.int
+    SYSTEM_CONFIGURATION_FIELD_NUMBER: builtins.int
+
+    @property
+    def subsystem_configs(self) -> google.protobuf.internal.containers.MessageMap[builtins.str, global___DeviceSubsystemConfig]:
+        """subsystems to be installed/configured/updated
+        note: previously installed subsystems will be removed from the system if removed from this list
+        DEPRECATED in favor of indidivual update_info and settings fields
+        """
+
+    @property
+    def check_interval(self) -> google.protobuf.duration_pb2.Duration:
+        """how often this request should be repeated"""
+
+    @property
+    def agent_update_info(self) -> global___UpdateInfo:
+        """update info for agent and viam-server, parsed/processed in App"""
+
+    @property
+    def viam_server_update_info(self) -> global___UpdateInfo:
+        ...
+
+    @property
+    def advanced_settings(self) -> google.protobuf.struct_pb2.Struct:
+        """various settings that are passed directly to device Agent"""
+
+    @property
+    def network_configuration(self) -> google.protobuf.struct_pb2.Struct:
+        ...
+
+    @property
+    def additional_networks(self) -> google.protobuf.struct_pb2.Struct:
+        ...
+
+    @property
+    def system_configuration(self) -> google.protobuf.struct_pb2.Struct:
+        ...
+
+    def __init__(self, *, subsystem_configs: collections.abc.Mapping[builtins.str, global___DeviceSubsystemConfig] | None=..., check_interval: google.protobuf.duration_pb2.Duration | None=..., agent_update_info: global___UpdateInfo | None=..., viam_server_update_info: global___UpdateInfo | None=..., advanced_settings: google.protobuf.struct_pb2.Struct | None=..., network_configuration: google.protobuf.struct_pb2.Struct | None=..., additional_networks: google.protobuf.struct_pb2.Struct | None=..., system_configuration: google.protobuf.struct_pb2.Struct | None=...) -> None:
+        ...
+
+    def HasField(self, field_name: typing.Literal['additional_networks', b'additional_networks', 'advanced_settings', b'advanced_settings', 'agent_update_info', b'agent_update_info', 'check_interval', b'check_interval', 'network_configuration', b'network_configuration', 'system_configuration', b'system_configuration', 'viam_server_update_info', b'viam_server_update_info']) -> builtins.bool:
+        ...
+
+    def ClearField(self, field_name: typing.Literal['additional_networks', b'additional_networks', 'advanced_settings', b'advanced_settings', 'agent_update_info', b'agent_update_info', 'check_interval', b'check_interval', 'network_configuration', b'network_configuration', 'subsystem_configs', b'subsystem_configs', 'system_configuration', b'system_configuration', 'viam_server_update_info', b'viam_server_update_info']) -> None:
+        ...
+global___DeviceAgentConfigResponse = DeviceAgentConfigResponse
+
+@typing.final
+class DeviceSubsystemConfig(google.protobuf.message.Message):
+    """DEPRECATED as of January 2025"""
+    DESCRIPTOR: google.protobuf.descriptor.Descriptor
+    UPDATE_INFO_FIELD_NUMBER: builtins.int
+    DISABLE_FIELD_NUMBER: builtins.int
+    FORCE_RESTART_FIELD_NUMBER: builtins.int
+    ATTRIBUTES_FIELD_NUMBER: builtins.int
+    disable: builtins.bool
+    'if this subsystem is disabled and should not be started by the agent'
+    force_restart: builtins.bool
+    'force_restart will restart the subsystem, even if no updates are available'
+
+    @property
+    def update_info(self) -> global___UpdateInfo:
+        """data needed to download/validate the subsystem"""
+
+    @property
+    def attributes(self) -> google.protobuf.struct_pb2.Struct:
+        """arbitrary config sections"""
+
+    def __init__(self, *, update_info: global___UpdateInfo | None=..., disable: builtins.bool=..., force_restart: builtins.bool=..., attributes: google.protobuf.struct_pb2.Struct | None=...) -> None:
+        ...
+
+    def HasField(self, field_name: typing.Literal['attributes', b'attributes', 'update_info', b'update_info']) -> builtins.bool:
+        ...
+
+    def ClearField(self, field_name: typing.Literal['attributes', b'attributes', 'disable', b'disable', 'force_restart', b'force_restart', 'update_info', b'update_info']) -> None:
+        ...
+global___DeviceSubsystemConfig = DeviceSubsystemConfig
+
+@typing.final
+class VersionInfo(google.protobuf.message.Message):
+    DESCRIPTOR: google.protobuf.descriptor.Descriptor
+    AGENT_RUNNING_FIELD_NUMBER: builtins.int
+    AGENT_INSTALLED_FIELD_NUMBER: builtins.int
+    VIAM_SERVER_RUNNING_FIELD_NUMBER: builtins.int
+    VIAM_SERVER_INSTALLED_FIELD_NUMBER: builtins.int
+    agent_running: builtins.str
+    'the version of agent currently running and making the request'
+    agent_installed: builtins.str
+    'the version of agent installed (will run after restart if different)'
+    viam_server_running: builtins.str
+    'the version of viam-server currently running'
+    viam_server_installed: builtins.str
+    'the version of viam-server installed (will run after restart if different)'
+
+    def __init__(self, *, agent_running: builtins.str=..., agent_installed: builtins.str=..., viam_server_running: builtins.str=..., viam_server_installed: builtins.str=...) -> None:
+        ...
+
+    def ClearField(self, field_name: typing.Literal['agent_installed', b'agent_installed', 'agent_running', b'agent_running', 'viam_server_installed', b'viam_server_installed', 'viam_server_running', b'viam_server_running']) -> None:
+        ...
+global___VersionInfo = VersionInfo
+
+@typing.final
+class HostInfo(google.protobuf.message.Message):
+    DESCRIPTOR: google.protobuf.descriptor.Descriptor
+    PLATFORM_FIELD_NUMBER: builtins.int
+    DISTRO_FIELD_NUMBER: builtins.int
+    TAGS_FIELD_NUMBER: builtins.int
+    platform: builtins.str
+    'platform is the docker styled combination of kernel and architecture. Ex: linux/amd64, darwin/arm64'
+    distro: builtins.str
+    'ID and VERSION_ID fields from /etc/os-release, colon seperated. Ex: ubuntu:22.04, debian:11'
+
+    @property
+    def tags(self) -> google.protobuf.internal.containers.RepeatedScalarFieldContainer[builtins.str]:
+        """additional tags for specific hardware or software that's present and may affect software selection
+        ex: "jetson", "rpi4", "systemd", etc.
+        """
+
+    def __init__(self, *, platform: builtins.str=..., distro: builtins.str=..., tags: collections.abc.Iterable[builtins.str] | None=...) -> None:
+        ...
+
+    def ClearField(self, field_name: typing.Literal['distro', b'distro', 'platform', b'platform', 'tags', b'tags']) -> None:
+        ...
+global___HostInfo = HostInfo
+
+@typing.final
+class UpdateInfo(google.protobuf.message.Message):
+    DESCRIPTOR: google.protobuf.descriptor.Descriptor
+    FILENAME_FIELD_NUMBER: builtins.int
+    URL_FIELD_NUMBER: builtins.int
+    VERSION_FIELD_NUMBER: builtins.int
+    SHA256_FIELD_NUMBER: builtins.int
+    FORMAT_FIELD_NUMBER: builtins.int
+    filename: builtins.str
+    'unpacked filename as it is expected on disk (regardless of url)'
+    url: builtins.str
+    'url to download from'
+    version: builtins.str
+    'version expected at the url'
+    sha256: builtins.bytes
+    'sha256 sum of file as downloaded'
+    format: global___PackageFormat.ValueType
+    'determines if decompression or executable permissions are needed'
+
+    def __init__(self, *, filename: builtins.str=..., url: builtins.str=..., version: builtins.str=..., sha256: builtins.bytes=..., format: global___PackageFormat.ValueType=...) -> None:
+        ...
+
+    def ClearField(self, field_name: typing.Literal['filename', b'filename', 'format', b'format', 'sha256', b'sha256', 'url', b'url', 'version', b'version']) -> None:
+        ...
+global___UpdateInfo = UpdateInfo