@volter-ai-dev/supercode-ui 0.1.32 → 0.1.34

package/README.md

@@ -103,6 +103,13 @@ Native continuation is headless by default. A host with a real terminal provider
 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.
 
+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
+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.
+
 The default controller projection is display-bounded: 120 visible transcript rows, at most 480
 native entries inspected to fill that tail, 16,000 characters per independent entry field, 100
 session rows, 20 fidelity-residue details, and 50 subagents. It filters harness-injected context
@@ -116,6 +123,8 @@ errors, and owned/attached identities without reimplementing transcript or capab
 - Every component accepts data and callbacks. No component reaches into a global controller.
 - The complete messenger accepts `slots` for high-level replacement and `components` for row-level
   replacement. Replacements receive the same typed, capability-filtered props as defaults.
+- `slots.headerActions` adds compact product controls to the default list, chat, and new-chat
+  headers without replacing their navigation, status, or accessibility behavior.
 - Stable `scui-*` classes and `data-*` attributes support additive styling; CSS custom properties
   are the supported theme API.
 - `styles.css` contains both neutral tokens and default component rules. Teams may load it whole,

package/components.mjs

@@ -744,7 +744,11 @@ function normalizeUiState(value) {
     recoverable: raw.recoverable === true,
     harnesses: Array.isArray(raw.harnesses) ? raw.harnesses.flatMap((candidate) => {
       const item = record(candidate);
-      return item && typeof item.id === "string" ? [{ id: item.id, label: string(item.label, harnessDisplayName(item.id)), installed: item.installed === true, startable: item.startable === true, reason: typeof item.reason === "string" ? item.reason : null }] : [];
+      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;
+      return [{ id: item.id, label: string(item.label, harnessDisplayName(item.id)), installed: item.installed === true, startable, reason: typeof item.reason === "string" ? item.reason : null, launchModes, preferredLaunchMode }];
     }) : [],
     history: { sessionLimit: number(history?.sessionLimit), hasMoreSessions: history?.hasMoreSessions === true, transcriptLimit: number(history?.transcriptLimit, 120), hasEarlier: history?.hasEarlier === true },
     savedDraft: string(raw.savedDraft),
@@ -829,7 +833,7 @@ function activitySummary(entries) {
 function canContinueHere(state) {
   if (state.mode !== "mirror" || state.canSend) return false;
   const row = state.attached?.key ? state.sessions.find((item) => item.key === state.attached.key) : null;
-  return state.canResume && row?.runtimeStatus !== "running" && row?.runtimeStatus !== "busy" && row?.runtimeStatus !== "idle";
+  return Boolean(row) && state.canResume && row.runtimeStatus !== "running" && row.runtimeStatus !== "busy" && row.runtimeStatus !== "idle";
 }
 function operationLabel(operation) {
   if (!operation) return "";
@@ -2126,7 +2130,7 @@ function SessionRow({ row, state, onOpen, now = Date.now() }) {
     ] })
   ] });
 }
-function SessionList({ state, adapter, onOpen, onNew, onClose, components = {}, labels = DEFAULT_LABELS, focusKey = null, memoryKey = state.workspace || "@default" }) {
+function SessionList({ state, adapter, onOpen, onNew, onClose, components = {}, labels = DEFAULT_LABELS, focusKey = null, memoryKey = state.workspace || "@default", headerActions: HeaderActions }) {
   const remembered = sessionListMemory.get(memoryKey) ?? { query: "", top: 0 };
   const [query, setQuery] = useState4(remembered.query);
   const [loadingMore, setLoadingMore] = useState4(false);
@@ -2167,6 +2171,7 @@ function SessionList({ state, adapter, onOpen, onNew, onClose, components = {},
           " recent conversations"
         ] })
       ] }),
+      HeaderActions ? /* @__PURE__ */ jsx7(HeaderActions, { state, adapter, value: "list" }) : null,
       /* @__PURE__ */ jsx7("button", { type: "button", "data-list-focus": "new", "aria-label": labels.newChat, disabled: !state.harnesses.some((item) => item.startable), onClick: onNew, children: /* @__PURE__ */ jsx7(UiIcon, { name: "plus", size: 18 }) }),
       onClose ? /* @__PURE__ */ jsx7("button", { type: "button", "aria-label": "Close", onClick: onClose, children: /* @__PURE__ */ jsx7(UiIcon, { name: "close", size: 18 }) }) : null
     ] }),
@@ -2405,7 +2410,7 @@ function ConversationActions({ state, adapter, actionPending, onSettings }) {
     ] }, group.label)) }) : null
   ] });
 }
-function ChatHeader({ state, adapter, pendingStatus, actionPending, onBack, onNew, onClose, onSettings }) {
+function ChatHeader({ state, adapter, pendingStatus, actionPending, onBack, onNew, onClose, onSettings, headerActions: HeaderActions }) {
   const back = useRef7(null);
   const harness = state.attached?.harness ?? state.harness;
   const title = state.attached ? sessionDisplayName(state.attached) : harnessDisplayName(harness) || "Agent chat";
@@ -2425,6 +2430,7 @@ function ChatHeader({ state, adapter, pendingStatus, actionPending, onBack, onNe
         status
       ] })
     ] }),
+    HeaderActions ? /* @__PURE__ */ jsx9(HeaderActions, { state, adapter, value: "chat" }) : null,
     menu ? /* @__PURE__ */ jsx9(ConversationActions, { state, adapter, actionPending, onSettings }) : null,
     /* @__PURE__ */ jsx9("button", { type: "button", "aria-label": "New chat", onClick: onNew, children: /* @__PURE__ */ jsx9(UiIcon, { name: "plus", size: 18 }) }),
     onClose ? /* @__PURE__ */ jsx9("button", { type: "button", "aria-label": "Close", onClick: onClose, children: /* @__PURE__ */ jsx9(UiIcon, { name: "close", size: 18 }) }) : null
@@ -2432,6 +2438,7 @@ function ChatHeader({ state, adapter, pendingStatus, actionPending, onBack, onNe
 }
 function Chat({ state, adapter, onBack, onNew, onClose, components, slots, labels }) {
   const Header = slots.header;
+  const HeaderActions = slots.headerActions;
   const memoryKey = state.attached?.key || `${state.harness}:${state.workspace}`;
   const [pending, setPendingState] = useState6(() => pendingMessageMemory.get(memoryKey) ?? null);
   const [pendingAction, setPendingAction] = useState6(null);
@@ -2531,7 +2538,7 @@ function Chat({ state, adapter, onBack, onNew, onClose, components, slots, label
   const Advisory = components.HarnessAdvisory ?? HarnessAdvisory;
   const SettingsPanel = components.HarnessSettingsPanel ?? HarnessSettingsPanel;
   return /* @__PURE__ */ jsxs8("section", { class: "scui-chat", children: [
-    Header ? /* @__PURE__ */ jsx9(Header, { state: actionState, adapter: trackedAdapter, value: null }) : /* @__PURE__ */ jsx9(ChatHeader, { state: actionState, adapter: trackedAdapter, pendingStatus: pending?.status ?? null, actionPending: Boolean(action), onBack, onNew, onClose, onSettings: () => setSettings({ recommendedChange: null }) }),
+    Header ? /* @__PURE__ */ jsx9(Header, { state: actionState, adapter: trackedAdapter, value: null }) : /* @__PURE__ */ jsx9(ChatHeader, { state: actionState, adapter: trackedAdapter, pendingStatus: pending?.status ?? null, actionPending: Boolean(action), onBack, onNew, onClose, onSettings: () => setSettings({ recommendedChange: null }), headerActions: HeaderActions }),
     actionLabel ? /* @__PURE__ */ jsxs8("div", { class: "scui-operation", role: "status", children: [
       /* @__PURE__ */ jsx9("i", {}),
       actionLabel
@@ -2548,34 +2555,41 @@ function Chat({ state, adapter, onBack, onNew, onClose, components, slots, label
     settings ? /* @__PURE__ */ jsx9(SettingsPanel, { state: actionState, adapter: trackedAdapter, value: state.interopSettings, recommendedChange: settings.recommendedChange, onClose: () => setSettings(null) }) : null
   ] });
 }
-function NewChat({ state, adapter, onBack, onClose, onStarted, labels, memoryKey }) {
+function NewChat({ state, adapter, onBack, onClose, onStarted, labels, memoryKey, headerActions: HeaderActions }) {
   const startable = state.harnesses.filter((item) => item.startable);
-  const startableKey = startable.map((item) => item.id).join("\0");
-  const remembered = newChatMemory.get(memoryKey) ?? { harness: startable[0]?.id ?? "", draft: "", context: [], images: [] };
+  const startableKey = startable.map((item) => `${item.id}:${item.launchModes?.join(",")}:${item.preferredLaunchMode ?? ""}`).join("\0");
+  const remembered = newChatMemory.get(memoryKey) ?? { harness: startable[0]?.id ?? "", draft: "", context: [], images: [], modes: {} };
   const [harness, setHarness] = useState6(remembered.harness);
   const [draft, setDraft] = useState6(remembered.draft);
   const [context, setContext] = useState6(remembered.context);
   const [images, setImages] = useState6(remembered.images ?? []);
+  const [modes, setModes] = useState6(remembered.modes ?? {});
   const [starting, setStarting] = useState6(null);
   const [picking, setPicking] = useState6(false);
   const [dragging, setDragging] = useState6(false);
   const [pickerError, setPickerError] = useState6(null);
   const startSequence = useRef7(0);
   const textarea = useRef7(null);
+  const selectedHarness = startable.find((item) => item.id === harness) ?? null;
+  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 terminalAttachments = mode === "terminal" && (context.length > 0 || images.length > 0);
+  const remember = (overrides = {}) => boundedSet(newChatMemory, memoryKey, { harness, draft, context, images, modes, ...overrides });
   useAutosizeTextarea(textarea, draft);
   useEffect8(() => {
     if (startable.some((item) => item.id === harness)) return;
     const next = startable[0]?.id ?? "";
     setHarness(next);
-    boundedSet(newChatMemory, memoryKey, { harness: next, draft, context, images });
+    remember({ harness: next });
   }, [harness, startableKey]);
   useEffect8(() => {
-    if (!starting) return;
+    if (!starting || starting.mode === "terminal") return;
     const sessionChanged = (state.attached?.key ?? null) !== starting.attachedKey;
     const beganWorking = !starting.busy && state.busy;
     if (!sessionChanged && !beganWorking) return;
     newChatMemory.delete(memoryKey);
-    onStarted();
+    onStarted("headless");
   }, [memoryKey, onStarted, starting, state.attached?.key, state.busy]);
   useEffect8(() => {
     if (starting && state.error !== starting.initialError && !state.busy && !state.operation) setStarting(null);
@@ -2584,7 +2598,7 @@ function NewChat({ state, adapter, onBack, onClose, onStarted, labels, memoryKey
     textarea.current?.focus({ preventScroll: true });
   }, []);
   const pickContext = () => {
-    if (!adapter.pickContext || picking || context.length >= MAX_CONTEXT_ITEMS && images.length >= MAX_IMAGE_ITEMS) return;
+    if (mode === "terminal" || !adapter.pickContext || picking || context.length >= MAX_CONTEXT_ITEMS && images.length >= MAX_IMAGE_ITEMS) return;
     setPicking(true);
     setPickerError(null);
     Promise.resolve().then(() => adapter.pickContext()).then((picked) => {
@@ -2593,12 +2607,12 @@ 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.`);
       setContext((current) => {
         const next = mergeContext(current, attachments.context);
-        boundedSet(newChatMemory, memoryKey, { harness, draft, context: next, images });
+        remember({ context: next });
         return next;
       });
       setImages((current) => {
         const next = mergeImages(current, attachments.images);
-        boundedSet(newChatMemory, memoryKey, { harness, draft, context, images: next });
+        remember({ images: next });
         return next;
       });
     }).catch((error) => setPickerError(error instanceof Error ? error.message : "Could not attach context.")).finally(() => setPicking(false));
@@ -2606,6 +2620,10 @@ function NewChat({ state, adapter, onBack, onClose, onStarted, labels, memoryKey
   const addImageFiles = (value, source) => {
     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.");
+      return true;
+    }
     const files = allFiles.filter((file) => file.type.startsWith("image/"));
     if (files.length !== allFiles.length) {
       setPickerError("Drop or paste PNG, JPEG, GIF, or WebP images.");
@@ -2619,7 +2637,7 @@ function NewChat({ state, adapter, onBack, onClose, onStarted, labels, memoryKey
     setPickerError(null);
     imageAttachmentsFromFiles(files).then((picked) => setImages((current) => {
       const next = mergeImages(current, picked);
-      boundedSet(newChatMemory, memoryKey, { harness, draft, context, images: next });
+      remember({ images: next });
       return next;
     }), (error) => setPickerError(error instanceof Error ? error.message : `Could not ${source} image.`)).finally(() => setPicking(false));
     return true;
@@ -2633,12 +2651,17 @@ function NewChat({ state, adapter, onBack, onClose, onStarted, labels, memoryKey
   };
   const send = () => {
     const text = draft.trim();
-    if (!text && !images.length || !harness || starting) return;
+    if (!text && !images.length || !harness || starting || terminalAttachments || mode === "terminal" && !text) return;
     const id = startSequence.current + 1;
     startSequence.current = id;
-    setStarting({ id, attachedKey: state.attached?.key ?? null, busy: state.busy, initialError: state.error });
-    const result = adapter.onIntent({ action: "new", harness, text, ...context.length ? { context } : {}, ...images.length ? { images } : {} });
-    if (result && typeof result.then === "function") {
+    setStarting({ id, mode, attachedKey: state.attached?.key ?? null, busy: state.busy, initialError: state.error });
+    const result = adapter.onIntent({ action: "new", harness, mode, text, ...context.length ? { context } : {}, ...images.length ? { images } : {} });
+    if (mode === "terminal") {
+      Promise.resolve(result).then(() => {
+        newChatMemory.delete(memoryKey);
+        onStarted("terminal");
+      }, () => setStarting((current) => current?.id === id ? null : current));
+    } else if (result && typeof result.then === "function") {
       Promise.resolve(result).catch(() => setStarting((current) => current?.id === id ? null : current));
     }
   };
@@ -2649,11 +2672,12 @@ function NewChat({ state, adapter, onBack, onClose, onStarted, labels, memoryKey
         /* @__PURE__ */ jsx9("strong", { children: labels.newChat }),
         /* @__PURE__ */ jsx9("small", { children: "No session is created until you send" })
       ] }),
+      HeaderActions ? /* @__PURE__ */ jsx9(HeaderActions, { state, adapter, value: "new" }) : null,
       onClose ? /* @__PURE__ */ jsx9("button", { type: "button", "aria-label": "Close", onClick: onClose, children: /* @__PURE__ */ jsx9(UiIcon, { name: "close", size: 18 }) }) : null
     ] }),
     starting ? /* @__PURE__ */ jsxs8("div", { class: "scui-operation", role: "status", children: [
       /* @__PURE__ */ jsx9("i", {}),
-      operationLabel("start")
+      mode === "terminal" ? "Opening terminal\u2026" : operationLabel("start")
     ] }) : null,
     /* @__PURE__ */ jsxs8("div", { class: "scui-new", children: [
       /* @__PURE__ */ jsx9("span", { "aria-hidden": "true", children: "\u2726" }),
@@ -2667,23 +2691,38 @@ function NewChat({ state, adapter, onBack, onClose, onStarted, labels, memoryKey
         /* @__PURE__ */ jsx9("select", { value: harness, disabled: Boolean(starting), onChange: (event) => {
           const value = event.currentTarget.value;
           setHarness(value);
-          boundedSet(newChatMemory, memoryKey, { harness: value, draft, context, images });
+          remember({ harness: value });
         }, children: state.harnesses.map((item) => /* @__PURE__ */ jsxs8("option", { value: item.id, disabled: !item.startable, children: [
           item.label,
           item.startable ? "" : " \xB7 unavailable"
         ] }, item.id)) })
       ] }),
+      launchModes.length > 1 ? /* @__PURE__ */ jsxs8("fieldset", { class: "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,
       /* @__PURE__ */ jsx9(ImageTray, { items: images, onRemove: (index) => setImages((items) => {
         const next = items.filter((_, itemIndex) => itemIndex !== index);
-        boundedSet(newChatMemory, memoryKey, { harness, draft, context, images: next });
+        remember({ images: next });
         return next;
       }) }),
       /* @__PURE__ */ jsx9(ContextTray, { items: context, onRemove: (index) => setContext((items) => {
         const next = items.filter((_, itemIndex) => itemIndex !== index);
-        boundedSet(newChatMemory, memoryKey, { harness, draft, context: next, images });
+        remember({ context: next });
         return next;
       }) }),
-      pickerError ? /* @__PURE__ */ jsx9("small", { class: "scui-context-error", role: "alert", children: pickerError }) : null,
+      terminalAttachments ? /* @__PURE__ */ jsx9("small", { class: "scui-context-error", role: "alert", children: "Terminal starts currently accept text only. Remove attachments or choose Chat." }) : pickerError ? /* @__PURE__ */ jsx9("small", { class: "scui-context-error", role: "alert", children: pickerError }) : null,
       /* @__PURE__ */ jsxs8("div", { class: `scui-envelope${dragging ? " scui-drop-target" : ""}`, onDragEnter: (event) => {
         if (Array.from(event.dataTransfer?.types ?? []).includes("Files")) {
           event.preventDefault();
@@ -2694,18 +2733,18 @@ function NewChat({ state, adapter, onBack, onClose, onStarted, labels, memoryKey
       }, onDragLeave: (event) => {
         if (!event.currentTarget.contains(event.relatedTarget)) setDragging(false);
       }, onDrop: dropImages, children: [
-        adapter.pickContext ? /* @__PURE__ */ jsx9("button", { class: "scui-attach", type: "button", "aria-label": "Attach files or images", disabled: picking || context.length >= MAX_CONTEXT_ITEMS && images.length >= MAX_IMAGE_ITEMS || Boolean(starting), onClick: pickContext, children: picking ? /* @__PURE__ */ jsx9("i", { class: "scui-control-spinner" }) : /* @__PURE__ */ jsx9(UiIcon, { name: "attach", size: 17 }) }) : null,
+        adapter.pickContext ? /* @__PURE__ */ jsx9("button", { class: "scui-attach", type: "button", "aria-label": "Attach files or images", disabled: mode === "terminal" || picking || context.length >= MAX_CONTEXT_ITEMS && images.length >= MAX_IMAGE_ITEMS || Boolean(starting), onClick: pickContext, children: picking ? /* @__PURE__ */ jsx9("i", { class: "scui-control-spinner" }) : /* @__PURE__ */ jsx9(UiIcon, { name: "attach", size: 17 }) }) : null,
         /* @__PURE__ */ jsx9("textarea", { ref: textarea, rows: 3, "aria-label": "Message coding agent", placeholder: startable.length ? "What should the agent do?" : "No coding harness is available", value: draft, disabled: !startable.length || Boolean(starting), onPaste: pasteImages, onInput: (event) => {
           const value = event.currentTarget.value;
           setDraft(value);
-          boundedSet(newChatMemory, memoryKey, { harness, draft: value, context, images });
+          remember({ draft: value });
         }, onKeyDown: (event) => {
           if (isSendKey(event)) {
             event.preventDefault();
             send();
           }
         } }),
-        /* @__PURE__ */ jsx9("span", { children: /* @__PURE__ */ jsx9("button", { type: "button", class: "scui-send", "aria-label": "Start chat", disabled: !draft.trim() && !images.length || !harness || Boolean(starting), onClick: send, children: starting ? /* @__PURE__ */ jsx9("i", { class: "scui-control-spinner" }) : /* @__PURE__ */ jsx9(UiIcon, { name: "send", size: 17 }) }) })
+        /* @__PURE__ */ jsx9("span", { children: /* @__PURE__ */ jsx9("button", { type: "button", class: "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", { class: "scui-control-spinner" }) : /* @__PURE__ */ jsx9(UiIcon, { name: "send", size: 17 }) }) })
       ] })
     ] })
   ] });
@@ -2737,12 +2776,13 @@ function SupercodeMessenger({ state: stateInput, adapter, class: className = "",
   };
   const close = () => adapter.onClose?.();
   const Footer = slots.footer;
+  const HeaderActions = slots.headerActions;
   return /* @__PURE__ */ jsxs8("main", { class: `scui-root ${className}`, "data-view": view, "data-mode": state.mode, "aria-label": "Supercode messenger", children: [
     view === "list" ? /* @__PURE__ */ jsx9(SessionList, { state, adapter, focusKey: listFocus, onOpen: open, onNew: () => {
       setListFocus("@new");
       setView("new");
-    }, onClose: adapter.onClose ? close : void 0, components, labels: copy, memoryKey }) : null,
-    view === "new" ? /* @__PURE__ */ jsx9(NewChat, { state, adapter, onBack: () => setView("list"), onClose: adapter.onClose ? close : void 0, onStarted: () => setView("chat"), labels: copy, memoryKey }) : null,
+    }, onClose: adapter.onClose ? close : void 0, components, labels: copy, memoryKey, headerActions: HeaderActions }) : null,
+    view === "new" ? /* @__PURE__ */ jsx9(NewChat, { state, adapter, onBack: () => setView("list"), onClose: adapter.onClose ? close : void 0, onStarted: (mode) => setView(mode === "terminal" ? "list" : "chat"), labels: copy, memoryKey, headerActions: HeaderActions }) : null,
     view === "chat" ? /* @__PURE__ */ jsx9(Chat, { state, adapter, onBack: () => {
       setListFocus(state.attached?.key ?? listFocus);
       setView("list");

package/composer.mjs

@@ -70,7 +70,7 @@ function harnessDisplayName(id) {
 function canContinueHere(state) {
   if (state.mode !== "mirror" || state.canSend) return false;
   const row = state.attached?.key ? state.sessions.find((item) => item.key === state.attached.key) : null;
-  return state.canResume && row?.runtimeStatus !== "running" && row?.runtimeStatus !== "busy" && row?.runtimeStatus !== "idle";
+  return Boolean(row) && state.canResume && row.runtimeStatus !== "running" && row.runtimeStatus !== "busy" && row.runtimeStatus !== "idle";
 }
 function isSendKey(event) {
   return event.key === "Enter" && !event.shiftKey && !event.isComposing;

package/controller.d.ts

@@ -84,6 +84,7 @@ export interface ControllerBindingOptions {
   onAcknowledge?: (key: string) => void | Promise<void>;
   onLoadSessions?: () => void | Promise<void>;
   onLoadEarlier?: () => void | Promise<void>;
+  onStartTerminal?: (intent: Extract<SupercodeUiIntent, { action: 'new' }>) => void | Promise<void>;
   onResumeTerminal?: (intent: Extract<SupercodeUiIntent, { action: 'resume' }>) => void | Promise<void>;
   copyText?: UiAdapter['copyText'];
   resolveImage?: UiAdapter['resolveImage'];

package/controller.mjs

@@ -447,6 +447,11 @@ async function dispatchStandard(controller, intent, options) {
   if (intent.action === 'attach') return controller.dispatch({ type: 'observe', sessionKey: intent.key });
   if (intent.action === 'send') return controller.dispatch({ type: 'send', text: intent.text, ...(intent.context?.length ? { context: intent.context } : {}), ...(intent.images?.length ? { images: intent.images } : {}) });
   if (intent.action === 'new') {
+    if (intent.mode === 'terminal') {
+      return options.onStartTerminal
+        ? options.onStartTerminal(intent)
+        : options.onUnsupported?.(intent);
+    }
     await controller.dispatch({ type: 'start', harness: intent.harness });
     return controller.dispatch({ type: 'send', text: intent.text, ...(intent.context?.length ? { context: intent.context } : {}), ...(intent.images?.length ? { images: intent.images } : {}) });
   }

package/core.mjs

@@ -796,7 +796,15 @@ export function normalizeUiState(value) {
     recoverable: raw.recoverable === true,
     harnesses: Array.isArray(raw.harnesses) ? raw.harnesses.flatMap((candidate) => {
       const item = record(candidate);
-      return item && typeof item.id === 'string' ? [{ id: item.id, label: string(item.label, harnessDisplayName(item.id)), installed: item.installed === true, startable: item.startable === true, reason: typeof item.reason === 'string' ? item.reason : null }] : [];
+      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;
+      return [{ id: item.id, label: string(item.label, harnessDisplayName(item.id)), installed: item.installed === true, startable, reason: typeof item.reason === 'string' ? item.reason : null, launchModes, preferredLaunchMode }];
     }) : [],
     history: { sessionLimit: number(history?.sessionLimit), hasMoreSessions: history?.hasMoreSessions === true, transcriptLimit: number(history?.transcriptLimit, 120), hasEarlier: history?.hasEarlier === true },
     savedDraft: string(raw.savedDraft),
@@ -895,7 +903,7 @@ export function activitySummary(entries) {
 export function canContinueHere(state) {
   if (state.mode !== 'mirror' || state.canSend) return false;
   const row = state.attached?.key ? state.sessions.find((item) => item.key === state.attached.key) : null;
-  return state.canResume && row?.runtimeStatus !== 'running' && row?.runtimeStatus !== 'busy' && row?.runtimeStatus !== 'idle';
+  return Boolean(row) && state.canResume && row.runtimeStatus !== 'running' && row.runtimeStatus !== 'busy' && row.runtimeStatus !== 'idle';
 }
 
 export function operationLabel(operation) {

package/embed.mjs

@@ -747,7 +747,11 @@ function normalizeUiState(value) {
     recoverable: raw.recoverable === true,
     harnesses: Array.isArray(raw.harnesses) ? raw.harnesses.flatMap((candidate) => {
       const item = record(candidate);
-      return item && typeof item.id === "string" ? [{ id: item.id, label: string(item.label, harnessDisplayName(item.id)), installed: item.installed === true, startable: item.startable === true, reason: typeof item.reason === "string" ? item.reason : null }] : [];
+      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;
+      return [{ id: item.id, label: string(item.label, harnessDisplayName(item.id)), installed: item.installed === true, startable, reason: typeof item.reason === "string" ? item.reason : null, launchModes, preferredLaunchMode }];
     }) : [],
     history: { sessionLimit: number(history?.sessionLimit), hasMoreSessions: history?.hasMoreSessions === true, transcriptLimit: number(history?.transcriptLimit, 120), hasEarlier: history?.hasEarlier === true },
     savedDraft: string(raw.savedDraft),
@@ -832,7 +836,7 @@ function activitySummary(entries) {
 function canContinueHere(state) {
   if (state.mode !== "mirror" || state.canSend) return false;
   const row = state.attached?.key ? state.sessions.find((item) => item.key === state.attached.key) : null;
-  return state.canResume && row?.runtimeStatus !== "running" && row?.runtimeStatus !== "busy" && row?.runtimeStatus !== "idle";
+  return Boolean(row) && state.canResume && row.runtimeStatus !== "running" && row.runtimeStatus !== "busy" && row.runtimeStatus !== "idle";
 }
 function operationLabel(operation) {
   if (!operation) return "";
@@ -2105,7 +2109,7 @@ function SessionRow({ row, state, onOpen, now = Date.now() }) {
     ] })
   ] });
 }
-function SessionList({ state, adapter, onOpen, onNew, onClose, components = {}, labels = DEFAULT_LABELS, focusKey = null, memoryKey = state.workspace || "@default" }) {
+function SessionList({ state, adapter, onOpen, onNew, onClose, components = {}, labels = DEFAULT_LABELS, focusKey = null, memoryKey = state.workspace || "@default", headerActions: HeaderActions }) {
   const remembered = sessionListMemory.get(memoryKey) ?? { query: "", top: 0 };
   const [query, setQuery] = useState4(remembered.query);
   const [loadingMore, setLoadingMore] = useState4(false);
@@ -2146,6 +2150,7 @@ function SessionList({ state, adapter, onOpen, onNew, onClose, components = {},
           " recent conversations"
         ] })
       ] }),
+      HeaderActions ? /* @__PURE__ */ jsx7(HeaderActions, { state, adapter, value: "list" }) : null,
       /* @__PURE__ */ jsx7("button", { type: "button", "data-list-focus": "new", "aria-label": labels.newChat, disabled: !state.harnesses.some((item) => item.startable), onClick: onNew, children: /* @__PURE__ */ jsx7(UiIcon, { name: "plus", size: 18 }) }),
       onClose ? /* @__PURE__ */ jsx7("button", { type: "button", "aria-label": "Close", onClick: onClose, children: /* @__PURE__ */ jsx7(UiIcon, { name: "close", size: 18 }) }) : null
     ] }),
@@ -2384,7 +2389,7 @@ function ConversationActions({ state, adapter, actionPending, onSettings }) {
     ] }, group.label)) }) : null
   ] });
 }
-function ChatHeader({ state, adapter, pendingStatus, actionPending, onBack, onNew, onClose, onSettings }) {
+function ChatHeader({ state, adapter, pendingStatus, actionPending, onBack, onNew, onClose, onSettings, headerActions: HeaderActions }) {
   const back = useRef7(null);
   const harness = state.attached?.harness ?? state.harness;
   const title = state.attached ? sessionDisplayName(state.attached) : harnessDisplayName(harness) || "Agent chat";
@@ -2404,6 +2409,7 @@ function ChatHeader({ state, adapter, pendingStatus, actionPending, onBack, onNe
         status
       ] })
     ] }),
+    HeaderActions ? /* @__PURE__ */ jsx9(HeaderActions, { state, adapter, value: "chat" }) : null,
     menu ? /* @__PURE__ */ jsx9(ConversationActions, { state, adapter, actionPending, onSettings }) : null,
     /* @__PURE__ */ jsx9("button", { type: "button", "aria-label": "New chat", onClick: onNew, children: /* @__PURE__ */ jsx9(UiIcon, { name: "plus", size: 18 }) }),
     onClose ? /* @__PURE__ */ jsx9("button", { type: "button", "aria-label": "Close", onClick: onClose, children: /* @__PURE__ */ jsx9(UiIcon, { name: "close", size: 18 }) }) : null
@@ -2411,6 +2417,7 @@ function ChatHeader({ state, adapter, pendingStatus, actionPending, onBack, onNe
 }
 function Chat({ state, adapter, onBack, onNew, onClose, components, slots, labels }) {
   const Header = slots.header;
+  const HeaderActions = slots.headerActions;
   const memoryKey = state.attached?.key || `${state.harness}:${state.workspace}`;
   const [pending, setPendingState] = useState6(() => pendingMessageMemory.get(memoryKey) ?? null);
   const [pendingAction, setPendingAction] = useState6(null);
@@ -2510,7 +2517,7 @@ function Chat({ state, adapter, onBack, onNew, onClose, components, slots, label
   const Advisory = components.HarnessAdvisory ?? HarnessAdvisory;
   const SettingsPanel = components.HarnessSettingsPanel ?? HarnessSettingsPanel;
   return /* @__PURE__ */ jsxs8("section", { class: "scui-chat", children: [
-    Header ? /* @__PURE__ */ jsx9(Header, { state: actionState, adapter: trackedAdapter, value: null }) : /* @__PURE__ */ jsx9(ChatHeader, { state: actionState, adapter: trackedAdapter, pendingStatus: pending?.status ?? null, actionPending: Boolean(action), onBack, onNew, onClose, onSettings: () => setSettings({ recommendedChange: null }) }),
+    Header ? /* @__PURE__ */ jsx9(Header, { state: actionState, adapter: trackedAdapter, value: null }) : /* @__PURE__ */ jsx9(ChatHeader, { state: actionState, adapter: trackedAdapter, pendingStatus: pending?.status ?? null, actionPending: Boolean(action), onBack, onNew, onClose, onSettings: () => setSettings({ recommendedChange: null }), headerActions: HeaderActions }),
     actionLabel ? /* @__PURE__ */ jsxs8("div", { class: "scui-operation", role: "status", children: [
       /* @__PURE__ */ jsx9("i", {}),
       actionLabel
@@ -2527,34 +2534,41 @@ function Chat({ state, adapter, onBack, onNew, onClose, components, slots, label
     settings ? /* @__PURE__ */ jsx9(SettingsPanel, { state: actionState, adapter: trackedAdapter, value: state.interopSettings, recommendedChange: settings.recommendedChange, onClose: () => setSettings(null) }) : null
   ] });
 }
-function NewChat({ state, adapter, onBack, onClose, onStarted, labels, memoryKey }) {
+function NewChat({ state, adapter, onBack, onClose, onStarted, labels, memoryKey, headerActions: HeaderActions }) {
   const startable = state.harnesses.filter((item) => item.startable);
-  const startableKey = startable.map((item) => item.id).join("\0");
-  const remembered = newChatMemory.get(memoryKey) ?? { harness: startable[0]?.id ?? "", draft: "", context: [], images: [] };
+  const startableKey = startable.map((item) => `${item.id}:${item.launchModes?.join(",")}:${item.preferredLaunchMode ?? ""}`).join("\0");
+  const remembered = newChatMemory.get(memoryKey) ?? { harness: startable[0]?.id ?? "", draft: "", context: [], images: [], modes: {} };
   const [harness, setHarness] = useState6(remembered.harness);
   const [draft, setDraft] = useState6(remembered.draft);
   const [context, setContext] = useState6(remembered.context);
   const [images, setImages] = useState6(remembered.images ?? []);
+  const [modes, setModes] = useState6(remembered.modes ?? {});
   const [starting, setStarting] = useState6(null);
   const [picking, setPicking] = useState6(false);
   const [dragging, setDragging] = useState6(false);
   const [pickerError, setPickerError] = useState6(null);
   const startSequence = useRef7(0);
   const textarea = useRef7(null);
+  const selectedHarness = startable.find((item) => item.id === harness) ?? null;
+  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 terminalAttachments = mode === "terminal" && (context.length > 0 || images.length > 0);
+  const remember = (overrides = {}) => boundedSet(newChatMemory, memoryKey, { harness, draft, context, images, modes, ...overrides });
   useAutosizeTextarea(textarea, draft);
   useEffect8(() => {
     if (startable.some((item) => item.id === harness)) return;
     const next = startable[0]?.id ?? "";
     setHarness(next);
-    boundedSet(newChatMemory, memoryKey, { harness: next, draft, context, images });
+    remember({ harness: next });
   }, [harness, startableKey]);
   useEffect8(() => {
-    if (!starting) return;
+    if (!starting || starting.mode === "terminal") return;
     const sessionChanged = (state.attached?.key ?? null) !== starting.attachedKey;
     const beganWorking = !starting.busy && state.busy;
     if (!sessionChanged && !beganWorking) return;
     newChatMemory.delete(memoryKey);
-    onStarted();
+    onStarted("headless");
   }, [memoryKey, onStarted, starting, state.attached?.key, state.busy]);
   useEffect8(() => {
     if (starting && state.error !== starting.initialError && !state.busy && !state.operation) setStarting(null);
@@ -2563,7 +2577,7 @@ function NewChat({ state, adapter, onBack, onClose, onStarted, labels, memoryKey
     textarea.current?.focus({ preventScroll: true });
   }, []);
   const pickContext = () => {
-    if (!adapter.pickContext || picking || context.length >= MAX_CONTEXT_ITEMS && images.length >= MAX_IMAGE_ITEMS) return;
+    if (mode === "terminal" || !adapter.pickContext || picking || context.length >= MAX_CONTEXT_ITEMS && images.length >= MAX_IMAGE_ITEMS) return;
     setPicking(true);
     setPickerError(null);
     Promise.resolve().then(() => adapter.pickContext()).then((picked) => {
@@ -2572,12 +2586,12 @@ 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.`);
       setContext((current) => {
         const next = mergeContext(current, attachments.context);
-        boundedSet(newChatMemory, memoryKey, { harness, draft, context: next, images });
+        remember({ context: next });
         return next;
       });
       setImages((current) => {
         const next = mergeImages(current, attachments.images);
-        boundedSet(newChatMemory, memoryKey, { harness, draft, context, images: next });
+        remember({ images: next });
         return next;
       });
     }).catch((error) => setPickerError(error instanceof Error ? error.message : "Could not attach context.")).finally(() => setPicking(false));
@@ -2585,6 +2599,10 @@ function NewChat({ state, adapter, onBack, onClose, onStarted, labels, memoryKey
   const addImageFiles = (value, source) => {
     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.");
+      return true;
+    }
     const files = allFiles.filter((file) => file.type.startsWith("image/"));
     if (files.length !== allFiles.length) {
       setPickerError("Drop or paste PNG, JPEG, GIF, or WebP images.");
@@ -2598,7 +2616,7 @@ function NewChat({ state, adapter, onBack, onClose, onStarted, labels, memoryKey
     setPickerError(null);
     imageAttachmentsFromFiles(files).then((picked) => setImages((current) => {
       const next = mergeImages(current, picked);
-      boundedSet(newChatMemory, memoryKey, { harness, draft, context, images: next });
+      remember({ images: next });
       return next;
     }), (error) => setPickerError(error instanceof Error ? error.message : `Could not ${source} image.`)).finally(() => setPicking(false));
     return true;
@@ -2612,12 +2630,17 @@ function NewChat({ state, adapter, onBack, onClose, onStarted, labels, memoryKey
   };
   const send = () => {
     const text = draft.trim();
-    if (!text && !images.length || !harness || starting) return;
+    if (!text && !images.length || !harness || starting || terminalAttachments || mode === "terminal" && !text) return;
     const id = startSequence.current + 1;
     startSequence.current = id;
-    setStarting({ id, attachedKey: state.attached?.key ?? null, busy: state.busy, initialError: state.error });
-    const result = adapter.onIntent({ action: "new", harness, text, ...context.length ? { context } : {}, ...images.length ? { images } : {} });
-    if (result && typeof result.then === "function") {
+    setStarting({ id, mode, attachedKey: state.attached?.key ?? null, busy: state.busy, initialError: state.error });
+    const result = adapter.onIntent({ action: "new", harness, mode, text, ...context.length ? { context } : {}, ...images.length ? { images } : {} });
+    if (mode === "terminal") {
+      Promise.resolve(result).then(() => {
+        newChatMemory.delete(memoryKey);
+        onStarted("terminal");
+      }, () => setStarting((current) => current?.id === id ? null : current));
+    } else if (result && typeof result.then === "function") {
       Promise.resolve(result).catch(() => setStarting((current) => current?.id === id ? null : current));
     }
   };
@@ -2628,11 +2651,12 @@ function NewChat({ state, adapter, onBack, onClose, onStarted, labels, memoryKey
         /* @__PURE__ */ jsx9("strong", { children: labels.newChat }),
         /* @__PURE__ */ jsx9("small", { children: "No session is created until you send" })
       ] }),
+      HeaderActions ? /* @__PURE__ */ jsx9(HeaderActions, { state, adapter, value: "new" }) : null,
       onClose ? /* @__PURE__ */ jsx9("button", { type: "button", "aria-label": "Close", onClick: onClose, children: /* @__PURE__ */ jsx9(UiIcon, { name: "close", size: 18 }) }) : null
     ] }),
     starting ? /* @__PURE__ */ jsxs8("div", { class: "scui-operation", role: "status", children: [
       /* @__PURE__ */ jsx9("i", {}),
-      operationLabel("start")
+      mode === "terminal" ? "Opening terminal\u2026" : operationLabel("start")
     ] }) : null,
     /* @__PURE__ */ jsxs8("div", { class: "scui-new", children: [
       /* @__PURE__ */ jsx9("span", { "aria-hidden": "true", children: "\u2726" }),
@@ -2646,23 +2670,38 @@ function NewChat({ state, adapter, onBack, onClose, onStarted, labels, memoryKey
         /* @__PURE__ */ jsx9("select", { value: harness, disabled: Boolean(starting), onChange: (event) => {
           const value = event.currentTarget.value;
           setHarness(value);
-          boundedSet(newChatMemory, memoryKey, { harness: value, draft, context, images });
+          remember({ harness: value });
         }, children: state.harnesses.map((item) => /* @__PURE__ */ jsxs8("option", { value: item.id, disabled: !item.startable, children: [
           item.label,
           item.startable ? "" : " \xB7 unavailable"
         ] }, item.id)) })
       ] }),
+      launchModes.length > 1 ? /* @__PURE__ */ jsxs8("fieldset", { class: "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,
       /* @__PURE__ */ jsx9(ImageTray, { items: images, onRemove: (index) => setImages((items) => {
         const next = items.filter((_, itemIndex) => itemIndex !== index);
-        boundedSet(newChatMemory, memoryKey, { harness, draft, context, images: next });
+        remember({ images: next });
         return next;
       }) }),
       /* @__PURE__ */ jsx9(ContextTray, { items: context, onRemove: (index) => setContext((items) => {
         const next = items.filter((_, itemIndex) => itemIndex !== index);
-        boundedSet(newChatMemory, memoryKey, { harness, draft, context: next, images });
+        remember({ context: next });
         return next;
       }) }),
-      pickerError ? /* @__PURE__ */ jsx9("small", { class: "scui-context-error", role: "alert", children: pickerError }) : null,
+      terminalAttachments ? /* @__PURE__ */ jsx9("small", { class: "scui-context-error", role: "alert", children: "Terminal starts currently accept text only. Remove attachments or choose Chat." }) : pickerError ? /* @__PURE__ */ jsx9("small", { class: "scui-context-error", role: "alert", children: pickerError }) : null,
       /* @__PURE__ */ jsxs8("div", { class: `scui-envelope${dragging ? " scui-drop-target" : ""}`, onDragEnter: (event) => {
         if (Array.from(event.dataTransfer?.types ?? []).includes("Files")) {
           event.preventDefault();
@@ -2673,18 +2712,18 @@ function NewChat({ state, adapter, onBack, onClose, onStarted, labels, memoryKey
       }, onDragLeave: (event) => {
         if (!event.currentTarget.contains(event.relatedTarget)) setDragging(false);
       }, onDrop: dropImages, children: [
-        adapter.pickContext ? /* @__PURE__ */ jsx9("button", { class: "scui-attach", type: "button", "aria-label": "Attach files or images", disabled: picking || context.length >= MAX_CONTEXT_ITEMS && images.length >= MAX_IMAGE_ITEMS || Boolean(starting), onClick: pickContext, children: picking ? /* @__PURE__ */ jsx9("i", { class: "scui-control-spinner" }) : /* @__PURE__ */ jsx9(UiIcon, { name: "attach", size: 17 }) }) : null,
+        adapter.pickContext ? /* @__PURE__ */ jsx9("button", { class: "scui-attach", type: "button", "aria-label": "Attach files or images", disabled: mode === "terminal" || picking || context.length >= MAX_CONTEXT_ITEMS && images.length >= MAX_IMAGE_ITEMS || Boolean(starting), onClick: pickContext, children: picking ? /* @__PURE__ */ jsx9("i", { class: "scui-control-spinner" }) : /* @__PURE__ */ jsx9(UiIcon, { name: "attach", size: 17 }) }) : null,
         /* @__PURE__ */ jsx9("textarea", { ref: textarea, rows: 3, "aria-label": "Message coding agent", placeholder: startable.length ? "What should the agent do?" : "No coding harness is available", value: draft, disabled: !startable.length || Boolean(starting), onPaste: pasteImages, onInput: (event) => {
           const value = event.currentTarget.value;
           setDraft(value);
-          boundedSet(newChatMemory, memoryKey, { harness, draft: value, context, images });
+          remember({ draft: value });
         }, onKeyDown: (event) => {
           if (isSendKey(event)) {
             event.preventDefault();
             send();
           }
         } }),
-        /* @__PURE__ */ jsx9("span", { children: /* @__PURE__ */ jsx9("button", { type: "button", class: "scui-send", "aria-label": "Start chat", disabled: !draft.trim() && !images.length || !harness || Boolean(starting), onClick: send, children: starting ? /* @__PURE__ */ jsx9("i", { class: "scui-control-spinner" }) : /* @__PURE__ */ jsx9(UiIcon, { name: "send", size: 17 }) }) })
+        /* @__PURE__ */ jsx9("span", { children: /* @__PURE__ */ jsx9("button", { type: "button", class: "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", { class: "scui-control-spinner" }) : /* @__PURE__ */ jsx9(UiIcon, { name: "send", size: 17 }) }) })
       ] })
     ] })
   ] });
@@ -2716,12 +2755,13 @@ function SupercodeMessenger({ state: stateInput, adapter, class: className = "",
   };
   const close = () => adapter.onClose?.();
   const Footer = slots.footer;
+  const HeaderActions = slots.headerActions;
   return /* @__PURE__ */ jsxs8("main", { class: `scui-root ${className}`, "data-view": view, "data-mode": state.mode, "aria-label": "Supercode messenger", children: [
     view === "list" ? /* @__PURE__ */ jsx9(SessionList, { state, adapter, focusKey: listFocus, onOpen: open, onNew: () => {
       setListFocus("@new");
       setView("new");
-    }, onClose: adapter.onClose ? close : void 0, components, labels: copy, memoryKey }) : null,
-    view === "new" ? /* @__PURE__ */ jsx9(NewChat, { state, adapter, onBack: () => setView("list"), onClose: adapter.onClose ? close : void 0, onStarted: () => setView("chat"), labels: copy, memoryKey }) : null,
+    }, onClose: adapter.onClose ? close : void 0, components, labels: copy, memoryKey, headerActions: HeaderActions }) : null,
+    view === "new" ? /* @__PURE__ */ jsx9(NewChat, { state, adapter, onBack: () => setView("list"), onClose: adapter.onClose ? close : void 0, onStarted: (mode) => setView(mode === "terminal" ? "list" : "chat"), labels: copy, memoryKey, headerActions: HeaderActions }) : null,
     view === "chat" ? /* @__PURE__ */ jsx9(Chat, { state, adapter, onBack: () => {
       setListFocus(state.attached?.key ?? listFocus);
       setView("list");

package/index.d.ts

@@ -5,7 +5,9 @@ export type UiTone = 'live' | 'warn' | 'dead' | 'off';
 export type StartupPhase = 'connecting' | 'starting' | 'discovering' | 'ready';
 export type SessionMode = 'none' | 'control' | 'mirror';
 export type ControlStrategy = 'start' | 'resume' | 'attach' | 'branch' | 'reduce' | null;
-export type ContinuationMode = 'headless' | 'terminal';
+export type ExecutionMode = 'headless' | 'terminal';
+/** @deprecated Use ExecutionMode. */
+export type ContinuationMode = ExecutionMode;
 export type SessionActivity = 'idle' | 'recent' | 'running' | 'working' | 'needs-input' | 'finished' | 'failed' | 'unseen';
 
 export interface HarnessOption {
@@ -14,6 +16,10 @@ export interface HarnessOption {
   installed: boolean;
   startable: boolean;
   reason: string | null;
+  /** Host-supported ways to start this harness. Omitted means headless when startable. */
+  launchModes?: ExecutionMode[];
+  /** Host preference, used unless this browser has a remembered choice for the harness. */
+  preferredLaunchMode?: ExecutionMode | null;
 }
 
 export interface SessionRowModel {
@@ -287,7 +293,7 @@ export type SupercodeUiIntent =
   | { action: 'loadEarlier' }
   | { action: 'draft'; text: string }
   | { action: 'send'; text: string; context?: TranscriptContext[]; images?: Array<TranscriptImage & { url: string }> }
-  | { action: 'new'; harness: HarnessId; text: string; context?: TranscriptContext[]; images?: Array<TranscriptImage & { url: string }> }
+  | { action: 'new'; harness: HarnessId; mode?: ExecutionMode; text: string; context?: TranscriptContext[]; images?: Array<TranscriptImage & { url: string }> }
   | { action: 'resume'; mode?: ContinuationMode }
   | { action: 'join' }
   | { action: 'detach' }
@@ -403,6 +409,8 @@ export interface MessengerComponents {
 
 export interface MessengerSlots {
   header?: ComponentType<ComponentOverrideProps>;
+  /** Add a compact consumer control to every default messenger header. `value` is the current view. */
+  headerActions?: ComponentType<ComponentOverrideProps<'list' | 'chat' | 'new'>>;
   emptyConversation?: ComponentType<ComponentOverrideProps>;
   beforeConversation?: ComponentType<ComponentOverrideProps>;
   afterConversation?: ComponentType<ComponentOverrideProps>;
@@ -460,7 +468,7 @@ export function HarnessSettingsPanel(props: HarnessSettingsPanelProps): VNode;
 export function SessionDetails(props: { semantics: SessionSemanticsModel }): VNode | null;
 export function Conversation(props: { state: SupercodeUiState; adapter: UiAdapter; components?: MessengerComponents; slots?: MessengerSlots; memoryKey?: string; pending?: string | PendingMessageModel | null; unreadAfterMessages?: number | null }): VNode;
 export function SessionRow(props: { row: SessionRowModel; state: SupercodeUiState; adapter: UiAdapter; now?: number; onOpen(row: SessionRowModel): void }): VNode;
-export function SessionList(props: { state: SupercodeUiState; adapter: UiAdapter; onOpen(row: SessionRowModel): void; onNew?(): void; onClose?(): void; components?: MessengerComponents; labels?: MessengerLabels; focusKey?: string | null; memoryKey?: string }): VNode;
+export function SessionList(props: { state: SupercodeUiState; adapter: UiAdapter; onOpen(row: SessionRowModel): void; onNew?(): void; onClose?(): void; components?: MessengerComponents; labels?: MessengerLabels; focusKey?: string | null; memoryKey?: string; headerActions?: MessengerSlots['headerActions'] }): VNode;
 export function ContinuationBar(props: { state: SupercodeUiState; adapter: UiAdapter; labels?: MessengerLabels }): VNode | null;
 export function Composer(props: { state: SupercodeUiState; adapter: UiAdapter; labels?: MessengerLabels; memoryKey?: string; pendingStatus?: PendingMessageModel['status'] | 'editing' | null; restoreDraft?: { id: string | number; text: string; context?: TranscriptContext[]; images?: TranscriptImage[] } | null; onPending?(text: string, context?: TranscriptContext[], images?: TranscriptImage[]): void; onDraftRestored?(id: string | number): void }): VNode;
 export function SupercodeMessenger(props: MessengerProps): VNode;

package/messenger.mjs

@@ -744,7 +744,11 @@ function normalizeUiState(value) {
     recoverable: raw.recoverable === true,
     harnesses: Array.isArray(raw.harnesses) ? raw.harnesses.flatMap((candidate) => {
       const item = record(candidate);
-      return item && typeof item.id === "string" ? [{ id: item.id, label: string(item.label, harnessDisplayName(item.id)), installed: item.installed === true, startable: item.startable === true, reason: typeof item.reason === "string" ? item.reason : null }] : [];
+      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;
+      return [{ id: item.id, label: string(item.label, harnessDisplayName(item.id)), installed: item.installed === true, startable, reason: typeof item.reason === "string" ? item.reason : null, launchModes, preferredLaunchMode }];
     }) : [],
     history: { sessionLimit: number(history?.sessionLimit), hasMoreSessions: history?.hasMoreSessions === true, transcriptLimit: number(history?.transcriptLimit, 120), hasEarlier: history?.hasEarlier === true },
     savedDraft: string(raw.savedDraft),
@@ -829,7 +833,7 @@ function activitySummary(entries) {
 function canContinueHere(state) {
   if (state.mode !== "mirror" || state.canSend) return false;
   const row = state.attached?.key ? state.sessions.find((item) => item.key === state.attached.key) : null;
-  return state.canResume && row?.runtimeStatus !== "running" && row?.runtimeStatus !== "busy" && row?.runtimeStatus !== "idle";
+  return Boolean(row) && state.canResume && row.runtimeStatus !== "running" && row.runtimeStatus !== "busy" && row.runtimeStatus !== "idle";
 }
 function operationLabel(operation) {
   if (!operation) return "";
@@ -2102,7 +2106,7 @@ function SessionRow({ row, state, onOpen, now = Date.now() }) {
     ] })
   ] });
 }
-function SessionList({ state, adapter, onOpen, onNew, onClose, components = {}, labels = DEFAULT_LABELS, focusKey = null, memoryKey = state.workspace || "@default" }) {
+function SessionList({ state, adapter, onOpen, onNew, onClose, components = {}, labels = DEFAULT_LABELS, focusKey = null, memoryKey = state.workspace || "@default", headerActions: HeaderActions }) {
   const remembered = sessionListMemory.get(memoryKey) ?? { query: "", top: 0 };
   const [query, setQuery] = useState4(remembered.query);
   const [loadingMore, setLoadingMore] = useState4(false);
@@ -2143,6 +2147,7 @@ function SessionList({ state, adapter, onOpen, onNew, onClose, components = {},
           " recent conversations"
         ] })
       ] }),
+      HeaderActions ? /* @__PURE__ */ jsx7(HeaderActions, { state, adapter, value: "list" }) : null,
       /* @__PURE__ */ jsx7("button", { type: "button", "data-list-focus": "new", "aria-label": labels.newChat, disabled: !state.harnesses.some((item) => item.startable), onClick: onNew, children: /* @__PURE__ */ jsx7(UiIcon, { name: "plus", size: 18 }) }),
       onClose ? /* @__PURE__ */ jsx7("button", { type: "button", "aria-label": "Close", onClick: onClose, children: /* @__PURE__ */ jsx7(UiIcon, { name: "close", size: 18 }) }) : null
     ] }),
@@ -2381,7 +2386,7 @@ function ConversationActions({ state, adapter, actionPending, onSettings }) {
     ] }, group.label)) }) : null
   ] });
 }
-function ChatHeader({ state, adapter, pendingStatus, actionPending, onBack, onNew, onClose, onSettings }) {
+function ChatHeader({ state, adapter, pendingStatus, actionPending, onBack, onNew, onClose, onSettings, headerActions: HeaderActions }) {
   const back = useRef7(null);
   const harness = state.attached?.harness ?? state.harness;
   const title = state.attached ? sessionDisplayName(state.attached) : harnessDisplayName(harness) || "Agent chat";
@@ -2401,6 +2406,7 @@ function ChatHeader({ state, adapter, pendingStatus, actionPending, onBack, onNe
         status
       ] })
     ] }),
+    HeaderActions ? /* @__PURE__ */ jsx9(HeaderActions, { state, adapter, value: "chat" }) : null,
     menu ? /* @__PURE__ */ jsx9(ConversationActions, { state, adapter, actionPending, onSettings }) : null,
     /* @__PURE__ */ jsx9("button", { type: "button", "aria-label": "New chat", onClick: onNew, children: /* @__PURE__ */ jsx9(UiIcon, { name: "plus", size: 18 }) }),
     onClose ? /* @__PURE__ */ jsx9("button", { type: "button", "aria-label": "Close", onClick: onClose, children: /* @__PURE__ */ jsx9(UiIcon, { name: "close", size: 18 }) }) : null
@@ -2408,6 +2414,7 @@ function ChatHeader({ state, adapter, pendingStatus, actionPending, onBack, onNe
 }
 function Chat({ state, adapter, onBack, onNew, onClose, components, slots, labels }) {
   const Header = slots.header;
+  const HeaderActions = slots.headerActions;
   const memoryKey = state.attached?.key || `${state.harness}:${state.workspace}`;
   const [pending, setPendingState] = useState6(() => pendingMessageMemory.get(memoryKey) ?? null);
   const [pendingAction, setPendingAction] = useState6(null);
@@ -2507,7 +2514,7 @@ function Chat({ state, adapter, onBack, onNew, onClose, components, slots, label
   const Advisory = components.HarnessAdvisory ?? HarnessAdvisory;
   const SettingsPanel = components.HarnessSettingsPanel ?? HarnessSettingsPanel;
   return /* @__PURE__ */ jsxs8("section", { class: "scui-chat", children: [
-    Header ? /* @__PURE__ */ jsx9(Header, { state: actionState, adapter: trackedAdapter, value: null }) : /* @__PURE__ */ jsx9(ChatHeader, { state: actionState, adapter: trackedAdapter, pendingStatus: pending?.status ?? null, actionPending: Boolean(action), onBack, onNew, onClose, onSettings: () => setSettings({ recommendedChange: null }) }),
+    Header ? /* @__PURE__ */ jsx9(Header, { state: actionState, adapter: trackedAdapter, value: null }) : /* @__PURE__ */ jsx9(ChatHeader, { state: actionState, adapter: trackedAdapter, pendingStatus: pending?.status ?? null, actionPending: Boolean(action), onBack, onNew, onClose, onSettings: () => setSettings({ recommendedChange: null }), headerActions: HeaderActions }),
     actionLabel ? /* @__PURE__ */ jsxs8("div", { class: "scui-operation", role: "status", children: [
       /* @__PURE__ */ jsx9("i", {}),
       actionLabel
@@ -2524,34 +2531,41 @@ function Chat({ state, adapter, onBack, onNew, onClose, components, slots, label
     settings ? /* @__PURE__ */ jsx9(SettingsPanel, { state: actionState, adapter: trackedAdapter, value: state.interopSettings, recommendedChange: settings.recommendedChange, onClose: () => setSettings(null) }) : null
   ] });
 }
-function NewChat({ state, adapter, onBack, onClose, onStarted, labels, memoryKey }) {
+function NewChat({ state, adapter, onBack, onClose, onStarted, labels, memoryKey, headerActions: HeaderActions }) {
   const startable = state.harnesses.filter((item) => item.startable);
-  const startableKey = startable.map((item) => item.id).join("\0");
-  const remembered = newChatMemory.get(memoryKey) ?? { harness: startable[0]?.id ?? "", draft: "", context: [], images: [] };
+  const startableKey = startable.map((item) => `${item.id}:${item.launchModes?.join(",")}:${item.preferredLaunchMode ?? ""}`).join("\0");
+  const remembered = newChatMemory.get(memoryKey) ?? { harness: startable[0]?.id ?? "", draft: "", context: [], images: [], modes: {} };
   const [harness, setHarness] = useState6(remembered.harness);
   const [draft, setDraft] = useState6(remembered.draft);
   const [context, setContext] = useState6(remembered.context);
   const [images, setImages] = useState6(remembered.images ?? []);
+  const [modes, setModes] = useState6(remembered.modes ?? {});
   const [starting, setStarting] = useState6(null);
   const [picking, setPicking] = useState6(false);
   const [dragging, setDragging] = useState6(false);
   const [pickerError, setPickerError] = useState6(null);
   const startSequence = useRef7(0);
   const textarea = useRef7(null);
+  const selectedHarness = startable.find((item) => item.id === harness) ?? null;
+  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 terminalAttachments = mode === "terminal" && (context.length > 0 || images.length > 0);
+  const remember = (overrides = {}) => boundedSet(newChatMemory, memoryKey, { harness, draft, context, images, modes, ...overrides });
   useAutosizeTextarea(textarea, draft);
   useEffect8(() => {
     if (startable.some((item) => item.id === harness)) return;
     const next = startable[0]?.id ?? "";
     setHarness(next);
-    boundedSet(newChatMemory, memoryKey, { harness: next, draft, context, images });
+    remember({ harness: next });
   }, [harness, startableKey]);
   useEffect8(() => {
-    if (!starting) return;
+    if (!starting || starting.mode === "terminal") return;
     const sessionChanged = (state.attached?.key ?? null) !== starting.attachedKey;
     const beganWorking = !starting.busy && state.busy;
     if (!sessionChanged && !beganWorking) return;
     newChatMemory.delete(memoryKey);
-    onStarted();
+    onStarted("headless");
   }, [memoryKey, onStarted, starting, state.attached?.key, state.busy]);
   useEffect8(() => {
     if (starting && state.error !== starting.initialError && !state.busy && !state.operation) setStarting(null);
@@ -2560,7 +2574,7 @@ function NewChat({ state, adapter, onBack, onClose, onStarted, labels, memoryKey
     textarea.current?.focus({ preventScroll: true });
   }, []);
   const pickContext = () => {
-    if (!adapter.pickContext || picking || context.length >= MAX_CONTEXT_ITEMS && images.length >= MAX_IMAGE_ITEMS) return;
+    if (mode === "terminal" || !adapter.pickContext || picking || context.length >= MAX_CONTEXT_ITEMS && images.length >= MAX_IMAGE_ITEMS) return;
     setPicking(true);
     setPickerError(null);
     Promise.resolve().then(() => adapter.pickContext()).then((picked) => {
@@ -2569,12 +2583,12 @@ 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.`);
       setContext((current) => {
         const next = mergeContext(current, attachments.context);
-        boundedSet(newChatMemory, memoryKey, { harness, draft, context: next, images });
+        remember({ context: next });
         return next;
       });
       setImages((current) => {
         const next = mergeImages(current, attachments.images);
-        boundedSet(newChatMemory, memoryKey, { harness, draft, context, images: next });
+        remember({ images: next });
         return next;
       });
     }).catch((error) => setPickerError(error instanceof Error ? error.message : "Could not attach context.")).finally(() => setPicking(false));
@@ -2582,6 +2596,10 @@ function NewChat({ state, adapter, onBack, onClose, onStarted, labels, memoryKey
   const addImageFiles = (value, source) => {
     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.");
+      return true;
+    }
     const files = allFiles.filter((file) => file.type.startsWith("image/"));
     if (files.length !== allFiles.length) {
       setPickerError("Drop or paste PNG, JPEG, GIF, or WebP images.");
@@ -2595,7 +2613,7 @@ function NewChat({ state, adapter, onBack, onClose, onStarted, labels, memoryKey
     setPickerError(null);
     imageAttachmentsFromFiles(files).then((picked) => setImages((current) => {
       const next = mergeImages(current, picked);
-      boundedSet(newChatMemory, memoryKey, { harness, draft, context, images: next });
+      remember({ images: next });
       return next;
     }), (error) => setPickerError(error instanceof Error ? error.message : `Could not ${source} image.`)).finally(() => setPicking(false));
     return true;
@@ -2609,12 +2627,17 @@ function NewChat({ state, adapter, onBack, onClose, onStarted, labels, memoryKey
   };
   const send = () => {
     const text = draft.trim();
-    if (!text && !images.length || !harness || starting) return;
+    if (!text && !images.length || !harness || starting || terminalAttachments || mode === "terminal" && !text) return;
     const id = startSequence.current + 1;
     startSequence.current = id;
-    setStarting({ id, attachedKey: state.attached?.key ?? null, busy: state.busy, initialError: state.error });
-    const result = adapter.onIntent({ action: "new", harness, text, ...context.length ? { context } : {}, ...images.length ? { images } : {} });
-    if (result && typeof result.then === "function") {
+    setStarting({ id, mode, attachedKey: state.attached?.key ?? null, busy: state.busy, initialError: state.error });
+    const result = adapter.onIntent({ action: "new", harness, mode, text, ...context.length ? { context } : {}, ...images.length ? { images } : {} });
+    if (mode === "terminal") {
+      Promise.resolve(result).then(() => {
+        newChatMemory.delete(memoryKey);
+        onStarted("terminal");
+      }, () => setStarting((current) => current?.id === id ? null : current));
+    } else if (result && typeof result.then === "function") {
       Promise.resolve(result).catch(() => setStarting((current) => current?.id === id ? null : current));
     }
   };
@@ -2625,11 +2648,12 @@ function NewChat({ state, adapter, onBack, onClose, onStarted, labels, memoryKey
         /* @__PURE__ */ jsx9("strong", { children: labels.newChat }),
         /* @__PURE__ */ jsx9("small", { children: "No session is created until you send" })
       ] }),
+      HeaderActions ? /* @__PURE__ */ jsx9(HeaderActions, { state, adapter, value: "new" }) : null,
       onClose ? /* @__PURE__ */ jsx9("button", { type: "button", "aria-label": "Close", onClick: onClose, children: /* @__PURE__ */ jsx9(UiIcon, { name: "close", size: 18 }) }) : null
     ] }),
     starting ? /* @__PURE__ */ jsxs8("div", { class: "scui-operation", role: "status", children: [
       /* @__PURE__ */ jsx9("i", {}),
-      operationLabel("start")
+      mode === "terminal" ? "Opening terminal\u2026" : operationLabel("start")
     ] }) : null,
     /* @__PURE__ */ jsxs8("div", { class: "scui-new", children: [
       /* @__PURE__ */ jsx9("span", { "aria-hidden": "true", children: "\u2726" }),
@@ -2643,23 +2667,38 @@ function NewChat({ state, adapter, onBack, onClose, onStarted, labels, memoryKey
         /* @__PURE__ */ jsx9("select", { value: harness, disabled: Boolean(starting), onChange: (event) => {
           const value = event.currentTarget.value;
           setHarness(value);
-          boundedSet(newChatMemory, memoryKey, { harness: value, draft, context, images });
+          remember({ harness: value });
         }, children: state.harnesses.map((item) => /* @__PURE__ */ jsxs8("option", { value: item.id, disabled: !item.startable, children: [
           item.label,
           item.startable ? "" : " \xB7 unavailable"
         ] }, item.id)) })
       ] }),
+      launchModes.length > 1 ? /* @__PURE__ */ jsxs8("fieldset", { class: "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,
       /* @__PURE__ */ jsx9(ImageTray, { items: images, onRemove: (index) => setImages((items) => {
         const next = items.filter((_, itemIndex) => itemIndex !== index);
-        boundedSet(newChatMemory, memoryKey, { harness, draft, context, images: next });
+        remember({ images: next });
         return next;
       }) }),
       /* @__PURE__ */ jsx9(ContextTray, { items: context, onRemove: (index) => setContext((items) => {
         const next = items.filter((_, itemIndex) => itemIndex !== index);
-        boundedSet(newChatMemory, memoryKey, { harness, draft, context: next, images });
+        remember({ context: next });
         return next;
       }) }),
-      pickerError ? /* @__PURE__ */ jsx9("small", { class: "scui-context-error", role: "alert", children: pickerError }) : null,
+      terminalAttachments ? /* @__PURE__ */ jsx9("small", { class: "scui-context-error", role: "alert", children: "Terminal starts currently accept text only. Remove attachments or choose Chat." }) : pickerError ? /* @__PURE__ */ jsx9("small", { class: "scui-context-error", role: "alert", children: pickerError }) : null,
       /* @__PURE__ */ jsxs8("div", { class: `scui-envelope${dragging ? " scui-drop-target" : ""}`, onDragEnter: (event) => {
         if (Array.from(event.dataTransfer?.types ?? []).includes("Files")) {
           event.preventDefault();
@@ -2670,18 +2709,18 @@ function NewChat({ state, adapter, onBack, onClose, onStarted, labels, memoryKey
       }, onDragLeave: (event) => {
         if (!event.currentTarget.contains(event.relatedTarget)) setDragging(false);
       }, onDrop: dropImages, children: [
-        adapter.pickContext ? /* @__PURE__ */ jsx9("button", { class: "scui-attach", type: "button", "aria-label": "Attach files or images", disabled: picking || context.length >= MAX_CONTEXT_ITEMS && images.length >= MAX_IMAGE_ITEMS || Boolean(starting), onClick: pickContext, children: picking ? /* @__PURE__ */ jsx9("i", { class: "scui-control-spinner" }) : /* @__PURE__ */ jsx9(UiIcon, { name: "attach", size: 17 }) }) : null,
+        adapter.pickContext ? /* @__PURE__ */ jsx9("button", { class: "scui-attach", type: "button", "aria-label": "Attach files or images", disabled: mode === "terminal" || picking || context.length >= MAX_CONTEXT_ITEMS && images.length >= MAX_IMAGE_ITEMS || Boolean(starting), onClick: pickContext, children: picking ? /* @__PURE__ */ jsx9("i", { class: "scui-control-spinner" }) : /* @__PURE__ */ jsx9(UiIcon, { name: "attach", size: 17 }) }) : null,
         /* @__PURE__ */ jsx9("textarea", { ref: textarea, rows: 3, "aria-label": "Message coding agent", placeholder: startable.length ? "What should the agent do?" : "No coding harness is available", value: draft, disabled: !startable.length || Boolean(starting), onPaste: pasteImages, onInput: (event) => {
           const value = event.currentTarget.value;
           setDraft(value);
-          boundedSet(newChatMemory, memoryKey, { harness, draft: value, context, images });
+          remember({ draft: value });
         }, onKeyDown: (event) => {
           if (isSendKey(event)) {
             event.preventDefault();
             send();
           }
         } }),
-        /* @__PURE__ */ jsx9("span", { children: /* @__PURE__ */ jsx9("button", { type: "button", class: "scui-send", "aria-label": "Start chat", disabled: !draft.trim() && !images.length || !harness || Boolean(starting), onClick: send, children: starting ? /* @__PURE__ */ jsx9("i", { class: "scui-control-spinner" }) : /* @__PURE__ */ jsx9(UiIcon, { name: "send", size: 17 }) }) })
+        /* @__PURE__ */ jsx9("span", { children: /* @__PURE__ */ jsx9("button", { type: "button", class: "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", { class: "scui-control-spinner" }) : /* @__PURE__ */ jsx9(UiIcon, { name: "send", size: 17 }) }) })
       ] })
     ] })
   ] });
@@ -2713,12 +2752,13 @@ function SupercodeMessenger({ state: stateInput, adapter, class: className = "",
   };
   const close = () => adapter.onClose?.();
   const Footer = slots.footer;
+  const HeaderActions = slots.headerActions;
   return /* @__PURE__ */ jsxs8("main", { class: `scui-root ${className}`, "data-view": view, "data-mode": state.mode, "aria-label": "Supercode messenger", children: [
     view === "list" ? /* @__PURE__ */ jsx9(SessionList, { state, adapter, focusKey: listFocus, onOpen: open, onNew: () => {
       setListFocus("@new");
       setView("new");
-    }, onClose: adapter.onClose ? close : void 0, components, labels: copy, memoryKey }) : null,
-    view === "new" ? /* @__PURE__ */ jsx9(NewChat, { state, adapter, onBack: () => setView("list"), onClose: adapter.onClose ? close : void 0, onStarted: () => setView("chat"), labels: copy, memoryKey }) : null,
+    }, onClose: adapter.onClose ? close : void 0, components, labels: copy, memoryKey, headerActions: HeaderActions }) : null,
+    view === "new" ? /* @__PURE__ */ jsx9(NewChat, { state, adapter, onBack: () => setView("list"), onClose: adapter.onClose ? close : void 0, onStarted: (mode) => setView(mode === "terminal" ? "list" : "chat"), labels: copy, memoryKey, headerActions: HeaderActions }) : null,
     view === "chat" ? /* @__PURE__ */ jsx9(Chat, { state, adapter, onBack: () => {
       setListFocus(state.attached?.key ?? listFocus);
       setView("list");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@volter-ai-dev/supercode-ui",
-  "version": "0.1.32",
+  "version": "0.1.34",
   "type": "module",
   "description": "Composable default UI kit for Supercode-powered coding-agent experiences",
   "exports": {

package/sessions.mjs

@@ -340,7 +340,7 @@ function SessionRow({ row, state, onOpen, now = Date.now() }) {
     ] })
   ] });
 }
-function SessionList({ state, adapter, onOpen, onNew, onClose, components = {}, labels = DEFAULT_LABELS, focusKey = null, memoryKey = state.workspace || "@default" }) {
+function SessionList({ state, adapter, onOpen, onNew, onClose, components = {}, labels = DEFAULT_LABELS, focusKey = null, memoryKey = state.workspace || "@default", headerActions: HeaderActions }) {
   const remembered = sessionListMemory.get(memoryKey) ?? { query: "", top: 0 };
   const [query, setQuery] = useState3(remembered.query);
   const [loadingMore, setLoadingMore] = useState3(false);
@@ -381,6 +381,7 @@ function SessionList({ state, adapter, onOpen, onNew, onClose, components = {},
           " recent conversations"
         ] })
       ] }),
+      HeaderActions ? /* @__PURE__ */ jsx6(HeaderActions, { state, adapter, value: "list" }) : null,
       /* @__PURE__ */ jsx6("button", { type: "button", "data-list-focus": "new", "aria-label": labels.newChat, disabled: !state.harnesses.some((item) => item.startable), onClick: onNew, children: /* @__PURE__ */ jsx6(UiIcon, { name: "plus", size: 18 }) }),
       onClose ? /* @__PURE__ */ jsx6("button", { type: "button", "aria-label": "Close", onClick: onClose, children: /* @__PURE__ */ jsx6(UiIcon, { name: "close", size: 18 }) }) : null
     ] }),

package/styles.css

@@ -191,6 +191,7 @@
 .scui-send,.scui-stop { display:grid; width:29px; height:29px; padding:0; place-items:center; border:0; border-radius:8px; background:var(--scui-accent); color:#fff; cursor:pointer }.scui-stop { background:var(--scui-danger) }.scui-send:disabled,.scui-stop:disabled { opacity:.4; cursor:default }.scui-control-spinner { box-sizing:border-box; width:13px; height:13px; border:1.5px solid currentColor; border-right-color:transparent; border-radius:50%; animation:scui-spin .75s linear infinite }
 .scui-queue { display:grid; gap:4px; max-height:85px; margin-bottom:6px; overflow:auto; font-size:10.5px }.scui-queue > span { display:flex; gap:6px; padding:4px 6px; border-radius:5px; background:var(--scui-fill) }.scui-queue > span > span { display:grid; min-width:0; overflow:hidden; text-overflow:ellipsis; white-space:nowrap }.scui-queue small { color:var(--scui-muted) }.scui-queue > span button { margin-left:auto; border:0; background:transparent }
 .scui-harness-picker { display:flex; align-items:center; gap:7px; margin-bottom:7px }.scui-harness-picker select { margin-left:auto; max-width:55%; padding:4px; border:1px solid var(--scui-border); border-radius:6px; background:var(--scui-bg); color:var(--scui-fg) }
+.scui-launch-modes { display:grid; grid-template-columns:repeat(2,minmax(0,1fr)); gap:5px; margin:0 0 7px; padding:0; border:0 }.scui-launch-modes legend { position:absolute; overflow:hidden; width:1px; height:1px; clip:rect(0 0 0 0); white-space:nowrap }.scui-launch-modes label { position:relative; min-width:0; cursor:pointer }.scui-launch-modes input { position:absolute; opacity:0; pointer-events:none }.scui-launch-modes label > span { display:flex; min-height:42px; flex-direction:column; justify-content:center; padding:6px 9px; border:1px solid var(--scui-border); border-radius:7px; background:var(--scui-bg); transition:border-color .14s ease,background .14s ease }.scui-launch-modes strong { font-size:11px; font-weight:650 }.scui-launch-modes small { overflow:hidden; color:var(--scui-muted); font-size:9px; text-overflow:ellipsis; white-space:nowrap }.scui-launch-modes input:checked + span { border-color:color-mix(in srgb,var(--scui-accent) 58%,var(--scui-border)); background:color-mix(in srgb,var(--scui-accent) 8%,var(--scui-bg)) }.scui-launch-modes input:focus-visible + span { outline:2px solid var(--scui-accent); outline-offset:1px }.scui-launch-modes:disabled label { cursor:default; opacity:.62 }
 .scui-new { display:grid; justify-items:center; gap:5px; margin:auto; padding:20px; color:var(--scui-muted); text-align:center }.scui-new > span { color:var(--scui-accent); font-size:28px }.scui-new strong { color:var(--scui-fg) }
 .scui-opening { position:absolute; z-index:30; inset:49px 0 0; display:flex; align-items:center; justify-content:center; gap:10px; padding:20px; background:var(--scui-bg) }.scui-opening > span { display:grid }.scui-opening small { color:var(--scui-muted) }.scui-opening > i { width:16px; height:16px; border:2px solid var(--scui-border); border-top-color:var(--scui-accent); border-radius:50%; animation:scui-spin .8s linear infinite }