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

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

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),
@@ -2550,32 +2554,39 @@ function Chat({ state, adapter, onBack, onNew, onClose, components, slots, label
 }
 function NewChat({ state, adapter, onBack, onClose, onStarted, labels, memoryKey }) {
   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 +2595,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 +2604,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 +2617,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 +2634,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 +2648,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));
     }
   };
@@ -2653,7 +2673,7 @@ function NewChat({ state, adapter, onBack, onClose, onStarted, labels, memoryKey
     ] }),
     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 +2687,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 +2729,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 }) }) })
       ] })
     ] })
   ] });
@@ -2742,7 +2777,7 @@ function SupercodeMessenger({ state: stateInput, adapter, class: className = "",
       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,
+    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 }) : null,
     view === "chat" ? /* @__PURE__ */ jsx9(Chat, { state, adapter, onBack: () => {
       setListFocus(state.attached?.key ?? listFocus);
       setView("list");

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),

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),
@@ -2529,32 +2533,39 @@ function Chat({ state, adapter, onBack, onNew, onClose, components, slots, label
 }
 function NewChat({ state, adapter, onBack, onClose, onStarted, labels, memoryKey }) {
   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 +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) => {
@@ -2572,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));
@@ -2585,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.");
@@ -2598,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;
@@ -2612,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));
     }
   };
@@ -2632,7 +2652,7 @@ function NewChat({ state, adapter, onBack, onClose, onStarted, labels, memoryKey
     ] }),
     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 +2666,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 +2708,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 }) }) })
       ] })
     ] })
   ] });
@@ -2721,7 +2756,7 @@ function SupercodeMessenger({ state: stateInput, adapter, class: className = "",
       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,
+    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 }) : 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' }

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),
@@ -2526,32 +2530,39 @@ function Chat({ state, adapter, onBack, onNew, onClose, components, slots, label
 }
 function NewChat({ state, adapter, onBack, onClose, onStarted, labels, memoryKey }) {
   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 +2571,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 +2580,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 +2593,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 +2610,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 +2624,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));
     }
   };
@@ -2629,7 +2649,7 @@ function NewChat({ state, adapter, onBack, onClose, onStarted, labels, memoryKey
     ] }),
     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 +2663,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 +2705,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 }) }) })
       ] })
     ] })
   ] });
@@ -2718,7 +2753,7 @@ function SupercodeMessenger({ state: stateInput, adapter, class: className = "",
       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,
+    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 }) : 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.33",
   "type": "module",
   "description": "Composable default UI kit for Supercode-powered coding-agent experiences",
   "exports": {

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 }