@devvit/protos 0.12.1-next-2025-09-08-20-55-43-6ce1b439e.0 → 0.12.1-next-2025-09-09-13-45-18-0f0a506a2.0

package/schema/.snootobuf/deps/.snootobuf/deps/devvit/actor/automation/v1alpha/event_handlers.proto

@@ -0,0 +1,105 @@
+syntax = "proto3";
+
+package devvit.actor.automation.v1alpha;
+
+import "devvit/events/v1alpha/events.proto";
+import "devvit/reddit/v2alpha/modaction.proto";
+import "devvit/reddit/v2alpha/modmail.proto";
+
+option go_package = "github.snooguts.net/reddit/reddit-devplatform-monorepo/go-common/generated/protos/types/devvit/actor/automation";
+option java_package = "com.reddit.devvit.actor.automation";
+
+// This needs to rectified with StepResult at some point
+message HandlerResult {}
+
+service OnPostSubmit {
+  rpc OnPostSubmit(devvit.events.v1alpha.PostSubmit) returns (HandlerResult);
+}
+
+service OnPostCreate {
+  rpc OnPostCreate(devvit.events.v1alpha.PostCreate) returns (HandlerResult);
+}
+
+service OnPostUpdate {
+  rpc OnPostUpdate(devvit.events.v1alpha.PostUpdate) returns (HandlerResult);
+}
+
+service OnPostReport {
+  rpc OnPostReport(devvit.events.v1alpha.PostReport) returns (HandlerResult);
+}
+
+service OnPostFlairUpdate {
+  rpc OnPostFlairUpdate(devvit.events.v1alpha.PostFlairUpdate) returns (HandlerResult);
+}
+
+service OnPostDelete {
+  rpc OnPostDelete(devvit.events.v1alpha.PostDelete) returns (HandlerResult);
+}
+
+service OnPostApprove {
+  rpc OnPostApprove(devvit.events.v1alpha.PostApprove) returns (HandlerResult);
+}
+
+service OnCommentSubmit {
+  rpc OnCommentSubmit(devvit.events.v1alpha.CommentSubmit) returns (HandlerResult);
+}
+
+service OnCommentCreate {
+  rpc OnCommentCreate(devvit.events.v1alpha.CommentCreate) returns (HandlerResult);
+}
+
+service OnCommentUpdate {
+  rpc OnCommentUpdate(devvit.events.v1alpha.CommentUpdate) returns (HandlerResult);
+}
+
+service OnCommentReport {
+  rpc OnCommentReport(devvit.events.v1alpha.CommentReport) returns (HandlerResult);
+}
+
+service OnCommentDelete {
+  rpc OnCommentDelete(devvit.events.v1alpha.CommentDelete) returns (HandlerResult);
+}
+
+service OnCommentApprove {
+  rpc OnCommentApprove(devvit.events.v1alpha.CommentApprove) returns (HandlerResult);
+}
+
+service OnSubredditSubscribe {
+  rpc OnSubredditSubscribe(devvit.events.v1alpha.SubredditSubscribe) returns (HandlerResult);
+}
+
+service OnAppInstall {
+  rpc OnAppInstall(devvit.events.v1alpha.AppInstall) returns (HandlerResult);
+}
+
+service OnAppUpgrade {
+  rpc OnAppUpgrade(devvit.events.v1alpha.AppUpgrade) returns (HandlerResult);
+}
+
+service OnModAction {
+  rpc OnModAction(devvit.reddit.v2alpha.ModAction) returns (HandlerResult);
+}
+
+service OnModMail {
+  rpc OnModMail(devvit.reddit.v2alpha.ModMail) returns (HandlerResult);
+}
+
+service OnAccountDelete {
+  rpc OnAccountDelete(devvit.events.v1alpha.AccountDelete) returns (HandlerResult);
+}
+
+service OnPostNsfwUpdate {
+  rpc OnPostNsfwUpdate(devvit.events.v1alpha.PostNsfwUpdate) returns (HandlerResult);
+}
+
+service OnPostSpoilerUpdate {
+  rpc OnPostSpoilerUpdate(devvit.events.v1alpha.PostSpoilerUpdate) returns (HandlerResult);
+}
+
+service OnAutomoderatorFilterPost {
+  rpc OnAutomoderatorFilterPost(devvit.events.v1alpha.AutomoderatorFilterPost) returns (HandlerResult);
+}
+
+service OnAutomoderatorFilterComment {
+  rpc OnAutomoderatorFilterComment(devvit.events.v1alpha.AutomoderatorFilterComment) returns (HandlerResult);
+}

package/schema/.snootobuf/deps/.snootobuf/deps/devvit/actor/hello/hello.proto

@@ -0,0 +1,18 @@
+syntax = "proto3";
+
+package devvit.actor.hello;
+
+option go_package = "github.snooguts.net/reddit/reddit-devplatform-monorepo/go-common/generated/protos/types/devvit/actor/hello";
+option java_package = "com.reddit.devvit.actor.hello";
+
+message PingMessage {
+  string message = 1;
+  int32 delay_millis = 2;
+  float success_probability = 3;
+}
+
+// hello is a ping service, with various conditions applied to how it succeeds
+// and fails
+service Hello {
+  rpc Ping(PingMessage) returns (PingMessage);
+}

package/schema/.snootobuf/deps/.snootobuf/deps/devvit/actor/payments/v1alpha/payments.proto

@@ -0,0 +1,41 @@
+syntax = "proto3";
+
+package devvit.actor.payments.v1alpha;
+
+import "devvit/payments/v1alpha/order.proto";
+
+option go_package = "github.snooguts.net/reddit/reddit-devplatform-monorepo/go-common/generated/protos/types/devvit/actor/payments";
+option java_package = "com.reddit.devvit.actor.payments";
+
+// PaymentProcessor is an actor type for exposing hooks that are triggered
+// as part of product order flow.
+service PaymentProcessor {
+  // FulfillOrder is called while the order is in-flight by the Payments platform.
+  // This give the opportunity for a developer to acknowlege and order has been
+  // fulfilled or reject it
+  rpc FulfillOrder(FulfillOrderRequest) returns (FulfillOrderResponse);
+
+  // RefundOrder is called when an order is refunded. This happens asynchnously
+  // outside the main order flow
+  rpc RefundOrder(RefundOrderRequest) returns (RefundOrderResponse);
+}
+
+message FulfillOrderRequest {
+  devvit.payments.v1alpha.Order order = 1;
+}
+
+message RefundOrderRequest {
+  devvit.payments.v1alpha.Order order = 1;
+}
+
+message FulfillOrderResponse {
+  oneof result {
+    // the product has been acknowledged and delivered
+    bool acknowledged = 1;
+    // the reason for rejecting product delivery
+    string rejection_reason = 2;
+  }
+}
+
+// RefundHandlerResult is empty. Placeholder for future functionality
+message RefundOrderResponse {}

package/schema/.snootobuf/deps/.snootobuf/deps/devvit/actor/producer/producer.proto

@@ -0,0 +1,22 @@
+syntax = "proto3";
+
+package devvit.actor.producer;
+
+option go_package = "github.snooguts.net/reddit/reddit-devplatform-monorepo/go-common/generated/protos/types/devvit/actor/producer";
+option java_package = "com.reddit.devvit.actor.producer";
+
+message Arg {
+  oneof element {
+    string str = 1;
+    int32 i32 = 2;
+    int64 i64 = 3;
+  }
+}
+
+message Args {
+  repeated Arg elements = 1;
+}
+
+service Producer {
+  rpc Produce(Args) returns (stream Arg);
+}

package/schema/.snootobuf/deps/.snootobuf/deps/devvit/actor/reddit/context_action.proto

@@ -0,0 +1,92 @@
+syntax = "proto3";
+
+package devvit.actor.reddit;
+
+import "devvit/actor/reddit/context_type.proto";
+import "devvit/actor/user_configurable/user_configurable.proto";
+import "devvit/plugin/redditapi/common/common_msg.proto";
+import "devvit/ui/effects/v1alpha/effect.proto";
+import "google/protobuf/empty.proto";
+
+option go_package = "github.snooguts.net/reddit/reddit-devplatform-monorepo/go-common/generated/protos/types/devvit/actor/reddit";
+option java_package = "com.reddit.devvit.actor.reddit";
+
+// Which contexts an action should be applied to
+message ContextActionAllowedContexts {
+  bool post = 1;
+  bool comment = 2;
+  bool subreddit = 3;
+}
+
+// Restrict access to specific user groups
+message ContextActionAllowedUsers {
+  // Moderator only
+  bool moderator = 1;
+  // Member of the subreddit where the Actor is installed
+  bool member = 2 [deprecated = true];
+  // Logged out users can perform this action
+  bool logged_out = 3;
+}
+
+// Filters for post actions
+message ContextActionPostFilters {
+  // If true, only display action for posts created by the app itself, otherwise for all posts
+  optional bool current_app = 1;
+}
+
+// Describes a single action provided by an Actor
+message ContextActionDescription {
+  // Dev-specified ID for this action to determine which one was called in OnAction
+  string action_id = 1;
+  // User-facing name for this action (i.e.: text in the overflow menu)
+  string name = 2;
+  // Short, user-facing secondary text to describe what this action is going to do
+  string description = 3;
+  // Flags to determine in which contexts this action should be displayed
+  ContextActionAllowedContexts contexts = 4;
+  // Flags to determine what kind of user can see this action
+  ContextActionAllowedUsers users = 5;
+  // Optional field to request user input when the action is clicked
+  devvit.actor.user_configurable.ConfigForm user_input = 6;
+  // Filters to apply to actions in post context
+  optional ContextActionPostFilters post_filters = 7;
+}
+
+message ContextActionList {
+  repeated ContextActionDescription actions = 1;
+}
+
+message ContextActionRequest {
+  // The action ID defined in ContextActionDescription
+  string action_id = 1;
+  // Which context this request is coming from
+  ContextType context = 2;
+  // The post/comment/subreddit metadata this click is associated with
+  oneof context_data {
+    // TODO: Replace with Post/Comment/Subreddit types when it's safe
+    devvit.plugin.redditapi.common.RedditObject post = 3;
+    devvit.plugin.redditapi.common.RedditObject comment = 4;
+    devvit.plugin.redditapi.common.SubredditObject subreddit = 5;
+  }
+  // If user_input is defined in ContextActionDescription, the result will be provided here
+  devvit.actor.user_configurable.ConfigForm user_input = 6;
+}
+
+message ContextActionResponse {
+  // Whether or not the action was successful.
+  // @deprecated Use effects instead
+  bool success = 1;
+  // If set, display as a popup toast to the user
+  // @deprecated Use effects instead
+  string message = 2;
+
+  repeated devvit.ui.effects.v1alpha.Effect effects = 3;
+}
+
+// Context actions are clickable entry points from various parts of Reddit,
+// such as a Post or Comment, in order to trigger additional actions
+// (perform actions on behalf of the user, display additional UI, etc.)
+service ContextAction {
+  rpc GetActions(google.protobuf.Empty) returns (ContextActionList);
+  rpc OnAction(ContextActionRequest) returns (ContextActionResponse);
+}

package/schema/.snootobuf/deps/.snootobuf/deps/devvit/actor/reddit/context_type.proto

@@ -0,0 +1,14 @@
+syntax = "proto3";
+
+package devvit.actor.reddit;
+
+option go_package = "github.snooguts.net/reddit/reddit-devplatform-monorepo/go-common/generated/protos/types/devvit/actor/reddit";
+option java_package = "com.reddit.devvit.actor.reddit";
+
+// NOTE: This enum is in its own file to optimize tree-shaking
+
+enum ContextType {
+  POST = 0;
+  COMMENT = 1;
+  SUBREDDIT = 2;
+}

package/schema/.snootobuf/deps/.snootobuf/deps/devvit/actor/reddit/post_filter.proto

@@ -0,0 +1,20 @@
+syntax = "proto3";
+
+package devvit.actor.reddit;
+
+import "devvit/reddit/post.proto";
+
+option go_package = "github.snooguts.net/reddit/reddit-devplatform-monorepo/go-common/generated/protos/types/devvit/actor/reddit";
+option java_package = "com.reddit.devvit.actor.reddit";
+
+message PostFilterRequest {
+  devvit.reddit.Post post = 1;
+}
+
+message Response {
+  bool accepted = 1;
+}
+
+service PostFilter {
+  rpc Filter(PostFilterRequest) returns (Response);
+}

package/schema/.snootobuf/deps/.snootobuf/deps/devvit/actor/scheduler/action.proto

@@ -0,0 +1,15 @@
+syntax = "proto3";
+
+package devvit.actor.scheduler;
+
+import "google/protobuf/struct.proto";
+
+option go_package = "github.snooguts.net/reddit/reddit-devplatform-monorepo/go-common/generated/protos/types/devvit/actor/scheduler";
+option java_package = "com.reddit.devvit.actor.scheduler";
+
+message ScheduledAction {
+  // Arbitrary string for an Actor's internal use
+  string type = 1;
+  // Arbitrary string for an Actor's internal use (i.e.: JSON serialized data)
+  google.protobuf.Struct data = 2;
+}

package/schema/.snootobuf/deps/.snootobuf/deps/devvit/actor/scheduler/handler.proto

@@ -0,0 +1,15 @@
+syntax = "proto3";
+
+package devvit.actor.scheduler;
+
+import "devvit/actor/scheduler/action.proto";
+import "google/protobuf/empty.proto";
+
+option go_package = "github.snooguts.net/reddit/reddit-devplatform-monorepo/go-common/generated/protos/types/devvit/actor/scheduler";
+option java_package = "com.reddit.devvit.actor.scheduler";
+
+// Actors must implement this interface to use the Scheduler.
+// HandleScheduledAction will be called by the Scheduler at the specified time.
+service SchedulerHandler {
+  rpc HandleScheduledAction(ScheduledAction) returns (google.protobuf.Empty);
+}

package/schema/.snootobuf/deps/.snootobuf/deps/devvit/actor/settings/v1alpha/app_settings.proto

@@ -0,0 +1,21 @@
+syntax = "proto3";
+
+package devvit.actor.settings.v1alpha;
+
+import "devvit/actor/settings/v1alpha/shared.proto";
+
+option go_package = "github.snooguts.net/reddit/reddit-devplatform-monorepo/go-common/generated/protos/types/devvit/actor/settings";
+option java_package = "com.reddit.devvit.actor.settings";
+
+// Define settings configured by the app dev when the app is uploaded.
+// App-level settings are available to every instance of your app within a single
+// app context.  For example, if creating a custom post app, every post will have access
+// to these settings.
+// Load the saved values with the Settings plugin.
+service AppSettings {
+  // Requested by the platform when rendering the configure form upon installing this app
+  rpc GetAppSettingsFields(GetFieldsRequest) returns (GetFieldsResponse);
+
+  // Called by the installation form before saving settings to allow for more advanced field validation
+  rpc ValidateAppForm(ValidateFormRequest) returns (ValidateFormResponse);
+}

package/schema/.snootobuf/deps/.snootobuf/deps/devvit/actor/settings/v1alpha/installation_settings.proto

@@ -0,0 +1,21 @@
+syntax = "proto3";
+
+package devvit.actor.settings.v1alpha;
+
+import "devvit/actor/settings/v1alpha/shared.proto";
+
+option go_package = "github.snooguts.net/reddit/reddit-devplatform-monorepo/go-common/generated/protos/types/devvit/actor/settings";
+option java_package = "com.reddit.devvit.actor.settings";
+
+// Define settings configured by the user when your app is installed.
+// Installation-level settings are available to every instance of your app within a single
+// installation context.  For example, if creating a custom post app, every post will have access
+// to these settings.
+// Load the saved values with the Settings plugin.
+service InstallationSettings {
+  // Requested by the platform when rendering the configure form upon installing this app
+  rpc GetSettingsFields(GetFieldsRequest) returns (GetFieldsResponse);
+
+  // Called by the installation form before saving settings to allow for more advanced field validation
+  rpc ValidateForm(ValidateFormRequest) returns (ValidateFormResponse);
+}

package/schema/.snootobuf/deps/.snootobuf/deps/devvit/actor/settings/v1alpha/instance_settings.proto

@@ -0,0 +1,20 @@
+syntax = "proto3";
+
+package devvit.actor.settings.v1alpha;
+
+import "devvit/actor/settings/v1alpha/shared.proto";
+
+option go_package = "github.snooguts.net/reddit/reddit-devplatform-monorepo/go-common/generated/protos/types/devvit/actor/settings";
+option java_package = "com.reddit.devvit.actor.settings";
+
+// Define settings scoped to a single instance of your app.
+// Useful for multi-instanced apps such as custom posts, where each post is configured by the user
+// when they create the post.  These values will _not_ be shared between instances.
+// Load the saved values with the Settings plugin.
+service InstanceSettings {
+  // Requested by the platform when rendering the form to configure this actor
+  rpc GetSettingsFields(GetFieldsRequest) returns (GetFieldsResponse);
+
+  // Called by the platform to allow more advanced verification of fields
+  rpc ValidateForm(ValidateFormRequest) returns (ValidateFormResponse);
+}

package/schema/.snootobuf/deps/.snootobuf/deps/devvit/actor/settings/v1alpha/shared.proto

@@ -0,0 +1,34 @@
+syntax = "proto3";
+
+package devvit.actor.settings.v1alpha;
+
+import "devvit/ui/form_builder/v1alpha/form.proto";
+import "devvit/ui/form_builder/v1alpha/value.proto";
+
+option go_package = "github.snooguts.net/reddit/reddit-devplatform-monorepo/go-common/generated/protos/types/devvit/actor/settings";
+option java_package = "com.reddit.devvit.actor.settings";
+
+message GetFieldsRequest {
+  // If true, the form is editing existing settings
+  bool editing = 1;
+}
+
+message GetFieldsResponse {
+  devvit.ui.form_builder.v1alpha.Form fields = 1;
+}
+
+message ValidateFormRequest {
+  // If true, the form is editing existing settings
+  bool editing = 1;
+
+  // Map of id:value pairs to validate
+  map<string, devvit.ui.form_builder.v1alpha.FormFieldValue> field_values = 2;
+}
+
+message ValidateFormResponse {
+  // If false, prevent submission and display errors on the form
+  bool success = 1;
+
+  // Map of id:error pairs to display on the form
+  map<string, string> errors = 2;
+}

package/schema/.snootobuf/deps/.snootobuf/deps/devvit/actor/test/wrappertypes.proto

@@ -0,0 +1,18 @@
+syntax = "proto3";
+
+package devvit.actor.test;
+
+import "google/protobuf/wrappers.proto";
+
+option go_package = "github.snooguts.net/reddit/reddit-devplatform-monorepo/go-common/generated/protos/types/devvit/actor/test";
+
+service WrapperTypes {
+  rpc StringRequest(google.protobuf.StringValue) returns (google.protobuf.StringValue);
+  rpc BoolRequest(google.protobuf.BoolValue) returns (google.protobuf.BoolValue);
+  rpc Int32Request(google.protobuf.Int32Value) returns (google.protobuf.Int32Value);
+  rpc UInt32Request(google.protobuf.UInt32Value) returns (google.protobuf.UInt32Value);
+  rpc Int64Request(google.protobuf.Int64Value) returns (google.protobuf.Int64Value);
+  rpc UInt64Request(google.protobuf.UInt64Value) returns (google.protobuf.UInt64Value);
+  rpc FloatRequest(google.protobuf.FloatValue) returns (google.protobuf.FloatValue);
+  rpc DoubleRequest(google.protobuf.DoubleValue) returns (google.protobuf.DoubleValue);
+}

package/schema/.snootobuf/deps/.snootobuf/deps/devvit/actor/user_configurable/user_configurable.proto

@@ -0,0 +1,55 @@
+syntax = "proto3";
+
+package devvit.actor.user_configurable;
+
+import "google/protobuf/empty.proto";
+
+option go_package = "github.snooguts.net/reddit/reddit-devplatform-monorepo/go-common/generated/protos/types/devvit/actor/user_configurable";
+option java_package = "com.reddit.devvit.actor.user_configurable";
+
+enum ConfigFieldType {
+  // Single-line string
+  STRING = 0;
+  // Multi-line string
+  PARAGRAPH = 1;
+  // Number input (i.e.: spinner)
+  NUMBER = 2;
+  // Checkbox, switch
+  BOOLEAN = 3;
+  // LIST, SECTION, and GROUP are not available here, so skipping 4-6
+  reserved 4 to 6;
+  // Image upload - value is a URL for the uploaded image
+  IMAGE = 7;
+}
+
+message ConfigForm {
+  repeated ConfigField fields = 1;
+}
+
+// Defines a configuration field with a specific type
+message ConfigField {
+  // Determines what kind of user input to generate for this field
+  ConfigFieldType field_type = 1;
+  // Unique identifier for the setting
+  string key = 2;
+  // Message to display to the user for this setting
+  string prompt = 3;
+  // The value of the field.
+  // When calling RenderForm provide the existing value of the field
+  // When calling HandleFormResponse read this property to get the user's response
+  string response = 4;
+}
+
+message FormResponse {
+  bool success = 1;
+  repeated string messages = 2;
+}
+
+// Enables an actor to be configurable after installation
+service UserConfigurable {
+  // Get a list of inputs to present to the user
+  rpc RenderForm(google.protobuf.Empty) returns (ConfigForm);
+  // Parse the user input.
+  // The original ConfigForm is provided with the response fields updated from the user's input.
+  rpc HandleFormResponse(ConfigForm) returns (FormResponse);
+}

package/schema/.snootobuf/deps/.snootobuf/deps/devvit/actor/webbit/webbit.proto

@@ -0,0 +1,34 @@
+syntax = "proto3";
+
+package devvit.actor.webbit;
+
+option go_package = "github.snooguts.net/reddit/reddit-devplatform-monorepo/go-common/generated/protos/types/devvit/actor/webbit";
+option java_package = "com.reddit.devvit.actor.webbit";
+
+message WebbitHttpRequest {
+  HttpMethod method = 1;
+  string path = 2;
+  map<string, string> headers = 3;
+  bytes body = 4;
+}
+
+message WebbitHttpResponse {
+  int32 status_code = 1;
+  map<string, string> headers = 2;
+  bytes body = 3;
+}
+
+service WebbitServer {
+  rpc Request(WebbitHttpRequest) returns (WebbitHttpResponse);
+}
+
+enum HttpMethod {
+  HTTP_METHOD_UNSPECIFIED = 0;
+  POST = 1;
+  GET = 2;
+  HEAD = 3;
+  PUT = 4;
+  DELETE = 5;
+  PATCH = 6;
+  OPTIONS = 7;
+}

package/schema/.snootobuf/deps/.snootobuf/deps/devvit/analytics/v1/analytics.proto

@@ -0,0 +1,32 @@
+syntax = "proto3";
+
+package devvit.analytics.v1;
+
+import "google/protobuf/timestamp.proto";
+
+option go_package = "github.snooguts.net/reddit/devplatform-api/go/grpc/devvit/analytics/v1";
+
+// The Devvit Analytics API provides analytics data on a per-app basis.
+service DevvitAnalyticsService {
+  rpc GetAnalyticsByApp(GetAnalyticsByAppRequest) returns (GetAnalyticsByAppResponse);
+}
+
+message GetAnalyticsByAppRequest {
+  string app_slug = 1;
+  google.protobuf.Timestamp start_date = 2;
+  google.protobuf.Timestamp end_date = 3;
+}
+
+message GetAnalyticsByAppResponse {
+  repeated DailyAppAnalytics daily_analytics = 1;
+}
+
+message DailyAppAnalytics {
+  google.protobuf.Timestamp date = 1;
+  int64 unique_clickers = 2;
+  int64 unique_viewers = 3;
+  int64 total_clicks = 4;
+  int64 total_views = 5;
+  int64 qualified_installs = 6;
+  int64 lifetime_clicks = 7;
+}

package/schema/.snootobuf/deps/.snootobuf/deps/devvit/cli/init.proto

@@ -0,0 +1,14 @@
+syntax = "proto3";
+package devvit.cli;
+
+option go_package = "github.snooguts.net/reddit/reddit-devplatform-monorepo/go-common/generated/protos/types/devvit/cli";
+
+// Response the init cli command expects to receive
+message InitAppResponse {
+  // One time use auth code to authenticate the CLI to Reddit
+  optional string auth_code = 1;
+  // Name of the app to be created
+  string app_name = 2;
+  // Name of the template to be used to create the app
+  optional string template_name = 3;
+}

package/schema/.snootobuf/deps/.snootobuf/deps/devvit/cli/playtest.proto

@@ -0,0 +1,41 @@
+syntax = "proto3";
+package devvit.cli;
+
+import "devvit/plugin/logger/logger.proto";
+
+option go_package = "github.snooguts.net/reddit/reddit-devplatform-monorepo/go-common/generated/protos/types/devvit/cli";
+
+// CLI and other clients may be at any version so Protobuf is used to guarantee
+// compatibility.
+
+// A message from a client (usually embedded in shreddit) to a server.
+message PlaytestProviderMessage {
+  oneof message {
+    PlaytestCallState call_state = 1;
+    PlaytestConnect connect = 2;
+  }
+}
+
+// A message from a server (usually the Devvit CLI) to a client.
+message PlaytestSubscriberMessage {
+  oneof message {
+    PlaytestAppInstalled app_installed = 1;
+  }
+}
+
+// Playtest app install notification.
+message PlaytestAppInstalled {}
+
+// Runtime.getCallState() reported by BrowserLiteClient.
+message PlaytestCallState {
+  repeated devvit.plugin.logger.LogMessage logs = 1;
+}
+
+// Connection details from BrowserLiteClient sent immediately after opening
+// socket.
+message PlaytestConnect {
+  // The full web address of the client. Eg,
+  // https://www.reddit.com/r/pixelary?playtest=pixelary-game and
+  // https://www.reddit.com/r/Pixelary/comments/1agoaja/what_is_this/?playtest&foo=bar.
+  string url = 1;
+}