Use WidgetTemplate from chatkit-python for news guide widgets (#37)

* use widget files for news guide

* use logger

* types

* bump versions; fix bugs

Author: jiwon-oai

examples/news-guide/backend/app/agents/event_finder_agent.py

@@ -65,7 +65,7 @@ async def search_events_by_date(
     ctx: RunContextWrapper[EventFinderContext],
     date: str,
 ) -> dict[str, Any]:
-    logger.info("[TOOL CALL] search_events_by_date", date)
+    logger.info("[TOOL CALL] search_events_by_date: %s", date)
     if not date:
         raise ValueError("Provide a valid date in YYYY-MM-DD format.")
     await ctx.context.stream(ProgressUpdateEvent(text=f"Looking up events on {date}"))
@@ -78,7 +78,7 @@ async def search_events_by_day_of_week(
     ctx: RunContextWrapper[EventFinderContext],
     day: str,
 ) -> dict[str, Any]:
-    logger.info("[TOOL CALL] search_events_by_day_of_week", day)
+    logger.info("[TOOL CALL] search_events_by_day_of_week: %s", day)
     if not day:
         raise ValueError("Provide a day of the week to search for (e.g., Saturday).")
     await ctx.context.stream(ProgressUpdateEvent(text=f"Checking {day} events"))
@@ -93,7 +93,7 @@ async def search_events_by_keyword(
     ctx: RunContextWrapper[EventFinderContext],
     keywords: List[str],
 ) -> dict[str, Any]:
-    logger.info("[TOOL CALL] search_events_by_keyword", keywords)
+    logger.info("[TOOL CALL] search_events_by_keyword: %s", keywords)
     tokens = [keyword.strip() for keyword in keywords if keyword and keyword.strip()]
     if not tokens:
         raise ValueError("Provide at least one keyword to search for.")
@@ -118,7 +118,7 @@ async def show_event_list_widget(
     events: List[EventRecord],
     message: str | None = None,
 ):
-    logger.info("[TOOL CALL] show_event_list_widget", events)
+    logger.info("[TOOL CALL] show_event_list_widget: %s", events)
     records: List[EventRecord] = [event for event in events if event]
 
     # Gracefully handle case where agent mistakenly calls this tool with no events.

examples/news-guide/backend/app/server.py

@@ -25,7 +25,6 @@
     WidgetItem,
     WidgetRootUpdated,
 )
-from chatkit.widgets import ListView
 from openai.types.responses import ResponseInputContentParam
 
 from .agents.event_finder_agent import EventFinderContext, event_finder_agent
@@ -157,13 +156,7 @@ async def _handle_view_event_details_action(
         record = self.event_store.get_event(selected_event_id) if selected_event_id else None
 
         # If the event is already selected, no need to show the details again.
-        if (
-            is_selected
-            or not record
-            or not event_ids
-            or not sender
-            or not isinstance(sender.widget, ListView)
-        ):
+        if is_selected or not record or not event_ids or not sender:
             return
 
         records: list[EventRecord] = []

examples/news-guide/backend/app/widgets/article_list_widget.py

@@ -8,10 +8,9 @@
 from datetime import datetime
 from typing import Any
 
-from chatkit.widgets import WidgetRoot
+from chatkit.widgets import WidgetRoot, WidgetTemplate
 
 from ..data.article_store import ArticleMetadata
-from .widget_template import WidgetTemplate
 
 
 def _format_date(value: datetime) -> str:

examples/news-guide/backend/app/widgets/event_list_widget.py

@@ -8,10 +8,9 @@
 from itertools import groupby
 from typing import Any, Iterable, Mapping
 
-from chatkit.widgets import WidgetRoot
+from chatkit.widgets import WidgetRoot, WidgetTemplate
 
 from ..data.event_store import EventRecord
-from .widget_template import WidgetTemplate
 
 CATEGORY_COLORS: dict[str, str] = {
     "community": "purple-400",

examples/news-guide/backend/app/widgets/preview_widgets.py

@@ -1,7 +1,8 @@
 from typing import Any
 
+from chatkit.widgets import BasicRoot, WidgetTemplate
+
 from ..data.article_store import ArticleMetadata
-from .widget_template import BasicRoot, WidgetTemplate
 
 AUTHOR_PROFILES: dict[str, dict[str, str]] = {
     "elowen-wilder": {

examples/news-guide/backend/app/widgets/widget_template.py

@@ -8,7 +8,7 @@ dependencies = [
     "fastapi>=0.114.1,<0.116",
     "uvicorn[standard]>=0.36,<0.37",
     "openai>=1.40",
-    "openai-chatkit>=1.1.2,<2",
+    "openai-chatkit>=1.4.0,<2",
     "jinja2",
 ]
 

examples/news-guide/backend/pyproject.toml

@@ -14,7 +14,7 @@
     "npm": ">=9"
   },
   "dependencies": {
-    "@openai/chatkit-react": "^1.0.0",
+    "@openai/chatkit-react": "^1.3.0",
     "clsx": "^2.1.1",
     "lucide-react": "^0.544.0",
     "react": "^19.2.0",