viam.gen.app.v1.robot_pb2

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

Attributes

`DESCRIPTOR`
`CREDENTIALS_TYPE_UNSPECIFIED`
`CREDENTIALS_TYPE_INTERNAL`
`CREDENTIALS_TYPE_API_KEY`
`CREDENTIALS_TYPE_ROBOT_SECRET`
`CREDENTIALS_TYPE_ROBOT_LOCATION_SECRET`
`Global___CredentialsType`
`Global___RobotConfig`
`Global___LogPatternConfig`
`Global___JobConfig`
`Global___TracingConfig`
`Global___LocationSecret`
`Global___AppValidationStatus`
`Global___CloudConfig`
`Global___ComponentConfig`
`Global___ResourceLevelServiceConfig`
`Global___ProcessConfig`
`Global___ServiceConfig`
`Global___NetworkConfig`
`Global___SessionsConfig`
`Global___TrafficTunnelEndpoint`
`Global___AuthConfig`
`Global___JWKSFile`
`Global___ExternalAuthConfig`
`Global___AuthHandlerConfig`
`Global___Frame`
`Global___LogConfiguration`
`Global___Translation`
`Global___Orientation`
`Global___RemoteConfig`
`Global___RemoteAuth`
`Global___AgentInfo`
`Global___ConfigRequest`
`Global___ConfigResponse`
`Global___CertificateRequest`
`Global___CertificateResponse`
`Global___LogRequest`
`Global___LogResponse`
`Global___NeedsRestartRequest`
`Global___NeedsRestartResponse`
`Global___ModuleConfig`
`Global___PackageConfig`
`Global___MaintenanceConfig`

Classes

`CredentialsType`
`RobotConfig`	Abstract base class for protocol messages.
`LogPatternConfig`	LogPatternConfig allows you to specify a 2-tuple consisting
`JobConfig`	Abstract base class for protocol messages.
`TracingConfig`	TracingConfig configures whether viam-server will record traces and if so
`LocationSecret`	Valid location secret that can be used for authentication to the robot.
`AppValidationStatus`	Abstract base class for protocol messages.
`CloudConfig`	Abstract base class for protocol messages.
`ComponentConfig`	Abstract base class for protocol messages.
`ResourceLevelServiceConfig`	A ResourceLevelServiceConfig describes component or remote configuration for a service.
`ProcessConfig`	A ProcessConfig describes how to manage a system process.
`ServiceConfig`	Abstract base class for protocol messages.
`NetworkConfig`	Abstract base class for protocol messages.
`SessionsConfig`	Abstract base class for protocol messages.
`TrafficTunnelEndpoint`	Abstract base class for protocol messages.
`AuthConfig`	Abstract base class for protocol messages.
`JWKSFile`	Abstract base class for protocol messages.
`ExternalAuthConfig`	ExternalAuthConfig describes how a viam managed robot can accept
`AuthHandlerConfig`	Abstract base class for protocol messages.
`Frame`	Abstract base class for protocol messages.
`LogConfiguration`	Abstract base class for protocol messages.
`Translation`	Abstract base class for protocol messages.
`Orientation`	Abstract base class for protocol messages.
`RemoteConfig`	A RemoteConfig describes a remote robot that should be integrated.
`RemoteAuth`	RemoteAuth specifies how to authenticate against a remote. If no credentials are
`AgentInfo`	Abstract base class for protocol messages.
`ConfigRequest`	Abstract base class for protocol messages.
`ConfigResponse`	Abstract base class for protocol messages.
`CertificateRequest`	Abstract base class for protocol messages.
`CertificateResponse`	Abstract base class for protocol messages.
`LogRequest`	Abstract base class for protocol messages.
`LogResponse`	Abstract base class for protocol messages.
`NeedsRestartRequest`	Abstract base class for protocol messages.
`NeedsRestartResponse`	Abstract base class for protocol messages.
`ModuleConfig`	ModuleConfig is the configuration for a module.
`PackageConfig`	PackageConfig is the configration for deployed Packages.
`MaintenanceConfig`	Abstract base class for protocol messages.

Module Contents

viam.gen.app.v1.robot_pb2.DESCRIPTOR: google.protobuf.descriptor.FileDescriptor

class viam.gen.app.v1.robot_pb2.CredentialsType: Bases: _CredentialsType

viam.gen.app.v1.robot_pb2.CREDENTIALS_TYPE_UNSPECIFIED: CredentialsType

viam.gen.app.v1.robot_pb2.CREDENTIALS_TYPE_INTERNAL: CredentialsType

viam.gen.app.v1.robot_pb2.CREDENTIALS_TYPE_API_KEY: CredentialsType

viam.gen.app.v1.robot_pb2.CREDENTIALS_TYPE_ROBOT_SECRET: CredentialsType

viam.gen.app.v1.robot_pb2.CREDENTIALS_TYPE_ROBOT_LOCATION_SECRET: CredentialsType

type viam.gen.app.v1.robot_pb2.Global___CredentialsType = CredentialsType

class viam.gen.app.v1.robot_pb2.RobotConfig(*, cloud: Global___CloudConfig | None = ..., remotes: collections.abc.Iterable[Global___RemoteConfig] | None = ..., components: collections.abc.Iterable[Global___ComponentConfig] | None = ..., processes: collections.abc.Iterable[Global___ProcessConfig] | None = ..., services: collections.abc.Iterable[Global___ServiceConfig] | None = ..., network: Global___NetworkConfig | None = ..., auth: Global___AuthConfig | None = ..., debug: bool | None = ..., modules: collections.abc.Iterable[Global___ModuleConfig] | None = ..., disable_partial_start: bool | None = ..., packages: collections.abc.Iterable[Global___PackageConfig] | None = ..., overwrite_fragment_status: collections.abc.Iterable[Global___AppValidationStatus] | None = ..., enable_web_profile: bool = ..., log: collections.abc.Iterable[Global___LogPatternConfig] | None = ..., revision: str = ..., maintenance: Global___MaintenanceConfig | None = ..., disable_log_deduplication: bool = ..., jobs: collections.abc.Iterable[Global___JobConfig] | None = ..., tracing: Global___TracingConfig | 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.

debug: bool: Turns on debug mode for robot, adding an echo server and more logging and tracing. Only works after restart

disable_partial_start: bool

enable_web_profile: bool: Turns on pprof http server on localhost. By default false.

revision: str: Attributes a particular revision to the config.

disable_log_deduplication: bool: Disables the robot’s log deduplication (identical, noisy logs will still be output individually instead of aggregated.)

cloud() → Global___CloudConfig

remotes() → google.protobuf.internal.containers.RepeatedCompositeFieldContainer[Global___RemoteConfig]

components() → google.protobuf.internal.containers.RepeatedCompositeFieldContainer[Global___ComponentConfig]

processes() → google.protobuf.internal.containers.RepeatedCompositeFieldContainer[Global___ProcessConfig]

services() → google.protobuf.internal.containers.RepeatedCompositeFieldContainer[Global___ServiceConfig]

network() → Global___NetworkConfig

auth() → Global___AuthConfig

modules() → google.protobuf.internal.containers.RepeatedCompositeFieldContainer[Global___ModuleConfig]

packages() → google.protobuf.internal.containers.RepeatedCompositeFieldContainer[Global___PackageConfig]

overwrite_fragment_status() → google.protobuf.internal.containers.RepeatedCompositeFieldContainer[Global___AppValidationStatus]

log() → google.protobuf.internal.containers.RepeatedCompositeFieldContainer[Global___LogPatternConfig]

maintenance() → Global___MaintenanceConfig

jobs() → google.protobuf.internal.containers.RepeatedCompositeFieldContainer[Global___JobConfig]

tracing() → Global___TracingConfig

HasField(field_name: _HasFieldArgType) → 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.

WhichOneof(oneof_group: _WhichOneofArgType__auth) → _WhichOneofReturnType__auth | None

WhichOneof(oneof_group: _WhichOneofArgType__debug) → _WhichOneofReturnType__debug | None

WhichOneof(oneof_group: _WhichOneofArgType__disable_partial_start) → _WhichOneofReturnType__disable_partial_start | None

WhichOneof(oneof_group: _WhichOneofArgType__maintenance) → _WhichOneofReturnType__maintenance | None

WhichOneof(oneof_group: _WhichOneofArgType__network) → _WhichOneofReturnType__network | None

WhichOneof(oneof_group: _WhichOneofArgType__tracing) → _WhichOneofReturnType__tracing | None

Returns the name of the field that is set inside a oneof group.

If no field is set, returns None.

Parameters:: oneof_group (str) – the name of the oneof group to check.
Returns:: The name of the group that is set, or None.
Return type:: str or None
Raises:: ValueError – no group with the given name exists

type viam.gen.app.v1.robot_pb2.Global___RobotConfig = RobotConfig

class viam.gen.app.v1.robot_pb2.LogPatternConfig(*, pattern: str = ..., level: str = ...)

Bases: google.protobuf.message.Message

LogPatternConfig allows you to specify a 2-tuple consisting of a logger name and its corresponding log level.

pattern: str

level: str

type viam.gen.app.v1.robot_pb2.Global___LogPatternConfig = LogPatternConfig

class viam.gen.app.v1.robot_pb2.JobConfig(*, name: str = ..., schedule: str = ..., resource: str = ..., method: str = ..., command: google.protobuf.struct_pb2.Struct | None = ..., log_configuration: Global___LogConfiguration | 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.

name: str: unique name of the job.

schedule: str: a unix-cron string or a Golang-parsable duration string, specifies the interval at which the job is run.

resource: str: the resource associated with this job.

method: str: the gRPC request of this job’s resource.

command() → google.protobuf.struct_pb2.Struct: in case method is “DoCommand”, specifies the command argument of the gRPC request.

log_configuration() → Global___LogConfiguration: configuration for this job’s logger.

HasField(field_name: _HasFieldArgType) → 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.

type viam.gen.app.v1.robot_pb2.Global___JobConfig = JobConfig

class viam.gen.app.v1.robot_pb2.TracingConfig(*, enabled: bool = ..., disk: bool = ..., console: bool = ..., otlp_endpoint: str = ...)

Bases: google.protobuf.message.Message

TracingConfig configures whether viam-server will record traces and if so where it will export them.

enabled: bool: Globally enable or disable tracing support.

disk: bool: Save trace spans to a file on disk.

console: bool: Print trace spans to the console.

otlp_endpoint: str: Send trace spans to an OTLP gRPC endpoint.

type viam.gen.app.v1.robot_pb2.Global___TracingConfig = TracingConfig

class viam.gen.app.v1.robot_pb2.LocationSecret(*, id: str = ..., secret: str = ...)

Bases: google.protobuf.message.Message

Valid location secret that can be used for authentication to the robot.

id: str

secret: str: secret payload

type viam.gen.app.v1.robot_pb2.Global___LocationSecret = LocationSecret

class viam.gen.app.v1.robot_pb2.AppValidationStatus(*, error: 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.

error: str

type viam.gen.app.v1.robot_pb2.Global___AppValidationStatus = AppValidationStatus

class viam.gen.app.v1.robot_pb2.CloudConfig(*, id: str = ..., fqdn: str = ..., local_fqdn: str = ..., managed_by: str = ..., signaling_address: str = ..., signaling_insecure: bool = ..., location_secret: str = ..., secret: str = ..., location_secrets: collections.abc.Iterable[Global___LocationSecret] | None = ..., primary_org_id: str = ..., location_id: str = ..., machine_id: 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.

id: str: Robot part id.

fqdn: str

local_fqdn: str

managed_by: str

signaling_address: str

signaling_insecure: bool

location_secret() → str: Deprecated use location_secrets

secret: str: Robot part secret

primary_org_id: str

location_id: str

machine_id: str

location_secrets() → google.protobuf.internal.containers.RepeatedCompositeFieldContainer[Global___LocationSecret]: All valid location secrets.

type viam.gen.app.v1.robot_pb2.Global___CloudConfig = CloudConfig

class viam.gen.app.v1.robot_pb2.ComponentConfig(*, name: str = ..., namespace: str = ..., type: str = ..., model: str = ..., frame: Global___Frame | None = ..., depends_on: collections.abc.Iterable[str] | None = ..., service_configs: collections.abc.Iterable[Global___ResourceLevelServiceConfig] | None = ..., attributes: google.protobuf.struct_pb2.Struct | None = ..., api: str = ..., log_configuration: Global___LogConfiguration | 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.

name: str

namespace: str: deprecated; use api

type: str: deprecated; use api

model: str

api: str

frame() → Global___Frame

depends_on() → google.protobuf.internal.containers.RepeatedScalarFieldContainer[str]

service_configs() → google.protobuf.internal.containers.RepeatedCompositeFieldContainer[Global___ResourceLevelServiceConfig]

attributes() → google.protobuf.struct_pb2.Struct

log_configuration() → Global___LogConfiguration

HasField(field_name: _HasFieldArgType) → 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.

type viam.gen.app.v1.robot_pb2.Global___ComponentConfig = ComponentConfig

class viam.gen.app.v1.robot_pb2.ResourceLevelServiceConfig(*, type: str = ..., attributes: google.protobuf.struct_pb2.Struct | None = ...)

Bases: google.protobuf.message.Message

A ResourceLevelServiceConfig describes component or remote configuration for a service.

type: str

attributes() → google.protobuf.struct_pb2.Struct: TODO(adam): Should this be move to a structured type as defined in the typescript frontend.

HasField(field_name: _HasFieldArgType) → 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.

type viam.gen.app.v1.robot_pb2.Global___ResourceLevelServiceConfig = ResourceLevelServiceConfig

class viam.gen.app.v1.robot_pb2.ProcessConfig(*, id: str = ..., name: str = ..., args: collections.abc.Iterable[str] | None = ..., cwd: str = ..., one_shot: bool = ..., log: bool = ..., stop_signal: int = ..., stop_timeout: google.protobuf.duration_pb2.Duration | None = ..., env: collections.abc.Mapping[str, str] | None = ..., username: str = ...)

Bases: google.protobuf.message.Message

A ProcessConfig describes how to manage a system process.

class EnvEntry(*, 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

id: str

name: str

cwd: str

one_shot: bool

log: bool

stop_signal: int

username: str

args() → google.protobuf.internal.containers.RepeatedScalarFieldContainer[str]

stop_timeout() → google.protobuf.duration_pb2.Duration

env() → google.protobuf.internal.containers.ScalarMap[str, str]: additional environment variables passed to the process

HasField(field_name: _HasFieldArgType) → 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.

type viam.gen.app.v1.robot_pb2.Global___ProcessConfig = ProcessConfig

class viam.gen.app.v1.robot_pb2.ServiceConfig(*, name: str = ..., namespace: str = ..., type: str = ..., attributes: google.protobuf.struct_pb2.Struct | None = ..., depends_on: collections.abc.Iterable[str] | None = ..., model: str = ..., api: str = ..., service_configs: collections.abc.Iterable[Global___ResourceLevelServiceConfig] | None = ..., log_configuration: Global___LogConfiguration | 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.

name: str

namespace: str: deprecated; use api

type: str: deprecated; use api

model: str

api: str

attributes() → google.protobuf.struct_pb2.Struct

depends_on() → google.protobuf.internal.containers.RepeatedScalarFieldContainer[str]

service_configs() → google.protobuf.internal.containers.RepeatedCompositeFieldContainer[Global___ResourceLevelServiceConfig]

log_configuration() → Global___LogConfiguration

HasField(field_name: _HasFieldArgType) → 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.

type viam.gen.app.v1.robot_pb2.Global___ServiceConfig = ServiceConfig

class viam.gen.app.v1.robot_pb2.NetworkConfig(*, fqdn: str = ..., bind_address: str = ..., tls_cert_file: str = ..., tls_key_file: str = ..., sessions: Global___SessionsConfig | None = ..., traffic_tunnel_endpoints: collections.abc.Iterable[Global___TrafficTunnelEndpoint] | None = ..., no_tls: bool = ...)

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.

fqdn: str

bind_address: str

tls_cert_file: str

tls_key_file: str

no_tls: bool

sessions() → Global___SessionsConfig

traffic_tunnel_endpoints() → google.protobuf.internal.containers.RepeatedCompositeFieldContainer[Global___TrafficTunnelEndpoint]

HasField(field_name: _HasFieldArgType) → 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.

type viam.gen.app.v1.robot_pb2.Global___NetworkConfig = NetworkConfig

class viam.gen.app.v1.robot_pb2.SessionsConfig(*, heartbeat_window: 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.

heartbeat_window() → google.protobuf.duration_pb2.Duration

HasField(field_name: _HasFieldArgType) → 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.

type viam.gen.app.v1.robot_pb2.Global___SessionsConfig = SessionsConfig

class viam.gen.app.v1.robot_pb2.TrafficTunnelEndpoint(*, port: int = ..., connection_timeout: 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.

port: int

connection_timeout() → google.protobuf.duration_pb2.Duration

HasField(field_name: _HasFieldArgType) → 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.

type viam.gen.app.v1.robot_pb2.Global___TrafficTunnelEndpoint = TrafficTunnelEndpoint

class viam.gen.app.v1.robot_pb2.AuthConfig(*, handlers: collections.abc.Iterable[Global___AuthHandlerConfig] | None = ..., tls_auth_entities: collections.abc.Iterable[str] | None = ..., external_auth_config: Global___ExternalAuthConfig | 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.

handlers() → google.protobuf.internal.containers.RepeatedCompositeFieldContainer[Global___AuthHandlerConfig]

tls_auth_entities() → google.protobuf.internal.containers.RepeatedScalarFieldContainer[str]

external_auth_config() → Global___ExternalAuthConfig

HasField(field_name: _HasFieldArgType) → 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.

WhichOneof(oneof_group: _WhichOneofArgType__external_auth_config) → _WhichOneofReturnType__external_auth_config | None

Returns the name of the field that is set inside a oneof group.

If no field is set, returns None.

Parameters:: oneof_group (str) – the name of the oneof group to check.
Returns:: The name of the group that is set, or None.
Return type:: str or None
Raises:: ValueError – no group with the given name exists

type viam.gen.app.v1.robot_pb2.Global___AuthConfig = AuthConfig

class viam.gen.app.v1.robot_pb2.JWKSFile(*, json: 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.

json() → google.protobuf.struct_pb2.Struct: JSON Web Keys (JWKS) file as arbitary json. See https://www.rfc-editor.org/rfc/rfc7517

HasField(field_name: _HasFieldArgType) → 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.

type viam.gen.app.v1.robot_pb2.Global___JWKSFile = JWKSFile

class viam.gen.app.v1.robot_pb2.ExternalAuthConfig(*, jwks: Global___JWKSFile | None = ...)

Bases: google.protobuf.message.Message

ExternalAuthConfig describes how a viam managed robot can accept credentials signed by the cloud app.

jwks() → Global___JWKSFile

HasField(field_name: _HasFieldArgType) → 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.

type viam.gen.app.v1.robot_pb2.Global___ExternalAuthConfig = ExternalAuthConfig

class viam.gen.app.v1.robot_pb2.AuthHandlerConfig(*, type: Global___CredentialsType = ..., config: 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.

type: Global___CredentialsType

config() → google.protobuf.struct_pb2.Struct

HasField(field_name: _HasFieldArgType) → 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.

type viam.gen.app.v1.robot_pb2.Global___AuthHandlerConfig = AuthHandlerConfig

class viam.gen.app.v1.robot_pb2.Frame(*, parent: str = ..., translation: Global___Translation | None = ..., orientation: Global___Orientation | None = ..., geometry: common.v1.common_pb2.Geometry | 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.

parent: str

translation() → Global___Translation

orientation() → Global___Orientation

geometry() → common.v1.common_pb2.Geometry

HasField(field_name: _HasFieldArgType) → 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.

type viam.gen.app.v1.robot_pb2.Global___Frame = Frame

class viam.gen.app.v1.robot_pb2.LogConfiguration(*, level: 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.

level: str

type viam.gen.app.v1.robot_pb2.Global___LogConfiguration = LogConfiguration

class viam.gen.app.v1.robot_pb2.Translation(*, x: float = ..., y: float = ..., z: float = ...)

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.

x: float

y: float

z: float

type viam.gen.app.v1.robot_pb2.Global___Translation = Translation

class viam.gen.app.v1.robot_pb2.Orientation(*, no_orientation: Global___Orientation | None = ..., vector_radians: Global___Orientation | None = ..., vector_degrees: Global___Orientation | None = ..., euler_angles: Global___Orientation | None = ..., axis_angles: Global___Orientation | None = ..., quaternion: Global___Orientation | 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 NoOrientation

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 OrientationVectorRadians(*, theta: float = ..., x: float = ..., y: float = ..., z: float = ...)

Bases: google.protobuf.message.Message

OrientationVector containing ox, oy, oz, theta represents an orientation vector Structured similarly to an angle axis, an orientation vector works differently. Rather than representing an orientation with an arbitrary axis and a rotation around it from an origin, an orientation vector represents orientation such that the ox/oy/oz components represent the point on the cartesian unit sphere at which your end effector is pointing from the origin, and that unit vector forms an axis around which theta rotates. This means that incrementing/decrementing theta will perform an in-line rotation of the end effector. Theta is defined as rotation between two planes: the plane defined by the origin, the point (0,0,1), and the rx,ry,rz point, and the plane defined by the origin, the rx,ry,rz point, and the new local Z axis. So if theta is kept at zero as the north/south pole is circled, the Roll will correct itself to remain in-line.

theta: float

x: float

y: float

z: float

class OrientationVectorDegrees(*, theta: float = ..., x: float = ..., y: float = ..., z: float = ...)

Bases: google.protobuf.message.Message

OrientationVectorDegrees is the orientation vector between two objects, but expressed in degrees rather than radians. Because protobuf Pose is in degrees, this is necessary.

theta: float

x: float

y: float

z: float

class EulerAngles(*, roll: float = ..., pitch: float = ..., yaw: float = ...)

Bases: google.protobuf.message.Message

EulerAngles are three angles (in radians) used to represent the rotation of an object in 3D Euclidean space The Tait–Bryan angle formalism is used, with rotations around three distinct axes in the z-y′-x″ sequence.

roll: float

pitch: float

yaw: float

class AxisAngles(*, theta: float = ..., x: float = ..., y: float = ..., z: float = ...)

Bases: google.protobuf.message.Message

See here for a thorough explanation: https://en.wikipedia.org/wiki/Axis%E2%80%93angle_representation Basic explanation: Imagine a 3d cartesian grid centered at 0,0,0, and a sphere of radius 1 centered at that same point. An orientation can be expressed by first specifying an axis, i.e. a line from the origin to a point on that sphere, represented by (rx, ry, rz), and a rotation around that axis, theta. These four numbers can be used as-is (R4), or they can be converted to R3, where theta is multiplied by each of the unit sphere components to give a vector whose length is theta and whose direction is the original axis. AxisAngles represents an R4 axis angle.

theta: float

x: float

y: float

z: float

class Quaternion(*, w: float = ..., x: float = ..., y: float = ..., z: float = ...)

Bases: google.protobuf.message.Message

Quaternion is a float64 precision quaternion.

w: float

x: float

y: float

z: float

no_orientation() → Global___Orientation

vector_radians() → Global___Orientation

vector_degrees() → Global___Orientation

euler_angles() → Global___Orientation

axis_angles() → Global___Orientation

quaternion() → Global___Orientation

HasField(field_name: _HasFieldArgType) → 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.

WhichOneof(oneof_group: _WhichOneofArgType_type) → _WhichOneofReturnType_type | None

Returns the name of the field that is set inside a oneof group.

If no field is set, returns None.

Parameters:: oneof_group (str) – the name of the oneof group to check.
Returns:: The name of the group that is set, or None.
Return type:: str or None
Raises:: ValueError – no group with the given name exists

type viam.gen.app.v1.robot_pb2.Global___Orientation = Orientation

class viam.gen.app.v1.robot_pb2.RemoteConfig(*, name: str = ..., address: str = ..., frame: Global___Frame | None = ..., auth: Global___RemoteAuth | None = ..., managed_by: str = ..., insecure: bool = ..., connection_check_interval: google.protobuf.duration_pb2.Duration | None = ..., reconnect_interval: google.protobuf.duration_pb2.Duration | None = ..., service_configs: collections.abc.Iterable[Global___ResourceLevelServiceConfig] | None = ..., secret: str = ..., prefix: str = ...)

Bases: google.protobuf.message.Message

A RemoteConfig describes a remote robot that should be integrated. The Frame field defines how the “world” node of the remote robot should be reconciled with the “world” node of the the current robot. All components of the remote robot who have Parent as “world” will be attached to the parent defined in Frame, and with the given offset as well.

name: str

address: str

managed_by: str

insecure: bool

secret: str: Secret is a helper for a robot location secret.

prefix: str: A string with which to prefix all resource names fetched from this remote.

frame() → Global___Frame

auth() → Global___RemoteAuth

connection_check_interval() → google.protobuf.duration_pb2.Duration

reconnect_interval() → google.protobuf.duration_pb2.Duration

service_configs() → google.protobuf.internal.containers.RepeatedCompositeFieldContainer[Global___ResourceLevelServiceConfig]

HasField(field_name: _HasFieldArgType) → 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.

type viam.gen.app.v1.robot_pb2.Global___RemoteConfig = RemoteConfig

class viam.gen.app.v1.robot_pb2.RemoteAuth(*, credentials: Global___RemoteAuth | None = ..., entity: str = ...)

Bases: google.protobuf.message.Message

RemoteAuth specifies how to authenticate against a remote. If no credentials are specified, authentication does not happen. If an entity is specified, the authentication request will specify it.

class Credentials(*, type: Global___CredentialsType = ..., payload: str = ...)

Bases: google.protobuf.message.Message

Credentials packages up both a type of credential along with its payload which is formatted specific to the type.

type: Global___CredentialsType

payload: str

entity: str

credentials() → Global___RemoteAuth

HasField(field_name: _HasFieldArgType) → 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.

type viam.gen.app.v1.robot_pb2.Global___RemoteAuth = RemoteAuth

class viam.gen.app.v1.robot_pb2.AgentInfo(*, host: str = ..., os: str = ..., ips: collections.abc.Iterable[str] | None = ..., version: str = ..., git_revision: str = ..., platform: str | None = ..., platform_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.

host: str

os: str: Will soon be deprecated, use platform instead

version: str: RDK version

git_revision: str

platform: str: The platform the RDK is running on. For example linux/amd64

ips() → google.protobuf.internal.containers.RepeatedScalarFieldContainer[str]: list of all ipv4 ips.

platform_tags() → google.protobuf.internal.containers.RepeatedScalarFieldContainer[str]: Optional tags to further constrain which artifact is returned for modules.

HasField(field_name: _HasFieldArgType) → 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.

WhichOneof(oneof_group: _WhichOneofArgType__platform) → _WhichOneofReturnType__platform | None

Returns the name of the field that is set inside a oneof group.

If no field is set, returns None.

Parameters:: oneof_group (str) – the name of the oneof group to check.
Returns:: The name of the group that is set, or None.
Return type:: str or None
Raises:: ValueError – no group with the given name exists

type viam.gen.app.v1.robot_pb2.Global___AgentInfo = AgentInfo

class viam.gen.app.v1.robot_pb2.ConfigRequest(*, id: str = ..., agent_info: Global___AgentInfo | 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.

id: str: Robot part id.

agent_info() → Global___AgentInfo: Details about the RDK (os, version) are updated during this request.

HasField(field_name: _HasFieldArgType) → 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.

WhichOneof(oneof_group: _WhichOneofArgType__agent_info) → _WhichOneofReturnType__agent_info | None

Returns the name of the field that is set inside a oneof group.

If no field is set, returns None.

Parameters:: oneof_group (str) – the name of the oneof group to check.
Returns:: The name of the group that is set, or None.
Return type:: str or None
Raises:: ValueError – no group with the given name exists

type viam.gen.app.v1.robot_pb2.Global___ConfigRequest = ConfigRequest

class viam.gen.app.v1.robot_pb2.ConfigResponse(*, config: Global___RobotConfig | 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.

config() → Global___RobotConfig

HasField(field_name: _HasFieldArgType) → 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.

type viam.gen.app.v1.robot_pb2.Global___ConfigResponse = ConfigResponse

class viam.gen.app.v1.robot_pb2.CertificateRequest(*, id: 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.

id: str: Robot part id.

type viam.gen.app.v1.robot_pb2.Global___CertificateRequest = CertificateRequest

class viam.gen.app.v1.robot_pb2.CertificateResponse(*, id: str = ..., tls_certificate: str = ..., tls_private_key: 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.

id: str: Robot part id.

tls_certificate: str

tls_private_key: str

type viam.gen.app.v1.robot_pb2.Global___CertificateResponse = CertificateResponse

class viam.gen.app.v1.robot_pb2.LogRequest(*, id: str = ..., logs: collections.abc.Iterable[common.v1.common_pb2.LogEntry] | 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.

id: str: Robot part id.

logs() → google.protobuf.internal.containers.RepeatedCompositeFieldContainer[common.v1.common_pb2.LogEntry]

type viam.gen.app.v1.robot_pb2.Global___LogRequest = LogRequest

class viam.gen.app.v1.robot_pb2.LogResponse

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.

type viam.gen.app.v1.robot_pb2.Global___LogResponse = LogResponse

class viam.gen.app.v1.robot_pb2.NeedsRestartRequest(*, id: 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.

id: str: Robot part id.

type viam.gen.app.v1.robot_pb2.Global___NeedsRestartRequest = NeedsRestartRequest

class viam.gen.app.v1.robot_pb2.NeedsRestartResponse(*, id: str = ..., must_restart: bool = ..., restart_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.

id: str: Robot part id.

must_restart: bool

restart_check_interval() → google.protobuf.duration_pb2.Duration

HasField(field_name: _HasFieldArgType) → 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.

type viam.gen.app.v1.robot_pb2.Global___NeedsRestartResponse = NeedsRestartResponse

class viam.gen.app.v1.robot_pb2.ModuleConfig(*, name: str = ..., path: str = ..., log_level: str = ..., type: str = ..., module_id: str = ..., env: collections.abc.Mapping[str, str] | None = ..., status: Global___AppValidationStatus | None = ..., first_run_timeout: google.protobuf.duration_pb2.Duration | None = ..., tcp_mode: bool = ...)

Bases: google.protobuf.message.Message

ModuleConfig is the configuration for a module.

class EnvEntry(*, 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

name: str

path: str: path to the executable

log_level: str: log level for module

type: str: type of the module (“local” or “registry”)

module_id: str: the id of the module if it is a registry module

tcp_mode: bool: whether we are starting a module in TCP mode

env() → google.protobuf.internal.containers.ScalarMap[str, str]: additional environment variables passed to the module process

status() → Global___AppValidationStatus: info about the validity of the module

first_run_timeout() → google.protobuf.duration_pb2.Duration: timeout for first_run script

HasField(field_name: _HasFieldArgType) → 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.

type viam.gen.app.v1.robot_pb2.Global___ModuleConfig = ModuleConfig

class viam.gen.app.v1.robot_pb2.PackageConfig(*, name: str = ..., package: str = ..., version: str = ..., type: str = ..., status: Global___AppValidationStatus | None = ...)

Bases: google.protobuf.message.Message

PackageConfig is the configration for deployed Packages.

name: str: Name is the local name of the package on the RDK. Must be unique across Packages. Must not be empty.

package: str: Package is the unique package name hosted by Viam. Must not be empty.

version: str: version of the package ID hosted by Viam. If not specified “latest” is assumed.

type: str: type of the package

status() → Global___AppValidationStatus: info about the validity of the package

HasField(field_name: _HasFieldArgType) → 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.

type viam.gen.app.v1.robot_pb2.Global___PackageConfig = PackageConfig

class viam.gen.app.v1.robot_pb2.MaintenanceConfig(*, sensor_name: common.v1.common_pb2.ResourceName | None = ..., maintenance_allowed_key: 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.

maintenance_allowed_key: str

sensor_name() → common.v1.common_pb2.ResourceName

HasField(field_name: _HasFieldArgType) → 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.

type viam.gen.app.v1.robot_pb2.Global___MaintenanceConfig = MaintenanceConfig