@mstar-harness/dsh 3.8.1 → 3.8.2

package/dist/client.js

@@ -110,6 +110,9 @@ function mstarPanelDefinition(t) {
 // src/engine-status-wire.ts
 var ENGINE_STATUS_CHANNEL = "/api";
 var ENGINE_STATUS_ENDPOINT = "mstar/engineStatus";
+var MSTAR_ENGINE_STATUS_NAMESPACE = "mstar";
+var MSTAR_SELECT_WORKFLOW_METHOD = "selectWorkflow";
+var SELECT_WORKFLOW_ENDPOINT = `${MSTAR_ENGINE_STATUS_NAMESPACE}/${MSTAR_SELECT_WORKFLOW_METHOD}`;
 
 // src/client/panel/guards.ts
 function str(value) {
@@ -127,6 +130,36 @@ function record(value) {
 function unavailable(reason) {
   return { status: "unavailable", reason };
 }
+function selectionView(value) {
+  const view = record(value);
+  if (view === null)
+    return null;
+  const workflowId = str(view.workflowId);
+  const dir = str(view.dir);
+  if (view.kind === "active" || view.kind === "terminal") {
+    if (workflowId === null || dir === null)
+      return null;
+    if (view.kind === "terminal")
+      return { kind: "terminal", workflowId, dir };
+    const warning = record(view.warning);
+    const code2 = warning === null ? null : str(warning.code);
+    const message2 = warning === null ? null : str(warning.message);
+    return {
+      kind: "active",
+      workflowId,
+      dir,
+      ...code2 === null || message2 === null ? {} : { warning: { code: code2, message: message2 } }
+    };
+  }
+  if (view.kind !== "error")
+    return null;
+  const code = str(view.code);
+  const message = str(view.message);
+  if (code === null || message === null)
+    return null;
+  const ids = Array.isArray(view.activeWorkflowIds) ? view.activeWorkflowIds.filter((id) => str(id) !== null) : undefined;
+  return { kind: "error", code, message, ...ids === undefined ? {} : { activeWorkflowIds: ids } };
+}
 function parseEngineStatusResult(raw, sessionId, cwd) {
   const envelope = record(raw);
   if (envelope === null)
@@ -156,13 +189,45 @@ function parseEngineStatusResult(raw, sessionId, cwd) {
   const payload = record(value.payload);
   if (payload === null)
     return unavailable("malformed-payload");
-  return { status: "ok", payload, at, turn };
+  const binding = record(value.binding);
+  return {
+    status: "ok",
+    payload,
+    at,
+    turn,
+    binding: binding === null ? null : selectionView(binding.selection)
+  };
+}
+function parseSelectWorkflowResult(raw, sessionId, workflowId) {
+  const envelope = record(raw);
+  if (envelope === null)
+    return { status: "unavailable", reason: "malformed-response" };
+  if (envelope.ok !== true) {
+    const error = record(envelope.error);
+    const code = str(error?.code);
+    return { status: "unavailable", reason: code === null ? "transport-error" : `transport-error:${code}` };
+  }
+  const value = record(envelope.value);
+  if (value === null)
+    return { status: "unavailable", reason: "malformed-response" };
+  if (value.status === "unavailable") {
+    return { status: "unavailable", reason: str(value.reason) ?? "unavailable" };
+  }
+  if (value.status !== "selected")
+    return { status: "unavailable", reason: "malformed-response" };
+  const acknowledgedSession = str(value.sessionId);
+  const acknowledgedWorkflow = str(value.workflowId);
+  if (acknowledgedSession !== sessionId)
+    return { status: "unavailable", reason: "session-mismatch" };
+  if (acknowledgedWorkflow !== workflowId)
+    return { status: "unavailable", reason: "workflow-mismatch" };
+  return { status: "selected", sessionId, workflowId };
 }
 
 // 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 };
+var EMPTY = { entries: new Map, selections: new Map };
 
 class MstarEngineStatusClient {
   connection;
@@ -176,6 +241,8 @@ class MstarEngineStatusClient {
   refreshTimer = null;
   generationDisposer = null;
   generation = 0;
+  sessionGenerations = new Map;
+  stale = new Set;
   disposed = false;
   constructor(connection, options = {}) {
     this.connection = connection;
@@ -200,8 +267,10 @@ class MstarEngineStatusClient {
   ensure(sessionId, cwd, anchorTime) {
     if (this.disposed)
       return;
-    if (this.snapshot.entries.get(sessionId)?.anchorTime === anchorTime)
-      return;
+    if (this.snapshot.entries.get(sessionId)?.anchorTime === anchorTime) {
+      if (!this.stale.delete(sessionId))
+        return;
+    }
     const key = `${sessionId}\x00${anchorTime}`;
     if (this.inFlight.has(key))
       return;
@@ -217,9 +286,56 @@ class MstarEngineStatusClient {
     this.inFlight.clear();
     if (this.snapshot.entries.size === 0)
       return;
-    this.snapshot = EMPTY;
+    this.snapshot = { ...this.snapshot, entries: new Map };
     this.notify();
   }
+  invalidateSession(sessionId) {
+    if (this.disposed)
+      return;
+    this.sessionGenerations.set(sessionId, this.sessionGen(sessionId) + 1);
+    const prefix = `${sessionId}\x00`;
+    for (const key of [...this.inFlight.keys()]) {
+      if (key.startsWith(prefix))
+        this.inFlight.delete(key);
+    }
+    this.stale.add(sessionId);
+  }
+  async selectWorkflow(sessionId, cwd, workflowId) {
+    if (this.disposed)
+      return { status: "unavailable", reason: "disposed" };
+    if (this.snapshot.selections.get(sessionId)?.state === "pending") {
+      return { status: "unavailable", reason: "selection-pending" };
+    }
+    this.setSelection(sessionId, { state: "pending" });
+    const answer = await this.callSelect(sessionId, cwd, workflowId);
+    if (answer.status === "selected") {
+      this.invalidateSession(sessionId);
+      this.setSelection(sessionId, { state: "selected", workflowId: answer.workflowId });
+    } else {
+      this.setSelection(sessionId, { state: "failed", reason: answer.reason });
+    }
+    return answer;
+  }
+  async callSelect(sessionId, cwd, workflowId) {
+    if (this.connection === null || this.connection === undefined || typeof this.connection.rpc?.call !== "function") {
+      return { status: "unavailable", reason: "no-connection" };
+    }
+    try {
+      const raw = await this.withDeadline((signal) => this.connection.rpc.call(ENGINE_STATUS_CHANNEL, SELECT_WORKFLOW_ENDPOINT, { args: { sessionId, cwd, workflowId } }, signal));
+      return parseSelectWorkflowResult(raw, sessionId, workflowId);
+    } catch (error) {
+      return { status: "unavailable", reason: `transport-error:${error?.message ?? "unknown"}` };
+    }
+  }
+  setSelection(sessionId, state) {
+    const selections = new Map(this.snapshot.selections);
+    selections.set(sessionId, state);
+    this.snapshot = { ...this.snapshot, selections };
+    this.notify();
+  }
+  sessionGen(sessionId) {
+    return this.sessionGenerations.get(sessionId) ?? 0;
+  }
   dispose() {
     this.disposed = true;
     this.generationDisposer?.();
@@ -263,6 +379,7 @@ class MstarEngineStatusClient {
   }
   async fetch(sessionId, cwd, anchorTime) {
     const generation = this.generation;
+    const sessionGeneration = this.sessionGen(sessionId);
     let answer;
     if (this.connection === null || this.connection === undefined || typeof this.connection.rpc?.call !== "function") {
       answer = { status: "unavailable", reason: "no-connection" };
@@ -274,7 +391,7 @@ class MstarEngineStatusClient {
         answer = { status: "unavailable", reason: `transport-error:${error?.message ?? "unknown"}` };
       }
     }
-    this.write(generation, sessionId, cwd, anchorTime, answer);
+    this.write(generation, sessionGeneration, sessionId, cwd, anchorTime, answer);
   }
   async withDeadline(call) {
     if (this.timeoutMs <= 0 || typeof setTimeout !== "function")
@@ -299,19 +416,22 @@ class MstarEngineStatusClient {
       this.abort.signal.removeEventListener("abort", relay);
     }
   }
-  write(generation, sessionId, cwd, anchorTime, fetch) {
+  write(generation, sessionGeneration, sessionId, cwd, anchorTime, fetch) {
     if (this.disposed)
       return;
     if (generation !== this.generation)
       return;
+    if (sessionGeneration !== this.sessionGen(sessionId))
+      return;
     if ((this.snapshot.entries.get(sessionId)?.anchorTime ?? anchorTime) > anchorTime)
       return;
     this.writeEntry(sessionId, { anchorTime, cwd, fetchedAt: Date.now(), fetch });
   }
   writeEntry(sessionId, entry) {
+    this.stale.delete(sessionId);
     const entries = new Map(this.snapshot.entries);
     entries.set(sessionId, entry);
-    this.snapshot = { entries };
+    this.snapshot = { ...this.snapshot, entries };
     this.notify();
   }
   notify() {
@@ -368,6 +488,7 @@ var zh = {
   "event-log.field.expected": "预期角色",
   "event-log.field.settled": "已结算",
   "event-log.field.duration": "耗时",
+  "event-log.field.child-id": "子会话 ID",
   "event-log.field.run-id": "运行 ID",
   "event-log.field.name": "运行名称",
   "event-log.field.members": "成员数",
@@ -437,6 +558,7 @@ var zh = {
   "zone.agents.group.plan-more": "+{n} 更多",
   "flow.empty": "暂无实际派发（记录自 agent-flow plan 合并起生效）",
   "flow.settle-only": "仅有结算记录（无派发证据）",
+  "flow.link-only": "仅有身份记录（无派发证据）",
   "flow.degraded": "agentFlow 证据缺失",
   "flow.unexpected": "未匹配角色",
   "flow.in-flight": "已派发",
@@ -447,6 +569,10 @@ var zh = {
   "state.title": "工作区状态",
   "state.selection": "所选工作流",
   "state.selection.history": "历史视图（终端快照）",
+  "state.selection.unbound": "存在多个活动工作流——请为本会话选择一个。本会话没有租约，也不在任何工作流工作区内。选择之前写入会暂停。其他会话保持各自的绑定。",
+  "state.selection.pick": "选择 {workflowId}",
+  "state.selection.pending": "正在提交选择…",
+  "state.selection.failed": "选择失败：{reason}",
   "state.plans": "计划",
   "state.residuals": "未决残留",
   "state.policy": "策略",
@@ -492,6 +618,7 @@ var en = {
   "event-log.field.expected": "Expected role",
   "event-log.field.settled": "Settled",
   "event-log.field.duration": "Duration",
+  "event-log.field.child-id": "Child session ID",
   "event-log.field.run-id": "Run ID",
   "event-log.field.name": "Run name",
   "event-log.field.members": "Members",
@@ -561,6 +688,7 @@ var en = {
   "zone.agents.group.plan-more": "+{n} more",
   "flow.empty": "No actual dispatches yet (recording starts at agent-flow plan merge)",
   "flow.settle-only": "Settle records only (no dispatch evidence)",
+  "flow.link-only": "Identity records only (no dispatch evidence)",
   "flow.degraded": "No agent-flow evidence (ledger missing)",
   "flow.unexpected": "Unexpected roles",
   "flow.in-flight": "dispatched",
@@ -571,6 +699,10 @@ var en = {
   "state.title": "Workspace state",
   "state.selection": "Selected workflow",
   "state.selection.history": "history view (terminal snapshot)",
+  "state.selection.unbound": "Multiple active workflows — pick one for this session. This session has no lease and is not inside a workflow worktree. Writes pause until you pick. Other sessions stay on their own binding.",
+  "state.selection.pick": "Select {workflowId}",
+  "state.selection.pending": "Committing your pick…",
+  "state.selection.failed": "Pick failed: {reason}",
   "state.plans": "Plans",
   "state.residuals": "Open residuals",
   "state.policy": "Policy",
@@ -1281,6 +1413,65 @@ var css = `
   font-weight: 600;
 }
 
+
+.\\36 7818fcf_picker {
+  display: flex;
+  flex-direction: column;
+  gap: var(--mstar-space-2);
+}
+
+.c6520e3e_pickerCopy {
+  margin: 0;
+  color: var(--dsw-alias-label-caption);
+  font: var(--dsw-font-xxxs-11);
+}
+
+.e81be137_pickerList {
+  display: flex;
+  flex-direction: column;
+  gap: var(--mstar-space-1);
+  margin: 0;
+  padding: 0;
+  list-style: none;
+}
+
+.\\36 3bf9208_pickerItem {
+  display: flex;
+  min-width: 0;
+}
+
+.\\35 9b39fff_pickerButton {
+  appearance: none;
+  min-width: 0;
+  max-width: 100%;
+  padding: var(--mstar-space-1) var(--mstar-space-2);
+  border: 1px solid var(--dsw-alias-border-l2);
+  border-radius: 999px;
+  background: none;
+  color: var(--dsw-alias-label-secondary);
+  font: var(--dsw-font-xxxs-11);
+  text-align: left;
+  overflow-wrap: anywhere;
+  cursor: pointer;
+  transition: color 150ms ease, border-color 150ms ease;   
+}
+
+.\\35 9b39fff_pickerButton:hover:not(:disabled) {
+  color: var(--dsw-alias-label-primary);
+  border-color: var(--dsw-alias-state-business-primary);
+}
+
+.\\35 9b39fff_pickerButton:disabled {
+  color: var(--dsw-alias-label-caption);
+  cursor: default;
+}
+
+.e14449f9_pickerStatus {
+  margin: 0;
+  color: var(--dsw-alias-label-caption);
+  font: var(--dsw-font-xxxs-11);
+}
+
 .\\31 8a7beee_empty {
   margin: 0;
   color: var(--dsw-alias-label-caption);
@@ -1312,7 +1503,7 @@ if (typeof document !== "undefined" && document.querySelector("style[data-plugin
   tag.textContent = css;
   document.head.appendChild(tag);
 }
-var panel_module_default = { root: "20fd0e45_root", emptyRoot: "f83e09fa_emptyRoot", groupGrid: "1843711c_groupGrid", scroll: "dd4ec22c_scroll", meta: "81fe4f58_meta", noHarnessCard: "58245a20_noHarnessCard", noHarnessIcon: "ffb65da7_noHarnessIcon", noHarnessTitle: "81e1817c_noHarnessTitle", noHarnessHint: "a2289da7_noHarnessHint", tabNav: "4bb38bc9_tabNav", tab: "98f72e4c_tab", tabActive: "59e199de_tabActive", 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", iterationHeadSplit: "77aea5a6_iterationHeadSplit", iterationBranches: "c3b8dcb0_iterationBranches", 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", sidebar: "c87acfc7_sidebar", 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" };
+var panel_module_default = { root: "20fd0e45_root", emptyRoot: "f83e09fa_emptyRoot", groupGrid: "1843711c_groupGrid", scroll: "dd4ec22c_scroll", meta: "81fe4f58_meta", noHarnessCard: "58245a20_noHarnessCard", noHarnessIcon: "ffb65da7_noHarnessIcon", noHarnessTitle: "81e1817c_noHarnessTitle", noHarnessHint: "a2289da7_noHarnessHint", tabNav: "4bb38bc9_tabNav", tab: "98f72e4c_tab", tabActive: "59e199de_tabActive", 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", iterationHeadSplit: "77aea5a6_iterationHeadSplit", iterationBranches: "c3b8dcb0_iterationBranches", 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", sidebar: "c87acfc7_sidebar", 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", picker: "67818fcf_picker", pickerCopy: "c6520e3e_pickerCopy", pickerList: "e81be137_pickerList", pickerItem: "63bf9208_pickerItem", pickerButton: "59b39fff_pickerButton", pickerStatus: "e14449f9_pickerStatus", empty: "18a7beee_empty", freshness: "c75c59b0_freshness" };
 
 // src/client/panel/plan-sort.ts
 var PLAN_CAP = 5;
@@ -1743,7 +1934,7 @@ function projectAgents(source, currentStep) {
   }
   const entries = classifyFlowRows(rawEvents);
   const empty = rawEvents.length === 0;
-  const note = empty ? "empty" : entries.some((e) => e.view.kind === "dispatch") ? null : "settle-only";
+  const note = empty ? "empty" : entries.some((e) => e.view.kind === "dispatch") ? null : entries.length > 0 && entries.every((e) => e.view.kind === "subagent-link") ? "link-only" : "settle-only";
   const iterationRow = source == null ? null : source.iteration;
   const iterationId = iterationRow === null || iterationRow === undefined ? null : str(iterationRow.iterationId);
   const planRows = Array.isArray(rawPlans) ? rawPlans.map(planRow) : [];
@@ -1823,6 +2014,8 @@ function flowEventOf(raw, index, stageIndex) {
     };
   }
   if (kind === "settle") {
+    const childId2 = str(row?.childId);
+    const taskRef = str(row?.taskRef);
     return {
       id: `${ts}-${kind}-${index}`,
       ts,
@@ -1837,7 +2030,30 @@ function flowEventOf(raw, index, stageIndex) {
       stage: matched ?? null,
       settled: false,
       ...row?.paired === true ? { paired: true } : {},
-      durationMs: count(row?.durationMs)
+      durationMs: count(row?.durationMs),
+      ...childId2 !== null ? { childId: childId2 } : {},
+      ...taskRef !== null ? { taskRef } : {}
+    };
+  }
+  if (kind === "subagent-link") {
+    const childId2 = str(row?.childId);
+    const taskRef = str(row?.taskRef);
+    return {
+      id: `${ts}-${kind}-${index}`,
+      ts,
+      kind,
+      role,
+      planId: str(row?.planId),
+      taskId: str(row?.taskId),
+      taskCategory: null,
+      agent: str(row?.agent),
+      status: "unknown",
+      expected: matched !== undefined,
+      stage: matched ?? null,
+      settled: false,
+      durationMs: null,
+      ...childId2 !== null ? { childId: childId2 } : {},
+      ...taskRef !== null ? { taskRef } : {}
     };
   }
   const runId = str(row?.runId);
@@ -1971,6 +2187,7 @@ function PanelMeta({ t, source }) {
 
 // src/client/panel/state-section.tsx
 var jsx_runtime4 = require("react/jsx-runtime");
+var NO_IDS = [];
 function enforcementLabel(t, enforcement) {
   if (enforcement === null || enforcement === undefined || typeof enforcement !== "object") {
     return t("panel.unknown");
@@ -1980,7 +2197,16 @@ function enforcementLabel(t, enforcement) {
   const flag = hard === null ? t("panel.unknown") : hard ? t("state.enforcement.hard") : t("state.enforcement.soft");
   return source === null ? flag : `${flag} (${source})`;
 }
-function StateSection({ t, state, enforcement }) {
+function ackStandsFor(selection, workflowId) {
+  if (selection === null)
+    return true;
+  if (selection.kind === "active")
+    return selection.workflowId === workflowId;
+  if (selection.kind === "error")
+    return selection.activeWorkflowIds?.includes(workflowId) ?? false;
+  return false;
+}
+function StateSection({ t, state, enforcement, selection, pick, select }) {
   const plans = Array.isArray(state?.plans) ? state.plans : [];
   const sortedPlans = sortPlans(plans);
   const visiblePlans = sortedPlans.slice(0, PLAN_CAP);
@@ -1990,7 +2216,13 @@ function StateSection({ t, state, enforcement }) {
   const hiddenFindings = findings === null ? 0 : Math.max(0, findings.length - FINDINGS_CAP);
   const leases = Array.isArray(state?.leases) ? state.leases : [];
   const knowledge = state?.knowledge ?? null;
-  const selection = state?.selection;
+  const acked = pick.state === "selected" && ackStandsFor(selection, pick.workflowId) ? pick.workflowId : null;
+  const activeId = selection?.kind === "active" ? selection.workflowId : acked;
+  const activeWarning = selection?.kind === "active" ? selection.warning : undefined;
+  const errorView = selection?.kind === "error" ? selection : null;
+  const unbound = selection?.kind === "error" && (selection.activeWorkflowIds?.length ?? 0) > 0 ? selection : null;
+  const candidates = unbound?.activeWorkflowIds ?? NO_IDS;
+  const commit = select;
   return /* @__PURE__ */ jsx_runtime4.jsxs("section", {
     className: panel_module_default.section,
     "data-mstar-section": "state",
@@ -2003,19 +2235,19 @@ function StateSection({ t, state, enforcement }) {
         className: panel_module_default.subTitle,
         children: t("state.selection")
       }),
-      selection?.kind === "active" ? /* @__PURE__ */ jsx_runtime4.jsxs("p", {
+      activeId !== null ? /* @__PURE__ */ jsx_runtime4.jsxs("p", {
         className: panel_module_default.selection,
         "data-selection-kind": "active",
-        "data-selection-workflow": selection.workflowId,
+        "data-selection-workflow": activeId,
         children: [
           /* @__PURE__ */ jsx_runtime4.jsx("span", {
             className: panel_module_default.selectionId,
-            children: selection.workflowId
+            children: activeId
           }),
-          selection.warning !== undefined ? /* @__PURE__ */ jsx_runtime4.jsx("span", {
+          activeWarning !== undefined ? /* @__PURE__ */ jsx_runtime4.jsx("span", {
             className: panel_module_default.selectionWarning,
             "data-selection-warning": true,
-            children: selection.warning.message
+            children: activeWarning.message
           }) : null
         ]
       }) : selection?.kind === "terminal" ? /* @__PURE__ */ jsx_runtime4.jsxs("p", {
@@ -2036,18 +2268,55 @@ function StateSection({ t, state, enforcement }) {
       }) : /* @__PURE__ */ jsx_runtime4.jsxs("p", {
         className: panel_module_default.selection,
         "data-selection-kind": "error",
-        "data-selection-code": selection?.code ?? t("panel.unknown"),
+        "data-selection-code": errorView?.code ?? t("panel.unknown"),
         children: [
           /* @__PURE__ */ jsx_runtime4.jsx("span", {
             className: panel_module_default.selectionCode,
-            children: selection?.code ?? t("panel.unknown")
+            children: errorView?.code ?? t("panel.unknown")
           }),
           /* @__PURE__ */ jsx_runtime4.jsx("span", {
             className: panel_module_default.selectionMeta,
-            children: selection?.message ?? t("state.none")
+            children: errorView?.message ?? t("state.none")
           })
         ]
       }),
+      unbound !== null && commit !== null ? /* @__PURE__ */ jsx_runtime4.jsxs("div", {
+        className: panel_module_default.picker,
+        "data-mstar-picker": true,
+        "data-picker-code": unbound.code,
+        children: [
+          /* @__PURE__ */ jsx_runtime4.jsx("p", {
+            className: panel_module_default.pickerCopy,
+            "data-picker-copy": true,
+            children: t("state.selection.unbound")
+          }),
+          /* @__PURE__ */ jsx_runtime4.jsx("ul", {
+            className: panel_module_default.pickerList,
+            children: candidates.map((id) => /* @__PURE__ */ jsx_runtime4.jsx("li", {
+              className: panel_module_default.pickerItem,
+              children: /* @__PURE__ */ jsx_runtime4.jsx("button", {
+                type: "button",
+                className: panel_module_default.pickerButton,
+                "data-picker-option": id,
+                disabled: pick.state === "pending",
+                onClick: () => commit(id),
+                children: t("state.selection.pick", { workflowId: id })
+              })
+            }, id))
+          }),
+          pick.state === "pending" ? /* @__PURE__ */ jsx_runtime4.jsx("p", {
+            className: panel_module_default.pickerStatus,
+            "data-picker-pending": true,
+            children: t("state.selection.pending")
+          }) : null,
+          pick.state === "failed" ? /* @__PURE__ */ jsx_runtime4.jsx("p", {
+            className: panel_module_default.pickerStatus,
+            "data-picker-failed": true,
+            "data-picker-reason": pick.reason,
+            children: t("state.selection.failed", { reason: pick.reason })
+          }) : null
+        ]
+      }) : null,
       /* @__PURE__ */ jsx_runtime4.jsx("h3", {
         className: panel_module_default.subTitle,
         children: t("state.plans")
@@ -2225,7 +2494,7 @@ function StateSection({ t, state, enforcement }) {
 
 // src/client/panel/sidebar.tsx
 var jsx_runtime5 = require("react/jsx-runtime");
-function Sidebar({ t, state, source }) {
+function Sidebar({ t, state, source, selection, pick, select }) {
   return /* @__PURE__ */ jsx_runtime5.jsx("aside", {
     className: panel_module_default.sidebar,
     "data-mstar-sidebar": true,
@@ -2236,7 +2505,10 @@ function Sidebar({ t, state, source }) {
     }) : /* @__PURE__ */ jsx_runtime5.jsx(StateSection, {
       t,
       state,
-      enforcement: source.enforcement
+      enforcement: source.enforcement,
+      selection,
+      pick,
+      select
     })
   });
 }
@@ -3331,7 +3603,7 @@ function subBucketLabel(id, t) {
 function AgentListPage({ view, iteration, t }) {
   const { degraded, note, executing, pending } = view;
   const groups = import_react2.useMemo(() => buildGroups(view), [view]);
-  const noteInfo = degraded ? { anchor: "degraded", text: t("flow.degraded") } : note === "empty" ? { anchor: "empty", text: t("flow.empty") } : note === "settle-only" ? { anchor: "settle-only", text: t("flow.settle-only") } : null;
+  const noteInfo = degraded ? { anchor: "degraded", text: t("flow.degraded") } : note === "empty" ? { anchor: "empty", text: t("flow.empty") } : note === "settle-only" ? { anchor: "settle-only", text: t("flow.settle-only") } : note === "link-only" ? { anchor: "link-only", text: t("flow.link-only") } : null;
   return /* @__PURE__ */ jsx_runtime9.jsxs("div", {
     className: agent_list_module_default.listPage,
     "data-mstar-page": "agents",
@@ -3869,18 +4141,23 @@ function EventDetailsBody({
       /* @__PURE__ */ jsx_runtime10.jsx(DetailField, {
         field: "expected",
         label: t("event-log.field.expected"),
-        value: entry.eventKind === "settle" || isWorkflowKind(entry.eventKind) ? "" : entry.expected ? t("event-log.yes") : t("event-log.no")
+        value: entry.eventKind === "settle" || entry.eventKind === "subagent-link" || isWorkflowKind(entry.eventKind) ? "" : entry.expected ? t("event-log.yes") : t("event-log.no")
       }),
       /* @__PURE__ */ jsx_runtime10.jsx(DetailField, {
         field: "settled",
         label: t("event-log.field.settled"),
-        value: entry.eventKind === "settle" || isWorkflowKind(entry.eventKind) ? "" : entry.settled ? t("event-log.yes") : t("event-log.no")
+        value: entry.eventKind === "settle" || entry.eventKind === "subagent-link" || isWorkflowKind(entry.eventKind) ? "" : entry.settled ? t("event-log.yes") : t("event-log.no")
       }),
       /* @__PURE__ */ jsx_runtime10.jsx(DetailField, {
         field: "duration",
         label: t("event-log.field.duration"),
         value: entry.durationMs === null ? "" : `${entry.durationMs}ms`
       }),
+      /* @__PURE__ */ jsx_runtime10.jsx(DetailField, {
+        field: "child-id",
+        label: t("event-log.field.child-id"),
+        value: source?.childId ?? ""
+      }),
       isWorkflowKind(entry.eventKind) && /* @__PURE__ */ jsx_runtime10.jsxs(jsx_runtime10.Fragment, {
         children: [
           /* @__PURE__ */ jsx_runtime10.jsx(DetailField, {
@@ -4362,7 +4639,7 @@ function IterationTaskPage({ view, t }) {
 
 // src/client/panel/use-mstar-engine-status.ts
 var import_react3 = require("react");
-var EMPTY_SNAPSHOT = { entries: new Map };
+var EMPTY_SNAPSHOT = { entries: new Map, selections: new Map };
 var NO_SUBSCRIBE = () => () => {};
 var readEmptySnapshot = () => EMPTY_SNAPSHOT;
 var ANCHOR_PLUGIN = "mstar-engine";
@@ -4400,11 +4677,13 @@ function selectSessionCwd(sessionId) {
   };
 }
 var WAITING = { state: "waiting", anchorTime: null, payload: null, at: null, turn: null, reason: null };
+var IDLE_PICK = { state: "idle" };
 function unavailable2(anchorTime, reason) {
   return { state: "unavailable", anchorTime, payload: null, at: null, turn: null, reason };
 }
 function useMstarEngineStatus(seats) {
   const { useChat, useSessions, sessionId, engineStatus } = seats;
+  const session = sessionId === undefined ? null : String(sessionId);
   let anchorTime = null;
   let cwd = null;
   try {
@@ -4418,26 +4697,42 @@ function useMstarEngineStatus(seats) {
     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 };
+  const target = engineStatus !== undefined && session !== null && cwd !== null ? { client: engineStatus, sessionId: session, cwd } : null;
+  let view;
+  if (anchorTime === null) {
+    view = WAITING;
+  } else {
+    if (target !== null) {
+      try {
+        target.client.ensure(target.sessionId, target.cwd, anchorTime);
+      } catch {}
+    }
+    const entry = session === null ? undefined : snapshot.entries.get(session);
+    if (entry === undefined) {
+      if (engineStatus === undefined)
+        view = unavailable2(anchorTime, "no-connection");
+      else if (session === null)
+        view = unavailable2(anchorTime, "session-unknown");
+      else if (cwd === null)
+        view = unavailable2(anchorTime, "session-cwd-unknown");
+      else
+        view = { state: "loading", anchorTime, payload: null, at: null, turn: null, reason: null };
+    } else if (entry.fetch.status === "unavailable") {
+      view = unavailable2(anchorTime, entry.fetch.reason);
+    } else {
+      view = { state: "ok", anchorTime, payload: entry.fetch.payload, at: entry.fetch.at, turn: entry.fetch.turn, binding: entry.fetch.binding, 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 };
+  return {
+    view,
+    selection: view.state === "ok" ? view.binding ?? view.payload.state?.selection ?? null : null,
+    pick: session === null ? IDLE_PICK : snapshot.selections.get(session) ?? IDLE_PICK,
+    select: target === null ? null : (workflowId) => {
+      try {
+        target.client.selectWorkflow(target.sessionId, target.cwd, workflowId);
+      } catch {}
+    }
+  };
 }
 
 // src/client/panel/PanelView.tsx
@@ -4466,7 +4761,7 @@ function PanelContent({ section, source, t }) {
   });
 }
 function PanelView({ t, useChat, useSessions, sessionId, engineStatus, useTabInfo, useStore, actions }) {
-  const view = useMstarEngineStatus({ useChat, useSessions, sessionId, engineStatus });
+  const { view, selection, pick, select } = useMstarEngineStatus({ useChat, useSessions, sessionId, engineStatus });
   const tabInfo = useTabInfo();
   const tabId = tabInfo.tab.id;
   const section = useStore((s) => s.byTab[tabId]) ?? "tasks";
@@ -4603,7 +4898,10 @@ function PanelView({ t, useChat, useSessions, sessionId, engineStatus, useTabInf
           /* @__PURE__ */ jsx_runtime14.jsx(Sidebar, {
             t,
             state: source.state,
-            source
+            source,
+            selection,
+            pick,
+            select
           }),
           freshness
         ]