ParticipantResponse.name is required where the API definition marks it nullable, so a nameless participant fails to parse
メンテナーはふだん 5 日以内に返信
評価
調査の方向性
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: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.
- 主要言語
- Python
- スター
- 17
- フォーク
- 11
- 平均マージ
- 5日 19時間
- マージ済み PR(30日)
- 6
環境構築
- Dockerfile・Docker Compose ファイルなし
- プルリクエストのテンプレートあり
- コントリビューションガイドを読む
はじめの一歩
- issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
- 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
- リポジトリをフォークし、ブランチを切って変更します。
- issue 番号を参照したプルリクエストを送ります。
twilio/twilio-agent-connect-python のほかの issue
-
難易度 2/5 1〜3時間 初心者へのやさしさ 50/100
twilio/twilio-agent-connect-python#136 ·
メンテナーはふだん 5 日以内に返信
-
難易度 5/5 1週間以上 初心者へのやさしさ 25/100
twilio/twilio-agent-connect-python#135 ·
メンテナーはふだん 5 日以内に返信
-
難易度 4/5 3〜5日 初心者へのやさしさ 45/100
twilio/twilio-agent-connect-python#133 ·
メンテナーはふだん 5 日以内に返信
-
難易度 5/5 1週間以上 初心者へのやさしさ 30/100
twilio/twilio-agent-connect-python#101 ·
メンテナーはふだん 5 日以内に返信
-
add tac config validations対応中かも @rahulsjha が 4 日前に担当しました。 オープン
難易度 3/5 1〜2日 初心者へのやさしさ 45/100
twilio/twilio-agent-connect-python#70 · コメント 1 件 ·
メンテナーはふだん 5 日以内に返信
twilio/twilio-agent-connect-python の issue をすべて見る
似ている issue
-
難易度 2/5 1〜3時間 初心者へのやさしさ 64/100
メンテナーはふだん 1 日以内に返信
-
area:cli area:security enhancement priority:medium size:small
難易度 2/5 1〜3時間 初心者へのやさしさ 76/100
RonaldHensbergen/composable-data-stack#1338 ·
メンテナーはふだん 1 日以内に返信
-
area:stdlib effort:S impact:med platform:linux type:bug
難易度 2/5 1〜3時間 初心者へのやさしさ 84/100
メンテナーはふだん 1 日以内に返信
-
automated endpoint-dead needs-curation
難易度 2/5 1〜3時間 初心者へのやさしさ 76/100
almanac-data/climate-almanac#139 ·
メンテナーはふだん 1 日以内に返信
-
難易度 2/5 1〜3時間 初心者へのやさしさ 82/100
UKGovernmentBEIS/inspect_ai#6695 · コメント 1 件 ·
メンテナーはふだん 1 日以内に返信