starpc 0.0.1 → 0.1.2

package/srpc/packet.ts

@@ -0,0 +1,105 @@
+import type { Source, Transform } from 'it-stream-types'
+import { Packet } from './rpcproto'
+import {
+  encode as lengthPrefixEncode,
+  decode as lengthPrefixDecode,
+} from 'it-length-prefixed'
+
+// decodePacketSource unmarshals and async yields encoded Packets.
+export async function* decodePacketSource(
+  source: Source<Uint8Array | Uint8Array[]>
+): AsyncIterable<Packet> {
+  for await (const pkt of source) {
+    if (Array.isArray(pkt)) {
+      for (const p of pkt) {
+        yield* [Packet.decode(p)]
+      }
+    } else {
+      yield* [Packet.decode(pkt)]
+    }
+  }
+}
+
+// encodePacketSource marshals and async yields packets.
+export async function* encodePacketSource(
+  source: Source<Packet | Packet[]>
+): AsyncIterable<Uint8Array> {
+  for await (const pkt of source) {
+    if (Array.isArray(pkt)) {
+      for (const p of pkt) {
+        yield* [Packet.encode(p).finish()]
+      }
+    } else {
+      yield* [Packet.encode(pkt).finish()]
+    }
+  }
+}
+
+// uint32LEDecode removes the length prefix.
+const uint32LEDecode = (data: Uint8Array) => {
+  if (data.length < 4) {
+    throw RangeError('Could not decode int32BE')
+  }
+
+  const view = new DataView(data.buffer, data.byteOffset, data.byteLength)
+  return view.getUint32(0, true)
+}
+uint32LEDecode.bytes = 4
+
+// uint32LEEncode adds the length prefix.
+const uint32LEEncode = (value: number, target?: Uint8Array, offset?: number) => {
+  target = target ?? new Uint8Array(4)
+  const view = new DataView(target.buffer, target.byteOffset, target.byteLength)
+  view.setUint32(offset ?? 0, value, true)
+  return target
+}
+uint32LEEncode.bytes = 4
+
+// prependLengthPrefixTransform adds a length prefix to a message source.
+// little-endian uint32
+export function prependLengthPrefixTransform(): Transform<Uint8Array> {
+  return lengthPrefixEncode({lengthEncoder: uint32LEEncode})
+}
+
+// parseLengthPrefixTransform parses the length prefix from a message source.
+// little-endian uint32
+export function parseLengthPrefixTransform(): Transform<Uint8Array> {
+  return lengthPrefixDecode({ lengthDecoder: uint32LEDecode })
+}
+
+// encodeUint32Le encodes the number as a uint32 with little endian.
+export function encodeUint32Le(value: number): Uint8Array {
+  // output is a 4 byte array
+  const output = new Uint8Array(4)
+  for (let index = 0; index < output.length; index++) {
+    const b = value & 0xff
+    output[index] = b
+    value = (value - b) / 256
+  }
+  return output
+}
+
+// decodeUint32Le decodes a uint32 from a 4 byte Uint8Array.
+// returns 0 if decoding failed.
+// callers should check that len(data) == 4
+export function decodeUint32Le(data: Uint8Array): number {
+  let value = 0
+  let nbytes = 4
+  if (data.length < nbytes) {
+    nbytes = data.length
+  }
+  for (let i = nbytes - 1; i >= 0; i--) {
+    value = value * 256 + data[i]
+  }
+  return value
+}
+
+// prependPacketLen adds the message length prefix to a packet.
+export function prependPacketLen(msgData: Uint8Array): Uint8Array {
+  const msgLen = msgData.length
+  const msgLenData = encodeUint32Le(msgLen)
+  const merged = new Uint8Array(msgLen + msgLenData.length)
+  merged.set(msgLenData)
+  merged.set(msgData, msgLenData.length)
+  return merged
+}

package/srpc/rpc-stream.go

@@ -0,0 +1,76 @@
+package srpc
+
+import (
+	"context"
+	"io"
+)
+
+// RPCStream implements the stream interface passed to implementations.
+type RPCStream struct {
+	// ctx is the stream context
+	ctx context.Context
+	// writer is the stream writer
+	writer Writer
+	// dataCh is the incoming data channel.
+	dataCh chan []byte
+}
+
+// NewRPCStream constructs a new Stream with a ClientRPC.
+// dataCh should be closed when no more messages will arrive.
+func NewRPCStream(ctx context.Context, writer Writer, dataCh chan []byte) *RPCStream {
+	return &RPCStream{
+		ctx:    ctx,
+		writer: writer,
+		dataCh: dataCh,
+	}
+}
+
+// Context is canceled when the Stream is no longer valid.
+func (r *RPCStream) Context() context.Context {
+	return r.ctx
+}
+
+// MsgSend sends the message to the remote.
+func (r *RPCStream) MsgSend(msg Message) error {
+	select {
+	case <-r.ctx.Done():
+		return context.Canceled
+	default:
+	}
+
+	msgData, err := msg.MarshalVT()
+	if err != nil {
+		return err
+	}
+	outPkt := NewCallDataPacket(msgData, false, nil)
+	return r.writer.WritePacket(outPkt)
+}
+
+// MsgRecv receives an incoming message from the remote.
+// Parses the message into the object at msg.
+func (r *RPCStream) MsgRecv(msg Message) error {
+	select {
+	case <-r.Context().Done():
+		return context.Canceled
+	case data, ok := <-r.dataCh:
+		if !ok {
+			return io.EOF
+		}
+		return msg.UnmarshalVT(data)
+	}
+}
+
+// CloseSend signals to the remote that we will no longer send any messages.
+func (r *RPCStream) CloseSend() error {
+	outPkt := NewCallDataPacket(nil, true, nil)
+	return r.writer.WritePacket(outPkt)
+}
+
+// Close closes the stream.
+func (r *RPCStream) Close() error {
+	_ = r.writer.Close()
+	return nil
+}
+
+// _ is a type assertion
+var _ Stream = ((*RPCStream)(nil))

package/srpc/rpcproto.pb.go

@@ -0,0 +1,455 @@
+// Code generated by protoc-gen-go. DO NOT EDIT.
+// versions:
+// 	protoc-gen-go v1.27.1-devel
+// 	protoc        v3.19.3
+// source: github.com/aperturerobotics/starpc/srpc/rpcproto.proto
+
+package srpc
+
+import (
+	reflect "reflect"
+	sync "sync"
+
+	protoreflect "google.golang.org/protobuf/reflect/protoreflect"
+	protoimpl "google.golang.org/protobuf/runtime/protoimpl"
+)
+
+const (
+	// Verify that this generated code is sufficiently up-to-date.
+	_ = protoimpl.EnforceVersion(20 - protoimpl.MinVersion)
+	// Verify that runtime/protoimpl is sufficiently up-to-date.
+	_ = protoimpl.EnforceVersion(protoimpl.MaxVersion - 20)
+)
+
+// Packet is a message sent over a srpc packet connection.
+type Packet struct {
+	state         protoimpl.MessageState
+	sizeCache     protoimpl.SizeCache
+	unknownFields protoimpl.UnknownFields
+
+	// Body is the packet body.
+	//
+	// Types that are assignable to Body:
+	//	*Packet_CallStart
+	//	*Packet_CallStartResp
+	//	*Packet_CallData
+	Body isPacket_Body `protobuf_oneof:"body"`
+}
+
+func (x *Packet) Reset() {
+	*x = Packet{}
+	if protoimpl.UnsafeEnabled {
+		mi := &file_github_com_aperturerobotics_starpc_srpc_rpcproto_proto_msgTypes[0]
+		ms := protoimpl.X.MessageStateOf(protoimpl.Pointer(x))
+		ms.StoreMessageInfo(mi)
+	}
+}
+
+func (x *Packet) String() string {
+	return protoimpl.X.MessageStringOf(x)
+}
+
+func (*Packet) ProtoMessage() {}
+
+func (x *Packet) ProtoReflect() protoreflect.Message {
+	mi := &file_github_com_aperturerobotics_starpc_srpc_rpcproto_proto_msgTypes[0]
+	if protoimpl.UnsafeEnabled && x != nil {
+		ms := protoimpl.X.MessageStateOf(protoimpl.Pointer(x))
+		if ms.LoadMessageInfo() == nil {
+			ms.StoreMessageInfo(mi)
+		}
+		return ms
+	}
+	return mi.MessageOf(x)
+}
+
+// Deprecated: Use Packet.ProtoReflect.Descriptor instead.
+func (*Packet) Descriptor() ([]byte, []int) {
+	return file_github_com_aperturerobotics_starpc_srpc_rpcproto_proto_rawDescGZIP(), []int{0}
+}
+
+func (m *Packet) GetBody() isPacket_Body {
+	if m != nil {
+		return m.Body
+	}
+	return nil
+}
+
+func (x *Packet) GetCallStart() *CallStart {
+	if x, ok := x.GetBody().(*Packet_CallStart); ok {
+		return x.CallStart
+	}
+	return nil
+}
+
+func (x *Packet) GetCallStartResp() *CallStartResp {
+	if x, ok := x.GetBody().(*Packet_CallStartResp); ok {
+		return x.CallStartResp
+	}
+	return nil
+}
+
+func (x *Packet) GetCallData() *CallData {
+	if x, ok := x.GetBody().(*Packet_CallData); ok {
+		return x.CallData
+	}
+	return nil
+}
+
+type isPacket_Body interface {
+	isPacket_Body()
+}
+
+type Packet_CallStart struct {
+	// CallStart initiates a new call.
+	CallStart *CallStart `protobuf:"bytes,1,opt,name=call_start,json=callStart,proto3,oneof"`
+}
+
+type Packet_CallStartResp struct {
+	// CallStartResp is the response to CallStart.
+	CallStartResp *CallStartResp `protobuf:"bytes,2,opt,name=call_start_resp,json=callStartResp,proto3,oneof"`
+}
+
+type Packet_CallData struct {
+	// CallData is a message in a streaming RPC sequence.
+	CallData *CallData `protobuf:"bytes,3,opt,name=call_data,json=callData,proto3,oneof"`
+}
+
+func (*Packet_CallStart) isPacket_Body() {}
+
+func (*Packet_CallStartResp) isPacket_Body() {}
+
+func (*Packet_CallData) isPacket_Body() {}
+
+// CallStart requests starting a new RPC call.
+type CallStart struct {
+	state         protoimpl.MessageState
+	sizeCache     protoimpl.SizeCache
+	unknownFields protoimpl.UnknownFields
+
+	// RpcService is the service to contact.
+	// Must be set.
+	RpcService string `protobuf:"bytes,1,opt,name=rpc_service,json=rpcService,proto3" json:"rpc_service,omitempty"`
+	// RpcMethod is the RPC method to call.
+	// Must be set.
+	RpcMethod string `protobuf:"bytes,2,opt,name=rpc_method,json=rpcMethod,proto3" json:"rpc_method,omitempty"`
+	// Data contains the request or the first message in the stream.
+	// Optional if streaming.
+	Data []byte `protobuf:"bytes,3,opt,name=data,proto3" json:"data,omitempty"`
+}
+
+func (x *CallStart) Reset() {
+	*x = CallStart{}
+	if protoimpl.UnsafeEnabled {
+		mi := &file_github_com_aperturerobotics_starpc_srpc_rpcproto_proto_msgTypes[1]
+		ms := protoimpl.X.MessageStateOf(protoimpl.Pointer(x))
+		ms.StoreMessageInfo(mi)
+	}
+}
+
+func (x *CallStart) String() string {
+	return protoimpl.X.MessageStringOf(x)
+}
+
+func (*CallStart) ProtoMessage() {}
+
+func (x *CallStart) ProtoReflect() protoreflect.Message {
+	mi := &file_github_com_aperturerobotics_starpc_srpc_rpcproto_proto_msgTypes[1]
+	if protoimpl.UnsafeEnabled && x != nil {
+		ms := protoimpl.X.MessageStateOf(protoimpl.Pointer(x))
+		if ms.LoadMessageInfo() == nil {
+			ms.StoreMessageInfo(mi)
+		}
+		return ms
+	}
+	return mi.MessageOf(x)
+}
+
+// Deprecated: Use CallStart.ProtoReflect.Descriptor instead.
+func (*CallStart) Descriptor() ([]byte, []int) {
+	return file_github_com_aperturerobotics_starpc_srpc_rpcproto_proto_rawDescGZIP(), []int{1}
+}
+
+func (x *CallStart) GetRpcService() string {
+	if x != nil {
+		return x.RpcService
+	}
+	return ""
+}
+
+func (x *CallStart) GetRpcMethod() string {
+	if x != nil {
+		return x.RpcMethod
+	}
+	return ""
+}
+
+func (x *CallStart) GetData() []byte {
+	if x != nil {
+		return x.Data
+	}
+	return nil
+}
+
+// CallStartResp is the response to CallStart.
+type CallStartResp struct {
+	state         protoimpl.MessageState
+	sizeCache     protoimpl.SizeCache
+	unknownFields protoimpl.UnknownFields
+
+	// Error contains any error starting the RPC call.
+	// Empty if successful.
+	Error string `protobuf:"bytes,1,opt,name=error,proto3" json:"error,omitempty"`
+}
+
+func (x *CallStartResp) Reset() {
+	*x = CallStartResp{}
+	if protoimpl.UnsafeEnabled {
+		mi := &file_github_com_aperturerobotics_starpc_srpc_rpcproto_proto_msgTypes[2]
+		ms := protoimpl.X.MessageStateOf(protoimpl.Pointer(x))
+		ms.StoreMessageInfo(mi)
+	}
+}
+
+func (x *CallStartResp) String() string {
+	return protoimpl.X.MessageStringOf(x)
+}
+
+func (*CallStartResp) ProtoMessage() {}
+
+func (x *CallStartResp) ProtoReflect() protoreflect.Message {
+	mi := &file_github_com_aperturerobotics_starpc_srpc_rpcproto_proto_msgTypes[2]
+	if protoimpl.UnsafeEnabled && x != nil {
+		ms := protoimpl.X.MessageStateOf(protoimpl.Pointer(x))
+		if ms.LoadMessageInfo() == nil {
+			ms.StoreMessageInfo(mi)
+		}
+		return ms
+	}
+	return mi.MessageOf(x)
+}
+
+// Deprecated: Use CallStartResp.ProtoReflect.Descriptor instead.
+func (*CallStartResp) Descriptor() ([]byte, []int) {
+	return file_github_com_aperturerobotics_starpc_srpc_rpcproto_proto_rawDescGZIP(), []int{2}
+}
+
+func (x *CallStartResp) GetError() string {
+	if x != nil {
+		return x.Error
+	}
+	return ""
+}
+
+// CallData contains a message in a streaming RPC sequence.
+type CallData struct {
+	state         protoimpl.MessageState
+	sizeCache     protoimpl.SizeCache
+	unknownFields protoimpl.UnknownFields
+
+	// Data contains the packet in the sequence.
+	Data []byte `protobuf:"bytes,1,opt,name=data,proto3" json:"data,omitempty"`
+	// Complete indicates the RPC call is completed.
+	Complete bool `protobuf:"varint,2,opt,name=complete,proto3" json:"complete,omitempty"`
+	// Error contains any error that caused the RPC to fail.
+	// If set, implies complete=true.
+	Error string `protobuf:"bytes,3,opt,name=error,proto3" json:"error,omitempty"`
+}
+
+func (x *CallData) Reset() {
+	*x = CallData{}
+	if protoimpl.UnsafeEnabled {
+		mi := &file_github_com_aperturerobotics_starpc_srpc_rpcproto_proto_msgTypes[3]
+		ms := protoimpl.X.MessageStateOf(protoimpl.Pointer(x))
+		ms.StoreMessageInfo(mi)
+	}
+}
+
+func (x *CallData) String() string {
+	return protoimpl.X.MessageStringOf(x)
+}
+
+func (*CallData) ProtoMessage() {}
+
+func (x *CallData) ProtoReflect() protoreflect.Message {
+	mi := &file_github_com_aperturerobotics_starpc_srpc_rpcproto_proto_msgTypes[3]
+	if protoimpl.UnsafeEnabled && x != nil {
+		ms := protoimpl.X.MessageStateOf(protoimpl.Pointer(x))
+		if ms.LoadMessageInfo() == nil {
+			ms.StoreMessageInfo(mi)
+		}
+		return ms
+	}
+	return mi.MessageOf(x)
+}
+
+// Deprecated: Use CallData.ProtoReflect.Descriptor instead.
+func (*CallData) Descriptor() ([]byte, []int) {
+	return file_github_com_aperturerobotics_starpc_srpc_rpcproto_proto_rawDescGZIP(), []int{3}
+}
+
+func (x *CallData) GetData() []byte {
+	if x != nil {
+		return x.Data
+	}
+	return nil
+}
+
+func (x *CallData) GetComplete() bool {
+	if x != nil {
+		return x.Complete
+	}
+	return false
+}
+
+func (x *CallData) GetError() string {
+	if x != nil {
+		return x.Error
+	}
+	return ""
+}
+
+var File_github_com_aperturerobotics_starpc_srpc_rpcproto_proto protoreflect.FileDescriptor
+
+var file_github_com_aperturerobotics_starpc_srpc_rpcproto_proto_rawDesc = []byte{
+	0x0a, 0x36, 0x67, 0x69, 0x74, 0x68, 0x75, 0x62, 0x2e, 0x63, 0x6f, 0x6d, 0x2f, 0x61, 0x70, 0x65,
+	0x72, 0x74, 0x75, 0x72, 0x65, 0x72, 0x6f, 0x62, 0x6f, 0x74, 0x69, 0x63, 0x73, 0x2f, 0x73, 0x74,
+	0x61, 0x72, 0x70, 0x63, 0x2f, 0x73, 0x72, 0x70, 0x63, 0x2f, 0x72, 0x70, 0x63, 0x70, 0x72, 0x6f,
+	0x74, 0x6f, 0x2e, 0x70, 0x72, 0x6f, 0x74, 0x6f, 0x12, 0x04, 0x73, 0x72, 0x70, 0x63, 0x22, 0xb0,
+	0x01, 0x0a, 0x06, 0x50, 0x61, 0x63, 0x6b, 0x65, 0x74, 0x12, 0x30, 0x0a, 0x0a, 0x63, 0x61, 0x6c,
+	0x6c, 0x5f, 0x73, 0x74, 0x61, 0x72, 0x74, 0x18, 0x01, 0x20, 0x01, 0x28, 0x0b, 0x32, 0x0f, 0x2e,
+	0x73, 0x72, 0x70, 0x63, 0x2e, 0x43, 0x61, 0x6c, 0x6c, 0x53, 0x74, 0x61, 0x72, 0x74, 0x48, 0x00,
+	0x52, 0x09, 0x63, 0x61, 0x6c, 0x6c, 0x53, 0x74, 0x61, 0x72, 0x74, 0x12, 0x3d, 0x0a, 0x0f, 0x63,
+	0x61, 0x6c, 0x6c, 0x5f, 0x73, 0x74, 0x61, 0x72, 0x74, 0x5f, 0x72, 0x65, 0x73, 0x70, 0x18, 0x02,
+	0x20, 0x01, 0x28, 0x0b, 0x32, 0x13, 0x2e, 0x73, 0x72, 0x70, 0x63, 0x2e, 0x43, 0x61, 0x6c, 0x6c,
+	0x53, 0x74, 0x61, 0x72, 0x74, 0x52, 0x65, 0x73, 0x70, 0x48, 0x00, 0x52, 0x0d, 0x63, 0x61, 0x6c,
+	0x6c, 0x53, 0x74, 0x61, 0x72, 0x74, 0x52, 0x65, 0x73, 0x70, 0x12, 0x2d, 0x0a, 0x09, 0x63, 0x61,
+	0x6c, 0x6c, 0x5f, 0x64, 0x61, 0x74, 0x61, 0x18, 0x03, 0x20, 0x01, 0x28, 0x0b, 0x32, 0x0e, 0x2e,
+	0x73, 0x72, 0x70, 0x63, 0x2e, 0x43, 0x61, 0x6c, 0x6c, 0x44, 0x61, 0x74, 0x61, 0x48, 0x00, 0x52,
+	0x08, 0x63, 0x61, 0x6c, 0x6c, 0x44, 0x61, 0x74, 0x61, 0x42, 0x06, 0x0a, 0x04, 0x62, 0x6f, 0x64,
+	0x79, 0x22, 0x5f, 0x0a, 0x09, 0x43, 0x61, 0x6c, 0x6c, 0x53, 0x74, 0x61, 0x72, 0x74, 0x12, 0x1f,
+	0x0a, 0x0b, 0x72, 0x70, 0x63, 0x5f, 0x73, 0x65, 0x72, 0x76, 0x69, 0x63, 0x65, 0x18, 0x01, 0x20,
+	0x01, 0x28, 0x09, 0x52, 0x0a, 0x72, 0x70, 0x63, 0x53, 0x65, 0x72, 0x76, 0x69, 0x63, 0x65, 0x12,
+	0x1d, 0x0a, 0x0a, 0x72, 0x70, 0x63, 0x5f, 0x6d, 0x65, 0x74, 0x68, 0x6f, 0x64, 0x18, 0x02, 0x20,
+	0x01, 0x28, 0x09, 0x52, 0x09, 0x72, 0x70, 0x63, 0x4d, 0x65, 0x74, 0x68, 0x6f, 0x64, 0x12, 0x12,
+	0x0a, 0x04, 0x64, 0x61, 0x74, 0x61, 0x18, 0x03, 0x20, 0x01, 0x28, 0x0c, 0x52, 0x04, 0x64, 0x61,
+	0x74, 0x61, 0x22, 0x25, 0x0a, 0x0d, 0x43, 0x61, 0x6c, 0x6c, 0x53, 0x74, 0x61, 0x72, 0x74, 0x52,
+	0x65, 0x73, 0x70, 0x12, 0x14, 0x0a, 0x05, 0x65, 0x72, 0x72, 0x6f, 0x72, 0x18, 0x01, 0x20, 0x01,
+	0x28, 0x09, 0x52, 0x05, 0x65, 0x72, 0x72, 0x6f, 0x72, 0x22, 0x50, 0x0a, 0x08, 0x43, 0x61, 0x6c,
+	0x6c, 0x44, 0x61, 0x74, 0x61, 0x12, 0x12, 0x0a, 0x04, 0x64, 0x61, 0x74, 0x61, 0x18, 0x01, 0x20,
+	0x01, 0x28, 0x0c, 0x52, 0x04, 0x64, 0x61, 0x74, 0x61, 0x12, 0x1a, 0x0a, 0x08, 0x63, 0x6f, 0x6d,
+	0x70, 0x6c, 0x65, 0x74, 0x65, 0x18, 0x02, 0x20, 0x01, 0x28, 0x08, 0x52, 0x08, 0x63, 0x6f, 0x6d,
+	0x70, 0x6c, 0x65, 0x74, 0x65, 0x12, 0x14, 0x0a, 0x05, 0x65, 0x72, 0x72, 0x6f, 0x72, 0x18, 0x03,
+	0x20, 0x01, 0x28, 0x09, 0x52, 0x05, 0x65, 0x72, 0x72, 0x6f, 0x72, 0x62, 0x06, 0x70, 0x72, 0x6f,
+	0x74, 0x6f, 0x33,
+}
+
+var (
+	file_github_com_aperturerobotics_starpc_srpc_rpcproto_proto_rawDescOnce sync.Once
+	file_github_com_aperturerobotics_starpc_srpc_rpcproto_proto_rawDescData = file_github_com_aperturerobotics_starpc_srpc_rpcproto_proto_rawDesc
+)
+
+func file_github_com_aperturerobotics_starpc_srpc_rpcproto_proto_rawDescGZIP() []byte {
+	file_github_com_aperturerobotics_starpc_srpc_rpcproto_proto_rawDescOnce.Do(func() {
+		file_github_com_aperturerobotics_starpc_srpc_rpcproto_proto_rawDescData = protoimpl.X.CompressGZIP(file_github_com_aperturerobotics_starpc_srpc_rpcproto_proto_rawDescData)
+	})
+	return file_github_com_aperturerobotics_starpc_srpc_rpcproto_proto_rawDescData
+}
+
+var file_github_com_aperturerobotics_starpc_srpc_rpcproto_proto_msgTypes = make([]protoimpl.MessageInfo, 4)
+var file_github_com_aperturerobotics_starpc_srpc_rpcproto_proto_goTypes = []interface{}{
+	(*Packet)(nil),        // 0: srpc.Packet
+	(*CallStart)(nil),     // 1: srpc.CallStart
+	(*CallStartResp)(nil), // 2: srpc.CallStartResp
+	(*CallData)(nil),      // 3: srpc.CallData
+}
+var file_github_com_aperturerobotics_starpc_srpc_rpcproto_proto_depIdxs = []int32{
+	1, // 0: srpc.Packet.call_start:type_name -> srpc.CallStart
+	2, // 1: srpc.Packet.call_start_resp:type_name -> srpc.CallStartResp
+	3, // 2: srpc.Packet.call_data:type_name -> srpc.CallData
+	3, // [3:3] is the sub-list for method output_type
+	3, // [3:3] is the sub-list for method input_type
+	3, // [3:3] is the sub-list for extension type_name
+	3, // [3:3] is the sub-list for extension extendee
+	0, // [0:3] is the sub-list for field type_name
+}
+
+func init() { file_github_com_aperturerobotics_starpc_srpc_rpcproto_proto_init() }
+func file_github_com_aperturerobotics_starpc_srpc_rpcproto_proto_init() {
+	if File_github_com_aperturerobotics_starpc_srpc_rpcproto_proto != nil {
+		return
+	}
+	if !protoimpl.UnsafeEnabled {
+		file_github_com_aperturerobotics_starpc_srpc_rpcproto_proto_msgTypes[0].Exporter = func(v interface{}, i int) interface{} {
+			switch v := v.(*Packet); i {
+			case 0:
+				return &v.state
+			case 1:
+				return &v.sizeCache
+			case 2:
+				return &v.unknownFields
+			default:
+				return nil
+			}
+		}
+		file_github_com_aperturerobotics_starpc_srpc_rpcproto_proto_msgTypes[1].Exporter = func(v interface{}, i int) interface{} {
+			switch v := v.(*CallStart); i {
+			case 0:
+				return &v.state
+			case 1:
+				return &v.sizeCache
+			case 2:
+				return &v.unknownFields
+			default:
+				return nil
+			}
+		}
+		file_github_com_aperturerobotics_starpc_srpc_rpcproto_proto_msgTypes[2].Exporter = func(v interface{}, i int) interface{} {
+			switch v := v.(*CallStartResp); i {
+			case 0:
+				return &v.state
+			case 1:
+				return &v.sizeCache
+			case 2:
+				return &v.unknownFields
+			default:
+				return nil
+			}
+		}
+		file_github_com_aperturerobotics_starpc_srpc_rpcproto_proto_msgTypes[3].Exporter = func(v interface{}, i int) interface{} {
+			switch v := v.(*CallData); i {
+			case 0:
+				return &v.state
+			case 1:
+				return &v.sizeCache
+			case 2:
+				return &v.unknownFields
+			default:
+				return nil
+			}
+		}
+	}
+	file_github_com_aperturerobotics_starpc_srpc_rpcproto_proto_msgTypes[0].OneofWrappers = []interface{}{
+		(*Packet_CallStart)(nil),
+		(*Packet_CallStartResp)(nil),
+		(*Packet_CallData)(nil),
+	}
+	type x struct{}
+	out := protoimpl.TypeBuilder{
+		File: protoimpl.DescBuilder{
+			GoPackagePath: reflect.TypeOf(x{}).PkgPath(),
+			RawDescriptor: file_github_com_aperturerobotics_starpc_srpc_rpcproto_proto_rawDesc,
+			NumEnums:      0,
+			NumMessages:   4,
+			NumExtensions: 0,
+			NumServices:   0,
+		},
+		GoTypes:           file_github_com_aperturerobotics_starpc_srpc_rpcproto_proto_goTypes,
+		DependencyIndexes: file_github_com_aperturerobotics_starpc_srpc_rpcproto_proto_depIdxs,
+		MessageInfos:      file_github_com_aperturerobotics_starpc_srpc_rpcproto_proto_msgTypes,
+	}.Build()
+	File_github_com_aperturerobotics_starpc_srpc_rpcproto_proto = out.File
+	file_github_com_aperturerobotics_starpc_srpc_rpcproto_proto_rawDesc = nil
+	file_github_com_aperturerobotics_starpc_srpc_rpcproto_proto_goTypes = nil
+	file_github_com_aperturerobotics_starpc_srpc_rpcproto_proto_depIdxs = nil
+}

package/srpc/rpcproto.proto

@@ -0,0 +1,46 @@
+syntax = "proto3";
+package srpc;
+
+// Packet is a message sent over a srpc packet connection.
+message Packet {
+  // Body is the packet body.
+  oneof body {
+    // CallStart initiates a new call.
+    CallStart call_start = 1;
+    // CallStartResp is the response to CallStart.
+    CallStartResp call_start_resp = 2;
+    // CallData is a message in a streaming RPC sequence.
+    CallData call_data = 3;
+  }
+}
+
+// CallStart requests starting a new RPC call.
+message CallStart {
+  // RpcService is the service to contact.
+  // Must be set.
+  string rpc_service = 1;
+  // RpcMethod is the RPC method to call.
+  // Must be set.
+  string rpc_method = 2;
+  // Data contains the request or the first message in the stream.
+  // Optional if streaming.
+  bytes data = 3;
+}
+
+// CallStartResp is the response to CallStart.
+message CallStartResp {
+  // Error contains any error starting the RPC call.
+  // Empty if successful.
+  string error = 1;
+}
+
+// CallData contains a message in a streaming RPC sequence.
+message CallData {
+  // Data contains the packet in the sequence.
+  bytes data = 1;
+  // Complete indicates the RPC call is completed.
+  bool complete = 2;
+  // Error contains any error that caused the RPC to fail.
+  // If set, implies complete=true.
+  string error = 3;
+}