@zhin.js/client 2.1.9 → 2.1.11

package/client/websocket/manager.ts

@@ -2,11 +2,32 @@ import { ConnectionState, WebSocketError, ConnectionError, MessageError, Request
 
 import { getApiBase, getStoredToken, resolveApiUrl } from "./remote-settings.js";
 import { applyConsoleEvent } from "../persistence/idb-store.js";
+import { fetchConsoleEventHistory } from '../console-events.js';
 import {
+  CONSOLE_EVENT_RECOVERY_GAP_EVENT,
   SIDE_EVENT_PUSH,
   normalizeConsolePushMessage,
+  parseConsoleSseFrame,
+  type ConsoleEventData,
+  type ConsoleEventEnvelope,
+  type ConsoleEventHistoryPage,
+  type ConsoleEventHistoryQuery,
 } from "@zhin.js/console-protocol";
 
+interface ConsoleEventCursor {
+  readonly runtimeId: string;
+  readonly eventId: number;
+}
+
+export type ConsoleEventListener<Type extends string> = (
+  event: ConsoleEventEnvelope<Type, ConsoleEventData<Type>>,
+) => void;
+export interface ConsoleEventRecoveryGap {
+  readonly query: ConsoleEventHistoryQuery;
+  readonly page: ConsoleEventHistoryPage;
+}
+export type ConsoleEventRecoveryGapListener = (gap: ConsoleEventRecoveryGap) => void;
+
 export class WebSocketManager {
   private ws: WebSocket | null = null;
   private config: Required<WebSocketConfig>;
@@ -20,7 +41,12 @@ export class WebSocketManager {
     { resolve: (value: unknown) => void; reject: (error: Error) => void; timer: ReturnType<typeof setTimeout> }
   >();
   private connectedListeners = new Set<(connected: boolean) => void>();
+  private eventListeners = new Map<string, Set<ConsoleEventListener<string>>>();
+  private recoveryGapListeners = new Set<ConsoleEventRecoveryGapListener>();
   private sseAbort: AbortController | null = null;
+  private eventRuntimeId = '';
+  private lastEventId = 0;
+  private durableCursorBlocked = false;
   private useRestTransport = true;
 
   constructor(config: WebSocketConfig = {}, callbacks: WebSocketCallbacks = {}) {
@@ -38,6 +64,27 @@ export class WebSocketManager {
     return () => this.connectedListeners.delete(listener);
   }
 
+  /** Subscribe by event name; known names infer their exact payload type. */
+  onConsoleEvent<Type extends string>(type: Type, listener: ConsoleEventListener<Type>): () => void {
+    let listeners = this.eventListeners.get(type);
+    if (!listeners) {
+      listeners = new Set();
+      this.eventListeners.set(type, listeners);
+    }
+    const stored = listener as ConsoleEventListener<string>;
+    listeners.add(stored);
+    return () => {
+      listeners?.delete(stored);
+      if (listeners?.size === 0) this.eventListeners.delete(type);
+    };
+  }
+
+  /** Observe a non-resumable cursor so domain views can perform a full resync. */
+  onConsoleEventRecoveryGap(listener: ConsoleEventRecoveryGapListener): () => void {
+    this.recoveryGapListeners.add(listener);
+    return () => this.recoveryGapListeners.delete(listener);
+  }
+
   private notifyConnection(connected: boolean) {
     for (const l of this.connectedListeners) l(connected);
   }
@@ -73,7 +120,12 @@ export class WebSocketManager {
         Accept: "text/event-stream",
       };
       if (token) headers.Authorization = `Bearer ${token}`;
-      const res = await fetch(resolveApiUrl("/api/events"), {
+      await this.recoverEventHistory(this.sseAbort.signal);
+      const params = new URLSearchParams();
+      if (this.eventRuntimeId) params.set('runtimeId', this.eventRuntimeId);
+      if (this.lastEventId > 0) params.set('after', String(this.lastEventId));
+      const suffix = params.size ? `?${params}` : '';
+      const res = await fetch(resolveApiUrl(`/api/events${suffix}`), {
         headers,
         signal: this.sseAbort.signal,
       });
@@ -107,22 +159,21 @@ export class WebSocketManager {
         const { done, value } = await reader.read();
         if (done) break;
         buffer += decoder.decode(value, { stream: true });
-        const parts = buffer.split("\n\n");
+        const parts = buffer.split(/\r?\n\r?\n/u);
         buffer = parts.pop() ?? "";
         for (const part of parts) {
-          const line = part.split("\n").find((l) => l.startsWith("data: "));
-          if (!line) continue;
-          const json = line.slice(6);
-          try {
-            const message = normalizeConsolePushMessage(
-              JSON.parse(json) as WebSocketMessage,
-            ) as WebSocketMessage;
-            void applyConsoleEvent(message);
-            this.handleBroadcast(message);
-            this.callbacks.onMessage?.(message);
-          } catch {
-            /* skip */
-          }
+          const parsed = parseConsoleSseFrame(part);
+          if (!parsed) continue;
+          const runtimeId = parsed.runtimeId ?? this.eventRuntimeId;
+          const event: ConsoleEventEnvelope = Object.freeze({
+            runtimeId,
+            eventId: parsed.eventId ?? 0,
+            type: parsed.type,
+            data: parsed.data,
+            timestamp: parsed.timestamp ?? Date.now(),
+            delivery: 'live',
+          });
+          await this.deliverConsoleEvent(event);
         }
       }
     } catch {
@@ -136,6 +187,99 @@ export class WebSocketManager {
     }
   }
 
+  private async recoverEventHistory(signal: AbortSignal): Promise<void> {
+    const stored = this.eventRuntimeId
+      ? { runtimeId: this.eventRuntimeId, eventId: this.lastEventId }
+      : readEventCursor();
+    let runtimeId = stored?.runtimeId;
+    let after = stored?.eventId ?? 0;
+    if (runtimeId) {
+      this.eventRuntimeId = runtimeId;
+      this.lastEventId = after;
+    }
+    for (;;) {
+      const query = { runtimeId, after, limit: 500 } satisfies ConsoleEventHistoryQuery;
+      const page = await fetchConsoleEventHistory(query, { signal });
+      if (page.runtimeId !== runtimeId) {
+        runtimeId = page.runtimeId;
+        after = 0;
+        this.lastEventId = 0;
+        this.durableCursorBlocked = false;
+      }
+      this.eventRuntimeId = page.runtimeId;
+      if (page.gap) this.notifyRecoveryGap({ query, page });
+      for (const item of page.items) {
+        await this.deliverConsoleEvent(Object.freeze({ ...item, delivery: 'history' }));
+        after = item.eventId;
+      }
+      if (!page.hasMore) {
+        this.lastEventId = Math.max(after, page.latestEventId);
+        if (!this.durableCursorBlocked) {
+          writeEventCursor({ runtimeId: page.runtimeId, eventId: this.lastEventId });
+        }
+        return;
+      }
+      after = page.nextAfter;
+    }
+  }
+
+  private async deliverConsoleEvent(event: ConsoleEventEnvelope): Promise<void> {
+    if (event.runtimeId && event.runtimeId !== this.eventRuntimeId) {
+      this.eventRuntimeId = event.runtimeId;
+      this.lastEventId = 0;
+      this.durableCursorBlocked = false;
+    }
+    if (event.eventId > 0
+      && event.runtimeId === this.eventRuntimeId
+      && event.eventId <= this.lastEventId) return;
+    const message = normalizeConsolePushMessage({
+      type: event.type,
+      data: event.data,
+      runtimeId: event.runtimeId,
+      eventId: event.eventId || undefined,
+      timestamp: event.timestamp,
+      delivery: event.delivery,
+    }) as WebSocketMessage;
+    try {
+      await applyConsoleEvent(message);
+    } catch (error) {
+      this.durableCursorBlocked = true;
+      console.error('[Console transport] Failed to persist event:', error);
+    }
+    this.handleBroadcast(message);
+    try {
+      this.callbacks.onMessage?.(message);
+    } catch (error) {
+      console.error('[Console transport] onMessage listener failed:', error);
+    }
+    for (const listener of this.eventListeners.get(event.type) ?? []) {
+      try {
+        listener(event as ConsoleEventEnvelope<string, unknown>);
+      } catch (error) {
+        console.error('[Console transport] event listener failed:', error);
+      }
+    }
+    if (event.eventId > 0 && event.runtimeId) {
+      this.lastEventId = Math.max(this.lastEventId, event.eventId);
+      if (!this.durableCursorBlocked) {
+        writeEventCursor({ runtimeId: event.runtimeId, eventId: this.lastEventId });
+      }
+    }
+  }
+
+  private notifyRecoveryGap(gap: ConsoleEventRecoveryGap): void {
+    if (typeof window !== 'undefined') {
+      window.dispatchEvent(new CustomEvent(CONSOLE_EVENT_RECOVERY_GAP_EVENT, { detail: gap }));
+    }
+    for (const listener of this.recoveryGapListeners) {
+      try {
+        listener(gap);
+      } catch (error) {
+        console.error('[Console transport] recovery gap listener failed:', error);
+      }
+    }
+  }
+
   disconnect(): void {
     this.clearReconnectTimer();
     this.clearPendingRequests();
@@ -362,12 +506,12 @@ export class WebSocketManager {
       }
       return;
     }
-    if (t === "hmr:reload") {
+    if (t === "hmr:reload" && message.delivery !== 'history') {
       console.info(`[HMR] File changed, reloading...`);
       window.location.reload();
       return;
     }
-    if (t === "system:restarting") {
+    if (t === "system:restarting" && message.delivery !== 'history') {
       console.info("[System] Server restarting, will reload shortly...");
       setTimeout(() => window.location.reload(), 3000);
       return;
@@ -443,3 +587,31 @@ export class WebSocketManager {
     this.pendingRequests.clear();
   }
 }
+
+function eventCursorStorageKey(): string {
+  return `zhin.console.event-cursor:${getApiBase()}`;
+}
+
+function readEventCursor(): ConsoleEventCursor | null {
+  if (typeof localStorage === 'undefined') return null;
+  try {
+    const parsed = JSON.parse(localStorage.getItem(eventCursorStorageKey()) ?? 'null') as Partial<ConsoleEventCursor> | null;
+    return parsed
+      && typeof parsed.runtimeId === 'string'
+      && Number.isSafeInteger(parsed.eventId)
+      && (parsed.eventId ?? -1) >= 0
+      ? { runtimeId: parsed.runtimeId, eventId: parsed.eventId as number }
+      : null;
+  } catch {
+    return null;
+  }
+}
+
+function writeEventCursor(cursor: ConsoleEventCursor): void {
+  if (typeof localStorage === 'undefined') return;
+  try {
+    localStorage.setItem(eventCursorStorageKey(), JSON.stringify(cursor));
+  } catch {
+    // HTTP history remains available when browser storage is unavailable.
+  }
+}

package/client/websocket/types.ts

@@ -1,6 +1,11 @@
+import type { ConsoleEventDelivery } from '@zhin.js/console-protocol';
+
 export interface BaseMessage {
   type: string;
   timestamp?: number;
+  runtimeId?: string;
+  eventId?: number;
+  delivery?: ConsoleEventDelivery;
   requestId?: number;
   error?: string;
 }

package/client/workroom/WorkroomRunsPage.tsx

@@ -0,0 +1,248 @@
+import { useCallback, useState } from 'react';
+import { apiFetch } from '../console-utils/remoteApi.js';
+
+type WorkroomTask = {
+  key: string;
+  title: string;
+  status: string;
+  revision: number;
+  attempt: number;
+  maxAttempts: number;
+  reportRef?: string;
+  terminalReason?: string;
+  currentAssignmentId?: string;
+  blockers?: Array<{ id: string; kind: string; owner: string; reason: string; deadline: number }>;
+  latestProgress?: { summary: string; completedUnits?: number; totalUnits?: number };
+};
+
+type WorkroomAssignment = {
+  id: string;
+  taskKey: string;
+  role: string;
+  status: string;
+  owner: string;
+  attempt: number;
+  leaseExpiresAt: number;
+  latestProgress?: { summary: string; completedUnits?: number; totalUnits?: number };
+  outcome?: string;
+};
+
+type WorkroomWait = {
+  id: string;
+  taskKey: string;
+  status: string;
+  owner: string;
+  route: string;
+  riskTier: string;
+  deadline: number;
+};
+
+type RunListItem = {
+  runId: string;
+  projectId: string;
+  status: string;
+  title: string;
+  sequence: number;
+  now: number;
+  cancelRequested: boolean;
+  tasks: Record<string, WorkroomTask>;
+  assignments: Record<string, WorkroomAssignment>;
+  reviewerAssignments: Record<string, WorkroomWait>;
+  sponsorGates: Record<string, WorkroomWait>;
+};
+
+type RunDetail = RunListItem;
+
+export default function WorkroomRunsPage() {
+  const [projectId, setProjectId] = useState('');
+  const [runs, setRuns] = useState<RunListItem[]>([]);
+  const [selected, setSelected] = useState<RunDetail | null>(null);
+  const [loading, setLoading] = useState(false);
+  const [error, setError] = useState('');
+  const [detailView, setDetailView] = useState<'tasks' | 'assignments' | 'acceptance'>('tasks');
+
+  const loadRuns = useCallback(async () => {
+    if (!projectId.trim()) {
+      setError('请输入 projectId');
+      return;
+    }
+    setLoading(true);
+    setError('');
+    setSelected(null);
+    try {
+      const res = await apiFetch(
+        `/api/agent/workroom/runs?projectId=${encodeURIComponent(projectId.trim())}`,
+      );
+      const body = await res.json() as { success?: boolean; error?: string; data?: { runs?: RunListItem[] } };
+      if (!res.ok || !body.success) {
+        throw new Error(body.error ?? `HTTP ${res.status}`);
+      }
+      setRuns(body.data?.runs ?? []);
+    } catch (err) {
+      setError(err instanceof Error ? err.message : String(err));
+      setRuns([]);
+    } finally {
+      setLoading(false);
+    }
+  }, [projectId]);
+
+  const loadRunDetail = useCallback(async (runId: string, runProjectId: string) => {
+    setLoading(true);
+    setError('');
+    try {
+      const res = await apiFetch(`/api/agent/workroom/runs/${encodeURIComponent(runId)}?projectId=${encodeURIComponent(runProjectId)}`);
+      const body = await res.json() as { success?: boolean; error?: string; data?: RunDetail };
+      if (!res.ok || !body.success || !body.data) {
+        throw new Error(body.error ?? `HTTP ${res.status}`);
+      }
+      setSelected(body.data);
+    } catch (err) {
+      setError(err instanceof Error ? err.message : String(err));
+    } finally {
+      setLoading(false);
+    }
+  }, []);
+
+  return (
+    <div className="p-4 md:p-6 space-y-5 max-w-7xl mx-auto">
+      <header className="flex flex-wrap items-end justify-between gap-3 border-b pb-4">
+        <div>
+          <span className="text-[11px] font-semibold uppercase tracking-[0.14em] text-muted-foreground">Project control plane</span>
+          <h1 className="mt-1 text-xl font-semibold tracking-tight">Workroom 控制台</h1>
+          <p className="mt-1 max-w-3xl text-sm text-muted-foreground">查看 Journal + CAS Kernel 投影出的 Run、Task、Assignment 与验收门；普通聊天不会隐式创建 Workroom。</p>
+        </div>
+        <span className="rounded-full border px-2.5 py-1 text-xs text-muted-foreground">只读事实投影</span>
+      </header>
+
+      <details className="rounded-xl border bg-muted/20 open:bg-muted/10">
+        <summary className="cursor-pointer list-none px-4 py-3 text-sm font-medium">运行与持久化配置 <span className="ml-2 text-xs font-normal text-muted-foreground">ai.sessions.useDatabase · 修改后需重启</span></summary>
+        <div className="grid gap-4 border-t px-4 py-4 md:grid-cols-[1fr_1fr]">
+          <div className="space-y-2 text-sm">
+            <p className="font-medium">数据库 Journal（默认）</p>
+            <p className="text-muted-foreground">`ai.sessions.useDatabase` 不为 false 时写入 `workroom_events`；Database Root Host 未就绪会阻止 candidate generation 发布。</p>
+            <pre className="overflow-auto rounded-lg border bg-background p-3 text-xs">{'ai:\n  sessions:\n    useDatabase: true'}</pre>
+          </div>
+          <div className="space-y-2 text-sm">
+            <p className="font-medium">原子文件 Journal</p>
+            <p className="text-muted-foreground">显式设为 false 后使用 `.zhin/workroom-journal`。后端在进程启动时固定，热重载不会切换事实源。</p>
+            <pre className="overflow-auto rounded-lg border bg-background p-3 text-xs">{'ai:\n  sessions:\n    useDatabase: false'}</pre>
+          </div>
+        </div>
+        <div className="flex items-center justify-between gap-3 border-t px-4 py-3 text-xs text-muted-foreground"><span>配置项属于 Agent session storage；切换 Journal 后端必须重启 Host，不能只做热重载。</span><a className="rounded-md border bg-background px-2.5 py-1.5 font-medium text-foreground hover:bg-muted" href="/config">打开配置编辑器</a></div>
+      </details>
+
+      <div className="flex flex-wrap gap-2 items-end">
+        <label className="flex flex-col gap-1 text-sm flex-1 min-w-[240px]">
+          projectId
+          <input
+            className="border rounded px-2 py-1 text-sm bg-background"
+            value={projectId}
+            onChange={(e) => setProjectId(e.target.value)}
+            placeholder="project-alpha"
+          />
+        </label>
+        <button
+          type="button"
+          className="border rounded px-3 py-1 text-sm hover:bg-muted"
+          disabled={loading}
+          onClick={() => void loadRuns()}
+        >
+          查询 Runs
+        </button>
+      </div>
+
+      {error ? <p className="text-sm text-red-600">{error}</p> : null}
+
+      <div className="grid gap-4 lg:grid-cols-[minmax(16rem,0.75fr)_minmax(0,1.5fr)]">
+        <section className="rounded-xl border p-3 space-y-2">
+          <h2 className="text-sm font-medium">Runs ({runs.length})</h2>
+          {runs.length === 0 ? (
+            <p className="text-sm text-muted-foreground">无数据</p>
+          ) : (
+            <ul className="space-y-2 text-sm">
+              {runs.map((item) => (
+                <li key={item.runId} className={`rounded-lg border p-2 transition-colors ${selected?.runId === item.runId ? 'border-primary/40 bg-primary/5' : 'hover:bg-muted/30'}`}>
+                  <button
+                    type="button"
+                    className="text-left w-full"
+                    onClick={() => void loadRunDetail(item.runId, item.projectId)}
+                  >
+                    <div className="font-mono text-xs">{item.runId}</div>
+                    <div className="mt-1 font-medium">{item.title || '(无标题)'}</div>
+                    <div className="text-muted-foreground">
+                      {item.status}
+                      {' · '}
+                      {Object.keys(item.tasks).length}
+                      {' tasks'}
+                    </div>
+                  </button>
+                </li>
+              ))}
+            </ul>
+          )}
+        </section>
+
+        <section className="rounded-xl border p-3 space-y-3">
+          <h2 className="text-sm font-medium">Run 详情</h2>
+          {!selected ? (
+            <p className="text-sm text-muted-foreground">选择左侧 Run</p>
+          ) : (
+            <>
+              <div className="flex flex-wrap items-start justify-between gap-3 rounded-lg bg-muted/25 p-3 text-sm">
+                <div><div className="font-medium">{selected.title}</div><code className="text-xs text-muted-foreground">{selected.runId}</code></div>
+                <span className={`rounded-full border px-2 py-0.5 text-xs ${statusTone(selected.status)}`}>{selected.status}</span>
+              </div>
+
+              <dl className="grid grid-cols-2 overflow-hidden rounded-lg border text-sm sm:grid-cols-4">
+                <div className="p-2.5"><dt className="text-xs text-muted-foreground">Sequence</dt><dd className="mt-0.5 font-medium tabular-nums">{selected.sequence}</dd></div>
+                <div className="border-l p-2.5"><dt className="text-xs text-muted-foreground">Tasks</dt><dd className="mt-0.5 font-medium tabular-nums">{Object.keys(selected.tasks).length}</dd></div>
+                <div className="border-t p-2.5 sm:border-l sm:border-t-0"><dt className="text-xs text-muted-foreground">Assignments</dt><dd className="mt-0.5 font-medium tabular-nums">{Object.keys(selected.assignments ?? {}).length}</dd></div>
+                <div className="border-l border-t p-2.5 sm:border-t-0"><dt className="text-xs text-muted-foreground">Acceptance waits</dt><dd className="mt-0.5 font-medium tabular-nums">{Object.keys(selected.reviewerAssignments ?? {}).length + Object.keys(selected.sponsorGates ?? {}).length}</dd></div>
+              </dl>
+
+              <div className="flex gap-1 rounded-lg bg-muted/35 p-1" role="tablist" aria-label="Workroom 详情视图">
+                {(['tasks', 'assignments', 'acceptance'] as const).map((view) => <button key={view} type="button" role="tab" aria-selected={detailView === view} className={`flex-1 rounded-md px-2 py-1.5 text-xs font-medium ${detailView === view ? 'bg-background shadow-sm' : 'text-muted-foreground hover:text-foreground'}`} onClick={() => setDetailView(view)}>{view === 'tasks' ? '任务' : view === 'assignments' ? '执行分配' : '验收门'}</button>)}
+              </div>
+
+              {detailView === 'tasks' && <ul className="space-y-2 text-sm">
+                {Object.values(selected.tasks).map((task) => (
+                  <li key={task.key} className="rounded-lg border p-3">
+                    <div className="flex items-start justify-between gap-2"><div><code className="text-xs text-muted-foreground">{task.key}</code><div className="font-medium">{task.title}</div></div><span className={`rounded-full border px-2 py-0.5 text-[11px] ${statusTone(task.status)}`}>{task.status}</span></div>
+                    <div className="mt-2 flex flex-wrap gap-x-4 gap-y-1 text-xs text-muted-foreground"><span>rev {task.revision}</span><span>attempt {task.attempt}/{task.maxAttempts}</span>{task.currentAssignmentId ? <span>assignment {task.currentAssignmentId}</span> : null}</div>
+                    {task.blockers?.map((blocker) => <div key={blocker.id} className="mt-2 rounded-md border border-amber-500/25 bg-amber-500/5 p-2 text-xs"><strong>{blocker.kind}</strong> · {blocker.reason}<div className="text-muted-foreground">owner {blocker.owner}</div></div>)}
+                    {task.reportRef ? <div className="mt-2 break-words rounded bg-muted/35 p-2 font-mono text-xs">report: {task.reportRef}</div> : null}
+                    {task.terminalReason ? <div className="mt-2 whitespace-pre-wrap text-xs text-red-600">{task.terminalReason}</div> : null}
+                  </li>
+                ))}
+              </ul>}
+
+              {detailView === 'assignments' && <ul className="space-y-2 text-sm">
+                {Object.values(selected.assignments ?? {}).length === 0 ? <li className="py-8 text-center text-muted-foreground">暂无 Assignment</li> : Object.values(selected.assignments ?? {}).map((assignment) => (
+                  <li key={assignment.id} className="rounded-lg border p-3">
+                    <div className="flex items-start justify-between gap-2"><div><code className="text-xs text-muted-foreground">{assignment.id}</code><div className="font-medium">{assignment.taskKey} · {assignment.role}</div></div><span className={`rounded-full border px-2 py-0.5 text-[11px] ${statusTone(assignment.status)}`}>{assignment.status}</span></div>
+                    <div className="mt-2 grid gap-1 text-xs text-muted-foreground sm:grid-cols-3"><span>owner {assignment.owner}</span><span>attempt {assignment.attempt}</span><span>lease {new Date(assignment.leaseExpiresAt).toLocaleString()}</span></div>
+                    {assignment.latestProgress ? <div className="mt-2 rounded-md bg-muted/35 p-2 text-xs"><strong>Progress</strong> · {assignment.latestProgress.summary}{assignment.latestProgress.totalUnits ? <div className="mt-1 h-1.5 overflow-hidden rounded-full bg-muted"><i className="block h-full bg-primary" style={{ width: `${Math.min(100, Math.max(0, ((assignment.latestProgress.completedUnits ?? 0) / assignment.latestProgress.totalUnits) * 100))}%` }} /></div> : null}</div> : null}
+                  </li>
+                ))}
+              </ul>}
+
+              {detailView === 'acceptance' && <ul className="space-y-2 text-sm">
+                {[...Object.values(selected.reviewerAssignments ?? {}), ...Object.values(selected.sponsorGates ?? {})].length === 0 ? <li className="py-8 text-center text-muted-foreground">当前没有 Reviewer / Sponsor 等待项</li> : [...Object.values(selected.reviewerAssignments ?? {}), ...Object.values(selected.sponsorGates ?? {})].map((wait) => (
+                  <li key={wait.id} className="rounded-lg border p-3"><div className="flex items-center justify-between gap-2"><div><div className="font-medium">{wait.taskKey} · {wait.route}</div><code className="text-xs text-muted-foreground">{wait.id}</code></div><span className={`rounded-full border px-2 py-0.5 text-[11px] ${statusTone(wait.status)}`}>{wait.status}</span></div><div className="mt-2 flex flex-wrap gap-3 text-xs text-muted-foreground"><span>risk {wait.riskTier}</span><span>owner {wait.owner}</span><span>deadline {new Date(wait.deadline).toLocaleString()}</span></div></li>
+                ))}
+              </ul>}
+
+            </>
+          )}
+        </section>
+      </div>
+    </div>
+  );
+}
+
+function statusTone(status: string): string {
+  if (/completed|accepted|approved|passed|execution_completed/u.test(status)) return 'border-emerald-500/25 bg-emerald-500/5 text-emerald-700 dark:text-emerald-300';
+  if (/failed|lost|rejected|expired/u.test(status)) return 'border-red-500/25 bg-red-500/5 text-red-700 dark:text-red-300';
+  if (/blocked|replan|rework|cancell/u.test(status)) return 'border-amber-500/25 bg-amber-500/5 text-amber-700 dark:text-amber-300';
+  return 'border-sky-500/25 bg-sky-500/5 text-sky-700 dark:text-sky-300';
+}

package/client/{orchestration/registerOrchestrationConsole.test.ts → workroom/registerWorkroomConsole.test.ts}

@@ -1,13 +1,13 @@
 import { describe, expect, it, vi } from 'vitest';
-import { registerOrchestrationConsole } from './registerOrchestrationConsole.js';
+import { registerWorkroomConsole } from './registerWorkroomConsole.js';
 
-describe('registerOrchestrationConsole', () => {
-  it('registers orchestration route and tool', () => {
+describe('registerWorkroomConsole', () => {
+  it('registers Workroom route and tool', () => {
     const addRoute = vi.fn();
     const addTool = vi.fn();
     const React = { createElement: vi.fn((type) => ({ type })) };
 
-    registerOrchestrationConsole({
+    registerWorkroomConsole({
       React: React as never,
       addRoute,
       addPage: addRoute,
@@ -15,12 +15,12 @@ describe('registerOrchestrationConsole', () => {
     });
 
     expect(addRoute).toHaveBeenCalledWith(expect.objectContaining({
-      path: '/console/orchestration',
-      name: '编排',
+      path: '/console/workroom',
+      name: 'Workroom',
     }));
     expect(addTool).toHaveBeenCalledWith(expect.objectContaining({
-      id: 'orchestration',
-      path: '/console/orchestration',
+      id: 'workroom',
+      path: '/console/workroom',
     }));
   });
 });

package/client/workroom/registerWorkroomConsole.ts

@@ -0,0 +1,17 @@
+import type { PluginRegisterHostApi } from '@zhin.js/contract';
+import WorkroomRunsPage from './WorkroomRunsPage.js';
+
+/** Read-only Workroom Run/Task/Assignment projection. */
+export function registerWorkroomConsole(api: PluginRegisterHostApi): void {
+  api.addRoute({
+    path: '/console/workroom',
+    name: 'Workroom',
+    element: api.React.createElement(WorkroomRunsPage),
+    meta: { order: 40, group: 'Agent' },
+  });
+  api.addTool({
+    id: 'workroom',
+    name: 'Workroom',
+    path: '/console/workroom',
+  });
+}

package/dist/console-events.d.ts

@@ -0,0 +1,7 @@
+import type { ConsoleEventHistoryPage, ConsoleEventHistoryQuery } from '@zhin.js/console-protocol';
+export interface FetchConsoleEventHistoryOptions {
+    readonly signal?: AbortSignal;
+}
+/** Read a typed page from the Host's bounded Console event journal. */
+export declare function fetchConsoleEventHistory(query?: ConsoleEventHistoryQuery, options?: FetchConsoleEventHistoryOptions): Promise<ConsoleEventHistoryPage>;
+//# sourceMappingURL=console-events.d.ts.map

package/dist/console-events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"console-events.d.ts","sourceRoot":"","sources":["../client/console-events.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,uBAAuB,EACvB,wBAAwB,EACzB,MAAM,2BAA2B,CAAC;AAGnC,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;CAC/B;AAED,uEAAuE;AACvE,wBAAsB,wBAAwB,CAC5C,KAAK,GAAE,wBAA6B,EACpC,OAAO,GAAE,+BAAoC,GAC5C,OAAO,CAAC,uBAAuB,CAAC,CAsBlC"}

package/dist/console-events.js

@@ -0,0 +1,26 @@
+import { getStoredToken, resolveApiUrl } from './websocket/remote-settings.js';
+/** Read a typed page from the Host's bounded Console event journal. */
+export async function fetchConsoleEventHistory(query = {}, options = {}) {
+    const params = new URLSearchParams();
+    if (query.runtimeId)
+        params.set('runtimeId', query.runtimeId);
+    if (query.after !== undefined)
+        params.set('after', String(query.after));
+    if (query.limit !== undefined)
+        params.set('limit', String(query.limit));
+    const token = getStoredToken();
+    const headers = { Accept: 'application/json' };
+    if (token)
+        headers.Authorization = `Bearer ${token}`;
+    const suffix = params.size ? `?${params}` : '';
+    const response = await fetch(resolveApiUrl(`/api/events/history${suffix}`), {
+        headers,
+        signal: options.signal,
+    });
+    const body = await response.json();
+    if (!response.ok || body.success !== true || !body.data) {
+        throw new Error(body.error ?? `Console event history failed: HTTP ${response.status}`);
+    }
+    return body.data;
+}
+//# sourceMappingURL=console-events.js.map

package/dist/console-events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"console-events.js","sourceRoot":"","sources":["../client/console-events.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAM/E,uEAAuE;AACvE,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,QAAkC,EAAE,EACpC,UAA2C,EAAE;IAE7C,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;IACrC,IAAI,KAAK,CAAC,SAAS;QAAE,MAAM,CAAC,GAAG,CAAC,WAAW,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;IAC9D,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS;QAAE,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;IACxE,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS;QAAE,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;IACxE,MAAM,KAAK,GAAG,cAAc,EAAE,CAAC;IAC/B,MAAM,OAAO,GAA2B,EAAE,MAAM,EAAE,kBAAkB,EAAE,CAAC;IACvE,IAAI,KAAK;QAAE,OAAO,CAAC,aAAa,GAAG,UAAU,KAAK,EAAE,CAAC;IACrD,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAC/C,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,aAAa,CAAC,sBAAsB,MAAM,EAAE,CAAC,EAAE;QAC1E,OAAO;QACP,MAAM,EAAE,OAAO,CAAC,MAAM;KACvB,CAAC,CAAC;IACH,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAI/B,CAAC;IACF,IAAI,CAAC,QAAQ,CAAC,EAAE,IAAI,IAAI,CAAC,OAAO,KAAK,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QACxD,MAAM,IAAI,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,sCAAsC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;IACzF,CAAC;IACD,OAAO,IAAI,CAAC,IAAI,CAAC;AACnB,CAAC"}

package/dist/index.d.ts

@@ -1,6 +1,9 @@
 export * from "./types";
-export { ENDPOINT_RPC, ENDPOINT_MANAGEMENT_CAPABILITIES, INBOX_RPC, SIDE_EVENT_PUSH, SIDE_EVENT_RPC, normalizeConsolePushMessage, normalizeConsolePushType, parseConsoleInboxEvent, type ConsoleInboxEvent, type ConsoleInboxEventKind, type ConsoleEndpointPhase, type ConsoleEndpointSummary, type EndpointManagementCapability, } from "@zhin.js/console-protocol";
+export { ENDPOINT_RPC, CONSOLE_EVENT_RECOVERY_GAP_EVENT, ENDPOINT_MANAGEMENT_CAPABILITIES, INBOX_RPC, SIDE_EVENT_PUSH, SIDE_EVENT_RPC, normalizeConsolePushMessage, normalizeConsolePushType, parseConsoleInboxEvent, type ConsoleInboxEvent, type ConsoleInboxEventKind, type ConsoleInboxNoticeRow, type ConsoleInboxNoticesQuery, type ConsoleInboxNoticesResult, type ConsoleEndpointPhase, type ConsoleEndpointSummary, type ConsoleEventActor, type ConsoleEventChannel, type EndpointManagementCapability, parseConsoleSseFrame, type ConsoleEventDelivery, type ConsoleEventData, type ConsoleEndpointEventData, type ConsoleEventEnvelope, type ConsoleEventHistoryPage, type ConsoleEventHistoryQuery, type ConsoleEventPayloadMap, type ConsoleMessageEventData, type ConsoleNoticeEventData, type ConsoleRequestEventData, type KnownConsoleEventType, type KnownConsoleEventEnvelope, type ParsedConsoleSseFrame, } from "@zhin.js/console-protocol";
+export { fetchConsoleEventHistory, type FetchConsoleEventHistoryOptions, } from './console-events.js';
 export { resolveMediaSrc, pickMediaRawUrl, type MediaKind } from "./mediaSrc";
+export { MarkdownContent, CodeBlock, type MarkdownContentProps, } from "./message-content/MarkdownContent.js";
+export { parseMarkdown, parseMarkdownInline, highlightCodeLine, isSafeMarkdownHref, type MarkdownBlock, type MarkdownInline, type CodeToken, type CodeTokenKind, } from "./message-content/markdown.js";
 export { segmentsForImDelivery, segmentsForAgentPanel } from "./segments.js";
 export { app, type ConsoleApp, type AddRouteInput, type AddToolInput, type ConsoleRouteRecord, type RouteTreeNode, type ToolTreeNode, type ConsoleRouteRenderer, } from "./app";
 export * from "./websocket";
@@ -9,7 +12,7 @@ export { createRegistryStore, useRegistry, type RegistryStore, } from "./store/c
 export { cn } from "./console-utils/cn.js";
 export { apiFetch, getApiBase, getToken, resolveApiUrl, resolveWebSocketUrl, } from "./console-utils/remoteApi.js";
 export { fetchConsoleEntries, createPluginRegisterHostApi, getRegisterFn, loadConsoleEntries, registerConsolePluginsFromEntries, resolveEntryRegister, type CreatePluginRegisterHostApiOptions, type FetchConsoleEntriesOptions, type LoadConsoleEntriesOptions, } from "./bootstrap/loadConsoleEntries.js";
-export { registerOrchestrationConsole } from "./orchestration/registerOrchestrationConsole.js";
-export { default as OrchestrationRunsPage } from "./orchestration/OrchestrationRunsPage.js";
+export { registerWorkroomConsole } from "./workroom/registerWorkroomConsole.js";
+export { default as WorkroomRunsPage } from "./workroom/WorkroomRunsPage.js";
 export { startAgentSession, continueAgentSession, subscribeAgentStream, iterateAgentStreamNdjson, foldAgentStreamNdjson, type AgentStreamClientOptions, type SubscribeAgentStreamOptions, } from "./agent-stream.js";
 //# sourceMappingURL=index.d.ts.map