@juzi/wechaty-grpc 1.0.105 → 1.0.107

package/dist/cjs/out/wechaty/puppet.openapi.yaml

@@ -9,7 +9,7 @@ info:
 
     Wechaty Puppet Service is the RESTful API for Wechaty API, which is build on
     top of the Wechaty Puppet Abstraction and the gRPC proto definition.
-  version: 1.0.105
+  version: 1.0.107
   contact:
     name: Wechaty
     url: https://github.com/wechaty/openapi
@@ -44,6 +44,26 @@ paths:
             $ref: '#/definitions/puppetCallInviteRequest'
       tags:
         - Puppet
+  /call/invite-with-media:
+    post:
+      operationId: Puppet_CallInviteWithMedia
+      responses:
+        '200':
+          description: A successful response.
+          schema:
+            $ref: '#/definitions/puppetCallInviteWithMediaResponse'
+        default:
+          description: An unexpected error response.
+          schema:
+            $ref: '#/definitions/rpcStatus'
+      parameters:
+        - name: body
+          in: body
+          required: true
+          schema:
+            $ref: '#/definitions/puppetCallInviteWithMediaRequest'
+      tags:
+        - Puppet
   /call/{callId}/accept:
     post:
       operationId: Puppet_CallAccept
@@ -3589,6 +3609,45 @@ definitions:
       - call_id 由 puppet 实现侧（协议端）生成并经本响应返回，全链路以此关联控制面与媒体旁路；
       - 上行 EVENT_TYPE_CALL 事件可能先于本响应到达，客户端须容忍乱序；
       - 后续控制 RPC（CallAccept/CallReject/CallCancel/CallHangup）凭此 call_id 引用本通通话。
+  puppetCallInviteWithMediaRequest:
+    type: object
+    properties:
+      contactIds:
+        type: array
+        items:
+          type: string
+        title: >-
+          对齐 CallInviteRequest：单元素 = 1v1，多元素 = 群通话播报（当前无实现支持，实现侧可拒
+          UNIMPLEMENTED）
+      fileBox:
+        type: string
+        title: |-
+          FileBox 序列化串（URL/OSS 形态优先），puppet 侧按内容指纹缓存下载与转码产物；
+          空 = 不播放、仅拨打（接通即视为"播放完成"，配合 hangup_on_finish 实现"接通 N 毫秒后自动挂断"）
+      hangupOnFinish:
+        type: boolean
+        title: |-
+          播放完成后自动挂断。"播放完成时刻" = 有文件时播放结束、无文件时接通。
+          file_box 为空时必须为 true（否则语义等价 CallInvite，应直接用 CallInvite），实现侧校验。
+      hangupDelayMs:
+        type: integer
+        format: int64
+        title: |-
+          播放完成 → 自动挂断的间隔毫秒数，0 = 立即；仅 hangup_on_finish = true 时生效。
+          有文件时留缓冲防尾音被挂断信令掐掉；无文件时即"接通后 N 毫秒挂断"。
+    title: |-
+      拨打并在接通后自动播放媒体文件（触达/群发场景）。
+      与 CallInvite 的区别：puppet 侧在振铃期间即预下载+转码媒体文件，接通后零延迟起播，
+      播放完成后可按配置自动挂断；业务侧一次 RPC 完成全部编排，无需媒体面连接。
+      未接通（拒接/超时/取消）走正常终态事件，不播放。
+  puppetCallInviteWithMediaResponse:
+    type: object
+    properties:
+      callId:
+        type: string
+    title: |-
+      语义对齐 CallInviteResponse：call_id 由 puppet 实现侧生成，业务侧凭此
+      Cancel/Hangup、关联终态事件与录音产物；事件可能先于本响应到达，须容忍乱序。
   puppetCallMediaEndpointResponse:
     type: object
     properties:
@@ -3645,6 +3704,9 @@ definitions:
         $ref: '#/definitions/puppetCallType'
       status:
         $ref: '#/definitions/puppetCallStatus'
+      callId:
+        type: string
+        title: 关联控制面 call_id，可空字符串表示历史/未知
   puppetCallRejectResponse:
     type: object
   puppetCallStatus:
@@ -3672,7 +3734,7 @@ definitions:
       - CALL_TYPE_VOICE
       - CALL_TYPE_VIDEO
     default: CALL_TYPE_UNKNOWN
-    title: |-
+    description: |-
       - CALL_TYPE_UNKNOWN: 不明确
        - CALL_TYPE_VOICE: 语音
        - CALL_TYPE_VIDEO: 视频
@@ -4176,7 +4238,7 @@ definitions:
       - FRIENDSHIP_SCENE_TYPE_SHAKING
       - FRIENDSHIP_SCENE_TYPE_QRCODE
     default: FRIENDSHIP_SCENE_TYPE_UNSPECIFIED
-    title: 事件场景 wxwork中未使用
+    description: 事件场景 wxwork中未使用
   puppetFriendshipSearchHandleRequest:
     type: object
     properties:
@@ -5014,7 +5076,7 @@ definitions:
       - PAYLOAD_TYPE_WXXD_ORDER
       - PAYLOAD_TYPE_CALL
     default: PAYLOAD_TYPE_UNSPECIFIED
-    title: 数值必须与 @juzi/wechaty-puppet 的 DirtyType 严格一致。
+    description: 数值必须与 @juzi/wechaty-puppet 的 DirtyType 严格一致。
   puppetPostPayloadClient:
     type: object
     properties:
@@ -5146,7 +5208,7 @@ definitions:
       - POST_TYPE_TEXT_BUTTON
       - POST_TYPE_GOODS_CARD
     default: POST_TYPE_UNSPECIFIED
-    title: |-
+    description: |-
       - POST_TYPE_MOMENT: 朋友圈
        - POST_TYPE_CHANNEL: 视频号——原始设计走post，实际目前采用message
        - POST_TYPE_MESSAGE: 消息——富媒体消息
@@ -5308,7 +5370,7 @@ definitions:
       - ROOM_MEMBER_JOIN_SCENE_TYPE_QRCODE
       - ROOM_MEMBER_JOIN_SCENE_TYPE_OTHER
     default: ROOM_MEMBER_JOIN_SCENE_TYPE_UNKNOWN
-    title: 类型枚举
+    description: 类型枚举
   puppetRoomMemberListResponse:
     type: object
     properties:
@@ -5605,7 +5667,7 @@ definitions:
       - PERSONAL
       - CORPORATION
     default: Unspecific
-    title: |-
+    description: |-
       - PERSONAL: 个人标签
        - CORPORATION: 企业标签
   puppetTapType:

package/dist/cjs/out/wechaty/puppet.swagger.json

@@ -3,7 +3,7 @@
   "info": {
     "title": "Wechaty Puppet Service OpenAPI Specification",
     "description": "Wechaty is a Conversational RPA SDK for chatbot makers. With only 6 lines of code, you can create a bot on the most popular IMs like WeChat, Whatsapp, WeCom, Gitter, etc.\n\nWechaty Puppet Service is the RESTful API for Wechaty API, which is build on top of the Wechaty Puppet Abstraction and the gRPC proto definition.",
-    "version": "1.0.105",
+    "version": "1.0.107",
     "contact": {
       "name": "Wechaty",
       "url": "https://github.com/wechaty/openapi",
@@ -58,6 +58,38 @@
         ]
       }
     },
+    "/call/invite-with-media": {
+      "post": {
+        "operationId": "Puppet_CallInviteWithMedia",
+        "responses": {
+          "200": {
+            "description": "A successful response.",
+            "schema": {
+              "$ref": "#/definitions/puppetCallInviteWithMediaResponse"
+            }
+          },
+          "default": {
+            "description": "An unexpected error response.",
+            "schema": {
+              "$ref": "#/definitions/rpcStatus"
+            }
+          }
+        },
+        "parameters": [
+          {
+            "name": "body",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/puppetCallInviteWithMediaRequest"
+            }
+          }
+        ],
+        "tags": [
+          "Puppet"
+        ]
+      }
+    },
     "/call/{callId}/accept": {
       "post": {
         "operationId": "Puppet_CallAccept",
@@ -5378,6 +5410,41 @@
       },
       "title": "CallInvite 响应：\n- call_id 由 puppet 实现侧（协议端）生成并经本响应返回，全链路以此关联控制面与媒体旁路；\n- 上行 EVENT_TYPE_CALL 事件可能先于本响应到达，客户端须容忍乱序；\n- 后续控制 RPC（CallAccept/CallReject/CallCancel/CallHangup）凭此 call_id 引用本通通话。"
     },
+    "puppetCallInviteWithMediaRequest": {
+      "type": "object",
+      "properties": {
+        "contactIds": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "title": "对齐 CallInviteRequest：单元素 = 1v1，多元素 = 群通话播报（当前无实现支持，实现侧可拒 UNIMPLEMENTED）"
+        },
+        "fileBox": {
+          "type": "string",
+          "title": "FileBox 序列化串（URL/OSS 形态优先），puppet 侧按内容指纹缓存下载与转码产物；\n空 = 不播放、仅拨打（接通即视为\"播放完成\"，配合 hangup_on_finish 实现\"接通 N 毫秒后自动挂断\"）"
+        },
+        "hangupOnFinish": {
+          "type": "boolean",
+          "title": "播放完成后自动挂断。\"播放完成时刻\" = 有文件时播放结束、无文件时接通。\nfile_box 为空时必须为 true（否则语义等价 CallInvite，应直接用 CallInvite），实现侧校验。"
+        },
+        "hangupDelayMs": {
+          "type": "integer",
+          "format": "int64",
+          "title": "播放完成 → 自动挂断的间隔毫秒数，0 = 立即；仅 hangup_on_finish = true 时生效。\n有文件时留缓冲防尾音被挂断信令掐掉；无文件时即\"接通后 N 毫秒挂断\"。"
+        }
+      },
+      "title": "拨打并在接通后自动播放媒体文件（触达/群发场景）。\n与 CallInvite 的区别：puppet 侧在振铃期间即预下载+转码媒体文件，接通后零延迟起播，\n播放完成后可按配置自动挂断；业务侧一次 RPC 完成全部编排，无需媒体面连接。\n未接通（拒接/超时/取消）走正常终态事件，不播放。"
+    },
+    "puppetCallInviteWithMediaResponse": {
+      "type": "object",
+      "properties": {
+        "callId": {
+          "type": "string"
+        }
+      },
+      "title": "语义对齐 CallInviteResponse：call_id 由 puppet 实现侧生成，业务侧凭此\nCancel/Hangup、关联终态事件与录音产物；事件可能先于本响应到达，须容忍乱序。"
+    },
     "puppetCallMediaEndpointResponse": {
       "type": "object",
       "properties": {
@@ -5454,6 +5521,10 @@
         },
         "status": {
           "$ref": "#/definitions/puppetCallStatus"
+        },
+        "callId": {
+          "type": "string",
+          "title": "关联控制面 call_id，可空字符串表示历史/未知"
         }
       }
     },
@@ -5482,7 +5553,7 @@
         "CALL_TYPE_VIDEO"
       ],
       "default": "CALL_TYPE_UNKNOWN",
-      "title": "- CALL_TYPE_UNKNOWN: 不明确\n - CALL_TYPE_VOICE: 语音\n - CALL_TYPE_VIDEO: 视频"
+      "description": "- CALL_TYPE_UNKNOWN: 不明确\n - CALL_TYPE_VOICE: 语音\n - CALL_TYPE_VIDEO: 视频"
     },
     "puppetCancelVerifyCodeResponse": {
       "type": "object"
@@ -6138,7 +6209,7 @@
         "FRIENDSHIP_SCENE_TYPE_QRCODE"
       ],
       "default": "FRIENDSHIP_SCENE_TYPE_UNSPECIFIED",
-      "title": "事件场景 wxwork中未使用"
+      "description": "事件场景 wxwork中未使用"
     },
     "puppetFriendshipSearchHandleRequest": {
       "type": "object",
@@ -7231,7 +7302,7 @@
         "PAYLOAD_TYPE_CALL"
       ],
       "default": "PAYLOAD_TYPE_UNSPECIFIED",
-      "title": "数值必须与 @juzi/wechaty-puppet 的 DirtyType 严格一致。"
+      "description": "数值必须与 @juzi/wechaty-puppet 的 DirtyType 严格一致。"
     },
     "puppetPostPayloadClient": {
       "type": "object",
@@ -7422,7 +7493,7 @@
         "POST_TYPE_GOODS_CARD"
       ],
       "default": "POST_TYPE_UNSPECIFIED",
-      "title": "- POST_TYPE_MOMENT: 朋友圈\n - POST_TYPE_CHANNEL: 视频号——原始设计走post，实际目前采用message\n - POST_TYPE_MESSAGE: 消息——富媒体消息\n - POST_TYPE_BROADCAST: 群发\n - POST_TYPE_TEXT_BUTTON: puppet-mini 按钮消息\n - POST_TYPE_GOODS_CARD: puppet-mini 商品消息"
+      "description": "- POST_TYPE_MOMENT: 朋友圈\n - POST_TYPE_CHANNEL: 视频号——原始设计走post，实际目前采用message\n - POST_TYPE_MESSAGE: 消息——富媒体消息\n - POST_TYPE_BROADCAST: 群发\n - POST_TYPE_TEXT_BUTTON: puppet-mini 按钮消息\n - POST_TYPE_GOODS_CARD: puppet-mini 商品消息"
     },
     "puppetReferrer": {
       "type": "object",
@@ -7638,7 +7709,7 @@
         "ROOM_MEMBER_JOIN_SCENE_TYPE_OTHER"
       ],
       "default": "ROOM_MEMBER_JOIN_SCENE_TYPE_UNKNOWN",
-      "title": "类型枚举"
+      "description": "类型枚举"
     },
     "puppetRoomMemberListResponse": {
       "type": "object",
@@ -8082,7 +8153,7 @@
         "CORPORATION"
       ],
       "default": "Unspecific",
-      "title": "- PERSONAL: 个人标签\n - CORPORATION: 企业标签"
+      "description": "- PERSONAL: 个人标签\n - CORPORATION: 企业标签"
     },
     "puppetTapType": {
       "type": "string",

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

@@ -78,6 +78,7 @@ interface IPuppetService extends grpc.ServiceDefinition<grpc.UntypedServiceImple
     callCancel: IPuppetService_ICallCancel;
     callHangup: IPuppetService_ICallHangup;
     callMediaEndpoint: IPuppetService_ICallMediaEndpoint;
+    callInviteWithMedia: IPuppetService_ICallInviteWithMedia;
     callPayload: IPuppetService_ICallPayload;
     messageChatHistory: IPuppetService_IMessageChatHistory;
     messageRecall: IPuppetService_IMessageRecall;
@@ -638,6 +639,15 @@ interface IPuppetService_ICallMediaEndpoint extends grpc.MethodDefinition<wechat
     responseSerialize: grpc.serialize<wechaty_puppet_call_pb.CallMediaEndpointResponse>;
     responseDeserialize: grpc.deserialize<wechaty_puppet_call_pb.CallMediaEndpointResponse>;
 }
+interface IPuppetService_ICallInviteWithMedia extends grpc.MethodDefinition<wechaty_puppet_call_pb.CallInviteWithMediaRequest, wechaty_puppet_call_pb.CallInviteWithMediaResponse> {
+    path: "/wechaty.Puppet/CallInviteWithMedia";
+    requestStream: false;
+    responseStream: false;
+    requestSerialize: grpc.serialize<wechaty_puppet_call_pb.CallInviteWithMediaRequest>;
+    requestDeserialize: grpc.deserialize<wechaty_puppet_call_pb.CallInviteWithMediaRequest>;
+    responseSerialize: grpc.serialize<wechaty_puppet_call_pb.CallInviteWithMediaResponse>;
+    responseDeserialize: grpc.deserialize<wechaty_puppet_call_pb.CallInviteWithMediaResponse>;
+}
 interface IPuppetService_ICallPayload extends grpc.MethodDefinition<wechaty_puppet_call_pb.CallPayloadRequest, wechaty_puppet_call_pb.CallPayloadResponse> {
     path: "/wechaty.Puppet/CallPayload";
     requestStream: false;
@@ -1424,6 +1434,7 @@ export interface IPuppetServer extends grpc.UntypedServiceImplementation {
     callCancel: grpc.handleUnaryCall<wechaty_puppet_call_pb.CallCancelRequest, wechaty_puppet_call_pb.CallCancelResponse>;
     callHangup: grpc.handleUnaryCall<wechaty_puppet_call_pb.CallHangupRequest, wechaty_puppet_call_pb.CallHangupResponse>;
     callMediaEndpoint: grpc.handleUnaryCall<wechaty_puppet_call_pb.CallMediaEndpointRequest, wechaty_puppet_call_pb.CallMediaEndpointResponse>;
+    callInviteWithMedia: grpc.handleUnaryCall<wechaty_puppet_call_pb.CallInviteWithMediaRequest, wechaty_puppet_call_pb.CallInviteWithMediaResponse>;
     callPayload: grpc.handleUnaryCall<wechaty_puppet_call_pb.CallPayloadRequest, wechaty_puppet_call_pb.CallPayloadResponse>;
     messageChatHistory: grpc.handleUnaryCall<wechaty_puppet_message_pb.MessageChatHistoryRequest, wechaty_puppet_message_pb.MessageChatHistoryResponse>;
     messageRecall: grpc.handleUnaryCall<wechaty_puppet_message_pb.MessageRecallRequest, wechaty_puppet_message_pb.MessageRecallResponse>;
@@ -1666,6 +1677,9 @@ export interface IPuppetClient {
     callMediaEndpoint(request: wechaty_puppet_call_pb.CallMediaEndpointRequest, callback: (error: grpc.ServiceError | null, response: wechaty_puppet_call_pb.CallMediaEndpointResponse) => void): grpc.ClientUnaryCall;
     callMediaEndpoint(request: wechaty_puppet_call_pb.CallMediaEndpointRequest, metadata: grpc.Metadata, callback: (error: grpc.ServiceError | null, response: wechaty_puppet_call_pb.CallMediaEndpointResponse) => void): grpc.ClientUnaryCall;
     callMediaEndpoint(request: wechaty_puppet_call_pb.CallMediaEndpointRequest, metadata: grpc.Metadata, options: Partial<grpc.CallOptions>, callback: (error: grpc.ServiceError | null, response: wechaty_puppet_call_pb.CallMediaEndpointResponse) => void): grpc.ClientUnaryCall;
+    callInviteWithMedia(request: wechaty_puppet_call_pb.CallInviteWithMediaRequest, callback: (error: grpc.ServiceError | null, response: wechaty_puppet_call_pb.CallInviteWithMediaResponse) => void): grpc.ClientUnaryCall;
+    callInviteWithMedia(request: wechaty_puppet_call_pb.CallInviteWithMediaRequest, metadata: grpc.Metadata, callback: (error: grpc.ServiceError | null, response: wechaty_puppet_call_pb.CallInviteWithMediaResponse) => void): grpc.ClientUnaryCall;
+    callInviteWithMedia(request: wechaty_puppet_call_pb.CallInviteWithMediaRequest, metadata: grpc.Metadata, options: Partial<grpc.CallOptions>, callback: (error: grpc.ServiceError | null, response: wechaty_puppet_call_pb.CallInviteWithMediaResponse) => void): grpc.ClientUnaryCall;
     callPayload(request: wechaty_puppet_call_pb.CallPayloadRequest, callback: (error: grpc.ServiceError | null, response: wechaty_puppet_call_pb.CallPayloadResponse) => void): grpc.ClientUnaryCall;
     callPayload(request: wechaty_puppet_call_pb.CallPayloadRequest, metadata: grpc.Metadata, callback: (error: grpc.ServiceError | null, response: wechaty_puppet_call_pb.CallPayloadResponse) => void): grpc.ClientUnaryCall;
     callPayload(request: wechaty_puppet_call_pb.CallPayloadRequest, metadata: grpc.Metadata, options: Partial<grpc.CallOptions>, callback: (error: grpc.ServiceError | null, response: wechaty_puppet_call_pb.CallPayloadResponse) => void): grpc.ClientUnaryCall;
@@ -2071,6 +2085,9 @@ export class PuppetClient extends grpc.Client implements IPuppetClient {
     public callMediaEndpoint(request: wechaty_puppet_call_pb.CallMediaEndpointRequest, callback: (error: grpc.ServiceError | null, response: wechaty_puppet_call_pb.CallMediaEndpointResponse) => void): grpc.ClientUnaryCall;
     public callMediaEndpoint(request: wechaty_puppet_call_pb.CallMediaEndpointRequest, metadata: grpc.Metadata, callback: (error: grpc.ServiceError | null, response: wechaty_puppet_call_pb.CallMediaEndpointResponse) => void): grpc.ClientUnaryCall;
     public callMediaEndpoint(request: wechaty_puppet_call_pb.CallMediaEndpointRequest, metadata: grpc.Metadata, options: Partial<grpc.CallOptions>, callback: (error: grpc.ServiceError | null, response: wechaty_puppet_call_pb.CallMediaEndpointResponse) => void): grpc.ClientUnaryCall;
+    public callInviteWithMedia(request: wechaty_puppet_call_pb.CallInviteWithMediaRequest, callback: (error: grpc.ServiceError | null, response: wechaty_puppet_call_pb.CallInviteWithMediaResponse) => void): grpc.ClientUnaryCall;
+    public callInviteWithMedia(request: wechaty_puppet_call_pb.CallInviteWithMediaRequest, metadata: grpc.Metadata, callback: (error: grpc.ServiceError | null, response: wechaty_puppet_call_pb.CallInviteWithMediaResponse) => void): grpc.ClientUnaryCall;
+    public callInviteWithMedia(request: wechaty_puppet_call_pb.CallInviteWithMediaRequest, metadata: grpc.Metadata, options: Partial<grpc.CallOptions>, callback: (error: grpc.ServiceError | null, response: wechaty_puppet_call_pb.CallInviteWithMediaResponse) => void): grpc.ClientUnaryCall;
     public callPayload(request: wechaty_puppet_call_pb.CallPayloadRequest, callback: (error: grpc.ServiceError | null, response: wechaty_puppet_call_pb.CallPayloadResponse) => void): grpc.ClientUnaryCall;
     public callPayload(request: wechaty_puppet_call_pb.CallPayloadRequest, metadata: grpc.Metadata, callback: (error: grpc.ServiceError | null, response: wechaty_puppet_call_pb.CallPayloadResponse) => void): grpc.ClientUnaryCall;
     public callPayload(request: wechaty_puppet_call_pb.CallPayloadRequest, metadata: grpc.Metadata, options: Partial<grpc.CallOptions>, callback: (error: grpc.ServiceError | null, response: wechaty_puppet_call_pb.CallPayloadResponse) => void): grpc.ClientUnaryCall;

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

@@ -231,6 +231,28 @@ function deserialize_wechaty_puppet_CallInviteResponse(buffer_arg) {
   return wechaty_puppet_call_pb.CallInviteResponse.deserializeBinary(new Uint8Array(buffer_arg));
 }
 
+function serialize_wechaty_puppet_CallInviteWithMediaRequest(arg) {
+  if (!(arg instanceof wechaty_puppet_call_pb.CallInviteWithMediaRequest)) {
+    throw new Error('Expected argument of type wechaty.puppet.CallInviteWithMediaRequest');
+  }
+  return Buffer.from(arg.serializeBinary());
+}
+
+function deserialize_wechaty_puppet_CallInviteWithMediaRequest(buffer_arg) {
+  return wechaty_puppet_call_pb.CallInviteWithMediaRequest.deserializeBinary(new Uint8Array(buffer_arg));
+}
+
+function serialize_wechaty_puppet_CallInviteWithMediaResponse(arg) {
+  if (!(arg instanceof wechaty_puppet_call_pb.CallInviteWithMediaResponse)) {
+    throw new Error('Expected argument of type wechaty.puppet.CallInviteWithMediaResponse');
+  }
+  return Buffer.from(arg.serializeBinary());
+}
+
+function deserialize_wechaty_puppet_CallInviteWithMediaResponse(buffer_arg) {
+  return wechaty_puppet_call_pb.CallInviteWithMediaResponse.deserializeBinary(new Uint8Array(buffer_arg));
+}
+
 function serialize_wechaty_puppet_CallMediaEndpointRequest(arg) {
   if (!(arg instanceof wechaty_puppet_call_pb.CallMediaEndpointRequest)) {
     throw new Error('Expected argument of type wechaty.puppet.CallMediaEndpointRequest');
@@ -3546,6 +3568,17 @@ callMediaEndpoint: {
     responseSerialize: serialize_wechaty_puppet_CallMediaEndpointResponse,
     responseDeserialize: deserialize_wechaty_puppet_CallMediaEndpointResponse,
   },
+  callInviteWithMedia: {
+    path: '/wechaty.Puppet/CallInviteWithMedia',
+    requestStream: false,
+    responseStream: false,
+    requestType: wechaty_puppet_call_pb.CallInviteWithMediaRequest,
+    responseType: wechaty_puppet_call_pb.CallInviteWithMediaResponse,
+    requestSerialize: serialize_wechaty_puppet_CallInviteWithMediaRequest,
+    requestDeserialize: deserialize_wechaty_puppet_CallInviteWithMediaRequest,
+    responseSerialize: serialize_wechaty_puppet_CallInviteWithMediaResponse,
+    responseDeserialize: deserialize_wechaty_puppet_CallInviteWithMediaResponse,
+  },
   callPayload: {
     path: '/wechaty.Puppet/CallPayload',
     requestStream: false,

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

@@ -497,6 +497,15 @@ type PuppetCallMediaEndpoint = {
   readonly responseType: typeof wechaty_puppet_call_pb.CallMediaEndpointResponse;
 };
 
+type PuppetCallInviteWithMedia = {
+  readonly methodName: string;
+  readonly service: typeof Puppet;
+  readonly requestStream: false;
+  readonly responseStream: false;
+  readonly requestType: typeof wechaty_puppet_call_pb.CallInviteWithMediaRequest;
+  readonly responseType: typeof wechaty_puppet_call_pb.CallInviteWithMediaResponse;
+};
+
 type PuppetCallPayload = {
   readonly methodName: string;
   readonly service: typeof Puppet;
@@ -1281,6 +1290,7 @@ export class Puppet {
   static readonly CallCancel: PuppetCallCancel;
   static readonly CallHangup: PuppetCallHangup;
   static readonly CallMediaEndpoint: PuppetCallMediaEndpoint;
+  static readonly CallInviteWithMedia: PuppetCallInviteWithMedia;
   static readonly CallPayload: PuppetCallPayload;
   static readonly MessageChatHistory: PuppetMessageChatHistory;
   static readonly MessageRecall: PuppetMessageRecall;
@@ -1865,6 +1875,15 @@ export class PuppetClient {
     requestMessage: wechaty_puppet_call_pb.CallMediaEndpointRequest,
     callback: (error: ServiceError|null, responseMessage: wechaty_puppet_call_pb.CallMediaEndpointResponse|null) => void
   ): UnaryResponse;
+  callInviteWithMedia(
+    requestMessage: wechaty_puppet_call_pb.CallInviteWithMediaRequest,
+    metadata: grpc.Metadata,
+    callback: (error: ServiceError|null, responseMessage: wechaty_puppet_call_pb.CallInviteWithMediaResponse|null) => void
+  ): UnaryResponse;
+  callInviteWithMedia(
+    requestMessage: wechaty_puppet_call_pb.CallInviteWithMediaRequest,
+    callback: (error: ServiceError|null, responseMessage: wechaty_puppet_call_pb.CallInviteWithMediaResponse|null) => void
+  ): UnaryResponse;
   callPayload(
     requestMessage: wechaty_puppet_call_pb.CallPayloadRequest,
     metadata: grpc.Metadata,

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

@@ -503,6 +503,15 @@ Puppet.CallMediaEndpoint = {
   responseType: wechaty_puppet_call_pb.CallMediaEndpointResponse
 };
 
+Puppet.CallInviteWithMedia = {
+  methodName: "CallInviteWithMedia",
+  service: Puppet,
+  requestStream: false,
+  responseStream: false,
+  requestType: wechaty_puppet_call_pb.CallInviteWithMediaRequest,
+  responseType: wechaty_puppet_call_pb.CallInviteWithMediaResponse
+};
+
 Puppet.CallPayload = {
   methodName: "CallPayload",
   service: Puppet,
@@ -2890,6 +2899,37 @@ PuppetClient.prototype.callMediaEndpoint = function callMediaEndpoint(requestMes
   };
 };
 
+PuppetClient.prototype.callInviteWithMedia = function callInviteWithMedia(requestMessage, metadata, callback) {
+  if (arguments.length === 2) {
+    callback = arguments[1];
+  }
+  var client = grpc.unary(Puppet.CallInviteWithMedia, {
+    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];

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

@@ -28,6 +28,7 @@ message CallRecordPayload {
   int32 length = 3;
   CallType type = 4;
   CallStatus status = 5;
+  string call_id = 6; // 关联控制面 call_id，可空字符串表示历史/未知
 }
 
 // 通话信令域全貌：
@@ -56,6 +57,30 @@ message CallInviteResponse {
   string call_id = 1;
 }
 
+// 拨打并在接通后自动播放媒体文件（触达/群发场景）。
+// 与 CallInvite 的区别：puppet 侧在振铃期间即预下载+转码媒体文件，接通后零延迟起播，
+// 播放完成后可按配置自动挂断；业务侧一次 RPC 完成全部编排，无需媒体面连接。
+// 未接通（拒接/超时/取消）走正常终态事件，不播放。
+message CallInviteWithMediaRequest {
+  // 对齐 CallInviteRequest：单元素 = 1v1，多元素 = 群通话播报（当前无实现支持，实现侧可拒 UNIMPLEMENTED）
+  repeated string contact_ids = 1;
+  // FileBox 序列化串（URL/OSS 形态优先），puppet 侧按内容指纹缓存下载与转码产物；
+  // 空 = 不播放、仅拨打（接通即视为"播放完成"，配合 hangup_on_finish 实现"接通 N 毫秒后自动挂断"）
+  string file_box = 2;
+  // 播放完成后自动挂断。"播放完成时刻" = 有文件时播放结束、无文件时接通。
+  // file_box 为空时必须为 true（否则语义等价 CallInvite，应直接用 CallInvite），实现侧校验。
+  bool hangup_on_finish = 3;
+  // 播放完成 → 自动挂断的间隔毫秒数，0 = 立即；仅 hangup_on_finish = true 时生效。
+  // 有文件时留缓冲防尾音被挂断信令掐掉；无文件时即"接通后 N 毫秒挂断"。
+  uint32 hangup_delay_ms = 4;
+}
+
+// 语义对齐 CallInviteResponse：call_id 由 puppet 实现侧生成，业务侧凭此
+// Cancel/Hangup、关联终态事件与录音产物；事件可能先于本响应到达，须容忍乱序。
+message CallInviteWithMediaResponse {
+  string call_id = 1;
+}
+
 // 通话中途拉人（errors-only 契约）：
 // - 新参与者的应答回执（响铃/接听/拒接）一律经 EVENT_TYPE_CALL 事件上行，本响应恒为空；
 // - 拉人特有的失败（通话不存在/已结束、人数上限等）经 gRPC status error 返回。

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

@@ -436,6 +436,12 @@ service Puppet {
       body: "*"
     };
   }
+  rpc CallInviteWithMedia (puppet.CallInviteWithMediaRequest) returns (puppet.CallInviteWithMediaResponse) {
+    option (google.api.http) = {
+      post: "/call/invite-with-media"
+      body: "*"
+    };
+  }
   rpc CallPayload (puppet.CallPayloadRequest) returns (puppet.CallPayloadResponse) {
     option (google.api.http) = {
       get: "/call/{id}"

package/dist/cjs/src/package-json.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"package-json.d.ts","sourceRoot":"","sources":["../../../src/package-json.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAA;AAC5C,eAAO,MAAM,WAAW,EAAE,WAgGlB,CAAA"}
+{"version":3,"file":"package-json.d.ts","sourceRoot":"","sources":["../../../src/package-json.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAA;AAC5C,eAAO,MAAM,WAAW,EAAE,WAiGlB,CAAA"}

package/dist/cjs/src/package-json.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.packageJson = void 0;
 exports.packageJson = {
     "name": "@juzi/wechaty-grpc",
-    "version": "1.0.105",
+    "version": "1.0.107",
     "description": "gRPC for Wechaty",
     "type": "module",
     "exports": {
@@ -69,6 +69,7 @@ exports.packageJson = {
         "@chatie/tsconfig": "^4.6.3",
         "@swc/core": "1.3.39",
         "@types/google-protobuf": "^3.15.5",
+        "@types/node": "^20",
         "@types/protobufjs": "^6.0.0",
         "cross-env": "^7.0.3",
         "esquery": "1.4.0",

package/dist/cjs/src/package-json.js.map

@@ -1 +1 @@
-{"version":3,"file":"package-json.js","sourceRoot":"","sources":["../../../src/package-json.ts"],"names":[],"mappings":";;;AAIa,QAAA,WAAW,GAAgB;IACtC,MAAM,EAAE,oBAAoB;IAC5B,SAAS,EAAE,SAAS;IACpB,aAAa,EAAE,kBAAkB;IACjC,MAAM,EAAE,QAAQ;IAChB,SAAS,EAAE;QACT,GAAG,EAAE;YACH,QAAQ,EAAE,uBAAuB;YACjC,SAAS,EAAE,uBAAuB;SACnC;KACF;IACD,SAAS,EAAE,yBAAyB;IACpC,SAAS,EAAE;QACT,MAAM,EAAE,MAAM;QACd,KAAK,EAAE,KAAK;KACb;IACD,SAAS,EAAE;QACT,OAAO,EAAE,yBAAyB;QAClC,MAAM,EAAE,0DAA0D;QAClE,OAAO,EAAE,iCAAiC;QAC1C,eAAe,EAAE,8DAA8D;QAC/E,WAAW,EAAE,+BAA+B;QAC5C,UAAU,EAAE,uFAAuF;QACnG,UAAU,EAAE,uFAAuF;QACnG,SAAS,EAAE,oCAAoC;QAC/C,YAAY,EAAE,qBAAqB;QACnC,gBAAgB,EAAE,2CAA2C;QAC7D,gBAAgB,EAAE,4BAA4B;QAC9C,UAAU,EAAE,kCAAkC;QAC9C,MAAM,EAAE,wCAAwC;QAChD,SAAS,EAAE,0FAA0F;QACrG,SAAS,EAAE,gCAAgC;QAC3C,YAAY,EAAE,gKAAgK;QAC9K,gBAAgB,EAAE,mCAAmC;QACrD,MAAM,EAAE,0CAA0C;QAClD,WAAW,EAAE,qCAAqC;QAClD,WAAW,EAAE,+GAA+G;QAC5H,eAAe,EAAE,mHAAmH;KACrI;IACD,YAAY,EAAE;QACZ,MAAM,EAAE,KAAK;QACb,KAAK,EAAE,iDAAiD;KACzD;IACD,UAAU,EAAE;QACV,MAAM;QACN,QAAQ;QACR,SAAS;QACT,QAAQ;QACR,QAAQ;QACR,SAAS;KACV;IACD,QAAQ,EAAE,2BAA2B;IACrC,SAAS,EAAE,YAAY;IACvB,MAAM,EAAE;QACN,KAAK,EAAE,gDAAgD;KACxD;IACD,UAAU,EAAE,gDAAgD;IAC5D,cAAc,EAAE;QACd,eAAe,EAAE,QAAQ;QACzB,iBAAiB,EAAE,SAAS;QAC5B,wBAAwB,EAAE,QAAQ;KACnC;IACD,iBAAiB,EAAE;QACjB,uBAAuB,EAAE,QAAQ;QACjC,gBAAgB,EAAE,QAAQ;QAC1B,kBAAkB,EAAE,QAAQ;QAC5B,WAAW,EAAE,QAAQ;QACrB,wBAAwB,EAAE,SAAS;QACnC,mBAAmB,EAAE,QAAQ;QAC7B,WAAW,EAAE,QAAQ;QACrB,SAAS,EAAE,OAAO;QAClB,2BAA2B,EAAE,QAAQ;QACrC,YAAY,EAAE,SAAS;QACvB,OAAO,EAAE,QAAQ;QACjB,SAAS,EAAE,SAAS;QACpB,aAAa,EAAE,QAAQ;QACvB,SAAS,EAAE,SAAS;QACpB,KAAK,EAAE,QAAQ;QACf,SAAS,EAAE,QAAQ;QACnB,eAAe,EAAE,SAAS;QAC1B,QAAQ,EAAE,QAAQ;QAClB,YAAY,EAAE,QAAQ;KACvB;IACD,OAAO,EAAE;QACP,MAAM;QACN,OAAO;QACP,MAAM;QACN,MAAM;KACP;IACD,eAAe,EAAE;QACf,QAAQ,EAAE,QAAQ;QAClB,KAAK,EAAE,QAAQ;KAChB;IACD,KAAK,EAAE;QACL,gBAAgB,EAAE,KAAK;KACxB;CACK,CAAA"}
+{"version":3,"file":"package-json.js","sourceRoot":"","sources":["../../../src/package-json.ts"],"names":[],"mappings":";;;AAIa,QAAA,WAAW,GAAgB;IACtC,MAAM,EAAE,oBAAoB;IAC5B,SAAS,EAAE,SAAS;IACpB,aAAa,EAAE,kBAAkB;IACjC,MAAM,EAAE,QAAQ;IAChB,SAAS,EAAE;QACT,GAAG,EAAE;YACH,QAAQ,EAAE,uBAAuB;YACjC,SAAS,EAAE,uBAAuB;SACnC;KACF;IACD,SAAS,EAAE,yBAAyB;IACpC,SAAS,EAAE;QACT,MAAM,EAAE,MAAM;QACd,KAAK,EAAE,KAAK;KACb;IACD,SAAS,EAAE;QACT,OAAO,EAAE,yBAAyB;QAClC,MAAM,EAAE,0DAA0D;QAClE,OAAO,EAAE,iCAAiC;QAC1C,eAAe,EAAE,8DAA8D;QAC/E,WAAW,EAAE,+BAA+B;QAC5C,UAAU,EAAE,uFAAuF;QACnG,UAAU,EAAE,uFAAuF;QACnG,SAAS,EAAE,oCAAoC;QAC/C,YAAY,EAAE,qBAAqB;QACnC,gBAAgB,EAAE,2CAA2C;QAC7D,gBAAgB,EAAE,4BAA4B;QAC9C,UAAU,EAAE,kCAAkC;QAC9C,MAAM,EAAE,wCAAwC;QAChD,SAAS,EAAE,0FAA0F;QACrG,SAAS,EAAE,gCAAgC;QAC3C,YAAY,EAAE,gKAAgK;QAC9K,gBAAgB,EAAE,mCAAmC;QACrD,MAAM,EAAE,0CAA0C;QAClD,WAAW,EAAE,qCAAqC;QAClD,WAAW,EAAE,+GAA+G;QAC5H,eAAe,EAAE,mHAAmH;KACrI;IACD,YAAY,EAAE;QACZ,MAAM,EAAE,KAAK;QACb,KAAK,EAAE,iDAAiD;KACzD;IACD,UAAU,EAAE;QACV,MAAM;QACN,QAAQ;QACR,SAAS;QACT,QAAQ;QACR,QAAQ;QACR,SAAS;KACV;IACD,QAAQ,EAAE,2BAA2B;IACrC,SAAS,EAAE,YAAY;IACvB,MAAM,EAAE;QACN,KAAK,EAAE,gDAAgD;KACxD;IACD,UAAU,EAAE,gDAAgD;IAC5D,cAAc,EAAE;QACd,eAAe,EAAE,QAAQ;QACzB,iBAAiB,EAAE,SAAS;QAC5B,wBAAwB,EAAE,QAAQ;KACnC;IACD,iBAAiB,EAAE;QACjB,uBAAuB,EAAE,QAAQ;QACjC,gBAAgB,EAAE,QAAQ;QAC1B,kBAAkB,EAAE,QAAQ;QAC5B,WAAW,EAAE,QAAQ;QACrB,wBAAwB,EAAE,SAAS;QACnC,aAAa,EAAE,KAAK;QACpB,mBAAmB,EAAE,QAAQ;QAC7B,WAAW,EAAE,QAAQ;QACrB,SAAS,EAAE,OAAO;QAClB,2BAA2B,EAAE,QAAQ;QACrC,YAAY,EAAE,SAAS;QACvB,OAAO,EAAE,QAAQ;QACjB,SAAS,EAAE,SAAS;QACpB,aAAa,EAAE,QAAQ;QACvB,SAAS,EAAE,SAAS;QACpB,KAAK,EAAE,QAAQ;QACf,SAAS,EAAE,QAAQ;QACnB,eAAe,EAAE,SAAS;QAC1B,QAAQ,EAAE,QAAQ;QAClB,YAAY,EAAE,QAAQ;KACvB;IACD,OAAO,EAAE;QACP,MAAM;QACN,OAAO;QACP,MAAM;QACN,MAAM;KACP;IACD,eAAe,EAAE;QACf,QAAQ,EAAE,QAAQ;QAClB,KAAK,EAAE,QAAQ;KAChB;IACD,KAAK,EAAE;QACL,gBAAgB,EAAE,KAAK;KACxB;CACK,CAAA"}

package/dist/cjs/tests/puppet-server-impl.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"puppet-server-impl.d.ts","sourceRoot":"","sources":["../../../tests/puppet-server-impl.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,MAAM,EACP,MAAM,eAAe,CAAA;AAEtB,aAAK,aAAa,GAAG,MAAM,CAAC,aAAa,CAAA;AAEzC;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,aAqyB9B,CAAA"}
+{"version":3,"file":"puppet-server-impl.d.ts","sourceRoot":"","sources":["../../../tests/puppet-server-impl.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,MAAM,EACP,MAAM,eAAe,CAAA;AAEtB,aAAK,aAAa,GAAG,MAAM,CAAC,aAAa,CAAA;AAEzC;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,aA2yB9B,CAAA"}

package/dist/cjs/tests/puppet-server-impl.js

@@ -194,6 +194,11 @@ exports.puppetServerImpl = {
         void callback;
         throw new Error('not implemented.');
     },
+    callInviteWithMedia: (call, callback) => {
+        void call;
+        void callback;
+        throw new Error('not implemented.');
+    },
     callPayload: (call, callback) => {
         void call;
         void callback;