ParticipantResponse.name is required where the API definition marks it nullable, so a nameless participant fails to parse

オープン 初心者向け
#134 コメント 0 件 リアクション 0 件 担当者 0 名 GitHub で見る

メンテナーはふだん 5 日以内に返信

@TheeCoderAhmed がすでに取り組んでいます。

2026年10月29日 から。

  • #147 @TheeCoderAhmed による — オープン

評価

難易度
1/5
見積もり時間
1時間未満
初心者へのやさしさ
86/100
issue の種類
バグ
明瞭さ
明確に書かれている
活発さ
活発
技術スタック
python
領域
api

調査の方向性

src/tac/models/conversation.pyと、237~243行付近のParticipantResponseの宣言を読み、nameフィールドをissueで引用されているnullableかつoptionalな定義と比較してください。src/tac/context/conversation.pyにあるparticipantの構築経路を確認し、関連するmodelまたはcontextのテストを実行してください。nameが欠落している、またはnullのresponsesが正常にパースされ、その他の必須フィールドは引き続き必須であれば完了です。

索引モデルが issue の本文から書いたものです。

説明

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: is id, conversationId, accountId — name is not in it
  • name is type: string with nullable: 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.

主要言語
Python
スター
17
フォーク
11
平均マージ
5日 19時間
マージ済み PR(30日)
6

環境構築

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

twilio/twilio-agent-connect-python のほかの issue

twilio/twilio-agent-connect-python の issue をすべて見る

似ている issue

Python の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。