feat: introduce internationalization for job status notifications and refactor job card styling for localization compatibility

Author: Rasic2

agents/matmaster_agent/callback.py

@@ -13,9 +13,10 @@
 
 from agents.matmaster_agent.base_agents.callback import _get_ak
 from agents.matmaster_agent.constant import FRONTEND_STATE_KEY
+from agents.matmaster_agent.locales import i18n
 from agents.matmaster_agent.model import UserContent
 from agents.matmaster_agent.prompt import get_user_content_lang
-from agents.matmaster_agent.style import JobCompleteCard
+from agents.matmaster_agent.style import get_job_complete_card
 from agents.matmaster_agent.utils.job_utils import get_job_status, has_job_running, get_running_jobs_detail
 
 logger = logging.getLogger(__name__)
@@ -75,10 +76,9 @@ async def matmaster_check_job_status(callback_context: CallbackContext, llm_resp
         running_job_ids = get_running_jobs_detail(jobs_dict)  # 从 state 里面拿
         access_key = _get_ak(callback_context)  # 从 state 或环境变量里面拿
         if callback_context.state['target_language'] in ['Chinese', 'zh-CN', '简体中文', 'Chinese (Simplified)']:
-            job_complete_intro = '检测到任务 <{job_id}> 已完成，我将立刻转移至对应的 Agent 去获取任务结果。'
+            i18n.language = "zh"
         else:
-            job_complete_intro = ('Job <{job_id}> has been detected as completed. '
-                                  'I will immediately transfer to the corresponding agent to retrieve the job results.')
+            i18n.language = "en"
 
         reset = False
         for origin_job_id, job_id, job_query_url, agent_name in running_job_ids:
@@ -101,7 +101,7 @@ async def matmaster_check_job_status(callback_context: CallbackContext, llm_resp
                     reset = True
                 function_call_id = f"call_{str(uuid.uuid4()).replace('-', '')[:24]}"
                 callback_context.state['origin_job_id'] = origin_job_id
-                llm_response.content.parts.append(Part(text=JobCompleteCard.format(job_id=job_id)))
+                llm_response.content.parts.append(Part(text=get_job_complete_card(i18n=i18n, job_id=job_id)))
                 llm_response.content.parts.append(Part(function_call=FunctionCall(id=function_call_id,
                                                                                   name='transfer_to_agent',
                                                                                   args={'agent_name': agent_name})))

agents/matmaster_agent/locales.py

@@ -0,0 +1,18 @@
+from toolsy.i8n import I18N
+
+translations = {
+    "en": {
+        "JobStatus": "Job Status",
+        "Job": "Job",
+        "JobCompleted": "Job Completed",
+        "ResultRetrieving": "Result Retrieving"
+    },
+    "zh": {
+        "JobStatus": "任务状态",
+        "Job": "任务",
+        "JobCompleted": "任务已完成",
+        "ResultRetrieving": "结果获取中"
+    }
+}
+
+i18n = I18N(translations=translations)

agents/matmaster_agent/style.py

@@ -1,4 +1,8 @@
-JobCompleteCard = """
+from toolsy.i8n import I18N
+
+
+def get_job_complete_card(i18n: I18N, job_id):
+    return f"""
 <div style="
     background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
     border-radius: 12px;
@@ -15,23 +19,24 @@
             backdrop-filter: blur(10px);
             font-size: 12px;
             font-weight: bold;
-        ">🚀 任务状态</div>
+        ">🚀 {i18n.t("JobStatus")}</div>
         <div style="
             background: rgba(255, 255, 255, 0.1);
             padding: 4px 10px;
             border-radius: 6px;
             font-family: monospace;
-        ">ID: {job_id}</div>
+            font-size: 12px;
+        ">{i18n.t("Job")}ID：{job_id}</div>
     </div>
     <div style="
         font-size: 16px;
         font-weight: 500;
         margin-top: 8px;
-    ">已完成 · 正在转移至 Agent</div>
+    ">✅ {i18n.t("JobCompleted")}</div>
     <div style="
-        font-size: 12px;
+        font-size: 14px;
         opacity: 0.9;
-        margin-top: 4px;
-    ">结果获取中...</div>
+        margin-top: 6px;
+    ">{i18n.t("ResultRetrieving")}...</div>
 </div>
-"""
+"""

pyproject.toml

@@ -16,6 +16,7 @@ dependencies = [
     "google-adk[a2a]==1.14.1",
     "pre-commit>=4.3.0",
     "bohrium-sdk>=0.14.0",
+    "toolsy>=0.1.2",
 ]
 
 [tool.setuptools]