From c9f5f09d50d3fa3029f1576bc8750f0f01286b16 Mon Sep 17 00:00:00 2001
From: Jiwon Kim <jiwon@openai.com>
Date: Wed, 15 Oct 2025 11:31:29 -0700
Subject: [PATCH 1/2] Use IconName type for EntitySource, CustomSummary,
 CustomTask

---
 chatkit/types.py | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/chatkit/types.py b/chatkit/types.py
index 5cfa024..51c3724 100644
--- a/chatkit/types.py
+++ b/chatkit/types.py
@@ -707,7 +707,7 @@ class CustomSummary(BaseModel):
     """Custom summary for a workflow."""
 
     title: str
-    icon: str | None = None
+    icon: IconName | None = None
 
 
 class DurationSummary(BaseModel):
@@ -735,7 +735,7 @@ class CustomTask(BaseTask):
 
     type: Literal["custom"] = "custom"
     title: str | None = None
-    icon: str | None = None
+    icon: IconName | None = None
     content: str | None = None
 
 
@@ -811,7 +811,7 @@ class EntitySource(SourceBase):
 
     type: Literal["entity"] = "entity"
     id: str
-    icon: str | None = None
+    icon: IconName | None = None
     preview: Literal["lazy"] | None = None
     data: dict[str, Any] = Field(default_factory=dict)
 

From 78ade7a77d0af9058c535566146f5e40a2c04e97 Mon Sep 17 00:00:00 2001
From: Jiwon Kim <jiwon@openai.com>
Date: Wed, 15 Oct 2025 11:45:44 -0700
Subject: [PATCH 2/2] Keep IconName in sync

---
 chatkit/types.py   | 30 ++++++++++++++++++++++++++++++
 chatkit/widgets.py |  2 ++
 2 files changed, 32 insertions(+)

diff --git a/chatkit/types.py b/chatkit/types.py
index 51c3724..728c7ef 100644
--- a/chatkit/types.py
+++ b/chatkit/types.py
@@ -831,29 +831,56 @@ class EntitySource(SourceBase):
 
 
 IconName = Literal[
+    "agent",
     "analytics",
     "atom",
+    "batch",
     "bolt",
     "book-open",
     "book-closed",
+    "book-clock",
+    "bug",
     "calendar",
     "chart",
+    "check",
+    "check-circle",
+    "check-circle-filled",
+    "chevron-left",
+    "chevron-right",
     "circle-question",
     "compass",
+    "confetti",
     "cube",
+    "desktop",
+    "document",
+    "dot",
+    "dots-horizontal",
+    "dots-vertical",
+    "empty-circle",
+    "external-link",
     "globe",
     "keys",
     "lab",
     "images",
+    "info",
     "lifesaver",
     "lightbulb",
+    "mail",
     "map-pin",
+    "maps",
+    "mobile",
     "name",
     "notebook",
     "notebook-pencil",
     "page-blank",
+    "phone",
+    "play",
+    "plus",
     "profile",
     "profile-card",
+    "reload",
+    "star",
+    "star-filled",
     "search",
     "sparkle",
     "sparkle-double",
@@ -861,6 +888,9 @@ class EntitySource(SourceBase):
     "square-image",
     "square-text",
     "suitcase",
+    "settings-slider",
+    "user",
+    "wreath",
     "write",
     "write-alt",
     "write-alt2",
diff --git a/chatkit/widgets.py b/chatkit/widgets.py
index 7477da2..ecfc6b2 100644
--- a/chatkit/widgets.py
+++ b/chatkit/widgets.py
@@ -1044,10 +1044,12 @@ class LineSeries(BaseModel):
     "agent",
     "analytics",
     "atom",
+    "batch",
     "bolt",
     "book-open",
     "book-clock",
     "book-closed",
+    "bug",
     "calendar",
     "chart",
     "check",