// Copyright (c) 2022 Boston Dynamics, Inc.  All rights reserved.
//
// Downloading, reproducing, distributing or otherwise using the SDK Software
// is subject to the terms and conditions of the Boston Dynamics Software
// Development Kit License (20191101-BDSDK-SL).

syntax = "proto3";

package bosdyn.api;

import "google/protobuf/any.proto";
import "google/protobuf/timestamp.proto";

option go_package = "bosdyn/api";
option java_outer_classname = "HeaderProto";

// Standard header attached to all GRPC requests to services.
message RequestHeader {
    // Time that the request was sent, as measured by the client's local system clock.
    google.protobuf.Timestamp request_timestamp = 1;

    // Name of the client to identify itself. The name will typically include a
    // symbolic string to identify the program, and a unique integer to identify
    // the specific instance of the process running.
    string client_name = 2;

    // If Set to true, request that request and response messages for this call are not recorded
    // in the GRPC log.
    bool disable_rpc_logging = 3;
}

// General error code are returned in the header to facilitate error-handling which is not
// message-specific.
// This can be used for generic error handlers, aggregation, and trend analysis.
message CommonError {
    enum Code {
        // Code is not specified.
        CODE_UNSPECIFIED = 0;

        // Not an error.  Request was successful.
        CODE_OK = 1;

        // Service experienced an unexpected error state.
        CODE_INTERNAL_SERVER_ERROR = 2;

        // Ill-formed request.  Request arguments were not valid.
        CODE_INVALID_REQUEST = 3;
    }
    // The different error codes that can be returned on a grpc response message.
    Code code = 1;

    // Human-readable error description.  Not for programmatic analysis.
    string message = 2;

    // Extra information that can optionally be provided for generic error handling/analysis.
    google.protobuf.Any data = 3;
}

// Standard header attached to all GRPC responses from services.
message ResponseHeader {
    // Echo-back the RequestHeader for timing information, etc....
    RequestHeader request_header = 1;

    // Time that the request was received. The server clock is the time basis.
    google.protobuf.Timestamp request_received_timestamp = 2;

    // Time that the response was received. The server clock is the time basis.
    google.protobuf.Timestamp response_timestamp = 3;

    // Common errors, such as invalid input or internal server problems.
    // If there is a common error, the rest of the response message outside of the
    // ResponseHeader will be invalid.
    CommonError error = 4;

    // Echoed request message. In some cases it may not be present, or it may be a stripped
    // down representation of the request.
    google.protobuf.Any request = 5;
}