@volter-ai-dev/supercode-ui 0.1.44 → 0.1.46

package/README.md

@@ -183,15 +183,16 @@ drafts, and artifact materialization remain explicit callbacks. A
 browser should receive projected state from a trusted host rather than instantiate a local
 controller or gain filesystem authority.
 
-Native continuation is headless by default. A host with a real terminal provider can add
-`terminal` to `continuationModes` and handle `onResumeTerminal`; the continuation bar then exposes
-that strategy beside “Continue here.” The UI never infers terminal support from a generic runtime
-handoff, and never presents a terminal strategy when the host cannot create one.
+Native continuation exposes one action and a quiet execution-transport selector. A host with a real
+terminal provider can add `terminal` to `continuationModes` and handle `onResumeTerminal`; Terminal
+is then the initial choice and Headless remains available from the selector. The UI never infers
+terminal support from a generic runtime handoff, and never presents a terminal transport when the
+host cannot create one.
 
 New-session execution is advertised per harness. Set `launchModes: ['headless', 'terminal']` and
-`preferredLaunchMode` on a `HarnessOption`; the complete messenger renders a compact “Chat” versus
-“Terminal” choice and emits that `mode` on the `new` intent. Direct controller bindings keep Chat as
-the standard path and delegate Terminal only through `onStartTerminal`, so a terminal selection can
+`preferredLaunchMode` on a `HarnessOption`; the complete messenger renders the same compact Terminal
+versus Headless selector in the composer footer and emits that `mode` on the `new` intent. Direct
+controller bindings delegate Terminal only through `onStartTerminal`, so a terminal selection can
 never accidentally create a second headless runtime. Hosts may remember the preference per harness;
 the messenger also retains the current browser draft choice while its New Chat view is open.
 
@@ -204,7 +205,9 @@ and can overlay a machine-wide session inventory, pagination state, attention, d
 errors, and owned/attached identities without reimplementing transcript or capability semantics.
 `projectSessionInventory` performs the corresponding title, latest-preview, activity, path, age,
 sorting, and row projection for raw machine-wide descriptors; the trusted host supplies only its
-opaque-key callback and retains the reversible locator map.
+opaque-key callback and retains the reversible locator map. Its `isWritable` capability callback
+is fail-closed: observed sessions remain neutral read-only channels until the host proves a real
+send or terminal-control path.
 
 ## Modularity contract
 

package/activity.mjs

@@ -554,6 +554,7 @@ function readSessions(value) {
       updatedAt: nullableNumber(row.updatedAt),
       messages: nullableNumber(row.messages),
       active: row.active === true,
+      writable: row.writable === true,
       live: row.live === true,
       runtimeStatus: row.runtimeStatus === "running" || row.runtimeStatus === "busy" || row.runtimeStatus === "idle" ? row.runtimeStatus : null
     }];
@@ -738,7 +739,7 @@ function normalizeUiState(value) {
       if (!item || typeof item.id !== "string") return [];
       const startable = item.startable === true;
       const launchModes = Array.isArray(item.launchModes) ? [...new Set(item.launchModes.filter((mode) => mode === "headless" || mode === "terminal"))] : startable ? ["headless"] : [];
-      const preferredLaunchMode = launchModes.includes(item.preferredLaunchMode) ? item.preferredLaunchMode : launchModes[0] ?? null;
+      const preferredLaunchMode = launchModes.includes(item.preferredLaunchMode) ? item.preferredLaunchMode : launchModes.includes("terminal") ? "terminal" : launchModes[0] ?? null;
       const capabilities = record(item.capabilities);
       return [{
         id: item.id,
@@ -783,6 +784,7 @@ function sessionDisplayName(session) {
   return title && title !== session.name ? title : session.name || "Untitled chat";
 }
 function sessionActivity(state, row) {
+  if (!row.writable) return "observed";
   if (state.needsInput && row.active) return "needs-input";
   if (state.busy && row.active) return "working";
   if (row.runtimeStatus === "busy") return "working";
@@ -800,6 +802,7 @@ var ACTIVITY_PRIORITY = Object.freeze({
   finished: 30,
   running: 20,
   recent: 10,
+  observed: 0,
   idle: 0
 });
 function activityDetail(activity, preview, pill) {
@@ -810,6 +813,7 @@ function activityDetail(activity, preview, pill) {
   if (activity === "finished") return "Finished";
   if (activity === "unseen") return "New reply";
   if (activity === "running") return "Session is running";
+  if (activity === "observed") return "Read-only channel";
   return pill || "Agent chats";
 }
 function projectAgentActivity(value) {

package/components.d.ts

@@ -6,6 +6,7 @@ export {
   ContextCandidate,
   ContextCandidates,
   ContinuationBar,
+  ExecutionModeSelect,
   Conversation,
   HarnessLogo,
   HarnessPicker,

package/components.mjs

@@ -566,6 +566,7 @@ function readSessions(value) {
       updatedAt: nullableNumber(row.updatedAt),
       messages: nullableNumber(row.messages),
       active: row.active === true,
+      writable: row.writable === true,
       live: row.live === true,
       runtimeStatus: row.runtimeStatus === "running" || row.runtimeStatus === "busy" || row.runtimeStatus === "idle" ? row.runtimeStatus : null
     }];
@@ -750,7 +751,7 @@ function normalizeUiState(value) {
       if (!item || typeof item.id !== "string") return [];
       const startable = item.startable === true;
       const launchModes = Array.isArray(item.launchModes) ? [...new Set(item.launchModes.filter((mode) => mode === "headless" || mode === "terminal"))] : startable ? ["headless"] : [];
-      const preferredLaunchMode = launchModes.includes(item.preferredLaunchMode) ? item.preferredLaunchMode : launchModes[0] ?? null;
+      const preferredLaunchMode = launchModes.includes(item.preferredLaunchMode) ? item.preferredLaunchMode : launchModes.includes("terminal") ? "terminal" : launchModes[0] ?? null;
       const capabilities = record(item.capabilities);
       return [{
         id: item.id,
@@ -795,6 +796,7 @@ function sessionDisplayName(session) {
   return title && title !== session.name ? title : session.name || "Untitled chat";
 }
 function sessionActivity(state, row) {
+  if (!row.writable) return "observed";
   if (state.needsInput && row.active) return "needs-input";
   if (state.busy && row.active) return "working";
   if (row.runtimeStatus === "busy") return "working";
@@ -812,6 +814,7 @@ var ACTIVITY_PRIORITY = Object.freeze({
   finished: 30,
   running: 20,
   recent: 10,
+  observed: 0,
   idle: 0
 });
 function activityDetail(activity, preview, pill) {
@@ -822,6 +825,7 @@ function activityDetail(activity, preview, pill) {
   if (activity === "finished") return "Finished";
   if (activity === "unseen") return "New reply";
   if (activity === "running") return "Session is running";
+  if (activity === "observed") return "Read-only channel";
   return pill || "Agent chats";
 }
 function projectAgentActivity(value) {
@@ -1294,13 +1298,23 @@ function useAutosizeTextarea(ref, value) {
 // src/composer.jsx
 import { jsx as jsx3, jsxs as jsxs3 } from "preact/jsx-runtime";
 var composerMemory = /* @__PURE__ */ new Map();
+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: [
+    /* @__PURE__ */ jsx3("span", { children: label }),
+    /* @__PURE__ */ jsx3("select", { "aria-label": label, value, disabled, onChange: (event) => onChange?.(event.currentTarget.value), children: modes.map((mode) => /* @__PURE__ */ jsx3("option", { value: mode, children: mode === "terminal" ? "Terminal" : "Headless" }, mode)) })
+  ] });
+}
 function ContinuationBar({ state, adapter, labels = DEFAULT_LABELS }) {
+  const continuationModes = state.continuationModes?.length ? state.continuationModes : ["headless"];
+  const [selection, setSelection] = useState2({ key: null, mode: null });
+  const requestedMode = selection.key === state.attached?.key ? selection.mode : null;
+  const executionMode = continuationModes.includes(requestedMode) ? requestedMode : continuationModes.includes("terminal") ? "terminal" : continuationModes[0];
   if (state.mode !== "mirror" || state.canSend) return null;
   const attached = state.attached;
   const row = attached?.key ? state.sessions.find((item) => item.key === attached.key) : null;
   const activeElsewhere = row?.runtimeStatus === "running" || row?.runtimeStatus === "busy" || row?.runtimeStatus === "idle";
   const resume = canContinueHere(state);
-  const terminal = resume && state.continuationModes?.includes("terminal");
   const join = state.canAttach;
   const branch = state.canBranch;
   if (!resume && !join && !branch) return /* @__PURE__ */ jsx3("div", { className: "scui-continuation", children: /* @__PURE__ */ jsxs3("span", { children: [
@@ -1313,8 +1327,8 @@ function ContinuationBar({ state, adapter, labels = DEFAULT_LABELS }) {
       /* @__PURE__ */ jsx3("small", { children: join ? "Join the proven live runtime without taking it over." : resume ? `Resume this ${harnessDisplayName(state.harness)} session here.` : "Start an independent continuation." })
     ] }),
     /* @__PURE__ */ jsxs3("span", { className: "scui-continuation-actions", children: [
-      /* @__PURE__ */ jsx3("button", { type: "button", disabled: Boolean(state.operation), onClick: () => dispatchConfirmedIntent(adapter, join ? { action: "join" } : resume ? { action: "resume", mode: "headless" } : { action: "branch" }), children: join ? labels.joinLive : resume ? labels.continueHere : labels.forkHere }),
-      terminal ? /* @__PURE__ */ jsx3("button", { type: "button", className: "scui-secondary", disabled: Boolean(state.operation), onClick: () => dispatchConfirmedIntent(adapter, { action: "resume", mode: "terminal" }), children: labels.continueWithTerminal ?? DEFAULT_LABELS.continueWithTerminal }) : null
+      !join && resume ? /* @__PURE__ */ jsx3(ExecutionModeSelect, { modes: continuationModes, value: executionMode, disabled: Boolean(state.operation), onChange: (mode) => setSelection({ key: state.attached?.key ?? null, mode }) }) : null,
+      /* @__PURE__ */ jsx3("button", { type: "button", disabled: Boolean(state.operation), onClick: () => dispatchConfirmedIntent(adapter, join ? { action: "join" } : resume ? { action: "resume", mode: executionMode } : { action: "branch" }), children: join ? labels.joinLive : resume ? labels.continueHere : labels.forkHere })
     ] })
   ] });
 }
@@ -2289,7 +2303,7 @@ function SessionRow({ row, state, onOpen, 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("button", { className: "scui-session", "data-active": row.active, "data-activity": activity, "data-session-key": row.key, type: "button", "aria-label": `${title} \xB7 ${harnessDisplayName(row.harness)}${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: [
+  return /* @__PURE__ */ jsxs7("button", { className: "scui-session", "data-active": row.active, "data-activity": activity, "data-writable": row.writable, "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__ */ jsxs7("span", { className: "scui-session-title", children: [
@@ -2870,7 +2884,8 @@ function NewChat({ state, adapter, onBack, onClose, onStarted, labels, memoryKey
   const Readiness = components.HarnessReadiness ?? HarnessReadiness;
   const launchModes = selectedHarness?.launchModes?.length ? selectedHarness.launchModes : ["headless"];
   const rememberedMode = modes[harness];
-  const mode = launchModes.includes(rememberedMode) ? rememberedMode : launchModes.includes(selectedHarness?.preferredLaunchMode) ? selectedHarness.preferredLaunchMode : launchModes[0];
+  const requestedMode = launchModes.includes(rememberedMode) ? rememberedMode : launchModes.includes(selectedHarness?.preferredLaunchMode) ? selectedHarness.preferredLaunchMode : launchModes[0];
+  const mode = (context.length > 0 || images.length > 0) && launchModes.includes("headless") ? "headless" : requestedMode;
   const terminalAttachments = mode === "terminal" && (context.length > 0 || images.length > 0);
   const remember = (overrides = {}) => boundedSet(newChatMemory, memoryKey, { harness, draft, context, images, modes, ...overrides });
   useAutosizeTextarea(textarea, draft);
@@ -2912,7 +2927,7 @@ function NewChat({ state, adapter, onBack, onClose, onStarted, labels, memoryKey
     lastComposerCommand.current = composerCommand.id;
     if (composerCommand.action === "attach") {
       if (mode === "terminal" && !launchModes.includes("headless")) {
-        setPickerError("Terminal starts currently accept text only. Choose Chat to attach context or images.");
+        setPickerError("Terminal starts currently accept text only. Choose Headless to attach context or images.");
       } else {
         try {
           const attachments = partitionAttachments(composerCommand.attachments);
@@ -2920,12 +2935,10 @@ function NewChat({ state, adapter, onBack, onClose, onStarted, labels, memoryKey
           if (images.length + attachments.images.length > MAX_IMAGE_ITEMS) throw new Error(`Attach at most ${MAX_IMAGE_ITEMS} images.`);
           const nextContext = mergeContext(context, attachments.context);
           const nextImages = mergeImages(images, attachments.images);
-          const nextModes = mode === "terminal" ? { ...modes, [harness]: "headless" } : modes;
-          if (nextModes !== modes) setModes(nextModes);
           setContext(nextContext);
           setImages(nextImages);
           setPickerError(null);
-          remember({ context: nextContext, images: nextImages, modes: nextModes });
+          remember({ context: nextContext, images: nextImages });
         } catch (error) {
           setPickerError(error instanceof Error ? error.message : "Could not attach context.");
         }
@@ -2966,7 +2979,7 @@ function NewChat({ state, adapter, onBack, onClose, onStarted, labels, memoryKey
     const allFiles = Array.from(value ?? []);
     if (!allFiles.length) return false;
     if (mode === "terminal") {
-      setPickerError("Terminal starts currently accept text only. Choose Chat to attach context or images.");
+      setPickerError("Terminal starts currently accept text only. Choose Headless to attach context or images.");
       return true;
     }
     const files = allFiles.filter((file) => file.type.startsWith("image/"));
@@ -3031,21 +3044,6 @@ function NewChat({ state, adapter, onBack, onClose, onStarted, labels, memoryKey
     ] }),
     /* @__PURE__ */ jsxs9("div", { className: "scui-compose", children: [
       /* @__PURE__ */ jsx10(Readiness, { harnesses: state.harnesses, state, adapter }),
-      launchModes.length > 1 ? /* @__PURE__ */ jsxs9("fieldset", { className: "scui-launch-modes", disabled: Boolean(starting), children: [
-        /* @__PURE__ */ jsx10("legend", { children: "Run as" }),
-        launchModes.map((item) => /* @__PURE__ */ jsxs9("label", { children: [
-          /* @__PURE__ */ jsx10("input", { type: "radio", name: `launch-mode-${memoryKey}`, value: item, checked: mode === item, onChange: () => {
-            const next = { ...modes, [harness]: item };
-            setModes(next);
-            setPickerError(null);
-            remember({ modes: next });
-          } }),
-          /* @__PURE__ */ jsxs9("span", { children: [
-            /* @__PURE__ */ jsx10("strong", { children: item === "terminal" ? "Terminal" : "Chat" }),
-            /* @__PURE__ */ jsx10("small", { children: item === "terminal" ? "Interactive tmux session" : "Managed here" })
-          ] })
-        ] }, item))
-      ] }) : null,
       mode !== "terminal" ? /* @__PURE__ */ jsx10(ContextCandidates, { items: contextCandidates, context, images, state, adapter, onAttach: attachCandidate, component: components.ContextCandidate }) : null,
       /* @__PURE__ */ jsx10(ImageTray, { items: images, onRemove: (index) => setImages((items) => {
         const next = items.filter((_, itemIndex) => itemIndex !== index);
@@ -3057,7 +3055,7 @@ function NewChat({ state, adapter, onBack, onClose, onStarted, labels, memoryKey
         remember({ context: next });
         return next;
       }) }),
-      terminalAttachments ? /* @__PURE__ */ jsx10("small", { className: "scui-context-error", role: "alert", children: "Terminal starts currently accept text only. Remove attachments or choose Chat." }) : pickerError ? /* @__PURE__ */ jsx10("small", { className: "scui-context-error", role: "alert", children: pickerError }) : null,
+      terminalAttachments ? /* @__PURE__ */ jsx10("small", { className: "scui-context-error", role: "alert", children: "Terminal starts currently accept text only. Remove attachments or choose Headless." }) : pickerError ? /* @__PURE__ */ jsx10("small", { className: "scui-context-error", role: "alert", children: pickerError }) : null,
       /* @__PURE__ */ jsxs9("div", { className: `scui-envelope scui-new-envelope${dragging ? " scui-drop-target" : ""}`, onDragEnter: (event) => {
         if (Array.from(event.dataTransfer?.types ?? []).includes("Files")) {
           event.preventDefault();
@@ -3084,7 +3082,13 @@ function NewChat({ state, adapter, onBack, onClose, onStarted, labels, memoryKey
             setHarness(value);
             remember({ harness: value });
           } }),
-          /* @__PURE__ */ jsx10("span", { children: /* @__PURE__ */ jsx10("button", { type: "button", className: "scui-send", "aria-label": mode === "terminal" ? "Start terminal session" : "Start chat", disabled: !draft.trim() && !images.length || !harness || Boolean(starting) || terminalAttachments || mode === "terminal" && !draft.trim(), onClick: send, children: starting ? /* @__PURE__ */ jsx10("i", { className: "scui-control-spinner" }) : /* @__PURE__ */ jsx10(UiIcon, { name: "send", size: 17 }) }) })
+          /* @__PURE__ */ jsx10(ExecutionModeSelect, { modes: launchModes, value: mode, disabled: Boolean(starting) || mode !== requestedMode, onChange: (item) => {
+            const next = { ...modes, [harness]: item };
+            setModes(next);
+            setPickerError(null);
+            remember({ modes: next });
+          } }),
+          /* @__PURE__ */ jsx10("span", { children: /* @__PURE__ */ jsx10("button", { type: "button", className: "scui-send", "aria-label": mode === "terminal" ? "Start terminal session" : "Start headless session", disabled: !draft.trim() && !images.length || !harness || Boolean(starting) || terminalAttachments || mode === "terminal" && !draft.trim(), onClick: send, children: starting ? /* @__PURE__ */ jsx10("i", { className: "scui-control-spinner" }) : /* @__PURE__ */ jsx10(UiIcon, { name: "send", size: 17 }) }) })
         ] })
       ] })
     ] })
@@ -3193,6 +3197,7 @@ export {
   ContextCandidates,
   ContinuationBar,
   Conversation,
+  ExecutionModeSelect,
   HarnessAdvisory,
   HarnessLogo,
   HarnessPicker,

package/composer.d.ts

@@ -1,2 +1,2 @@
 export type { MessengerLabels, PendingMessageModel, SupercodeUiState, UiAdapter } from './index.js';
-export { Composer, ContinuationBar } from './index.js';
+export { Composer, ContinuationBar, ExecutionModeSelect } from './index.js';

package/composer.mjs

@@ -77,6 +77,7 @@ var ACTIVITY_PRIORITY = Object.freeze({
   finished: 30,
   running: 20,
   recent: 10,
+  observed: 0,
   idle: 0
 });
 function canContinueHere(state) {
@@ -295,13 +296,23 @@ function useAutosizeTextarea(ref, value) {
 // src/composer.jsx
 import { jsx as jsx3, jsxs as jsxs3 } from "preact/jsx-runtime";
 var composerMemory = /* @__PURE__ */ new Map();
+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: [
+    /* @__PURE__ */ jsx3("span", { children: label }),
+    /* @__PURE__ */ jsx3("select", { "aria-label": label, value, disabled, onChange: (event) => onChange?.(event.currentTarget.value), children: modes.map((mode) => /* @__PURE__ */ jsx3("option", { value: mode, children: mode === "terminal" ? "Terminal" : "Headless" }, mode)) })
+  ] });
+}
 function ContinuationBar({ state, adapter, labels = DEFAULT_LABELS }) {
+  const continuationModes = state.continuationModes?.length ? state.continuationModes : ["headless"];
+  const [selection, setSelection] = useState2({ key: null, mode: null });
+  const requestedMode = selection.key === state.attached?.key ? selection.mode : null;
+  const executionMode = continuationModes.includes(requestedMode) ? requestedMode : continuationModes.includes("terminal") ? "terminal" : continuationModes[0];
   if (state.mode !== "mirror" || state.canSend) return null;
   const attached = state.attached;
   const row = attached?.key ? state.sessions.find((item) => item.key === attached.key) : null;
   const activeElsewhere = row?.runtimeStatus === "running" || row?.runtimeStatus === "busy" || row?.runtimeStatus === "idle";
   const resume = canContinueHere(state);
-  const terminal = resume && state.continuationModes?.includes("terminal");
   const join = state.canAttach;
   const branch = state.canBranch;
   if (!resume && !join && !branch) return /* @__PURE__ */ jsx3("div", { className: "scui-continuation", children: /* @__PURE__ */ jsxs3("span", { children: [
@@ -314,8 +325,8 @@ function ContinuationBar({ state, adapter, labels = DEFAULT_LABELS }) {
       /* @__PURE__ */ jsx3("small", { children: join ? "Join the proven live runtime without taking it over." : resume ? `Resume this ${harnessDisplayName(state.harness)} session here.` : "Start an independent continuation." })
     ] }),
     /* @__PURE__ */ jsxs3("span", { className: "scui-continuation-actions", children: [
-      /* @__PURE__ */ jsx3("button", { type: "button", disabled: Boolean(state.operation), onClick: () => dispatchConfirmedIntent(adapter, join ? { action: "join" } : resume ? { action: "resume", mode: "headless" } : { action: "branch" }), children: join ? labels.joinLive : resume ? labels.continueHere : labels.forkHere }),
-      terminal ? /* @__PURE__ */ jsx3("button", { type: "button", className: "scui-secondary", disabled: Boolean(state.operation), onClick: () => dispatchConfirmedIntent(adapter, { action: "resume", mode: "terminal" }), children: labels.continueWithTerminal ?? DEFAULT_LABELS.continueWithTerminal }) : null
+      !join && resume ? /* @__PURE__ */ jsx3(ExecutionModeSelect, { modes: continuationModes, value: executionMode, disabled: Boolean(state.operation), onChange: (mode) => setSelection({ key: state.attached?.key ?? null, mode }) }) : null,
+      /* @__PURE__ */ jsx3("button", { type: "button", disabled: Boolean(state.operation), onClick: () => dispatchConfirmedIntent(adapter, join ? { action: "join" } : resume ? { action: "resume", mode: executionMode } : { action: "branch" }), children: join ? labels.joinLive : resume ? labels.continueHere : labels.forkHere })
     ] })
   ] });
 }
@@ -536,5 +547,6 @@ function Composer({ state, adapter, labels = DEFAULT_LABELS, memoryKey = state.a
 }
 export {
   Composer,
-  ContinuationBar
+  ContinuationBar,
+  ExecutionModeSelect
 };

package/controller.d.ts

@@ -65,6 +65,8 @@ export interface SessionInventoryProjectionOptions {
   maxSessions?: number;
   liveWindowMs?: number;
   preserveOrder?: boolean;
+  /** Capability check performed by the trusted host; omitted rows are read-only observations. */
+  isWritable?(descriptor: SessionDescriptor): boolean;
 }
 
 export function sessionConversationUpdatedAt(descriptor: SessionDescriptor): number | null;

package/controller.mjs

@@ -72,7 +72,7 @@ function descriptorTitle(descriptor) {
     return compactTopic(nativeTitle);
   }
   if (descriptor?.locator?.harness !== 'claude-code' && descriptor?.locator?.harness !== 'codex') {
-    return compactTopic(nativeTitle || workspace || descriptor?.locator?.session_id?.slice(0, 8)) || 'Untitled chat';
+    return compactTopic(nativeTitle || workspace) || 'Untitled chat';
   }
   const openingUserMessages = (descriptor?.preview_candidates ?? []).filter(
     (candidate) => candidate?.role === undefined || candidate.role === 'user',
@@ -125,6 +125,7 @@ export function projectSessionInventory(descriptors, options) {
       active: active?.sessionId != null
         && descriptor.locator.harness === active.harness
         && descriptor.locator.session_id === active.sessionId,
+      writable: options.isWritable?.(descriptor) === true,
       live: updatedAt !== null && now - updatedAt <= liveWindowMs,
       runtimeStatus: sessionDescriptorRuntimeStatus(descriptor),
     });
@@ -378,14 +379,14 @@ function attached(snapshot) {
     harness: snapshot.activeHarness,
     name: workspaceName(snapshot.workspace),
     cwd: snapshot.workspace,
-    title: snapshot.activeSession?.model ?? snapshot.activeSessionId ?? 'Active session',
+    title: 'Untitled chat',
   } : null;
   return {
     key: session.key,
     harness: session.harness,
     name: workspaceName(session.cwd),
     cwd: session.cwd ?? '',
-    title: session.title ?? session.model ?? session.sessionId,
+    title: session.title ?? 'Untitled chat',
   };
 }
 
@@ -442,11 +443,12 @@ function projectClientSnapshotInternal(snapshot, options, imageRegistry) {
     harness: session.harness,
     name: workspaceName(session.cwd),
     cwd: session.cwd ?? '',
-    title: session.title ?? session.model ?? session.sessionId,
+    title: session.title ?? 'Untitled chat',
     age: relativeAge(session.updatedAt, now),
     updatedAt: session.updatedAt ?? null,
     messages: session.messageCount ?? null,
     active: session.key === snapshot.activeSessionKey,
+    writable: session.key === snapshot.activeSessionKey && actions.send === true,
     live: typeof session.updatedAt === 'number' && now - session.updatedAt <= liveWindowMs,
     runtimeStatus: session.liveStatus ?? null,
   }));

package/conversation.mjs

@@ -439,6 +439,7 @@ var ACTIVITY_PRIORITY = Object.freeze({
   finished: 30,
   running: 20,
   recent: 10,
+  observed: 0,
   idle: 0
 });
 function groupConversation(entries) {

package/core.mjs

@@ -562,6 +562,7 @@ function readSessions(value) {
       updatedAt: nullableNumber(row.updatedAt),
       messages: nullableNumber(row.messages),
       active: row.active === true,
+      writable: row.writable === true,
       live: row.live === true,
       runtimeStatus: row.runtimeStatus === 'running' || row.runtimeStatus === 'busy' || row.runtimeStatus === 'idle' ? row.runtimeStatus : null,
     }];
@@ -806,7 +807,9 @@ export function normalizeUiState(value) {
         : startable ? ['headless'] : [];
       const preferredLaunchMode = launchModes.includes(item.preferredLaunchMode)
         ? item.preferredLaunchMode
-        : launchModes[0] ?? null;
+        : launchModes.includes('terminal')
+          ? 'terminal'
+          : launchModes[0] ?? null;
       const capabilities = record(item.capabilities);
       return [{
         id: item.id,
@@ -856,6 +859,9 @@ export function sessionDisplayName(session) {
 }
 
 export function sessionActivity(state, row) {
+  // Runtime activity and interaction authority are deliberately independent. A process may be
+  // busy in another terminal, but presenting it as this surface's active agent is misleading.
+  if (!row.writable) return 'observed';
   if (state.needsInput && row.active) return 'needs-input';
   if (state.busy && row.active) return 'working';
   // Unread/finished attention has its own badge. It must not suppress the
@@ -876,6 +882,7 @@ const ACTIVITY_PRIORITY = Object.freeze({
   finished: 30,
   running: 20,
   recent: 10,
+  observed: 0,
   idle: 0,
 });
 
@@ -887,6 +894,7 @@ function activityDetail(activity, preview, pill) {
   if (activity === 'finished') return 'Finished';
   if (activity === 'unseen') return 'New reply';
   if (activity === 'running') return 'Session is running';
+  if (activity === 'observed') return 'Read-only channel';
   return pill || 'Agent chats';
 }
 

package/embed.mjs

@@ -569,6 +569,7 @@ function readSessions(value) {
       updatedAt: nullableNumber(row.updatedAt),
       messages: nullableNumber(row.messages),
       active: row.active === true,
+      writable: row.writable === true,
       live: row.live === true,
       runtimeStatus: row.runtimeStatus === "running" || row.runtimeStatus === "busy" || row.runtimeStatus === "idle" ? row.runtimeStatus : null
     }];
@@ -753,7 +754,7 @@ function normalizeUiState(value) {
       if (!item || typeof item.id !== "string") return [];
       const startable = item.startable === true;
       const launchModes = Array.isArray(item.launchModes) ? [...new Set(item.launchModes.filter((mode) => mode === "headless" || mode === "terminal"))] : startable ? ["headless"] : [];
-      const preferredLaunchMode = launchModes.includes(item.preferredLaunchMode) ? item.preferredLaunchMode : launchModes[0] ?? null;
+      const preferredLaunchMode = launchModes.includes(item.preferredLaunchMode) ? item.preferredLaunchMode : launchModes.includes("terminal") ? "terminal" : launchModes[0] ?? null;
       const capabilities = record(item.capabilities);
       return [{
         id: item.id,
@@ -798,6 +799,7 @@ function sessionDisplayName(session) {
   return title && title !== session.name ? title : session.name || "Untitled chat";
 }
 function sessionActivity(state, row) {
+  if (!row.writable) return "observed";
   if (state.needsInput && row.active) return "needs-input";
   if (state.busy && row.active) return "working";
   if (row.runtimeStatus === "busy") return "working";
@@ -815,6 +817,7 @@ var ACTIVITY_PRIORITY = Object.freeze({
   finished: 30,
   running: 20,
   recent: 10,
+  observed: 0,
   idle: 0
 });
 function filterSessions(rows, query) {
@@ -1260,13 +1263,23 @@ function useAutosizeTextarea(ref, value) {
 // src/composer.jsx
 import { jsx as jsx3, jsxs as jsxs3 } from "preact/jsx-runtime";
 var composerMemory = /* @__PURE__ */ new Map();
+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: [
+    /* @__PURE__ */ jsx3("span", { children: label }),
+    /* @__PURE__ */ jsx3("select", { "aria-label": label, value, disabled, onChange: (event) => onChange?.(event.currentTarget.value), children: modes.map((mode) => /* @__PURE__ */ jsx3("option", { value: mode, children: mode === "terminal" ? "Terminal" : "Headless" }, mode)) })
+  ] });
+}
 function ContinuationBar({ state, adapter, labels = DEFAULT_LABELS }) {
+  const continuationModes = state.continuationModes?.length ? state.continuationModes : ["headless"];
+  const [selection, setSelection] = useState2({ key: null, mode: null });
+  const requestedMode = selection.key === state.attached?.key ? selection.mode : null;
+  const executionMode = continuationModes.includes(requestedMode) ? requestedMode : continuationModes.includes("terminal") ? "terminal" : continuationModes[0];
   if (state.mode !== "mirror" || state.canSend) return null;
   const attached = state.attached;
   const row = attached?.key ? state.sessions.find((item) => item.key === attached.key) : null;
   const activeElsewhere = row?.runtimeStatus === "running" || row?.runtimeStatus === "busy" || row?.runtimeStatus === "idle";
   const resume = canContinueHere(state);
-  const terminal = resume && state.continuationModes?.includes("terminal");
   const join = state.canAttach;
   const branch = state.canBranch;
   if (!resume && !join && !branch) return /* @__PURE__ */ jsx3("div", { className: "scui-continuation", children: /* @__PURE__ */ jsxs3("span", { children: [
@@ -1279,8 +1292,8 @@ function ContinuationBar({ state, adapter, labels = DEFAULT_LABELS }) {
       /* @__PURE__ */ jsx3("small", { children: join ? "Join the proven live runtime without taking it over." : resume ? `Resume this ${harnessDisplayName(state.harness)} session here.` : "Start an independent continuation." })
     ] }),
     /* @__PURE__ */ jsxs3("span", { className: "scui-continuation-actions", children: [
-      /* @__PURE__ */ jsx3("button", { type: "button", disabled: Boolean(state.operation), onClick: () => dispatchConfirmedIntent(adapter, join ? { action: "join" } : resume ? { action: "resume", mode: "headless" } : { action: "branch" }), children: join ? labels.joinLive : resume ? labels.continueHere : labels.forkHere }),
-      terminal ? /* @__PURE__ */ jsx3("button", { type: "button", className: "scui-secondary", disabled: Boolean(state.operation), onClick: () => dispatchConfirmedIntent(adapter, { action: "resume", mode: "terminal" }), children: labels.continueWithTerminal ?? DEFAULT_LABELS.continueWithTerminal }) : null
+      !join && resume ? /* @__PURE__ */ jsx3(ExecutionModeSelect, { modes: continuationModes, value: executionMode, disabled: Boolean(state.operation), onChange: (mode) => setSelection({ key: state.attached?.key ?? null, mode }) }) : null,
+      /* @__PURE__ */ jsx3("button", { type: "button", disabled: Boolean(state.operation), onClick: () => dispatchConfirmedIntent(adapter, join ? { action: "join" } : resume ? { action: "resume", mode: executionMode } : { action: "branch" }), children: join ? labels.joinLive : resume ? labels.continueHere : labels.forkHere })
     ] })
   ] });
 }
@@ -2209,7 +2222,7 @@ function SessionRow({ row, state, onOpen, 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__ */ jsxs6("button", { className: "scui-session", "data-active": row.active, "data-activity": activity, "data-session-key": row.key, type: "button", "aria-label": `${title} \xB7 ${harnessDisplayName(row.harness)}${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: [
+  return /* @__PURE__ */ jsxs6("button", { className: "scui-session", "data-active": row.active, "data-activity": activity, "data-writable": row.writable, "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__ */ jsx7(HarnessLogo, { id: row.harness, activity, size: 34 }),
     /* @__PURE__ */ jsxs6("span", { className: "scui-session-copy", children: [
       /* @__PURE__ */ jsxs6("span", { className: "scui-session-title", children: [
@@ -2790,7 +2803,8 @@ function NewChat({ state, adapter, onBack, onClose, onStarted, labels, memoryKey
   const Readiness = components.HarnessReadiness ?? HarnessReadiness;
   const launchModes = selectedHarness?.launchModes?.length ? selectedHarness.launchModes : ["headless"];
   const rememberedMode = modes[harness];
-  const mode = launchModes.includes(rememberedMode) ? rememberedMode : launchModes.includes(selectedHarness?.preferredLaunchMode) ? selectedHarness.preferredLaunchMode : launchModes[0];
+  const requestedMode = launchModes.includes(rememberedMode) ? rememberedMode : launchModes.includes(selectedHarness?.preferredLaunchMode) ? selectedHarness.preferredLaunchMode : launchModes[0];
+  const mode = (context.length > 0 || images.length > 0) && launchModes.includes("headless") ? "headless" : requestedMode;
   const terminalAttachments = mode === "terminal" && (context.length > 0 || images.length > 0);
   const remember = (overrides = {}) => boundedSet(newChatMemory, memoryKey, { harness, draft, context, images, modes, ...overrides });
   useAutosizeTextarea(textarea, draft);
@@ -2832,7 +2846,7 @@ function NewChat({ state, adapter, onBack, onClose, onStarted, labels, memoryKey
     lastComposerCommand.current = composerCommand.id;
     if (composerCommand.action === "attach") {
       if (mode === "terminal" && !launchModes.includes("headless")) {
-        setPickerError("Terminal starts currently accept text only. Choose Chat to attach context or images.");
+        setPickerError("Terminal starts currently accept text only. Choose Headless to attach context or images.");
       } else {
         try {
           const attachments = partitionAttachments(composerCommand.attachments);
@@ -2840,12 +2854,10 @@ function NewChat({ state, adapter, onBack, onClose, onStarted, labels, memoryKey
           if (images.length + attachments.images.length > MAX_IMAGE_ITEMS) throw new Error(`Attach at most ${MAX_IMAGE_ITEMS} images.`);
           const nextContext = mergeContext(context, attachments.context);
           const nextImages = mergeImages(images, attachments.images);
-          const nextModes = mode === "terminal" ? { ...modes, [harness]: "headless" } : modes;
-          if (nextModes !== modes) setModes(nextModes);
           setContext(nextContext);
           setImages(nextImages);
           setPickerError(null);
-          remember({ context: nextContext, images: nextImages, modes: nextModes });
+          remember({ context: nextContext, images: nextImages });
         } catch (error) {
           setPickerError(error instanceof Error ? error.message : "Could not attach context.");
         }
@@ -2886,7 +2898,7 @@ function NewChat({ state, adapter, onBack, onClose, onStarted, labels, memoryKey
     const allFiles = Array.from(value ?? []);
     if (!allFiles.length) return false;
     if (mode === "terminal") {
-      setPickerError("Terminal starts currently accept text only. Choose Chat to attach context or images.");
+      setPickerError("Terminal starts currently accept text only. Choose Headless to attach context or images.");
       return true;
     }
     const files = allFiles.filter((file) => file.type.startsWith("image/"));
@@ -2951,21 +2963,6 @@ function NewChat({ state, adapter, onBack, onClose, onStarted, labels, memoryKey
     ] }),
     /* @__PURE__ */ jsxs8("div", { className: "scui-compose", children: [
       /* @__PURE__ */ jsx9(Readiness, { harnesses: state.harnesses, state, adapter }),
-      launchModes.length > 1 ? /* @__PURE__ */ jsxs8("fieldset", { className: "scui-launch-modes", disabled: Boolean(starting), children: [
-        /* @__PURE__ */ jsx9("legend", { children: "Run as" }),
-        launchModes.map((item) => /* @__PURE__ */ jsxs8("label", { children: [
-          /* @__PURE__ */ jsx9("input", { type: "radio", name: `launch-mode-${memoryKey}`, value: item, checked: mode === item, onChange: () => {
-            const next = { ...modes, [harness]: item };
-            setModes(next);
-            setPickerError(null);
-            remember({ modes: next });
-          } }),
-          /* @__PURE__ */ jsxs8("span", { children: [
-            /* @__PURE__ */ jsx9("strong", { children: item === "terminal" ? "Terminal" : "Chat" }),
-            /* @__PURE__ */ jsx9("small", { children: item === "terminal" ? "Interactive tmux session" : "Managed here" })
-          ] })
-        ] }, item))
-      ] }) : null,
       mode !== "terminal" ? /* @__PURE__ */ jsx9(ContextCandidates, { items: contextCandidates, context, images, state, adapter, onAttach: attachCandidate, component: components.ContextCandidate }) : null,
       /* @__PURE__ */ jsx9(ImageTray, { items: images, onRemove: (index) => setImages((items) => {
         const next = items.filter((_, itemIndex) => itemIndex !== index);
@@ -2977,7 +2974,7 @@ function NewChat({ state, adapter, onBack, onClose, onStarted, labels, memoryKey
         remember({ context: next });
         return next;
       }) }),
-      terminalAttachments ? /* @__PURE__ */ jsx9("small", { className: "scui-context-error", role: "alert", children: "Terminal starts currently accept text only. Remove attachments or choose Chat." }) : pickerError ? /* @__PURE__ */ jsx9("small", { className: "scui-context-error", role: "alert", children: pickerError }) : null,
+      terminalAttachments ? /* @__PURE__ */ jsx9("small", { className: "scui-context-error", role: "alert", children: "Terminal starts currently accept text only. Remove attachments or choose Headless." }) : pickerError ? /* @__PURE__ */ jsx9("small", { className: "scui-context-error", role: "alert", children: pickerError }) : null,
       /* @__PURE__ */ jsxs8("div", { className: `scui-envelope scui-new-envelope${dragging ? " scui-drop-target" : ""}`, onDragEnter: (event) => {
         if (Array.from(event.dataTransfer?.types ?? []).includes("Files")) {
           event.preventDefault();
@@ -3004,7 +3001,13 @@ function NewChat({ state, adapter, onBack, onClose, onStarted, labels, memoryKey
             setHarness(value);
             remember({ harness: value });
           } }),
-          /* @__PURE__ */ jsx9("span", { children: /* @__PURE__ */ jsx9("button", { type: "button", className: "scui-send", "aria-label": mode === "terminal" ? "Start terminal session" : "Start chat", disabled: !draft.trim() && !images.length || !harness || Boolean(starting) || terminalAttachments || mode === "terminal" && !draft.trim(), onClick: send, children: starting ? /* @__PURE__ */ jsx9("i", { className: "scui-control-spinner" }) : /* @__PURE__ */ jsx9(UiIcon, { name: "send", size: 17 }) }) })
+          /* @__PURE__ */ jsx9(ExecutionModeSelect, { modes: launchModes, value: mode, disabled: Boolean(starting) || mode !== requestedMode, onChange: (item) => {
+            const next = { ...modes, [harness]: item };
+            setModes(next);
+            setPickerError(null);
+            remember({ modes: next });
+          } }),
+          /* @__PURE__ */ jsx9("span", { children: /* @__PURE__ */ jsx9("button", { type: "button", className: "scui-send", "aria-label": mode === "terminal" ? "Start terminal session" : "Start headless session", disabled: !draft.trim() && !images.length || !harness || Boolean(starting) || terminalAttachments || mode === "terminal" && !draft.trim(), onClick: send, children: starting ? /* @__PURE__ */ jsx9("i", { className: "scui-control-spinner" }) : /* @__PURE__ */ jsx9(UiIcon, { name: "send", size: 17 }) }) })
         ] })
       ] })
     ] })