@towns-labs/proto 7.1.0 → 7.3.0

package/dist/gen/apps_pb.d.ts

@@ -360,1435 +360,1595 @@ export type GetSessionResponse = Message<"river.GetSessionResponse"> & {
  */
 export declare const GetSessionResponseSchema: GenMessage<GetSessionResponse>;
 /**
- * As a performance optimization, we may wish to bundle together many key solicitation requests
- * and channel messages for the bot to respond to in a single webhook call. Thus, an isolated
- * group of channel messages and encryption keys, or a request for a key solicitation, is
- * represented here. For webhook calls regarding channel content, the payload may contain one or
- * more of these events.
+ * Position represents a single position held by a user.
  *
- * @generated from message river.EventPayload
+ * @generated from message river.Position
  */
-export type EventPayload = Message<"river.EventPayload"> & {
+export type Position = Message<"river.Position"> & {
     /**
-     * @generated from oneof river.EventPayload.payload
+     * Human-readable label (e.g., "ETH-PERP Long", "Will BTC hit $100k?")
+     *
+     * @generated from field: string label = 1;
      */
-    payload: {
-        /**
-         * @generated from field: river.EventPayload.Messages messages = 1;
-         */
-        value: EventPayload_Messages;
-        case: "messages";
-    } | {
-        /**
-         * @generated from field: river.EventPayload.SolicitKeys solicitation = 2;
-         */
-        value: EventPayload_SolicitKeys;
-        case: "solicitation";
-    } | {
-        case: undefined;
-        value?: undefined;
-    };
+    label: string;
+    /**
+     * Optional description (e.g., "10x leverage", "Yes @ $0.85")
+     *
+     * @generated from field: optional string description = 2;
+     */
+    description?: string;
+    /**
+     * Asset/token identifier (e.g., "ETH", "BTC", token ID)
+     *
+     * @generated from field: string symbol = 3;
+     */
+    symbol: string;
+    /**
+     * Position type for categorization
+     *
+     * @generated from field: river.PositionType type = 4;
+     */
+    type: PositionType;
+    /**
+     * Position value in USD (string for precision)
+     *
+     * @generated from field: string balance_usd = 5;
+     */
+    balanceUsd: string;
+    /**
+     * Unrealized PnL in USD (string for precision)
+     *
+     * @generated from field: string pnl_usd = 6;
+     */
+    pnlUsd: string;
+    /**
+     * Optional: Chain ID where the position exists (e.g., 42161 for Arbitrum, 137 for Polygon)
+     *
+     * @generated from field: optional uint64 chain_id = 7;
+     */
+    chainId?: bigint;
+    /**
+     * Optional: Native token balance on the chain (e.g., ETH, MATIC)
+     *
+     * @generated from field: optional string native_balance = 8;
+     */
+    nativeBalance?: string;
 };
 /**
- * Describes the message river.EventPayload.
- * Use `create(EventPayloadSchema)` to create a new message.
+ * Describes the message river.Position.
+ * Use `create(PositionSchema)` to create a new message.
  */
-export declare const EventPayloadSchema: GenMessage<EventPayload>;
+export declare const PositionSchema: GenMessage<Position>;
 /**
- * A Messages payload represents a group of user messages in a channel that qualifies for the app
- * to be notified. The included set of group encryption sessions in this message should have
- * all the needed ciphertexts to decrypt the set of messages sent in the same payload.
+ * PositionsRequest is sent by the app registry to a bot to fetch user positions.
  *
- * @generated from message river.EventPayload.Messages
+ * @generated from message river.PositionsRequest
  */
-export type EventPayload_Messages = Message<"river.EventPayload.Messages"> & {
-    /**
-     * @generated from field: bytes stream_id = 1;
-     */
-    streamId: Uint8Array;
-    /**
-     * @generated from field: repeated river.Envelope messages = 2;
-     */
-    messages: Envelope[];
+export type PositionsRequest = Message<"river.PositionsRequest"> & {
     /**
-     * @generated from field: repeated river.Envelope group_encryption_sessions_messages = 3;
+     * User requesting positions (20-byte Ethereum address)
+     *
+     * @generated from field: bytes user_id = 1;
      */
-    groupEncryptionSessionsMessages: Envelope[];
+    userId: Uint8Array;
 };
 /**
- * Describes the message river.EventPayload.Messages.
- * Use `create(EventPayload_MessagesSchema)` to create a new message.
+ * Describes the message river.PositionsRequest.
+ * Use `create(PositionsRequestSchema)` to create a new message.
  */
-export declare const EventPayload_MessagesSchema: GenMessage<EventPayload_Messages>;
+export declare const PositionsRequestSchema: GenMessage<PositionsRequest>;
 /**
- * A SolicitKeys request is sent when one or more messages in the same channel cannot be forwarded
- * to the app because the app does not have keys available to decrypt it in it's user inbox stream.
- * In this case, the app must be prompted to send a message to the stream to solicit the missing
- * session keys so that all queued messages can be forwarded.
+ * PositionsResponse is returned by a bot containing the user's positions.
  *
- * @generated from message river.EventPayload.SolicitKeys
+ * @generated from message river.PositionsResponse
  */
-export type EventPayload_SolicitKeys = Message<"river.EventPayload.SolicitKeys"> & {
+export type PositionsResponse = Message<"river.PositionsResponse"> & {
     /**
-     * @generated from field: bytes stream_id = 1;
+     * Whether the bot supports positions
+     *
+     * @generated from field: bool supported = 1;
      */
-    streamId: Uint8Array;
+    supported: boolean;
     /**
-     * @generated from field: repeated string session_ids = 2;
+     * Error message if positions couldn't be fetched
+     *
+     * @generated from field: optional string error = 2;
      */
-    sessionIds: string[];
+    error?: string;
+    /**
+     * Individual positions
+     *
+     * @generated from field: repeated river.Position positions = 3;
+     */
+    positions: Position[];
+    /**
+     * Timestamp when data was fetched (Unix milliseconds)
+     *
+     * @generated from field: int64 timestamp = 4;
+     */
+    timestamp: bigint;
 };
 /**
- * Describes the message river.EventPayload.SolicitKeys.
- * Use `create(EventPayload_SolicitKeysSchema)` to create a new message.
+ * Describes the message river.PositionsResponse.
+ * Use `create(PositionsResponseSchema)` to create a new message.
  */
-export declare const EventPayload_SolicitKeysSchema: GenMessage<EventPayload_SolicitKeys>;
+export declare const PositionsResponseSchema: GenMessage<PositionsResponse>;
 /**
- * @generated from message river.EventsPayload
+ * SlashCommand represents a command that the bot supports.
+ *
+ * @generated from message river.SlashCommand
  */
-export type EventsPayload = Message<"river.EventsPayload"> & {
+export type SlashCommand = Message<"river.SlashCommand"> & {
     /**
-     * @generated from field: repeated river.EventPayload events = 1;
+     * name is the command name (e.g., "help", "search").
+     * Must be 1-32 characters, contain only letters, numbers, and underscores,
+     * and start with a letter.
+     *
+     * @generated from field: string name = 1;
      */
-    events: EventPayload[];
+    name: string;
+    /**
+     * description is a short description of what the command does.
+     * Must be 1-256 characters.
+     *
+     * @generated from field: string description = 2;
+     */
+    description: string;
 };
 /**
- * Describes the message river.EventsPayload.
- * Use `create(EventsPayloadSchema)` to create a new message.
+ * Describes the message river.SlashCommand.
+ * Use `create(SlashCommandSchema)` to create a new message.
  */
-export declare const EventsPayloadSchema: GenMessage<EventsPayload>;
+export declare const SlashCommandSchema: GenMessage<SlashCommand>;
 /**
- * @generated from message river.AppServiceRequest
+ * CapabilityExample provides an example invocation for a capability.
+ *
+ * @generated from message river.CapabilityExample
  */
-export type AppServiceRequest = Message<"river.AppServiceRequest"> & {
+export type CapabilityExample = Message<"river.CapabilityExample"> & {
     /**
-     * @generated from oneof river.AppServiceRequest.payload
+     * user_query is a natural language query that would trigger this capability.
+     *
+     * @generated from field: string user_query = 1;
      */
-    payload: {
-        /**
-         * @generated from field: google.protobuf.Empty initialize = 101;
-         */
-        value: Empty;
-        case: "initialize";
-    } | {
-        /**
-         * @generated from field: google.protobuf.Empty status = 102;
-         */
-        value: Empty;
-        case: "status";
-    } | {
-        /**
-         * @generated from field: river.EventsPayload events = 103;
-         */
-        value: EventsPayload;
-        case: "events";
-    } | {
-        /**
-         * @generated from field: river.PositionsRequest positions = 104;
-         */
-        value: PositionsRequest;
-        case: "positions";
-    } | {
-        /**
-         * @generated from field: river.AppServiceRequest.ProposalsRequest proposals = 105;
-         */
-        value: AppServiceRequest_ProposalsRequest;
-        case: "proposals";
-    } | {
-        /**
-         * @generated from field: river.AppServiceRequest.ConciergeRequest concierge_request = 106;
-         */
-        value: AppServiceRequest_ConciergeRequest;
-        case: "conciergeRequest";
-    } | {
-        case: undefined;
-        value?: undefined;
-    };
+    userQuery: string;
+    /**
+     * parameters is a JSON-encoded example parameter object.
+     *
+     * @generated from field: string parameters = 2;
+     */
+    parameters: string;
 };
 /**
- * Describes the message river.AppServiceRequest.
- * Use `create(AppServiceRequestSchema)` to create a new message.
+ * Describes the message river.CapabilityExample.
+ * Use `create(CapabilityExampleSchema)` to create a new message.
  */
-export declare const AppServiceRequestSchema: GenMessage<AppServiceRequest>;
+export declare const CapabilityExampleSchema: GenMessage<CapabilityExample>;
 /**
- * @generated from message river.AppServiceRequest.ProposalsRequest
+ * Capability describes an action a specialist agent can perform.
+ *
+ * @generated from message river.Capability
  */
-export type AppServiceRequest_ProposalsRequest = Message<"river.AppServiceRequest.ProposalsRequest"> & {
+export type Capability = Message<"river.Capability"> & {
     /**
-     * Seed ID being populated by this specialist request.
+     * name is a unique identifier for this capability (e.g. "open_position").
      *
-     * @generated from field: string conversation_seed_id = 1;
+     * @generated from field: string name = 1;
      */
-    conversationSeedId: string;
+    name: string;
     /**
-     * Original user query for specialist context.
+     * description explains what this capability does.
      *
-     * @generated from field: string user_query = 2;
+     * @generated from field: string description = 2;
      */
-    userQuery: string;
+    description: string;
     /**
-     * Optional normalized context (e.g., thread summary or conversation context).
+     * input_schema is a JSON schema for the capability input.
      *
-     * @generated from field: optional string context = 3;
+     * @generated from field: string input_schema = 3;
      */
-    context?: string;
+    inputSchema: string;
     /**
-     * Invocations for this bot.
+     * examples help route natural language intents to this capability.
      *
-     * @generated from field: repeated river.SpecialistCapabilityInvocation invocations = 4;
+     * @generated from field: repeated river.CapabilityExample examples = 4;
      */
-    invocations: SpecialistCapabilityInvocation[];
+    examples: CapabilityExample[];
+};
+/**
+ * Describes the message river.Capability.
+ * Use `create(CapabilitySchema)` to create a new message.
+ */
+export declare const CapabilitySchema: GenMessage<Capability>;
+/**
+ * CapabilityManifest is the full capability advertisement for a specialist agent.
+ *
+ * @generated from message river.CapabilityManifest
+ */
+export type CapabilityManifest = Message<"river.CapabilityManifest"> & {
     /**
-     * Optional timeout budget for fan-out.
+     * agent_id is the specialist app_id (20 bytes).
      *
-     * @generated from field: optional int32 timeout_ms = 5;
+     * @generated from field: bytes agent_id = 1;
      */
-    timeoutMs?: number;
+    agentId: Uint8Array;
     /**
-     * IANA timezone of the user, e.g. "America/New_York".
+     * agent_name is a human-readable specialist name.
      *
-     * @generated from field: optional string user_timezone = 6;
+     * @generated from field: string agent_name = 2;
      */
-    userTimezone?: string;
+    agentName: string;
     /**
-     * Optional metadata forwarded from concierge to specialist handlers.
+     * agent_description is a human-readable specialist description.
      *
-     * @generated from field: map<string, string> metadata = 7;
+     * @generated from field: string agent_description = 3;
      */
-    metadata: {
-        [key: string]: string;
-    };
+    agentDescription: string;
+    /**
+     * capabilities declared by this specialist.
+     *
+     * @generated from field: repeated river.Capability capabilities = 4;
+     */
+    capabilities: Capability[];
+    /**
+     * version is used for cache invalidation.
+     *
+     * @generated from field: string version = 5;
+     */
+    version: string;
 };
 /**
- * Describes the message river.AppServiceRequest.ProposalsRequest.
- * Use `create(AppServiceRequest_ProposalsRequestSchema)` to create a new message.
+ * Describes the message river.CapabilityManifest.
+ * Use `create(CapabilityManifestSchema)` to create a new message.
  */
-export declare const AppServiceRequest_ProposalsRequestSchema: GenMessage<AppServiceRequest_ProposalsRequest>;
+export declare const CapabilityManifestSchema: GenMessage<CapabilityManifest>;
 /**
- * @generated from message river.AppServiceRequest.ConciergeRequest
+ * @generated from message river.AppMetadata
  */
-export type AppServiceRequest_ConciergeRequest = Message<"river.AppServiceRequest.ConciergeRequest"> & {
+export type AppMetadata = Message<"river.AppMetadata"> & {
     /**
-     * Seed ID created by QueryConcierge and used for polling/fan-out.
+     * username is the identifier used to mention the bot (e.g., "@mybot").
+     * Must be unique across all bots.
      *
-     * @generated from field: string conversation_seed_id = 1;
+     * @generated from field: string username = 1;
      */
-    conversationSeedId: string;
+    username: string;
     /**
-     * Original user query (or query derived from full twitter thread context).
-     *
-     * @generated from field: string user_query = 2;
+     * @generated from field: string description = 2;
      */
-    userQuery: string;
+    description: string;
     /**
-     * Optional normalized context (e.g., thread summary or conversation history).
-     *
-     * @generated from field: optional string context = 3;
+     * @generated from field: string image_url = 3;
      */
-    context?: string;
+    imageUrl: string;
     /**
-     * Optional external reference (e.g., tweet ID).
+     * @generated from field: optional string external_url = 4;
+     */
+    externalUrl?: string;
+    /**
+     * slash_commands is a list of commands the bot supports.
+     * Maximum of 25 commands per bot.
      *
-     * @generated from field: optional string external_ref = 4;
+     * @generated from field: repeated river.SlashCommand slash_commands = 6;
      */
-    externalRef?: string;
+    slashCommands: SlashCommand[];
     /**
-     * Timeout from the conversation seed.
+     * display_name is the friendly name shown in chat conversations (e.g., "My Helpful Bot").
+     * Must be non-empty.
      *
-     * @generated from field: optional int64 proposal_timeout_ms = 5;
+     * @generated from field: string display_name = 7;
      */
-    proposalTimeoutMs?: bigint;
+    displayName: string;
     /**
-     * Timeout from the conversation seed.
+     * motto is a short tagline or slogan for the bot.
      *
-     * @generated from field: optional int64 concierge_timeout_ms = 6;
+     * @generated from field: string motto = 8;
      */
-    conciergeTimeoutMs?: bigint;
+    motto: string;
     /**
-     * IANA timezone of the user, e.g. "America/New_York".
+     * capabilities is a list of specialist capabilities supported by the app.
      *
-     * @generated from field: optional string user_timezone = 7;
+     * @generated from field: repeated river.Capability capabilities = 9;
      */
-    userTimezone?: string;
+    capabilities: Capability[];
+};
+/**
+ * Describes the message river.AppMetadata.
+ * Use `create(AppMetadataSchema)` to create a new message.
+ */
+export declare const AppMetadataSchema: GenMessage<AppMetadata>;
+/**
+ * AppMetadataUpdate represents a partial update to app metadata
+ *
+ * @generated from message river.AppMetadataUpdate
+ */
+export type AppMetadataUpdate = Message<"river.AppMetadataUpdate"> & {
     /**
-     * Optional user ID (Ethereum address) of the user making the query.
+     * All fields are optional for partial updates
      *
-     * @generated from field: optional bytes user_id = 8;
+     * @generated from field: optional string username = 1;
+     */
+    username?: string;
+    /**
+     * @generated from field: optional string description = 2;
+     */
+    description?: string;
+    /**
+     * @generated from field: optional string image_url = 3;
+     */
+    imageUrl?: string;
+    /**
+     * @generated from field: optional string external_url = 4;
+     */
+    externalUrl?: string;
+    /**
+     * @generated from field: repeated river.SlashCommand slash_commands = 6;
+     */
+    slashCommands: SlashCommand[];
+    /**
+     * @generated from field: optional string display_name = 7;
+     */
+    displayName?: string;
+    /**
+     * @generated from field: optional string motto = 8;
+     */
+    motto?: string;
+    /**
+     * @generated from field: repeated river.Capability capabilities = 9;
+     */
+    capabilities: Capability[];
+};
+/**
+ * Describes the message river.AppMetadataUpdate.
+ * Use `create(AppMetadataUpdateSchema)` to create a new message.
+ */
+export declare const AppMetadataUpdateSchema: GenMessage<AppMetadataUpdate>;
+/**
+ * Update app metadata
+ *
+ * @generated from message river.UpdateAppMetadataRequest
+ */
+export type UpdateAppMetadataRequest = Message<"river.UpdateAppMetadataRequest"> & {
+    /**
+     * @generated from field: bytes app_id = 1;
+     */
+    appId: Uint8Array;
+    /**
+     * @generated from field: river.AppMetadataUpdate metadata = 2;
+     */
+    metadata?: AppMetadataUpdate;
+    /**
+     * @generated from field: repeated string update_mask = 3;
+     */
+    updateMask: string[];
+};
+/**
+ * Describes the message river.UpdateAppMetadataRequest.
+ * Use `create(UpdateAppMetadataRequestSchema)` to create a new message.
+ */
+export declare const UpdateAppMetadataRequestSchema: GenMessage<UpdateAppMetadataRequest>;
+/**
+ * @generated from message river.UpdateAppMetadataResponse
+ */
+export type UpdateAppMetadataResponse = Message<"river.UpdateAppMetadataResponse"> & {};
+/**
+ * Describes the message river.UpdateAppMetadataResponse.
+ * Use `create(UpdateAppMetadataResponseSchema)` to create a new message.
+ */
+export declare const UpdateAppMetadataResponseSchema: GenMessage<UpdateAppMetadataResponse>;
+/**
+ * Get app metadata
+ *
+ * @generated from message river.GetAppMetadataRequest
+ */
+export type GetAppMetadataRequest = Message<"river.GetAppMetadataRequest"> & {
+    /**
+     * @generated from field: bytes app_id = 1;
      */
-    userId?: Uint8Array;
+    appId: Uint8Array;
 };
 /**
- * Describes the message river.AppServiceRequest.ConciergeRequest.
- * Use `create(AppServiceRequest_ConciergeRequestSchema)` to create a new message.
+ * Describes the message river.GetAppMetadataRequest.
+ * Use `create(GetAppMetadataRequestSchema)` to create a new message.
  */
-export declare const AppServiceRequest_ConciergeRequestSchema: GenMessage<AppServiceRequest_ConciergeRequest>;
+export declare const GetAppMetadataRequestSchema: GenMessage<GetAppMetadataRequest>;
 /**
- * @generated from message river.AppServiceResponse
+ * @generated from message river.GetAppMetadataResponse
  */
-export type AppServiceResponse = Message<"river.AppServiceResponse"> & {
+export type GetAppMetadataResponse = Message<"river.GetAppMetadataResponse"> & {
     /**
-     * @generated from oneof river.AppServiceResponse.payload
+     * @generated from field: river.AppMetadata metadata = 1;
      */
-    payload: {
-        /**
-         * @generated from field: river.AppServiceResponse.InitializeResponse initialize = 101;
-         */
-        value: AppServiceResponse_InitializeResponse;
-        case: "initialize";
-    } | {
-        /**
-         * @generated from field: river.AppServiceResponse.StatusResponse status = 102;
-         */
-        value: AppServiceResponse_StatusResponse;
-        case: "status";
-    } | {
-        /**
-         * @generated from field: river.PositionsResponse positions = 103;
-         */
-        value: PositionsResponse;
-        case: "positions";
-    } | {
-        /**
-         * @generated from field: river.AppServiceResponse.ProposalsResponse proposals = 104;
-         */
-        value: AppServiceResponse_ProposalsResponse;
-        case: "proposals";
-    } | {
-        /**
-         * @generated from field: river.AppServiceResponse.ConciergeResponse concierge_response = 105;
-         */
-        value: AppServiceResponse_ConciergeResponse;
-        case: "conciergeResponse";
-    } | {
-        case: undefined;
-        value?: undefined;
-    };
+    metadata?: AppMetadata;
 };
 /**
- * Describes the message river.AppServiceResponse.
- * Use `create(AppServiceResponseSchema)` to create a new message.
+ * Describes the message river.GetAppMetadataResponse.
+ * Use `create(GetAppMetadataResponseSchema)` to create a new message.
  */
-export declare const AppServiceResponseSchema: GenMessage<AppServiceResponse>;
+export declare const GetAppMetadataResponseSchema: GenMessage<GetAppMetadataResponse>;
 /**
- * @generated from message river.AppServiceResponse.InitializeResponse
+ * Validate bot username
+ *
+ * @generated from message river.ValidateBotNameRequest
  */
-export type AppServiceResponse_InitializeResponse = Message<"river.AppServiceResponse.InitializeResponse"> & {
+export type ValidateBotNameRequest = Message<"river.ValidateBotNameRequest"> & {
     /**
-     * @generated from field: river.UserMetadataPayload.EncryptionDevice encryption_device = 1;
+     * @generated from field: string username = 1;
      */
-    encryptionDevice?: UserMetadataPayload_EncryptionDevice;
+    username: string;
 };
 /**
- * Describes the message river.AppServiceResponse.InitializeResponse.
- * Use `create(AppServiceResponse_InitializeResponseSchema)` to create a new message.
+ * Describes the message river.ValidateBotNameRequest.
+ * Use `create(ValidateBotNameRequestSchema)` to create a new message.
  */
-export declare const AppServiceResponse_InitializeResponseSchema: GenMessage<AppServiceResponse_InitializeResponse>;
+export declare const ValidateBotNameRequestSchema: GenMessage<ValidateBotNameRequest>;
 /**
- * @generated from message river.AppServiceResponse.StatusResponse
+ * @generated from message river.ValidateBotNameResponse
  */
-export type AppServiceResponse_StatusResponse = Message<"river.AppServiceResponse.StatusResponse"> & {
-    /**
-     * Version established by the app registry that the bot framework supports.
-     * It indicates protocol compatibility.
-     *
-     * @generated from field: int32 framework_version = 1;
-     */
-    frameworkVersion: number;
-    /**
-     * @generated from field: string device_key = 2;
-     */
-    deviceKey: string;
+export type ValidateBotNameResponse = Message<"river.ValidateBotNameResponse"> & {
     /**
-     * @generated from field: string fallback_key = 3;
+     * @generated from field: bool is_available = 1;
      */
-    fallbackKey: string;
+    isAvailable: boolean;
     /**
-     * Optional metadata used to identify the client SDK version.
-     * Example: "javascript:@towns-labs/app-framework:0.0.1"
-     *
-     * @generated from field: optional string client_version = 4;
+     * @generated from field: string error_message = 2;
      */
-    clientVersion?: string;
+    errorMessage: string;
 };
 /**
- * Describes the message river.AppServiceResponse.StatusResponse.
- * Use `create(AppServiceResponse_StatusResponseSchema)` to create a new message.
+ * Describes the message river.ValidateBotNameResponse.
+ * Use `create(ValidateBotNameResponseSchema)` to create a new message.
  */
-export declare const AppServiceResponse_StatusResponseSchema: GenMessage<AppServiceResponse_StatusResponse>;
+export declare const ValidateBotNameResponseSchema: GenMessage<ValidateBotNameResponse>;
 /**
- * @generated from message river.AppServiceResponse.ProposalsResponse
+ * Set app active status
+ *
+ * @generated from message river.SetAppActiveStatusRequest
  */
-export type AppServiceResponse_ProposalsResponse = Message<"river.AppServiceResponse.ProposalsResponse"> & {
+export type SetAppActiveStatusRequest = Message<"river.SetAppActiveStatusRequest"> & {
     /**
-     * Webhook delivery accepted; processing continues asynchronously.
-     *
-     * @generated from field: bool accepted = 1;
+     * @generated from field: bytes app_id = 1;
      */
-    accepted: boolean;
+    appId: Uint8Array;
+    /**
+     * @generated from field: bool active = 2;
+     */
+    active: boolean;
 };
 /**
- * Describes the message river.AppServiceResponse.ProposalsResponse.
- * Use `create(AppServiceResponse_ProposalsResponseSchema)` to create a new message.
+ * Describes the message river.SetAppActiveStatusRequest.
+ * Use `create(SetAppActiveStatusRequestSchema)` to create a new message.
  */
-export declare const AppServiceResponse_ProposalsResponseSchema: GenMessage<AppServiceResponse_ProposalsResponse>;
+export declare const SetAppActiveStatusRequestSchema: GenMessage<SetAppActiveStatusRequest>;
 /**
- * @generated from message river.AppServiceResponse.ConciergeResponse
+ * @generated from message river.SetAppActiveStatusResponse
  */
-export type AppServiceResponse_ConciergeResponse = Message<"river.AppServiceResponse.ConciergeResponse"> & {
-    /**
-     * Webhook delivery accepted; processing continues asynchronously.
-     *
-     * @generated from field: bool accepted = 1;
-     */
-    accepted: boolean;
-};
+export type SetAppActiveStatusResponse = Message<"river.SetAppActiveStatusResponse"> & {};
 /**
- * Describes the message river.AppServiceResponse.ConciergeResponse.
- * Use `create(AppServiceResponse_ConciergeResponseSchema)` to create a new message.
+ * Describes the message river.SetAppActiveStatusResponse.
+ * Use `create(SetAppActiveStatusResponseSchema)` to create a new message.
  */
-export declare const AppServiceResponse_ConciergeResponseSchema: GenMessage<AppServiceResponse_ConciergeResponse>;
+export declare const SetAppActiveStatusResponseSchema: GenMessage<SetAppActiveStatusResponse>;
 /**
- * Position represents a single position held by a user.
+ * SetAppPromotedStatusRequest sets the promoted status of an app.
  *
- * @generated from message river.Position
+ * @generated from message river.SetAppPromotedStatusRequest
  */
-export type Position = Message<"river.Position"> & {
-    /**
-     * Human-readable label (e.g., "ETH-PERP Long", "Will BTC hit $100k?")
-     *
-     * @generated from field: string label = 1;
-     */
-    label: string;
-    /**
-     * Optional description (e.g., "10x leverage", "Yes @ $0.85")
-     *
-     * @generated from field: optional string description = 2;
-     */
-    description?: string;
+export type SetAppPromotedStatusRequest = Message<"river.SetAppPromotedStatusRequest"> & {
     /**
-     * Asset/token identifier (e.g., "ETH", "BTC", token ID)
+     * app_id is the address of the app (20 bytes)
      *
-     * @generated from field: string symbol = 3;
+     * @generated from field: bytes app_id = 1;
      */
-    symbol: string;
+    appId: Uint8Array;
     /**
-     * Position type for categorization
+     * promoted indicates whether the app should be discoverable in the catalog
      *
-     * @generated from field: river.PositionType type = 4;
+     * @generated from field: bool promoted = 2;
      */
-    type: PositionType;
+    promoted: boolean;
+};
+/**
+ * Describes the message river.SetAppPromotedStatusRequest.
+ * Use `create(SetAppPromotedStatusRequestSchema)` to create a new message.
+ */
+export declare const SetAppPromotedStatusRequestSchema: GenMessage<SetAppPromotedStatusRequest>;
+/**
+ * @generated from message river.SetAppPromotedStatusResponse
+ */
+export type SetAppPromotedStatusResponse = Message<"river.SetAppPromotedStatusResponse"> & {};
+/**
+ * Describes the message river.SetAppPromotedStatusResponse.
+ * Use `create(SetAppPromotedStatusResponseSchema)` to create a new message.
+ */
+export declare const SetAppPromotedStatusResponseSchema: GenMessage<SetAppPromotedStatusResponse>;
+/**
+ * SetAppVerifiedStatusRequest sets the verified status of an app.
+ *
+ * @generated from message river.SetAppVerifiedStatusRequest
+ */
+export type SetAppVerifiedStatusRequest = Message<"river.SetAppVerifiedStatusRequest"> & {
     /**
-     * Position value in USD (string for precision)
+     * app_id is the address of the app (20 bytes)
      *
-     * @generated from field: string balance_usd = 5;
+     * @generated from field: bytes app_id = 1;
      */
-    balanceUsd: string;
+    appId: Uint8Array;
     /**
-     * Unrealized PnL in USD (string for precision)
+     * verified indicates whether the app has been reviewed and approved by admins
      *
-     * @generated from field: string pnl_usd = 6;
+     * @generated from field: bool verified = 2;
      */
-    pnlUsd: string;
+    verified: boolean;
+};
+/**
+ * Describes the message river.SetAppVerifiedStatusRequest.
+ * Use `create(SetAppVerifiedStatusRequestSchema)` to create a new message.
+ */
+export declare const SetAppVerifiedStatusRequestSchema: GenMessage<SetAppVerifiedStatusRequest>;
+/**
+ * @generated from message river.SetAppVerifiedStatusResponse
+ */
+export type SetAppVerifiedStatusResponse = Message<"river.SetAppVerifiedStatusResponse"> & {};
+/**
+ * Describes the message river.SetAppVerifiedStatusResponse.
+ * Use `create(SetAppVerifiedStatusResponseSchema)` to create a new message.
+ */
+export declare const SetAppVerifiedStatusResponseSchema: GenMessage<SetAppVerifiedStatusResponse>;
+/**
+ * SetUserName allows users to set or update their username and display name.
+ *
+ * @generated from message river.SetUserNameRequest
+ */
+export type SetUserNameRequest = Message<"river.SetUserNameRequest"> & {
     /**
-     * Optional: Chain ID where the position exists (e.g., 42161 for Arbitrum, 137 for Polygon)
+     * username is the new username to set for the authenticated user.
      *
-     * @generated from field: optional uint64 chain_id = 7;
+     * @generated from field: string username = 1;
      */
-    chainId?: bigint;
+    username: string;
     /**
-     * Optional: Native token balance on the chain (e.g., ETH, MATIC)
+     * display_name is the friendly name shown in chat.
      *
-     * @generated from field: optional string native_balance = 8;
+     * @generated from field: string display_name = 2;
      */
-    nativeBalance?: string;
+    displayName: string;
 };
 /**
- * Describes the message river.Position.
- * Use `create(PositionSchema)` to create a new message.
+ * Describes the message river.SetUserNameRequest.
+ * Use `create(SetUserNameRequestSchema)` to create a new message.
  */
-export declare const PositionSchema: GenMessage<Position>;
+export declare const SetUserNameRequestSchema: GenMessage<SetUserNameRequest>;
 /**
- * PositionsRequest is sent by the app registry to a bot to fetch user positions.
+ * @generated from message river.SetUserNameResponse
+ */
+export type SetUserNameResponse = Message<"river.SetUserNameResponse"> & {};
+/**
+ * Describes the message river.SetUserNameResponse.
+ * Use `create(SetUserNameResponseSchema)` to create a new message.
+ */
+export declare const SetUserNameResponseSchema: GenMessage<SetUserNameResponse>;
+/**
+ * GetEntityName request - retrieves username for a single entity.
  *
- * @generated from message river.PositionsRequest
+ * @generated from message river.GetEntityNameRequest
  */
-export type PositionsRequest = Message<"river.PositionsRequest"> & {
+export type GetEntityNameRequest = Message<"river.GetEntityNameRequest"> & {
     /**
-     * User requesting positions (20-byte Ethereum address)
+     * entity_id is the address of the user or app to look up
      *
-     * @generated from field: bytes user_id = 1;
+     * @generated from field: bytes entity_id = 1;
      */
-    userId: Uint8Array;
+    entityId: Uint8Array;
 };
 /**
- * Describes the message river.PositionsRequest.
- * Use `create(PositionsRequestSchema)` to create a new message.
+ * Describes the message river.GetEntityNameRequest.
+ * Use `create(GetEntityNameRequestSchema)` to create a new message.
  */
-export declare const PositionsRequestSchema: GenMessage<PositionsRequest>;
+export declare const GetEntityNameRequestSchema: GenMessage<GetEntityNameRequest>;
 /**
- * PositionsResponse is returned by a bot containing the user's positions.
- *
- * @generated from message river.PositionsResponse
+ * @generated from message river.GetEntityNameResponse
  */
-export type PositionsResponse = Message<"river.PositionsResponse"> & {
-    /**
-     * Whether the bot supports positions
-     *
-     * @generated from field: bool supported = 1;
-     */
-    supported: boolean;
+export type GetEntityNameResponse = Message<"river.GetEntityNameResponse"> & {
     /**
-     * Error message if positions couldn't be fetched
+     * username is the entity's chosen username
      *
-     * @generated from field: optional string error = 2;
+     * @generated from field: string username = 1;
      */
-    error?: string;
+    username: string;
     /**
-     * Individual positions
+     * display_name is the entity's friendly display name
      *
-     * @generated from field: repeated river.Position positions = 3;
+     * @generated from field: string display_name = 2;
      */
-    positions: Position[];
+    displayName: string;
     /**
-     * Timestamp when data was fetched (Unix milliseconds)
+     * entity_type indicates whether this is a user (0) or app (1)
      *
-     * @generated from field: int64 timestamp = 4;
+     * @generated from field: int32 entity_type = 3;
      */
-    timestamp: bigint;
+    entityType: number;
 };
 /**
- * Describes the message river.PositionsResponse.
- * Use `create(PositionsResponseSchema)` to create a new message.
+ * Describes the message river.GetEntityNameResponse.
+ * Use `create(GetEntityNameResponseSchema)` to create a new message.
  */
-export declare const PositionsResponseSchema: GenMessage<PositionsResponse>;
+export declare const GetEntityNameResponseSchema: GenMessage<GetEntityNameResponse>;
 /**
- * SlashCommand represents a command that the bot supports.
+ * GetBatchEntityNames request - retrieves usernames for multiple entities.
  *
- * @generated from message river.SlashCommand
+ * @generated from message river.GetBatchEntityNamesRequest
  */
-export type SlashCommand = Message<"river.SlashCommand"> & {
-    /**
-     * name is the command name (e.g., "help", "search").
-     * Must be 1-32 characters, contain only letters, numbers, and underscores,
-     * and start with a letter.
-     *
-     * @generated from field: string name = 1;
-     */
-    name: string;
+export type GetBatchEntityNamesRequest = Message<"river.GetBatchEntityNamesRequest"> & {
     /**
-     * description is a short description of what the command does.
-     * Must be 1-256 characters.
+     * entity_ids is the list of addresses to look up
      *
-     * @generated from field: string description = 2;
+     * @generated from field: repeated bytes entity_ids = 1;
      */
-    description: string;
+    entityIds: Uint8Array[];
 };
 /**
- * Describes the message river.SlashCommand.
- * Use `create(SlashCommandSchema)` to create a new message.
+ * Describes the message river.GetBatchEntityNamesRequest.
+ * Use `create(GetBatchEntityNamesRequestSchema)` to create a new message.
  */
-export declare const SlashCommandSchema: GenMessage<SlashCommand>;
+export declare const GetBatchEntityNamesRequestSchema: GenMessage<GetBatchEntityNamesRequest>;
 /**
- * CapabilityExample provides an example invocation for a capability.
+ * EntityNameInfo contains the name information for a single entity.
  *
- * @generated from message river.CapabilityExample
+ * @generated from message river.EntityNameInfo
  */
-export type CapabilityExample = Message<"river.CapabilityExample"> & {
-    /**
-     * user_query is a natural language query that would trigger this capability.
-     *
-     * @generated from field: string user_query = 1;
-     */
-    userQuery: string;
+export type EntityNameInfo = Message<"river.EntityNameInfo"> & {
     /**
-     * parameters is a JSON-encoded example parameter object.
+     * entity_id is the address of the entity
      *
-     * @generated from field: string parameters = 2;
+     * @generated from field: bytes entity_id = 1;
      */
-    parameters: string;
-};
-/**
- * Describes the message river.CapabilityExample.
- * Use `create(CapabilityExampleSchema)` to create a new message.
- */
-export declare const CapabilityExampleSchema: GenMessage<CapabilityExample>;
-/**
- * Capability describes an action a specialist agent can perform.
- *
- * @generated from message river.Capability
- */
-export type Capability = Message<"river.Capability"> & {
+    entityId: Uint8Array;
     /**
-     * name is a unique identifier for this capability (e.g. "open_position").
+     * username is the entity's chosen username
      *
-     * @generated from field: string name = 1;
+     * @generated from field: string username = 2;
      */
-    name: string;
+    username: string;
     /**
-     * description explains what this capability does.
+     * display_name is the entity's friendly display name
      *
-     * @generated from field: string description = 2;
+     * @generated from field: string display_name = 3;
      */
-    description: string;
+    displayName: string;
     /**
-     * input_schema is a JSON schema for the capability input.
+     * entity_type indicates whether this is a user (0) or app (1)
      *
-     * @generated from field: string input_schema = 3;
+     * @generated from field: int32 entity_type = 4;
      */
-    inputSchema: string;
+    entityType: number;
+};
+/**
+ * Describes the message river.EntityNameInfo.
+ * Use `create(EntityNameInfoSchema)` to create a new message.
+ */
+export declare const EntityNameInfoSchema: GenMessage<EntityNameInfo>;
+/**
+ * @generated from message river.GetBatchEntityNamesResponse
+ */
+export type GetBatchEntityNamesResponse = Message<"river.GetBatchEntityNamesResponse"> & {
     /**
-     * examples help route natural language intents to this capability.
+     * entities contains the name info for each found entity.
+     * Entities that have not set usernames will not be included.
      *
-     * @generated from field: repeated river.CapabilityExample examples = 4;
+     * @generated from field: repeated river.EntityNameInfo entities = 1;
      */
-    examples: CapabilityExample[];
+    entities: EntityNameInfo[];
 };
 /**
- * Describes the message river.Capability.
- * Use `create(CapabilitySchema)` to create a new message.
+ * Describes the message river.GetBatchEntityNamesResponse.
+ * Use `create(GetBatchEntityNamesResponseSchema)` to create a new message.
  */
-export declare const CapabilitySchema: GenMessage<Capability>;
+export declare const GetBatchEntityNamesResponseSchema: GenMessage<GetBatchEntityNamesResponse>;
 /**
- * CapabilityManifest is the full capability advertisement for a specialist agent.
+ * SearchEntityNames request - searches entities by username or display name.
  *
- * @generated from message river.CapabilityManifest
+ * @generated from message river.SearchEntityNamesRequest
  */
-export type CapabilityManifest = Message<"river.CapabilityManifest"> & {
+export type SearchEntityNamesRequest = Message<"river.SearchEntityNamesRequest"> & {
     /**
-     * agent_id is the specialist app_id (20 bytes).
+     * search_query is the text to search for in usernames and display names.
+     * Must be at least 3 characters long.
      *
-     * @generated from field: bytes agent_id = 1;
+     * @generated from field: string search_query = 1;
      */
-    agentId: Uint8Array;
+    searchQuery: string;
     /**
-     * agent_name is a human-readable specialist name.
+     * limit is the maximum number of results to return (default 10, max 20).
      *
-     * @generated from field: string agent_name = 2;
+     * @generated from field: int32 limit = 2;
      */
-    agentName: string;
+    limit: number;
     /**
-     * agent_description is a human-readable specialist description.
+     * entity_type optionally filters by entity type (0=user, 1=app).
+     * If not set, all entity types are returned.
      *
-     * @generated from field: string agent_description = 3;
+     * @generated from field: optional int32 entity_type = 3;
      */
-    agentDescription: string;
+    entityType?: number;
     /**
-     * capabilities declared by this specialist.
+     * offset is the number of results to skip for pagination (default 0).
      *
-     * @generated from field: repeated river.Capability capabilities = 4;
+     * @generated from field: int32 offset = 4;
      */
-    capabilities: Capability[];
+    offset: number;
+};
+/**
+ * Describes the message river.SearchEntityNamesRequest.
+ * Use `create(SearchEntityNamesRequestSchema)` to create a new message.
+ */
+export declare const SearchEntityNamesRequestSchema: GenMessage<SearchEntityNamesRequest>;
+/**
+ * @generated from message river.SearchEntityNamesResponse
+ */
+export type SearchEntityNamesResponse = Message<"river.SearchEntityNamesResponse"> & {
     /**
-     * version is used for cache invalidation.
+     * entities contains the matching entity name records.
      *
-     * @generated from field: string version = 5;
+     * @generated from field: repeated river.EntityNameInfo entities = 1;
      */
-    version: string;
+    entities: EntityNameInfo[];
 };
 /**
- * Describes the message river.CapabilityManifest.
- * Use `create(CapabilityManifestSchema)` to create a new message.
+ * Describes the message river.SearchEntityNamesResponse.
+ * Use `create(SearchEntityNamesResponseSchema)` to create a new message.
  */
-export declare const CapabilityManifestSchema: GenMessage<CapabilityManifest>;
+export declare const SearchEntityNamesResponseSchema: GenMessage<SearchEntityNamesResponse>;
 /**
- * @generated from message river.AppMetadata
+ * InviteEncryptionSession contains a single group session key that can be imported
+ * by the invitee before joining a stream.
+ *
+ * @generated from message river.InviteEncryptionSession
  */
-export type AppMetadata = Message<"river.AppMetadata"> & {
+export type InviteEncryptionSession = Message<"river.InviteEncryptionSession"> & {
     /**
-     * username is the identifier used to mention the bot (e.g., "@mybot").
-     * Must be unique across all bots.
+     * session_id is the group session identifier.
      *
-     * @generated from field: string username = 1;
-     */
-    username: string;
-    /**
-     * @generated from field: string description = 2;
-     */
-    description: string;
-    /**
-     * @generated from field: string image_url = 3;
-     */
-    imageUrl: string;
-    /**
-     * @generated from field: optional string external_url = 4;
+     * @generated from field: string session_id = 1;
      */
-    externalUrl?: string;
+    sessionId: string;
     /**
-     * slash_commands is a list of commands the bot supports.
-     * Maximum of 25 commands per bot.
+     * session_key is the exported session key material.
      *
-     * @generated from field: repeated river.SlashCommand slash_commands = 6;
+     * @generated from field: string session_key = 2;
      */
-    slashCommands: SlashCommand[];
+    sessionKey: string;
+};
+/**
+ * Describes the message river.InviteEncryptionSession.
+ * Use `create(InviteEncryptionSessionSchema)` to create a new message.
+ */
+export declare const InviteEncryptionSessionSchema: GenMessage<InviteEncryptionSession>;
+/**
+ * InviteEncryptionData contains key material shared via invite links so an invitee
+ * can decrypt prior GDM history immediately after joining.
+ *
+ * @generated from message river.InviteEncryptionData
+ */
+export type InviteEncryptionData = Message<"river.InviteEncryptionData"> & {
     /**
-     * display_name is the friendly name shown in chat conversations (e.g., "My Helpful Bot").
-     * Must be non-empty.
+     * stream_id is the 32-byte stream ID these keys belong to.
      *
-     * @generated from field: string display_name = 7;
+     * @generated from field: bytes stream_id = 1;
      */
-    displayName: string;
+    streamId: Uint8Array;
     /**
-     * motto is a short tagline or slogan for the bot.
+     * algorithm is the group encryption algorithm identifier.
      *
-     * @generated from field: string motto = 8;
+     * @generated from field: string algorithm = 2;
      */
-    motto: string;
+    algorithm: string;
     /**
-     * capabilities is a list of specialist capabilities supported by the app.
+     * sessions is the list of group session keys to import.
      *
-     * @generated from field: repeated river.Capability capabilities = 9;
+     * @generated from field: repeated river.InviteEncryptionSession sessions = 3;
      */
-    capabilities: Capability[];
+    sessions: InviteEncryptionSession[];
 };
 /**
- * Describes the message river.AppMetadata.
- * Use `create(AppMetadataSchema)` to create a new message.
+ * Describes the message river.InviteEncryptionData.
+ * Use `create(InviteEncryptionDataSchema)` to create a new message.
  */
-export declare const AppMetadataSchema: GenMessage<AppMetadata>;
+export declare const InviteEncryptionDataSchema: GenMessage<InviteEncryptionData>;
 /**
- * AppMetadataUpdate represents a partial update to app metadata
+ * CreateInviteLink - creates a new invite link for a stream
  *
- * @generated from message river.AppMetadataUpdate
+ * @generated from message river.CreateInviteLinkRequest
  */
-export type AppMetadataUpdate = Message<"river.AppMetadataUpdate"> & {
+export type CreateInviteLinkRequest = Message<"river.CreateInviteLinkRequest"> & {
     /**
-     * All fields are optional for partial updates
+     * stream_id is the 32-byte stream ID
      *
-     * @generated from field: optional string username = 1;
-     */
-    username?: string;
-    /**
-     * @generated from field: optional string description = 2;
-     */
-    description?: string;
-    /**
-     * @generated from field: optional string image_url = 3;
+     * @generated from field: bytes stream_id = 1;
      */
-    imageUrl?: string;
+    streamId: Uint8Array;
     /**
-     * @generated from field: optional string external_url = 4;
+     * invite_encryption_data contains group session keys that the invitee must
+     * import before joining.
+     *
+     * @generated from field: river.InviteEncryptionData invite_encryption_data = 2;
      */
-    externalUrl?: string;
+    inviteEncryptionData?: InviteEncryptionData;
     /**
-     * @generated from field: repeated river.SlashCommand slash_commands = 6;
+     * channel_properties contains the GDM channel properties (name, topic, image)
+     * so the invitee can display them before joining.
+     *
+     * @generated from field: optional river.ChannelProperties channel_properties = 3;
      */
-    slashCommands: SlashCommand[];
+    channelProperties?: ChannelProperties;
+};
+/**
+ * Describes the message river.CreateInviteLinkRequest.
+ * Use `create(CreateInviteLinkRequestSchema)` to create a new message.
+ */
+export declare const CreateInviteLinkRequestSchema: GenMessage<CreateInviteLinkRequest>;
+/**
+ * @generated from message river.CreateInviteLinkResponse
+ */
+export type CreateInviteLinkResponse = Message<"river.CreateInviteLinkResponse"> & {
     /**
-     * @generated from field: optional string display_name = 7;
+     * invite_code is the 16-character base64url-safe invite code
+     *
+     * @generated from field: string invite_code = 1;
      */
-    displayName?: string;
+    inviteCode: string;
+};
+/**
+ * Describes the message river.CreateInviteLinkResponse.
+ * Use `create(CreateInviteLinkResponseSchema)` to create a new message.
+ */
+export declare const CreateInviteLinkResponseSchema: GenMessage<CreateInviteLinkResponse>;
+/**
+ * RevokeInviteLink - invalidates the current invite link
+ *
+ * @generated from message river.RevokeInviteLinkRequest
+ */
+export type RevokeInviteLinkRequest = Message<"river.RevokeInviteLinkRequest"> & {
     /**
-     * @generated from field: optional string motto = 8;
+     * stream_id is the 32-byte stream ID
+     *
+     * @generated from field: bytes stream_id = 1;
      */
-    motto?: string;
+    streamId: Uint8Array;
+};
+/**
+ * Describes the message river.RevokeInviteLinkRequest.
+ * Use `create(RevokeInviteLinkRequestSchema)` to create a new message.
+ */
+export declare const RevokeInviteLinkRequestSchema: GenMessage<RevokeInviteLinkRequest>;
+/**
+ * @generated from message river.RevokeInviteLinkResponse
+ */
+export type RevokeInviteLinkResponse = Message<"river.RevokeInviteLinkResponse"> & {};
+/**
+ * Describes the message river.RevokeInviteLinkResponse.
+ * Use `create(RevokeInviteLinkResponseSchema)` to create a new message.
+ */
+export declare const RevokeInviteLinkResponseSchema: GenMessage<RevokeInviteLinkResponse>;
+/**
+ * RedeemInviteLink - validates invite code and returns signed payload.
+ * The stream ID is determined by the invite code lookup.
+ *
+ * @generated from message river.RedeemInviteLinkRequest
+ */
+export type RedeemInviteLinkRequest = Message<"river.RedeemInviteLinkRequest"> & {
     /**
-     * @generated from field: repeated river.Capability capabilities = 9;
+     * invite_code is the 16-character invite code to redeem
+     *
+     * @generated from field: string invite_code = 1;
      */
-    capabilities: Capability[];
+    inviteCode: string;
 };
 /**
- * Describes the message river.AppMetadataUpdate.
- * Use `create(AppMetadataUpdateSchema)` to create a new message.
+ * Describes the message river.RedeemInviteLinkRequest.
+ * Use `create(RedeemInviteLinkRequestSchema)` to create a new message.
  */
-export declare const AppMetadataUpdateSchema: GenMessage<AppMetadataUpdate>;
+export declare const RedeemInviteLinkRequestSchema: GenMessage<RedeemInviteLinkRequest>;
 /**
- * Update app metadata
- *
- * @generated from message river.UpdateAppMetadataRequest
+ * @generated from message river.RedeemInviteLinkResponse
  */
-export type UpdateAppMetadataRequest = Message<"river.UpdateAppMetadataRequest"> & {
+export type RedeemInviteLinkResponse = Message<"river.RedeemInviteLinkResponse"> & {
     /**
-     * @generated from field: bytes app_id = 1;
+     * signed_payload contains the signed invitation that can be used to join the stream
+     *
+     * @generated from field: river.InviteSignedPayload signed_payload = 1;
      */
-    appId: Uint8Array;
+    signedPayload?: InviteSignedPayload;
     /**
-     * @generated from field: river.AppMetadataUpdate metadata = 2;
+     * invite_encryption_data contains group session keys to import before join.
+     *
+     * @generated from field: river.InviteEncryptionData invite_encryption_data = 2;
      */
-    metadata?: AppMetadataUpdate;
+    inviteEncryptionData?: InviteEncryptionData;
     /**
-     * @generated from field: repeated string update_mask = 3;
+     * channel_properties contains the GDM channel properties from the invite creator.
+     *
+     * @generated from field: optional river.ChannelProperties channel_properties = 3;
      */
-    updateMask: string[];
+    channelProperties?: ChannelProperties;
 };
 /**
- * Describes the message river.UpdateAppMetadataRequest.
- * Use `create(UpdateAppMetadataRequestSchema)` to create a new message.
- */
-export declare const UpdateAppMetadataRequestSchema: GenMessage<UpdateAppMetadataRequest>;
-/**
- * @generated from message river.UpdateAppMetadataResponse
- */
-export type UpdateAppMetadataResponse = Message<"river.UpdateAppMetadataResponse"> & {};
-/**
- * Describes the message river.UpdateAppMetadataResponse.
- * Use `create(UpdateAppMetadataResponseSchema)` to create a new message.
+ * Describes the message river.RedeemInviteLinkResponse.
+ * Use `create(RedeemInviteLinkResponseSchema)` to create a new message.
  */
-export declare const UpdateAppMetadataResponseSchema: GenMessage<UpdateAppMetadataResponse>;
+export declare const RedeemInviteLinkResponseSchema: GenMessage<RedeemInviteLinkResponse>;
 /**
- * Get app metadata
+ * GetInviteLink - retrieves the current active invite link
  *
- * @generated from message river.GetAppMetadataRequest
+ * @generated from message river.GetInviteLinkRequest
  */
-export type GetAppMetadataRequest = Message<"river.GetAppMetadataRequest"> & {
+export type GetInviteLinkRequest = Message<"river.GetInviteLinkRequest"> & {
     /**
-     * @generated from field: bytes app_id = 1;
+     * stream_id is the 32-byte stream ID
+     *
+     * @generated from field: bytes stream_id = 1;
      */
-    appId: Uint8Array;
+    streamId: Uint8Array;
 };
 /**
- * Describes the message river.GetAppMetadataRequest.
- * Use `create(GetAppMetadataRequestSchema)` to create a new message.
+ * Describes the message river.GetInviteLinkRequest.
+ * Use `create(GetInviteLinkRequestSchema)` to create a new message.
  */
-export declare const GetAppMetadataRequestSchema: GenMessage<GetAppMetadataRequest>;
+export declare const GetInviteLinkRequestSchema: GenMessage<GetInviteLinkRequest>;
 /**
- * @generated from message river.GetAppMetadataResponse
+ * @generated from message river.GetInviteLinkResponse
  */
-export type GetAppMetadataResponse = Message<"river.GetAppMetadataResponse"> & {
+export type GetInviteLinkResponse = Message<"river.GetInviteLinkResponse"> & {
     /**
-     * @generated from field: river.AppMetadata metadata = 1;
+     * invite_code is the current active invite code, if any
+     *
+     * @generated from field: optional string invite_code = 1;
      */
-    metadata?: AppMetadata;
+    inviteCode?: string;
+    /**
+     * created_at_epoch_ms is when the invite was created
+     *
+     * @generated from field: optional int64 created_at_epoch_ms = 2;
+     */
+    createdAtEpochMs?: bigint;
 };
 /**
- * Describes the message river.GetAppMetadataResponse.
- * Use `create(GetAppMetadataResponseSchema)` to create a new message.
+ * Describes the message river.GetInviteLinkResponse.
+ * Use `create(GetInviteLinkResponseSchema)` to create a new message.
  */
-export declare const GetAppMetadataResponseSchema: GenMessage<GetAppMetadataResponse>;
+export declare const GetInviteLinkResponseSchema: GenMessage<GetInviteLinkResponse>;
 /**
- * Validate bot username
+ * AppInstallStats contains installation statistics for an app.
  *
- * @generated from message river.ValidateBotNameRequest
+ * @generated from message river.AppInstallStats
  */
-export type ValidateBotNameRequest = Message<"river.ValidateBotNameRequest"> & {
+export type AppInstallStats = Message<"river.AppInstallStats"> & {
     /**
-     * @generated from field: string username = 1;
+     * app_id is the address of the app (20 bytes)
+     *
+     * @generated from field: bytes app_id = 1;
      */
-    username: string;
+    appId: Uint8Array;
+    /**
+     * install_count is the number of active DM/GDM installations
+     *
+     * @generated from field: int32 install_count = 2;
+     */
+    installCount: number;
 };
 /**
- * Describes the message river.ValidateBotNameRequest.
- * Use `create(ValidateBotNameRequestSchema)` to create a new message.
+ * Describes the message river.AppInstallStats.
+ * Use `create(AppInstallStatsSchema)` to create a new message.
  */
-export declare const ValidateBotNameRequestSchema: GenMessage<ValidateBotNameRequest>;
+export declare const AppInstallStatsSchema: GenMessage<AppInstallStats>;
 /**
- * @generated from message river.ValidateBotNameResponse
+ * AppReview represents a single review for an app.
+ *
+ * @generated from message river.AppReview
  */
-export type ValidateBotNameResponse = Message<"river.ValidateBotNameResponse"> & {
+export type AppReview = Message<"river.AppReview"> & {
+    /**
+     * id is the unique review identifier (UUID string)
+     *
+     * @generated from field: string id = 1;
+     */
+    id: string;
+    /**
+     * app_id is the address of the app being reviewed (20 bytes)
+     *
+     * @generated from field: bytes app_id = 2;
+     */
+    appId: Uint8Array;
+    /**
+     * reviewer_address is the wallet address of the reviewer (20 bytes)
+     *
+     * @generated from field: bytes reviewer_address = 3;
+     */
+    reviewerAddress: Uint8Array;
+    /**
+     * rating is the review rating (1-5)
+     *
+     * @generated from field: int32 rating = 4;
+     */
+    rating: number;
+    /**
+     * comment is the optional review text
+     *
+     * @generated from field: string comment = 5;
+     */
+    comment: string;
     /**
-     * @generated from field: bool is_available = 1;
+     * created_at_ms is the creation timestamp in milliseconds since epoch
+     *
+     * @generated from field: int64 created_at_ms = 6;
      */
-    isAvailable: boolean;
+    createdAtMs: bigint;
     /**
-     * @generated from field: string error_message = 2;
+     * is_revoked indicates if the review has been revoked
+     *
+     * @generated from field: bool is_revoked = 7;
      */
-    errorMessage: string;
+    isRevoked: boolean;
 };
 /**
- * Describes the message river.ValidateBotNameResponse.
- * Use `create(ValidateBotNameResponseSchema)` to create a new message.
+ * Describes the message river.AppReview.
+ * Use `create(AppReviewSchema)` to create a new message.
  */
-export declare const ValidateBotNameResponseSchema: GenMessage<ValidateBotNameResponse>;
+export declare const AppReviewSchema: GenMessage<AppReview>;
 /**
- * Set app active status
+ * AppReviewSummary contains aggregated review statistics for an app.
  *
- * @generated from message river.SetAppActiveStatusRequest
+ * @generated from message river.AppReviewSummary
  */
-export type SetAppActiveStatusRequest = Message<"river.SetAppActiveStatusRequest"> & {
+export type AppReviewSummary = Message<"river.AppReviewSummary"> & {
     /**
+     * app_id is the address of the app (20 bytes)
+     *
      * @generated from field: bytes app_id = 1;
      */
     appId: Uint8Array;
     /**
-     * @generated from field: bool active = 2;
+     * total_reviews is the total number of reviews (including revoked)
+     *
+     * @generated from field: int32 total_reviews = 2;
      */
-    active: boolean;
-};
-/**
- * Describes the message river.SetAppActiveStatusRequest.
- * Use `create(SetAppActiveStatusRequestSchema)` to create a new message.
- */
-export declare const SetAppActiveStatusRequestSchema: GenMessage<SetAppActiveStatusRequest>;
-/**
- * @generated from message river.SetAppActiveStatusResponse
- */
-export type SetAppActiveStatusResponse = Message<"river.SetAppActiveStatusResponse"> & {};
-/**
- * Describes the message river.SetAppActiveStatusResponse.
- * Use `create(SetAppActiveStatusResponseSchema)` to create a new message.
- */
-export declare const SetAppActiveStatusResponseSchema: GenMessage<SetAppActiveStatusResponse>;
-/**
- * SetAppPromotedStatusRequest sets the promoted status of an app.
- *
- * @generated from message river.SetAppPromotedStatusRequest
- */
-export type SetAppPromotedStatusRequest = Message<"river.SetAppPromotedStatusRequest"> & {
+    totalReviews: number;
     /**
-     * app_id is the address of the app (20 bytes)
+     * active_reviews is the number of non-revoked reviews
      *
-     * @generated from field: bytes app_id = 1;
+     * @generated from field: int32 active_reviews = 3;
      */
-    appId: Uint8Array;
+    activeReviews: number;
     /**
-     * promoted indicates whether the app should be discoverable in the catalog
+     * average_rating is the average rating from active reviews
      *
-     * @generated from field: bool promoted = 2;
+     * @generated from field: float average_rating = 4;
      */
-    promoted: boolean;
+    averageRating: number;
 };
 /**
- * Describes the message river.SetAppPromotedStatusRequest.
- * Use `create(SetAppPromotedStatusRequestSchema)` to create a new message.
- */
-export declare const SetAppPromotedStatusRequestSchema: GenMessage<SetAppPromotedStatusRequest>;
-/**
- * @generated from message river.SetAppPromotedStatusResponse
- */
-export type SetAppPromotedStatusResponse = Message<"river.SetAppPromotedStatusResponse"> & {};
-/**
- * Describes the message river.SetAppPromotedStatusResponse.
- * Use `create(SetAppPromotedStatusResponseSchema)` to create a new message.
+ * Describes the message river.AppReviewSummary.
+ * Use `create(AppReviewSummarySchema)` to create a new message.
  */
-export declare const SetAppPromotedStatusResponseSchema: GenMessage<SetAppPromotedStatusResponse>;
+export declare const AppReviewSummarySchema: GenMessage<AppReviewSummary>;
 /**
- * SetAppVerifiedStatusRequest sets the verified status of an app.
+ * AppInfoFull contains complete app information for discovery.
  *
- * @generated from message river.SetAppVerifiedStatusRequest
+ * @generated from message river.AppInfoFull
  */
-export type SetAppVerifiedStatusRequest = Message<"river.SetAppVerifiedStatusRequest"> & {
+export type AppInfoFull = Message<"river.AppInfoFull"> & {
     /**
-     * app_id is the address of the app (20 bytes)
+     * app_id is the address of the app (20 bytes, primary identifier)
      *
      * @generated from field: bytes app_id = 1;
      */
     appId: Uint8Array;
     /**
-     * verified indicates whether the app has been reviewed and approved by admins
+     * owner is the owner address (20 bytes)
      *
-     * @generated from field: bool verified = 2;
+     * @generated from field: bytes owner = 2;
      */
-    verified: boolean;
-};
-/**
- * Describes the message river.SetAppVerifiedStatusRequest.
- * Use `create(SetAppVerifiedStatusRequestSchema)` to create a new message.
- */
-export declare const SetAppVerifiedStatusRequestSchema: GenMessage<SetAppVerifiedStatusRequest>;
-/**
- * @generated from message river.SetAppVerifiedStatusResponse
- */
-export type SetAppVerifiedStatusResponse = Message<"river.SetAppVerifiedStatusResponse"> & {};
-/**
- * Describes the message river.SetAppVerifiedStatusResponse.
- * Use `create(SetAppVerifiedStatusResponseSchema)` to create a new message.
- */
-export declare const SetAppVerifiedStatusResponseSchema: GenMessage<SetAppVerifiedStatusResponse>;
-/**
- * SetUserName allows users to set or update their username and display name.
- *
- * @generated from message river.SetUserNameRequest
- */
-export type SetUserNameRequest = Message<"river.SetUserNameRequest"> & {
+    owner: Uint8Array;
     /**
-     * username is the new username to set for the authenticated user.
+     * metadata contains the app's profile data
      *
-     * @generated from field: string username = 1;
+     * @generated from field: river.AppMetadata metadata = 3;
      */
-    username: string;
+    metadata?: AppMetadata;
     /**
-     * display_name is the friendly name shown in chat.
+     * install_stats contains installation statistics
      *
-     * @generated from field: string display_name = 2;
+     * @generated from field: river.AppInstallStats install_stats = 4;
      */
-    displayName: string;
+    installStats?: AppInstallStats;
+    /**
+     * review_summary contains aggregated review data
+     *
+     * @generated from field: river.AppReviewSummary review_summary = 5;
+     */
+    reviewSummary?: AppReviewSummary;
+    /**
+     * is_active indicates whether the app is currently active (published)
+     *
+     * @generated from field: bool is_active = 6;
+     */
+    isActive: boolean;
+    /**
+     * is_promoted indicates whether the app is discoverable in the catalog
+     *
+     * @generated from field: bool is_promoted = 7;
+     */
+    isPromoted: boolean;
+    /**
+     * is_verified indicates whether the app has been reviewed and approved by admins
+     *
+     * @generated from field: bool is_verified = 8;
+     */
+    isVerified: boolean;
+    /**
+     * supported_apis lists the optional APIs this app has declared support for
+     *
+     * @generated from field: repeated river.SupportedApi supported_apis = 9;
+     */
+    supportedApis: SupportedApi[];
 };
 /**
- * Describes the message river.SetUserNameRequest.
- * Use `create(SetUserNameRequestSchema)` to create a new message.
- */
-export declare const SetUserNameRequestSchema: GenMessage<SetUserNameRequest>;
-/**
- * @generated from message river.SetUserNameResponse
- */
-export type SetUserNameResponse = Message<"river.SetUserNameResponse"> & {};
-/**
- * Describes the message river.SetUserNameResponse.
- * Use `create(SetUserNameResponseSchema)` to create a new message.
+ * Describes the message river.AppInfoFull.
+ * Use `create(AppInfoFullSchema)` to create a new message.
  */
-export declare const SetUserNameResponseSchema: GenMessage<SetUserNameResponse>;
+export declare const AppInfoFullSchema: GenMessage<AppInfoFull>;
 /**
- * GetEntityName request - retrieves username for a single entity.
+ * ListRegisteredAppsRequest retrieves registered apps with optional filters.
  *
- * @generated from message river.GetEntityNameRequest
+ * @generated from message river.ListRegisteredAppsRequest
  */
-export type GetEntityNameRequest = Message<"river.GetEntityNameRequest"> & {
+export type ListRegisteredAppsRequest = Message<"river.ListRegisteredAppsRequest"> & {
     /**
-     * entity_id is the address of the user or app to look up
+     * limit is the maximum number of apps to return
      *
-     * @generated from field: bytes entity_id = 1;
+     * @generated from field: int32 limit = 1;
      */
-    entityId: Uint8Array;
+    limit: number;
+    /**
+     * offset is the number of apps to skip for pagination
+     *
+     * @generated from field: int32 offset = 2;
+     */
+    offset: number;
+    /**
+     * active_only filters to only return active (published) apps
+     *
+     * @generated from field: bool active_only = 3;
+     */
+    activeOnly: boolean;
+    /**
+     * owner_address filters by owner - for "my apps" view (20 bytes)
+     *
+     * @generated from field: optional bytes owner_address = 4;
+     */
+    ownerAddress?: Uint8Array;
+    /**
+     * stream_id filters by stream - for apps in a DM/GDM (32 bytes)
+     *
+     * @generated from field: optional bytes stream_id = 5;
+     */
+    streamId?: Uint8Array;
+    /**
+     * promoted_only filters to only return promoted (discoverable) apps
+     *
+     * @generated from field: bool promoted_only = 6;
+     */
+    promotedOnly: boolean;
+    /**
+     * search_query searches apps by display_name and description (case-insensitive)
+     *
+     * @generated from field: optional string search_query = 7;
+     */
+    searchQuery?: string;
 };
 /**
- * Describes the message river.GetEntityNameRequest.
- * Use `create(GetEntityNameRequestSchema)` to create a new message.
+ * Describes the message river.ListRegisteredAppsRequest.
+ * Use `create(ListRegisteredAppsRequestSchema)` to create a new message.
  */
-export declare const GetEntityNameRequestSchema: GenMessage<GetEntityNameRequest>;
+export declare const ListRegisteredAppsRequestSchema: GenMessage<ListRegisteredAppsRequest>;
 /**
- * @generated from message river.GetEntityNameResponse
+ * @generated from message river.ListRegisteredAppsResponse
  */
-export type GetEntityNameResponse = Message<"river.GetEntityNameResponse"> & {
+export type ListRegisteredAppsResponse = Message<"river.ListRegisteredAppsResponse"> & {
     /**
-     * username is the entity's chosen username
+     * apps is the list of matching apps
      *
-     * @generated from field: string username = 1;
+     * @generated from field: repeated river.AppInfoFull apps = 1;
      */
-    username: string;
+    apps: AppInfoFull[];
     /**
-     * display_name is the entity's friendly display name
+     * total_count is the total number of matching apps (for pagination)
      *
-     * @generated from field: string display_name = 2;
+     * @generated from field: int32 total_count = 2;
      */
-    displayName: string;
+    totalCount: number;
+};
+/**
+ * Describes the message river.ListRegisteredAppsResponse.
+ * Use `create(ListRegisteredAppsResponseSchema)` to create a new message.
+ */
+export declare const ListRegisteredAppsResponseSchema: GenMessage<ListRegisteredAppsResponse>;
+/**
+ * GetBulkAppDataRequest retrieves full app data for multiple apps.
+ *
+ * @generated from message river.GetBulkAppDataRequest
+ */
+export type GetBulkAppDataRequest = Message<"river.GetBulkAppDataRequest"> & {
     /**
-     * entity_type indicates whether this is a user (0) or app (1)
+     * app_ids is the list of app addresses to look up (each 20 bytes)
      *
-     * @generated from field: int32 entity_type = 3;
+     * @generated from field: repeated bytes app_ids = 1;
      */
-    entityType: number;
+    appIds: Uint8Array[];
 };
 /**
- * Describes the message river.GetEntityNameResponse.
- * Use `create(GetEntityNameResponseSchema)` to create a new message.
+ * Describes the message river.GetBulkAppDataRequest.
+ * Use `create(GetBulkAppDataRequestSchema)` to create a new message.
  */
-export declare const GetEntityNameResponseSchema: GenMessage<GetEntityNameResponse>;
+export declare const GetBulkAppDataRequestSchema: GenMessage<GetBulkAppDataRequest>;
 /**
- * GetBatchEntityNames request - retrieves usernames for multiple entities.
- *
- * @generated from message river.GetBatchEntityNamesRequest
+ * @generated from message river.GetBulkAppDataResponse
  */
-export type GetBatchEntityNamesRequest = Message<"river.GetBatchEntityNamesRequest"> & {
+export type GetBulkAppDataResponse = Message<"river.GetBulkAppDataResponse"> & {
     /**
-     * entity_ids is the list of addresses to look up
+     * apps is the list of app data for found apps
      *
-     * @generated from field: repeated bytes entity_ids = 1;
+     * @generated from field: repeated river.AppInfoFull apps = 1;
      */
-    entityIds: Uint8Array[];
+    apps: AppInfoFull[];
 };
 /**
- * Describes the message river.GetBatchEntityNamesRequest.
- * Use `create(GetBatchEntityNamesRequestSchema)` to create a new message.
+ * Describes the message river.GetBulkAppDataResponse.
+ * Use `create(GetBulkAppDataResponseSchema)` to create a new message.
  */
-export declare const GetBatchEntityNamesRequestSchema: GenMessage<GetBatchEntityNamesRequest>;
+export declare const GetBulkAppDataResponseSchema: GenMessage<GetBulkAppDataResponse>;
 /**
- * EntityNameInfo contains the name information for a single entity.
+ * GetAppInstallStatsRequest retrieves installation stats for a single app.
  *
- * @generated from message river.EntityNameInfo
+ * @generated from message river.GetAppInstallStatsRequest
  */
-export type EntityNameInfo = Message<"river.EntityNameInfo"> & {
-    /**
-     * entity_id is the address of the entity
-     *
-     * @generated from field: bytes entity_id = 1;
-     */
-    entityId: Uint8Array;
-    /**
-     * username is the entity's chosen username
-     *
-     * @generated from field: string username = 2;
-     */
-    username: string;
-    /**
-     * display_name is the entity's friendly display name
-     *
-     * @generated from field: string display_name = 3;
-     */
-    displayName: string;
+export type GetAppInstallStatsRequest = Message<"river.GetAppInstallStatsRequest"> & {
     /**
-     * entity_type indicates whether this is a user (0) or app (1)
+     * app_id is the address of the app (20 bytes)
      *
-     * @generated from field: int32 entity_type = 4;
+     * @generated from field: bytes app_id = 1;
      */
-    entityType: number;
+    appId: Uint8Array;
 };
 /**
- * Describes the message river.EntityNameInfo.
- * Use `create(EntityNameInfoSchema)` to create a new message.
+ * Describes the message river.GetAppInstallStatsRequest.
+ * Use `create(GetAppInstallStatsRequestSchema)` to create a new message.
  */
-export declare const EntityNameInfoSchema: GenMessage<EntityNameInfo>;
+export declare const GetAppInstallStatsRequestSchema: GenMessage<GetAppInstallStatsRequest>;
 /**
- * @generated from message river.GetBatchEntityNamesResponse
+ * @generated from message river.GetAppInstallStatsResponse
  */
-export type GetBatchEntityNamesResponse = Message<"river.GetBatchEntityNamesResponse"> & {
+export type GetAppInstallStatsResponse = Message<"river.GetAppInstallStatsResponse"> & {
     /**
-     * entities contains the name info for each found entity.
-     * Entities that have not set usernames will not be included.
+     * stats contains the installation statistics
      *
-     * @generated from field: repeated river.EntityNameInfo entities = 1;
+     * @generated from field: river.AppInstallStats stats = 1;
      */
-    entities: EntityNameInfo[];
+    stats?: AppInstallStats;
 };
 /**
- * Describes the message river.GetBatchEntityNamesResponse.
- * Use `create(GetBatchEntityNamesResponseSchema)` to create a new message.
+ * Describes the message river.GetAppInstallStatsResponse.
+ * Use `create(GetAppInstallStatsResponseSchema)` to create a new message.
  */
-export declare const GetBatchEntityNamesResponseSchema: GenMessage<GetBatchEntityNamesResponse>;
+export declare const GetAppInstallStatsResponseSchema: GenMessage<GetAppInstallStatsResponse>;
 /**
- * SearchEntityNames request - searches entities by username or display name.
+ * GetBulkAppInstallStatsRequest retrieves installation stats for multiple apps.
  *
- * @generated from message river.SearchEntityNamesRequest
+ * @generated from message river.GetBulkAppInstallStatsRequest
  */
-export type SearchEntityNamesRequest = Message<"river.SearchEntityNamesRequest"> & {
-    /**
-     * search_query is the text to search for in usernames and display names.
-     * Must be at least 3 characters long.
-     *
-     * @generated from field: string search_query = 1;
-     */
-    searchQuery: string;
-    /**
-     * limit is the maximum number of results to return (default 10, max 20).
-     *
-     * @generated from field: int32 limit = 2;
-     */
-    limit: number;
-    /**
-     * entity_type optionally filters by entity type (0=user, 1=app).
-     * If not set, all entity types are returned.
-     *
-     * @generated from field: optional int32 entity_type = 3;
-     */
-    entityType?: number;
+export type GetBulkAppInstallStatsRequest = Message<"river.GetBulkAppInstallStatsRequest"> & {
     /**
-     * offset is the number of results to skip for pagination (default 0).
+     * app_ids is the list of app addresses to look up (each 20 bytes)
      *
-     * @generated from field: int32 offset = 4;
+     * @generated from field: repeated bytes app_ids = 1;
      */
-    offset: number;
+    appIds: Uint8Array[];
 };
 /**
- * Describes the message river.SearchEntityNamesRequest.
- * Use `create(SearchEntityNamesRequestSchema)` to create a new message.
+ * Describes the message river.GetBulkAppInstallStatsRequest.
+ * Use `create(GetBulkAppInstallStatsRequestSchema)` to create a new message.
  */
-export declare const SearchEntityNamesRequestSchema: GenMessage<SearchEntityNamesRequest>;
+export declare const GetBulkAppInstallStatsRequestSchema: GenMessage<GetBulkAppInstallStatsRequest>;
 /**
- * @generated from message river.SearchEntityNamesResponse
+ * @generated from message river.GetBulkAppInstallStatsResponse
  */
-export type SearchEntityNamesResponse = Message<"river.SearchEntityNamesResponse"> & {
+export type GetBulkAppInstallStatsResponse = Message<"river.GetBulkAppInstallStatsResponse"> & {
     /**
-     * entities contains the matching entity name records.
+     * stats is a map of app_id (hex string) to installation stats
      *
-     * @generated from field: repeated river.EntityNameInfo entities = 1;
+     * @generated from field: repeated river.AppInstallStats stats = 1;
      */
-    entities: EntityNameInfo[];
+    stats: AppInstallStats[];
 };
 /**
- * Describes the message river.SearchEntityNamesResponse.
- * Use `create(SearchEntityNamesResponseSchema)` to create a new message.
+ * Describes the message river.GetBulkAppInstallStatsResponse.
+ * Use `create(GetBulkAppInstallStatsResponseSchema)` to create a new message.
  */
-export declare const SearchEntityNamesResponseSchema: GenMessage<SearchEntityNamesResponse>;
+export declare const GetBulkAppInstallStatsResponseSchema: GenMessage<GetBulkAppInstallStatsResponse>;
 /**
- * InviteEncryptionSession contains a single group session key that can be imported
- * by the invitee before joining a stream.
+ * SubmitAppReviewRequest creates or updates a review.
  *
- * @generated from message river.InviteEncryptionSession
+ * @generated from message river.SubmitAppReviewRequest
  */
-export type InviteEncryptionSession = Message<"river.InviteEncryptionSession"> & {
+export type SubmitAppReviewRequest = Message<"river.SubmitAppReviewRequest"> & {
     /**
-     * session_id is the group session identifier.
+     * app_id is the address of the app to review (20 bytes)
      *
-     * @generated from field: string session_id = 1;
+     * @generated from field: bytes app_id = 1;
      */
-    sessionId: string;
+    appId: Uint8Array;
     /**
-     * session_key is the exported session key material.
+     * rating is the review rating (1-5)
      *
-     * @generated from field: string session_key = 2;
+     * @generated from field: int32 rating = 2;
      */
-    sessionKey: string;
+    rating: number;
+    /**
+     * comment is the optional review text
+     *
+     * @generated from field: string comment = 3;
+     */
+    comment: string;
 };
 /**
- * Describes the message river.InviteEncryptionSession.
- * Use `create(InviteEncryptionSessionSchema)` to create a new message.
+ * Describes the message river.SubmitAppReviewRequest.
+ * Use `create(SubmitAppReviewRequestSchema)` to create a new message.
  */
-export declare const InviteEncryptionSessionSchema: GenMessage<InviteEncryptionSession>;
+export declare const SubmitAppReviewRequestSchema: GenMessage<SubmitAppReviewRequest>;
 /**
- * InviteEncryptionData contains key material shared via invite links so an invitee
- * can decrypt prior GDM history immediately after joining.
- *
- * @generated from message river.InviteEncryptionData
+ * @generated from message river.SubmitAppReviewResponse
  */
-export type InviteEncryptionData = Message<"river.InviteEncryptionData"> & {
-    /**
-     * stream_id is the 32-byte stream ID these keys belong to.
-     *
-     * @generated from field: bytes stream_id = 1;
-     */
-    streamId: Uint8Array;
-    /**
-     * algorithm is the group encryption algorithm identifier.
-     *
-     * @generated from field: string algorithm = 2;
-     */
-    algorithm: string;
+export type SubmitAppReviewResponse = Message<"river.SubmitAppReviewResponse"> & {
     /**
-     * sessions is the list of group session keys to import.
+     * review_id is the unique identifier of the created/updated review
      *
-     * @generated from field: repeated river.InviteEncryptionSession sessions = 3;
+     * @generated from field: string review_id = 1;
      */
-    sessions: InviteEncryptionSession[];
+    reviewId: string;
 };
 /**
- * Describes the message river.InviteEncryptionData.
- * Use `create(InviteEncryptionDataSchema)` to create a new message.
+ * Describes the message river.SubmitAppReviewResponse.
+ * Use `create(SubmitAppReviewResponseSchema)` to create a new message.
  */
-export declare const InviteEncryptionDataSchema: GenMessage<InviteEncryptionData>;
+export declare const SubmitAppReviewResponseSchema: GenMessage<SubmitAppReviewResponse>;
 /**
- * CreateInviteLink - creates a new invite link for a stream
+ * GetAppReviewsRequest retrieves paginated reviews for an app.
  *
- * @generated from message river.CreateInviteLinkRequest
+ * @generated from message river.GetAppReviewsRequest
  */
-export type CreateInviteLinkRequest = Message<"river.CreateInviteLinkRequest"> & {
+export type GetAppReviewsRequest = Message<"river.GetAppReviewsRequest"> & {
     /**
-     * stream_id is the 32-byte stream ID
+     * app_id is the address of the app (20 bytes)
      *
-     * @generated from field: bytes stream_id = 1;
+     * @generated from field: bytes app_id = 1;
      */
-    streamId: Uint8Array;
+    appId: Uint8Array;
     /**
-     * invite_encryption_data contains group session keys that the invitee must
-     * import before joining.
+     * limit is the maximum number of reviews to return
      *
-     * @generated from field: river.InviteEncryptionData invite_encryption_data = 2;
+     * @generated from field: int32 limit = 2;
      */
-    inviteEncryptionData?: InviteEncryptionData;
+    limit: number;
     /**
-     * channel_properties contains the GDM channel properties (name, topic, image)
-     * so the invitee can display them before joining.
+     * offset is the number of reviews to skip for pagination
      *
-     * @generated from field: optional river.ChannelProperties channel_properties = 3;
+     * @generated from field: int32 offset = 3;
      */
-    channelProperties?: ChannelProperties;
+    offset: number;
 };
 /**
- * Describes the message river.CreateInviteLinkRequest.
- * Use `create(CreateInviteLinkRequestSchema)` to create a new message.
+ * Describes the message river.GetAppReviewsRequest.
+ * Use `create(GetAppReviewsRequestSchema)` to create a new message.
  */
-export declare const CreateInviteLinkRequestSchema: GenMessage<CreateInviteLinkRequest>;
+export declare const GetAppReviewsRequestSchema: GenMessage<GetAppReviewsRequest>;
 /**
- * @generated from message river.CreateInviteLinkResponse
+ * @generated from message river.GetAppReviewsResponse
  */
-export type CreateInviteLinkResponse = Message<"river.CreateInviteLinkResponse"> & {
+export type GetAppReviewsResponse = Message<"river.GetAppReviewsResponse"> & {
     /**
-     * invite_code is the 16-character base64url-safe invite code
+     * reviews is the list of reviews
      *
-     * @generated from field: string invite_code = 1;
+     * @generated from field: repeated river.AppReview reviews = 1;
      */
-    inviteCode: string;
+    reviews: AppReview[];
+    /**
+     * total_count is the total number of reviews (for pagination)
+     *
+     * @generated from field: int32 total_count = 2;
+     */
+    totalCount: number;
 };
 /**
- * Describes the message river.CreateInviteLinkResponse.
- * Use `create(CreateInviteLinkResponseSchema)` to create a new message.
+ * Describes the message river.GetAppReviewsResponse.
+ * Use `create(GetAppReviewsResponseSchema)` to create a new message.
  */
-export declare const CreateInviteLinkResponseSchema: GenMessage<CreateInviteLinkResponse>;
+export declare const GetAppReviewsResponseSchema: GenMessage<GetAppReviewsResponse>;
 /**
- * RevokeInviteLink - invalidates the current invite link
+ * RevokeAppReviewRequest revokes the caller's review for an app.
  *
- * @generated from message river.RevokeInviteLinkRequest
+ * @generated from message river.RevokeAppReviewRequest
  */
-export type RevokeInviteLinkRequest = Message<"river.RevokeInviteLinkRequest"> & {
+export type RevokeAppReviewRequest = Message<"river.RevokeAppReviewRequest"> & {
     /**
-     * stream_id is the 32-byte stream ID
+     * app_id is the address of the app (20 bytes)
      *
-     * @generated from field: bytes stream_id = 1;
+     * @generated from field: bytes app_id = 1;
      */
-    streamId: Uint8Array;
+    appId: Uint8Array;
 };
 /**
- * Describes the message river.RevokeInviteLinkRequest.
- * Use `create(RevokeInviteLinkRequestSchema)` to create a new message.
+ * Describes the message river.RevokeAppReviewRequest.
+ * Use `create(RevokeAppReviewRequestSchema)` to create a new message.
  */
-export declare const RevokeInviteLinkRequestSchema: GenMessage<RevokeInviteLinkRequest>;
+export declare const RevokeAppReviewRequestSchema: GenMessage<RevokeAppReviewRequest>;
 /**
- * @generated from message river.RevokeInviteLinkResponse
+ * @generated from message river.RevokeAppReviewResponse
  */
-export type RevokeInviteLinkResponse = Message<"river.RevokeInviteLinkResponse"> & {};
+export type RevokeAppReviewResponse = Message<"river.RevokeAppReviewResponse"> & {};
 /**
- * Describes the message river.RevokeInviteLinkResponse.
- * Use `create(RevokeInviteLinkResponseSchema)` to create a new message.
+ * Describes the message river.RevokeAppReviewResponse.
+ * Use `create(RevokeAppReviewResponseSchema)` to create a new message.
  */
-export declare const RevokeInviteLinkResponseSchema: GenMessage<RevokeInviteLinkResponse>;
+export declare const RevokeAppReviewResponseSchema: GenMessage<RevokeAppReviewResponse>;
 /**
- * RedeemInviteLink - validates invite code and returns signed payload.
- * The stream ID is determined by the invite code lookup.
+ * GetAppReviewSummaryRequest retrieves review summary for a single app.
  *
- * @generated from message river.RedeemInviteLinkRequest
+ * @generated from message river.GetAppReviewSummaryRequest
  */
-export type RedeemInviteLinkRequest = Message<"river.RedeemInviteLinkRequest"> & {
+export type GetAppReviewSummaryRequest = Message<"river.GetAppReviewSummaryRequest"> & {
     /**
-     * invite_code is the 16-character invite code to redeem
+     * app_id is the address of the app (20 bytes)
      *
-     * @generated from field: string invite_code = 1;
+     * @generated from field: bytes app_id = 1;
      */
-    inviteCode: string;
+    appId: Uint8Array;
 };
 /**
- * Describes the message river.RedeemInviteLinkRequest.
- * Use `create(RedeemInviteLinkRequestSchema)` to create a new message.
+ * Describes the message river.GetAppReviewSummaryRequest.
+ * Use `create(GetAppReviewSummaryRequestSchema)` to create a new message.
  */
-export declare const RedeemInviteLinkRequestSchema: GenMessage<RedeemInviteLinkRequest>;
+export declare const GetAppReviewSummaryRequestSchema: GenMessage<GetAppReviewSummaryRequest>;
 /**
- * @generated from message river.RedeemInviteLinkResponse
+ * @generated from message river.GetAppReviewSummaryResponse
  */
-export type RedeemInviteLinkResponse = Message<"river.RedeemInviteLinkResponse"> & {
-    /**
-     * signed_payload contains the signed invitation that can be used to join the stream
-     *
-     * @generated from field: river.InviteSignedPayload signed_payload = 1;
-     */
-    signedPayload?: InviteSignedPayload;
-    /**
-     * invite_encryption_data contains group session keys to import before join.
-     *
-     * @generated from field: river.InviteEncryptionData invite_encryption_data = 2;
-     */
-    inviteEncryptionData?: InviteEncryptionData;
+export type GetAppReviewSummaryResponse = Message<"river.GetAppReviewSummaryResponse"> & {
     /**
-     * channel_properties contains the GDM channel properties from the invite creator.
+     * summary contains the aggregated review statistics
      *
-     * @generated from field: optional river.ChannelProperties channel_properties = 3;
+     * @generated from field: river.AppReviewSummary summary = 1;
      */
-    channelProperties?: ChannelProperties;
+    summary?: AppReviewSummary;
 };
 /**
- * Describes the message river.RedeemInviteLinkResponse.
- * Use `create(RedeemInviteLinkResponseSchema)` to create a new message.
+ * Describes the message river.GetAppReviewSummaryResponse.
+ * Use `create(GetAppReviewSummaryResponseSchema)` to create a new message.
  */
-export declare const RedeemInviteLinkResponseSchema: GenMessage<RedeemInviteLinkResponse>;
+export declare const GetAppReviewSummaryResponseSchema: GenMessage<GetAppReviewSummaryResponse>;
 /**
- * GetInviteLink - retrieves the current active invite link
+ * GetBulkAppReviewSummariesRequest retrieves review summaries for multiple apps.
  *
- * @generated from message river.GetInviteLinkRequest
+ * @generated from message river.GetBulkAppReviewSummariesRequest
  */
-export type GetInviteLinkRequest = Message<"river.GetInviteLinkRequest"> & {
+export type GetBulkAppReviewSummariesRequest = Message<"river.GetBulkAppReviewSummariesRequest"> & {
     /**
-     * stream_id is the 32-byte stream ID
+     * app_ids is the list of app addresses to look up (each 20 bytes)
      *
-     * @generated from field: bytes stream_id = 1;
+     * @generated from field: repeated bytes app_ids = 1;
      */
-    streamId: Uint8Array;
+    appIds: Uint8Array[];
 };
 /**
- * Describes the message river.GetInviteLinkRequest.
- * Use `create(GetInviteLinkRequestSchema)` to create a new message.
+ * Describes the message river.GetBulkAppReviewSummariesRequest.
+ * Use `create(GetBulkAppReviewSummariesRequestSchema)` to create a new message.
  */
-export declare const GetInviteLinkRequestSchema: GenMessage<GetInviteLinkRequest>;
+export declare const GetBulkAppReviewSummariesRequestSchema: GenMessage<GetBulkAppReviewSummariesRequest>;
 /**
- * @generated from message river.GetInviteLinkResponse
+ * @generated from message river.GetBulkAppReviewSummariesResponse
  */
-export type GetInviteLinkResponse = Message<"river.GetInviteLinkResponse"> & {
-    /**
-     * invite_code is the current active invite code, if any
-     *
-     * @generated from field: optional string invite_code = 1;
-     */
-    inviteCode?: string;
+export type GetBulkAppReviewSummariesResponse = Message<"river.GetBulkAppReviewSummariesResponse"> & {
     /**
-     * created_at_epoch_ms is when the invite was created
+     * summaries is the list of review summaries for found apps
      *
-     * @generated from field: optional int64 created_at_epoch_ms = 2;
+     * @generated from field: repeated river.AppReviewSummary summaries = 1;
      */
-    createdAtEpochMs?: bigint;
+    summaries: AppReviewSummary[];
 };
 /**
- * Describes the message river.GetInviteLinkResponse.
- * Use `create(GetInviteLinkResponseSchema)` to create a new message.
+ * Describes the message river.GetBulkAppReviewSummariesResponse.
+ * Use `create(GetBulkAppReviewSummariesResponseSchema)` to create a new message.
  */
-export declare const GetInviteLinkResponseSchema: GenMessage<GetInviteLinkResponse>;
+export declare const GetBulkAppReviewSummariesResponseSchema: GenMessage<GetBulkAppReviewSummariesResponse>;
 /**
- * AppInstallStats contains installation statistics for an app.
+ * GetAppPositionsRequest retrieves positions for the authenticated user from a single app.
  *
- * @generated from message river.AppInstallStats
+ * @generated from message river.GetAppPositionsRequest
  */
-export type AppInstallStats = Message<"river.AppInstallStats"> & {
+export type GetAppPositionsRequest = Message<"river.GetAppPositionsRequest"> & {
     /**
      * app_id is the address of the app (20 bytes)
      *
      * @generated from field: bytes app_id = 1;
      */
     appId: Uint8Array;
-    /**
-     * install_count is the number of active DM/GDM installations
-     *
-     * @generated from field: int32 install_count = 2;
-     */
-    installCount: number;
 };
 /**
- * Describes the message river.AppInstallStats.
- * Use `create(AppInstallStatsSchema)` to create a new message.
+ * Describes the message river.GetAppPositionsRequest.
+ * Use `create(GetAppPositionsRequestSchema)` to create a new message.
  */
-export declare const AppInstallStatsSchema: GenMessage<AppInstallStats>;
+export declare const GetAppPositionsRequestSchema: GenMessage<GetAppPositionsRequest>;
 /**
- * AppReview represents a single review for an app.
- *
- * @generated from message river.AppReview
+ * @generated from message river.GetAppPositionsResponse
  */
-export type AppReview = Message<"river.AppReview"> & {
-    /**
-     * id is the unique review identifier (UUID string)
-     *
-     * @generated from field: string id = 1;
-     */
-    id: string;
+export type GetAppPositionsResponse = Message<"river.GetAppPositionsResponse"> & {
     /**
-     * app_id is the address of the app being reviewed (20 bytes)
+     * app_id is the address of the app (20 bytes)
      *
-     * @generated from field: bytes app_id = 2;
+     * @generated from field: bytes app_id = 1;
      */
     appId: Uint8Array;
     /**
-     * reviewer_address is the wallet address of the reviewer (20 bytes)
-     *
-     * @generated from field: bytes reviewer_address = 3;
-     */
-    reviewerAddress: Uint8Array;
-    /**
-     * rating is the review rating (1-5)
-     *
-     * @generated from field: int32 rating = 4;
-     */
-    rating: number;
-    /**
-     * comment is the optional review text
+     * positions contains the position data from the bot
      *
-     * @generated from field: string comment = 5;
+     * @generated from field: river.PositionsResponse positions = 2;
      */
-    comment: string;
+    positions?: PositionsResponse;
+};
+/**
+ * Describes the message river.GetAppPositionsResponse.
+ * Use `create(GetAppPositionsResponseSchema)` to create a new message.
+ */
+export declare const GetAppPositionsResponseSchema: GenMessage<GetAppPositionsResponse>;
+/**
+ * GetBatchAppPositionsRequest retrieves positions from multiple apps.
+ *
+ * @generated from message river.GetBatchAppPositionsRequest
+ */
+export type GetBatchAppPositionsRequest = Message<"river.GetBatchAppPositionsRequest"> & {
     /**
-     * created_at_ms is the creation timestamp in milliseconds since epoch
+     * app_ids is the list of app addresses to query (each 20 bytes)
+     * Maximum 10 apps per request (enforced server-side)
      *
-     * @generated from field: int64 created_at_ms = 6;
+     * @generated from field: repeated bytes app_ids = 1;
      */
-    createdAtMs: bigint;
+    appIds: Uint8Array[];
+};
+/**
+ * Describes the message river.GetBatchAppPositionsRequest.
+ * Use `create(GetBatchAppPositionsRequestSchema)` to create a new message.
+ */
+export declare const GetBatchAppPositionsRequestSchema: GenMessage<GetBatchAppPositionsRequest>;
+/**
+ * @generated from message river.GetBatchAppPositionsResponse
+ */
+export type GetBatchAppPositionsResponse = Message<"river.GetBatchAppPositionsResponse"> & {
     /**
-     * is_revoked indicates if the review has been revoked
+     * entries contains position data for each requested app
      *
-     * @generated from field: bool is_revoked = 7;
+     * @generated from field: repeated river.AppPositionsEntry entries = 1;
      */
-    isRevoked: boolean;
+    entries: AppPositionsEntry[];
 };
 /**
- * Describes the message river.AppReview.
- * Use `create(AppReviewSchema)` to create a new message.
+ * Describes the message river.GetBatchAppPositionsResponse.
+ * Use `create(GetBatchAppPositionsResponseSchema)` to create a new message.
  */
-export declare const AppReviewSchema: GenMessage<AppReview>;
+export declare const GetBatchAppPositionsResponseSchema: GenMessage<GetBatchAppPositionsResponse>;
 /**
- * AppReviewSummary contains aggregated review statistics for an app.
+ * AppPositionsEntry contains position data for a single app in a batch response.
  *
- * @generated from message river.AppReviewSummary
+ * @generated from message river.AppPositionsEntry
  */
-export type AppReviewSummary = Message<"river.AppReviewSummary"> & {
+export type AppPositionsEntry = Message<"river.AppPositionsEntry"> & {
     /**
      * app_id is the address of the app (20 bytes)
      *
@@ -1796,918 +1956,972 @@ export type AppReviewSummary = Message<"river.AppReviewSummary"> & {
      */
     appId: Uint8Array;
     /**
-     * total_reviews is the total number of reviews (including revoked)
+     * positions contains the position data from the bot
      *
-     * @generated from field: int32 total_reviews = 2;
+     * @generated from field: river.PositionsResponse positions = 2;
      */
-    totalReviews: number;
+    positions?: PositionsResponse;
     /**
-     * active_reviews is the number of non-revoked reviews
+     * error contains an error message if this specific app failed
      *
-     * @generated from field: int32 active_reviews = 3;
+     * @generated from field: optional string error = 3;
      */
-    activeReviews: number;
+    error?: string;
+};
+/**
+ * Describes the message river.AppPositionsEntry.
+ * Use `create(AppPositionsEntrySchema)` to create a new message.
+ */
+export declare const AppPositionsEntrySchema: GenMessage<AppPositionsEntry>;
+/**
+ * GetBatchAppPnlRequest retrieves PNL data from multiple apps for multiple users.
+ *
+ * @generated from message river.GetBatchAppPnlRequest
+ */
+export type GetBatchAppPnlRequest = Message<"river.GetBatchAppPnlRequest"> & {
     /**
-     * average_rating is the average rating from active reviews
+     * app_ids is the list of app addresses to query (each 20 bytes).
+     * If empty, all active apps supporting the PNL API are queried.
+     * Maximum 10 apps per request (enforced server-side).
      *
-     * @generated from field: float average_rating = 4;
+     * @generated from field: repeated bytes app_ids = 1;
      */
-    averageRating: number;
+    appIds: Uint8Array[];
+    /**
+     * user_ids is the list of user addresses to query (each 20 bytes)
+     * Maximum 100 users per request (enforced server-side)
+     *
+     * @generated from field: repeated bytes user_ids = 2;
+     */
+    userIds: Uint8Array[];
 };
 /**
- * Describes the message river.AppReviewSummary.
- * Use `create(AppReviewSummarySchema)` to create a new message.
+ * Describes the message river.GetBatchAppPnlRequest.
+ * Use `create(GetBatchAppPnlRequestSchema)` to create a new message.
  */
-export declare const AppReviewSummarySchema: GenMessage<AppReviewSummary>;
+export declare const GetBatchAppPnlRequestSchema: GenMessage<GetBatchAppPnlRequest>;
 /**
- * AppInfoFull contains complete app information for discovery.
- *
- * @generated from message river.AppInfoFull
+ * @generated from message river.GetBatchAppPnlResponse
  */
-export type AppInfoFull = Message<"river.AppInfoFull"> & {
+export type GetBatchAppPnlResponse = Message<"river.GetBatchAppPnlResponse"> & {
     /**
-     * app_id is the address of the app (20 bytes, primary identifier)
+     * users contains aggregated PNL data for each requested user
      *
-     * @generated from field: bytes app_id = 1;
+     * @generated from field: repeated river.UserAggregatedPnl users = 1;
      */
-    appId: Uint8Array;
+    users: UserAggregatedPnl[];
+};
+/**
+ * Describes the message river.GetBatchAppPnlResponse.
+ * Use `create(GetBatchAppPnlResponseSchema)` to create a new message.
+ */
+export declare const GetBatchAppPnlResponseSchema: GenMessage<GetBatchAppPnlResponse>;
+/**
+ * UserAggregatedPnl contains aggregated PNL totals for a single user across all queried apps.
+ *
+ * @generated from message river.UserAggregatedPnl
+ */
+export type UserAggregatedPnl = Message<"river.UserAggregatedPnl"> & {
     /**
-     * owner is the owner address (20 bytes)
+     * user_id is the address of the user (20 bytes)
      *
-     * @generated from field: bytes owner = 2;
+     * @generated from field: bytes user_id = 1;
      */
-    owner: Uint8Array;
+    userId: Uint8Array;
     /**
-     * metadata contains the app's profile data
+     * total_realized_pnl is the sum of realized PNL across all apps (string for precision)
      *
-     * @generated from field: river.AppMetadata metadata = 3;
+     * @generated from field: string total_realized_pnl = 2;
      */
-    metadata?: AppMetadata;
+    totalRealizedPnl: string;
     /**
-     * install_stats contains installation statistics
+     * total_unrealized_pnl is the sum of unrealized PNL across all apps (string for precision)
      *
-     * @generated from field: river.AppInstallStats install_stats = 4;
+     * @generated from field: string total_unrealized_pnl = 3;
      */
-    installStats?: AppInstallStats;
+    totalUnrealizedPnl: string;
     /**
-     * review_summary contains aggregated review data
+     * total_pnl is the sum of total PNL across all apps (string for precision)
      *
-     * @generated from field: river.AppReviewSummary review_summary = 5;
+     * @generated from field: string total_pnl = 4;
      */
-    reviewSummary?: AppReviewSummary;
+    totalPnl: string;
     /**
-     * is_active indicates whether the app is currently active (published)
+     * total_account_value is the sum of account values across all apps (string for precision)
      *
-     * @generated from field: bool is_active = 6;
+     * @generated from field: string total_account_value = 5;
      */
-    isActive: boolean;
+    totalAccountValue: string;
     /**
-     * is_promoted indicates whether the app is discoverable in the catalog
+     * total_volume is the sum of volume across all apps (string for precision)
      *
-     * @generated from field: bool is_promoted = 7;
+     * @generated from field: string total_volume = 6;
      */
-    isPromoted: boolean;
+    totalVolume: string;
     /**
-     * is_verified indicates whether the app has been reviewed and approved by admins
+     * app_entries contains per-app PNL breakdowns
      *
-     * @generated from field: bool is_verified = 8;
+     * @generated from field: repeated river.AppPnlEntry app_entries = 7;
      */
-    isVerified: boolean;
+    appEntries: AppPnlEntry[];
 };
 /**
- * Describes the message river.AppInfoFull.
- * Use `create(AppInfoFullSchema)` to create a new message.
+ * Describes the message river.UserAggregatedPnl.
+ * Use `create(UserAggregatedPnlSchema)` to create a new message.
  */
-export declare const AppInfoFullSchema: GenMessage<AppInfoFull>;
+export declare const UserAggregatedPnlSchema: GenMessage<UserAggregatedPnl>;
 /**
- * ListRegisteredAppsRequest retrieves registered apps with optional filters.
+ * AppPnlEntry contains PNL data for a single user from a single app.
  *
- * @generated from message river.ListRegisteredAppsRequest
+ * @generated from message river.AppPnlEntry
  */
-export type ListRegisteredAppsRequest = Message<"river.ListRegisteredAppsRequest"> & {
-    /**
-     * limit is the maximum number of apps to return
-     *
-     * @generated from field: int32 limit = 1;
-     */
-    limit: number;
+export type AppPnlEntry = Message<"river.AppPnlEntry"> & {
     /**
-     * offset is the number of apps to skip for pagination
+     * app_id is the address of the app (20 bytes)
      *
-     * @generated from field: int32 offset = 2;
+     * @generated from field: bytes app_id = 1;
      */
-    offset: number;
+    appId: Uint8Array;
     /**
-     * active_only filters to only return active (published) apps
+     * wallet_address is the wallet address used on this app (hex string)
      *
-     * @generated from field: bool active_only = 3;
+     * @generated from field: string wallet_address = 2;
      */
-    activeOnly: boolean;
+    walletAddress: string;
     /**
-     * owner_address filters by owner - for "my apps" view (20 bytes)
+     * realized_pnl from this app (string for precision)
      *
-     * @generated from field: optional bytes owner_address = 4;
+     * @generated from field: string realized_pnl = 3;
      */
-    ownerAddress?: Uint8Array;
+    realizedPnl: string;
     /**
-     * stream_id filters by stream - for apps in a DM/GDM (32 bytes)
+     * unrealized_pnl from this app (string for precision)
      *
-     * @generated from field: optional bytes stream_id = 5;
+     * @generated from field: string unrealized_pnl = 4;
      */
-    streamId?: Uint8Array;
+    unrealizedPnl: string;
     /**
-     * promoted_only filters to only return promoted (discoverable) apps
+     * total_pnl from this app (string for precision)
      *
-     * @generated from field: bool promoted_only = 6;
+     * @generated from field: string total_pnl = 5;
      */
-    promotedOnly: boolean;
+    totalPnl: string;
     /**
-     * search_query searches apps by display_name and description (case-insensitive)
+     * account_value on this app (string for precision)
      *
-     * @generated from field: optional string search_query = 7;
+     * @generated from field: string account_value = 6;
      */
-    searchQuery?: string;
-};
-/**
- * Describes the message river.ListRegisteredAppsRequest.
- * Use `create(ListRegisteredAppsRequestSchema)` to create a new message.
- */
-export declare const ListRegisteredAppsRequestSchema: GenMessage<ListRegisteredAppsRequest>;
-/**
- * @generated from message river.ListRegisteredAppsResponse
- */
-export type ListRegisteredAppsResponse = Message<"river.ListRegisteredAppsResponse"> & {
+    accountValue: string;
     /**
-     * apps is the list of matching apps
+     * volume on this app (string for precision)
      *
-     * @generated from field: repeated river.AppInfoFull apps = 1;
+     * @generated from field: string volume = 7;
      */
-    apps: AppInfoFull[];
+    volume: string;
     /**
-     * total_count is the total number of matching apps (for pagination)
+     * error contains an error message if this specific app failed for this user
      *
-     * @generated from field: int32 total_count = 2;
+     * @generated from field: optional string error = 8;
      */
-    totalCount: number;
+    error?: string;
 };
 /**
- * Describes the message river.ListRegisteredAppsResponse.
- * Use `create(ListRegisteredAppsResponseSchema)` to create a new message.
+ * Describes the message river.AppPnlEntry.
+ * Use `create(AppPnlEntrySchema)` to create a new message.
  */
-export declare const ListRegisteredAppsResponseSchema: GenMessage<ListRegisteredAppsResponse>;
+export declare const AppPnlEntrySchema: GenMessage<AppPnlEntry>;
 /**
- * GetBulkAppDataRequest retrieves full app data for multiple apps.
+ * GetBulkAgentCapabilitiesRequest fetches capability manifests for specialist agents.
  *
- * @generated from message river.GetBulkAppDataRequest
+ * @generated from message river.GetBulkAgentCapabilitiesRequest
  */
-export type GetBulkAppDataRequest = Message<"river.GetBulkAppDataRequest"> & {
+export type GetBulkAgentCapabilitiesRequest = Message<"river.GetBulkAgentCapabilitiesRequest"> & {
     /**
-     * app_ids is the list of app addresses to look up (each 20 bytes)
+     * agent_ids is the list of specialist app addresses (each 20 bytes)
      *
-     * @generated from field: repeated bytes app_ids = 1;
+     * @generated from field: repeated bytes agent_ids = 1;
      */
-    appIds: Uint8Array[];
+    agentIds: Uint8Array[];
 };
 /**
- * Describes the message river.GetBulkAppDataRequest.
- * Use `create(GetBulkAppDataRequestSchema)` to create a new message.
+ * Describes the message river.GetBulkAgentCapabilitiesRequest.
+ * Use `create(GetBulkAgentCapabilitiesRequestSchema)` to create a new message.
  */
-export declare const GetBulkAppDataRequestSchema: GenMessage<GetBulkAppDataRequest>;
+export declare const GetBulkAgentCapabilitiesRequestSchema: GenMessage<GetBulkAgentCapabilitiesRequest>;
 /**
- * @generated from message river.GetBulkAppDataResponse
+ * @generated from message river.GetBulkAgentCapabilitiesResponse
  */
-export type GetBulkAppDataResponse = Message<"river.GetBulkAppDataResponse"> & {
+export type GetBulkAgentCapabilitiesResponse = Message<"river.GetBulkAgentCapabilitiesResponse"> & {
     /**
-     * apps is the list of app data for found apps
+     * manifests contains capability manifests for agents that have capabilities
      *
-     * @generated from field: repeated river.AppInfoFull apps = 1;
+     * @generated from field: repeated river.CapabilityManifest manifests = 1;
      */
-    apps: AppInfoFull[];
+    manifests: CapabilityManifest[];
 };
 /**
- * Describes the message river.GetBulkAppDataResponse.
- * Use `create(GetBulkAppDataResponseSchema)` to create a new message.
+ * Describes the message river.GetBulkAgentCapabilitiesResponse.
+ * Use `create(GetBulkAgentCapabilitiesResponseSchema)` to create a new message.
  */
-export declare const GetBulkAppDataResponseSchema: GenMessage<GetBulkAppDataResponse>;
+export declare const GetBulkAgentCapabilitiesResponseSchema: GenMessage<GetBulkAgentCapabilitiesResponse>;
 /**
- * GetAppInstallStatsRequest retrieves installation stats for a single app.
+ * GetBulkAgentProposalsRequest fans out proposal requests to specialist agents asynchronously.
  *
- * @generated from message river.GetAppInstallStatsRequest
+ * @generated from message river.GetBulkAgentProposalsRequest
  */
-export type GetAppInstallStatsRequest = Message<"river.GetAppInstallStatsRequest"> & {
+export type GetBulkAgentProposalsRequest = Message<"river.GetBulkAgentProposalsRequest"> & {
     /**
-     * app_id is the address of the app (20 bytes)
+     * conversation_seed_id is the seed being populated by this async fan-out
      *
-     * @generated from field: bytes app_id = 1;
+     * @generated from field: string conversation_seed_id = 1;
      */
-    appId: Uint8Array;
-};
-/**
- * Describes the message river.GetAppInstallStatsRequest.
- * Use `create(GetAppInstallStatsRequestSchema)` to create a new message.
- */
-export declare const GetAppInstallStatsRequestSchema: GenMessage<GetAppInstallStatsRequest>;
-/**
- * @generated from message river.GetAppInstallStatsResponse
- */
-export type GetAppInstallStatsResponse = Message<"river.GetAppInstallStatsResponse"> & {
+    conversationSeedId: string;
     /**
-     * stats contains the installation statistics
+     * requests contains the capability invocations to fan out
+     * (each invocation includes agent_id, name, and parameters)
      *
-     * @generated from field: river.AppInstallStats stats = 1;
+     * @generated from field: repeated river.SpecialistCapabilityInvocation requests = 2;
      */
-    stats?: AppInstallStats;
-};
-/**
- * Describes the message river.GetAppInstallStatsResponse.
- * Use `create(GetAppInstallStatsResponseSchema)` to create a new message.
- */
-export declare const GetAppInstallStatsResponseSchema: GenMessage<GetAppInstallStatsResponse>;
-/**
- * GetBulkAppInstallStatsRequest retrieves installation stats for multiple apps.
- *
- * @generated from message river.GetBulkAppInstallStatsRequest
- */
-export type GetBulkAppInstallStatsRequest = Message<"river.GetBulkAppInstallStatsRequest"> & {
+    requests: SpecialistCapabilityInvocation[];
     /**
-     * app_ids is the list of app addresses to look up (each 20 bytes)
+     * timeout_ms is optional per-agent timeout budget in milliseconds
      *
-     * @generated from field: repeated bytes app_ids = 1;
+     * @generated from field: optional int32 timeout_ms = 3;
      */
-    appIds: Uint8Array[];
+    timeoutMs?: number;
+    /**
+     * IANA timezone of the user, e.g. "America/New_York", if not supplied, the timezone from the conversation seed will be used.
+     *
+     * @generated from field: optional string user_timezone = 4;
+     */
+    userTimezone?: string;
+    /**
+     * Optional metadata forwarded to specialist webhook requests.
+     *
+     * @generated from field: map<string, string> metadata = 5;
+     */
+    metadata: {
+        [key: string]: string;
+    };
 };
 /**
- * Describes the message river.GetBulkAppInstallStatsRequest.
- * Use `create(GetBulkAppInstallStatsRequestSchema)` to create a new message.
+ * Describes the message river.GetBulkAgentProposalsRequest.
+ * Use `create(GetBulkAgentProposalsRequestSchema)` to create a new message.
  */
-export declare const GetBulkAppInstallStatsRequestSchema: GenMessage<GetBulkAppInstallStatsRequest>;
+export declare const GetBulkAgentProposalsRequestSchema: GenMessage<GetBulkAgentProposalsRequest>;
 /**
- * @generated from message river.GetBulkAppInstallStatsResponse
+ * @generated from message river.GetBulkAgentProposalsResponse
  */
-export type GetBulkAppInstallStatsResponse = Message<"river.GetBulkAppInstallStatsResponse"> & {
+export type GetBulkAgentProposalsResponse = Message<"river.GetBulkAgentProposalsResponse"> & {
     /**
-     * stats is a map of app_id (hex string) to installation stats
+     * Request accepted; proposal aggregation continues asynchronously.
      *
-     * @generated from field: repeated river.AppInstallStats stats = 1;
+     * @generated from field: bool accepted = 1;
      */
-    stats: AppInstallStats[];
+    accepted: boolean;
 };
 /**
- * Describes the message river.GetBulkAppInstallStatsResponse.
- * Use `create(GetBulkAppInstallStatsResponseSchema)` to create a new message.
+ * Describes the message river.GetBulkAgentProposalsResponse.
+ * Use `create(GetBulkAgentProposalsResponseSchema)` to create a new message.
  */
-export declare const GetBulkAppInstallStatsResponseSchema: GenMessage<GetBulkAppInstallStatsResponse>;
+export declare const GetBulkAgentProposalsResponseSchema: GenMessage<GetBulkAgentProposalsResponse>;
 /**
- * SubmitAppReviewRequest creates or updates a review.
+ * QueryConciergeRequest submits a natural language query to the Concierge agent.
  *
- * @generated from message river.SubmitAppReviewRequest
+ * @generated from message river.QueryConciergeRequest
  */
-export type SubmitAppReviewRequest = Message<"river.SubmitAppReviewRequest"> & {
+export type QueryConciergeRequest = Message<"river.QueryConciergeRequest"> & {
     /**
-     * app_id is the address of the app to review (20 bytes)
+     * User's natural language query
      *
-     * @generated from field: bytes app_id = 1;
+     * @generated from field: string query = 1;
      */
-    appId: Uint8Array;
+    query: string;
     /**
-     * rating is the review rating (1-5)
+     * Origin: "web", "twitter"
      *
-     * @generated from field: int32 rating = 2;
+     * @generated from field: optional string source = 2;
      */
-    rating: number;
+    source?: string;
     /**
-     * comment is the optional review text
+     * e.g. Twitter tweet ID for thread hydration
      *
-     * @generated from field: string comment = 3;
+     * @generated from field: optional string external_ref = 3;
      */
-    comment: string;
+    externalRef?: string;
+    /**
+     * IANA timezone of the user, e.g. "America/New_York"
+     *
+     * @generated from field: optional string user_timezone = 4;
+     */
+    userTimezone?: string;
 };
 /**
- * Describes the message river.SubmitAppReviewRequest.
- * Use `create(SubmitAppReviewRequestSchema)` to create a new message.
+ * Describes the message river.QueryConciergeRequest.
+ * Use `create(QueryConciergeRequestSchema)` to create a new message.
  */
-export declare const SubmitAppReviewRequestSchema: GenMessage<SubmitAppReviewRequest>;
+export declare const QueryConciergeRequestSchema: GenMessage<QueryConciergeRequest>;
 /**
- * @generated from message river.SubmitAppReviewResponse
+ * @generated from message river.QueryConciergeResponse
  */
-export type SubmitAppReviewResponse = Message<"river.SubmitAppReviewResponse"> & {
+export type QueryConciergeResponse = Message<"river.QueryConciergeResponse"> & {
     /**
-     * review_id is the unique identifier of the created/updated review
+     * Newly created conversation seed ID to poll.
      *
-     * @generated from field: string review_id = 1;
+     * @generated from field: string conversation_seed_id = 1;
      */
-    reviewId: string;
+    conversationSeedId: string;
+};
+/**
+ * Describes the message river.QueryConciergeResponse.
+ * Use `create(QueryConciergeResponseSchema)` to create a new message.
+ */
+export declare const QueryConciergeResponseSchema: GenMessage<QueryConciergeResponse>;
+/**
+ * GetConversationSeedRequest retrieves a stored ConversationSeed by ID.
+ *
+ * @generated from message river.GetConversationSeedRequest
+ */
+export type GetConversationSeedRequest = Message<"river.GetConversationSeedRequest"> & {
+    /**
+     * The conversation seed ID (from the URL path).
+     *
+     * @generated from field: string seed_id = 1;
+     */
+    seedId: string;
 };
 /**
- * Describes the message river.SubmitAppReviewResponse.
- * Use `create(SubmitAppReviewResponseSchema)` to create a new message.
+ * Describes the message river.GetConversationSeedRequest.
+ * Use `create(GetConversationSeedRequestSchema)` to create a new message.
  */
-export declare const SubmitAppReviewResponseSchema: GenMessage<SubmitAppReviewResponse>;
+export declare const GetConversationSeedRequestSchema: GenMessage<GetConversationSeedRequest>;
 /**
- * GetAppReviewsRequest retrieves paginated reviews for an app.
- *
- * @generated from message river.GetAppReviewsRequest
+ * @generated from message river.GetConversationSeedResponse
  */
-export type GetAppReviewsRequest = Message<"river.GetAppReviewsRequest"> & {
+export type GetConversationSeedResponse = Message<"river.GetConversationSeedResponse"> & {
     /**
-     * app_id is the address of the app (20 bytes)
+     * The conversation seed.
      *
-     * @generated from field: bytes app_id = 1;
+     * @generated from field: river.ConversationSeed seed = 1;
      */
-    appId: Uint8Array;
+    seed?: ConversationSeed;
     /**
-     * limit is the maximum number of reviews to return
+     * Computed user-facing readiness from seed content/timestamps.
      *
-     * @generated from field: int32 limit = 2;
+     * @generated from field: river.ConversationSeedStatus status = 2;
      */
-    limit: number;
+    status: ConversationSeedStatus;
     /**
-     * offset is the number of reviews to skip for pagination
+     * Computed specialist fan-out status from proposals_by_agent outcomes.
      *
-     * @generated from field: int32 offset = 3;
+     * @generated from field: river.ProposalStatus proposal_status = 3;
      */
-    offset: number;
+    proposalStatus: ProposalStatus;
 };
 /**
- * Describes the message river.GetAppReviewsRequest.
- * Use `create(GetAppReviewsRequestSchema)` to create a new message.
+ * Describes the message river.GetConversationSeedResponse.
+ * Use `create(GetConversationSeedResponseSchema)` to create a new message.
  */
-export declare const GetAppReviewsRequestSchema: GenMessage<GetAppReviewsRequest>;
+export declare const GetConversationSeedResponseSchema: GenMessage<GetConversationSeedResponse>;
 /**
- * @generated from message river.GetAppReviewsResponse
+ * SubmitAgentProposalsRequest is sent by a specialist agent to deliver proposal results.
+ *
+ * @generated from message river.SubmitAgentProposalsRequest
  */
-export type GetAppReviewsResponse = Message<"river.GetAppReviewsResponse"> & {
+export type SubmitAgentProposalsRequest = Message<"river.SubmitAgentProposalsRequest"> & {
     /**
-     * reviews is the list of reviews
+     * The conversation seed ID these proposals belong to.
      *
-     * @generated from field: repeated river.AppReview reviews = 1;
+     * @generated from field: string conversation_seed_id = 1;
      */
-    reviews: AppReview[];
+    conversationSeedId: string;
     /**
-     * total_count is the total number of reviews (for pagination)
+     * Proposals generated by this agent.
      *
-     * @generated from field: int32 total_count = 2;
+     * @generated from field: repeated river.Proposal proposals = 2;
      */
-    totalCount: number;
-};
-/**
- * Describes the message river.GetAppReviewsResponse.
- * Use `create(GetAppReviewsResponseSchema)` to create a new message.
- */
-export declare const GetAppReviewsResponseSchema: GenMessage<GetAppReviewsResponse>;
-/**
- * RevokeAppReviewRequest revokes the caller's review for an app.
- *
- * @generated from message river.RevokeAppReviewRequest
- */
-export type RevokeAppReviewRequest = Message<"river.RevokeAppReviewRequest"> & {
+    proposals: Proposal[];
     /**
-     * app_id is the address of the app (20 bytes)
+     * Errors encountered during proposal generation.
      *
-     * @generated from field: bytes app_id = 1;
+     * @generated from field: repeated river.AgentProposalError errors = 3;
      */
-    appId: Uint8Array;
+    errors: AgentProposalError[];
 };
 /**
- * Describes the message river.RevokeAppReviewRequest.
- * Use `create(RevokeAppReviewRequestSchema)` to create a new message.
+ * Describes the message river.SubmitAgentProposalsRequest.
+ * Use `create(SubmitAgentProposalsRequestSchema)` to create a new message.
  */
-export declare const RevokeAppReviewRequestSchema: GenMessage<RevokeAppReviewRequest>;
+export declare const SubmitAgentProposalsRequestSchema: GenMessage<SubmitAgentProposalsRequest>;
 /**
- * @generated from message river.RevokeAppReviewResponse
+ * @generated from message river.SubmitAgentProposalsResponse
  */
-export type RevokeAppReviewResponse = Message<"river.RevokeAppReviewResponse"> & {};
+export type SubmitAgentProposalsResponse = Message<"river.SubmitAgentProposalsResponse"> & {};
 /**
- * Describes the message river.RevokeAppReviewResponse.
- * Use `create(RevokeAppReviewResponseSchema)` to create a new message.
+ * Describes the message river.SubmitAgentProposalsResponse.
+ * Use `create(SubmitAgentProposalsResponseSchema)` to create a new message.
  */
-export declare const RevokeAppReviewResponseSchema: GenMessage<RevokeAppReviewResponse>;
+export declare const SubmitAgentProposalsResponseSchema: GenMessage<SubmitAgentProposalsResponse>;
 /**
- * GetAppReviewSummaryRequest retrieves review summary for a single app.
+ * FinishConversationSeedRequest is sent by the concierge agent to finalize a seed
+ * with its output (response text, selected proposals, clarifying questions).
  *
- * @generated from message river.GetAppReviewSummaryRequest
+ * @generated from message river.FinishConversationSeedRequest
  */
-export type GetAppReviewSummaryRequest = Message<"river.GetAppReviewSummaryRequest"> & {
+export type FinishConversationSeedRequest = Message<"river.FinishConversationSeedRequest"> & {
     /**
-     * app_id is the address of the app (20 bytes)
+     * The conversation seed ID to finalize.
      *
-     * @generated from field: bytes app_id = 1;
+     * @generated from field: string conversation_seed_id = 1;
      */
-    appId: Uint8Array;
-};
-/**
- * Describes the message river.GetAppReviewSummaryRequest.
- * Use `create(GetAppReviewSummaryRequestSchema)` to create a new message.
- */
-export declare const GetAppReviewSummaryRequestSchema: GenMessage<GetAppReviewSummaryRequest>;
-/**
- * @generated from message river.GetAppReviewSummaryResponse
- */
-export type GetAppReviewSummaryResponse = Message<"river.GetAppReviewSummaryResponse"> & {
+    conversationSeedId: string;
     /**
-     * summary contains the aggregated review statistics
+     * Concierge-formatted response text shown to user.
      *
-     * @generated from field: river.AppReviewSummary summary = 1;
+     * @generated from field: string response_text = 2;
      */
-    summary?: AppReviewSummary;
-};
-/**
- * Describes the message river.GetAppReviewSummaryResponse.
- * Use `create(GetAppReviewSummaryResponseSchema)` to create a new message.
- */
-export declare const GetAppReviewSummaryResponseSchema: GenMessage<GetAppReviewSummaryResponse>;
-/**
- * GetBulkAppReviewSummariesRequest retrieves review summaries for multiple apps.
- *
- * @generated from message river.GetBulkAppReviewSummariesRequest
- */
-export type GetBulkAppReviewSummariesRequest = Message<"river.GetBulkAppReviewSummariesRequest"> & {
+    responseText: string;
     /**
-     * app_ids is the list of app addresses to look up (each 20 bytes)
+     * Proposal IDs selected by concierge for presentation.
      *
-     * @generated from field: repeated bytes app_ids = 1;
+     * @generated from field: repeated string selected_proposal_ids = 3;
      */
-    appIds: Uint8Array[];
-};
-/**
- * Describes the message river.GetBulkAppReviewSummariesRequest.
- * Use `create(GetBulkAppReviewSummariesRequestSchema)` to create a new message.
- */
-export declare const GetBulkAppReviewSummariesRequestSchema: GenMessage<GetBulkAppReviewSummariesRequest>;
-/**
- * @generated from message river.GetBulkAppReviewSummariesResponse
- */
-export type GetBulkAppReviewSummariesResponse = Message<"river.GetBulkAppReviewSummariesResponse"> & {
+    selectedProposalIds: string[];
     /**
-     * summaries is the list of review summaries for found apps
+     * Optional clarifying questions for the user.
      *
-     * @generated from field: repeated river.AppReviewSummary summaries = 1;
+     * @generated from field: repeated string clarifying_questions = 4;
      */
-    summaries: AppReviewSummary[];
+    clarifyingQuestions: string[];
+    /**
+     * Status of the concierge finalization. Defaults to SUCCESS (0) for backward compatibility.
+     *
+     * @generated from field: river.ConciergeFinishStatus status = 5;
+     */
+    status: ConciergeFinishStatus;
 };
 /**
- * Describes the message river.GetBulkAppReviewSummariesResponse.
- * Use `create(GetBulkAppReviewSummariesResponseSchema)` to create a new message.
+ * Describes the message river.FinishConversationSeedRequest.
+ * Use `create(FinishConversationSeedRequestSchema)` to create a new message.
  */
-export declare const GetBulkAppReviewSummariesResponseSchema: GenMessage<GetBulkAppReviewSummariesResponse>;
+export declare const FinishConversationSeedRequestSchema: GenMessage<FinishConversationSeedRequest>;
 /**
- * GetAppPositionsRequest retrieves positions for the authenticated user from a single app.
- *
- * @generated from message river.GetAppPositionsRequest
+ * @generated from message river.FinishConversationSeedResponse
  */
-export type GetAppPositionsRequest = Message<"river.GetAppPositionsRequest"> & {
+export type FinishConversationSeedResponse = Message<"river.FinishConversationSeedResponse"> & {
     /**
-     * app_id is the address of the app (20 bytes)
-     *
-     * @generated from field: bytes app_id = 1;
+     * @generated from field: river.ConversationSeed seed = 1;
      */
-    appId: Uint8Array;
+    seed?: ConversationSeed;
 };
 /**
- * Describes the message river.GetAppPositionsRequest.
- * Use `create(GetAppPositionsRequestSchema)` to create a new message.
+ * Describes the message river.FinishConversationSeedResponse.
+ * Use `create(FinishConversationSeedResponseSchema)` to create a new message.
  */
-export declare const GetAppPositionsRequestSchema: GenMessage<GetAppPositionsRequest>;
+export declare const FinishConversationSeedResponseSchema: GenMessage<FinishConversationSeedResponse>;
 /**
- * @generated from message river.GetAppPositionsResponse
+ * GetEntitlementsRequest retrieves the caller's entitlements for a specific app.
+ *
+ * @generated from message river.GetEntitlementsRequest
  */
-export type GetAppPositionsResponse = Message<"river.GetAppPositionsResponse"> & {
+export type GetEntitlementsRequest = Message<"river.GetEntitlementsRequest"> & {
     /**
      * app_id is the address of the app (20 bytes)
      *
      * @generated from field: bytes app_id = 1;
      */
     appId: Uint8Array;
-    /**
-     * positions contains the position data from the bot
-     *
-     * @generated from field: river.PositionsResponse positions = 2;
-     */
-    positions?: PositionsResponse;
 };
 /**
- * Describes the message river.GetAppPositionsResponse.
- * Use `create(GetAppPositionsResponseSchema)` to create a new message.
+ * Describes the message river.GetEntitlementsRequest.
+ * Use `create(GetEntitlementsRequestSchema)` to create a new message.
  */
-export declare const GetAppPositionsResponseSchema: GenMessage<GetAppPositionsResponse>;
+export declare const GetEntitlementsRequestSchema: GenMessage<GetEntitlementsRequest>;
 /**
- * GetBatchAppPositionsRequest retrieves positions from multiple apps.
- *
- * @generated from message river.GetBatchAppPositionsRequest
+ * @generated from message river.GetEntitlementsResponse
  */
-export type GetBatchAppPositionsRequest = Message<"river.GetBatchAppPositionsRequest"> & {
+export type GetEntitlementsResponse = Message<"river.GetEntitlementsResponse"> & {
     /**
-     * app_ids is the list of app addresses to query (each 20 bytes)
-     * Maximum 10 apps per request (enforced server-side)
+     * can_set_promoted indicates whether the caller can change the app's promoted status
      *
-     * @generated from field: repeated bytes app_ids = 1;
+     * @generated from field: bool can_set_promoted = 1;
      */
-    appIds: Uint8Array[];
-};
-/**
- * Describes the message river.GetBatchAppPositionsRequest.
- * Use `create(GetBatchAppPositionsRequestSchema)` to create a new message.
- */
-export declare const GetBatchAppPositionsRequestSchema: GenMessage<GetBatchAppPositionsRequest>;
-/**
- * @generated from message river.GetBatchAppPositionsResponse
- */
-export type GetBatchAppPositionsResponse = Message<"river.GetBatchAppPositionsResponse"> & {
+    canSetPromoted: boolean;
     /**
-     * entries contains position data for each requested app
+     * can_set_verified indicates whether the caller can change the app's verified status
      *
-     * @generated from field: repeated river.AppPositionsEntry entries = 1;
+     * @generated from field: bool can_set_verified = 2;
      */
-    entries: AppPositionsEntry[];
-};
-/**
- * Describes the message river.GetBatchAppPositionsResponse.
- * Use `create(GetBatchAppPositionsResponseSchema)` to create a new message.
- */
-export declare const GetBatchAppPositionsResponseSchema: GenMessage<GetBatchAppPositionsResponse>;
-/**
- * AppPositionsEntry contains position data for a single app in a batch response.
- *
- * @generated from message river.AppPositionsEntry
- */
-export type AppPositionsEntry = Message<"river.AppPositionsEntry"> & {
+    canSetVerified: boolean;
     /**
-     * app_id is the address of the app (20 bytes)
+     * can_set_active indicates whether the caller can change the app's active status
      *
-     * @generated from field: bytes app_id = 1;
+     * @generated from field: bool can_set_active = 3;
      */
-    appId: Uint8Array;
+    canSetActive: boolean;
     /**
-     * positions contains the position data from the bot
+     * can_update_metadata indicates whether the caller can update the app's metadata
      *
-     * @generated from field: river.PositionsResponse positions = 2;
+     * @generated from field: bool can_update_metadata = 4;
      */
-    positions?: PositionsResponse;
+    canUpdateMetadata: boolean;
     /**
-     * error contains an error message if this specific app failed
+     * is_owner indicates whether the caller is the app's owner
      *
-     * @generated from field: optional string error = 3;
+     * @generated from field: bool is_owner = 5;
      */
-    error?: string;
-};
-/**
- * Describes the message river.AppPositionsEntry.
- * Use `create(AppPositionsEntrySchema)` to create a new message.
- */
-export declare const AppPositionsEntrySchema: GenMessage<AppPositionsEntry>;
-/**
- * GetBulkAgentCapabilitiesRequest fetches capability manifests for specialist agents.
- *
- * @generated from message river.GetBulkAgentCapabilitiesRequest
- */
-export type GetBulkAgentCapabilitiesRequest = Message<"river.GetBulkAgentCapabilitiesRequest"> & {
+    isOwner: boolean;
     /**
-     * agent_ids is the list of specialist app addresses (each 20 bytes)
+     * is_admin indicates whether the caller is a platform admin
      *
-     * @generated from field: repeated bytes agent_ids = 1;
+     * @generated from field: bool is_admin = 6;
      */
-    agentIds: Uint8Array[];
+    isAdmin: boolean;
 };
 /**
- * Describes the message river.GetBulkAgentCapabilitiesRequest.
- * Use `create(GetBulkAgentCapabilitiesRequestSchema)` to create a new message.
+ * Describes the message river.GetEntitlementsResponse.
+ * Use `create(GetEntitlementsResponseSchema)` to create a new message.
  */
-export declare const GetBulkAgentCapabilitiesRequestSchema: GenMessage<GetBulkAgentCapabilitiesRequest>;
+export declare const GetEntitlementsResponseSchema: GenMessage<GetEntitlementsResponse>;
 /**
- * @generated from message river.GetBulkAgentCapabilitiesResponse
+ * ConversationContext carries normalized conversation metadata for GDM webhook deliveries.
+ * It is optional and currently only populated for GDM streams.
+ *
+ * @generated from message river.ConversationContext
  */
-export type GetBulkAgentCapabilitiesResponse = Message<"river.GetBulkAgentCapabilitiesResponse"> & {
+export type ConversationContext = Message<"river.ConversationContext"> & {
     /**
-     * manifests contains capability manifests for agents that have capabilities
+     * participants are all current joined members of the GDM stream.
      *
-     * @generated from field: repeated river.CapabilityManifest manifests = 1;
+     * @generated from field: repeated river.ConversationContext.Participant participants = 1;
      */
-    manifests: CapabilityManifest[];
+    participants: ConversationContext_Participant[];
 };
 /**
- * Describes the message river.GetBulkAgentCapabilitiesResponse.
- * Use `create(GetBulkAgentCapabilitiesResponseSchema)` to create a new message.
+ * Describes the message river.ConversationContext.
+ * Use `create(ConversationContextSchema)` to create a new message.
  */
-export declare const GetBulkAgentCapabilitiesResponseSchema: GenMessage<GetBulkAgentCapabilitiesResponse>;
+export declare const ConversationContextSchema: GenMessage<ConversationContext>;
 /**
- * GetBulkAgentProposalsRequest fans out proposal requests to specialist agents asynchronously.
- *
- * @generated from message river.GetBulkAgentProposalsRequest
+ * @generated from message river.ConversationContext.Participant
  */
-export type GetBulkAgentProposalsRequest = Message<"river.GetBulkAgentProposalsRequest"> & {
-    /**
-     * conversation_seed_id is the seed being populated by this async fan-out
-     *
-     * @generated from field: string conversation_seed_id = 1;
-     */
-    conversationSeedId: string;
-    /**
-     * requests contains the capability invocations to fan out
-     * (each invocation includes agent_id, name, and parameters)
-     *
-     * @generated from field: repeated river.SpecialistCapabilityInvocation requests = 2;
-     */
-    requests: SpecialistCapabilityInvocation[];
+export type ConversationContext_Participant = Message<"river.ConversationContext.Participant"> & {
     /**
-     * timeout_ms is optional per-agent timeout budget in milliseconds
+     * address is the 20-byte participant address.
      *
-     * @generated from field: optional int32 timeout_ms = 3;
+     * @generated from field: bytes address = 1;
      */
-    timeoutMs?: number;
+    address: Uint8Array;
     /**
-     * IANA timezone of the user, e.g. "America/New_York", if not supplied, the timezone from the conversation seed will be used.
+     * name is the participant username, if configured.
      *
-     * @generated from field: optional string user_timezone = 4;
+     * @generated from field: string name = 2;
      */
-    userTimezone?: string;
+    name: string;
     /**
-     * Optional metadata forwarded to specialist webhook requests.
+     * display_name is the participant display name, if configured.
      *
-     * @generated from field: map<string, string> metadata = 5;
+     * @generated from field: string display_name = 3;
      */
-    metadata: {
-        [key: string]: string;
-    };
+    displayName: string;
 };
 /**
- * Describes the message river.GetBulkAgentProposalsRequest.
- * Use `create(GetBulkAgentProposalsRequestSchema)` to create a new message.
+ * Describes the message river.ConversationContext.Participant.
+ * Use `create(ConversationContext_ParticipantSchema)` to create a new message.
  */
-export declare const GetBulkAgentProposalsRequestSchema: GenMessage<GetBulkAgentProposalsRequest>;
+export declare const ConversationContext_ParticipantSchema: GenMessage<ConversationContext_Participant>;
 /**
- * @generated from message river.GetBulkAgentProposalsResponse
+ * As a performance optimization, we may wish to bundle together many key solicitation requests
+ * and channel messages for the bot to respond to in a single webhook call. Thus, an isolated
+ * group of channel messages and encryption keys, or a request for a key solicitation, is
+ * represented here. For webhook calls regarding channel content, the payload may contain one or
+ * more of these events.
+ *
+ * @generated from message river.EventPayload
  */
-export type GetBulkAgentProposalsResponse = Message<"river.GetBulkAgentProposalsResponse"> & {
+export type EventPayload = Message<"river.EventPayload"> & {
     /**
-     * Request accepted; proposal aggregation continues asynchronously.
-     *
-     * @generated from field: bool accepted = 1;
+     * @generated from oneof river.EventPayload.payload
      */
-    accepted: boolean;
+    payload: {
+        /**
+         * @generated from field: river.EventPayload.Messages messages = 1;
+         */
+        value: EventPayload_Messages;
+        case: "messages";
+    } | {
+        /**
+         * @generated from field: river.EventPayload.SolicitKeys solicitation = 2;
+         */
+        value: EventPayload_SolicitKeys;
+        case: "solicitation";
+    } | {
+        case: undefined;
+        value?: undefined;
+    };
 };
 /**
- * Describes the message river.GetBulkAgentProposalsResponse.
- * Use `create(GetBulkAgentProposalsResponseSchema)` to create a new message.
+ * Describes the message river.EventPayload.
+ * Use `create(EventPayloadSchema)` to create a new message.
  */
-export declare const GetBulkAgentProposalsResponseSchema: GenMessage<GetBulkAgentProposalsResponse>;
+export declare const EventPayloadSchema: GenMessage<EventPayload>;
 /**
- * QueryConciergeRequest submits a natural language query to the Concierge agent.
+ * A Messages payload represents a group of user messages in a channel that qualifies for the app
+ * to be notified. The included set of group encryption sessions in this message should have
+ * all the needed ciphertexts to decrypt the set of messages sent in the same payload.
  *
- * @generated from message river.QueryConciergeRequest
+ * @generated from message river.EventPayload.Messages
  */
-export type QueryConciergeRequest = Message<"river.QueryConciergeRequest"> & {
+export type EventPayload_Messages = Message<"river.EventPayload.Messages"> & {
     /**
-     * User's natural language query
-     *
-     * @generated from field: string query = 1;
+     * @generated from field: bytes stream_id = 1;
      */
-    query: string;
+    streamId: Uint8Array;
     /**
-     * Origin: "web", "twitter"
-     *
-     * @generated from field: optional string source = 2;
+     * @generated from field: repeated river.Envelope messages = 2;
      */
-    source?: string;
+    messages: Envelope[];
     /**
-     * e.g. Twitter tweet ID for thread hydration
-     *
-     * @generated from field: optional string external_ref = 3;
+     * @generated from field: repeated river.Envelope group_encryption_sessions_messages = 3;
      */
-    externalRef?: string;
+    groupEncryptionSessionsMessages: Envelope[];
     /**
-     * IANA timezone of the user, e.g. "America/New_York"
-     *
-     * @generated from field: optional string user_timezone = 4;
+     * @generated from field: river.ConversationContext conversation_context = 4;
      */
-    userTimezone?: string;
+    conversationContext?: ConversationContext;
 };
 /**
- * Describes the message river.QueryConciergeRequest.
- * Use `create(QueryConciergeRequestSchema)` to create a new message.
+ * Describes the message river.EventPayload.Messages.
+ * Use `create(EventPayload_MessagesSchema)` to create a new message.
  */
-export declare const QueryConciergeRequestSchema: GenMessage<QueryConciergeRequest>;
+export declare const EventPayload_MessagesSchema: GenMessage<EventPayload_Messages>;
 /**
- * @generated from message river.QueryConciergeResponse
+ * A SolicitKeys request is sent when one or more messages in the same channel cannot be forwarded
+ * to the app because the app does not have keys available to decrypt it in it's user inbox stream.
+ * In this case, the app must be prompted to send a message to the stream to solicit the missing
+ * session keys so that all queued messages can be forwarded.
+ *
+ * @generated from message river.EventPayload.SolicitKeys
  */
-export type QueryConciergeResponse = Message<"river.QueryConciergeResponse"> & {
+export type EventPayload_SolicitKeys = Message<"river.EventPayload.SolicitKeys"> & {
     /**
-     * Newly created conversation seed ID to poll.
-     *
-     * @generated from field: string conversation_seed_id = 1;
+     * @generated from field: bytes stream_id = 1;
      */
-    conversationSeedId: string;
+    streamId: Uint8Array;
+    /**
+     * @generated from field: repeated string session_ids = 2;
+     */
+    sessionIds: string[];
 };
 /**
- * Describes the message river.QueryConciergeResponse.
- * Use `create(QueryConciergeResponseSchema)` to create a new message.
+ * Describes the message river.EventPayload.SolicitKeys.
+ * Use `create(EventPayload_SolicitKeysSchema)` to create a new message.
  */
-export declare const QueryConciergeResponseSchema: GenMessage<QueryConciergeResponse>;
+export declare const EventPayload_SolicitKeysSchema: GenMessage<EventPayload_SolicitKeys>;
 /**
- * GetConversationSeedRequest retrieves a stored ConversationSeed by ID.
- *
- * @generated from message river.GetConversationSeedRequest
+ * @generated from message river.EventsPayload
  */
-export type GetConversationSeedRequest = Message<"river.GetConversationSeedRequest"> & {
+export type EventsPayload = Message<"river.EventsPayload"> & {
     /**
-     * The conversation seed ID (from the URL path).
-     *
-     * @generated from field: string seed_id = 1;
+     * @generated from field: repeated river.EventPayload events = 1;
      */
-    seedId: string;
+    events: EventPayload[];
 };
 /**
- * Describes the message river.GetConversationSeedRequest.
- * Use `create(GetConversationSeedRequestSchema)` to create a new message.
+ * Describes the message river.EventsPayload.
+ * Use `create(EventsPayloadSchema)` to create a new message.
  */
-export declare const GetConversationSeedRequestSchema: GenMessage<GetConversationSeedRequest>;
+export declare const EventsPayloadSchema: GenMessage<EventsPayload>;
 /**
- * @generated from message river.GetConversationSeedResponse
+ * @generated from message river.AppServiceRequest
  */
-export type GetConversationSeedResponse = Message<"river.GetConversationSeedResponse"> & {
+export type AppServiceRequest = Message<"river.AppServiceRequest"> & {
+    /**
+     * @generated from oneof river.AppServiceRequest.payload
+     */
+    payload: {
+        /**
+         * @generated from field: google.protobuf.Empty initialize = 101;
+         */
+        value: Empty;
+        case: "initialize";
+    } | {
+        /**
+         * @generated from field: google.protobuf.Empty status = 102;
+         */
+        value: Empty;
+        case: "status";
+    } | {
+        /**
+         * @generated from field: river.EventsPayload events = 103;
+         */
+        value: EventsPayload;
+        case: "events";
+    } | {
+        /**
+         * @generated from field: river.PositionsRequest positions = 104;
+         */
+        value: PositionsRequest;
+        case: "positions";
+    } | {
+        /**
+         * @generated from field: river.AppServiceRequest.ProposalsRequest proposals = 105;
+         */
+        value: AppServiceRequest_ProposalsRequest;
+        case: "proposals";
+    } | {
+        /**
+         * @generated from field: river.AppServiceRequest.ConciergeRequest concierge_request = 106;
+         */
+        value: AppServiceRequest_ConciergeRequest;
+        case: "conciergeRequest";
+    } | {
+        case: undefined;
+        value?: undefined;
+    };
+};
+/**
+ * Describes the message river.AppServiceRequest.
+ * Use `create(AppServiceRequestSchema)` to create a new message.
+ */
+export declare const AppServiceRequestSchema: GenMessage<AppServiceRequest>;
+/**
+ * @generated from message river.AppServiceRequest.ProposalsRequest
+ */
+export type AppServiceRequest_ProposalsRequest = Message<"river.AppServiceRequest.ProposalsRequest"> & {
+    /**
+     * Seed ID being populated by this specialist request.
+     *
+     * @generated from field: string conversation_seed_id = 1;
+     */
+    conversationSeedId: string;
+    /**
+     * Original user query for specialist context.
+     *
+     * @generated from field: string user_query = 2;
+     */
+    userQuery: string;
+    /**
+     * Optional normalized context (e.g., thread summary or conversation context).
+     *
+     * @generated from field: optional string context = 3;
+     */
+    context?: string;
     /**
-     * The conversation seed.
+     * Invocations for this bot.
      *
-     * @generated from field: river.ConversationSeed seed = 1;
+     * @generated from field: repeated river.SpecialistCapabilityInvocation invocations = 4;
      */
-    seed?: ConversationSeed;
+    invocations: SpecialistCapabilityInvocation[];
     /**
-     * Computed user-facing readiness from seed content/timestamps.
+     * Optional timeout budget for fan-out.
      *
-     * @generated from field: river.ConversationSeedStatus status = 2;
+     * @generated from field: optional int32 timeout_ms = 5;
      */
-    status: ConversationSeedStatus;
+    timeoutMs?: number;
     /**
-     * Computed specialist fan-out status from proposals_by_agent outcomes.
+     * IANA timezone of the user, e.g. "America/New_York".
      *
-     * @generated from field: river.ProposalStatus proposal_status = 3;
+     * @generated from field: optional string user_timezone = 6;
      */
-    proposalStatus: ProposalStatus;
+    userTimezone?: string;
+    /**
+     * Optional metadata forwarded from concierge to specialist handlers.
+     *
+     * @generated from field: map<string, string> metadata = 7;
+     */
+    metadata: {
+        [key: string]: string;
+    };
 };
 /**
- * Describes the message river.GetConversationSeedResponse.
- * Use `create(GetConversationSeedResponseSchema)` to create a new message.
+ * Describes the message river.AppServiceRequest.ProposalsRequest.
+ * Use `create(AppServiceRequest_ProposalsRequestSchema)` to create a new message.
  */
-export declare const GetConversationSeedResponseSchema: GenMessage<GetConversationSeedResponse>;
+export declare const AppServiceRequest_ProposalsRequestSchema: GenMessage<AppServiceRequest_ProposalsRequest>;
 /**
- * SubmitAgentProposalsRequest is sent by a specialist agent to deliver proposal results.
- *
- * @generated from message river.SubmitAgentProposalsRequest
+ * @generated from message river.AppServiceRequest.ConciergeRequest
  */
-export type SubmitAgentProposalsRequest = Message<"river.SubmitAgentProposalsRequest"> & {
+export type AppServiceRequest_ConciergeRequest = Message<"river.AppServiceRequest.ConciergeRequest"> & {
     /**
-     * The conversation seed ID these proposals belong to.
+     * Seed ID created by QueryConcierge and used for polling/fan-out.
      *
      * @generated from field: string conversation_seed_id = 1;
      */
     conversationSeedId: string;
     /**
-     * Proposals generated by this agent.
+     * Original user query (or query derived from full twitter thread context).
      *
-     * @generated from field: repeated river.Proposal proposals = 2;
+     * @generated from field: string user_query = 2;
      */
-    proposals: Proposal[];
+    userQuery: string;
     /**
-     * Errors encountered during proposal generation.
+     * Optional normalized context (e.g., thread summary or conversation history).
      *
-     * @generated from field: repeated river.AgentProposalError errors = 3;
+     * @generated from field: optional string context = 3;
      */
-    errors: AgentProposalError[];
-};
-/**
- * Describes the message river.SubmitAgentProposalsRequest.
- * Use `create(SubmitAgentProposalsRequestSchema)` to create a new message.
- */
-export declare const SubmitAgentProposalsRequestSchema: GenMessage<SubmitAgentProposalsRequest>;
-/**
- * @generated from message river.SubmitAgentProposalsResponse
- */
-export type SubmitAgentProposalsResponse = Message<"river.SubmitAgentProposalsResponse"> & {};
-/**
- * Describes the message river.SubmitAgentProposalsResponse.
- * Use `create(SubmitAgentProposalsResponseSchema)` to create a new message.
- */
-export declare const SubmitAgentProposalsResponseSchema: GenMessage<SubmitAgentProposalsResponse>;
-/**
- * FinishConversationSeedRequest is sent by the concierge agent to finalize a seed
- * with its output (response text, selected proposals, clarifying questions).
- *
- * @generated from message river.FinishConversationSeedRequest
- */
-export type FinishConversationSeedRequest = Message<"river.FinishConversationSeedRequest"> & {
+    context?: string;
     /**
-     * The conversation seed ID to finalize.
+     * Optional external reference (e.g., tweet ID).
      *
-     * @generated from field: string conversation_seed_id = 1;
+     * @generated from field: optional string external_ref = 4;
      */
-    conversationSeedId: string;
+    externalRef?: string;
     /**
-     * Concierge-formatted response text shown to user.
+     * Timeout from the conversation seed.
      *
-     * @generated from field: string response_text = 2;
+     * @generated from field: optional int64 proposal_timeout_ms = 5;
      */
-    responseText: string;
+    proposalTimeoutMs?: bigint;
     /**
-     * Proposal IDs selected by concierge for presentation.
+     * Timeout from the conversation seed.
      *
-     * @generated from field: repeated string selected_proposal_ids = 3;
+     * @generated from field: optional int64 concierge_timeout_ms = 6;
      */
-    selectedProposalIds: string[];
+    conciergeTimeoutMs?: bigint;
     /**
-     * Optional clarifying questions for the user.
+     * IANA timezone of the user, e.g. "America/New_York".
      *
-     * @generated from field: repeated string clarifying_questions = 4;
+     * @generated from field: optional string user_timezone = 7;
      */
-    clarifyingQuestions: string[];
+    userTimezone?: string;
     /**
-     * Status of the concierge finalization. Defaults to SUCCESS (0) for backward compatibility.
+     * Optional user ID (Ethereum address) of the user making the query.
      *
-     * @generated from field: river.ConciergeFinishStatus status = 5;
+     * @generated from field: optional bytes user_id = 8;
      */
-    status: ConciergeFinishStatus;
+    userId?: Uint8Array;
 };
 /**
- * Describes the message river.FinishConversationSeedRequest.
- * Use `create(FinishConversationSeedRequestSchema)` to create a new message.
+ * Describes the message river.AppServiceRequest.ConciergeRequest.
+ * Use `create(AppServiceRequest_ConciergeRequestSchema)` to create a new message.
  */
-export declare const FinishConversationSeedRequestSchema: GenMessage<FinishConversationSeedRequest>;
+export declare const AppServiceRequest_ConciergeRequestSchema: GenMessage<AppServiceRequest_ConciergeRequest>;
 /**
- * @generated from message river.FinishConversationSeedResponse
+ * @generated from message river.AppServiceResponse
  */
-export type FinishConversationSeedResponse = Message<"river.FinishConversationSeedResponse"> & {
+export type AppServiceResponse = Message<"river.AppServiceResponse"> & {
     /**
-     * @generated from field: river.ConversationSeed seed = 1;
+     * @generated from oneof river.AppServiceResponse.payload
      */
-    seed?: ConversationSeed;
+    payload: {
+        /**
+         * @generated from field: river.AppServiceResponse.InitializeResponse initialize = 101;
+         */
+        value: AppServiceResponse_InitializeResponse;
+        case: "initialize";
+    } | {
+        /**
+         * @generated from field: river.AppServiceResponse.StatusResponse status = 102;
+         */
+        value: AppServiceResponse_StatusResponse;
+        case: "status";
+    } | {
+        /**
+         * @generated from field: river.PositionsResponse positions = 103;
+         */
+        value: PositionsResponse;
+        case: "positions";
+    } | {
+        /**
+         * @generated from field: river.AppServiceResponse.ProposalsResponse proposals = 104;
+         */
+        value: AppServiceResponse_ProposalsResponse;
+        case: "proposals";
+    } | {
+        /**
+         * @generated from field: river.AppServiceResponse.ConciergeResponse concierge_response = 105;
+         */
+        value: AppServiceResponse_ConciergeResponse;
+        case: "conciergeResponse";
+    } | {
+        case: undefined;
+        value?: undefined;
+    };
 };
 /**
- * Describes the message river.FinishConversationSeedResponse.
- * Use `create(FinishConversationSeedResponseSchema)` to create a new message.
+ * Describes the message river.AppServiceResponse.
+ * Use `create(AppServiceResponseSchema)` to create a new message.
  */
-export declare const FinishConversationSeedResponseSchema: GenMessage<FinishConversationSeedResponse>;
+export declare const AppServiceResponseSchema: GenMessage<AppServiceResponse>;
 /**
- * GetEntitlementsRequest retrieves the caller's entitlements for a specific app.
- *
- * @generated from message river.GetEntitlementsRequest
+ * @generated from message river.AppServiceResponse.InitializeResponse
  */
-export type GetEntitlementsRequest = Message<"river.GetEntitlementsRequest"> & {
+export type AppServiceResponse_InitializeResponse = Message<"river.AppServiceResponse.InitializeResponse"> & {
     /**
-     * app_id is the address of the app (20 bytes)
-     *
-     * @generated from field: bytes app_id = 1;
+     * @generated from field: river.UserMetadataPayload.EncryptionDevice encryption_device = 1;
      */
-    appId: Uint8Array;
+    encryptionDevice?: UserMetadataPayload_EncryptionDevice;
 };
 /**
- * Describes the message river.GetEntitlementsRequest.
- * Use `create(GetEntitlementsRequestSchema)` to create a new message.
+ * Describes the message river.AppServiceResponse.InitializeResponse.
+ * Use `create(AppServiceResponse_InitializeResponseSchema)` to create a new message.
  */
-export declare const GetEntitlementsRequestSchema: GenMessage<GetEntitlementsRequest>;
+export declare const AppServiceResponse_InitializeResponseSchema: GenMessage<AppServiceResponse_InitializeResponse>;
 /**
- * @generated from message river.GetEntitlementsResponse
+ * @generated from message river.AppServiceResponse.StatusResponse
  */
-export type GetEntitlementsResponse = Message<"river.GetEntitlementsResponse"> & {
+export type AppServiceResponse_StatusResponse = Message<"river.AppServiceResponse.StatusResponse"> & {
     /**
-     * can_set_promoted indicates whether the caller can change the app's promoted status
+     * Version established by the app registry that the bot framework supports.
+     * It indicates protocol compatibility.
      *
-     * @generated from field: bool can_set_promoted = 1;
+     * @generated from field: int32 framework_version = 1;
      */
-    canSetPromoted: boolean;
+    frameworkVersion: number;
     /**
-     * can_set_verified indicates whether the caller can change the app's verified status
-     *
-     * @generated from field: bool can_set_verified = 2;
+     * @generated from field: string device_key = 2;
      */
-    canSetVerified: boolean;
+    deviceKey: string;
     /**
-     * can_set_active indicates whether the caller can change the app's active status
-     *
-     * @generated from field: bool can_set_active = 3;
+     * @generated from field: string fallback_key = 3;
      */
-    canSetActive: boolean;
+    fallbackKey: string;
     /**
-     * can_update_metadata indicates whether the caller can update the app's metadata
+     * Optional metadata used to identify the client SDK version.
+     * Example: "javascript:@towns-labs/app-framework:0.0.1"
      *
-     * @generated from field: bool can_update_metadata = 4;
+     * @generated from field: optional string client_version = 4;
      */
-    canUpdateMetadata: boolean;
+    clientVersion?: string;
+};
+/**
+ * Describes the message river.AppServiceResponse.StatusResponse.
+ * Use `create(AppServiceResponse_StatusResponseSchema)` to create a new message.
+ */
+export declare const AppServiceResponse_StatusResponseSchema: GenMessage<AppServiceResponse_StatusResponse>;
+/**
+ * @generated from message river.AppServiceResponse.ProposalsResponse
+ */
+export type AppServiceResponse_ProposalsResponse = Message<"river.AppServiceResponse.ProposalsResponse"> & {
     /**
-     * is_owner indicates whether the caller is the app's owner
+     * Webhook delivery accepted; processing continues asynchronously.
      *
-     * @generated from field: bool is_owner = 5;
+     * @generated from field: bool accepted = 1;
      */
-    isOwner: boolean;
+    accepted: boolean;
+};
+/**
+ * Describes the message river.AppServiceResponse.ProposalsResponse.
+ * Use `create(AppServiceResponse_ProposalsResponseSchema)` to create a new message.
+ */
+export declare const AppServiceResponse_ProposalsResponseSchema: GenMessage<AppServiceResponse_ProposalsResponse>;
+/**
+ * @generated from message river.AppServiceResponse.ConciergeResponse
+ */
+export type AppServiceResponse_ConciergeResponse = Message<"river.AppServiceResponse.ConciergeResponse"> & {
     /**
-     * is_admin indicates whether the caller is a platform admin
+     * Webhook delivery accepted; processing continues asynchronously.
      *
-     * @generated from field: bool is_admin = 6;
+     * @generated from field: bool accepted = 1;
      */
-    isAdmin: boolean;
+    accepted: boolean;
 };
 /**
- * Describes the message river.GetEntitlementsResponse.
- * Use `create(GetEntitlementsResponseSchema)` to create a new message.
+ * Describes the message river.AppServiceResponse.ConciergeResponse.
+ * Use `create(AppServiceResponse_ConciergeResponseSchema)` to create a new message.
  */
-export declare const GetEntitlementsResponseSchema: GenMessage<GetEntitlementsResponse>;
+export declare const AppServiceResponse_ConciergeResponseSchema: GenMessage<AppServiceResponse_ConciergeResponse>;
 /**
  * ForwardSettingValue is an app-specific setting applied to all space channels the app is a member
  * of. It specifies which messages the app registry service will consider relevant for forwarding to
@@ -2763,7 +2977,13 @@ export declare enum SupportedApi {
      *
      * @generated from enum value: SUPPORTED_API_POSITIONS = 1;
      */
-    POSITIONS = 1
+    POSITIONS = 1,
+    /**
+     * App supports the PNL API (returns PnlResponse via POST /api/user-pnl).
+     *
+     * @generated from enum value: SUPPORTED_API_PNL = 2;
+     */
+    PNL = 2
 }
 /**
  * Describes the enum river.SupportedApi.
@@ -2829,7 +3049,7 @@ export declare const ConciergeFinishStatusSchema: GenEnum<ConciergeFinishStatus>
  * GetStatus, GetAppMetadata, ValidateBotName, GetEntityName, GetBatchEntityNames,
  * ListRegisteredApps, GetBulkAppData, GetAppInstallStats, GetBulkAppInstallStats,
  * GetAppReviews, GetAppReviewSummary, GetBulkAppReviewSummaries,
- * GetBulkAgentCapabilities, QueryConcierge, GetConversationSeed.
+ * GetBulkAgentCapabilities, QueryConcierge, GetConversationSeed, GetBatchAppPnl.
  *
  * @generated from service river.AppRegistryService
  */
@@ -3199,6 +3419,18 @@ export declare const AppRegistryService: GenService<{
         input: typeof GetBatchAppPositionsRequestSchema;
         output: typeof GetBatchAppPositionsResponseSchema;
     };
+    /**
+     * GetBatchAppPnl retrieves PNL data for multiple users from multiple apps.
+     * Apps that don't support PNL will return error entries.
+     * This endpoint does not require authentication.
+     *
+     * @generated from rpc river.AppRegistryService.GetBatchAppPnl
+     */
+    getBatchAppPnl: {
+        methodKind: "unary";
+        input: typeof GetBatchAppPnlRequestSchema;
+        output: typeof GetBatchAppPnlResponseSchema;
+    };
     /**
      * GetBulkAgentCapabilities returns capability manifests for the given specialist agents.
      * This endpoint does not require authentication.