@mstar-harness/dsh 3.7.3 → 3.8.0

package/dist/client/panel/use-mstar-engine-status.d.ts

@@ -1,42 +1,114 @@
 /**
- * Data hook for the workflow panel (spec §5): subscribes to the active
- * session's conversation log through the session standard kit's chat target
- * (`useChat`, a uSES selector hook over the `chat` conversation view target)
- * and scans the log for the latest `mstar-engine-status` catalog row.
+ * Data hook for the workflow panel (spec §5): the panel's ONE data path.
  *
- * Node discriminator (spec §2.4): `kind === 'context'` + `form === 'catalog'`
- * + `source.kind === 'mstar-engine-status'`; the LATEST row wins (snapshot
- * order tail). Refresh = snapshot subscription: a digest/TTL re-emission on
- * the server only produces a new log line, whose snapshot bump re-runs this
- * selection — no manual reload, no polling.
+ * The persisted catalog row is an ANCHOR, not a data source: since the source
+ * reduction the row carries exactly `{ kind: 'plugin', plugin:
+ * 'mstar-engine-status', form: 'catalog' }`, and the structured payload lives
+ * in the host's per-session snapshot store. So the hook
  *
- * Contract: `{ source: MstarEngineStatusSource | null; lastUpdated: number |
- * null }` — `source` null while no catalog row is logged yet (waiting empty
- * state); `lastUpdated` carries the catalog message node `time` (Unix ms) for
- * the freshness marker. The hook never throws: a snapshot the selector cannot
- * read, or an absent session face, degrades to the explicit empty signal
- * instead of bubbling a crash (spec §5 degradation path; the strict-session
- * slot normally guarantees a session — the guard is belt-and-suspenders).
+ * 1. finds the LATEST anchor row in the active session's conversation log
+ *    (`kind === 'context'` + `form === 'catalog'` + the first-party `plugin`
+ *    arm with this plugin's identity) and takes its message time as the
+ *    refresh key — a re-emission appends a new row, the snapshot bump re-runs
+ *    this selection, and the newest anchor asks for the newest snapshot;
+ * 2. reads the session's workspace directory from the session standard kit's
+ *    session feed (the host cross-checks the asserted `cwd` against the
+ *    session AND the stored snapshot, so it must be the real one);
+ * 3. asks {@link MstarEngineStatusClient} for that session's snapshot over the
+ *    host's shared `/api` typert gateway, and renders the validated result.
+ *
+ * Every degraded path is an EXPLICIT state (spec §5): `waiting` (no anchor row
+ * — the plugin never ran on this session), `loading` (anchor seen, no answer
+ * for it yet), `unavailable` (a reason: transport failure, an unknown session
+ * directory, no connection, a malformed answer, or the host's own reason).
+ * None of them renders an empty plans list, an empty event log or a zeroed
+ * counter as if it were data. A VALID snapshot that says "empty" still renders
+ * as data — the distinction between "no snapshot" and "a snapshot that says
+ * empty" survives.
+ *
+ * Freshness is the served snapshot's own `at`, never "live".
+ *
+ * The hook never throws: a throwing seat or a missing client degrades to an
+ * explicit state instead of bubbling a crash (spec §5 degradation path).
  */
+import type { ConversationNode, ContextMessageNode } from '@deepseek-ai/dsh-client-ui-conversation/client';
 import type { ChatSnapshot } from '@deepseek-ai/dsh-client-ui-chat/client';
 import type { SnapshotSelectorHook } from '@deepseek-ai/dsh-client-ui-slots';
-import type { MstarEngineStatusSource } from '../../types.ts';
-/** The hook result: the latest catalog row plus its message time (spec §5). */
-export interface MstarEngineStatusView {
-    source: MstarEngineStatusSource | null;
-    /** Unix ms of the catalog message node; null while no row is present. */
-    lastUpdated: number | null;
+import type { SessionListState } from '@deepseek-ai/dsh-api-session-controller/client';
+import type { SessionId } from '@deepseek-ai/dsh-session';
+import type { MstarEngineStatusPayload } from '../../types.ts';
+import type { MstarEngineStatusClient } from './engine-status-client.ts';
+/** Selector hook over the Host session list (the `useSessions` standard seat). */
+export type UseSessions = SnapshotSelectorHook<SessionListState>;
+/** The panel's render state — a closed set: no shape can be both data and empty. */
+export type MstarEngineStatusView = 
+/** No anchor row: this session never ran the plugin (today's empty state). */
+{
+    readonly state: 'waiting';
+    readonly anchorTime: null;
+    readonly payload: null;
+    readonly at: null;
+    readonly turn: null;
+    readonly reason: null;
+}
+/** Anchor row seen, no answer for it yet — pending, never rendered as data. */
+ | {
+    readonly state: 'loading';
+    readonly anchorTime: number;
+    readonly payload: null;
+    readonly at: null;
+    readonly turn: null;
+    readonly reason: null;
+}
+/**
+ * The validated snapshot: the payload plus the snapshot's OWN emission
+ * identity (`at` timestamp and the agent turn it was written for). Both are
+ * the host's records of the stored entry, so the panel can name which
+ * emission it is showing rather than implying it is the newest one.
+ */
+ | {
+    readonly state: 'ok';
+    readonly anchorTime: number;
+    readonly payload: MstarEngineStatusPayload;
+    readonly at: string;
+    readonly turn: number;
+    readonly reason: null;
+}
+/** An explicit degraded answer — always WITH a reason, never silently empty. */
+ | {
+    readonly state: 'unavailable';
+    readonly anchorTime: number;
+    readonly payload: null;
+    readonly at: null;
+    readonly turn: null;
+    readonly reason: string;
+};
+/** The seats the hook needs: the session standard kit + the plugin's client. */
+export interface MstarEngineStatusSeats {
+    /** Selector hook over the chat target snapshot (the `conversation.view` kit). */
+    useChat: SnapshotSelectorHook<ChatSnapshot>;
+    /**
+     * Selector hook over the Host session list (the global standard seat). The
+     * view ring always hands it to a `conversation.view` entry; it stays
+     * optional here because a program without the ui-session adapter does not
+     * see the declaration merge (the panel then reports `session-cwd-unknown`).
+     */
+    useSessions: UseSessions | undefined;
+    /** Current session identity (the strict-session slot's own prop). */
+    sessionId: SessionId | undefined;
+    /** The plugin's engine-status client (absent in a composition without one). */
+    engineStatus: MstarEngineStatusClient | undefined;
 }
+/** Latest `mstar-engine-status` anchor row in snapshot order, or null. */
+export declare function latestEngineStatusRow(nodes: readonly ConversationNode[]): ContextMessageNode | null;
+/** Anchor row message time, or null when the log carries no anchor row. */
+export declare function selectAnchorTime(snapshot: ChatSnapshot): number | null;
+/** One session's workspace directory from the session list, or null when unknown. */
+export declare function selectSessionCwd(sessionId: SessionId | undefined): (state: SessionListState) => string | null;
 /**
- * `useMstarEngineStatus(useChat): MstarEngineStatusView` — the panel's data
- * hook (spec §5). The session standard kit's `useChat` is passed in (the
- * view ring hands it to every `conversation.view` entry); the hook rides it as
- * a selector over the chat target snapshot, so a snapshot bump (new catalog
- * row) re-runs the selection and refreshes the panel.
+ * The panel's data hook (spec §5).
  *
- * The hook never throws (spec §5 degradation path; Task 3 contract): a
- * throwing session face or an absent one degrades to the explicit empty
- * signal instead of bubbling a crash — the strict-session slot normally
- * guarantees a session, the guard is belt-and-suspenders.
+ * @param seats - the session standard kit + the plugin's engine-status client.
+ * @returns the explicit render state (never a throw, never a half-parsed view).
  */
-export declare function useMstarEngineStatus(useChat: SnapshotSelectorHook<ChatSnapshot>): MstarEngineStatusView;
+export declare function useMstarEngineStatus(seats: MstarEngineStatusSeats): MstarEngineStatusView;

package/dist/client.js

@@ -72,6 +72,222 @@ __export(exports_client, {
 });
 module.exports = __toCommonJS(exports_client);
 
+// src/engine-status-wire.ts
+var ENGINE_STATUS_CHANNEL = "/api";
+var ENGINE_STATUS_ENDPOINT = "mstar/engineStatus";
+
+// src/client/panel/guards.ts
+function str(value) {
+  return typeof value === "string" && value.length > 0 ? value : null;
+}
+function bool(value) {
+  return typeof value === "boolean" ? value : null;
+}
+function count(value) {
+  return typeof value === "number" && Number.isFinite(value) ? value : null;
+}
+function record(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value) ? value : null;
+}
+function unavailable(reason) {
+  return { status: "unavailable", reason };
+}
+function parseEngineStatusResult(raw, sessionId, cwd) {
+  const envelope = record(raw);
+  if (envelope === null)
+    return unavailable("malformed-response");
+  if (envelope.ok !== true) {
+    const error = record(envelope.error);
+    const code = str(error?.code);
+    return unavailable(code === null ? "transport-error" : `transport-error:${code}`);
+  }
+  const value = record(envelope.value);
+  if (value === null)
+    return unavailable("malformed-response");
+  if (value.status === "unavailable")
+    return unavailable(str(value.reason) ?? "unavailable");
+  if (value.status !== "ok")
+    return unavailable("malformed-response");
+  if (value.sessionId !== sessionId)
+    return unavailable("session-mismatch");
+  if (cwd !== undefined && value.cwd !== cwd)
+    return unavailable("cwd-mismatch");
+  const at = str(value.at);
+  if (at === null)
+    return unavailable("malformed-snapshot");
+  const turn = count(value.turn);
+  if (turn === null)
+    return unavailable("malformed-snapshot");
+  const payload = record(value.payload);
+  if (payload === null)
+    return unavailable("malformed-payload");
+  return { status: "ok", payload, at, turn };
+}
+
+// src/client/panel/engine-status-client.ts
+var ENGINE_STATUS_REQUEST_TIMEOUT_MS = 5000;
+var ENGINE_STATUS_REFRESH_INTERVAL_MS = 30000;
+var EMPTY = { entries: new Map };
+
+class MstarEngineStatusClient {
+  connection;
+  snapshot = EMPTY;
+  listeners = new Set;
+  inFlight = new Map;
+  abort = new AbortController;
+  refreshing = new Set;
+  timeoutMs;
+  refreshIntervalMs;
+  refreshTimer = null;
+  generationDisposer = null;
+  generation = 0;
+  disposed = false;
+  constructor(connection, options = {}) {
+    this.connection = connection;
+    this.timeoutMs = options.timeoutMs ?? ENGINE_STATUS_REQUEST_TIMEOUT_MS;
+    this.refreshIntervalMs = options.refreshIntervalMs ?? ENGINE_STATUS_REFRESH_INTERVAL_MS;
+    try {
+      this.generationDisposer = connection?.generation?.subscribe(() => {
+        this.invalidate();
+      }) ?? null;
+    } catch {
+      this.generationDisposer = null;
+    }
+    this.startRefreshTimer();
+  }
+  getSnapshot = () => this.snapshot;
+  subscribe = (listener) => {
+    this.listeners.add(listener);
+    return () => {
+      this.listeners.delete(listener);
+    };
+  };
+  ensure(sessionId, cwd, anchorTime) {
+    if (this.disposed)
+      return;
+    if (this.snapshot.entries.get(sessionId)?.anchorTime === anchorTime)
+      return;
+    const key = `${sessionId}\x00${anchorTime}`;
+    if (this.inFlight.has(key))
+      return;
+    const request = this.fetch(sessionId, cwd, anchorTime).finally(() => {
+      this.inFlight.delete(key);
+    });
+    this.inFlight.set(key, request);
+  }
+  invalidate() {
+    if (this.disposed)
+      return;
+    this.generation += 1;
+    this.inFlight.clear();
+    if (this.snapshot.entries.size === 0)
+      return;
+    this.snapshot = EMPTY;
+    this.notify();
+  }
+  dispose() {
+    this.disposed = true;
+    this.generationDisposer?.();
+    this.generationDisposer = null;
+    if (this.refreshTimer !== null) {
+      clearInterval(this.refreshTimer);
+      this.refreshTimer = null;
+    }
+    this.abort.abort();
+    this.listeners.clear();
+  }
+  startRefreshTimer() {
+    if (this.disposed || this.refreshIntervalMs <= 0)
+      return;
+    if (typeof setInterval !== "function")
+      return;
+    this.refreshTimer = setInterval(() => {
+      this.refresh();
+    }, this.refreshIntervalMs);
+    const timer = this.refreshTimer;
+    timer.unref?.();
+  }
+  refresh() {
+    if (this.disposed)
+      return;
+    const now = Date.now();
+    for (const [sessionId, entry] of [...this.snapshot.entries]) {
+      if (this.disposed)
+        return;
+      if (now - entry.fetchedAt < this.refreshIntervalMs)
+        continue;
+      if (this.refreshing.has(sessionId))
+        continue;
+      if (this.snapshot.entries.get(sessionId)?.anchorTime !== entry.anchorTime)
+        continue;
+      this.refreshing.add(sessionId);
+      this.fetch(sessionId, entry.cwd, entry.anchorTime).finally(() => {
+        this.refreshing.delete(sessionId);
+      });
+    }
+  }
+  async fetch(sessionId, cwd, anchorTime) {
+    const generation = this.generation;
+    let answer;
+    if (this.connection === null || this.connection === undefined || typeof this.connection.rpc?.call !== "function") {
+      answer = { status: "unavailable", reason: "no-connection" };
+    } else {
+      try {
+        const raw = await this.withDeadline((signal) => this.connection.rpc.call(ENGINE_STATUS_CHANNEL, ENGINE_STATUS_ENDPOINT, { args: { sessionId, cwd } }, signal));
+        answer = parseEngineStatusResult(raw, sessionId, cwd);
+      } catch (error) {
+        answer = { status: "unavailable", reason: `transport-error:${error?.message ?? "unknown"}` };
+      }
+    }
+    this.write(generation, sessionId, cwd, anchorTime, answer);
+  }
+  async withDeadline(call) {
+    if (this.timeoutMs <= 0 || typeof setTimeout !== "function")
+      return await call(this.abort.signal);
+    const controller = new AbortController;
+    const relay = () => {
+      controller.abort();
+    };
+    this.abort.signal.addEventListener("abort", relay);
+    let timer = null;
+    const deadline = new Promise((_resolve, reject) => {
+      timer = setTimeout(() => {
+        controller.abort();
+        reject(new Error(`timeout:${this.timeoutMs}ms`));
+      }, this.timeoutMs);
+    });
+    try {
+      return await Promise.race([call(controller.signal), deadline]);
+    } finally {
+      if (timer !== null)
+        clearTimeout(timer);
+      this.abort.signal.removeEventListener("abort", relay);
+    }
+  }
+  write(generation, sessionId, cwd, anchorTime, fetch) {
+    if (this.disposed)
+      return;
+    if (generation !== this.generation)
+      return;
+    if ((this.snapshot.entries.get(sessionId)?.anchorTime ?? anchorTime) > anchorTime)
+      return;
+    this.writeEntry(sessionId, { anchorTime, cwd, fetchedAt: Date.now(), fetch });
+  }
+  writeEntry(sessionId, entry) {
+    const entries = new Map(this.snapshot.entries);
+    entries.set(sessionId, entry);
+    this.snapshot = { entries };
+    this.notify();
+  }
+  notify() {
+    for (const listener of [...this.listeners]) {
+      try {
+        listener();
+      } catch {}
+    }
+  }
+}
+
 // src/client/panel/locale.ts
 var NS = "mstar-panel";
 var zh = {
@@ -111,6 +327,8 @@ var zh = {
   "event-log.yes": "是",
   "event-log.no": "否",
   "empty.waiting": "等待首条 engine-status catalog…",
+  "empty.loading": "正在读取该会话的 engine-status 快照…",
+  "empty.unavailable": "engine-status 快照不可用（{reason}）",
   "empty.no-harness": "未检测到 Morning Star harness",
   "empty.no-harness-hint": "当前工作区未发现 .mstar/ harness 目录，详细面板保持未激活；检测到 harness 后自动呈现",
   "watermark.version": "mstar {version}",
@@ -192,8 +410,8 @@ var zh = {
   "state.policy.worktree": "worktree",
   "state.policy.control-worktree": "control worktree",
   "state.knowledge.docs": "{count} 篇文档",
-  "freshness.last-updated": "最后更新 {time}",
-  "freshness.refresh-note": "刷新跟随 catalog 重发（约 ≤1 分钟）"
+  "freshness.last-updated": "快照 {time} · 第 {turn} 轮",
+  "freshness.refresh-note": "该会话已存储的快照——不是实时值"
 };
 var en = {
   "view.mstar-workflow": "MStar Workflow",
@@ -232,6 +450,8 @@ var en = {
   "event-log.yes": "yes",
   "event-log.no": "no",
   "empty.waiting": "Waiting for the first engine-status catalog…",
+  "empty.loading": "Reading this session’s engine-status snapshot…",
+  "empty.unavailable": "Engine-status snapshot unavailable ({reason})",
   "empty.no-harness": "No Morning Star harness detected",
   "empty.no-harness-hint": "No .mstar/ harness directory found in this workspace — the detail panel stays inactive and activates automatically once a harness is detected",
   "watermark.version": "mstar {version}",
@@ -313,12 +533,12 @@ var en = {
   "state.policy.worktree": "worktree",
   "state.policy.control-worktree": "control worktree",
   "state.knowledge.docs": "{count} docs",
-  "freshness.last-updated": "last updated {time}",
-  "freshness.refresh-note": "refreshes with catalog re-emission (≤~1 min)"
+  "freshness.last-updated": "snapshot {time} · turn {turn}",
+  "freshness.refresh-note": "the stored snapshot for this session — never a live value"
 };
 
 // src/client/panel/PanelView.tsx
-var import_react3 = require("react");
+var import_react4 = require("react");
 
 // src/client/panel/panel.module.css
 var css = `
@@ -1053,17 +1273,6 @@ if (typeof document !== "undefined" && document.querySelector("style[data-plugin
 }
 var panel_module_default = { root: "20fd0e45_root", emptyRoot: "f83e09fa_emptyRoot", noHarnessCard: "58245a20_noHarnessCard", noHarnessIcon: "ffb65da7_noHarnessIcon", noHarnessTitle: "81e1817c_noHarnessTitle", noHarnessHint: "a2289da7_noHarnessHint", sidebar: "c87acfc7_sidebar", iterationHeadSplit: "77aea5a6_iterationHeadSplit", iterationBranches: "c3b8dcb0_iterationBranches", main: "ea90e208_main", tabNav: "4bb38bc9_tabNav", tab: "98f72e4c_tab", tabActive: "59e199de_tabActive", content: "90bec3c2_content", iterationPage: "3b1c4147_iterationPage", iterationHead: "8a629a8e_iterationHead", iterationSummary: "2d1bee34_iterationSummary", iterationSummaryId: "17162a99_iterationSummaryId", iterationSummaryVerdict: "d3d74135_iterationSummaryVerdict", iterationSummaryStatus: "d9a886be_iterationSummaryStatus", iterationSummaryStatusMuted: "13bf2f41_iterationSummaryStatusMuted", iterationSummaryHint: "ede5708d_iterationSummaryHint", iterationHeadBody: "64d1da62_iterationHeadBody", iterationStepsRow: "c52f7b85_iterationStepsRow", iterationStepItem: "81013a9d_iterationStepItem", iterationStepBadge: "7befde45_iterationStepBadge", iterationStepPhase: "d6cd23a5_iterationStepPhase", iterationStepChip: "de293024_iterationStepChip", iterationVerdictSeat: "afea5850_iterationVerdictSeat", iterationVerdict: "ebe6bbcd_iterationVerdict", iterationBranchesTitle: "e6921da6_iterationBranchesTitle", iterationBranchList: "8a2cd65c_iterationBranchList", iterationBranchRow: "997b0230_iterationBranchRow", iterationBranchLabel: "6cafc032_iterationBranchLabel", iterationBranchValue: "cdcd06ed_iterationBranchValue", iterationTasks: "87f7efbe_iterationTasks", sidebarScroll: "a0b80516_sidebarScroll", meta: "81fe4f58_meta", metaLine: "0fc275e2_metaLine", section: "fcdd0ccc_section", sectionTitle: "aded23ea_sectionTitle", subTitle: "b7190159_subTitle", defList: "26763614_defList", defTerm: "670df156_defTerm", defValue: "3f1b3a05_defValue", planList: "a129f16e_planList", residualList: "113e0aa2_residualList", leaseList: "33dfcc85_leaseList", violationList: "999efdc0_violationList", planId: "744bf63f_planId", leasePlan: "560663a6_leasePlan", leaseHolder: "a68a6d03_leaseHolder", leaseWorktree: "db027b44_leaseWorktree", findingSeverity: "1797fd51_findingSeverity", findingTitle: "c80b7bb0_findingTitle", findingPlan: "616667ad_findingPlan", violationCode: "e42c0bfd_violationCode", knowledgeCategories: "e2098247_knowledgeCategories", planStatus: "a3021d7c_planStatus", truncated: "1849d129_truncated", knowledge: "3eb5feeb_knowledge", direction: "df6dc76a_direction", selection: "4364e615_selection", selectionId: "0ae21b10_selectionId", selectionMeta: "5e43d3a8_selectionMeta", selectionWarning: "da64723f_selectionWarning", selectionCode: "ac988a64_selectionCode", empty: "18a7beee_empty", freshness: "c75c59b0_freshness" };
 
-// src/client/panel/guards.ts
-function str(value) {
-  return typeof value === "string" && value.length > 0 ? value : null;
-}
-function bool(value) {
-  return typeof value === "boolean" ? value : null;
-}
-function count(value) {
-  return typeof value === "number" && Number.isFinite(value) ? value : null;
-}
-
 // src/client/panel/plan-sort.ts
 var PLAN_CAP = 5;
 var FINDINGS_CAP = 10;
@@ -1679,7 +1888,7 @@ function pairingKeyOf(row) {
   return [row.agent ?? "", row.role ?? "", row.planId ?? "", row.taskId ?? ""].join("\x00");
 }
 function pairSettleStatus(rows) {
-  const record = new Map;
+  const record2 = new Map;
   const lastDispatch = new Map;
   for (let i = rows.length - 1;i >= 0; i--) {
     const entry = rows[i];
@@ -1689,10 +1898,10 @@ function pairSettleStatus(rows) {
     } else if (entry.paired === true && entry.agent !== null) {
       const paired = lastDispatch.get(pairingKeyOf(entry));
       if (paired !== undefined)
-        record.set(paired, entry.status ?? "ok");
+        record2.set(paired, entry.status ?? "ok");
     }
   }
-  return record;
+  return record2;
 }
 function pairSettleIndexes(rows) {
   return new Set(pairSettleStatus(rows).keys());
@@ -3424,11 +3633,11 @@ function EntityCard({ entity, t, box }) {
   const running = entity.status === "running";
   const done = entity.status === "settled" && entity.emphasis !== "off";
   const title = entity.idle ? entity.name : entity.role !== "" ? entity.role : entity.name;
-  const record = [];
+  const record2 = [];
   if (entity.agent !== null)
-    record.push(entity.agent);
+    record2.push(entity.agent);
   if (entity.task !== null)
-    record.push(entity.task);
+    record2.push(entity.task);
   return /* @__PURE__ */ jsx_runtime7.jsxs("li", {
     className: entity.idle ? `${agent_canvas_module_default.agentCard} ${agent_canvas_module_default.agentCardIdle}` : running ? `${agent_canvas_module_default.agentCard} ${agent_canvas_module_default.agentCardRunning}` : done ? `${agent_canvas_module_default.agentCard} ${agent_canvas_module_default.agentCardDone}` : agent_canvas_module_default.agentCard,
     style: { left: box.x, top: box.y, width: box.w, height: box.h },
@@ -3490,10 +3699,10 @@ function EntityCard({ entity, t, box }) {
         "data-agent-role": entity.role,
         children: entity.role
       }),
-      record.length > 0 && /* @__PURE__ */ jsx_runtime7.jsx("span", {
+      record2.length > 0 && /* @__PURE__ */ jsx_runtime7.jsx("span", {
         className: agent_canvas_module_default.agentRecord,
         "data-agent-record": true,
-        children: record.join(" · ")
+        children: record2.join(" · ")
       })
     ]
   });
@@ -4668,44 +4877,87 @@ function IterationTaskPage({ view, t }) {
 }
 
 // src/client/panel/use-mstar-engine-status.ts
-var EMPTY = { source: null, lastUpdated: null };
+var import_react3 = require("react");
+var EMPTY_SNAPSHOT = { entries: new Map };
+var NO_SUBSCRIBE = () => () => {};
+var readEmptySnapshot = () => EMPTY_SNAPSHOT;
 function latestEngineStatusRow(nodes) {
   for (let i = nodes.length - 1;i >= 0; i--) {
     const node = nodes[i];
     if (node.kind !== "context" || node.form !== "catalog")
       continue;
     const source = node.source;
-    if (source?.kind === "mstar-engine-status")
+    if (source?.kind === "plugin" && source.plugin === "mstar-engine-status")
       return node;
   }
   return null;
 }
-function sameView(a, b) {
-  return a.source === b.source && a.lastUpdated === b.lastUpdated;
-}
-function selectEngineStatus(snapshot) {
+function selectAnchorTime(snapshot) {
   try {
-    const row = latestEngineStatusRow(snapshot.legacy.nodes);
-    if (row === null)
-      return EMPTY;
-    return { source: row.source, lastUpdated: row.time };
+    const row = latestEngineStatusRow(snapshot?.legacy?.nodes ?? []);
+    return row === null ? null : row.time;
   } catch {
-    return EMPTY;
+    return null;
   }
 }
-function useMstarEngineStatus(useChat) {
+function selectSessionCwd(sessionId) {
+  return (state) => {
+    try {
+      if (sessionId === undefined)
+        return null;
+      const cwd = state?.byId?.[sessionId]?.cwd;
+      return typeof cwd === "string" && cwd !== "" ? cwd : null;
+    } catch {
+      return null;
+    }
+  };
+}
+var WAITING = { state: "waiting", anchorTime: null, payload: null, at: null, turn: null, reason: null };
+function unavailable2(anchorTime, reason) {
+  return { state: "unavailable", anchorTime, payload: null, at: null, turn: null, reason };
+}
+function useMstarEngineStatus(seats) {
+  const { useChat, useSessions, sessionId, engineStatus } = seats;
+  let anchorTime = null;
+  let cwd = null;
+  try {
+    anchorTime = useChat(selectAnchorTime);
+  } catch {
+    anchorTime = null;
+  }
   try {
-    const view = useChat(selectEngineStatus, sameView);
-    return view ?? EMPTY;
+    cwd = useSessions === undefined ? null : useSessions(selectSessionCwd(sessionId));
   } catch {
-    return EMPTY;
+    cwd = null;
+  }
+  const snapshot = import_react3.useSyncExternalStore(engineStatus?.subscribe ?? NO_SUBSCRIBE, engineStatus?.getSnapshot ?? readEmptySnapshot, engineStatus?.getSnapshot ?? readEmptySnapshot);
+  if (anchorTime === null)
+    return WAITING;
+  if (engineStatus !== undefined && sessionId !== undefined && cwd !== null) {
+    try {
+      engineStatus.ensure(String(sessionId), cwd, anchorTime);
+    } catch {}
+  }
+  const entry = sessionId === undefined ? undefined : snapshot.entries.get(String(sessionId));
+  if (entry === undefined) {
+    if (engineStatus === undefined)
+      return unavailable2(anchorTime, "no-connection");
+    if (sessionId === undefined)
+      return unavailable2(anchorTime, "session-unknown");
+    if (cwd === null)
+      return unavailable2(anchorTime, "session-cwd-unknown");
+    return { state: "loading", anchorTime, payload: null, at: null, turn: null, reason: null };
   }
+  if (entry.fetch.status === "unavailable")
+    return unavailable2(anchorTime, entry.fetch.reason);
+  return { state: "ok", anchorTime, payload: entry.fetch.payload, at: entry.fetch.at, turn: entry.fetch.turn, reason: null };
 }
 
 // src/client/panel/PanelView.tsx
 var jsx_runtime12 = require("react/jsx-runtime");
-function formatTime(ms) {
-  return new Date(ms).toLocaleTimeString("en-GB");
+function formatSnapshotTime(at) {
+  const ms = Date.parse(at);
+  return Number.isNaN(ms) ? null : new Date(ms).toLocaleTimeString("en-GB");
 }
 function PanelContent({ tab, source, t }) {
   if (tab === "agents") {
@@ -4726,10 +4978,10 @@ function PanelContent({ tab, source, t }) {
     t
   });
 }
-function PanelView({ t, useChat }) {
-  const { source, lastUpdated } = useMstarEngineStatus(useChat);
-  const [tab, setTab] = import_react3.useState("tasks");
-  if (source === null || source === undefined) {
+function PanelView({ t, useChat, useSessions, sessionId, engineStatus }) {
+  const view = useMstarEngineStatus({ useChat, useSessions, sessionId, engineStatus });
+  const [tab, setTab] = import_react4.useState("tasks");
+  if (view.state === "waiting") {
     return /* @__PURE__ */ jsx_runtime12.jsx("div", {
       className: panel_module_default.emptyRoot,
       "data-mstar-panel": "waiting",
@@ -4741,14 +4993,43 @@ function PanelView({ t, useChat }) {
       })
     });
   }
+  if (view.state === "loading") {
+    return /* @__PURE__ */ jsx_runtime12.jsx("div", {
+      className: panel_module_default.emptyRoot,
+      "data-mstar-panel": "loading",
+      "data-conversation-composer-overlay": "",
+      children: /* @__PURE__ */ jsx_runtime12.jsx("p", {
+        className: panel_module_default.empty,
+        "data-mstar-empty": "loading",
+        children: t("empty.loading")
+      })
+    });
+  }
+  if (view.state === "unavailable") {
+    return /* @__PURE__ */ jsx_runtime12.jsx("div", {
+      className: panel_module_default.emptyRoot,
+      "data-mstar-panel": "unavailable",
+      "data-conversation-composer-overlay": "",
+      children: /* @__PURE__ */ jsx_runtime12.jsx("p", {
+        className: panel_module_default.empty,
+        "data-mstar-empty": "unavailable",
+        "data-mstar-unavailable-reason": view.reason,
+        children: t("empty.unavailable", { reason: view.reason })
+      })
+    });
+  }
+  const source = view.payload;
+  const snapshotTime = formatSnapshotTime(view.at);
   const noHarness = source.harnessDir === null && source.state === null && source.iteration == null;
   const freshness = /* @__PURE__ */ jsx_runtime12.jsxs("footer", {
     className: panel_module_default.freshness,
     "data-mstar-freshness": true,
     children: [
-      typeof lastUpdated === "number" ? /* @__PURE__ */ jsx_runtime12.jsx("span", {
-        children: t("freshness.last-updated", { time: formatTime(lastUpdated) })
-      }) : null,
+      snapshotTime === null ? null : /* @__PURE__ */ jsx_runtime12.jsx("span", {
+        "data-mstar-freshness-at": view.at,
+        "data-mstar-freshness-turn": String(view.turn),
+        children: t("freshness.last-updated", { time: snapshotTime, turn: String(view.turn) })
+      }),
       /* @__PURE__ */ jsx_runtime12.jsx("span", {
         children: t("freshness.refresh-note")
       })
@@ -4844,8 +5125,10 @@ function PanelView({ t, useChat }) {
 }
 
 // src/client/index.ts
-var inject = ["slots", "sessions", "locale"];
+var inject = ["slots", "sessions", "locale", "connection"];
 function apply(ctx) {
+  const engineStatus = new MstarEngineStatusClient(ctx.connection);
+  ctx.effect(() => () => engineStatus.dispose(), "ui-mstar-panel: engine-status client");
   ctx.effect(() => ctx.locale.register(NS, { zh, en }), "ui-mstar-panel: dictionaries");
   ctx.slots.inject("conversation.view", () => ctx.slots.register({
     name: "conversation.view",
@@ -4853,7 +5136,7 @@ function apply(ctx) {
     order: 20,
     label: () => ctx.locale.bind(NS)("view.mstar-workflow"),
     locale: NS
-  }, PanelView));
+  }, (props) => PanelView({ ...props, engineStatus })));
 }
 
 return module.exports; } });