@juzi/wechaty-grpc 1.0.101 → 1.0.103

package/dist/cjs/out/wechaty/puppet_pb_service.d.ts

@@ -3,6 +3,7 @@
 
 import * as wechaty_puppet_pb from "../wechaty/puppet_pb";
 import * as wechaty_puppet_base_pb from "../wechaty/puppet/base_pb";
+import * as wechaty_puppet_call_pb from "../wechaty/puppet/call_pb";
 import * as wechaty_puppet_contact_pb from "../wechaty/puppet/contact_pb";
 import * as wechaty_puppet_download_upload_pb from "../wechaty/puppet/download-upload_pb";
 import * as wechaty_puppet_event_pb from "../wechaty/puppet/event_pb";
@@ -415,6 +416,78 @@ type PuppetMessageCallRecord = {
   readonly responseType: typeof wechaty_puppet_message_pb.MessageCallRecordResponse;
 };
 
+type PuppetCallInvite = {
+  readonly methodName: string;
+  readonly service: typeof Puppet;
+  readonly requestStream: false;
+  readonly responseStream: false;
+  readonly requestType: typeof wechaty_puppet_call_pb.CallInviteRequest;
+  readonly responseType: typeof wechaty_puppet_call_pb.CallInviteResponse;
+};
+
+type PuppetCallAdd = {
+  readonly methodName: string;
+  readonly service: typeof Puppet;
+  readonly requestStream: false;
+  readonly responseStream: false;
+  readonly requestType: typeof wechaty_puppet_call_pb.CallAddRequest;
+  readonly responseType: typeof wechaty_puppet_call_pb.CallAddResponse;
+};
+
+type PuppetCallAccept = {
+  readonly methodName: string;
+  readonly service: typeof Puppet;
+  readonly requestStream: false;
+  readonly responseStream: false;
+  readonly requestType: typeof wechaty_puppet_call_pb.CallAcceptRequest;
+  readonly responseType: typeof wechaty_puppet_call_pb.CallAcceptResponse;
+};
+
+type PuppetCallReject = {
+  readonly methodName: string;
+  readonly service: typeof Puppet;
+  readonly requestStream: false;
+  readonly responseStream: false;
+  readonly requestType: typeof wechaty_puppet_call_pb.CallRejectRequest;
+  readonly responseType: typeof wechaty_puppet_call_pb.CallRejectResponse;
+};
+
+type PuppetCallCancel = {
+  readonly methodName: string;
+  readonly service: typeof Puppet;
+  readonly requestStream: false;
+  readonly responseStream: false;
+  readonly requestType: typeof wechaty_puppet_call_pb.CallCancelRequest;
+  readonly responseType: typeof wechaty_puppet_call_pb.CallCancelResponse;
+};
+
+type PuppetCallHangup = {
+  readonly methodName: string;
+  readonly service: typeof Puppet;
+  readonly requestStream: false;
+  readonly responseStream: false;
+  readonly requestType: typeof wechaty_puppet_call_pb.CallHangupRequest;
+  readonly responseType: typeof wechaty_puppet_call_pb.CallHangupResponse;
+};
+
+type PuppetCallMediaEndpoint = {
+  readonly methodName: string;
+  readonly service: typeof Puppet;
+  readonly requestStream: false;
+  readonly responseStream: false;
+  readonly requestType: typeof wechaty_puppet_call_pb.CallMediaEndpointRequest;
+  readonly responseType: typeof wechaty_puppet_call_pb.CallMediaEndpointResponse;
+};
+
+type PuppetCallPayload = {
+  readonly methodName: string;
+  readonly service: typeof Puppet;
+  readonly requestStream: false;
+  readonly responseStream: false;
+  readonly requestType: typeof wechaty_puppet_call_pb.CallPayloadRequest;
+  readonly responseType: typeof wechaty_puppet_call_pb.CallPayloadResponse;
+};
+
 type PuppetMessageChatHistory = {
   readonly methodName: string;
   readonly service: typeof Puppet;
@@ -1172,6 +1245,14 @@ export class Puppet {
   static readonly MessageChannel: PuppetMessageChannel;
   static readonly MessageChannelCard: PuppetMessageChannelCard;
   static readonly MessageCallRecord: PuppetMessageCallRecord;
+  static readonly CallInvite: PuppetCallInvite;
+  static readonly CallAdd: PuppetCallAdd;
+  static readonly CallAccept: PuppetCallAccept;
+  static readonly CallReject: PuppetCallReject;
+  static readonly CallCancel: PuppetCallCancel;
+  static readonly CallHangup: PuppetCallHangup;
+  static readonly CallMediaEndpoint: PuppetCallMediaEndpoint;
+  static readonly CallPayload: PuppetCallPayload;
   static readonly MessageChatHistory: PuppetMessageChatHistory;
   static readonly MessageRecall: PuppetMessageRecall;
   static readonly MessageForward: PuppetMessageForward;
@@ -1673,6 +1754,78 @@ export class PuppetClient {
     requestMessage: wechaty_puppet_message_pb.MessageCallRecordRequest,
     callback: (error: ServiceError|null, responseMessage: wechaty_puppet_message_pb.MessageCallRecordResponse|null) => void
   ): UnaryResponse;
+  callInvite(
+    requestMessage: wechaty_puppet_call_pb.CallInviteRequest,
+    metadata: grpc.Metadata,
+    callback: (error: ServiceError|null, responseMessage: wechaty_puppet_call_pb.CallInviteResponse|null) => void
+  ): UnaryResponse;
+  callInvite(
+    requestMessage: wechaty_puppet_call_pb.CallInviteRequest,
+    callback: (error: ServiceError|null, responseMessage: wechaty_puppet_call_pb.CallInviteResponse|null) => void
+  ): UnaryResponse;
+  callAdd(
+    requestMessage: wechaty_puppet_call_pb.CallAddRequest,
+    metadata: grpc.Metadata,
+    callback: (error: ServiceError|null, responseMessage: wechaty_puppet_call_pb.CallAddResponse|null) => void
+  ): UnaryResponse;
+  callAdd(
+    requestMessage: wechaty_puppet_call_pb.CallAddRequest,
+    callback: (error: ServiceError|null, responseMessage: wechaty_puppet_call_pb.CallAddResponse|null) => void
+  ): UnaryResponse;
+  callAccept(
+    requestMessage: wechaty_puppet_call_pb.CallAcceptRequest,
+    metadata: grpc.Metadata,
+    callback: (error: ServiceError|null, responseMessage: wechaty_puppet_call_pb.CallAcceptResponse|null) => void
+  ): UnaryResponse;
+  callAccept(
+    requestMessage: wechaty_puppet_call_pb.CallAcceptRequest,
+    callback: (error: ServiceError|null, responseMessage: wechaty_puppet_call_pb.CallAcceptResponse|null) => void
+  ): UnaryResponse;
+  callReject(
+    requestMessage: wechaty_puppet_call_pb.CallRejectRequest,
+    metadata: grpc.Metadata,
+    callback: (error: ServiceError|null, responseMessage: wechaty_puppet_call_pb.CallRejectResponse|null) => void
+  ): UnaryResponse;
+  callReject(
+    requestMessage: wechaty_puppet_call_pb.CallRejectRequest,
+    callback: (error: ServiceError|null, responseMessage: wechaty_puppet_call_pb.CallRejectResponse|null) => void
+  ): UnaryResponse;
+  callCancel(
+    requestMessage: wechaty_puppet_call_pb.CallCancelRequest,
+    metadata: grpc.Metadata,
+    callback: (error: ServiceError|null, responseMessage: wechaty_puppet_call_pb.CallCancelResponse|null) => void
+  ): UnaryResponse;
+  callCancel(
+    requestMessage: wechaty_puppet_call_pb.CallCancelRequest,
+    callback: (error: ServiceError|null, responseMessage: wechaty_puppet_call_pb.CallCancelResponse|null) => void
+  ): UnaryResponse;
+  callHangup(
+    requestMessage: wechaty_puppet_call_pb.CallHangupRequest,
+    metadata: grpc.Metadata,
+    callback: (error: ServiceError|null, responseMessage: wechaty_puppet_call_pb.CallHangupResponse|null) => void
+  ): UnaryResponse;
+  callHangup(
+    requestMessage: wechaty_puppet_call_pb.CallHangupRequest,
+    callback: (error: ServiceError|null, responseMessage: wechaty_puppet_call_pb.CallHangupResponse|null) => void
+  ): UnaryResponse;
+  callMediaEndpoint(
+    requestMessage: wechaty_puppet_call_pb.CallMediaEndpointRequest,
+    metadata: grpc.Metadata,
+    callback: (error: ServiceError|null, responseMessage: wechaty_puppet_call_pb.CallMediaEndpointResponse|null) => void
+  ): UnaryResponse;
+  callMediaEndpoint(
+    requestMessage: wechaty_puppet_call_pb.CallMediaEndpointRequest,
+    callback: (error: ServiceError|null, responseMessage: wechaty_puppet_call_pb.CallMediaEndpointResponse|null) => void
+  ): UnaryResponse;
+  callPayload(
+    requestMessage: wechaty_puppet_call_pb.CallPayloadRequest,
+    metadata: grpc.Metadata,
+    callback: (error: ServiceError|null, responseMessage: wechaty_puppet_call_pb.CallPayloadResponse|null) => void
+  ): UnaryResponse;
+  callPayload(
+    requestMessage: wechaty_puppet_call_pb.CallPayloadRequest,
+    callback: (error: ServiceError|null, responseMessage: wechaty_puppet_call_pb.CallPayloadResponse|null) => void
+  ): UnaryResponse;
   messageChatHistory(
     requestMessage: wechaty_puppet_message_pb.MessageChatHistoryRequest,
     metadata: grpc.Metadata,

package/dist/cjs/out/wechaty/puppet_pb_service.js

@@ -3,6 +3,7 @@
 
 var wechaty_puppet_pb = require("../wechaty/puppet_pb");
 var wechaty_puppet_base_pb = require("../wechaty/puppet/base_pb");
+var wechaty_puppet_call_pb = require("../wechaty/puppet/call_pb");
 var wechaty_puppet_contact_pb = require("../wechaty/puppet/contact_pb");
 var wechaty_puppet_download_upload_pb = require("../wechaty/puppet/download-upload_pb");
 var wechaty_puppet_event_pb = require("../wechaty/puppet/event_pb");
@@ -421,6 +422,78 @@ Puppet.MessageCallRecord = {
   responseType: wechaty_puppet_message_pb.MessageCallRecordResponse
 };
 
+Puppet.CallInvite = {
+  methodName: "CallInvite",
+  service: Puppet,
+  requestStream: false,
+  responseStream: false,
+  requestType: wechaty_puppet_call_pb.CallInviteRequest,
+  responseType: wechaty_puppet_call_pb.CallInviteResponse
+};
+
+Puppet.CallAdd = {
+  methodName: "CallAdd",
+  service: Puppet,
+  requestStream: false,
+  responseStream: false,
+  requestType: wechaty_puppet_call_pb.CallAddRequest,
+  responseType: wechaty_puppet_call_pb.CallAddResponse
+};
+
+Puppet.CallAccept = {
+  methodName: "CallAccept",
+  service: Puppet,
+  requestStream: false,
+  responseStream: false,
+  requestType: wechaty_puppet_call_pb.CallAcceptRequest,
+  responseType: wechaty_puppet_call_pb.CallAcceptResponse
+};
+
+Puppet.CallReject = {
+  methodName: "CallReject",
+  service: Puppet,
+  requestStream: false,
+  responseStream: false,
+  requestType: wechaty_puppet_call_pb.CallRejectRequest,
+  responseType: wechaty_puppet_call_pb.CallRejectResponse
+};
+
+Puppet.CallCancel = {
+  methodName: "CallCancel",
+  service: Puppet,
+  requestStream: false,
+  responseStream: false,
+  requestType: wechaty_puppet_call_pb.CallCancelRequest,
+  responseType: wechaty_puppet_call_pb.CallCancelResponse
+};
+
+Puppet.CallHangup = {
+  methodName: "CallHangup",
+  service: Puppet,
+  requestStream: false,
+  responseStream: false,
+  requestType: wechaty_puppet_call_pb.CallHangupRequest,
+  responseType: wechaty_puppet_call_pb.CallHangupResponse
+};
+
+Puppet.CallMediaEndpoint = {
+  methodName: "CallMediaEndpoint",
+  service: Puppet,
+  requestStream: false,
+  responseStream: false,
+  requestType: wechaty_puppet_call_pb.CallMediaEndpointRequest,
+  responseType: wechaty_puppet_call_pb.CallMediaEndpointResponse
+};
+
+Puppet.CallPayload = {
+  methodName: "CallPayload",
+  service: Puppet,
+  requestStream: false,
+  responseStream: false,
+  requestType: wechaty_puppet_call_pb.CallPayloadRequest,
+  responseType: wechaty_puppet_call_pb.CallPayloadResponse
+};
+
 Puppet.MessageChatHistory = {
   methodName: "MessageChatHistory",
   service: Puppet,
@@ -2511,6 +2584,254 @@ PuppetClient.prototype.messageCallRecord = function messageCallRecord(requestMes
   };
 };
 
+PuppetClient.prototype.callInvite = function callInvite(requestMessage, metadata, callback) {
+  if (arguments.length === 2) {
+    callback = arguments[1];
+  }
+  var client = grpc.unary(Puppet.CallInvite, {
+    request: requestMessage,
+    host: this.serviceHost,
+    metadata: metadata,
+    transport: this.options.transport,
+    debug: this.options.debug,
+    onEnd: function (response) {
+      if (callback) {
+        if (response.status !== grpc.Code.OK) {
+          var err = new Error(response.statusMessage);
+          err.code = response.status;
+          err.metadata = response.trailers;
+          callback(err, null);
+        } else {
+          callback(null, response.message);
+        }
+      }
+    }
+  });
+  return {
+    cancel: function () {
+      callback = null;
+      client.close();
+    }
+  };
+};
+
+PuppetClient.prototype.callAdd = function callAdd(requestMessage, metadata, callback) {
+  if (arguments.length === 2) {
+    callback = arguments[1];
+  }
+  var client = grpc.unary(Puppet.CallAdd, {
+    request: requestMessage,
+    host: this.serviceHost,
+    metadata: metadata,
+    transport: this.options.transport,
+    debug: this.options.debug,
+    onEnd: function (response) {
+      if (callback) {
+        if (response.status !== grpc.Code.OK) {
+          var err = new Error(response.statusMessage);
+          err.code = response.status;
+          err.metadata = response.trailers;
+          callback(err, null);
+        } else {
+          callback(null, response.message);
+        }
+      }
+    }
+  });
+  return {
+    cancel: function () {
+      callback = null;
+      client.close();
+    }
+  };
+};
+
+PuppetClient.prototype.callAccept = function callAccept(requestMessage, metadata, callback) {
+  if (arguments.length === 2) {
+    callback = arguments[1];
+  }
+  var client = grpc.unary(Puppet.CallAccept, {
+    request: requestMessage,
+    host: this.serviceHost,
+    metadata: metadata,
+    transport: this.options.transport,
+    debug: this.options.debug,
+    onEnd: function (response) {
+      if (callback) {
+        if (response.status !== grpc.Code.OK) {
+          var err = new Error(response.statusMessage);
+          err.code = response.status;
+          err.metadata = response.trailers;
+          callback(err, null);
+        } else {
+          callback(null, response.message);
+        }
+      }
+    }
+  });
+  return {
+    cancel: function () {
+      callback = null;
+      client.close();
+    }
+  };
+};
+
+PuppetClient.prototype.callReject = function callReject(requestMessage, metadata, callback) {
+  if (arguments.length === 2) {
+    callback = arguments[1];
+  }
+  var client = grpc.unary(Puppet.CallReject, {
+    request: requestMessage,
+    host: this.serviceHost,
+    metadata: metadata,
+    transport: this.options.transport,
+    debug: this.options.debug,
+    onEnd: function (response) {
+      if (callback) {
+        if (response.status !== grpc.Code.OK) {
+          var err = new Error(response.statusMessage);
+          err.code = response.status;
+          err.metadata = response.trailers;
+          callback(err, null);
+        } else {
+          callback(null, response.message);
+        }
+      }
+    }
+  });
+  return {
+    cancel: function () {
+      callback = null;
+      client.close();
+    }
+  };
+};
+
+PuppetClient.prototype.callCancel = function callCancel(requestMessage, metadata, callback) {
+  if (arguments.length === 2) {
+    callback = arguments[1];
+  }
+  var client = grpc.unary(Puppet.CallCancel, {
+    request: requestMessage,
+    host: this.serviceHost,
+    metadata: metadata,
+    transport: this.options.transport,
+    debug: this.options.debug,
+    onEnd: function (response) {
+      if (callback) {
+        if (response.status !== grpc.Code.OK) {
+          var err = new Error(response.statusMessage);
+          err.code = response.status;
+          err.metadata = response.trailers;
+          callback(err, null);
+        } else {
+          callback(null, response.message);
+        }
+      }
+    }
+  });
+  return {
+    cancel: function () {
+      callback = null;
+      client.close();
+    }
+  };
+};
+
+PuppetClient.prototype.callHangup = function callHangup(requestMessage, metadata, callback) {
+  if (arguments.length === 2) {
+    callback = arguments[1];
+  }
+  var client = grpc.unary(Puppet.CallHangup, {
+    request: requestMessage,
+    host: this.serviceHost,
+    metadata: metadata,
+    transport: this.options.transport,
+    debug: this.options.debug,
+    onEnd: function (response) {
+      if (callback) {
+        if (response.status !== grpc.Code.OK) {
+          var err = new Error(response.statusMessage);
+          err.code = response.status;
+          err.metadata = response.trailers;
+          callback(err, null);
+        } else {
+          callback(null, response.message);
+        }
+      }
+    }
+  });
+  return {
+    cancel: function () {
+      callback = null;
+      client.close();
+    }
+  };
+};
+
+PuppetClient.prototype.callMediaEndpoint = function callMediaEndpoint(requestMessage, metadata, callback) {
+  if (arguments.length === 2) {
+    callback = arguments[1];
+  }
+  var client = grpc.unary(Puppet.CallMediaEndpoint, {
+    request: requestMessage,
+    host: this.serviceHost,
+    metadata: metadata,
+    transport: this.options.transport,
+    debug: this.options.debug,
+    onEnd: function (response) {
+      if (callback) {
+        if (response.status !== grpc.Code.OK) {
+          var err = new Error(response.statusMessage);
+          err.code = response.status;
+          err.metadata = response.trailers;
+          callback(err, null);
+        } else {
+          callback(null, response.message);
+        }
+      }
+    }
+  });
+  return {
+    cancel: function () {
+      callback = null;
+      client.close();
+    }
+  };
+};
+
+PuppetClient.prototype.callPayload = function callPayload(requestMessage, metadata, callback) {
+  if (arguments.length === 2) {
+    callback = arguments[1];
+  }
+  var client = grpc.unary(Puppet.CallPayload, {
+    request: requestMessage,
+    host: this.serviceHost,
+    metadata: metadata,
+    transport: this.options.transport,
+    debug: this.options.debug,
+    onEnd: function (response) {
+      if (callback) {
+        if (response.status !== grpc.Code.OK) {
+          var err = new Error(response.statusMessage);
+          err.code = response.status;
+          err.metadata = response.trailers;
+          callback(err, null);
+        } else {
+          callback(null, response.message);
+        }
+      }
+    }
+  });
+  return {
+    cancel: function () {
+      callback = null;
+      client.close();
+    }
+  };
+};
+
 PuppetClient.prototype.messageChatHistory = function messageChatHistory(requestMessage, metadata, callback) {
   if (arguments.length === 2) {
     callback = arguments[1];

package/dist/cjs/proto/wechaty/puppet/base.proto

@@ -5,6 +5,7 @@ option go_package       = "github.com/wechaty/go-grpc/wechaty/puppet";
 option java_package     = "io.github.wechaty.grpc.puppet";
 option csharp_namespace = "github.wechaty.grpc.puppet";
 
+// 数值必须与 @juzi/wechaty-puppet 的 DirtyType 严格一致。
 enum PayloadType {
   PAYLOAD_TYPE_UNSPECIFIED = 0;
   PAYLOAD_TYPE_MESSAGE     = 1;
@@ -15,6 +16,9 @@ enum PayloadType {
   PAYLOAD_TYPE_POST        = 6;
   PAYLOAD_TYPE_TAG         = 7;
   PAYLOAD_TYPE_TAG_GROUP   = 8;
+  PAYLOAD_TYPE_WXXD_PRODUCT = 9;
+  PAYLOAD_TYPE_WXXD_ORDER   = 10;
+  PAYLOAD_TYPE_CALL         = 11;
 }
 
 message StartRequest {}

package/dist/cjs/proto/wechaty/puppet/call.proto

@@ -5,6 +5,8 @@ option go_package       = "github.com/wechaty/go-grpc/wechaty/puppet";
 option java_package     = "io.github.wechaty.grpc.puppet";
 option csharp_namespace = "github.wechaty.grpc.puppet";
 
+import "google/protobuf/timestamp.proto";
+
 enum CallType {
   CALL_TYPE_UNKNOWN = 0; // 不明确
   CALL_TYPE_VOICE = 1; // 语音
@@ -15,7 +17,7 @@ enum CallStatus { // 类型枚举
   CALL_STATUS_UNKNOWN = 0; // 不明确
   CALL_STATUS_CANCELED = 1; // 自己取消
   CALL_STATUS_REJECTED = 2; // 对方拒接
-  CALL_STATUS_MISSED = 3; // 正在通话
+  CALL_STATUS_MISSED = 3; // 未接
   CALL_STATUS_ONGOING = 4; // 正在通话
   CALL_STATUS_ENDED = 5; // 已结束
 }
@@ -27,3 +29,101 @@ message CallRecordPayload {
   CallType type = 4;
   CallStatus status = 5;
 }
+
+// 通话信令域全貌：
+// - 下行动作（业务侧 → 协议端）= CallInvite / CallAdd / CallAccept / CallReject / CallCancel / CallHangup
+//   六个独立 RPC（对齐 MessageSendText / MessageRecall / FriendshipAccept 的「一动作一 RPC」惯例）；
+// - CallMediaEndpoint 为媒体入场券：按需向协议端换取媒体网关协商入口（url/token），刻意不缓存；
+// - 状态面 = CallPayload 查询 + dirty(PAYLOAD_TYPE_CALL, id) 失效通知：协议端在任何通话状态变化时
+//   发 dirty，业务侧再经 CallPayload 拉取最新快照；
+// - 上行回执（ringing/accept/reject/cancel/hangup 及来电 invite）一律经 EVENT_TYPE_CALL 事件上行，
+//   payload 为 JSON 序列化的字符串（含 callId/signal/contactId/reason?/timestamp）；
+// - Ringing 没有下行 RPC：响铃回执是被叫协议端的自动行为，不是业务动作。
+
+// 发起呼叫请求：callId 不由主叫携带，而是由 puppet 实现侧生成并经 CallInviteResponse 返回。
+message CallInviteRequest {
+  // 受邀方 contactId 列表（不含发起方）：单元素 = 1v1 通话，多元素 = 群通话；
+  // 无论几人，一通通话只铸造一个 call_id。
+  repeated string contact_ids = 1;
+  CallType media = 2; // 必填：媒体类型（VOICE/VIDEO），复用既有 CallType；零值 CALL_TYPE_UNKNOWN 会被 server 拒绝
+}
+
+// CallInvite 响应：
+// - call_id 由 puppet 实现侧（协议端）生成并经本响应返回，全链路以此关联控制面与媒体旁路；
+// - 上行 EVENT_TYPE_CALL 事件可能先于本响应到达，客户端须容忍乱序；
+// - 后续控制 RPC（CallAccept/CallReject/CallCancel/CallHangup）凭此 call_id 引用本通通话。
+message CallInviteResponse {
+  string call_id = 1;
+}
+
+// 通话中途拉人（errors-only 契约）：
+// - 新参与者的应答回执（响铃/接听/拒接）一律经 EVENT_TYPE_CALL 事件上行，本响应恒为空；
+// - 拉人特有的失败（通话不存在/已结束、人数上限等）经 gRPC status error 返回。
+message CallAddRequest {
+  string call_id = 1; // 由 CallInvite 响应获得
+  repeated string contact_ids = 2; // 新增受邀方 contactId 列表（不含已在通话中的参与者）
+}
+
+message CallAddResponse {}
+
+// 以下四个控制 RPC（CallAccept/CallReject/CallCancel/CallHangup）的信令投递为 errors-only 契约：
+// gRPC status error 仅表示传输失败或 puppet 不支持；对端的业务响应（响铃/接听/拒接/挂断）
+// 一律经 EVENT_TYPE_CALL 事件上行，故四个响应消息恒为空。
+
+// 被叫接听来电。
+message CallAcceptRequest {
+  string call_id = 1; // 由 CallInvite 响应获得；协议端持有会话状态，凭此即可定位会话（无需 peer/media）
+}
+
+message CallAcceptResponse {}
+
+// 被叫拒接来电。
+message CallRejectRequest {
+  string call_id = 1; // 由 CallInvite 响应获得；协议端持有会话状态，凭此即可定位会话（无需 peer/media）
+  string reason  = 2; // 可空，空串表示无
+}
+
+message CallRejectResponse {}
+
+// 接通前主叫取消呼叫。
+message CallCancelRequest {
+  string call_id = 1; // 由 CallInvite 响应获得；协议端持有会话状态，凭此即可定位会话（无需 peer/media）
+}
+
+message CallCancelResponse {}
+
+// 接通后任一方挂断。
+message CallHangupRequest {
+  string call_id = 1; // 由 CallInvite 响应获得；协议端持有会话状态，凭此即可定位会话（无需 peer/media）
+  string reason  = 2; // 可空，空串表示无
+}
+
+message CallHangupResponse {}
+
+// 媒体入场券：按 call_id 向协议端换取媒体网关协商入口。
+// 签发可能在网关侧预分配媒体会话（有副作用），故服务端不得缓存响应、客户端按需拉取。
+message CallMediaEndpointRequest {
+  string call_id = 1; // 由 CallInvite 响应获得
+}
+
+message CallMediaEndpointResponse {
+  string url      = 1; // 媒体网关协商入口（非媒体流地址本身）
+  string token    = 2; // 短时效凭证，绑定 call_id + 本端身份
+  google.protobuf.Timestamp expires_at = 3; // 凭证过期时刻；不设置 = 不过期；过期后重新拉取本 RPC
+  string protocol = 4; // 入口方言（如 whip / livekit / 自定义），由媒体 SDK 消费
+}
+
+// 通话状态快照查询（对齐 ContactPayload 的实体查询模式）：
+// 协议端在任何通话状态变化时须发 dirty(PAYLOAD_TYPE_CALL, id)，业务侧凭此失效缓存后重新拉取。
+message CallPayloadRequest {
+  string id = 1; // call_id
+}
+
+message CallPayloadResponse {
+  string id      = 1;
+  string starter = 2; // 发起方 contactId；空串 = 协议端不可知（如中途被拉入者视角）
+  repeated string participants = 3; // 当前全量参与者名册
+  CallType media = 4; // 当前媒体类型（语音↔视频切换经 dirty 反映）
+  google.protobuf.Timestamp start_time = 5; // 通话发起时刻；接通时刻不在此（等于上行 Accept 事件的 timestamp）
+  google.protobuf.Timestamp end_time   = 6; // 通话结束时刻；未设置 = 通话进行中
+}

package/dist/cjs/proto/wechaty/puppet/channel.proto

@@ -18,6 +18,25 @@ message ChannelPayload {
   // 视频号直播专属
   string object_id = 9;
   string object_nonce_id = 10;
+
+  // 个微（phoenix）转发视频号所需补充字段，来自接收视频号的 appmsg.finderFeed
+  string username = 11;                  // 视频号 finder userName
+  int32  auth_icon_type = 12;            // 认证类型
+  string auth_icon_url = 13;             // 授权图标地址
+  string from_user_name = 14;            // 视频号转发自好友 userName
+  repeated ChannelMedia media_list = 15; // 媒体资源列表（图片类视频号可多条）
+}
+
+// 视频号媒体资源，对应接收视频号 finderFeed.mediaList.media
+message ChannelMedia {
+  int32  media_type = 1;          // 资源类型 2:图片 4:视频
+  string url = 2;                 // 原始媒体流地址
+  string thumb_url = 3;           // 视频第一帧缩略图地址
+  string full_cover_url = 4;      // 封面缩略图地址
+  string cover_url = 5;           // 封面地址
+  int32  width = 6;               // 缩略图宽度，默认 1080
+  int32  height = 7;              // 缩略图高度，默认 1920
+  int32  video_play_duration = 8; // 视频播放时长（秒）
 }
 
 enum ChannelFeedType {

package/dist/cjs/proto/wechaty/puppet/event.proto

@@ -34,6 +34,7 @@ enum EventType {
   EVENT_TYPE_ROOM_ANNOUNCE = 32;
   EVENT_TYPE_VERIFY_CODE   = 33;
   EVENT_TYPE_VERIFY_SLIDE  = 34;
+  EVENT_TYPE_CALL          = 35;
 }
 
 message EventRequest {