Conversations models use Memory v1's 8-value channel enum, so a VIDEO address fails to parse and VOICE is accepted on send
I maintainer di solito rispondono entro 5 giorni
Nessuno ha ancora preso questa issue.
Valutazione
- Difficoltà
- 4/5
- Tempo stimato
- 3-5 giorni
- Idoneità per principianti
- 45/100
- Tipo di issue
- Bug
- Chiarezza
- Abbastanza chiara
- Stato di attività
- Attiva
- Stack tecnologico
- python, typescript
- Ambito
- api
Direzione di ricerca
Start with src/tac/models/conversation.py and the referenced TypeScript schemas in packages/core/src/types/conversation.ts; compare their channel types with the canonical Conversations enums cited in the issue. First resolve whether the documented EMAIL address is supported or the spec prose is stale. Done when receive/address and send channels match the confirmed definitions and both SDKs accept valid responses while rejecting invalid send channels.
Scritto dal modello di indicizzazione a partire dal testo della issue.
Descrizione
What differs
Both SDKs use a single 8-value channel union for every channel field in the Conversations v2 models. The canonical definition has two channel enums for Conversations, with six and four values, and neither is the union the SDKs use.
Verified against main today (2026-10-08): Python at 2c24bd988c, TypeScript at c34450aa8c. All line citations are for navigation only.
| source | values |
|---|---|
| SDK union (both languages) | VOICE SMS RCS EMAIL WHATSAPP CHAT API SYSTEM |
conversations.v2.channel (receive/address) |
VOICE SMS RCS WHATSAPP CHAT VIDEO |
conversations.v2.send_channel (send) |
SMS RCS WHATSAPP CHAT |
The canonical enums are in twilio/twilio-oai spec/yaml/twilio_conversations_v2.yaml at 141f1201b5, :1997-2005 and :2007-2015.
The SDK union appears to have been taken from Memory v1, not Conversations: spec/yaml/twilio_memory_v1.yaml:3450-3461 declares Participant.channel as exactly those eight values, in exactly that order. That is the mechanism rather than a guess — the order matches member for member.
Sites:
- Python
src/tac/models/conversation.py:83(ParticipantAddress),:270(CommunicationParticipant),:445(ActionParticipantRef) - TypeScript
packages/core/src/types/conversation.ts:9-18(ParticipantAddressTypeSchema), applied at:25,:39,:124(ActionParticipantRefSchema) and:302(ConversationAddressSchema)
Three consequences, one of which breaks reads
-
VIDEOis rejected on the read path.conversations.v2.channelincludesVIDEO; the SDK union does not. A participant carrying aVIDEOaddress makesParticipantResponse(**response.json())raiseValidationErrorin Python and makesListParticipantsResponseSchema.parse(data)throw in TypeScript — solist_participants/listParticipantsfails on a response the API is entitled to send. This is the sharpest one: a caller cannot read the conversation at all, and no caller mistake is involved. -
EMAIL,APIandSYSTEMare accepted client-side where the Conversations definition does not declare them, so a caller who sets one gets a service-side 400 instead of a type error at the point of the mistake. -
The send path accepts receive-only channels.
ActionParticipantRef(conversation.py:445,conversation.ts:124) is thefrom/toof aSEND_MESSAGEaction, where the definition usessend_channel— four values, with the note "VOICE is receive-only and not supported for send operations." The SDKs permitVOICE, plus the three undeclared values.
What the models should declare
Two distinct types rather than one, matching the two canonical enums:
- an address/receive channel —
VOICE SMS RCS WHATSAPP CHAT VIDEO— forParticipantAddress,CommunicationParticipant,ConversationAddress - a send channel —
SMS RCS WHATSAPP CHAT— forActionParticipantRef
If Memory v1's eight-value enum is needed for Memory models, keeping it under its own name would stop it being reused where Conversations' narrower enums apply.
One thing to confirm on your side
The canonical definition is not entirely self-consistent here, so please check this rather than taking the table above as settled. conversations.v2.participant's addresses description still documents an EMAIL address format — "- EMAIL: Email address (such as "[email protected]")", twilio_conversations_v2.yaml:462, and at four further sites — while the channel enum it points at has no EMAIL. So either the enum is missing a value or the prose is stale, and we cannot tell which from outside. If EMAIL is genuinely supported, the fix is in the definition and only VIDEO and the send/receive split apply to the SDKs.
Context, and no urgency implied
Found while building an OpenAPI-driven client generator against the canonical twilio-oai specs and comparing its output with the hand-written SDKs. Filed here rather than in the TypeScript repo because the two track each other and Python looks like the source (your twilio-agent-connect-typescript HEAD is "Synced from Python"); the TypeScript sites are listed above so both can move together. We are not blocked and nothing here needs a response on any timeline.
- Lingua principale
- Python
- Stelle
- 17
- Fork
- 11
- Merge medio
- 5g 19h
- PR unite (30g)
- 6
Preparare l'ambiente
- Nessun Dockerfile né file Docker Compose
- Ha un modello di pull request
- Leggi la guida per i contributori
Come iniziare
- Leggi tutta la issue e poi la guida ai contributi del progetto.
- Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
- Fai un fork del repository e lavora su un branch.
- Apri una pull request che faccia riferimento al numero della issue.
Altre issue di twilio/twilio-agent-connect-python
-
ParticipantResponse.name is required where the API definition marks it nullable, so a nameless participant fails to parseForse già presa @TheeCoderAhmed l’ha presa 22 giorni fa. Aperta
Difficoltà 1/5 Meno di un'ora Idoneità per principianti 86/100
twilio/twilio-agent-connect-python#134 ·
I maintainer di solito rispondono entro 5 giorni
-
Difficoltà 2/5 1-3 ore Idoneità per principianti 50/100
twilio/twilio-agent-connect-python#136 ·
I maintainer di solito rispondono entro 5 giorni
-
Difficoltà 5/5 Più di una settimana Idoneità per principianti 25/100
twilio/twilio-agent-connect-python#135 ·
I maintainer di solito rispondono entro 5 giorni
-
Difficoltà 5/5 Più di una settimana Idoneità per principianti 30/100
twilio/twilio-agent-connect-python#101 ·
I maintainer di solito rispondono entro 5 giorni
-
add tac config validationsForse già presa @rahulsjha l’ha presa 4 giorni fa. Aperta
Difficoltà 3/5 1-2 giorni Idoneità per principianti 45/100
twilio/twilio-agent-connect-python#70 · 1 commento ·
I maintainer di solito rispondono entro 5 giorni
Tutte le issue di twilio/twilio-agent-connect-python
Issue simili
-
Difficoltà 2/5 1-3 ore Idoneità per principianti 64/100
I maintainer di solito rispondono entro 1 giorno
-
Harden tools/pr_threads.sh: pass all printed thread fields through the deterministic sanitizerApertaarea:cli area:security enhancement priority:medium size:small
Difficoltà 2/5 1-3 ore Idoneità per principianti 76/100
RonaldHensbergen/composable-data-stack#1338 ·
I maintainer di solito rispondono entro 1 giorno
-
area:stdlib effort:S impact:med platform:linux type:bug
Difficoltà 2/5 1-3 ore Idoneità per principianti 84/100
I maintainer di solito rispondono entro 1 giorno
-
automated endpoint-dead needs-curation
Difficoltà 2/5 1-3 ore Idoneità per principianti 76/100
almanac-data/climate-almanac#139 ·
I maintainer di solito rispondono entro 1 giorno
-
Difficoltà 2/5 1-3 ore Idoneità per principianti 82/100
UKGovernmentBEIS/inspect_ai#6695 · 1 commento ·
I maintainer di solito rispondono entro 1 giorno