@agent-wechat/agent-wechat 1.5.1 → 2.0.0-beta.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -16,6 +16,9 @@
16
16
  "wechat_group_info",
17
17
  "wechat_login",
18
18
  "wechat_call"
19
+ ],
20
+ "trustedToolPolicies": [
21
+ "wechat-conference-consultation"
19
22
  ]
20
23
  },
21
24
  "toolMetadata": {
@@ -157,7 +160,7 @@
157
160
  "calls": {
158
161
  "type": "object",
159
162
  "additionalProperties": false,
160
- "description": "Independent voice and video permissions. Both default off; the current backend supports direct voice only.",
163
+ "description": "Independent voice and video permissions. Voice includes direct calls and separately configured conferences; both default off.",
161
164
  "properties": {
162
165
  "voice": {
163
166
  "type": "object",
@@ -166,7 +169,42 @@
166
169
  "enabled": {
167
170
  "type": "boolean",
168
171
  "default": false,
169
- "description": "Enable direct voice calling. Disabled voice calls are ignored without answering or declining."
172
+ "description": "Enable voice calling. Conferences require an exact group rule or an explicit wildcard group rule. Disabled voice calls are ignored without answering or declining."
173
+ },
174
+ "mode": {
175
+ "type": "string",
176
+ "enum": [
177
+ "bidi",
178
+ "agent"
179
+ ],
180
+ "default": "bidi",
181
+ "description": "bidi uses a realtime voice model (including Live); agent transcribes speech, runs the configured OpenClaw agent and speaks through OpenClaw TTS. Applies to direct calls and conferences."
182
+ },
183
+ "transcription": {
184
+ "type": "object",
185
+ "additionalProperties": false,
186
+ "properties": {
187
+ "provider": {
188
+ "type": "string",
189
+ "minLength": 1,
190
+ "maxLength": 200,
191
+ "default": "openai",
192
+ "description": "Registered realtime transcription provider for agent mode."
193
+ },
194
+ "model": {
195
+ "type": "string",
196
+ "minLength": 1,
197
+ "maxLength": 200
198
+ },
199
+ "language": {
200
+ "type": "string",
201
+ "minLength": 1,
202
+ "maxLength": 200
203
+ },
204
+ "apiKey": {
205
+ "description": "Optional OpenClaw SecretRef or API-key string for the transcription provider. Omitted uses provider configuration."
206
+ }
207
+ }
170
208
  },
171
209
  "inboundPolicy": {
172
210
  "type": "string",
@@ -182,7 +220,8 @@
182
220
  "type": "string",
183
221
  "minLength": 1,
184
222
  "maxLength": 200
185
- }
223
+ },
224
+ "description": "Direct-call caller IDs; an explicit '*' accepts any incoming caller. Admission does not grant owner consultation."
186
225
  },
187
226
  "outboundPolicy": {
188
227
  "type": "string",
@@ -209,6 +248,98 @@
209
248
  "maxLength": 200
210
249
  }
211
250
  },
251
+ "conferences": {
252
+ "type": "object",
253
+ "additionalProperties": false,
254
+ "properties": {
255
+ "groups": {
256
+ "type": "object",
257
+ "maxProperties": 128,
258
+ "propertyNames": {
259
+ "type": "string",
260
+ "pattern": "^(?:\\*|.+@chatroom)$",
261
+ "maxLength": 200
262
+ },
263
+ "description": "Exact group IDs or '*'. An exact rule overrides the wildcard, including autoJoin=false. Wildcard auto-join requires autoJoinAllowFrom; use ['*'] to accept any inviter.",
264
+ "allOf": [
265
+ {
266
+ "if": {
267
+ "required": [
268
+ "*"
269
+ ],
270
+ "properties": {
271
+ "*": {
272
+ "required": [
273
+ "autoJoin"
274
+ ],
275
+ "properties": {
276
+ "autoJoin": {
277
+ "const": true
278
+ }
279
+ }
280
+ }
281
+ }
282
+ },
283
+ "then": {
284
+ "properties": {
285
+ "*": {
286
+ "required": [
287
+ "autoJoinAllowFrom"
288
+ ]
289
+ }
290
+ }
291
+ }
292
+ }
293
+ ],
294
+ "additionalProperties": {
295
+ "type": "object",
296
+ "additionalProperties": false,
297
+ "properties": {
298
+ "autoJoin": {
299
+ "type": "boolean",
300
+ "default": false,
301
+ "description": "Join current authenticated invitations matching this group rule after voice preflight. No configured groups means no conference automation."
302
+ },
303
+ "autoJoinAllowFrom": {
304
+ "type": "array",
305
+ "maxItems": 128,
306
+ "items": {
307
+ "type": "string",
308
+ "minLength": 1,
309
+ "maxLength": 200
310
+ },
311
+ "description": "Conference inviter IDs; '*' accepts any inviter and an empty list disables auto-join. Required for wildcard-group auto-join. An exact group may omit this field to accept any inviter. The current inviter is rechecked before joining."
312
+ },
313
+ "toolPolicy": {
314
+ "type": "string",
315
+ "enum": [
316
+ "none",
317
+ "safe-read-only",
318
+ "owner"
319
+ ],
320
+ "default": "safe-read-only",
321
+ "description": "Conference consultation authority. Owner requires voice.toolPolicy=owner and an exact agent-wechat:GROUP_ID grant in commands.ownerAllowFrom. It trusts the whole group without attributing speech to a person; otherwise consultation stays read-only."
322
+ },
323
+ "ownerInviterToolPolicy": {
324
+ "type": "string",
325
+ "enum": [
326
+ "none",
327
+ "safe-read-only",
328
+ "owner"
329
+ ],
330
+ "description": "Optional policy for calls whose authenticated inviter exactly matches an agent-wechat:CONTACT_ID owner grant. Otherwise toolPolicy applies. Owner also requires voice.toolPolicy=owner and an exact group owner grant. Applies to the whole call, including later participants; permissions can decrease but cannot increase during a call."
331
+ },
332
+ "sessionKey": {
333
+ "type": "string",
334
+ "pattern": "^agent:[a-z0-9][a-z0-9_-]{0,63}:[^:\\s][^\\s]*$",
335
+ "maxLength": 1024,
336
+ "description": "Optional consultation parent session of this voice agent for this group. Default sessions are isolated by account, group and authority."
337
+ }
338
+ }
339
+ }
340
+ }
341
+ }
342
+ },
212
343
  "agentId": {
213
344
  "type": "string",
214
345
  "minLength": 1,
@@ -248,7 +379,7 @@
248
379
  "enabled": {
249
380
  "type": "boolean",
250
381
  "default": false,
251
- "description": "Send bounded excerpts of the selected agent's IDENTITY.md and SOUL.md to the Realtime provider. Configured agent identity is used independently."
382
+ "description": "Use OpenClaw's shared voice context to send bounded IDENTITY.md, USER.md and SOUL.md excerpts for direct calls and conferences. Configured agent identity is used independently; normal agent/TTS turns already receive host context."
252
383
  }
253
384
  }
254
385
  },
@@ -573,7 +704,7 @@
573
704
  "calls": {
574
705
  "type": "object",
575
706
  "additionalProperties": false,
576
- "description": "Independent voice and video permissions. Both default off; the current backend supports direct voice only.",
707
+ "description": "Independent voice and video permissions. Voice includes direct calls and separately configured conferences; both default off.",
577
708
  "properties": {
578
709
  "voice": {
579
710
  "type": "object",
@@ -582,7 +713,42 @@
582
713
  "enabled": {
583
714
  "type": "boolean",
584
715
  "default": false,
585
- "description": "Enable direct voice calling. Disabled voice calls are ignored without answering or declining."
716
+ "description": "Enable voice calling. Conferences require an exact group rule or an explicit wildcard group rule. Disabled voice calls are ignored without answering or declining."
717
+ },
718
+ "mode": {
719
+ "type": "string",
720
+ "enum": [
721
+ "bidi",
722
+ "agent"
723
+ ],
724
+ "default": "bidi",
725
+ "description": "bidi uses a realtime voice model (including Live); agent transcribes speech, runs the configured OpenClaw agent and speaks through OpenClaw TTS. Applies to direct calls and conferences."
726
+ },
727
+ "transcription": {
728
+ "type": "object",
729
+ "additionalProperties": false,
730
+ "properties": {
731
+ "provider": {
732
+ "type": "string",
733
+ "minLength": 1,
734
+ "maxLength": 200,
735
+ "default": "openai",
736
+ "description": "Registered realtime transcription provider for agent mode."
737
+ },
738
+ "model": {
739
+ "type": "string",
740
+ "minLength": 1,
741
+ "maxLength": 200
742
+ },
743
+ "language": {
744
+ "type": "string",
745
+ "minLength": 1,
746
+ "maxLength": 200
747
+ },
748
+ "apiKey": {
749
+ "description": "Optional OpenClaw SecretRef or API-key string for the transcription provider. Omitted uses provider configuration."
750
+ }
751
+ }
586
752
  },
587
753
  "inboundPolicy": {
588
754
  "type": "string",
@@ -598,7 +764,8 @@
598
764
  "type": "string",
599
765
  "minLength": 1,
600
766
  "maxLength": 200
601
- }
767
+ },
768
+ "description": "Direct-call caller IDs; an explicit '*' accepts any incoming caller. Admission does not grant owner consultation."
602
769
  },
603
770
  "outboundPolicy": {
604
771
  "type": "string",
@@ -625,6 +792,98 @@
625
792
  "maxLength": 200
626
793
  }
627
794
  },
795
+ "conferences": {
796
+ "type": "object",
797
+ "additionalProperties": false,
798
+ "properties": {
799
+ "groups": {
800
+ "type": "object",
801
+ "maxProperties": 128,
802
+ "propertyNames": {
803
+ "type": "string",
804
+ "pattern": "^(?:\\*|.+@chatroom)$",
805
+ "maxLength": 200
806
+ },
807
+ "description": "Exact group IDs or '*'. An exact rule overrides the wildcard, including autoJoin=false. Wildcard auto-join requires autoJoinAllowFrom; use ['*'] to accept any inviter.",
808
+ "allOf": [
809
+ {
810
+ "if": {
811
+ "required": [
812
+ "*"
813
+ ],
814
+ "properties": {
815
+ "*": {
816
+ "required": [
817
+ "autoJoin"
818
+ ],
819
+ "properties": {
820
+ "autoJoin": {
821
+ "const": true
822
+ }
823
+ }
824
+ }
825
+ }
826
+ },
827
+ "then": {
828
+ "properties": {
829
+ "*": {
830
+ "required": [
831
+ "autoJoinAllowFrom"
832
+ ]
833
+ }
834
+ }
835
+ }
836
+ }
837
+ ],
838
+ "additionalProperties": {
839
+ "type": "object",
840
+ "additionalProperties": false,
841
+ "properties": {
842
+ "autoJoin": {
843
+ "type": "boolean",
844
+ "default": false,
845
+ "description": "Join current authenticated invitations matching this group rule after voice preflight. No configured groups means no conference automation."
846
+ },
847
+ "autoJoinAllowFrom": {
848
+ "type": "array",
849
+ "maxItems": 128,
850
+ "items": {
851
+ "type": "string",
852
+ "minLength": 1,
853
+ "maxLength": 200
854
+ },
855
+ "description": "Conference inviter IDs; '*' accepts any inviter and an empty list disables auto-join. Required for wildcard-group auto-join. An exact group may omit this field to accept any inviter. The current inviter is rechecked before joining."
856
+ },
857
+ "toolPolicy": {
858
+ "type": "string",
859
+ "enum": [
860
+ "none",
861
+ "safe-read-only",
862
+ "owner"
863
+ ],
864
+ "default": "safe-read-only",
865
+ "description": "Conference consultation authority. Owner requires voice.toolPolicy=owner and an exact agent-wechat:GROUP_ID grant in commands.ownerAllowFrom. It trusts the whole group without attributing speech to a person; otherwise consultation stays read-only."
866
+ },
867
+ "ownerInviterToolPolicy": {
868
+ "type": "string",
869
+ "enum": [
870
+ "none",
871
+ "safe-read-only",
872
+ "owner"
873
+ ],
874
+ "description": "Optional policy for calls whose authenticated inviter exactly matches an agent-wechat:CONTACT_ID owner grant. Otherwise toolPolicy applies. Owner also requires voice.toolPolicy=owner and an exact group owner grant. Applies to the whole call, including later participants; permissions can decrease but cannot increase during a call."
875
+ },
876
+ "sessionKey": {
877
+ "type": "string",
878
+ "pattern": "^agent:[a-z0-9][a-z0-9_-]{0,63}:[^:\\s][^\\s]*$",
879
+ "maxLength": 1024,
880
+ "description": "Optional consultation parent session of this voice agent for this group. Default sessions are isolated by account, group and authority."
881
+ }
882
+ }
883
+ }
884
+ }
885
+ }
886
+ },
628
887
  "agentId": {
629
888
  "type": "string",
630
889
  "minLength": 1,
@@ -664,7 +923,7 @@
664
923
  "enabled": {
665
924
  "type": "boolean",
666
925
  "default": false,
667
- "description": "Send bounded excerpts of the selected agent's IDENTITY.md and SOUL.md to the Realtime provider. Configured agent identity is used independently."
926
+ "description": "Use OpenClaw's shared voice context to send bounded IDENTITY.md, USER.md and SOUL.md excerpts for direct calls and conferences. Configured agent identity is used independently; normal agent/TTS turns already receive host context."
668
927
  }
669
928
  }
670
929
  },
@@ -822,6 +1081,11 @@
822
1081
  "path": "calls.voice.realtime.providers.openai.apiKey",
823
1082
  "expected": "string",
824
1083
  "ownerKind": "capability"
1084
+ },
1085
+ {
1086
+ "path": "calls.voice.transcription.apiKey",
1087
+ "expected": "string",
1088
+ "ownerKind": "capability"
825
1089
  }
826
1090
  ]
827
1091
  }
@@ -832,6 +1096,9 @@
832
1096
  },
833
1097
  "calls.voice.realtime.providers.openai.apiKey": {
834
1098
  "sensitive": true
1099
+ },
1100
+ "calls.voice.transcription.apiKey": {
1101
+ "sensitive": true
835
1102
  }
836
1103
  }
837
1104
  }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@agent-wechat/agent-wechat",
3
- "version": "1.5.1",
3
+ "version": "2.0.0-beta.1",
4
4
  "license": "MIT",
5
5
  "type": "module",
6
6
  "files": [
@@ -13,7 +13,7 @@
13
13
  "esbuild": "^0.25.0",
14
14
  "openclaw": "2026.10.9",
15
15
  "typescript": "^5.4.5",
16
- "@agent-wechat/shared": "1.1.1"
16
+ "@agent-wechat/shared": "2.0.0-beta.0"
17
17
  },
18
18
  "openclaw": {
19
19
  "extensions": [
@@ -209,7 +209,7 @@
209
209
  "calls": {
210
210
  "type": "object",
211
211
  "additionalProperties": false,
212
- "description": "Independent voice and video permissions. Both default off; the current backend supports direct voice only.",
212
+ "description": "Independent voice and video permissions. Voice includes direct calls and separately configured conferences; both default off.",
213
213
  "properties": {
214
214
  "voice": {
215
215
  "type": "object",
@@ -218,7 +218,42 @@
218
218
  "enabled": {
219
219
  "type": "boolean",
220
220
  "default": false,
221
- "description": "Enable direct voice calling. Disabled voice calls are ignored without answering or declining."
221
+ "description": "Enable voice calling. Conferences require an exact group rule or an explicit wildcard group rule. Disabled voice calls are ignored without answering or declining."
222
+ },
223
+ "mode": {
224
+ "type": "string",
225
+ "enum": [
226
+ "bidi",
227
+ "agent"
228
+ ],
229
+ "default": "bidi",
230
+ "description": "bidi uses a realtime voice model (including Live); agent transcribes speech, runs the configured OpenClaw agent and speaks through OpenClaw TTS. Applies to direct calls and conferences."
231
+ },
232
+ "transcription": {
233
+ "type": "object",
234
+ "additionalProperties": false,
235
+ "properties": {
236
+ "provider": {
237
+ "type": "string",
238
+ "minLength": 1,
239
+ "maxLength": 200,
240
+ "default": "openai",
241
+ "description": "Registered realtime transcription provider for agent mode."
242
+ },
243
+ "model": {
244
+ "type": "string",
245
+ "minLength": 1,
246
+ "maxLength": 200
247
+ },
248
+ "language": {
249
+ "type": "string",
250
+ "minLength": 1,
251
+ "maxLength": 200
252
+ },
253
+ "apiKey": {
254
+ "description": "Optional OpenClaw SecretRef or API-key string for the transcription provider. Omitted uses provider configuration."
255
+ }
256
+ }
222
257
  },
223
258
  "inboundPolicy": {
224
259
  "type": "string",
@@ -234,7 +269,8 @@
234
269
  "type": "string",
235
270
  "minLength": 1,
236
271
  "maxLength": 200
237
- }
272
+ },
273
+ "description": "Direct-call caller IDs; an explicit '*' accepts any incoming caller. Admission does not grant owner consultation."
238
274
  },
239
275
  "outboundPolicy": {
240
276
  "type": "string",
@@ -261,6 +297,98 @@
261
297
  "maxLength": 200
262
298
  }
263
299
  },
300
+ "conferences": {
301
+ "type": "object",
302
+ "additionalProperties": false,
303
+ "properties": {
304
+ "groups": {
305
+ "type": "object",
306
+ "maxProperties": 128,
307
+ "propertyNames": {
308
+ "type": "string",
309
+ "pattern": "^(?:\\*|.+@chatroom)$",
310
+ "maxLength": 200
311
+ },
312
+ "description": "Exact group IDs or '*'. An exact rule overrides the wildcard, including autoJoin=false. Wildcard auto-join requires autoJoinAllowFrom; use ['*'] to accept any inviter.",
313
+ "allOf": [
314
+ {
315
+ "if": {
316
+ "required": [
317
+ "*"
318
+ ],
319
+ "properties": {
320
+ "*": {
321
+ "required": [
322
+ "autoJoin"
323
+ ],
324
+ "properties": {
325
+ "autoJoin": {
326
+ "const": true
327
+ }
328
+ }
329
+ }
330
+ }
331
+ },
332
+ "then": {
333
+ "properties": {
334
+ "*": {
335
+ "required": [
336
+ "autoJoinAllowFrom"
337
+ ]
338
+ }
339
+ }
340
+ }
341
+ }
342
+ ],
343
+ "additionalProperties": {
344
+ "type": "object",
345
+ "additionalProperties": false,
346
+ "properties": {
347
+ "autoJoin": {
348
+ "type": "boolean",
349
+ "default": false,
350
+ "description": "Join current authenticated invitations matching this group rule after voice preflight. No configured groups means no conference automation."
351
+ },
352
+ "autoJoinAllowFrom": {
353
+ "type": "array",
354
+ "maxItems": 128,
355
+ "items": {
356
+ "type": "string",
357
+ "minLength": 1,
358
+ "maxLength": 200
359
+ },
360
+ "description": "Conference inviter IDs; '*' accepts any inviter and an empty list disables auto-join. Required for wildcard-group auto-join. An exact group may omit this field to accept any inviter. The current inviter is rechecked before joining."
361
+ },
362
+ "toolPolicy": {
363
+ "type": "string",
364
+ "enum": [
365
+ "none",
366
+ "safe-read-only",
367
+ "owner"
368
+ ],
369
+ "default": "safe-read-only",
370
+ "description": "Conference consultation authority. Owner requires voice.toolPolicy=owner and an exact agent-wechat:GROUP_ID grant in commands.ownerAllowFrom. It trusts the whole group without attributing speech to a person; otherwise consultation stays read-only."
371
+ },
372
+ "ownerInviterToolPolicy": {
373
+ "type": "string",
374
+ "enum": [
375
+ "none",
376
+ "safe-read-only",
377
+ "owner"
378
+ ],
379
+ "description": "Optional policy for calls whose authenticated inviter exactly matches an agent-wechat:CONTACT_ID owner grant. Otherwise toolPolicy applies. Owner also requires voice.toolPolicy=owner and an exact group owner grant. Applies to the whole call, including later participants; permissions can decrease but cannot increase during a call."
380
+ },
381
+ "sessionKey": {
382
+ "type": "string",
383
+ "pattern": "^agent:[a-z0-9][a-z0-9_-]{0,63}:[^:\\s][^\\s]*$",
384
+ "maxLength": 1024,
385
+ "description": "Optional consultation parent session of this voice agent for this group. Default sessions are isolated by account, group and authority."
386
+ }
387
+ }
388
+ }
389
+ }
390
+ }
391
+ },
264
392
  "agentId": {
265
393
  "type": "string",
266
394
  "minLength": 1,
@@ -300,7 +428,7 @@
300
428
  "enabled": {
301
429
  "type": "boolean",
302
430
  "default": false,
303
- "description": "Send bounded excerpts of the selected agent's IDENTITY.md and SOUL.md to the Realtime provider. Configured agent identity is used independently."
431
+ "description": "Use OpenClaw's shared voice context to send bounded IDENTITY.md, USER.md and SOUL.md excerpts for direct calls and conferences. Configured agent identity is used independently; normal agent/TTS turns already receive host context."
304
432
  }
305
433
  }
306
434
  },