@volter-ai-dev/supercode-ui 0.1.67 → 0.1.69

package/activity.mjs

@@ -29,6 +29,10 @@ var EMPTY_UI_STATE = Object.freeze({
   harness: "",
   mode: "none",
   strategy: null,
+  participant: Object.freeze({ kind: "local-user", label: null, origin: null }),
+  workspaceRef: Object.freeze({ kind: "none", value: null }),
+  mirror: null,
+  holder: null,
   canSend: false,
   canSteer: false,
   canResume: false,
@@ -629,12 +633,40 @@ function readToolPresentation(value, entry) {
     matches: nullableNumber(item.matches) ?? generated.matches
   };
 }
+var OPAQUE_RAW_CHARS = 4e3;
+function opaqueEntry(item) {
+  const previouslyOpaque = item.role === "opaque";
+  let raw;
+  if (previouslyOpaque && typeof item.raw === "string") {
+    raw = item.raw;
+  } else {
+    try {
+      raw = JSON.stringify(item, null, 2) ?? "";
+    } catch {
+      raw = "[unserializable entry payload]";
+    }
+  }
+  const kind = previouslyOpaque && typeof item.kind === "string" ? item.kind : typeof item.role === "string" ? item.role : "";
+  return {
+    id: item.id,
+    role: "opaque",
+    kind: boundedString(kind, 120) || "unknown",
+    text: typeof item.text === "string" ? boundedString(item.text, OPAQUE_RAW_CHARS) : "",
+    ts: nullableNumber(item.ts),
+    truncated: item.truncated === true || raw.length > OPAQUE_RAW_CHARS,
+    raw: boundedString(raw, OPAQUE_RAW_CHARS)
+  };
+}
 function readTranscript(value) {
   if (!Array.isArray(value)) return [];
   const result = [];
   for (const candidate of value) {
     const item = record(candidate);
-    if (!item || typeof item.id !== "string" || typeof item.text !== "string" || !ROLES.has(item.role)) continue;
+    if (!item || typeof item.id !== "string") continue;
+    if (typeof item.text !== "string" || !ROLES.has(item.role)) {
+      result.push(opaqueEntry(item));
+      continue;
+    }
     const entry = {
       id: item.id,
       role: item.role,
@@ -692,6 +724,75 @@ function readTranscript(value) {
   }
   return result;
 }
+function readParticipant(value) {
+  const participant = record(value);
+  if (!participant) return { kind: "local-user", label: null, origin: null };
+  return {
+    kind: ["local-user", "foreign", "unknown"].includes(participant.kind) ? participant.kind : "unknown",
+    label: typeof participant.label === "string" && participant.label ? boundedString(participant.label, 200) : null,
+    origin: typeof participant.origin === "string" && participant.origin ? boundedString(participant.origin, 100) : null
+  };
+}
+function readWorkspaceRef(value, fallbackPath = "") {
+  const ref = record(value);
+  if (ref && ["repo", "none", "channel"].includes(ref.kind)) {
+    return {
+      kind: ref.kind,
+      value: ref.kind === "none" ? null : typeof ref.value === "string" && ref.value ? boundedString(ref.value, 500) : null
+    };
+  }
+  return fallbackPath ? { kind: "repo", value: boundedString(fallbackPath, 500) } : { kind: "none", value: null };
+}
+function readMirror(value) {
+  const mirror = record(value);
+  if (!mirror || typeof mirror.canonicalHarness !== "string" || !mirror.canonicalHarness) return null;
+  return {
+    canonicalHarness: boundedString(mirror.canonicalHarness, 100),
+    canonicalKey: typeof mirror.canonicalKey === "string" && mirror.canonicalKey ? boundedString(mirror.canonicalKey, 300) : null,
+    bounded: mirror.bounded === true,
+    truncated: mirror.truncated === true,
+    origin: typeof mirror.origin === "string" && mirror.origin ? boundedString(mirror.origin, 200) : null
+  };
+}
+function readHolder(value) {
+  const holder = record(value);
+  if (!holder) return null;
+  const surface = typeof holder.surface === "string" && holder.surface ? boundedString(holder.surface, 100) : null;
+  return {
+    surface,
+    canTakeOver: holder.canTakeOver === true && surface !== null && surface !== "supercode"
+  };
+}
+var TRIGGER_KINDS = ["human", "channel", "cron", "heartbeat", "webhook", "parent", "api", "unknown"];
+function readTrigger(value) {
+  const trigger = record(value);
+  if (!trigger) return null;
+  const kind = trigger.kind === "manual" ? "human" : trigger.kind;
+  return {
+    kind: TRIGGER_KINDS.includes(kind) ? kind : "unknown",
+    label: typeof trigger.label === "string" && trigger.label ? boundedString(trigger.label, 200) : null,
+    surface: typeof trigger.surface === "string" && trigger.surface ? boundedString(trigger.surface, 300) : null
+  };
+}
+function readCrossSurface(value) {
+  const moved = record(value);
+  if (!moved || typeof moved.state !== "string" || !moved.state) return null;
+  return {
+    state: boundedString(moved.state, 100),
+    platform: typeof moved.platform === "string" && moved.platform ? boundedString(moved.platform, 100) : null,
+    error: typeof moved.error === "string" && moved.error ? boundedString(moved.error, 500) : null
+  };
+}
+function readRecurring(value) {
+  const recurring = record(value);
+  if (!recurring || typeof recurring.groupKey !== "string" || !recurring.groupKey) return null;
+  const runs = Number.isSafeInteger(recurring.runs) && recurring.runs > 0 ? recurring.runs : 1;
+  return {
+    groupKey: boundedString(recurring.groupKey, 300),
+    runs,
+    lastStatus: ["ok", "failed", "mixed"].includes(recurring.lastStatus) ? recurring.lastStatus : null
+  };
+}
 function readSessions(value) {
   if (!Array.isArray(value)) return [];
   return value.flatMap((raw) => {
@@ -713,7 +814,13 @@ function readSessions(value) {
       live: row.live === true,
       runtimeStatus: row.runtimeStatus === "running" || row.runtimeStatus === "busy" || row.runtimeStatus === "idle" ? row.runtimeStatus : null,
       ...Number.isSafeInteger(row.subagentCount) && row.subagentCount > 0 ? { subagentCount: row.subagentCount } : {},
-      activity: ACTIVITY_PRIORITY[row.activity] !== void 0 ? row.activity : void 0
+      activity: ACTIVITY_PRIORITY[row.activity] !== void 0 ? row.activity : void 0,
+      ...row.participant !== void 0 ? { participant: readParticipant(row.participant) } : {},
+      workspaceRef: readWorkspaceRef(row.workspaceRef, string(row.cwd)),
+      ...readMirror(row.mirror) ? { mirror: readMirror(row.mirror) } : {},
+      ...readTrigger(row.trigger) ? { trigger: readTrigger(row.trigger) } : {},
+      ...readRecurring(row.recurring) ? { recurring: readRecurring(row.recurring) } : {},
+      ...readCrossSurface(row.crossSurface) ? { crossSurface: readCrossSurface(row.crossSurface) } : {}
     }];
   });
 }
@@ -897,6 +1004,10 @@ function normalizeUiState(value) {
     canConfigureSettings: raw.canConfigureSettings === true,
     messaging: raw.messaging === "live_peer" ? "live_peer" : null,
     workspace: string(raw.workspace),
+    workspaceRef: readWorkspaceRef(raw.workspaceRef, string(raw.workspace)),
+    participant: readParticipant(raw.participant),
+    mirror: readMirror(raw.mirror),
+    holder: readHolder(raw.holder),
     taskPlan: readTaskPlan(raw.taskPlan),
     semantics: readSemantics(raw.semantics),
     terminalHandoff: readTerminalHandoff(raw.terminalHandoff),

package/components.d.ts

@@ -26,3 +26,6 @@ export {
   UiIcon,
   hasHarnessLogo,
 } from './index.js';
+
+/** Clear all session-scoped UI memory stores (drafts, queues, view choices). */
+export declare function resetSupercodeUiMemory(): void;

package/components.mjs

@@ -32,6 +32,10 @@ var EMPTY_UI_STATE = Object.freeze({
   harness: "",
   mode: "none",
   strategy: null,
+  participant: Object.freeze({ kind: "local-user", label: null, origin: null }),
+  workspaceRef: Object.freeze({ kind: "none", value: null }),
+  mirror: null,
+  holder: null,
   canSend: false,
   canSteer: false,
   canResume: false,
@@ -641,12 +645,40 @@ function readToolPresentation(value, entry) {
     matches: nullableNumber(item.matches) ?? generated.matches
   };
 }
+var OPAQUE_RAW_CHARS = 4e3;
+function opaqueEntry(item) {
+  const previouslyOpaque = item.role === "opaque";
+  let raw;
+  if (previouslyOpaque && typeof item.raw === "string") {
+    raw = item.raw;
+  } else {
+    try {
+      raw = JSON.stringify(item, null, 2) ?? "";
+    } catch {
+      raw = "[unserializable entry payload]";
+    }
+  }
+  const kind = previouslyOpaque && typeof item.kind === "string" ? item.kind : typeof item.role === "string" ? item.role : "";
+  return {
+    id: item.id,
+    role: "opaque",
+    kind: boundedString(kind, 120) || "unknown",
+    text: typeof item.text === "string" ? boundedString(item.text, OPAQUE_RAW_CHARS) : "",
+    ts: nullableNumber(item.ts),
+    truncated: item.truncated === true || raw.length > OPAQUE_RAW_CHARS,
+    raw: boundedString(raw, OPAQUE_RAW_CHARS)
+  };
+}
 function readTranscript(value) {
   if (!Array.isArray(value)) return [];
   const result = [];
   for (const candidate of value) {
     const item = record(candidate);
-    if (!item || typeof item.id !== "string" || typeof item.text !== "string" || !ROLES.has(item.role)) continue;
+    if (!item || typeof item.id !== "string") continue;
+    if (typeof item.text !== "string" || !ROLES.has(item.role)) {
+      result.push(opaqueEntry(item));
+      continue;
+    }
     const entry = {
       id: item.id,
       role: item.role,
@@ -704,6 +736,75 @@ function readTranscript(value) {
   }
   return result;
 }
+function readParticipant(value) {
+  const participant = record(value);
+  if (!participant) return { kind: "local-user", label: null, origin: null };
+  return {
+    kind: ["local-user", "foreign", "unknown"].includes(participant.kind) ? participant.kind : "unknown",
+    label: typeof participant.label === "string" && participant.label ? boundedString(participant.label, 200) : null,
+    origin: typeof participant.origin === "string" && participant.origin ? boundedString(participant.origin, 100) : null
+  };
+}
+function readWorkspaceRef(value, fallbackPath = "") {
+  const ref = record(value);
+  if (ref && ["repo", "none", "channel"].includes(ref.kind)) {
+    return {
+      kind: ref.kind,
+      value: ref.kind === "none" ? null : typeof ref.value === "string" && ref.value ? boundedString(ref.value, 500) : null
+    };
+  }
+  return fallbackPath ? { kind: "repo", value: boundedString(fallbackPath, 500) } : { kind: "none", value: null };
+}
+function readMirror(value) {
+  const mirror = record(value);
+  if (!mirror || typeof mirror.canonicalHarness !== "string" || !mirror.canonicalHarness) return null;
+  return {
+    canonicalHarness: boundedString(mirror.canonicalHarness, 100),
+    canonicalKey: typeof mirror.canonicalKey === "string" && mirror.canonicalKey ? boundedString(mirror.canonicalKey, 300) : null,
+    bounded: mirror.bounded === true,
+    truncated: mirror.truncated === true,
+    origin: typeof mirror.origin === "string" && mirror.origin ? boundedString(mirror.origin, 200) : null
+  };
+}
+function readHolder(value) {
+  const holder = record(value);
+  if (!holder) return null;
+  const surface = typeof holder.surface === "string" && holder.surface ? boundedString(holder.surface, 100) : null;
+  return {
+    surface,
+    canTakeOver: holder.canTakeOver === true && surface !== null && surface !== "supercode"
+  };
+}
+var TRIGGER_KINDS = ["human", "channel", "cron", "heartbeat", "webhook", "parent", "api", "unknown"];
+function readTrigger(value) {
+  const trigger = record(value);
+  if (!trigger) return null;
+  const kind = trigger.kind === "manual" ? "human" : trigger.kind;
+  return {
+    kind: TRIGGER_KINDS.includes(kind) ? kind : "unknown",
+    label: typeof trigger.label === "string" && trigger.label ? boundedString(trigger.label, 200) : null,
+    surface: typeof trigger.surface === "string" && trigger.surface ? boundedString(trigger.surface, 300) : null
+  };
+}
+function readCrossSurface(value) {
+  const moved = record(value);
+  if (!moved || typeof moved.state !== "string" || !moved.state) return null;
+  return {
+    state: boundedString(moved.state, 100),
+    platform: typeof moved.platform === "string" && moved.platform ? boundedString(moved.platform, 100) : null,
+    error: typeof moved.error === "string" && moved.error ? boundedString(moved.error, 500) : null
+  };
+}
+function readRecurring(value) {
+  const recurring = record(value);
+  if (!recurring || typeof recurring.groupKey !== "string" || !recurring.groupKey) return null;
+  const runs = Number.isSafeInteger(recurring.runs) && recurring.runs > 0 ? recurring.runs : 1;
+  return {
+    groupKey: boundedString(recurring.groupKey, 300),
+    runs,
+    lastStatus: ["ok", "failed", "mixed"].includes(recurring.lastStatus) ? recurring.lastStatus : null
+  };
+}
 function readSessions(value) {
   if (!Array.isArray(value)) return [];
   return value.flatMap((raw) => {
@@ -725,7 +826,13 @@ function readSessions(value) {
       live: row.live === true,
       runtimeStatus: row.runtimeStatus === "running" || row.runtimeStatus === "busy" || row.runtimeStatus === "idle" ? row.runtimeStatus : null,
       ...Number.isSafeInteger(row.subagentCount) && row.subagentCount > 0 ? { subagentCount: row.subagentCount } : {},
-      activity: ACTIVITY_PRIORITY[row.activity] !== void 0 ? row.activity : void 0
+      activity: ACTIVITY_PRIORITY[row.activity] !== void 0 ? row.activity : void 0,
+      ...row.participant !== void 0 ? { participant: readParticipant(row.participant) } : {},
+      workspaceRef: readWorkspaceRef(row.workspaceRef, string(row.cwd)),
+      ...readMirror(row.mirror) ? { mirror: readMirror(row.mirror) } : {},
+      ...readTrigger(row.trigger) ? { trigger: readTrigger(row.trigger) } : {},
+      ...readRecurring(row.recurring) ? { recurring: readRecurring(row.recurring) } : {},
+      ...readCrossSurface(row.crossSurface) ? { crossSurface: readCrossSurface(row.crossSurface) } : {}
     }];
   });
 }
@@ -909,6 +1016,10 @@ function normalizeUiState(value) {
     canConfigureSettings: raw.canConfigureSettings === true,
     messaging: raw.messaging === "live_peer" ? "live_peer" : null,
     workspace: string(raw.workspace),
+    workspaceRef: readWorkspaceRef(raw.workspaceRef, string(raw.workspace)),
+    participant: readParticipant(raw.participant),
+    mirror: readMirror(raw.mirror),
+    holder: readHolder(raw.holder),
     taskPlan: readTaskPlan(raw.taskPlan),
     semantics: readSemantics(raw.semantics),
     terminalHandoff: readTerminalHandoff(raw.terminalHandoff),
@@ -1110,6 +1221,15 @@ function isSendKey(event) {
 
 // src/memory.js
 var MEMORY_LIMIT = 100;
+var registry = /* @__PURE__ */ new Set();
+function uiMemory() {
+  const map = /* @__PURE__ */ new Map();
+  registry.add(map);
+  return map;
+}
+function resetSupercodeUiMemory() {
+  for (const map of registry) map.clear();
+}
 function boundedSet(map, key, value) {
   map.delete(key);
   map.set(key, value);
@@ -1463,7 +1583,7 @@ function MessageImages({ items, adapter }) {
 }
 
 // src/intent.js
-var CONFIRMABLE_ACTIONS = /* @__PURE__ */ new Set(["resume", "join", "branch", "reduce", "export"]);
+var CONFIRMABLE_ACTIONS = /* @__PURE__ */ new Set(["resume", "join", "branch", "reduce", "export", "take_over"]);
 async function dispatchConfirmedIntent(adapter, intent) {
   if (CONFIRMABLE_ACTIONS.has(intent.action) && adapter.confirmIntent) {
     const confirmed = await adapter.confirmIntent(intent);
@@ -1488,7 +1608,7 @@ function useAutosizeTextarea(ref, value) {
 
 // src/composer.jsx
 import { jsx as jsx3, jsxs as jsxs3 } from "preact/jsx-runtime";
-var composerMemory = /* @__PURE__ */ new Map();
+var composerMemory = uiMemory();
 function ExecutionModeSelect({ modes = [], value, onChange, disabled = false, label = "Run in" }) {
   if (modes.length < 2) return null;
   return /* @__PURE__ */ jsxs3("label", { className: "scui-execution-mode", title: disabled ? void 0 : `${label}: ${value}`, children: [
@@ -1891,7 +2011,11 @@ function languageLabel(info) {
 }
 function frameCode(render, tokens, index, options, env, self) {
   const label = markdown.utils.escapeHtml(languageLabel(tokens[index]?.info ?? ""));
-  return `<div class="scui-code-block"><div class="scui-code-head"><span>${label}</span><button class="scui-code-copy" type="button" aria-label="Copy code" title="Copy code">${COPY_ICON}<span>Copy</span></button></div>${render(tokens, index, options, env, self)}</div>`;
+  const body = render(tokens, index, options, env, self).replace(
+    "<pre>",
+    `<pre tabindex="0" role="region" aria-label="${label} code">`
+  );
+  return `<div class="scui-code-block"><div class="scui-code-head"><span>${label}</span><button class="scui-code-copy" type="button" aria-label="Copy code" title="Copy code">${COPY_ICON}<span>Copy</span></button></div>${body}</div>`;
 }
 for (const kind of ["fence", "code_block"]) {
   const render = markdown.renderer.rules[kind];
@@ -2228,6 +2352,26 @@ function TechnicalDetails({ entry }) {
   ] });
 }
 function TranscriptEntry({ entry, state, adapter }) {
+  if (entry.role === "opaque") {
+    return /* @__PURE__ */ jsxs6("article", { className: "scui-message scui-opaque", "data-role": "opaque", "data-kind": entry.kind, "aria-label": "Unrecognized entry", children: [
+      /* @__PURE__ */ jsxs6("div", { className: "scui-notice", "data-code": "opaque-entry", children: [
+        "Unrecognized entry kind ",
+        /* @__PURE__ */ jsx7("code", { children: entry.kind }),
+        " \u2014 kept as-is, nothing dropped"
+      ] }),
+      entry.text ? /* @__PURE__ */ jsx7(Markdown, { value: entry.text, copyText: adapter?.copyText }) : null,
+      entry.raw ? /* @__PURE__ */ jsxs6("details", { className: "scui-tool-technical", children: [
+        /* @__PURE__ */ jsx7("summary", { children: "Technical details" }),
+        /* @__PURE__ */ jsx7("div", { children: /* @__PURE__ */ jsxs6("section", { children: [
+          /* @__PURE__ */ jsx7("strong", { children: "Raw entry" }),
+          /* @__PURE__ */ jsxs6("pre", { children: [
+            entry.raw,
+            entry.truncated ? "\n[truncated]" : ""
+          ] })
+        ] }) })
+      ] }) : null
+    ] });
+  }
   if (entry.role === "request") return /* @__PURE__ */ jsx7(RequestCard, { entry, adapter, canRespond: state.canRespond });
   if (entry.role === "reasoning") {
     return /* @__PURE__ */ jsxs6("details", { className: "scui-reasoning", open: entry.streaming, children: [
@@ -2357,7 +2501,7 @@ function SessionDetails({ semantics }) {
     ] })
   ] });
 }
-var conversationMemory = /* @__PURE__ */ new Map();
+var conversationMemory = uiMemory();
 function ConversationAnnouncements({ state }) {
   const previousBusy = useRef4(state.busy);
   const [announcement, setAnnouncement] = useState3("");
@@ -2476,7 +2620,7 @@ import { useEffect as useEffect9, useId as useId3, useMemo as useMemo3, useRef a
 // src/sessions.jsx
 import { useEffect as useEffect6, useLayoutEffect as useLayoutEffect3, useRef as useRef5, useState as useState4 } from "preact/hooks";
 import { jsx as jsx8, jsxs as jsxs7 } from "preact/jsx-runtime";
-var sessionListMemory = /* @__PURE__ */ new Map();
+var sessionListMemory = uiMemory();
 function sessionPathParts(value) {
   const complete = String(value ?? "").replaceAll("\\", "/");
   const boundary = complete.lastIndexOf("/");
@@ -2498,11 +2642,55 @@ function SessionRow({ row, state, onOpen, onOpenSubagents, now = Date.now() }) {
   const unreadCount = attention?.unreadCount ?? 0;
   const unreadLabel = unreadCount > 99 ? "99+" : String(unreadCount);
   const age = relativeAge(row.previewUpdatedAt ?? row.updatedAt, now) || row.age;
-  return /* @__PURE__ */ jsxs7("article", { className: "scui-session", "data-active": row.active, "data-activity": activity, "data-writable": row.writable, children: [
+  const nounBadges = [];
+  if (row.trigger && row.trigger.kind !== "manual" && row.trigger.kind !== "human") {
+    const runs = row.recurring?.runs;
+    const detail = row.trigger.label || row.trigger.surface || "";
+    nounBadges.push(
+      /* @__PURE__ */ jsxs7("small", { className: "scui-session-noun", "data-noun": "trigger", "data-kind": row.trigger.kind, "data-surface": row.trigger.surface ?? void 0, "data-status": row.recurring?.lastStatus ?? void 0, children: [
+        row.trigger.kind,
+        detail ? ` \xB7 ${detail}` : "",
+        runs && runs > 1 ? ` \xB7 \xD7${runs}` : ""
+      ] }, "trigger")
+    );
+  }
+  if (row.crossSurface) {
+    nounBadges.push(
+      /* @__PURE__ */ jsxs7("small", { className: "scui-session-noun", "data-noun": "cross-surface", "data-state": row.crossSurface.state, title: row.crossSurface.error ?? void 0, children: [
+        "\u2192",
+        row.crossSurface.platform ?? "elsewhere",
+        " \xB7 ",
+        row.crossSurface.state
+      ] }, "cross-surface")
+    );
+  }
+  if (row.participant && row.participant.kind !== "local-user") {
+    nounBadges.push(
+      /* @__PURE__ */ jsx8("small", { className: "scui-session-noun", "data-noun": "participant", "data-kind": row.participant.kind, children: row.participant.kind === "foreign" ? `${row.participant.label ?? "someone else"}${row.participant.origin ? ` via ${row.participant.origin}` : ""}` : "unknown participant" }, "participant")
+    );
+  }
+  if (row.mirror) {
+    nounBadges.push(
+      /* @__PURE__ */ jsxs7("small", { className: "scui-session-noun", "data-noun": "mirror", "data-truncated": row.mirror.truncated, children: [
+        "mirror of ",
+        harnessDisplayName(row.mirror.canonicalHarness)
+      ] }, "mirror")
+    );
+  }
+  if (row.workspaceRef?.kind === "channel") {
+    nounBadges.push(
+      /* @__PURE__ */ jsxs7("small", { className: "scui-session-noun", "data-noun": "workspace", "data-kind": "channel", children: [
+        "#",
+        row.workspaceRef.value ?? "channel"
+      ] }, "workspace")
+    );
+  }
+  return /* @__PURE__ */ jsxs7("article", { className: "scui-session", "data-active": row.active, "data-activity": activity, "data-writable": row.writable, "data-workspace-kind": row.workspaceRef?.kind, children: [
     /* @__PURE__ */ jsxs7("button", { className: "scui-session-main", "data-session-key": row.key, type: "button", "aria-label": `${title} \xB7 ${harnessDisplayName(row.harness)}${row.writable ? "" : " \xB7 Read-only"}${working ? " \xB7 Working" : ""}${path.complete ? ` \xB7 ${path.complete}` : ""}${preview ? ` \xB7 ${preview}` : ""}${unreadCount ? ` \xB7 ${unreadCount} unread` : ""}${age ? ` \xB7 ${age}` : ""}`, "aria-current": row.active ? "true" : void 0, onClick: () => onOpen(row), children: [
       /* @__PURE__ */ jsx8(HarnessLogo, { id: row.harness, activity, size: 34 }),
       /* @__PURE__ */ jsxs7("span", { className: "scui-session-copy", children: [
         /* @__PURE__ */ jsx8("span", { className: "scui-session-title", children: /* @__PURE__ */ jsx8("strong", { children: title }) }),
+        nounBadges.length ? /* @__PURE__ */ jsx8("span", { className: "scui-session-nouns", children: nounBadges }) : null,
         path.complete ? /* @__PURE__ */ jsxs7("small", { className: "scui-session-path", title: row.cwd, children: [
           /* @__PURE__ */ jsx8("span", { className: "scui-session-path-leading", children: path.leading }),
           path.separator ? /* @__PURE__ */ jsx8("span", { className: "scui-session-path-separator", children: path.separator }) : null,
@@ -2917,10 +3105,54 @@ function HarnessPicker({ harnesses, state, value, disabled = false, adapter, onC
 
 // src/messenger.jsx
 import { Fragment as Fragment5, jsx as jsx11, jsxs as jsxs10 } from "preact/jsx-runtime";
-var pendingMessageMemory = /* @__PURE__ */ new Map();
-var messengerViewMemory = /* @__PURE__ */ new Map();
-var newChatMemory = /* @__PURE__ */ new Map();
+var pendingMessageMemory = uiMemory();
+var messengerViewMemory = uiMemory();
+var newChatMemory = uiMemory();
 var TRACKED_ACTIONS = /* @__PURE__ */ new Set(["resume", "join", "detach", "branch", "reduce", "terminal", "export", "steer", "interrupt", "respond", "configureHarness", "refresh", "loadEarlier", "loadSessions"]);
+function UniversalNouns({ state, adapter }) {
+  const banners = [];
+  if (state.participant && state.participant.kind !== "local-user") {
+    banners.push(
+      /* @__PURE__ */ jsx11("div", { className: "scui-notice scui-noun-banner", "data-noun": "participant", "data-kind": state.participant.kind, children: state.participant.kind === "foreign" ? /* @__PURE__ */ jsxs10(Fragment5, { children: [
+        "This is ",
+        /* @__PURE__ */ jsx11("strong", { children: state.participant.label ?? "someone else's" }),
+        " conversation",
+        state.participant.origin ? /* @__PURE__ */ jsxs10(Fragment5, { children: [
+          " via ",
+          state.participant.origin
+        ] }) : null,
+        "."
+      ] }) : /* @__PURE__ */ jsx11(Fragment5, { children: "Unknown participant \u2014 this conversation was not started here." }) }, "participant")
+    );
+  }
+  if (state.mirror) {
+    banners.push(
+      /* @__PURE__ */ jsxs10("div", { className: "scui-notice scui-noun-banner", "data-noun": "mirror", "data-truncated": state.mirror.truncated, children: [
+        state.mirror.bounded ? "Bounded mirror" : "Mirror",
+        " of a ",
+        /* @__PURE__ */ jsx11("strong", { children: harnessDisplayName(state.mirror.canonicalHarness) }),
+        " session \u2014 the canonical record lives in its own store",
+        state.mirror.truncated ? " (truncated here)" : "",
+        ".",
+        state.mirror.canonicalKey ? /* @__PURE__ */ jsx11("button", { type: "button", onClick: () => adapter.onIntent({ action: "open_session", key: state.mirror.canonicalKey }), children: "Open canonical session" }) : null
+      ] }, "mirror")
+    );
+  }
+  if (state.holder && state.holder.surface !== "supercode") {
+    banners.push(
+      /* @__PURE__ */ jsxs10("div", { className: "scui-notice scui-noun-banner", "data-noun": "holder", "data-surface": state.holder.surface ?? "unheld", children: [
+        state.holder.surface ? /* @__PURE__ */ jsxs10(Fragment5, { children: [
+          "Held by ",
+          /* @__PURE__ */ jsx11("strong", { children: state.holder.surface }),
+          " right now."
+        ] }) : /* @__PURE__ */ jsx11(Fragment5, { children: "No surface holds this session right now." }),
+        state.holder.canTakeOver ? /* @__PURE__ */ jsx11("button", { type: "button", onClick: () => dispatchConfirmedIntent(adapter, { action: "take_over" }), children: "Take over" }) : null
+      ] }, "holder")
+    );
+  }
+  if (!banners.length) return null;
+  return /* @__PURE__ */ jsx11("div", { className: "scui-noun-banners", children: banners });
+}
 function Receipt({ state, adapter }) {
   const receipt = state.reductionReceipt;
   if (receipt) return /* @__PURE__ */ jsx11("div", { className: "scui-receipt", children: /* @__PURE__ */ jsxs10("span", { children: [
@@ -3184,6 +3416,7 @@ function Chat({ state, adapter, onBack, onNew, onClose, components, slots, label
       state.recoverable ? /* @__PURE__ */ jsx11("button", { type: "button", disabled: Boolean(action), onClick: () => trackedAdapter.onIntent({ action: "refresh" }), children: "Retry" }) : null
     ] }) : null,
     /* @__PURE__ */ jsx11(Receipt, { state, adapter }),
+    /* @__PURE__ */ jsx11(UniversalNouns, { state: actionState, adapter: trackedAdapter }),
     /* @__PURE__ */ jsx11(Conversation, { state: actionState, adapter: trackedAdapter, components, slots, memoryKey, pending: pendingMessage, unreadAfterMessages }, memoryKey),
     /* @__PURE__ */ jsx11(ContinuationBar, { state: actionState, adapter: trackedAdapter, labels }),
     /* @__PURE__ */ jsx11(Advisory, { state: actionState, adapter: trackedAdapter, value: state.interopSettings?.advisories[0] ?? null, onReview: (recommendedChange) => setSettings({ recommendedChange }) }),
@@ -3558,5 +3791,6 @@ export {
   TranscriptEntry,
   UiIcon,
   harnessLogoDataUrl,
-  hasHarnessLogo
+  hasHarnessLogo,
+  resetSupercodeUiMemory
 };

package/composer.mjs

@@ -32,6 +32,10 @@ var EMPTY_UI_STATE = Object.freeze({
   harness: "",
   mode: "none",
   strategy: null,
+  participant: Object.freeze({ kind: "local-user", label: null, origin: null }),
+  workspaceRef: Object.freeze({ kind: "none", value: null }),
+  mirror: null,
+  holder: null,
   canSend: false,
   canSteer: false,
   canResume: false,
@@ -100,6 +104,12 @@ function isSendKey(event) {
 
 // src/memory.js
 var MEMORY_LIMIT = 100;
+var registry = /* @__PURE__ */ new Set();
+function uiMemory() {
+  const map = /* @__PURE__ */ new Map();
+  registry.add(map);
+  return map;
+}
 function boundedSet(map, key, value) {
   map.delete(key);
   map.set(key, value);
@@ -289,7 +299,7 @@ function ImageTray({ items, onRemove }) {
 }
 
 // src/intent.js
-var CONFIRMABLE_ACTIONS = /* @__PURE__ */ new Set(["resume", "join", "branch", "reduce", "export"]);
+var CONFIRMABLE_ACTIONS = /* @__PURE__ */ new Set(["resume", "join", "branch", "reduce", "export", "take_over"]);
 async function dispatchConfirmedIntent(adapter, intent) {
   if (CONFIRMABLE_ACTIONS.has(intent.action) && adapter.confirmIntent) {
     const confirmed = await adapter.confirmIntent(intent);
@@ -314,7 +324,7 @@ function useAutosizeTextarea(ref, value) {
 
 // src/composer.jsx
 import { jsx as jsx3, jsxs as jsxs3 } from "preact/jsx-runtime";
-var composerMemory = /* @__PURE__ */ new Map();
+var composerMemory = uiMemory();
 function ExecutionModeSelect({ modes = [], value, onChange, disabled = false, label = "Run in" }) {
   if (modes.length < 2) return null;
   return /* @__PURE__ */ jsxs3("label", { className: "scui-execution-mode", title: disabled ? void 0 : `${label}: ${value}`, children: [

package/controller.d.ts

@@ -9,6 +9,7 @@ import type {
   SupercodeController,
 } from '@volter-ai-dev/supercode-client';
 import type {
+  TranscriptEntryModel,
   AttachedSessionModel,
   ContinuationMode,
   SessionAttention,
@@ -19,6 +20,9 @@ import type {
   UiAdapter,
 } from './index.js';
 
+/** `after`: a conversation entry id (row follows it), `'^'` (before everything), or null/absent (at the end). */
+export type HostTranscriptEntry = TranscriptEntryModel & { after?: string | null };
+
 export interface ClientProjectionOptions {
   now?: number;
   /** Maximum rendered conversation rows after hidden context is removed. Default 120. */
@@ -49,6 +53,9 @@ export interface ClientProjectionOptions {
   continuationModes?: ContinuationMode[];
   /** Trusted-host inventory and lifecycle overlays (for example a machine-wide session catalog). */
   sessions?: SessionRowModel[];
+  /** Host-owned rows placed inside the conversation: after the conversation entry `after` names,
+   * or at the end. The conversation's own order is never changed; ids already present are skipped. */
+  hostEntries?: readonly HostTranscriptEntry[];
   attached?: AttachedSessionModel | null;
   owned?: AttachedSessionModel | null;
   attachError?: SupercodeUiState['attachError'];

package/controller.mjs

@@ -509,6 +509,39 @@ function projectPill(snapshot) {
   return { tone: 'live', label: text(`${label(harness)} ready`) };
 }
 
+/** A host's own rows — display objects an app printed, notices the host raised —
+ * inside the conversation at the position the host names: after a conversation
+ * entry by id, or at the end. The conversation's own order is never changed. */
+function withHostEntries(transcript, hostEntries) {
+  if (!Array.isArray(hostEntries) || hostEntries.length === 0) return transcript;
+  const out = [...transcript];
+  const tail = [];
+  for (const raw of hostEntries) {
+    if (!raw || typeof raw !== 'object' || typeof raw.id !== 'string') continue;
+    const { after, ...entry } = raw;
+    if (out.some((item) => item.id === entry.id)) continue;
+    if (after === '^') {
+      // before everything, in the given order
+      let at = 0;
+      while (at < out.length && out[at].__hostAfter === '^') at += 1;
+      out.splice(at, 0, { ...entry, __hostAfter: '^' });
+      continue;
+    }
+    const index = typeof after === 'string' ? out.findIndex((item) => item.id === after) : -1;
+    if (index >= 0) {
+      // keep host rows that share an anchor in their given order
+      let at = index + 1;
+      while (at < out.length && out[at].__hostAfter === after) at += 1;
+      out.splice(at, 0, { ...entry, __hostAfter: after });
+    } else tail.push(entry);
+  }
+  return [...out, ...tail].map((item) => {
+    if (!('__hostAfter' in item)) return item;
+    const { __hostAfter: _anchor, ...clean } = item;
+    return clean;
+  });
+}
+
 function projectClientSnapshotInternal(snapshot, options, imageRegistry) {
   const now = Number.isFinite(options.now) ? options.now : Date.now();
   const busy = ['running', 'interrupting', 'reconciling'].includes(snapshot.turn?.state);
@@ -559,7 +592,10 @@ function projectClientSnapshotInternal(snapshot, options, imageRegistry) {
     ? snapshot.connection?.ownsRuntime ? active : null
     : options.owned;
   const maxEntries = positiveInteger(options.maxEntries, DEFAULT_MAX_ENTRIES);
-  const transcript = projectConversation(snapshot.conversation ?? [], options, imageRegistry);
+  const transcript = withHostEntries(
+    projectConversation(snapshot.conversation ?? [], options, imageRegistry),
+    options.hostEntries,
+  );
   const startup = snapshot.availability === 'loading'
     ? snapshot.operation === 'start' ? 'starting' : snapshot.operation === 'refresh' ? 'discovering' : 'connecting'
     : 'ready';