style: apply ruff format to Python codebase (CopilotKit#4813)

## Summary

One-time `ruff format .` across the Python codebase — 320 files,
7759+/4678-.

This aligns the existing Python code with the ruff format check added in
CopilotKit#4812. Without this, the push-to-main format job fails on every merge
that touches the `static / quality` workflow.

## Why a separate PR

Pure formatting, no behavioral changes. Keeping it isolated makes git
blame clean — one commit to skip, not interleaved with logic changes.

## Test plan

- [ ] CI format job passes (the whole point)
- [ ] Python unit tests unaffected (formatting only)

Author: jpr5

examples/canvas/gemini/agent/main.py

@@ -5,7 +5,7 @@
 import os
 from dotenv import load_dotenv
 
-load_dotenv()  
+load_dotenv()
 
 from fastapi import FastAPI
 import uvicorn

examples/canvas/gemini/agent/posts_generator_agent.py

@@ -4,6 +4,7 @@
 import os
 from langchain_google_genai import ChatGoogleGenerativeAI
 from prompts import system_prompt, system_prompt_3, system_prompt_4
+
 load_dotenv()
 from typing import Dict, List, Any
 from langchain_core.runnables import RunnableConfig
@@ -16,6 +17,7 @@
 import uuid
 import asyncio
 
+
 # Define the agent's runtime state schema for CopilotKit/LangGraph
 class AgentState(CopilotKitState):
     tool_logs: List[Dict[str, Any]]
@@ -43,9 +45,9 @@ async def chat_node(state: AgentState, config: RunnableConfig):
             google_api_key=os.getenv("GOOGLE_API_KEY"),
         )
         messages = [*state["messages"]]
-        messages[-1].content = (
-            "The posts had been generated successfully. Just generate a summary of the posts."
-        )
+        messages[
+            -1
+        ].content = "The posts had been generated successfully. Just generate a summary of the posts."
         resp = await client.ainvoke(
             [*state["messages"]],
             config,
@@ -62,19 +64,17 @@ async def chat_node(state: AgentState, config: RunnableConfig):
     if config is None:
         config = RunnableConfig(recursion_limit=25)
     else:
-        config = copilotkit_customize_config(config, emit_messages=True, emit_tool_calls=True)
+        config = copilotkit_customize_config(
+            config, emit_messages=True, emit_tool_calls=True
+        )
     # 4. Generating the response using the model. This returns the response along with the web search queries.
     response = await model.aio.models.generate_content(
         model="gemini-2.5-pro",
         contents=[
             types.Content(role="user", parts=[types.Part(text=system_prompt)]),
             types.Content(
                 role="model",
-                parts=[
-                    types.Part(
-                        text= system_prompt_4
-                    )
-                ],
+                parts=[types.Part(text=system_prompt_4)],
             ),
             types.Content(
                 role="user", parts=[types.Part(text=state["messages"][-1].content)]
@@ -86,11 +86,17 @@ async def chat_node(state: AgentState, config: RunnableConfig):
     state["tool_logs"][-1]["status"] = "completed"
     await copilotkit_emit_state(config, state)
     state["response"] = response.text
-    
+
     # 6. Orchestrating the web search queries and updating the tool logs
-    grounding = getattr(response.candidates[0], "grounding_metadata", None) if response.candidates else None
-    search_queries = getattr(grounding, "web_search_queries", None) if grounding else None
-    for query in (search_queries or []):
+    grounding = (
+        getattr(response.candidates[0], "grounding_metadata", None)
+        if response.candidates
+        else None
+    )
+    search_queries = (
+        getattr(grounding, "web_search_queries", None) if grounding else None
+    )
+    for query in search_queries or []:
         state["tool_logs"].append(
             {
                 "id": str(uuid.uuid4()),
@@ -108,7 +114,7 @@ async def chat_node(state: AgentState, config: RunnableConfig):
 async def fe_actions_node(state: AgentState, config: RunnableConfig):
     if len(state["messages"]) >= 2 and state["messages"][-2].type == "tool":
         return Command(goto="end_node", update=state)
-        
+
     state["tool_logs"].append(
         {
             "id": str(uuid.uuid4()),

examples/canvas/gemini/agent/prompts.py

@@ -48,4 +48,4 @@
 """
 
 system_prompt_4 = """I understand. I will use the google_search tool when needed to provide current and accurate information.
-"""
+"""

examples/canvas/gemini/agent/stack_agent.py

@@ -31,8 +31,8 @@ class StackAgentState(CopilotKitState):
     tool_logs: List[Dict[str, Any]]
     analysis: Dict[str, Any]
     show_cards: bool
-    context : Dict[str, Any]
-    last_user_content : str
+    context: Dict[str, Any]
+    last_user_content: str
 
 
 # -------------------- Structured Output Schema --------------------
@@ -95,7 +95,6 @@ class StructuredStackAnalysis(BaseModel):
     risks_notes: List[RiskNoteSpec] = Field(default_factory=list)
 
 
-
 # Expose a tool to return the structured stack analysis to the caller
 @tool("return_stack_analysis", args_schema=StructuredStackAnalysis)
 def return_stack_analysis_tool(**kwargs) -> Dict[str, Any]:
@@ -282,19 +281,18 @@ async def gather_context_node(state: StackAgentState, config: RunnableConfig):
     # Parse the last user message for a GitHub URL; fall back when absent
     last_user_content = state["messages"][-1].content if state["messages"] else ""
     parsed = _parse_github_url(last_user_content)
-    
+
     if not parsed:
         return Command(
-            goto= "analyze",
-            update = {
+            goto="analyze",
+            update={
                 "analysis": state["analysis"],
                 "context": {},
                 "tool_logs": state["tool_logs"],
                 "show_cards": False,
-                "last_user_content": last_user_content
-            }
-        )        
- 
+                "last_user_content": last_user_content,
+            },
+        )
 
     # 2. Create a log entry for URL extraction
     state["tool_logs"] = state.get("tool_logs", [])
@@ -307,7 +305,6 @@ async def gather_context_node(state: StackAgentState, config: RunnableConfig):
     )
     await copilotkit_emit_state(config, state)
 
-
     owner, repo = parsed
     state["tool_logs"][-1]["status"] = "completed"
     await copilotkit_emit_state(config, state)
@@ -345,30 +342,30 @@ async def gather_context_node(state: StackAgentState, config: RunnableConfig):
     await copilotkit_emit_state(config, state)
 
     return Command(
-        goto= "analyze",
-        update = {
+        goto="analyze",
+        update={
             "analysis": state["analysis"],
             "context": context,
             "tool_logs": state["tool_logs"],
             "show_cards": False,
-            "last_user_content": last_user_content
-        }
+            "last_user_content": last_user_content,
+        },
     )
 
 
 async def analyze_with_gemini_node(state: StackAgentState, config: RunnableConfig):
     # 6. Short-circuit when no context exists and request a valid URL
-    
+
     context = state.get("context", {})
     if not context:
-        state["messages"].append(AIMessage(content= "Please provide a valid GitHub URL"))
+        state["messages"].append(AIMessage(content="Please provide a valid GitHub URL"))
         return Command(
-            goto= "end",
-            update = {
+            goto="end",
+            update={
                 "messages": state["messages"],
                 "show_cards": state["show_cards"],
-                "analysis": state["analysis"]
-            }
+                "analysis": state["analysis"],
+            },
         )
 
     # 7. Begin analysis and emit progress
@@ -413,8 +410,8 @@ async def analyze_with_gemini_node(state: StackAgentState, config: RunnableConfi
                 for call in tool_calls:
                     if call.get("name") == "return_stack_analysis":
                         args = call.get("args", {}) or {}
-                        state['analysis'] = json.dumps(args)
-                        state['show_cards'] = True
+                        state["analysis"] = json.dumps(args)
+                        state["show_cards"] = True
                         await copilotkit_emit_state(config, state)
                         try:
                             structured_payload = StructuredStackAnalysis(
@@ -448,31 +445,47 @@ async def analyze_with_gemini_node(state: StackAgentState, config: RunnableConfi
     await copilotkit_emit_state(config, state)
     messages[-1].content = state["last_user_content"]
     if tool_calls and tool_msg:
-        messages.append(AIMessage(tool_calls=tool_calls, id=tool_msg.id, type="ai", content=''))
-        messages.append(ToolMessage(content="The GitHub Repository has been analyzed", tool_call_id=tool_calls[0]["id"], type="tool"))
-    messages[0].content = "Generate a summary of the GitHub Repository. It should be in a concise and strictly textual"
-    
+        messages.append(
+            AIMessage(tool_calls=tool_calls, id=tool_msg.id, type="ai", content="")
+        )
+        messages.append(
+            ToolMessage(
+                content="The GitHub Repository has been analyzed",
+                tool_call_id=tool_calls[0]["id"],
+                type="tool",
+            )
+        )
+    messages[
+        0
+    ].content = "Generate a summary of the GitHub Repository. It should be in a concise and strictly textual"
+
     # 13. Generate a user-facing summary referencing the tool call outcome
     client = ChatGoogleGenerativeAI(
         model="gemini-2.5-pro",
         temperature=0.4,
         max_retries=2,
         google_api_key=os.getenv("GOOGLE_API_KEY"),
     )
-    state["tool_logs"].append({"id": str(uuid.uuid4()), "message": "Generating Summary", "status": "processing"})
+    state["tool_logs"].append(
+        {
+            "id": str(uuid.uuid4()),
+            "message": "Generating Summary",
+            "status": "processing",
+        }
+    )
     await copilotkit_emit_state(config, state)
     model_response = await client.ainvoke(messages, config)
     state["tool_logs"][-1]["status"] = "completed"
     await copilotkit_emit_state(config, state)
     state["messages"].append(AIMessage(content=model_response.content))
     # 14. Return a message containing the analysis
     return Command(
-        goto= "end",
-        update = {
+        goto="end",
+        update={
             "messages": state["messages"],
             "show_cards": True,
-            "analysis": state["analysis"]
-        }
+            "analysis": state["analysis"],
+        },
     )
 
 
@@ -482,12 +495,12 @@ async def end_node(state: StackAgentState, config: RunnableConfig):
     state["tool_logs"] = []
     await copilotkit_emit_state(config or RunnableConfig(recursion_limit=25), state)
     return Command(
-        goto= END,
-        update = {
+        goto=END,
+        update={
             "messages": state["messages"],
             "show_cards": state["show_cards"],
-            "analysis": state["analysis"]
-        }
+            "analysis": state["analysis"],
+        },
     )