notification

type AddAgentParticipantRequest struct {
	ConversationId  string   `protobuf:"bytes,1,opt,name=conversation_id,json=conversationId,proto3" json:"conversation_id,omitempty"`
	AgentConfigId   string   `protobuf:"bytes,2,opt,name=agent_config_id,json=agentConfigId,proto3" json:"agent_config_id,omitempty"`
	TriggerPolicy   *string  `protobuf:"bytes,3,opt,name=trigger_policy,json=triggerPolicy,proto3,oneof" json:"trigger_policy,omitempty"` // mention | keyword | always (default mention)
	TriggerKeywords []string `protobuf:"bytes,4,rep,name=trigger_keywords,json=triggerKeywords,proto3" json:"trigger_keywords,omitempty"`
	// contains filtered or unexported fields
}

type AddConversationLinkRequest struct {
	ConversationId string `protobuf:"bytes,1,opt,name=conversation_id,json=conversationId,proto3" json:"conversation_id,omitempty"`
	ResourceType   string `protobuf:"bytes,2,opt,name=resource_type,json=resourceType,proto3" json:"resource_type,omitempty"`
	ResourceId     string `protobuf:"bytes,3,opt,name=resource_id,json=resourceId,proto3" json:"resource_id,omitempty"`
	// contains filtered or unexported fields
}

type AddMessagingGroupMemberRequest struct {
	GroupId       string  `protobuf:"bytes,1,opt,name=group_id,json=groupId,proto3" json:"group_id,omitempty"`
	MemberType    string  `protobuf:"bytes,2,opt,name=member_type,json=memberType,proto3" json:"member_type,omitempty"` // user | agent
	AccountUserId *string `protobuf:"bytes,3,opt,name=account_user_id,json=accountUserId,proto3,oneof" json:"account_user_id,omitempty"`
	AgentConfigId *string `protobuf:"bytes,4,opt,name=agent_config_id,json=agentConfigId,proto3,oneof" json:"agent_config_id,omitempty"`
	// contains filtered or unexported fields
}

type AddParticipantRequest struct {
	ConversationId string  `protobuf:"bytes,1,opt,name=conversation_id,json=conversationId,proto3" json:"conversation_id,omitempty"`
	AccountUserId  string  `protobuf:"bytes,2,opt,name=account_user_id,json=accountUserId,proto3" json:"account_user_id,omitempty"`
	Role           *string `protobuf:"bytes,3,opt,name=role,proto3,oneof" json:"role,omitempty"`
	// contains filtered or unexported fields
}

type AnnouncementInfo struct {
	Id               string                 `protobuf:"bytes,1,opt,name=id,proto3" json:"id,omitempty"`
	Scope            string                 `protobuf:"bytes,2,opt,name=scope,proto3" json:"scope,omitempty"` // platform | account
	AccountId        *string                `protobuf:"bytes,3,opt,name=account_id,json=accountId,proto3,oneof" json:"account_id,omitempty"`
	Category         string                 `protobuf:"bytes,4,opt,name=category,proto3" json:"category,omitempty"`
	TemplateKey      *string                `protobuf:"bytes,5,opt,name=template_key,json=templateKey,proto3,oneof" json:"template_key,omitempty"`
	TemplateParams   []byte                 `protobuf:"bytes,6,opt,name=template_params,json=templateParams,proto3" json:"template_params,omitempty"` // raw JSON; absent when empty
	Title            string                 `protobuf:"bytes,7,opt,name=title,proto3" json:"title,omitempty"`
	Body             *string                `protobuf:"bytes,8,opt,name=body,proto3,oneof" json:"body,omitempty"`
	LinkResourceType *string                `protobuf:"bytes,9,opt,name=link_resource_type,json=linkResourceType,proto3,oneof" json:"link_resource_type,omitempty"`
	LinkResourceId   *string                `protobuf:"bytes,10,opt,name=link_resource_id,json=linkResourceId,proto3,oneof" json:"link_resource_id,omitempty"`
	Priority         string                 `protobuf:"bytes,11,opt,name=priority,proto3" json:"priority,omitempty"`
	PublishAt        *timestamppb.Timestamp `protobuf:"bytes,12,opt,name=publish_at,json=publishAt,proto3" json:"publish_at,omitempty"`
	ExpiresAt        *timestamppb.Timestamp `protobuf:"bytes,13,opt,name=expires_at,json=expiresAt,proto3,oneof" json:"expires_at,omitempty"`
	CreatedAt        *timestamppb.Timestamp `protobuf:"bytes,14,opt,name=created_at,json=createdAt,proto3" json:"created_at,omitempty"`
	UpdatedAt        *timestamppb.Timestamp `protobuf:"bytes,15,opt,name=updated_at,json=updatedAt,proto3" json:"updated_at,omitempty"`
	SeenAt           *timestamppb.Timestamp `protobuf:"bytes,16,opt,name=seen_at,json=seenAt,proto3,oneof" json:"seen_at,omitempty"`
	ReadAt           *timestamppb.Timestamp `protobuf:"bytes,17,opt,name=read_at,json=readAt,proto3,oneof" json:"read_at,omitempty"`
	DismissedAt      *timestamppb.Timestamp `protobuf:"bytes,18,opt,name=dismissed_at,json=dismissedAt,proto3,oneof" json:"dismissed_at,omitempty"`
	// contains filtered or unexported fields
}

type ApproveAndSendReplyDraftRequest struct {
	DraftId         string `protobuf:"bytes,1,opt,name=draft_id,json=draftId,proto3" json:"draft_id,omitempty"`
	ClientMessageId string `protobuf:"bytes,2,opt,name=client_message_id,json=clientMessageId,proto3" json:"client_message_id,omitempty"`
	// contains filtered or unexported fields
}

type AssignConversationRequest struct {
	ConversationId string `protobuf:"bytes,1,opt,name=conversation_id,json=conversationId,proto3" json:"conversation_id,omitempty"`
	// Single polymorphic case owner (account_user or account_group). Omit both to clear the assignment.
	AssigneeResourceType *string `` /* 129-byte string literal not displayed */
	AssigneeResourceId   *string `protobuf:"bytes,3,opt,name=assignee_resource_id,json=assigneeResourceId,proto3,oneof" json:"assignee_resource_id,omitempty"`
	// contains filtered or unexported fields
}

type AttachmentInfo struct {
	Id           string                 `protobuf:"bytes,1,opt,name=id,proto3" json:"id,omitempty"`
	Kind         string                 `protobuf:"bytes,2,opt,name=kind,proto3" json:"kind,omitempty"`
	Url          *string                `protobuf:"bytes,3,opt,name=url,proto3,oneof" json:"url,omitempty"`
	Filename     *string                `protobuf:"bytes,4,opt,name=filename,proto3,oneof" json:"filename,omitempty"`
	ContentType  *string                `protobuf:"bytes,5,opt,name=content_type,json=contentType,proto3,oneof" json:"content_type,omitempty"`
	SizeBytes    *int64                 `protobuf:"varint,6,opt,name=size_bytes,json=sizeBytes,proto3,oneof" json:"size_bytes,omitempty"`
	ResourceType *string                `protobuf:"bytes,7,opt,name=resource_type,json=resourceType,proto3,oneof" json:"resource_type,omitempty"`
	ResourceId   *string                `protobuf:"bytes,8,opt,name=resource_id,json=resourceId,proto3,oneof" json:"resource_id,omitempty"`
	CreatedAt    *timestamppb.Timestamp `protobuf:"bytes,9,opt,name=created_at,json=createdAt,proto3" json:"created_at,omitempty"`
	// contains filtered or unexported fields
}

type AttachmentInput struct {
	Kind         string  `protobuf:"bytes,1,opt,name=kind,proto3" json:"kind,omitempty"` // file | image | link | resource
	S3Key        *string `protobuf:"bytes,2,opt,name=s3_key,json=s3Key,proto3,oneof" json:"s3_key,omitempty"`
	Filename     *string `protobuf:"bytes,3,opt,name=filename,proto3,oneof" json:"filename,omitempty"`
	ContentType  *string `protobuf:"bytes,4,opt,name=content_type,json=contentType,proto3,oneof" json:"content_type,omitempty"`
	SizeBytes    *int64  `protobuf:"varint,5,opt,name=size_bytes,json=sizeBytes,proto3,oneof" json:"size_bytes,omitempty"`
	Url          *string `protobuf:"bytes,6,opt,name=url,proto3,oneof" json:"url,omitempty"`
	ResourceType *string `protobuf:"bytes,7,opt,name=resource_type,json=resourceType,proto3,oneof" json:"resource_type,omitempty"`
	ResourceId   *string `protobuf:"bytes,8,opt,name=resource_id,json=resourceId,proto3,oneof" json:"resource_id,omitempty"`
	// contains filtered or unexported fields
}

type AttachmentUploadTargetInfo struct {
	Attachment *AttachmentInfo        `protobuf:"bytes,1,opt,name=attachment,proto3" json:"attachment,omitempty"`
	UploadUrl  string                 `protobuf:"bytes,2,opt,name=upload_url,json=uploadUrl,proto3" json:"upload_url,omitempty"`
	S3Key      string                 `protobuf:"bytes,3,opt,name=s3_key,json=s3Key,proto3" json:"s3_key,omitempty"`
	ExpiresAt  *timestamppb.Timestamp `protobuf:"bytes,4,opt,name=expires_at,json=expiresAt,proto3" json:"expires_at,omitempty"`
	// contains filtered or unexported fields
}

type BatchGetConversationsRequest struct {
	Ids []string `protobuf:"bytes,1,rep,name=ids,proto3" json:"ids,omitempty"`
	// contains filtered or unexported fields
}

type BatchGetConversationsResponse struct {
	Conversations []*ConversationInfo `protobuf:"bytes,1,rep,name=conversations,proto3" json:"conversations,omitempty"`
	// contains filtered or unexported fields
}

type BatchGetMessagesRequest struct {
	Ids []string `protobuf:"bytes,1,rep,name=ids,proto3" json:"ids,omitempty"`
	// contains filtered or unexported fields
}

type BatchGetMessagesResponse struct {
	Messages []*MessageInfo `protobuf:"bytes,1,rep,name=messages,proto3" json:"messages,omitempty"`
	// contains filtered or unexported fields
}

type BlockInfo struct {
	Id                   string                 `protobuf:"bytes,1,opt,name=id,proto3" json:"id,omitempty"`
	AccountId            string                 `protobuf:"bytes,2,opt,name=account_id,json=accountId,proto3" json:"account_id,omitempty"`
	BlockerAccountUserId string                 `protobuf:"bytes,3,opt,name=blocker_account_user_id,json=blockerAccountUserId,proto3" json:"blocker_account_user_id,omitempty"`
	BlockedAccountUserId string                 `protobuf:"bytes,4,opt,name=blocked_account_user_id,json=blockedAccountUserId,proto3" json:"blocked_account_user_id,omitempty"`
	CreatedAt            *timestamppb.Timestamp `protobuf:"bytes,5,opt,name=created_at,json=createdAt,proto3" json:"created_at,omitempty"`
	// contains filtered or unexported fields
}

type BlockRequest struct {
	BlockedAccountUserId string `protobuf:"bytes,1,opt,name=blocked_account_user_id,json=blockedAccountUserId,proto3" json:"blocked_account_user_id,omitempty"`
	// contains filtered or unexported fields
}

type CancelScheduledMessageRequest struct {
	Id string `protobuf:"bytes,1,opt,name=id,proto3" json:"id,omitempty"`
	// contains filtered or unexported fields
}

type ChatAck struct {
	// contains filtered or unexported fields
}

type ChatServiceClient interface {
	// CreateConversation creates a DM (deduped by participant pair) or other conversation type.
	CreateConversation(ctx context.Context, in *CreateConversationRequest, opts ...grpc.CallOption) (*ConversationInfo, error)
	// ListConversations returns the caller's conversations (most-recently-active first).
	ListConversations(ctx context.Context, in *ListConversationsRequest, opts ...grpc.CallOption) (*ListConversationsResponse, error)
	// GetConversation returns one conversation (with participants) the caller belongs to.
	GetConversation(ctx context.Context, in *GetConversationRequest, opts ...grpc.CallOption) (*ConversationInfo, error)
	// BatchGetConversations returns the requested conversations the caller belongs to (for ?include= expansion). Conversations the caller cannot access are omitted.
	BatchGetConversations(ctx context.Context, in *BatchGetConversationsRequest, opts ...grpc.CallOption) (*BatchGetConversationsResponse, error)
	// ContactSupport returns (creating if needed) the calling customer's support conversation.
	ContactSupport(ctx context.Context, in *ContactSupportRequest, opts ...grpc.CallOption) (*ConversationInfo, error)
	// GetSupportAvailability reports whether the calling customer can contact support (the vendor has a
	// configured route with at least one recipient). The portal gates the feature on this.
	GetSupportAvailability(ctx context.Context, in *GetSupportAvailabilityRequest, opts ...grpc.CallOption) (*SupportAvailabilityInfo, error)
	// ── Support routing: which group conversation handles a relationship's inbound support ──
	// SetSupportRoute designates the group conversation that receives a relationship's support; its
	// participants become the deterministic recipients seated on the customer's support thread.
	SetSupportRoute(ctx context.Context, in *SetSupportRouteRequest, opts ...grpc.CallOption) (*SupportRouteInfo, error)
	// ClearSupportRoute removes the route for a scope (account default or a specific relation).
	ClearSupportRoute(ctx context.Context, in *ClearSupportRouteRequest, opts ...grpc.CallOption) (*ChatAck, error)
	// GetSupportRoute returns the route for an exact scope in the caller's account, if any.
	GetSupportRoute(ctx context.Context, in *GetSupportRouteRequest, opts ...grpc.CallOption) (*SupportRouteInfo, error)
	// SendMessage posts a message (idempotent on client_message_id).
	SendMessage(ctx context.Context, in *SendMessageRequest, opts ...grpc.CallOption) (*MessageInfo, error)
	// ListMessages returns a conversation's messages, keyset-paginated by sequence.
	ListMessages(ctx context.Context, in *ListMessagesRequest, opts ...grpc.CallOption) (*ListMessagesResponse, error)
	// BatchGetMessages returns the requested messages from conversations the caller belongs to (for ?include= expansion). Messages the caller cannot access are omitted.
	BatchGetMessages(ctx context.Context, in *BatchGetMessagesRequest, opts ...grpc.CallOption) (*BatchGetMessagesResponse, error)
	// MarkConversationRead advances the caller's read cursor and returns the unread count.
	MarkConversationRead(ctx context.Context, in *MarkConversationReadRequest, opts ...grpc.CallOption) (*MarkConversationReadResponse, error)
	// IsParticipant reports whether the account_user is an active participant (WS authz).
	IsParticipant(ctx context.Context, in *IsParticipantRequest, opts ...grpc.CallOption) (*IsParticipantResponse, error)
	// SendTyping broadcasts an ephemeral typing indicator to the conversation's live subscribers.
	// Best-effort and not persisted (published directly to the realtime fanout, bypassing the outbox).
	SendTyping(ctx context.Context, in *SendTypingRequest, opts ...grpc.CallOption) (*ChatAck, error)
	// ── Phase 3: group management, lifecycle, edit/delete, blocks ──
	UpdateConversation(ctx context.Context, in *UpdateConversationRequest, opts ...grpc.CallOption) (*ConversationInfo, error)
	AddParticipant(ctx context.Context, in *AddParticipantRequest, opts ...grpc.CallOption) (*ConversationInfo, error)
	RemoveParticipant(ctx context.Context, in *RemoveParticipantRequest, opts ...grpc.CallOption) (*ChatAck, error)
	UpdateParticipantRole(ctx context.Context, in *UpdateParticipantRoleRequest, opts ...grpc.CallOption) (*ConversationInfo, error)
	LeaveConversation(ctx context.Context, in *LeaveConversationRequest, opts ...grpc.CallOption) (*ChatAck, error)
	HideConversation(ctx context.Context, in *HideConversationRequest, opts ...grpc.CallOption) (*ChatAck, error)
	UnhideConversation(ctx context.Context, in *UnhideConversationRequest, opts ...grpc.CallOption) (*ChatAck, error)
	SetMute(ctx context.Context, in *SetMuteRequest, opts ...grpc.CallOption) (*ConversationInfo, error)
	Block(ctx context.Context, in *BlockRequest, opts ...grpc.CallOption) (*BlockInfo, error)
	Unblock(ctx context.Context, in *UnblockRequest, opts ...grpc.CallOption) (*ChatAck, error)
	ListBlocks(ctx context.Context, in *ListBlocksRequest, opts ...grpc.CallOption) (*ListBlocksResponse, error)
	// ── Messaging directory + abuse reports ──
	// ListContacts returns the caller's messageable targets (the messaging directory).
	ListContacts(ctx context.Context, in *ListContactsRequest, opts ...grpc.CallOption) (*ListContactsResponse, error)
	// ReportConversation persists a minimal abuse report against a conversation/message.
	ReportConversation(ctx context.Context, in *ReportConversationRequest, opts ...grpc.CallOption) (*MessageReportInfo, error)
	// ── Phase 4: attachment upload pipeline ──
	CreateAttachmentUploadURL(ctx context.Context, in *CreateAttachmentUploadURLRequest, opts ...grpc.CallOption) (*AttachmentUploadTargetInfo, error)
	// ── Phase 5: scheduled messages (status=scheduled message rows) ──
	ScheduleMessage(ctx context.Context, in *ScheduleMessageRequest, opts ...grpc.CallOption) (*MessageInfo, error)
	ListScheduledMessages(ctx context.Context, in *ListScheduledMessagesRequest, opts ...grpc.CallOption) (*ListScheduledMessagesResponse, error)
	CancelScheduledMessage(ctx context.Context, in *CancelScheduledMessageRequest, opts ...grpc.CallOption) (*MessageInfo, error)
	// ── Phase 5: agents as participants ──
	AddAgentParticipant(ctx context.Context, in *AddAgentParticipantRequest, opts ...grpc.CallOption) (*ParticipantInfo, error)
	RemoveAgentParticipant(ctx context.Context, in *RemoveAgentParticipantRequest, opts ...grpc.CallOption) (*ChatAck, error)
	// ── Phase 6: GDPR redaction + legal hold ──
	SetLegalHold(ctx context.Context, in *SetLegalHoldRequest, opts ...grpc.CallOption) (*ConversationInfo, error)
	RedactConversation(ctx context.Context, in *RedactConversationRequest, opts ...grpc.CallOption) (*ConversationInfo, error)
	// ── External customer-service cases: triage, assignment, links, drafts ──
	// (A staff customer-visible reply is the folded-in SendMessage path, visibility=external.)
	// UpdateConversationWorkflow sets an external case's triage lane.
	UpdateConversationWorkflow(ctx context.Context, in *UpdateConversationWorkflowRequest, opts ...grpc.CallOption) (*ConversationInfo, error)
	// AssignConversation sets or clears the owning user/team for an external case.
	AssignConversation(ctx context.Context, in *AssignConversationRequest, opts ...grpc.CallOption) (*ConversationInfo, error)
	// ListInbox lists external customer-facing cases for the support inbox.
	ListInbox(ctx context.Context, in *ListInboxRequest, opts ...grpc.CallOption) (*ListConversationsResponse, error)
	// ListConversationsByResource lists conversations linked to a business record (topic or link).
	ListConversationsByResource(ctx context.Context, in *ListConversationsByResourceRequest, opts ...grpc.CallOption) (*ListConversationsResponse, error)
	// AddConversationLink links a business record to a conversation.
	AddConversationLink(ctx context.Context, in *AddConversationLinkRequest, opts ...grpc.CallOption) (*ConversationLinkInfo, error)
	// RemoveConversationLink removes a business-record link from a conversation.
	RemoveConversationLink(ctx context.Context, in *RemoveConversationLinkRequest, opts ...grpc.CallOption) (*ChatAck, error)
	// ListConversationLinks lists a conversation's business-record links.
	ListConversationLinks(ctx context.Context, in *ListConversationLinksRequest, opts ...grpc.CallOption) (*ListConversationLinksResponse, error)
	// CreateReplyDraft proposes a customer-reply draft on an external case (a message at status=draft).
	CreateReplyDraft(ctx context.Context, in *CreateReplyDraftRequest, opts ...grpc.CallOption) (*MessageInfo, error)
	// ListReplyDrafts lists a case's reply drafts (optionally filtered by status).
	ListReplyDrafts(ctx context.Context, in *ListReplyDraftsRequest, opts ...grpc.CallOption) (*ListReplyDraftsResponse, error)
	// UpdateReplyDraft edits a still-open draft's body/subject.
	UpdateReplyDraft(ctx context.Context, in *UpdateReplyDraftRequest, opts ...grpc.CallOption) (*MessageInfo, error)
	// RejectReplyDraft discards an open draft without sending.
	RejectReplyDraft(ctx context.Context, in *RejectReplyDraftRequest, opts ...grpc.CallOption) (*MessageInfo, error)
	// ApproveAndSendReplyDraft promotes an open draft to a sent customer-visible message in place.
	ApproveAndSendReplyDraft(ctx context.Context, in *ApproveAndSendReplyDraftRequest, opts ...grpc.CallOption) (*MessageInfo, error)
	// ── Reusable groups (rosters): named member sets that seed many conversations ──
	// CreateMessagingGroup creates a named roster of users and/or agents.
	CreateMessagingGroup(ctx context.Context, in *CreateMessagingGroupRequest, opts ...grpc.CallOption) (*MessagingGroupInfo, error)
	// ListMessagingGroups returns the account's rosters (most-recently-updated first).
	ListMessagingGroups(ctx context.Context, in *ListMessagingGroupsRequest, opts ...grpc.CallOption) (*ListMessagingGroupsResponse, error)
	// GetMessagingGroup returns one roster with its members.
	GetMessagingGroup(ctx context.Context, in *GetMessagingGroupRequest, opts ...grpc.CallOption) (*MessagingGroupInfo, error)
	// UpdateMessagingGroup renames a roster.
	UpdateMessagingGroup(ctx context.Context, in *UpdateMessagingGroupRequest, opts ...grpc.CallOption) (*MessagingGroupInfo, error)
	// DeleteMessagingGroup deletes a roster (nulling group_id on any conversations it seeded).
	DeleteMessagingGroup(ctx context.Context, in *DeleteMessagingGroupRequest, opts ...grpc.CallOption) (*ChatAck, error)
	// AddMessagingGroupMember adds a user or agent to a roster.
	AddMessagingGroupMember(ctx context.Context, in *AddMessagingGroupMemberRequest, opts ...grpc.CallOption) (*MessagingGroupInfo, error)
	// RemoveMessagingGroupMember removes a member from a roster.
	RemoveMessagingGroupMember(ctx context.Context, in *RemoveMessagingGroupMemberRequest, opts ...grpc.CallOption) (*MessagingGroupInfo, error)
}

type ChatServiceServer interface {
	// CreateConversation creates a DM (deduped by participant pair) or other conversation type.
	CreateConversation(context.Context, *CreateConversationRequest) (*ConversationInfo, error)
	// ListConversations returns the caller's conversations (most-recently-active first).
	ListConversations(context.Context, *ListConversationsRequest) (*ListConversationsResponse, error)
	// GetConversation returns one conversation (with participants) the caller belongs to.
	GetConversation(context.Context, *GetConversationRequest) (*ConversationInfo, error)
	// BatchGetConversations returns the requested conversations the caller belongs to (for ?include= expansion). Conversations the caller cannot access are omitted.
	BatchGetConversations(context.Context, *BatchGetConversationsRequest) (*BatchGetConversationsResponse, error)
	// ContactSupport returns (creating if needed) the calling customer's support conversation.
	ContactSupport(context.Context, *ContactSupportRequest) (*ConversationInfo, error)
	// GetSupportAvailability reports whether the calling customer can contact support (the vendor has a
	// configured route with at least one recipient). The portal gates the feature on this.
	GetSupportAvailability(context.Context, *GetSupportAvailabilityRequest) (*SupportAvailabilityInfo, error)
	// ── Support routing: which group conversation handles a relationship's inbound support ──
	// SetSupportRoute designates the group conversation that receives a relationship's support; its
	// participants become the deterministic recipients seated on the customer's support thread.
	SetSupportRoute(context.Context, *SetSupportRouteRequest) (*SupportRouteInfo, error)
	// ClearSupportRoute removes the route for a scope (account default or a specific relation).
	ClearSupportRoute(context.Context, *ClearSupportRouteRequest) (*ChatAck, error)
	// GetSupportRoute returns the route for an exact scope in the caller's account, if any.
	GetSupportRoute(context.Context, *GetSupportRouteRequest) (*SupportRouteInfo, error)
	// SendMessage posts a message (idempotent on client_message_id).
	SendMessage(context.Context, *SendMessageRequest) (*MessageInfo, error)
	// ListMessages returns a conversation's messages, keyset-paginated by sequence.
	ListMessages(context.Context, *ListMessagesRequest) (*ListMessagesResponse, error)
	// BatchGetMessages returns the requested messages from conversations the caller belongs to (for ?include= expansion). Messages the caller cannot access are omitted.
	BatchGetMessages(context.Context, *BatchGetMessagesRequest) (*BatchGetMessagesResponse, error)
	// MarkConversationRead advances the caller's read cursor and returns the unread count.
	MarkConversationRead(context.Context, *MarkConversationReadRequest) (*MarkConversationReadResponse, error)
	// IsParticipant reports whether the account_user is an active participant (WS authz).
	IsParticipant(context.Context, *IsParticipantRequest) (*IsParticipantResponse, error)
	// SendTyping broadcasts an ephemeral typing indicator to the conversation's live subscribers.
	// Best-effort and not persisted (published directly to the realtime fanout, bypassing the outbox).
	SendTyping(context.Context, *SendTypingRequest) (*ChatAck, error)
	// ── Phase 3: group management, lifecycle, edit/delete, blocks ──
	UpdateConversation(context.Context, *UpdateConversationRequest) (*ConversationInfo, error)
	AddParticipant(context.Context, *AddParticipantRequest) (*ConversationInfo, error)
	RemoveParticipant(context.Context, *RemoveParticipantRequest) (*ChatAck, error)
	UpdateParticipantRole(context.Context, *UpdateParticipantRoleRequest) (*ConversationInfo, error)
	LeaveConversation(context.Context, *LeaveConversationRequest) (*ChatAck, error)
	HideConversation(context.Context, *HideConversationRequest) (*ChatAck, error)
	UnhideConversation(context.Context, *UnhideConversationRequest) (*ChatAck, error)
	SetMute(context.Context, *SetMuteRequest) (*ConversationInfo, error)
	Block(context.Context, *BlockRequest) (*BlockInfo, error)
	Unblock(context.Context, *UnblockRequest) (*ChatAck, error)
	ListBlocks(context.Context, *ListBlocksRequest) (*ListBlocksResponse, error)
	// ── Messaging directory + abuse reports ──
	// ListContacts returns the caller's messageable targets (the messaging directory).
	ListContacts(context.Context, *ListContactsRequest) (*ListContactsResponse, error)
	// ReportConversation persists a minimal abuse report against a conversation/message.
	ReportConversation(context.Context, *ReportConversationRequest) (*MessageReportInfo, error)
	// ── Phase 4: attachment upload pipeline ──
	CreateAttachmentUploadURL(context.Context, *CreateAttachmentUploadURLRequest) (*AttachmentUploadTargetInfo, error)
	// ── Phase 5: scheduled messages (status=scheduled message rows) ──
	ScheduleMessage(context.Context, *ScheduleMessageRequest) (*MessageInfo, error)
	ListScheduledMessages(context.Context, *ListScheduledMessagesRequest) (*ListScheduledMessagesResponse, error)
	CancelScheduledMessage(context.Context, *CancelScheduledMessageRequest) (*MessageInfo, error)
	// ── Phase 5: agents as participants ──
	AddAgentParticipant(context.Context, *AddAgentParticipantRequest) (*ParticipantInfo, error)
	RemoveAgentParticipant(context.Context, *RemoveAgentParticipantRequest) (*ChatAck, error)
	// ── Phase 6: GDPR redaction + legal hold ──
	SetLegalHold(context.Context, *SetLegalHoldRequest) (*ConversationInfo, error)
	RedactConversation(context.Context, *RedactConversationRequest) (*ConversationInfo, error)
	// ── External customer-service cases: triage, assignment, links, drafts ──
	// (A staff customer-visible reply is the folded-in SendMessage path, visibility=external.)
	// UpdateConversationWorkflow sets an external case's triage lane.
	UpdateConversationWorkflow(context.Context, *UpdateConversationWorkflowRequest) (*ConversationInfo, error)
	// AssignConversation sets or clears the owning user/team for an external case.
	AssignConversation(context.Context, *AssignConversationRequest) (*ConversationInfo, error)
	// ListInbox lists external customer-facing cases for the support inbox.
	ListInbox(context.Context, *ListInboxRequest) (*ListConversationsResponse, error)
	// ListConversationsByResource lists conversations linked to a business record (topic or link).
	ListConversationsByResource(context.Context, *ListConversationsByResourceRequest) (*ListConversationsResponse, error)
	// AddConversationLink links a business record to a conversation.
	AddConversationLink(context.Context, *AddConversationLinkRequest) (*ConversationLinkInfo, error)
	// RemoveConversationLink removes a business-record link from a conversation.
	RemoveConversationLink(context.Context, *RemoveConversationLinkRequest) (*ChatAck, error)
	// ListConversationLinks lists a conversation's business-record links.
	ListConversationLinks(context.Context, *ListConversationLinksRequest) (*ListConversationLinksResponse, error)
	// CreateReplyDraft proposes a customer-reply draft on an external case (a message at status=draft).
	CreateReplyDraft(context.Context, *CreateReplyDraftRequest) (*MessageInfo, error)
	// ListReplyDrafts lists a case's reply drafts (optionally filtered by status).
	ListReplyDrafts(context.Context, *ListReplyDraftsRequest) (*ListReplyDraftsResponse, error)
	// UpdateReplyDraft edits a still-open draft's body/subject.
	UpdateReplyDraft(context.Context, *UpdateReplyDraftRequest) (*MessageInfo, error)
	// RejectReplyDraft discards an open draft without sending.
	RejectReplyDraft(context.Context, *RejectReplyDraftRequest) (*MessageInfo, error)
	// ApproveAndSendReplyDraft promotes an open draft to a sent customer-visible message in place.
	ApproveAndSendReplyDraft(context.Context, *ApproveAndSendReplyDraftRequest) (*MessageInfo, error)
	// ── Reusable groups (rosters): named member sets that seed many conversations ──
	// CreateMessagingGroup creates a named roster of users and/or agents.
	CreateMessagingGroup(context.Context, *CreateMessagingGroupRequest) (*MessagingGroupInfo, error)
	// ListMessagingGroups returns the account's rosters (most-recently-updated first).
	ListMessagingGroups(context.Context, *ListMessagingGroupsRequest) (*ListMessagingGroupsResponse, error)
	// GetMessagingGroup returns one roster with its members.
	GetMessagingGroup(context.Context, *GetMessagingGroupRequest) (*MessagingGroupInfo, error)
	// UpdateMessagingGroup renames a roster.
	UpdateMessagingGroup(context.Context, *UpdateMessagingGroupRequest) (*MessagingGroupInfo, error)
	// DeleteMessagingGroup deletes a roster (nulling group_id on any conversations it seeded).
	DeleteMessagingGroup(context.Context, *DeleteMessagingGroupRequest) (*ChatAck, error)
	// AddMessagingGroupMember adds a user or agent to a roster.
	AddMessagingGroupMember(context.Context, *AddMessagingGroupMemberRequest) (*MessagingGroupInfo, error)
	// RemoveMessagingGroupMember removes a member from a roster.
	RemoveMessagingGroupMember(context.Context, *RemoveMessagingGroupMemberRequest) (*MessagingGroupInfo, error)
	// contains filtered or unexported methods
}

type ClearSupportRouteRequest struct {
	RelationAccountId string `protobuf:"bytes,1,opt,name=relation_account_id,json=relationAccountId,proto3" json:"relation_account_id,omitempty"` // "" = account default
	// contains filtered or unexported fields
}

type ContactInfo struct {
	Type          string  `protobuf:"bytes,1,opt,name=type,proto3" json:"type,omitempty"`
	AccountUserId *string `protobuf:"bytes,2,opt,name=account_user_id,json=accountUserId,proto3,oneof" json:"account_user_id,omitempty"`
	Name          string  `protobuf:"bytes,3,opt,name=name,proto3" json:"name,omitempty"`
	// contains filtered or unexported fields
}

type ContactSupportRequest struct {
	// contains filtered or unexported fields
}

type ConversationInfo struct {
	Id                string                 `protobuf:"bytes,1,opt,name=id,proto3" json:"id,omitempty"`
	AccountId         string                 `protobuf:"bytes,2,opt,name=account_id,json=accountId,proto3" json:"account_id,omitempty"`
	Type              string                 `protobuf:"bytes,3,opt,name=type,proto3" json:"type,omitempty"`
	Title             *string                `protobuf:"bytes,4,opt,name=title,proto3,oneof" json:"title,omitempty"`
	TopicResourceType *string                `protobuf:"bytes,5,opt,name=topic_resource_type,json=topicResourceType,proto3,oneof" json:"topic_resource_type,omitempty"`
	TopicResourceId   *string                `protobuf:"bytes,6,opt,name=topic_resource_id,json=topicResourceId,proto3,oneof" json:"topic_resource_id,omitempty"`
	LastMessageId     *string                `protobuf:"bytes,8,opt,name=last_message_id,json=lastMessageId,proto3,oneof" json:"last_message_id,omitempty"`
	LastMessageAt     *timestamppb.Timestamp `protobuf:"bytes,9,opt,name=last_message_at,json=lastMessageAt,proto3,oneof" json:"last_message_at,omitempty"`
	Status            string                 `protobuf:"bytes,10,opt,name=status,proto3" json:"status,omitempty"` // active | archived
	Unread            int64                  `protobuf:"varint,11,opt,name=unread,proto3" json:"unread,omitempty"`
	CreatedAt         *timestamppb.Timestamp `protobuf:"bytes,12,opt,name=created_at,json=createdAt,proto3" json:"created_at,omitempty"`
	UpdatedAt         *timestamppb.Timestamp `protobuf:"bytes,13,opt,name=updated_at,json=updatedAt,proto3" json:"updated_at,omitempty"`
	Participants      []*ParticipantInfo     `protobuf:"bytes,14,rep,name=participants,proto3" json:"participants,omitempty"`
	LegalHold         bool                   `protobuf:"varint,15,opt,name=legal_hold,json=legalHold,proto3" json:"legal_hold,omitempty"`
	// The most recent message in the conversation, embedded for inbox list previews so
	// clients don't issue an N+1 fetch per row. Absent when the conversation has no messages.
	LastMessage *MessageInfo `protobuf:"bytes,16,opt,name=last_message,json=lastMessage,proto3,oneof" json:"last_message,omitempty"`
	// Whether the conversation is hidden for the calling participant.
	Hidden bool `protobuf:"varint,17,opt,name=hidden,proto3" json:"hidden,omitempty"`
	// Audience: "internal" (team-only) or "customer" (external customer-facing case).
	Audience string `protobuf:"bytes,18,opt,name=audience,proto3" json:"audience,omitempty"`
	// Customer-service case triage (audience=customer only; absent on internal conversations).
	WorkflowStatus *string `protobuf:"bytes,19,opt,name=workflow_status,json=workflowStatus,proto3,oneof" json:"workflow_status,omitempty"`
	// Single polymorphic case owner: an account_user or an account_group (type + id).
	AssigneeResourceType *string `` /* 130-byte string literal not displayed */
	AssigneeResourceId   *string `protobuf:"bytes,21,opt,name=assignee_resource_id,json=assigneeResourceId,proto3,oneof" json:"assignee_resource_id,omitempty"`
	// The email inbox this case is bridged to, when applicable (replies route through it).
	EmailInboxId *string `protobuf:"bytes,22,opt,name=email_inbox_id,json=emailInboxId,proto3,oneof" json:"email_inbox_id,omitempty"`
	// Secondary business-record links on the conversation.
	Links []*ConversationLinkInfo `protobuf:"bytes,23,rep,name=links,proto3" json:"links,omitempty"`
	// The reusable roster (messaging_group.id) this conversation was seeded from, if any. Provenance
	// only — members were snapshotted at create time and are not driven by the group thereafter.
	GroupId *string `protobuf:"bytes,24,opt,name=group_id,json=groupId,proto3,oneof" json:"group_id,omitempty"`
	// contains filtered or unexported fields
}

type ConversationLinkInfo struct {
	Id                     string                 `protobuf:"bytes,1,opt,name=id,proto3" json:"id,omitempty"`
	AccountId              string                 `protobuf:"bytes,2,opt,name=account_id,json=accountId,proto3" json:"account_id,omitempty"`
	ConversationId         string                 `protobuf:"bytes,3,opt,name=conversation_id,json=conversationId,proto3" json:"conversation_id,omitempty"`
	ResourceType           string                 `protobuf:"bytes,4,opt,name=resource_type,json=resourceType,proto3" json:"resource_type,omitempty"`
	ResourceId             string                 `protobuf:"bytes,5,opt,name=resource_id,json=resourceId,proto3" json:"resource_id,omitempty"`
	CreatedByParticipantId *string                `` /* 137-byte string literal not displayed */
	CreatedAt              *timestamppb.Timestamp `protobuf:"bytes,7,opt,name=created_at,json=createdAt,proto3" json:"created_at,omitempty"`
	// contains filtered or unexported fields
}

type CreateAttachmentUploadURLRequest struct {
	ConversationId string  `protobuf:"bytes,1,opt,name=conversation_id,json=conversationId,proto3" json:"conversation_id,omitempty"`
	Filename       string  `protobuf:"bytes,2,opt,name=filename,proto3" json:"filename,omitempty"`
	ContentType    *string `protobuf:"bytes,3,opt,name=content_type,json=contentType,proto3,oneof" json:"content_type,omitempty"`
	// contains filtered or unexported fields
}

type CreateConversationRequest struct {
	Type                      string   `protobuf:"bytes,1,opt,name=type,proto3" json:"type,omitempty"`
	ParticipantAccountUserIds []string `` /* 140-byte string literal not displayed */
	Title                     *string  `protobuf:"bytes,3,opt,name=title,proto3,oneof" json:"title,omitempty"`
	TopicResourceType         *string  `protobuf:"bytes,4,opt,name=topic_resource_type,json=topicResourceType,proto3,oneof" json:"topic_resource_type,omitempty"`
	TopicResourceId           *string  `protobuf:"bytes,5,opt,name=topic_resource_id,json=topicResourceId,proto3,oneof" json:"topic_resource_id,omitempty"`
	// When set, seed the conversation from a reusable roster (messaging_group.id): its members are
	// snapshotted into participants (in addition to any participant_account_user_ids) and the
	// conversation records this group_id as provenance. Agent members default to mention trigger.
	GroupId *string `protobuf:"bytes,6,opt,name=group_id,json=groupId,proto3,oneof" json:"group_id,omitempty"`
	// contains filtered or unexported fields
}

type CreateEmailDomainRequest struct {
	Domain string `protobuf:"bytes,1,opt,name=domain,proto3" json:"domain,omitempty"`
	// contains filtered or unexported fields
}

type CreateEmailInboxRequest struct {
	EmailDomainId        string   `protobuf:"bytes,1,opt,name=email_domain_id,json=emailDomainId,proto3" json:"email_domain_id,omitempty"`
	Address              string   `protobuf:"bytes,2,opt,name=address,proto3" json:"address,omitempty"`
	FromName             *string  `protobuf:"bytes,3,opt,name=from_name,json=fromName,proto3,oneof" json:"from_name,omitempty"`
	AgentConfigId        *string  `protobuf:"bytes,4,opt,name=agent_config_id,json=agentConfigId,proto3,oneof" json:"agent_config_id,omitempty"`
	AgentTriggerPolicy   *string  `protobuf:"bytes,5,opt,name=agent_trigger_policy,json=agentTriggerPolicy,proto3,oneof" json:"agent_trigger_policy,omitempty"`
	AgentTriggerKeywords []string `protobuf:"bytes,6,rep,name=agent_trigger_keywords,json=agentTriggerKeywords,proto3" json:"agent_trigger_keywords,omitempty"`
	GroupId              *string  `protobuf:"bytes,7,opt,name=group_id,json=groupId,proto3,oneof" json:"group_id,omitempty"`
	// contains filtered or unexported fields
}

type CreateMessagingGroupRequest struct {
	Name                 string   `protobuf:"bytes,1,opt,name=name,proto3" json:"name,omitempty"`
	MemberAccountUserIds []string `protobuf:"bytes,2,rep,name=member_account_user_ids,json=memberAccountUserIds,proto3" json:"member_account_user_ids,omitempty"`
	MemberAgentConfigIds []string `protobuf:"bytes,3,rep,name=member_agent_config_ids,json=memberAgentConfigIds,proto3" json:"member_agent_config_ids,omitempty"`
	// contains filtered or unexported fields
}

type CreateReplyDraftRequest struct {
	ConversationId        string  `protobuf:"bytes,1,opt,name=conversation_id,json=conversationId,proto3" json:"conversation_id,omitempty"`
	Channel               string  `protobuf:"bytes,2,opt,name=channel,proto3" json:"channel,omitempty"` // message | email
	Body                  string  `protobuf:"bytes,3,opt,name=body,proto3" json:"body,omitempty"`
	Subject               *string `protobuf:"bytes,4,opt,name=subject,proto3,oneof" json:"subject,omitempty"`
	SourceThreadMessageId *string `` /* 134-byte string literal not displayed */
	// contains filtered or unexported fields
}

type DeleteEmailDomainRequest struct {
	Id string `protobuf:"bytes,1,opt,name=id,proto3" json:"id,omitempty"`
	// contains filtered or unexported fields
}

type DeleteEmailInboxRequest struct {
	Id string `protobuf:"bytes,1,opt,name=id,proto3" json:"id,omitempty"`
	// contains filtered or unexported fields
}

type DeleteMessagingGroupRequest struct {
	GroupId string `protobuf:"bytes,1,opt,name=group_id,json=groupId,proto3" json:"group_id,omitempty"`
	// contains filtered or unexported fields
}

type EmailBridgeAck struct {
	Ok bool `protobuf:"varint,1,opt,name=ok,proto3" json:"ok,omitempty"`
	// contains filtered or unexported fields
}

type EmailBridgeServiceClient interface {
	// CreateEmailDomain registers a customer-owned domain with SES (Easy DKIM) and returns the DKIM
	// records the customer must publish; the domain starts in status=pending.
	CreateEmailDomain(ctx context.Context, in *CreateEmailDomainRequest, opts ...grpc.CallOption) (*EmailDomainInfo, error)
	// ListEmailDomains returns the caller account's registered domains.
	ListEmailDomains(ctx context.Context, in *ListEmailDomainsRequest, opts ...grpc.CallOption) (*ListEmailDomainsResponse, error)
	// GetEmailDomain returns a single domain owned by the caller account.
	GetEmailDomain(ctx context.Context, in *GetEmailDomainRequest, opts ...grpc.CallOption) (*EmailDomainInfo, error)
	// VerifyEmailDomain re-polls SES and flips the domain to verified once DKIM is confirmed.
	VerifyEmailDomain(ctx context.Context, in *VerifyEmailDomainRequest, opts ...grpc.CallOption) (*EmailDomainInfo, error)
	// DeleteEmailDomain deregisters a domain (deleting its SES identity) once it has no inboxes.
	DeleteEmailDomain(ctx context.Context, in *DeleteEmailDomainRequest, opts ...grpc.CallOption) (*EmailBridgeAck, error)
	// CreateEmailInbox provisions a routable inbox address on a verified domain.
	CreateEmailInbox(ctx context.Context, in *CreateEmailInboxRequest, opts ...grpc.CallOption) (*EmailInboxInfo, error)
	// ListEmailInboxes returns the caller account's inboxes.
	ListEmailInboxes(ctx context.Context, in *ListEmailInboxesRequest, opts ...grpc.CallOption) (*ListEmailInboxesResponse, error)
	// GetEmailInbox returns a single inbox owned by the caller account.
	GetEmailInbox(ctx context.Context, in *GetEmailInboxRequest, opts ...grpc.CallOption) (*EmailInboxInfo, error)
	// UpdateEmailInbox edits an inbox's from-name, status, and default agent trigger config.
	UpdateEmailInbox(ctx context.Context, in *UpdateEmailInboxRequest, opts ...grpc.CallOption) (*EmailInboxInfo, error)
	// DeleteEmailInbox removes an inbox.
	DeleteEmailInbox(ctx context.Context, in *DeleteEmailInboxRequest, opts ...grpc.CallOption) (*EmailBridgeAck, error)
	// SendInboxReply sends an agent's outbound email reply through the conversation's bound inbox
	// (SES, threaded under the latest inbound mail) and posts it into the thread. Called by
	// agent-service when an approved send_email tool executes.
	SendInboxReply(ctx context.Context, in *SendInboxReplyRequest, opts ...grpc.CallOption) (*EmailMessageRef, error)
	// PostReplyDraft proposes an agent's customer reply as a real status=draft message held for human
	// approval (channel resolved from the case: email if bridged, else a portal message). Called by
	// agent-service when the draft_customer_reply tool executes; the draft surfaces in the reply-drafts
	// bar for a human to edit/approve/send.
	PostReplyDraft(ctx context.Context, in *PostReplyDraftRequest, opts ...grpc.CallOption) (*EmailMessageRef, error)
}