ParticipantResponse.name is required where the API definition marks it nullable, so a nameless participant fails to parse
I maintainer di solito rispondono entro 5 giorni
Valutazione
- Difficoltà
- 1/5
- Tempo stimato
- Meno di un'ora
- Idoneità per principianti
- 86/100
Direzione di ricerca
Leggi src/tac/models/conversation.py e la dichiarazione di ParticipantResponse intorno alle righe 237–243; confronta il suo campo name con la definizione nullable e facoltativa citata nell’issue. Controlla i percorsi di costruzione dei participants in src/tac/context/conversation.py ed esegui i test pertinenti del model o del context. Il lavoro è completato quando le responses senza name o con valore null vengono analizzate correttamente, mentre gli altri campi obbligatori restano obbligatori.
Scritto dal modello di indicizzazione a partire dal testo della issue.
Descrizione
What differs
ParticipantResponse.name is a required, non-nullable str, where the canonical definition marks the field nullable and does not require it. A participant with no display name therefore raises ValidationError client-side on a response the API is entitled to send.
Verified against main today (2026-10-08) at 2c24bd988c. All line citations are for navigation only.
# src/tac/models/conversation.py:237-243
class ParticipantResponse(BaseModel):
id: str = Field(..., description="Participant ID")
conversation_id: str = Field(..., alias="conversationId", description="Conversation ID")
account_id: str = Field(..., alias="accountId", description="Account ID")
name: str = Field(..., description="Participant display name")
What the definition declares
twilio/twilio-oai spec/yaml/twilio_conversations_v2.yaml, schema conversations.v2.participant at 141f1201b5 (:422-445):
required:isid,conversationId,accountId—nameis not in itnameistype: stringwithnullable: true
The other three required fields match the model exactly, so name is the only divergence in this class.
Consequence
create_participant, update_participant and list_participants all construct ParticipantResponse(**...) (src/tac/context/conversation.py:140, :204, :228). Any participant the service returns without a name — or with "name": null, which nullable: true permits — makes all three raise, so the caller cannot read a conversation's participants rather than reading them with name=None.
What the model should declare
name: str | None = Field(None, description="Participant display name"), matching the treatment profile_id, created_at and updated_at already get in the same class.
The TypeScript port has a milder instance of the same thing
Not a separate report, since the two SDKs track each other — twilio/twilio-agent-connect-typescript at c34450aa8c, packages/core/src/types/conversation.ts:316:
export const ConversationParticipantSchema = z.object({
...
name: z.string().optional(), // :316 — accepts missing, rejects null
.optional() admits undefined but not null, so an explicit "name": null fails ListParticipantsResponseSchema.parse. The same file already uses the right shape twice for exactly this reason, with the reason in the comment — :281 name: z.string().nullish(), // API returns null when not set and :304 channelId: z.string().nullish(), // API returns null when not set. .nullish() at :316 would make it consistent.
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. We are not blocked — 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
-
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à 4/5 3-5 giorni Idoneità per principianti 45/100
twilio/twilio-agent-connect-python#133 ·
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