feat(remote-control): 优化 Web 展示、状态同步与桥接控制流程 (#288)

Co-authored-by: chengzifeng <chengzifeng@meituan.com>

packages/remote-control-server/src/services/automationState.ts

@@ -0,0 +1,64 @@
+import type { AutomationStateResponse } from "../types/api";
+
+const DISABLED_AUTOMATION_STATE: AutomationStateResponse = Object.freeze({
+  enabled: false,
+  phase: null,
+  next_tick_at: null,
+  sleep_until: null,
+});
+
+function cloneAutomationState(state: AutomationStateResponse): AutomationStateResponse {
+  return { ...state };
+}
+
+function normalizeAutomationState(raw: unknown): AutomationStateResponse {
+  if (!raw || typeof raw !== "object") {
+    return cloneAutomationState(DISABLED_AUTOMATION_STATE);
+  }
+
+  const state = raw as Record<string, unknown>;
+  return {
+    enabled: state.enabled === true,
+    phase: state.phase === "standby" || state.phase === "sleeping" ? state.phase : null,
+    next_tick_at: typeof state.next_tick_at === "number" ? state.next_tick_at : null,
+    sleep_until: typeof state.sleep_until === "number" ? state.sleep_until : null,
+  };
+}
+
+function readAutomationStateValue(metadata: Record<string, unknown> | null | undefined): unknown {
+  if (!metadata || typeof metadata !== "object") {
+    return undefined;
+  }
+  if (!Object.prototype.hasOwnProperty.call(metadata, "automation_state")) {
+    return undefined;
+  }
+  return metadata.automation_state;
+}
+
+export function getAutomationStateSnapshot(
+  metadata: Record<string, unknown> | null | undefined,
+): AutomationStateResponse | undefined {
+  const raw = readAutomationStateValue(metadata);
+  if (raw === undefined) {
+    return undefined;
+  }
+  return normalizeAutomationState(raw);
+}
+
+export function getAutomationStateEventPayload(
+  metadata: Record<string, unknown> | null | undefined,
+): AutomationStateResponse {
+  return getAutomationStateSnapshot(metadata) ?? cloneAutomationState(DISABLED_AUTOMATION_STATE);
+}
+
+export function automationStatesEqual(
+  a: AutomationStateResponse,
+  b: AutomationStateResponse,
+): boolean {
+  return (
+    a.enabled === b.enabled &&
+    a.phase === b.phase &&
+    a.next_tick_at === b.next_tick_at &&
+    a.sleep_until === b.sleep_until
+  );
+}

packages/remote-control-server/src/services/transport.ts

@@ -52,6 +52,9 @@ export function normalizePayload(type: string, payload: unknown): Record<string,
   };
 
   if (typeof p.uuid === "string" && p.uuid) normalized.uuid = p.uuid;
+  if (typeof p.isSynthetic === "boolean") normalized.isSynthetic = p.isSynthetic;
+  if (typeof p.status === "string") normalized.status = p.status;
+  if (typeof p.subtype === "string") normalized.subtype = p.subtype;
 
   // Preserve tool fields
   if (p.tool_name) normalized.tool_name = p.tool_name;
@@ -68,6 +71,12 @@ export function normalizePayload(type: string, payload: unknown): Record<string,
   // Preserve message field for backward compat
   if (p.message) normalized.message = p.message;
 
+  if (type === "task_state") {
+    if (typeof p.task_list_id === "string") normalized.task_list_id = p.task_list_id;
+    if (typeof p.taskListId === "string") normalized.taskListId = p.taskListId;
+    if (Array.isArray(p.tasks)) normalized.tasks = p.tasks;
+  }
+
   return normalized;
 }