xg-cli 1.0__py3-none-any.whl

xg/tui/i18n.py

@@ -0,0 +1,169 @@
+"""Small, dependency-free UI translations used by the Inspector."""
+
+from __future__ import annotations
+
+from typing import Literal
+
+
+UiLanguage = Literal["en", "zh"]
+SUPPORTED_UI_LANGUAGES: tuple[UiLanguage, ...] = ("en", "zh")
+
+
+def normalize_language(value: object) -> UiLanguage:
+    """Return a supported UI language, falling back to the default English."""
+    return "zh" if str(value).strip().lower() == "zh" else "en"
+
+
+INSPECTOR_TEXT: dict[str, dict[str, str]] = {
+    "en": {
+        "view.session": "Session",
+        "view.plan": "Plan",
+        "view.memory": "Memory",
+        "view.safety": "Safety",
+        "label.provider": "provider",
+        "label.model": "model",
+        "label.status": "status",
+        "label.estimated_input": "estimated input",
+        "label.model_window": "model window",
+        "label.window_usage": "window usage",
+        "label.input_budget": "input budget",
+        "label.budget_usage": "budget usage",
+        "label.source": "source",
+        "label.last_request": "last request",
+        "label.prompt": "prompt",
+        "label.completion": "completion",
+        "label.total": "total",
+        "label.session_usage": "session usage",
+        "label.compaction": "compaction",
+        "label.count": "count",
+        "label.last": "last",
+        "label.goal": "goal",
+        "label.current_round": "current round",
+        "label.progress": "progress",
+        "label.failures": "failures",
+        "label.project_root": "project root",
+        "label.warnings": "warnings",
+        "label.entries": "entries",
+        "label.last_operation": "last operation",
+        "label.store": "store",
+        "label.session_allow_all": "session allow all",
+        "label.tool": "tool",
+        "label.level": "level",
+        "label.decision": "decision",
+        "label.reason": "reason",
+        "label.last_rejection": "last rejection",
+        "section.context": "Context",
+        "section.last_request": "Last request",
+        "section.session_usage": "Session usage",
+        "section.compaction": "Compaction",
+        "section.tasks": "Tasks",
+        "section.project_memory": "Project memory",
+        "section.long_term_memory": "Long-term memory",
+        "section.current_approval": "Current approval",
+        "section.last_decision": "Last decision",
+        "section.policy": "Policy",
+        "empty.no_plan": "No plan",
+        "unit.token": "token",
+        "unit.tasks": "tasks",
+        "unit.round": "Round {current} / {total}",
+    },
+    "zh": {
+        "view.session": "Session",
+        "view.plan": "Plan",
+        "view.memory": "Memory",
+        "view.safety": "Safety",
+        "label.provider": "Provider",
+        "label.model": "Model",
+        "label.status": "Status",
+        "label.estimated_input": "预估输入",
+        "label.model_window": "上下文窗口",
+        "label.window_usage": "窗口使用率",
+        "label.input_budget": "输入预算",
+        "label.budget_usage": "预算使用率",
+        "label.source": "来源",
+        "label.last_request": "最近一次请求",
+        "label.prompt": "Prompt",
+        "label.completion": "Completion",
+        "label.total": "Total",
+        "label.session_usage": "Session 使用量",
+        "label.compaction": "Compaction",
+        "label.count": "次数",
+        "label.last": "最近一次",
+        "label.goal": "目标",
+        "label.current_round": "当前轮次",
+        "label.progress": "进度",
+        "label.failures": "失败次数",
+        "label.project_root": "项目根目录",
+        "label.warnings": "警告数",
+        "label.entries": "条目数",
+        "label.last_operation": "最近一次操作",
+        "label.store": "Store",
+        "label.session_allow_all": "Session 全部允许",
+        "label.tool": "Tool",
+        "label.level": "级别",
+        "label.decision": "Decision",
+        "label.reason": "原因",
+        "label.last_rejection": "最近一次拒绝",
+        "section.context": "Context",
+        "section.last_request": "最近一次请求",
+        "section.session_usage": "Session 使用量",
+        "section.compaction": "Compaction",
+        "section.tasks": "Tasks",
+        "section.project_memory": "项目 Memory",
+        "section.long_term_memory": "长期 Memory",
+        "section.current_approval": "当前 approval",
+        "section.last_decision": "最近一次决策",
+        "section.policy": "Policy",
+        "empty.no_plan": "暂无 Plan",
+        "unit.token": "token",
+        "unit.tasks": "个 Task",
+        "unit.round": "第 {current} / {total} 轮",
+    },
+}
+
+
+STATUS_ZH: dict[str, str] = {
+    "idle": "空闲 (Idle)",
+    "running": "执行中 (Running)",
+    "working": "工作中 (Working)",
+    "waiting": "等待中 (waiting)",
+    "waiting approval": "等待审批 (Waiting approval)",
+    "review": "审阅中 (review)",
+    "plan review": "等待 Plan 审阅 (Plan review)",
+    "done": "已完成 (Done)",
+    "success": "成功 (success)",
+    "approved": "已批准 (approved)",
+    "active": "生效中 (active)",
+    "on": "开启 (on)",
+    "off": "关闭 (off)",
+    "yes": "是 (yes)",
+    "no": "否 (no)",
+    "loaded": "已加载 (loaded)",
+    "available": "可用 (available)",
+    "failed": "失败 (failed)",
+    "error": "错误 (Error)",
+    "rejected": "已拒绝 (rejected)",
+    "denied": "已拒绝 (denied)",
+    "cancelled": "已取消 (cancelled)",
+    "inactive": "未生效 (inactive)",
+    "unavailable": "不可用 (unavailable)",
+    "not found": "未找到 (not found)",
+    "blocked": "已阻塞 (blocked)",
+    "skipped": "已跳过 (skipped)",
+}
+
+
+def translate(language: UiLanguage, key: str, **values: object) -> str:
+    """Translate a fixed UI key and format only its explicit placeholders."""
+    lang = normalize_language(language)
+    value = INSPECTOR_TEXT.get(lang, {}).get(key)
+    if value is None:
+        value = INSPECTOR_TEXT["en"].get(key, key)
+    return value.format(**values) if values else value
+
+
+def translate_status(language: UiLanguage, status: str) -> str:
+    """Translate a canonical status while retaining its English meaning."""
+    if normalize_language(language) == "en":
+        return status
+    return STATUS_ZH.get(status.lower(), status)

xg/tui/messages.py

@@ -0,0 +1,45 @@
+"""Small Textual messages used to bridge controller callbacks to widgets."""
+
+from __future__ import annotations
+
+from textual.message import Message
+
+from xg.tui.state import InspectorView, TuiState
+
+
+class StateChanged(Message):
+    def __init__(self, state: TuiState) -> None:
+        super().__init__()
+        self.state = state
+
+
+class TraceCardToggled(Message):
+    """A user clicked or activated one collapsible execution card."""
+
+    def __init__(self, item_id: str) -> None:
+        super().__init__()
+        self.item_id = item_id
+
+
+class AgentGroupToggled(Message):
+    """A user expanded or collapsed one Team Agent conversation group."""
+
+    def __init__(self, group_id: str) -> None:
+        super().__init__()
+        self.group_id = group_id
+
+
+class CommandSuggestionSelected(Message):
+    """A local command suggestion was selected without being submitted."""
+
+    def __init__(self, candidate) -> None:
+        super().__init__()
+        self.candidate = candidate
+
+
+class InspectorViewSelected(Message):
+    """A user selected one of the Inspector's stable view tabs."""
+
+    def __init__(self, view: InspectorView) -> None:
+        super().__init__()
+        self.view = view

xg/tui/plan_renderables.py

@@ -0,0 +1,147 @@
+"""Plan review flowchart renderables for the Textual transcript."""
+
+from __future__ import annotations
+
+from dataclasses import dataclass
+
+from rich.console import Console, ConsoleOptions, Group, RenderResult
+from rich.panel import Panel
+from rich.text import Text
+
+from xg.agent.plan import Plan, PlanTask
+from xg.agent.team import TeamPlan
+from xg.tui.diagrams.model import FlowchartEdge, FlowchartModel, FlowchartNode
+from xg.tui.diagrams.renderer import render_flowchart
+from xg.tui.state import TranscriptItem
+
+
+@dataclass(frozen=True)
+class PlanFlowchartData:
+    model: FlowchartModel
+    rank_by_node: dict[str, int]
+    ordered_ids: tuple[str, ...]
+
+
+def plan_to_flowchart(plan: Plan | TeamPlan) -> PlanFlowchartData:
+    """Adapt an already validated Plan DAG to the text flowchart model."""
+    tasks = {task.id: task for task in plan.tasks}
+    ordered_ids: list[str] = []
+    rank_by_node: dict[str, int] = {}
+    for batch_no, batch in enumerate(plan.batches):
+        for task_id in batch:
+            if task_id in tasks and task_id not in ordered_ids:
+                ordered_ids.append(task_id)
+                rank_by_node[task_id] = batch_no
+    # Defensive fallback for a manually-created Plan whose batches are stale.
+    for task in plan.tasks:
+        if task.id not in ordered_ids:
+            ordered_ids.append(task.id)
+            rank_by_node[task.id] = len(plan.batches)
+
+    nodes = [
+        FlowchartNode(id=task_id, label=f"{task_id} {tasks[task_id].title}")
+        for task_id in ordered_ids
+    ]
+    known = set(tasks)
+    edges = [
+        FlowchartEdge(source=dependency, target=task.id)
+        for task in plan.tasks
+        for dependency in task.deps
+        if dependency in known and task.id in known
+    ]
+    warnings = []
+    missing = [
+        f"{task.id} 依赖不存在的任务 {dependency}"
+        for task in plan.tasks
+        for dependency in task.deps
+        if dependency not in known
+    ]
+    warnings.extend(missing)
+    return PlanFlowchartData(
+        model=FlowchartModel(direction="TD", nodes=nodes, edges=edges, warnings=warnings),
+        rank_by_node=rank_by_node,
+        ordered_ids=tuple(ordered_ids),
+    )
+
+
+def _task_title_text(task: PlanTask) -> Text:
+    """Render a task title with a consistent visual hierarchy."""
+    line = Text(style="bold")
+    line.append(task.id, style="cyan bold")
+    line.append(f" {task.title}", style="bold")
+    return line
+
+
+def _task_summary_renderable(plan: Plan | TeamPlan, ordered_ids: tuple[str, ...], detailed: bool) -> Group:
+    """Render the task heading, keyboard hint, and task content separately."""
+    tasks = {task.id: task for task in plan.tasks}
+    renderables: list[object] = [
+        Text("任务详情" if detailed else "任务概括"),
+        Text("按 d 收起详情" if detailed else "按 d 显示详情", style="dim"),
+    ]
+    for task_id in ordered_ids:
+        task = tasks.get(task_id)
+        if task is None:
+            continue
+        renderables.append(_task_title_text(task))
+        if detailed:
+            deps = ", ".join(task.deps) if task.deps else "无"
+            renderables.extend([
+                Text(f"  描述：{task.description or '暂无描述'}", style="dim"),
+                Text(f"  依赖：{deps}", style="dim"),
+            ])
+            tools = getattr(task, "allowed_tools", ())
+            if tools:
+                renderables.append(Text(f"  工具：{', '.join(tools)}", style="dim"))
+            for warning in getattr(task, "tool_warnings", ()):
+                renderables.append(Text(f"  工具提示：{warning}", style="yellow"))
+            mode = getattr(task, "resource_scope_mode", "")
+            if mode:
+                renderables.append(Text(f"  资源模式：{mode}", style="dim"))
+            for claim in getattr(task, "resource_claims", ()):
+                renderables.append(
+                    Text(f"  资源声明：{claim.access} {claim.pattern}", style="dim")
+                )
+    return Group(*renderables)
+
+
+class PlanReviewCard:
+    """Static review card: flowchart plus summary/details below it."""
+
+    def __init__(self, item: TranscriptItem) -> None:
+        self.item = item
+
+    def __rich_console__(self, console: Console, options: ConsoleOptions) -> RenderResult:
+        plan = self.item.plan
+        # /plan uses Plan while /team uses TeamPlan. Both expose the same
+        # validated task/batch shape needed by this read-only renderer.
+        if not isinstance(plan, (Plan, TeamPlan)):
+            yield Panel(Text(self.item.text or "计划不可用"), title="计划审阅", border_style="magenta")
+            return
+        data = plan_to_flowchart(plan)
+        chart = render_flowchart(
+            data.model,
+            width=max(1, options.max_width - 8),
+            rank_by_node=data.rank_by_node,
+        )
+        parts: list[object] = [
+            Text(f"目标：{plan.goal}\n共 {len(plan.batches)} 轮", style="bold"),
+        ]
+        # Skip the flow-chart panel entirely when rendering falls back to
+        # structured text: the panel would just repeat the task IDs already
+        # listed below, and the warning inside a cyan border looks noisy.
+        if chart.mode != "structured":
+            chart_parts: list[object] = [Text(chart.text, no_wrap=True, overflow="crop")]
+            if chart.warnings:
+                chart_parts.append(Text("\n\n⚠ " + "；".join(chart.warnings)))
+            parts.append(Panel(Group(*chart_parts), title="轮次流程", border_style="cyan"))
+        elif chart.warnings:
+            parts.append(Text("⚠ " + "；".join(chart.warnings), style="dim"))
+        batch_lines = [
+            f"第 {batch_no} 轮：{', '.join(batch)}"
+            for batch_no, batch in enumerate(plan.batches, 1)
+        ]
+        parts.append(Text("\n".join(batch_lines), style="dim"))
+        parts.append(_task_summary_renderable(plan, data.ordered_ids, not self.item.collapsed))
+        parts.append(Text("\nEnter 执行 · r 重规划 · Esc 取消", style="dim"))
+        yield Panel(Group(*parts), title="计划审阅", border_style="magenta")