viam.gen.app.agent.v1.agent_pb2

@generated by mypy-protobuf. Do not edit manually! isort:skip_file

Module Contents

Classes

PackageFormat
DeviceAgentConfigRequest	Device side
DeviceAgentConfigResponse	Abstract base class for protocol messages.
DeviceSubsystemConfig	Abstract base class for protocol messages.
HostInfo	Abstract base class for protocol messages.
SubsystemUpdateInfo	Abstract base class for protocol messages.

Attributes

DESCRIPTOR
PACKAGE_FORMAT_UNSPECIFIED	unknown/unset (autodetection may be attempted)
PACKAGE_FORMAT_RAW	do nothing
PACKAGE_FORMAT_XZ	decompress .xz file
PACKAGE_FORMAT_EXECUTABLE	set executable permissions
PACKAGE_FORMAT_XZ_EXECUTABLE	decompress and set executable
global___PackageFormat
global___DeviceAgentConfigRequest
global___DeviceAgentConfigResponse
global___DeviceSubsystemConfig
global___HostInfo
global___SubsystemUpdateInfo

viam.gen.app.agent.v1.agent_pb2.DESCRIPTOR: google.protobuf.descriptor.FileDescriptor

class viam.gen.app.agent.v1.agent_pb2.PackageFormat

Bases: _PackageFormat

viam.gen.app.agent.v1.agent_pb2.PACKAGE_FORMAT_UNSPECIFIED: PackageFormat

unknown/unset (autodetection may be attempted)

viam.gen.app.agent.v1.agent_pb2.PACKAGE_FORMAT_RAW: PackageFormat

do nothing

viam.gen.app.agent.v1.agent_pb2.PACKAGE_FORMAT_XZ: PackageFormat

decompress .xz file

viam.gen.app.agent.v1.agent_pb2.PACKAGE_FORMAT_EXECUTABLE: PackageFormat

set executable permissions

viam.gen.app.agent.v1.agent_pb2.PACKAGE_FORMAT_XZ_EXECUTABLE: PackageFormat

decompress and set executable

viam.gen.app.agent.v1.agent_pb2.global___PackageFormat

class viam.gen.app.agent.v1.agent_pb2.DeviceAgentConfigRequest(*, id: str = ..., host_info: global___HostInfo | None = ..., subsystem_versions: collections.abc.Mapping[str, str] | None = ...)

Bases: google.protobuf.message.Message

Device side

class SubsystemVersionsEntry(*, key: str = ..., value: str = ...)

Bases: google.protobuf.message.Message

Abstract base class for protocol messages.

Protocol message classes are almost always generated by the protocol compiler. These generated types subclass Message and implement the methods shown below.

key: str

value: str

property host_info: global___HostInfo

info about the host system

property subsystem_versions: google.protobuf.internal.containers.ScalarMap[str, str]

current subsystems and versions

id: str

robot partID

HasField(field_name: Literal[host_info, b'host_info']) → bool

Checks if a certain field is set for the message.

For a oneof group, checks if any field inside is set. Note that if the field_name is not defined in the message descriptor, ValueError will be raised.

Parameters:

field_name (str) – The name of the field to check for presence.

Returns:

Whether a value has been set for the named field.

Return type:

bool

Raises:

ValueError – if the field_name is not a member of this message.

viam.gen.app.agent.v1.agent_pb2.global___DeviceAgentConfigRequest

class viam.gen.app.agent.v1.agent_pb2.DeviceAgentConfigResponse(*, subsystem_configs: collections.abc.Mapping[str, global___DeviceSubsystemConfig] | None = ..., check_interval: google.protobuf.duration_pb2.Duration | None = ...)

Bases: google.protobuf.message.Message

Abstract base class for protocol messages.

Protocol message classes are almost always generated by the protocol compiler. These generated types subclass Message and implement the methods shown below.

class SubsystemConfigsEntry(*, key: str = ..., value: global___DeviceSubsystemConfig | None = ...)

Bases: google.protobuf.message.Message

Abstract base class for protocol messages.

Protocol message classes are almost always generated by the protocol compiler. These generated types subclass Message and implement the methods shown below.

property value: global___DeviceSubsystemConfig

key: str

HasField(field_name: Literal[value, b'value']) → bool

Checks if a certain field is set for the message.

For a oneof group, checks if any field inside is set. Note that if the field_name is not defined in the message descriptor, ValueError will be raised.

Parameters:

field_name (str) – The name of the field to check for presence.

Returns:

Whether a value has been set for the named field.

Return type:

bool

Raises:

ValueError – if the field_name is not a member of this message.

property subsystem_configs: google.protobuf.internal.containers.MessageMap[str, global___DeviceSubsystemConfig]

subsystems to be installed/configured/updated note: previously installed subsystems will be removed from the system if removed from this list

property check_interval: google.protobuf.duration_pb2.Duration

how often this request should be repeated

HasField(field_name: Literal[check_interval, b'check_interval']) → bool

Checks if a certain field is set for the message.

For a oneof group, checks if any field inside is set. Note that if the field_name is not defined in the message descriptor, ValueError will be raised.

Parameters:

field_name (str) – The name of the field to check for presence.

Returns:

Whether a value has been set for the named field.

Return type:

bool

Raises:

ValueError – if the field_name is not a member of this message.

viam.gen.app.agent.v1.agent_pb2.global___DeviceAgentConfigResponse

class viam.gen.app.agent.v1.agent_pb2.DeviceSubsystemConfig(*, update_info: global___SubsystemUpdateInfo | None = ..., disable: bool = ..., force_restart: bool = ..., attributes: google.protobuf.struct_pb2.Struct | None = ...)

Bases: google.protobuf.message.Message

Abstract base class for protocol messages.

Protocol message classes are almost always generated by the protocol compiler. These generated types subclass Message and implement the methods shown below.

property update_info: global___SubsystemUpdateInfo

data needed to download/validate the subsystem

property attributes: google.protobuf.struct_pb2.Struct

arbitrary config sections

disable: bool

if this subsystem is disabled and should not be started by the agent

force_restart: bool

force_restart will restart the subsystem, even if no updates are available

HasField(field_name: Literal[attributes, b'attributes', update_info, b'update_info']) → bool

Checks if a certain field is set for the message.

For a oneof group, checks if any field inside is set. Note that if the field_name is not defined in the message descriptor, ValueError will be raised.

Parameters:

field_name (str) – The name of the field to check for presence.

Returns:

Whether a value has been set for the named field.

Return type:

bool

Raises:

ValueError – if the field_name is not a member of this message.

viam.gen.app.agent.v1.agent_pb2.global___DeviceSubsystemConfig

class viam.gen.app.agent.v1.agent_pb2.HostInfo(*, platform: str = ..., distro: str = ..., tags: collections.abc.Iterable[str] | None = ...)

Bases: google.protobuf.message.Message

Abstract base class for protocol messages.

Protocol message classes are almost always generated by the protocol compiler. These generated types subclass Message and implement the methods shown below.

property tags: google.protobuf.internal.containers.RepeatedScalarFieldContainer[str]

additional tags for specific hardware or software that’s present and may affect software selection ex: “jetson”, “rpi4”, “systemd”, etc.

platform: str

linux/amd64, darwin/arm64

Type:

platform is the docker styled combination of kernel and architecture. Ex

distro: str

22.04, debian:11

Type:

ID and VERSION_ID fields from /etc/os-release, colon seperated. Ex

Type:

ubuntu

viam.gen.app.agent.v1.agent_pb2.global___HostInfo

class viam.gen.app.agent.v1.agent_pb2.SubsystemUpdateInfo(*, filename: str = ..., url: str = ..., version: str = ..., sha256: bytes = ..., format: global___PackageFormat = ...)

Bases: google.protobuf.message.Message

Abstract base class for protocol messages.

Protocol message classes are almost always generated by the protocol compiler. These generated types subclass Message and implement the methods shown below.

filename: str

unpacked filename as it is expected on disk (regardless of url)

url: str

url to download from

version: str

version expected at the url

sha256: bytes

sha256 sum of file as downloaded

format: global___PackageFormat

determines if decompression or executable permissions are needed

viam.gen.app.agent.v1.agent_pb2.global___SubsystemUpdateInfo