rime-api 0.0.2__tar.gz → 0.2.0__tar.gz

rime_api-0.2.0/NOTICE

@@ -0,0 +1,6 @@
+Rime API
+Copyright 2026 Rime.
+
+Distributions include Google RPC definitions from Google APIs under the Apache
+License 2.0, and Protobuf well-known type definitions under PROTOBUF_LICENSE.
+The source files retain their copyright notices.

{rime_api-0.0.2 → rime_api-0.2.0}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: rime-api
-Version: 0.0.2
-Summary: Generated protocol definitions for Rime text-to-speech
+Version: 0.2.0
+Summary: Generated protocol definitions for Rime text-to-speech and speech-to-text
 Project-URL: Documentation, https://docs.rime.ai
 Project-URL: Repository, https://github.com/rimelabs/rime-api
 Project-URL: Issues, https://github.com/rimelabs/rime-api/issues
@@ -9,13 +9,15 @@ Author: Rime
 License-Expression: Apache-2.0
 License-File: LICENSE
 License-File: NOTICE
+License-File: PROTOBUF_LICENSE
 Requires-Python: >=3.10
+Requires-Dist: googleapis-common-protos>=1.70.0
 Requires-Dist: protobuf>=5.29.6
 Description-Content-Type: text/markdown
 
 # Rime API
 
-Generated message definitions for Rime text-to-speech. Python and JavaScript
+Generated message definitions for Rime text-to-speech and speech-to-text. Python and JavaScript
 packages use the same schema and release version.
 
 ## Python
@@ -31,8 +33,9 @@ request = proto.WebSocketRequest(context_id='turn-42', text='Hello.')
 encoded = request.SerializeToString()
 ```
 
-Python 3.10 or newer is required. The package includes type stubs. Its only
-runtime dependency is `protobuf>=5.29.6`. It does not require gRPC.
+Python 3.10 or newer is required. The package includes type stubs. Runtime
+dependencies are `protobuf>=5.29.6` and `googleapis-common-protos>=1.70.0`.
+It does not require gRPC.
 
 ## JavaScript and TypeScript
 
@@ -57,21 +60,63 @@ Consumers that import `@bufbuild/protobuf` directly should declare it as a
 direct dependency too. Use its `fromJson` and `toJson` functions for the Rime
 JSON protocol. `JSON.stringify` does not implement the protobuf JSON mapping.
 
+## Speech-to-text
+
+Python uses a separate module for STT:
+
+```python
+from rime_api import speech_to_text_pb2 as proto
+
+request = proto.SpeechWebSocketRequest(
+    start=proto.StreamingConfig(
+        output_contract=proto.STREAMING_OUTPUT_CONTRACT_REVISED_HYPOTHESES,
+        language="en",
+    )
+)
+encoded = request.SerializeToString()
+```
+
+JavaScript and TypeScript export STT definitions from the same package:
+
+```typescript
+import { create, toBinary } from "@bufbuild/protobuf";
+import {
+  SpeechWebSocketRequestSchema,
+  StreamingOutputContract,
+} from "@rimelabs/api";
+
+const request = create(SpeechWebSocketRequestSchema, {
+  payload: {
+    case: "start",
+    value: {
+      outputContract: StreamingOutputContract.REVISED_HYPOTHESES,
+      language: "en",
+    },
+  },
+});
+const encoded = toBinary(SpeechWebSocketRequestSchema, request);
+```
+
+The STT schema includes whole-utterance transcription, bidirectional streaming,
+and WebSocket messages. See `schema/rime/speech_to_text.proto` and
+`schema/speech_to_text.asyncapi.yaml` in the package for the full contract.
+
 ## Scope and compatibility
 
-These packages contain the full public TTS schema, including synthesis,
-normalization, language and speaker queries, and WebSocket envelopes.
+These packages contain the full public TTS and STT schemas, including synthesis,
+normalization, language and speaker queries, transcription, and WebSocket envelopes.
 Framework adapters own connections, authentication, cancellation, and audio I/O.
 Service descriptors are included; gRPC client stubs are not included.
 
 The protobuf package remains `rime`. The Python generator uses a virtual source
-path, `rime_api/text_to_speech.proto`, to obtain the Python import name.
-This changes the Python descriptor's file name, but preserves message names,
+paths, `rime_api/text_to_speech.proto` and `rime_api/speech_to_text.proto`,
+to obtain the Python import names. This changes the Python descriptor file names, but preserves message names,
 service names, field numbers, and both wire formats. Do not load independently
 generated definitions of these same `rime` messages in one Python process.
 
 The Python wheel, source archive, and npm archive include the exact Protobuf
-and AsyncAPI definitions and their SHA-256 hashes in `SOURCE.json`. In the
+and AsyncAPI definitions. The `schemas` map in `SOURCE.json` records each
+public definition's path and SHA-256 hash. In the
 wheel, the definitions are under `rime_api/schema/`. The other archives use
 `schema/`. Generated code is part of the distribution;
 installation requires no protobuf compiler or access to the Rime repository.

rime_api-0.2.0/PROTOBUF_LICENSE

@@ -0,0 +1,32 @@
+Copyright 2008 Google Inc.  All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are
+met:
+
+    * Redistributions of source code must retain the above copyright
+notice, this list of conditions and the following disclaimer.
+    * Redistributions in binary form must reproduce the above
+copyright notice, this list of conditions and the following disclaimer
+in the documentation and/or other materials provided with the
+distribution.
+    * Neither the name of Google Inc. nor the names of its
+contributors may be used to endorse or promote products derived from
+this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+Code generated by the Protocol Buffer compiler is owned by the owner
+of the input file used when generating it.  This code is not
+standalone and requires a support library to be linked with it.  This
+support library is itself covered by the above license.

{rime_api-0.0.2 → rime_api-0.2.0}/README.md

@@ -1,6 +1,6 @@
 # Rime API
 
-Generated message definitions for Rime text-to-speech. Python and JavaScript
+Generated message definitions for Rime text-to-speech and speech-to-text. Python and JavaScript
 packages use the same schema and release version.
 
 ## Python
@@ -16,8 +16,9 @@ request = proto.WebSocketRequest(context_id='turn-42', text='Hello.')
 encoded = request.SerializeToString()
 ```
 
-Python 3.10 or newer is required. The package includes type stubs. Its only
-runtime dependency is `protobuf>=5.29.6`. It does not require gRPC.
+Python 3.10 or newer is required. The package includes type stubs. Runtime
+dependencies are `protobuf>=5.29.6` and `googleapis-common-protos>=1.70.0`.
+It does not require gRPC.
 
 ## JavaScript and TypeScript
 
@@ -42,21 +43,63 @@ Consumers that import `@bufbuild/protobuf` directly should declare it as a
 direct dependency too. Use its `fromJson` and `toJson` functions for the Rime
 JSON protocol. `JSON.stringify` does not implement the protobuf JSON mapping.
 
+## Speech-to-text
+
+Python uses a separate module for STT:
+
+```python
+from rime_api import speech_to_text_pb2 as proto
+
+request = proto.SpeechWebSocketRequest(
+    start=proto.StreamingConfig(
+        output_contract=proto.STREAMING_OUTPUT_CONTRACT_REVISED_HYPOTHESES,
+        language="en",
+    )
+)
+encoded = request.SerializeToString()
+```
+
+JavaScript and TypeScript export STT definitions from the same package:
+
+```typescript
+import { create, toBinary } from "@bufbuild/protobuf";
+import {
+  SpeechWebSocketRequestSchema,
+  StreamingOutputContract,
+} from "@rimelabs/api";
+
+const request = create(SpeechWebSocketRequestSchema, {
+  payload: {
+    case: "start",
+    value: {
+      outputContract: StreamingOutputContract.REVISED_HYPOTHESES,
+      language: "en",
+    },
+  },
+});
+const encoded = toBinary(SpeechWebSocketRequestSchema, request);
+```
+
+The STT schema includes whole-utterance transcription, bidirectional streaming,
+and WebSocket messages. See `schema/rime/speech_to_text.proto` and
+`schema/speech_to_text.asyncapi.yaml` in the package for the full contract.
+
 ## Scope and compatibility
 
-These packages contain the full public TTS schema, including synthesis,
-normalization, language and speaker queries, and WebSocket envelopes.
+These packages contain the full public TTS and STT schemas, including synthesis,
+normalization, language and speaker queries, transcription, and WebSocket envelopes.
 Framework adapters own connections, authentication, cancellation, and audio I/O.
 Service descriptors are included; gRPC client stubs are not included.
 
 The protobuf package remains `rime`. The Python generator uses a virtual source
-path, `rime_api/text_to_speech.proto`, to obtain the Python import name.
-This changes the Python descriptor's file name, but preserves message names,
+paths, `rime_api/text_to_speech.proto` and `rime_api/speech_to_text.proto`,
+to obtain the Python import names. This changes the Python descriptor file names, but preserves message names,
 service names, field numbers, and both wire formats. Do not load independently
 generated definitions of these same `rime` messages in one Python process.
 
 The Python wheel, source archive, and npm archive include the exact Protobuf
-and AsyncAPI definitions and their SHA-256 hashes in `SOURCE.json`. In the
+and AsyncAPI definitions. The `schemas` map in `SOURCE.json` records each
+public definition's path and SHA-256 hash. In the
 wheel, the definitions are under `rime_api/schema/`. The other archives use
 `schema/`. Generated code is part of the distribution;
 installation requires no protobuf compiler or access to the Rime repository.

rime_api-0.2.0/SOURCE.json

@@ -0,0 +1,9 @@
+{
+  "version": "0.2.0",
+  "schemas": {
+    "rime/speech_to_text.proto": "77131e17e7048cd989d547ff81c991151c23b896272b6bff903bd548eb8eb5b3",
+    "rime/text_to_speech.proto": "6a5707f207c95fcb32557f4b811e30fb67c01df8fc4dc60ec823e592cc477e5e",
+    "speech_to_text.asyncapi.yaml": "604cb549319ff1bc7cc792d4a6df15dd8d9d75123397d57a3f31e8e5d93b71b6",
+    "text_to_speech.asyncapi.yaml": "00e1223faf9858c278046bf774cf9f328606cfc336b02c71fdbf52c82a85ee35"
+  }
+}

{rime_api-0.0.2 → rime_api-0.2.0}/pyproject.toml

@@ -4,14 +4,14 @@ build-backend = "hatchling.build"
 
 [project]
 name = "rime-api"
-version = "0.0.2"
-description = "Generated protocol definitions for Rime text-to-speech"
+version = "0.2.0"
+description = "Generated protocol definitions for Rime text-to-speech and speech-to-text"
 readme = "README.md"
 requires-python = ">=3.10"
 license = "Apache-2.0"
-license-files = ["LICENSE", "NOTICE"]
+license-files = ["LICENSE", "NOTICE", "PROTOBUF_LICENSE"]
 authors = [{ name = "Rime" }]
-dependencies = ["protobuf>=5.29.6"]
+dependencies = ["protobuf>=5.29.6", "googleapis-common-protos>=1.70.0"]
 
 [project.urls]
 Documentation = "https://docs.rime.ai"
@@ -26,4 +26,4 @@ packages = ["src/rime_api"]
 "schema" = "rime_api/schema"
 
 [tool.hatch.build.targets.sdist]
-include = ["src", "schema", "SOURCE.json", "pyproject.toml", "README.md", "LICENSE", "NOTICE"]
+include = ["src", "schema", "SOURCE.json", "pyproject.toml", "README.md", "LICENSE", "NOTICE", "PROTOBUF_LICENSE"]

rime_api-0.2.0/schema/google/protobuf/any.proto

@@ -0,0 +1,106 @@
+// Protocol Buffers - Google's data interchange format
+// Copyright 2008 Google Inc.  All rights reserved.
+// https://developers.google.com/protocol-buffers/
+//
+// Redistribution and use in source and binary forms, with or without
+// modification, are permitted provided that the following conditions are
+// met:
+//
+//     * Redistributions of source code must retain the above copyright
+// notice, this list of conditions and the following disclaimer.
+//     * Redistributions in binary form must reproduce the above
+// copyright notice, this list of conditions and the following disclaimer
+// in the documentation and/or other materials provided with the
+// distribution.
+//     * Neither the name of Google Inc. nor the names of its
+// contributors may be used to endorse or promote products derived from
+// this software without specific prior written permission.
+//
+// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+// "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+// LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+// A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+// OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+// SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+// LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+// DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+// (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+syntax = "proto3";
+
+package google.protobuf;
+
+option go_package = "google.golang.org/protobuf/types/known/anypb";
+option java_package = "com.google.protobuf";
+option java_outer_classname = "AnyProto";
+option java_multiple_files = true;
+option objc_class_prefix = "GPB";
+option csharp_namespace = "Google.Protobuf.WellKnownTypes";
+
+// `Any` contains an arbitrary serialized protocol buffer message along with a
+// URL that describes the type of the serialized message.
+//
+// In its binary encoding, an `Any` is an ordinary message; but in other wire
+// forms like JSON, it has a special encoding. The format of the type URL is
+// described on the `type_url` field.
+//
+// Protobuf APIs provide utilities to interact with `Any` values:
+//
+// - A 'pack' operation accepts a message and constructs a generic `Any` wrapper
+//   around it.
+// - An 'unpack' operation reads the content of an `Any` message, either into an
+//   existing message or a new one. Unpack operations must check the type of the
+//   value they unpack against the declared `type_url`.
+// - An 'is' operation decides whether an `Any` contains a message of the given
+//   type, i.e. whether it can 'unpack' that type.
+//
+// The JSON format representation of an `Any` follows one of these cases:
+//
+// - For types without special-cased JSON encodings, the JSON format
+//   representation of the `Any` is the same as that of the message, with an
+//   additional `@type` field which contains the type URL.
+// - For types with special-cased JSON encodings (typically called 'well-known'
+//   types, listed in https://protobuf.dev/programming-guides/json/#any), the
+//   JSON format representation has a key `@type` which contains the type URL
+//   and a key `value` which contains the JSON-serialized value.
+//
+// The text format representation of an `Any` is like a message with one field
+// whose name is the type URL in brackets. For example, an `Any` containing a
+// `foo.Bar` message may be written `[type.googleapis.com/foo.Bar] { a: 2 }`.
+message Any {
+  // Identifies the type of the serialized Protobuf message with a URI reference
+  // consisting of a prefix ending in a slash and the fully-qualified type name.
+  //
+  // Example: type.googleapis.com/google.protobuf.StringValue
+  //
+  // This string must contain at least one `/` character, and the content after
+  // the last `/` must be the fully-qualified name of the type in canonical
+  // form, without a leading dot. Do not write a scheme on these URI references
+  // so that clients do not attempt to contact them.
+  //
+  // The prefix is arbitrary and Protobuf implementations are expected to
+  // simply strip off everything up to and including the last `/` to identify
+  // the type. `type.googleapis.com/` is a common default prefix that some
+  // legacy implementations require. This prefix does not indicate the origin of
+  // the type, and URIs containing it are not expected to respond to any
+  // requests.
+  //
+  // All type URL strings must be legal URI references with the additional
+  // restriction (for the text format) that the content of the reference
+  // must consist only of alphanumeric characters, percent-encoded escapes, and
+  // characters in the following set (not including the outer backticks):
+  // `/-.~_!$&()*+,;=`. Despite our allowing percent encodings, implementations
+  // should not unescape them to prevent confusion with existing parsers. For
+  // example, `type.googleapis.com%2FFoo` should be rejected.
+  //
+  // In the original design of `Any`, the possibility of launching a type
+  // resolution service at these type URLs was considered but Protobuf never
+  // implemented one and considers contacting these URLs to be problematic and
+  // a potential security issue. Do not attempt to contact type URLs.
+  string type_url = 1;
+
+  // Holds a Protobuf serialization of the type described by type_url.
+  bytes value = 2;
+}

rime_api-0.2.0/schema/google/protobuf/duration.proto

@@ -0,0 +1,115 @@
+// Protocol Buffers - Google's data interchange format
+// Copyright 2008 Google Inc.  All rights reserved.
+// https://developers.google.com/protocol-buffers/
+//
+// Redistribution and use in source and binary forms, with or without
+// modification, are permitted provided that the following conditions are
+// met:
+//
+//     * Redistributions of source code must retain the above copyright
+// notice, this list of conditions and the following disclaimer.
+//     * Redistributions in binary form must reproduce the above
+// copyright notice, this list of conditions and the following disclaimer
+// in the documentation and/or other materials provided with the
+// distribution.
+//     * Neither the name of Google Inc. nor the names of its
+// contributors may be used to endorse or promote products derived from
+// this software without specific prior written permission.
+//
+// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+// "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+// LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+// A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+// OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+// SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+// LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+// DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+// (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+syntax = "proto3";
+
+package google.protobuf;
+
+option cc_enable_arenas = true;
+option go_package = "google.golang.org/protobuf/types/known/durationpb";
+option java_package = "com.google.protobuf";
+option java_outer_classname = "DurationProto";
+option java_multiple_files = true;
+option objc_class_prefix = "GPB";
+option csharp_namespace = "Google.Protobuf.WellKnownTypes";
+
+// A Duration represents a signed, fixed-length span of time represented
+// as a count of seconds and fractions of seconds at nanosecond
+// resolution. It is independent of any calendar and concepts like "day"
+// or "month". It is related to Timestamp in that the difference between
+// two Timestamp values is a Duration and it can be added or subtracted
+// from a Timestamp. Range is approximately +-10,000 years.
+//
+// # Examples
+//
+// Example 1: Compute Duration from two Timestamps in pseudo code.
+//
+//     Timestamp start = ...;
+//     Timestamp end = ...;
+//     Duration duration = ...;
+//
+//     duration.seconds = end.seconds - start.seconds;
+//     duration.nanos = end.nanos - start.nanos;
+//
+//     if (duration.seconds < 0 && duration.nanos > 0) {
+//       duration.seconds += 1;
+//       duration.nanos -= 1000000000;
+//     } else if (duration.seconds > 0 && duration.nanos < 0) {
+//       duration.seconds -= 1;
+//       duration.nanos += 1000000000;
+//     }
+//
+// Example 2: Compute Timestamp from Timestamp + Duration in pseudo code.
+//
+//     Timestamp start = ...;
+//     Duration duration = ...;
+//     Timestamp end = ...;
+//
+//     end.seconds = start.seconds + duration.seconds;
+//     end.nanos = start.nanos + duration.nanos;
+//
+//     if (end.nanos < 0) {
+//       end.seconds -= 1;
+//       end.nanos += 1000000000;
+//     } else if (end.nanos >= 1000000000) {
+//       end.seconds += 1;
+//       end.nanos -= 1000000000;
+//     }
+//
+// Example 3: Compute Duration from datetime.timedelta in Python.
+//
+//     td = datetime.timedelta(days=3, minutes=10)
+//     duration = Duration()
+//     duration.FromTimedelta(td)
+//
+// # JSON Mapping
+//
+// In JSON format, the Duration type is encoded as a string rather than an
+// object, where the string ends in the suffix "s" (indicating seconds) and
+// is preceded by the number of seconds, with nanoseconds expressed as
+// fractional seconds. For example, 3 seconds with 0 nanoseconds should be
+// encoded in JSON format as "3s", while 3 seconds and 1 nanosecond should
+// be expressed in JSON format as "3.000000001s", and 3 seconds and 1
+// microsecond should be expressed in JSON format as "3.000001s".
+//
+message Duration {
+  // Signed seconds of the span of time. Must be from -315,576,000,000
+  // to +315,576,000,000 inclusive. Note: these bounds are computed from:
+  // 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
+  int64 seconds = 1;
+
+  // Signed fractions of a second at nanosecond resolution of the span
+  // of time. Durations less than one second are represented with a 0
+  // `seconds` field and a positive or negative `nanos` field. For durations
+  // of one second or more, a non-zero value for the `nanos` field must be
+  // of the same sign as the `seconds` field. Must be from -999,999,999
+  // to +999,999,999 inclusive.
+  int32 nanos = 2;
+}

rime_api-0.2.0/schema/google/rpc/status.proto

@@ -0,0 +1,49 @@
+// Copyright 2025 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.rpc;
+
+import "google/protobuf/any.proto";
+
+option cc_enable_arenas = true;
+option go_package = "google.golang.org/genproto/googleapis/rpc/status;status";
+option java_multiple_files = true;
+option java_outer_classname = "StatusProto";
+option java_package = "com.google.rpc";
+option objc_class_prefix = "RPC";
+
+// The `Status` type defines a logical error model that is suitable for
+// different programming environments, including REST APIs and RPC APIs. It is
+// used by [gRPC](https://github.com/grpc). Each `Status` message contains
+// three pieces of data: error code, error message, and error details.
+//
+// You can find out more about this error model and how to work with it in the
+// [API Design Guide](https://cloud.google.com/apis/design/errors).
+message Status {
+  // The status code, which should be an enum value of
+  // [google.rpc.Code][google.rpc.Code].
+  int32 code = 1;
+
+  // A developer-facing error message, which should be in English. Any
+  // user-facing error message should be localized and sent in the
+  // [google.rpc.Status.details][google.rpc.Status.details] field, or localized
+  // by the client.
+  string message = 2;
+
+  // A list of messages that carry the error details.  There is a common set of
+  // message types for APIs to use.
+  repeated google.protobuf.Any details = 3;
+}