@limecloud/agent-runtime-ui

@limecloud/agent-runtime-ui 是 Lime 当前 React AgentUI surface seed。它只消费 AgentUiProjectionState 和 callbacks，不拥有 runtime transport、不订阅 Provider、不维护 runtime truth。

实现锚点：packages/agent-runtime-ui/。

安装

npm install @limecloud/agent-runtime-ui react react-dom

导出面

export {
  AgentUiProjectionView,
  UIMessagePartsView,
  ProcessTimelineView,
  ExecutionGraphView,
  ArtifactRefList,
  EvidenceRefList,
  TeamWorkbenchView,
  TeamRosterView,
  WorkBoardView,
  HandoffLaneView,
  RuntimeFactsPanel,
  RuntimeFactsSummary,
  ToolGroup,
  ActionRequiredList
} from "@limecloud/agent-runtime-ui";

Surface Map

Surface	Input	Purpose
AgentUiProjectionView	AgentUiProjectionState	标准组合视图。
UIMessagePartsView	UIMessagePart[]	消息、reasoning、tool preview、artifact/evidence 引用。
ProcessTimelineView	ProcessTimelineEntry[]	过程时间线。
ExecutionGraphView	ExecutionGraphNode[]	task / subagent / tool / action 图。
TeamWorkbenchView	AgentUiProjectionState	团队成员、工作板、移交 / review lane。
TeamRosterView	ExecutionGraphNode[]	subagent / worker 成员视图。
WorkBoardView	ExecutionGraphNode[]	task / job / run / attempt 工作项。
HandoffLaneView	projected handoff / review events	移交、协作和评审事实。
ArtifactRefList	AgentUiArtifactRefView[]	artifact 引用列表，只输出打开意图。
EvidenceRefList	AgentUiEvidenceRefView[]	evidence 引用列表，只输出打开意图。
ActionRequiredList	projected action events	人类介入。
ToolGroup	projected tool events	工具调用摘要。
RuntimeFactsPanel	AgentRuntimeReadModel	read model facts 面板。

这些 React surface 的标准输入分别来自 UIMessageParts、ProcessTimeline、ExecutionGraph、ActionRequired、ArtifactRef、EvidenceRef、TeamWorkbench。组件可以通过 labels 和 callbacks 注入产品行为，但不能把本地状态写回 runtime facts。

Example

import { AgentUiProjectionView } from "@limecloud/agent-runtime-ui";

export function AgentPanel({ state, onResolveAction }) {
  return (
    <AgentUiProjectionView
      state={state}
      onResolveAction={onResolveAction}
      labels={{
        messagePartsAriaLabel: "消息",
        processTimelineAriaLabel: "过程",
        executionGraphAriaLabel: "执行图",
        teamWorkbenchAriaLabel: "团队工作台"
      }}
    />
  );
}

Boundary

允许	禁止
渲染 projection state。	调用 App Server JSON-RPC。
通过 callback 上报用户动作。	本地标记 action resolved。
注入 labels / formatting callbacks。	硬编码产品五语言文案。
展示 refs。	复制 artifact / evidence 大 payload。
缺少 subagent facts 时不渲染 Team Workbench。	伪造 teammate、handoff 或 review。

关键参考页

• Provider Boundary
• Callbacks
• Artifact And Evidence Refs

验证

npm --prefix packages/agent-runtime-ui run test

如果 surface 改动影响产品 GUI，再补产品侧 UI 回归和 GUI smoke。