@aepstore-dev/contracts 1.105.0 → 1.107.0

package/gen/payments.d.ts

@@ -3,6 +3,23 @@ export declare const protobufPackage = "payments.v1";
 export interface Ok {
     ok: boolean;
 }
+export interface GetSupportPurchasesContextRequest {
+    userId: string;
+    /** clamped to 1..5 by payments-service */
+    limit: number;
+}
+export interface SupportPurchaseContext {
+    purchaseId: string;
+    status: string;
+    createdAt: string;
+    completedAt: string;
+    productId: string;
+    productName: string;
+    accessStatus: string;
+}
+export interface SupportPurchasesContext {
+    items: SupportPurchaseContext[];
+}
 /**
  * ---------------------------------------------------------------------------
  * Purchase / checkout / topup
@@ -638,6 +655,11 @@ export interface PaymentsServiceClient {
     getMyPurchases(request: GetMyPurchasesRequest): Observable<PurchasesListResponse>;
     getPurchase(request: GetPurchaseRequest): Observable<Purchase>;
     refundPurchase(request: RefundPurchaseRequest): Observable<Purchase>;
+    /**
+     * Internal, read-only purchase summary for support AI. No money-provider,
+     * card, ledger, payout or withdrawal data is exposed.
+     */
+    getSupportPurchasesContext(request: GetSupportPurchasesContextRequest): Observable<SupportPurchasesContext>;
     /** ----- wallet ----- */
     getWallet(request: GetWalletRequest): Observable<WalletResponse>;
     listTransactions(request: ListTransactionsRequest): Observable<TransactionsListResponse>;
@@ -720,6 +742,11 @@ export interface PaymentsServiceController {
     getMyPurchases(request: GetMyPurchasesRequest): Promise<PurchasesListResponse> | Observable<PurchasesListResponse> | PurchasesListResponse;
     getPurchase(request: GetPurchaseRequest): Promise<Purchase> | Observable<Purchase> | Purchase;
     refundPurchase(request: RefundPurchaseRequest): Promise<Purchase> | Observable<Purchase> | Purchase;
+    /**
+     * Internal, read-only purchase summary for support AI. No money-provider,
+     * card, ledger, payout or withdrawal data is exposed.
+     */
+    getSupportPurchasesContext(request: GetSupportPurchasesContextRequest): Promise<SupportPurchasesContext> | Observable<SupportPurchasesContext> | SupportPurchasesContext;
     /** ----- wallet ----- */
     getWallet(request: GetWalletRequest): Promise<WalletResponse> | Observable<WalletResponse> | WalletResponse;
     listTransactions(request: ListTransactionsRequest): Promise<TransactionsListResponse> | Observable<TransactionsListResponse> | TransactionsListResponse;

package/gen/payments.js

@@ -19,6 +19,7 @@ function PaymentsServiceControllerMethods() {
             "getMyPurchases",
             "getPurchase",
             "refundPurchase",
+            "getSupportPurchasesContext",
             "getWallet",
             "listTransactions",
             "getTransactionMonths",

package/gen/payments.ts

@@ -14,6 +14,26 @@ export interface Ok {
   ok: boolean;
 }
 
+export interface GetSupportPurchasesContextRequest {
+  userId: string;
+  /** clamped to 1..5 by payments-service */
+  limit: number;
+}
+
+export interface SupportPurchaseContext {
+  purchaseId: string;
+  status: string;
+  createdAt: string;
+  completedAt: string;
+  productId: string;
+  productName: string;
+  accessStatus: string;
+}
+
+export interface SupportPurchasesContext {
+  items: SupportPurchaseContext[];
+}
+
 /**
  * ---------------------------------------------------------------------------
  * Purchase / checkout / topup
@@ -730,6 +750,13 @@ export interface PaymentsServiceClient {
 
   refundPurchase(request: RefundPurchaseRequest): Observable<Purchase>;
 
+  /**
+   * Internal, read-only purchase summary for support AI. No money-provider,
+   * card, ledger, payout or withdrawal data is exposed.
+   */
+
+  getSupportPurchasesContext(request: GetSupportPurchasesContextRequest): Observable<SupportPurchasesContext>;
+
   /** ----- wallet ----- */
 
   getWallet(request: GetWalletRequest): Observable<WalletResponse>;
@@ -867,6 +894,15 @@ export interface PaymentsServiceController {
 
   refundPurchase(request: RefundPurchaseRequest): Promise<Purchase> | Observable<Purchase> | Purchase;
 
+  /**
+   * Internal, read-only purchase summary for support AI. No money-provider,
+   * card, ledger, payout or withdrawal data is exposed.
+   */
+
+  getSupportPurchasesContext(
+    request: GetSupportPurchasesContextRequest,
+  ): Promise<SupportPurchasesContext> | Observable<SupportPurchasesContext> | SupportPurchasesContext;
+
   /** ----- wallet ----- */
 
   getWallet(request: GetWalletRequest): Promise<WalletResponse> | Observable<WalletResponse> | WalletResponse;
@@ -1027,6 +1063,7 @@ export function PaymentsServiceControllerMethods() {
       "getMyPurchases",
       "getPurchase",
       "refundPurchase",
+      "getSupportPurchasesContext",
       "getWallet",
       "listTransactions",
       "getTransactionMonths",

package/gen/support.d.ts

@@ -46,6 +46,9 @@ export interface Ticket {
     reportedAt: string;
     /** SUPPORT|USER, empty when no one is expected (e.g. CLOSED) */
     waitingFor: string;
+    /** WEB|TELEGRAM */
+    originChannel: string;
+    contactId: string;
 }
 export interface TicketAssignee {
     id: string;
@@ -78,6 +81,14 @@ export interface TicketMessage {
     isReadByStaff: boolean;
     /** first known staff read timestamp for this message, '' if unread */
     staffReadAt: string;
+    /** USER|GUEST|STAFF|AI|SYSTEM */
+    authorType: string;
+    aiCitations: AiCitation[];
+}
+export interface AiCitation {
+    sourceId: string;
+    title: string;
+    reference: string;
 }
 export interface TicketAttachment {
     fileName: string;
@@ -327,6 +338,117 @@ export interface TicketsListResponse {
     page: number;
     limit: number;
 }
+export interface ChannelIdentity {
+    channel: string;
+    externalUserId: string;
+    externalChatId: string;
+    username: string;
+    displayName: string;
+    locale: string;
+}
+export interface GetChannelSessionRequest {
+    identity: ChannelIdentity | undefined;
+    correlationId: string;
+}
+export interface ChannelSession {
+    identityId: string;
+    contactId: string;
+    userId: string;
+    isLinked: boolean;
+    activeTicket: Ticket | undefined;
+}
+export interface CreateChannelTicketRequest {
+    identity: ChannelIdentity | undefined;
+    externalEventId: string;
+    idempotencyKey: string;
+    correlationId: string;
+    subject: string;
+    body: string;
+    category: string;
+}
+export interface AppendChannelMessageRequest {
+    identity: ChannelIdentity | undefined;
+    externalEventId: string;
+    idempotencyKey: string;
+    correlationId: string;
+    body: string;
+}
+export interface ChannelMutationResponse {
+    session: ChannelSession | undefined;
+    message: TicketMessage | undefined;
+    duplicate: boolean;
+}
+export interface RequestHumanHandoffRequest {
+    identity: ChannelIdentity | undefined;
+    externalEventId: string;
+    correlationId: string;
+}
+export interface CloseChannelTicketRequest {
+    identity: ChannelIdentity | undefined;
+    externalEventId: string;
+    correlationId: string;
+}
+export interface LinkChannelIdentityRequest {
+    identity: ChannelIdentity | undefined;
+    /** trusted gateway result, never accepted from the bot body */
+    userId: string;
+    correlationId: string;
+}
+export interface GetTelegramIntegrationRequest {
+    userId: string;
+}
+export interface UpdateTelegramIntegrationRequest {
+    userId: string;
+    notificationsEnabled: boolean;
+    notificationCategories: string[];
+}
+export interface DisconnectTelegramIntegrationRequest {
+    userId: string;
+}
+export interface TelegramIntegration {
+    connected: boolean;
+    identityId: string;
+    username: string;
+    linkedAt: string;
+    notificationsEnabled: boolean;
+    notificationCategories: string[];
+}
+export interface TelegramIntegrationMutationResponse {
+    disconnected: boolean;
+}
+export interface ChannelDelivery {
+    id: string;
+    channel: string;
+    recipientExternalChatId: string;
+    body: string;
+    status: string;
+    attempts: number;
+    correlationId: string;
+    createdAt: string;
+}
+export interface LeaseChannelDeliveriesRequest {
+    channel: string;
+    workerId: string;
+    limit: number;
+    leaseSeconds: number;
+}
+export interface ChannelDeliveriesResponse {
+    items: ChannelDelivery[];
+}
+export interface AcknowledgeChannelDeliveryRequest {
+    deliveryId: string;
+    workerId: string;
+    providerMessageId: string;
+    correlationId: string;
+}
+export interface FailChannelDeliveryRequest {
+    deliveryId: string;
+    workerId: string;
+    errorCode: string;
+    retryAfterMs: number;
+    permanent: boolean;
+    correlationId: string;
+}
 export declare const SUPPORT_V1_PACKAGE_NAME = "support.v1";
 /**
  * Support ticket system (G1). Enums as strings matching the DB:
@@ -356,6 +478,22 @@ export interface SupportServiceClient {
     getTicketCreationBan(request: GetTicketCreationBanRequest): Observable<TicketCreationBanState>;
     setTicketCreationBan(request: SetTicketCreationBanRequest): Observable<SupportTicketBan>;
     clearTicketCreationBan(request: ClearTicketCreationBanRequest): Observable<TicketCreationBanState>;
+    /**
+     * Internal channel adapter API. Gateway authenticates the external channel
+     * and forwards only validated identifiers to these methods.
+     */
+    getChannelSession(request: GetChannelSessionRequest): Observable<ChannelSession>;
+    createChannelTicket(request: CreateChannelTicketRequest): Observable<ChannelMutationResponse>;
+    appendChannelMessage(request: AppendChannelMessageRequest): Observable<ChannelMutationResponse>;
+    requestHumanHandoff(request: RequestHumanHandoffRequest): Observable<ChannelSession>;
+    closeChannelTicket(request: CloseChannelTicketRequest): Observable<ChannelSession>;
+    linkChannelIdentity(request: LinkChannelIdentityRequest): Observable<ChannelSession>;
+    getTelegramIntegration(request: GetTelegramIntegrationRequest): Observable<TelegramIntegration>;
+    updateTelegramIntegration(request: UpdateTelegramIntegrationRequest): Observable<TelegramIntegration>;
+    disconnectTelegramIntegration(request: DisconnectTelegramIntegrationRequest): Observable<TelegramIntegrationMutationResponse>;
+    leaseChannelDeliveries(request: LeaseChannelDeliveriesRequest): Observable<ChannelDeliveriesResponse>;
+    acknowledgeChannelDelivery(request: AcknowledgeChannelDeliveryRequest): Observable<ChannelDelivery>;
+    failChannelDelivery(request: FailChannelDeliveryRequest): Observable<ChannelDelivery>;
 }
 /**
  * Support ticket system (G1). Enums as strings matching the DB:
@@ -385,6 +523,22 @@ export interface SupportServiceController {
     getTicketCreationBan(request: GetTicketCreationBanRequest): Promise<TicketCreationBanState> | Observable<TicketCreationBanState> | TicketCreationBanState;
     setTicketCreationBan(request: SetTicketCreationBanRequest): Promise<SupportTicketBan> | Observable<SupportTicketBan> | SupportTicketBan;
     clearTicketCreationBan(request: ClearTicketCreationBanRequest): Promise<TicketCreationBanState> | Observable<TicketCreationBanState> | TicketCreationBanState;
+    /**
+     * Internal channel adapter API. Gateway authenticates the external channel
+     * and forwards only validated identifiers to these methods.
+     */
+    getChannelSession(request: GetChannelSessionRequest): Promise<ChannelSession> | Observable<ChannelSession> | ChannelSession;
+    createChannelTicket(request: CreateChannelTicketRequest): Promise<ChannelMutationResponse> | Observable<ChannelMutationResponse> | ChannelMutationResponse;
+    appendChannelMessage(request: AppendChannelMessageRequest): Promise<ChannelMutationResponse> | Observable<ChannelMutationResponse> | ChannelMutationResponse;
+    requestHumanHandoff(request: RequestHumanHandoffRequest): Promise<ChannelSession> | Observable<ChannelSession> | ChannelSession;
+    closeChannelTicket(request: CloseChannelTicketRequest): Promise<ChannelSession> | Observable<ChannelSession> | ChannelSession;
+    linkChannelIdentity(request: LinkChannelIdentityRequest): Promise<ChannelSession> | Observable<ChannelSession> | ChannelSession;
+    getTelegramIntegration(request: GetTelegramIntegrationRequest): Promise<TelegramIntegration> | Observable<TelegramIntegration> | TelegramIntegration;
+    updateTelegramIntegration(request: UpdateTelegramIntegrationRequest): Promise<TelegramIntegration> | Observable<TelegramIntegration> | TelegramIntegration;
+    disconnectTelegramIntegration(request: DisconnectTelegramIntegrationRequest): Promise<TelegramIntegrationMutationResponse> | Observable<TelegramIntegrationMutationResponse> | TelegramIntegrationMutationResponse;
+    leaseChannelDeliveries(request: LeaseChannelDeliveriesRequest): Promise<ChannelDeliveriesResponse> | Observable<ChannelDeliveriesResponse> | ChannelDeliveriesResponse;
+    acknowledgeChannelDelivery(request: AcknowledgeChannelDeliveryRequest): Promise<ChannelDelivery> | Observable<ChannelDelivery> | ChannelDelivery;
+    failChannelDelivery(request: FailChannelDeliveryRequest): Promise<ChannelDelivery> | Observable<ChannelDelivery> | ChannelDelivery;
 }
 export declare function SupportServiceControllerMethods(): (constructor: Function) => void;
 export declare const SUPPORT_SERVICE_NAME = "SupportService";

package/gen/support.js

@@ -34,6 +34,18 @@ function SupportServiceControllerMethods() {
             "getTicketCreationBan",
             "setTicketCreationBan",
             "clearTicketCreationBan",
+            "getChannelSession",
+            "createChannelTicket",
+            "appendChannelMessage",
+            "requestHumanHandoff",
+            "closeChannelTicket",
+            "linkChannelIdentity",
+            "getTelegramIntegration",
+            "updateTelegramIntegration",
+            "disconnectTelegramIntegration",
+            "leaseChannelDeliveries",
+            "acknowledgeChannelDelivery",
+            "failChannelDelivery",
         ];
         for (const method of grpcMethods) {
             const descriptor = Reflect.getOwnPropertyDescriptor(constructor.prototype, method);

package/gen/support.ts

@@ -58,6 +58,9 @@ export interface Ticket {
   reportedAt: string;
   /** SUPPORT|USER, empty when no one is expected (e.g. CLOSED) */
   waitingFor: string;
+  /** WEB|TELEGRAM */
+  originChannel: string;
+  contactId: string;
 }
 
 export interface TicketAssignee {
@@ -92,6 +95,15 @@ export interface TicketMessage {
   isReadByStaff: boolean;
   /** first known staff read timestamp for this message, '' if unread */
   staffReadAt: string;
+  /** USER|GUEST|STAFF|AI|SYSTEM */
+  authorType: string;
+  aiCitations: AiCitation[];
+}
+
+export interface AiCitation {
+  sourceId: string;
+  title: string;
+  reference: string;
 }
 
 export interface TicketAttachment {
@@ -371,6 +383,138 @@ export interface TicketsListResponse {
   limit: number;
 }
 
+export interface ChannelIdentity {
+  channel: string;
+  externalUserId: string;
+  externalChatId: string;
+  username: string;
+  displayName: string;
+  locale: string;
+}
+
+export interface GetChannelSessionRequest {
+  identity: ChannelIdentity | undefined;
+  correlationId: string;
+}
+
+export interface ChannelSession {
+  identityId: string;
+  contactId: string;
+  userId: string;
+  isLinked: boolean;
+  activeTicket: Ticket | undefined;
+}
+
+export interface CreateChannelTicketRequest {
+  identity: ChannelIdentity | undefined;
+  externalEventId: string;
+  idempotencyKey: string;
+  correlationId: string;
+  subject: string;
+  body: string;
+  category: string;
+}
+
+export interface AppendChannelMessageRequest {
+  identity: ChannelIdentity | undefined;
+  externalEventId: string;
+  idempotencyKey: string;
+  correlationId: string;
+  body: string;
+}
+
+export interface ChannelMutationResponse {
+  session: ChannelSession | undefined;
+  message: TicketMessage | undefined;
+  duplicate: boolean;
+}
+
+export interface RequestHumanHandoffRequest {
+  identity: ChannelIdentity | undefined;
+  externalEventId: string;
+  correlationId: string;
+}
+
+export interface CloseChannelTicketRequest {
+  identity: ChannelIdentity | undefined;
+  externalEventId: string;
+  correlationId: string;
+}
+
+export interface LinkChannelIdentityRequest {
+  identity:
+    | ChannelIdentity
+    | undefined;
+  /** trusted gateway result, never accepted from the bot body */
+  userId: string;
+  correlationId: string;
+}
+
+export interface GetTelegramIntegrationRequest {
+  userId: string;
+}
+
+export interface UpdateTelegramIntegrationRequest {
+  userId: string;
+  notificationsEnabled: boolean;
+  notificationCategories: string[];
+}
+
+export interface DisconnectTelegramIntegrationRequest {
+  userId: string;
+}
+
+export interface TelegramIntegration {
+  connected: boolean;
+  identityId: string;
+  username: string;
+  linkedAt: string;
+  notificationsEnabled: boolean;
+  notificationCategories: string[];
+}
+
+export interface TelegramIntegrationMutationResponse {
+  disconnected: boolean;
+}
+
+export interface ChannelDelivery {
+  id: string;
+  channel: string;
+  recipientExternalChatId: string;
+  body: string;
+  status: string;
+  attempts: number;
+  correlationId: string;
+  createdAt: string;
+}
+
+export interface LeaseChannelDeliveriesRequest {
+  channel: string;
+  workerId: string;
+  limit: number;
+  leaseSeconds: number;
+}
+
+export interface ChannelDeliveriesResponse {
+  items: ChannelDelivery[];
+}
+
+export interface AcknowledgeChannelDeliveryRequest {
+  deliveryId: string;
+  workerId: string;
+  providerMessageId: string;
+  correlationId: string;
+}
+
+export interface FailChannelDeliveryRequest {
+  deliveryId: string;
+  workerId: string;
+  errorCode: string;
+  retryAfterMs: number;
+  permanent: boolean;
+  correlationId: string;
+}
+
 export const SUPPORT_V1_PACKAGE_NAME = "support.v1";
 
 /**
@@ -424,6 +568,37 @@ export interface SupportServiceClient {
   setTicketCreationBan(request: SetTicketCreationBanRequest): Observable<SupportTicketBan>;
 
   clearTicketCreationBan(request: ClearTicketCreationBanRequest): Observable<TicketCreationBanState>;
+
+  /**
+   * Internal channel adapter API. Gateway authenticates the external channel
+   * and forwards only validated identifiers to these methods.
+   */
+
+  getChannelSession(request: GetChannelSessionRequest): Observable<ChannelSession>;
+
+  createChannelTicket(request: CreateChannelTicketRequest): Observable<ChannelMutationResponse>;
+
+  appendChannelMessage(request: AppendChannelMessageRequest): Observable<ChannelMutationResponse>;
+
+  requestHumanHandoff(request: RequestHumanHandoffRequest): Observable<ChannelSession>;
+
+  closeChannelTicket(request: CloseChannelTicketRequest): Observable<ChannelSession>;
+
+  linkChannelIdentity(request: LinkChannelIdentityRequest): Observable<ChannelSession>;
+
+  getTelegramIntegration(request: GetTelegramIntegrationRequest): Observable<TelegramIntegration>;
+
+  updateTelegramIntegration(request: UpdateTelegramIntegrationRequest): Observable<TelegramIntegration>;
+
+  disconnectTelegramIntegration(
+    request: DisconnectTelegramIntegrationRequest,
+  ): Observable<TelegramIntegrationMutationResponse>;
+
+  leaseChannelDeliveries(request: LeaseChannelDeliveriesRequest): Observable<ChannelDeliveriesResponse>;
+
+  acknowledgeChannelDelivery(request: AcknowledgeChannelDeliveryRequest): Observable<ChannelDelivery>;
+
+  failChannelDelivery(request: FailChannelDeliveryRequest): Observable<ChannelDelivery>;
 }
 
 /**
@@ -501,6 +676,62 @@ export interface SupportServiceController {
   clearTicketCreationBan(
     request: ClearTicketCreationBanRequest,
   ): Promise<TicketCreationBanState> | Observable<TicketCreationBanState> | TicketCreationBanState;
+
+  /**
+   * Internal channel adapter API. Gateway authenticates the external channel
+   * and forwards only validated identifiers to these methods.
+   */
+
+  getChannelSession(
+    request: GetChannelSessionRequest,
+  ): Promise<ChannelSession> | Observable<ChannelSession> | ChannelSession;
+
+  createChannelTicket(
+    request: CreateChannelTicketRequest,
+  ): Promise<ChannelMutationResponse> | Observable<ChannelMutationResponse> | ChannelMutationResponse;
+
+  appendChannelMessage(
+    request: AppendChannelMessageRequest,
+  ): Promise<ChannelMutationResponse> | Observable<ChannelMutationResponse> | ChannelMutationResponse;
+
+  requestHumanHandoff(
+    request: RequestHumanHandoffRequest,
+  ): Promise<ChannelSession> | Observable<ChannelSession> | ChannelSession;
+
+  closeChannelTicket(
+    request: CloseChannelTicketRequest,
+  ): Promise<ChannelSession> | Observable<ChannelSession> | ChannelSession;
+
+  linkChannelIdentity(
+    request: LinkChannelIdentityRequest,
+  ): Promise<ChannelSession> | Observable<ChannelSession> | ChannelSession;
+
+  getTelegramIntegration(
+    request: GetTelegramIntegrationRequest,
+  ): Promise<TelegramIntegration> | Observable<TelegramIntegration> | TelegramIntegration;
+
+  updateTelegramIntegration(
+    request: UpdateTelegramIntegrationRequest,
+  ): Promise<TelegramIntegration> | Observable<TelegramIntegration> | TelegramIntegration;
+
+  disconnectTelegramIntegration(
+    request: DisconnectTelegramIntegrationRequest,
+  ):
+    | Promise<TelegramIntegrationMutationResponse>
+    | Observable<TelegramIntegrationMutationResponse>
+    | TelegramIntegrationMutationResponse;
+
+  leaseChannelDeliveries(
+    request: LeaseChannelDeliveriesRequest,
+  ): Promise<ChannelDeliveriesResponse> | Observable<ChannelDeliveriesResponse> | ChannelDeliveriesResponse;
+
+  acknowledgeChannelDelivery(
+    request: AcknowledgeChannelDeliveryRequest,
+  ): Promise<ChannelDelivery> | Observable<ChannelDelivery> | ChannelDelivery;
+
+  failChannelDelivery(
+    request: FailChannelDeliveryRequest,
+  ): Promise<ChannelDelivery> | Observable<ChannelDelivery> | ChannelDelivery;
 }
 
 export function SupportServiceControllerMethods() {
@@ -526,6 +757,18 @@ export function SupportServiceControllerMethods() {
       "getTicketCreationBan",
       "setTicketCreationBan",
       "clearTicketCreationBan",
+      "getChannelSession",
+      "createChannelTicket",
+      "appendChannelMessage",
+      "requestHumanHandoff",
+      "closeChannelTicket",
+      "linkChannelIdentity",
+      "getTelegramIntegration",
+      "updateTelegramIntegration",
+      "disconnectTelegramIntegration",
+      "leaseChannelDeliveries",
+      "acknowledgeChannelDelivery",
+      "failChannelDelivery",
     ];
     for (const method of grpcMethods) {
       const descriptor: any = Reflect.getOwnPropertyDescriptor(constructor.prototype, method);

package/gen/users.d.ts

@@ -26,6 +26,19 @@ export declare enum PremiumPeriod {
 export interface Ok {
     ok: boolean;
 }
+export interface GetSupportUserContextRequest {
+    userId: string;
+}
+export interface SupportUserContext {
+    userId: string;
+    username: string;
+    fullName: string;
+    accountStatus: string;
+    isVerified: boolean;
+    createdAt: string;
+    locale: string;
+    roles: string[];
+}
 export interface User {
     id: string;
     email: string;
@@ -779,6 +792,8 @@ export interface UsersServiceClient {
     collectUserExportData(request: CollectUserExportDataRequest): Observable<CollectUserExportDataResponse>;
     /** Unified read for the settings page */
     getAccountSettings(request: GetAccountSettingsRequest): Observable<AccountSettingsResponse>;
+    /** Internal, read-only and deliberately minimal context for support AI. */
+    getSupportUserContext(request: GetSupportUserContextRequest): Observable<SupportUserContext>;
     /** Password — separate from generic createCode/verifyCode reset flow. */
     changePassword(request: ChangePasswordRequest): Observable<Ok>;
 }
@@ -847,6 +862,8 @@ export interface UsersServiceController {
     collectUserExportData(request: CollectUserExportDataRequest): Promise<CollectUserExportDataResponse> | Observable<CollectUserExportDataResponse> | CollectUserExportDataResponse;
     /** Unified read for the settings page */
     getAccountSettings(request: GetAccountSettingsRequest): Promise<AccountSettingsResponse> | Observable<AccountSettingsResponse> | AccountSettingsResponse;
+    /** Internal, read-only and deliberately minimal context for support AI. */
+    getSupportUserContext(request: GetSupportUserContextRequest): Promise<SupportUserContext> | Observable<SupportUserContext> | SupportUserContext;
     /** Password — separate from generic createCode/verifyCode reset flow. */
     changePassword(request: ChangePasswordRequest): Promise<Ok> | Observable<Ok> | Ok;
 }

package/gen/users.js

@@ -78,6 +78,7 @@ function UsersServiceControllerMethods() {
             "completeDataExport",
             "collectUserExportData",
             "getAccountSettings",
+            "getSupportUserContext",
             "changePassword",
         ];
         for (const method of grpcMethods) {

package/gen/users.ts

@@ -40,6 +40,21 @@ export interface Ok {
   ok: boolean;
 }
 
+export interface GetSupportUserContextRequest {
+  userId: string;
+}
+
+export interface SupportUserContext {
+  userId: string;
+  username: string;
+  fullName: string;
+  accountStatus: string;
+  isVerified: boolean;
+  createdAt: string;
+  locale: string;
+  roles: string[];
+}
+
 export interface User {
   id: string;
   email: string;
@@ -941,6 +956,10 @@ export interface UsersServiceClient {
 
   getAccountSettings(request: GetAccountSettingsRequest): Observable<AccountSettingsResponse>;
 
+  /** Internal, read-only and deliberately minimal context for support AI. */
+
+  getSupportUserContext(request: GetSupportUserContextRequest): Observable<SupportUserContext>;
+
   /** Password — separate from generic createCode/verifyCode reset flow. */
 
   changePassword(request: ChangePasswordRequest): Observable<Ok>;
@@ -1126,6 +1145,12 @@ export interface UsersServiceController {
     request: GetAccountSettingsRequest,
   ): Promise<AccountSettingsResponse> | Observable<AccountSettingsResponse> | AccountSettingsResponse;
 
+  /** Internal, read-only and deliberately minimal context for support AI. */
+
+  getSupportUserContext(
+    request: GetSupportUserContextRequest,
+  ): Promise<SupportUserContext> | Observable<SupportUserContext> | SupportUserContext;
+
   /** Password — separate from generic createCode/verifyCode reset flow. */
 
   changePassword(request: ChangePasswordRequest): Promise<Ok> | Observable<Ok> | Ok;
@@ -1172,6 +1197,7 @@ export function UsersServiceControllerMethods() {
       "completeDataExport",
       "collectUserExportData",
       "getAccountSettings",
+      "getSupportUserContext",
       "changePassword",
     ];
     for (const method of grpcMethods) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aepstore-dev/contracts",
-  "version": "1.105.0",
+	"version": "1.107.0",
   "description": "Protobuf definitions for aepstore microservices",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",

package/proto/payments.proto

@@ -12,6 +12,9 @@ service PaymentsService {
     rpc GetMyPurchases(GetMyPurchasesRequest) returns (PurchasesListResponse);
     rpc GetPurchase(GetPurchaseRequest) returns (Purchase);
     rpc RefundPurchase(RefundPurchaseRequest) returns (Purchase);
+    // Internal, read-only purchase summary for support AI. No money-provider,
+    // card, ledger, payout or withdrawal data is exposed.
+    rpc GetSupportPurchasesContext(GetSupportPurchasesContextRequest) returns (SupportPurchasesContext);
 
     // ----- wallet -----
     rpc GetWallet(GetWalletRequest) returns (WalletResponse);
@@ -79,6 +82,25 @@ service PaymentsService {
 
 message Ok { bool ok = 1; }
 
+message GetSupportPurchasesContextRequest {
+    string user_id = 1;
+    int32 limit = 2; // clamped to 1..5 by payments-service
+}
+
+message SupportPurchaseContext {
+    string purchase_id = 1;
+    string status = 2;
+    string created_at = 3;
+    string completed_at = 4;
+    string product_id = 5;
+    string product_name = 6;
+    string access_status = 7;
+}
+
+message SupportPurchasesContext {
+    repeated SupportPurchaseContext items = 1;
+}
+
 // ---------------------------------------------------------------------------
 // Purchase / checkout / topup
 // ---------------------------------------------------------------------------

package/proto/support.proto

@@ -29,6 +29,21 @@ service SupportService {
     rpc GetTicketCreationBan(GetTicketCreationBanRequest) returns (TicketCreationBanState);
     rpc SetTicketCreationBan(SetTicketCreationBanRequest) returns (SupportTicketBan);
     rpc ClearTicketCreationBan(ClearTicketCreationBanRequest) returns (TicketCreationBanState);
+
+    // Internal channel adapter API. Gateway authenticates the external channel
+    // and forwards only validated identifiers to these methods.
+    rpc GetChannelSession(GetChannelSessionRequest) returns (ChannelSession);
+    rpc CreateChannelTicket(CreateChannelTicketRequest) returns (ChannelMutationResponse);
+    rpc AppendChannelMessage(AppendChannelMessageRequest) returns (ChannelMutationResponse);
+    rpc RequestHumanHandoff(RequestHumanHandoffRequest) returns (ChannelSession);
+    rpc CloseChannelTicket(CloseChannelTicketRequest) returns (ChannelSession);
+    rpc LinkChannelIdentity(LinkChannelIdentityRequest) returns (ChannelSession);
+    rpc GetTelegramIntegration(GetTelegramIntegrationRequest) returns (TelegramIntegration);
+    rpc UpdateTelegramIntegration(UpdateTelegramIntegrationRequest) returns (TelegramIntegration);
+    rpc DisconnectTelegramIntegration(DisconnectTelegramIntegrationRequest) returns (TelegramIntegrationMutationResponse);
+    rpc LeaseChannelDeliveries(LeaseChannelDeliveriesRequest) returns (ChannelDeliveriesResponse);
+    rpc AcknowledgeChannelDelivery(AcknowledgeChannelDeliveryRequest) returns (ChannelDelivery);
+    rpc FailChannelDelivery(FailChannelDeliveryRequest) returns (ChannelDelivery);
 }
 
 message PingRequest { string message = 1; }
@@ -63,6 +78,8 @@ message Ticket {
     TicketAssignee assignee = 26;
     string reported_at = 27;
     string waiting_for = 28;  // SUPPORT|USER, empty when no one is expected (e.g. CLOSED)
+    string origin_channel = 29; // WEB|TELEGRAM
+    string contact_id = 30;
 }
 
 message TicketAssignee {
@@ -91,6 +108,14 @@ message TicketMessage {
     string deleted_at = 12;
     bool is_read_by_staff = 13;  // true for user messages already read by support staff
     string staff_read_at = 14;   // first known staff read timestamp for this message, '' if unread
+    string author_type = 15;     // USER|GUEST|STAFF|AI|SYSTEM
+    repeated AiCitation ai_citations = 16;
+}
+
+message AiCitation {
+    string source_id = 1;
+    string title = 2;
+    string reference = 3;
 }
 
 message TicketAttachment {
@@ -331,3 +356,136 @@ message TicketsListResponse {
     int32 page = 3;
     int32 limit = 4;
 }
+
+// ---------------------------------------------------------------------------
+// Channel adapters (internal only)
+// ---------------------------------------------------------------------------
+
+message ChannelIdentity {
+    string channel = 1;
+    string external_user_id = 2;
+    string external_chat_id = 3;
+    string username = 4;
+    string display_name = 5;
+    string locale = 6;
+}
+
+message GetChannelSessionRequest {
+    ChannelIdentity identity = 1;
+    string correlation_id = 2;
+}
+
+message ChannelSession {
+    string identity_id = 1;
+    string contact_id = 2;
+    string user_id = 3;
+    bool is_linked = 4;
+    Ticket active_ticket = 5;
+}
+
+message CreateChannelTicketRequest {
+    ChannelIdentity identity = 1;
+    string external_event_id = 2;
+    string idempotency_key = 3;
+    string correlation_id = 4;
+    string subject = 5;
+    string body = 6;
+    string category = 7;
+}
+
+message AppendChannelMessageRequest {
+    ChannelIdentity identity = 1;
+    string external_event_id = 2;
+    string idempotency_key = 3;
+    string correlation_id = 4;
+    string body = 5;
+}
+
+message ChannelMutationResponse {
+    ChannelSession session = 1;
+    TicketMessage message = 2;
+    bool duplicate = 3;
+}
+
+message RequestHumanHandoffRequest {
+    ChannelIdentity identity = 1;
+    string external_event_id = 2;
+    string correlation_id = 3;
+}
+
+message CloseChannelTicketRequest {
+    ChannelIdentity identity = 1;
+    string external_event_id = 2;
+    string correlation_id = 3;
+}
+
+message LinkChannelIdentityRequest {
+    ChannelIdentity identity = 1;
+    string user_id = 2; // trusted gateway result, never accepted from the bot body
+    string correlation_id = 3;
+}
+
+message GetTelegramIntegrationRequest {
+    string user_id = 1;
+}
+
+message UpdateTelegramIntegrationRequest {
+    string user_id = 1;
+    bool notifications_enabled = 2;
+    repeated string notification_categories = 3;
+}
+
+message DisconnectTelegramIntegrationRequest {
+    string user_id = 1;
+}
+
+message TelegramIntegration {
+    bool connected = 1;
+    string identity_id = 2;
+    string username = 3;
+    string linked_at = 4;
+    bool notifications_enabled = 5;
+    repeated string notification_categories = 6;
+}
+
+message TelegramIntegrationMutationResponse {
+    bool disconnected = 1;
+}
+
+message ChannelDelivery {
+    string id = 1;
+    string channel = 2;
+    string recipient_external_chat_id = 3;
+    string body = 4;
+    string status = 5;
+    int32 attempts = 6;
+    string correlation_id = 7;
+    string created_at = 8;
+}
+
+message LeaseChannelDeliveriesRequest {
+    string channel = 1;
+    string worker_id = 2;
+    int32 limit = 3;
+    int32 lease_seconds = 4;
+}
+
+message ChannelDeliveriesResponse {
+    repeated ChannelDelivery items = 1;
+}
+
+message AcknowledgeChannelDeliveryRequest {
+    string delivery_id = 1;
+    string worker_id = 2;
+    string provider_message_id = 3;
+    string correlation_id = 4;
+}
+
+message FailChannelDeliveryRequest {
+    string delivery_id = 1;
+    string worker_id = 2;
+    string error_code = 3;
+    int32 retry_after_ms = 4;
+    bool permanent = 5;
+    string correlation_id = 6;
+}

package/proto/users.proto

@@ -64,12 +64,27 @@ service UsersService {
     // Unified read for the settings page
     rpc GetAccountSettings(GetAccountSettingsRequest) returns (AccountSettingsResponse);
 
+    // Internal, read-only and deliberately minimal context for support AI.
+    rpc GetSupportUserContext(GetSupportUserContextRequest) returns (SupportUserContext);
+
     // Password — separate from generic createCode/verifyCode reset flow.
     rpc ChangePassword(ChangePasswordRequest) returns (Ok);
 }
 
 message Ok { bool ok = 1; }
 
+message GetSupportUserContextRequest { string user_id = 1; }
+message SupportUserContext {
+    string user_id = 1;
+    string username = 2;
+    string full_name = 3;
+    string account_status = 4;
+    bool is_verified = 5;
+    string created_at = 6;
+    string locale = 7;
+    repeated string roles = 8;
+}
+
 // =================================================================
 // Common types
 // =================================================================