viam-sdk 0.25.2__py3-none-linux_armv7l.whl → 0.62.0__py3-none-linux_armv7l.whl

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 = 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)
+        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,95 @@
+import abc
+from typing import Any, Final, Mapping, Optional
+
+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) -> int:
+        """
+        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:
+            int: The number of available positions.
+
+        For more information, see `Switch component <https://docs.viam.com/dev/reference/apis/components/switch/#getnumberofpositions>`_.
+        """
+        ...

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

@@ -1,36 +1,47 @@
 """Generated protocol buffer code."""
-from google.protobuf.internal import builder as _builder
 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"\x9d\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\x12q\n\x12subsystem_versions\x18\x03 \x03(\x0b2B.viam.app.agent.v1.DeviceAgentConfigRequest.SubsystemVersionsEntryR\x11subsystemVersions\x1aD\n\x16SubsystemVersionsEntry\x12\x10\n\x03key\x18\x01 \x01(\tR\x03key\x12\x14\n\x05value\x18\x02 \x01(\tR\x05value:\x028\x01"\xbd\x02\n\x19DeviceAgentConfigResponse\x12o\n\x11subsystem_configs\x18\x01 \x03(\x0b2B.viam.app.agent.v1.DeviceAgentConfigResponse.SubsystemConfigsEntryR\x10subsystemConfigs\x12@\n\x0echeck_interval\x18\x02 \x01(\x0b2\x19.google.protobuf.DurationR\rcheckInterval\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"\xd8\x01\n\x15DeviceSubsystemConfig\x12G\n\x0bupdate_info\x18\x01 \x01(\x0b2&.viam.app.agent.v1.SubsystemUpdateInfoR\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"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"\xaf\x01\n\x13SubsystemUpdateInfo\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')
-_builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, globals())
-_builder.BuildTopDescriptorsAndMessages(DESCRIPTOR, 'app.agent.v1.agent_pb2', globals())
-if _descriptor._USE_C_DESCRIPTORS == False:
-    DESCRIPTOR._options = None
-    DESCRIPTOR._serialized_options = b'Z\x1cgo.viam.com/api/app/agent/v1'
-    _DEVICEAGENTCONFIGREQUEST_SUBSYSTEMVERSIONSENTRY._options = None
-    _DEVICEAGENTCONFIGREQUEST_SUBSYSTEMVERSIONSENTRY._serialized_options = b'8\x01'
-    _DEVICEAGENTCONFIGRESPONSE_SUBSYSTEMCONFIGSENTRY._options = None
-    _DEVICEAGENTCONFIGRESPONSE_SUBSYSTEMCONFIGSENTRY._serialized_options = b'8\x01'
-    _PACKAGEFORMAT._serialized_start = 1199
-    _PACKAGEFORMAT._serialized_end = 1358
-    _DEVICEAGENTCONFIGREQUEST._serialized_start = 110
-    _DEVICEAGENTCONFIGREQUEST._serialized_end = 395
-    _DEVICEAGENTCONFIGREQUEST_SUBSYSTEMVERSIONSENTRY._serialized_start = 327
-    _DEVICEAGENTCONFIGREQUEST_SUBSYSTEMVERSIONSENTRY._serialized_end = 395
-    _DEVICEAGENTCONFIGRESPONSE._serialized_start = 398
-    _DEVICEAGENTCONFIGRESPONSE._serialized_end = 715
-    _DEVICEAGENTCONFIGRESPONSE_SUBSYSTEMCONFIGSENTRY._serialized_start = 606
-    _DEVICEAGENTCONFIGRESPONSE_SUBSYSTEMCONFIGSENTRY._serialized_end = 715
-    _DEVICESUBSYSTEMCONFIG._serialized_start = 718
-    _DEVICESUBSYSTEMCONFIG._serialized_end = 934
-    _HOSTINFO._serialized_start = 936
-    _HOSTINFO._serialized_end = 1018
-    _SUBSYSTEMUPDATEINFO._serialized_start = 1021
-    _SUBSYSTEMUPDATEINFO._serialized_end = 1196
-    _AGENTDEVICESERVICE._serialized_start = 1361
-    _AGENTDEVICESERVICE._serialized_end = 1493
+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

@@ -70,6 +70,7 @@ class DeviceAgentConfigRequest(google.protobuf.message.Message):
     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'
 
@@ -79,15 +80,21 @@ class DeviceAgentConfigRequest(google.protobuf.message.Message):
 
     @property
     def subsystem_versions(self) -> google.protobuf.internal.containers.ScalarMap[builtins.str, builtins.str]:
-        """current subsystems and versions"""
+        """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=...) -> None:
+    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']) -> builtins.bool:
+    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']) -> None:
+    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
 
@@ -116,29 +123,61 @@ class DeviceAgentConfigResponse(google.protobuf.message.Message):
             ...
     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"""
 
-    def __init__(self, *, subsystem_configs: collections.abc.Mapping[builtins.str, global___DeviceSubsystemConfig] | None=..., check_interval: google.protobuf.duration_pb2.Duration | None=...) -> None:
+    @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:
         ...
 
-    def HasField(self, field_name: typing.Literal['check_interval', b'check_interval']) -> builtins.bool:
+    @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:
         ...
 
-    def ClearField(self, field_name: typing.Literal['check_interval', b'check_interval', 'subsystem_configs', b'subsystem_configs']) -> None:
+    @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
@@ -150,14 +189,14 @@ class DeviceSubsystemConfig(google.protobuf.message.Message):
     'force_restart will restart the subsystem, even if no updates are available'
 
     @property
-    def update_info(self) -> global___SubsystemUpdateInfo:
+    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___SubsystemUpdateInfo | None=..., disable: builtins.bool=..., force_restart: builtins.bool=..., attributes: google.protobuf.struct_pb2.Struct | None=...) -> None:
+    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:
@@ -167,6 +206,29 @@ class DeviceSubsystemConfig(google.protobuf.message.Message):
         ...
 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
@@ -192,7 +254,7 @@ class HostInfo(google.protobuf.message.Message):
 global___HostInfo = HostInfo
 
 @typing.final
-class SubsystemUpdateInfo(google.protobuf.message.Message):
+class UpdateInfo(google.protobuf.message.Message):
     DESCRIPTOR: google.protobuf.descriptor.Descriptor
     FILENAME_FIELD_NUMBER: builtins.int
     URL_FIELD_NUMBER: builtins.int
@@ -215,4 +277,4 @@ class SubsystemUpdateInfo(google.protobuf.message.Message):
 
     def ClearField(self, field_name: typing.Literal['filename', b'filename', 'format', b'format', 'sha256', b'sha256', 'url', b'url', 'version', b'version']) -> None:
         ...
-global___SubsystemUpdateInfo = SubsystemUpdateInfo
+global___UpdateInfo = UpdateInfo

viam/gen/app/cloudslam/v1/cloud_slam_pb2.py

@@ -1,51 +1,54 @@
 """Generated protocol buffer code."""
-from google.protobuf.internal import builder as _builder
 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/cloudslam/v1/cloud_slam.proto')
 _sym_db = _symbol_database.Default()
 from ....common.v1 import common_pb2 as common_dot_v1_dot_common__pb2
 from google.protobuf import struct_pb2 as google_dot_protobuf_dot_struct__pb2
 from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
 DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n!app/cloudslam/v1/cloud_slam.proto\x12\x15viam.app.cloudslam.v1\x1a\x16common/v1/common.proto\x1a\x1cgoogle/protobuf/struct.proto\x1a\x1fgoogle/protobuf/timestamp.proto"\xa2\x04\n\x1aStartMappingSessionRequest\x12!\n\x0cslam_version\x18\x01 \x01(\tR\x0bslamVersion\x12.\n\x13viam_server_version\x18\x02 \x01(\tR\x11viamServerVersion\x12\x19\n\x08map_name\x18\x03 \x01(\tR\x07mapName\x12\'\n\x0forganization_id\x18\x04 \x01(\tR\x0eorganizationId\x12\x1f\n\x0blocation_id\x18\x05 \x01(\tR\nlocationId\x12\x19\n\x08robot_id\x18\x06 \x01(\tR\x07robotId\x12Q\n\x10capture_interval\x18\x07 \x01(\x0b2&.viam.app.cloudslam.v1.CaptureIntervalR\x0fcaptureInterval\x12;\n\x07sensors\x18\x08 \x03(\x0b2!.viam.app.cloudslam.v1.SensorInfoR\x07sensors\x128\n\x0bslam_config\x18\n \x01(\x0b2\x17.google.protobuf.StructR\nslamConfig\x120\n\x14existing_map_version\x18\x0b \x01(\tR\x12existingMapVersion\x125\n\x06module\x18\x0c \x01(\x0b2\x1d.viam.app.cloudslam.v1.ModuleR\x06module"S\n\x06Module\x12\x12\n\x04name\x18\x02 \x01(\tR\x04name\x12\x1b\n\tmodule_id\x18\x03 \x01(\tR\x08moduleId\x12\x18\n\x07version\x18\x04 \x01(\tR\x07version"\x80\x01\n\nSensorInfo\x122\n\x15source_component_name\x18\x01 \x01(\tR\x13sourceComponentName\x12\x12\n\x04type\x18\x02 \x01(\tR\x04type\x12*\n\x11data_frequency_hz\x18\x03 \x01(\tR\x0fdataFrequencyHz"\x83\x01\n\x0fCaptureInterval\x129\n\nstart_time\x18\x01 \x01(\x0b2\x1a.google.protobuf.TimestampR\tstartTime\x125\n\x08end_time\x18\x02 \x01(\x0b2\x1a.google.protobuf.TimestampR\x07endTime"<\n\x1bStartMappingSessionResponse\x12\x1d\n\nsession_id\x18\x01 \x01(\tR\tsessionId"D\n\'GetActiveMappingSessionsForRobotRequest\x12\x19\n\x08robot_id\x18\x01 \x01(\tR\x07robotId"I\n(GetActiveMappingSessionsForRobotResponse\x12\x1d\n\nsession_id\x18\x01 \x01(\tR\tsessionId"C\n"GetMappingSessionPointCloudRequest\x12\x1d\n\nsession_id\x18\x01 \x01(\tR\tsessionId"h\n#GetMappingSessionPointCloudResponse\x12\x17\n\x07map_url\x18\x01 \x01(\tR\x06mapUrl\x12(\n\x04pose\x18\x02 \x01(\x0b2\x14.viam.common.v1.PoseR\x04pose"f\n\x1aListMappingSessionsRequest\x12\'\n\x0forganization_id\x18\x01 \x01(\tR\x0eorganizationId\x12\x1f\n\x0blocation_id\x18\x02 \x01(\tR\nlocationId"_\n\x1bListMappingSessionsResponse\x12@\n\x07session\x18\x01 \x03(\x0b2&.viam.app.cloudslam.v1.MappingMetadataR\x07session":\n\x19StopMappingSessionRequest\x12\x1d\n\nsession_id\x18\x01 \x01(\tR\tsessionId"U\n\x1aStopMappingSessionResponse\x12\x1d\n\npackage_id\x18\x01 \x01(\tR\tpackageId\x12\x18\n\x07version\x18\x02 \x01(\tR\x07version"E\n$GetMappingSessionMetadataByIDRequest\x12\x1d\n\nsession_id\x18\x01 \x01(\tR\tsessionId"z\n%GetMappingSessionMetadataByIDResponse\x12Q\n\x10session_metadata\x18\x01 \x01(\x0b2&.viam.app.cloudslam.v1.MappingMetadataR\x0fsessionMetadata"\xb5\x05\n\x0fMappingMetadata\x12\x15\n\x06org_id\x18\x01 \x01(\tR\x05orgId\x12\x1f\n\x0blocation_id\x18\x02 \x01(\tR\nlocationId\x12\x19\n\x08robot_id\x18\x03 \x01(\tR\x07robotId\x12L\n\x14time_start_submitted\x18\x04 \x01(\x0b2\x1a.google.protobuf.TimestampR\x12timeStartSubmitted\x12V\n\x1atime_cloud_run_job_started\x18\x05 \x01(\x0b2\x1a.google.protobuf.TimestampR\x16timeCloudRunJobStarted\x12H\n\x12time_end_submitted\x18\x06 \x01(\x0b2\x1a.google.protobuf.TimestampR\x10timeEndSubmitted\x12R\n\x18time_cloud_run_job_ended\x18\x07 \x01(\x0b2\x1a.google.protobuf.TimestampR\x14timeCloudRunJobEnded\x12?\n\nend_status\x18\x08 \x01(\x0e2 .viam.app.cloudslam.v1.EndStatusR\tendStatus\x12\'\n\x10cloud_run_job_id\x18\t \x01(\tR\rcloudRunJobId\x12.\n\x13viam_server_version\x18\n \x01(\tR\x11viamServerVersion\x12\x19\n\x08map_name\x18\x0b \x01(\tR\x07mapName\x12!\n\x0cslam_version\x18\x0c \x01(\tR\x0bslamVersion\x12\x16\n\x06config\x18\r \x01(\tR\x06config\x12\x1b\n\terror_msg\x18\x0e \x01(\tR\x08errorMsg*l\n\tEndStatus\x12\x1a\n\x16END_STATUS_UNSPECIFIED\x10\x00\x12\x16\n\x12END_STATUS_SUCCESS\x10\x01\x12\x16\n\x12END_STATUS_TIMEOUT\x10\x02\x12\x13\n\x0fEND_STATUS_FAIL\x10\x032\xe3\x06\n\x10CloudSLAMService\x12|\n\x13StartMappingSession\x121.viam.app.cloudslam.v1.StartMappingSessionRequest\x1a2.viam.app.cloudslam.v1.StartMappingSessionResponse\x12\xa3\x01\n GetActiveMappingSessionsForRobot\x12>.viam.app.cloudslam.v1.GetActiveMappingSessionsForRobotRequest\x1a?.viam.app.cloudslam.v1.GetActiveMappingSessionsForRobotResponse\x12\x94\x01\n\x1bGetMappingSessionPointCloud\x129.viam.app.cloudslam.v1.GetMappingSessionPointCloudRequest\x1a:.viam.app.cloudslam.v1.GetMappingSessionPointCloudResponse\x12|\n\x13ListMappingSessions\x121.viam.app.cloudslam.v1.ListMappingSessionsRequest\x1a2.viam.app.cloudslam.v1.ListMappingSessionsResponse\x12y\n\x12StopMappingSession\x120.viam.app.cloudslam.v1.StopMappingSessionRequest\x1a1.viam.app.cloudslam.v1.StopMappingSessionResponse\x12\x9a\x01\n\x1dGetMappingSessionMetadataByID\x12;.viam.app.cloudslam.v1.GetMappingSessionMetadataByIDRequest\x1a<.viam.app.cloudslam.v1.GetMappingSessionMetadataByIDResponseB"Z go.viam.com/api/app/cloudslam/v1b\x06proto3')
-_builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, globals())
-_builder.BuildTopDescriptorsAndMessages(DESCRIPTOR, 'app.cloudslam.v1.cloud_slam_pb2', globals())
-if _descriptor._USE_C_DESCRIPTORS == False:
-    DESCRIPTOR._options = None
-    DESCRIPTOR._serialized_options = b'Z go.viam.com/api/app/cloudslam/v1'
-    _ENDSTATUS._serialized_start = 2667
-    _ENDSTATUS._serialized_end = 2775
-    _STARTMAPPINGSESSIONREQUEST._serialized_start = 148
-    _STARTMAPPINGSESSIONREQUEST._serialized_end = 694
-    _MODULE._serialized_start = 696
-    _MODULE._serialized_end = 779
-    _SENSORINFO._serialized_start = 782
-    _SENSORINFO._serialized_end = 910
-    _CAPTUREINTERVAL._serialized_start = 913
-    _CAPTUREINTERVAL._serialized_end = 1044
-    _STARTMAPPINGSESSIONRESPONSE._serialized_start = 1046
-    _STARTMAPPINGSESSIONRESPONSE._serialized_end = 1106
-    _GETACTIVEMAPPINGSESSIONSFORROBOTREQUEST._serialized_start = 1108
-    _GETACTIVEMAPPINGSESSIONSFORROBOTREQUEST._serialized_end = 1176
-    _GETACTIVEMAPPINGSESSIONSFORROBOTRESPONSE._serialized_start = 1178
-    _GETACTIVEMAPPINGSESSIONSFORROBOTRESPONSE._serialized_end = 1251
-    _GETMAPPINGSESSIONPOINTCLOUDREQUEST._serialized_start = 1253
-    _GETMAPPINGSESSIONPOINTCLOUDREQUEST._serialized_end = 1320
-    _GETMAPPINGSESSIONPOINTCLOUDRESPONSE._serialized_start = 1322
-    _GETMAPPINGSESSIONPOINTCLOUDRESPONSE._serialized_end = 1426
-    _LISTMAPPINGSESSIONSREQUEST._serialized_start = 1428
-    _LISTMAPPINGSESSIONSREQUEST._serialized_end = 1530
-    _LISTMAPPINGSESSIONSRESPONSE._serialized_start = 1532
-    _LISTMAPPINGSESSIONSRESPONSE._serialized_end = 1627
-    _STOPMAPPINGSESSIONREQUEST._serialized_start = 1629
-    _STOPMAPPINGSESSIONREQUEST._serialized_end = 1687
-    _STOPMAPPINGSESSIONRESPONSE._serialized_start = 1689
-    _STOPMAPPINGSESSIONRESPONSE._serialized_end = 1774
-    _GETMAPPINGSESSIONMETADATABYIDREQUEST._serialized_start = 1776
-    _GETMAPPINGSESSIONMETADATABYIDREQUEST._serialized_end = 1845
-    _GETMAPPINGSESSIONMETADATABYIDRESPONSE._serialized_start = 1847
-    _GETMAPPINGSESSIONMETADATABYIDRESPONSE._serialized_end = 1969
-    _MAPPINGMETADATA._serialized_start = 1972
-    _MAPPINGMETADATA._serialized_end = 2665
-    _CLOUDSLAMSERVICE._serialized_start = 2778
-    _CLOUDSLAMSERVICE._serialized_end = 3645
+_globals = globals()
+_builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, _globals)
+_builder.BuildTopDescriptorsAndMessages(DESCRIPTOR, 'app.cloudslam.v1.cloud_slam_pb2', _globals)
+if not _descriptor._USE_C_DESCRIPTORS:
+    _globals['DESCRIPTOR']._loaded_options = None
+    _globals['DESCRIPTOR']._serialized_options = b'Z go.viam.com/api/app/cloudslam/v1'
+    _globals['_ENDSTATUS']._serialized_start = 2667
+    _globals['_ENDSTATUS']._serialized_end = 2775
+    _globals['_STARTMAPPINGSESSIONREQUEST']._serialized_start = 148
+    _globals['_STARTMAPPINGSESSIONREQUEST']._serialized_end = 694
+    _globals['_MODULE']._serialized_start = 696
+    _globals['_MODULE']._serialized_end = 779
+    _globals['_SENSORINFO']._serialized_start = 782
+    _globals['_SENSORINFO']._serialized_end = 910
+    _globals['_CAPTUREINTERVAL']._serialized_start = 913
+    _globals['_CAPTUREINTERVAL']._serialized_end = 1044
+    _globals['_STARTMAPPINGSESSIONRESPONSE']._serialized_start = 1046
+    _globals['_STARTMAPPINGSESSIONRESPONSE']._serialized_end = 1106
+    _globals['_GETACTIVEMAPPINGSESSIONSFORROBOTREQUEST']._serialized_start = 1108
+    _globals['_GETACTIVEMAPPINGSESSIONSFORROBOTREQUEST']._serialized_end = 1176
+    _globals['_GETACTIVEMAPPINGSESSIONSFORROBOTRESPONSE']._serialized_start = 1178
+    _globals['_GETACTIVEMAPPINGSESSIONSFORROBOTRESPONSE']._serialized_end = 1251
+    _globals['_GETMAPPINGSESSIONPOINTCLOUDREQUEST']._serialized_start = 1253
+    _globals['_GETMAPPINGSESSIONPOINTCLOUDREQUEST']._serialized_end = 1320
+    _globals['_GETMAPPINGSESSIONPOINTCLOUDRESPONSE']._serialized_start = 1322
+    _globals['_GETMAPPINGSESSIONPOINTCLOUDRESPONSE']._serialized_end = 1426
+    _globals['_LISTMAPPINGSESSIONSREQUEST']._serialized_start = 1428
+    _globals['_LISTMAPPINGSESSIONSREQUEST']._serialized_end = 1530
+    _globals['_LISTMAPPINGSESSIONSRESPONSE']._serialized_start = 1532
+    _globals['_LISTMAPPINGSESSIONSRESPONSE']._serialized_end = 1627
+    _globals['_STOPMAPPINGSESSIONREQUEST']._serialized_start = 1629
+    _globals['_STOPMAPPINGSESSIONREQUEST']._serialized_end = 1687
+    _globals['_STOPMAPPINGSESSIONRESPONSE']._serialized_start = 1689
+    _globals['_STOPMAPPINGSESSIONRESPONSE']._serialized_end = 1774
+    _globals['_GETMAPPINGSESSIONMETADATABYIDREQUEST']._serialized_start = 1776
+    _globals['_GETMAPPINGSESSIONMETADATABYIDREQUEST']._serialized_end = 1845
+    _globals['_GETMAPPINGSESSIONMETADATABYIDRESPONSE']._serialized_start = 1847
+    _globals['_GETMAPPINGSESSIONMETADATABYIDRESPONSE']._serialized_end = 1969
+    _globals['_MAPPINGMETADATA']._serialized_start = 1972
+    _globals['_MAPPINGMETADATA']._serialized_end = 2665
+    _globals['_CLOUDSLAMSERVICE']._serialized_start = 2778
+    _globals['_CLOUDSLAMSERVICE']._serialized_end = 3645