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

package/README.md

@@ -98,6 +98,18 @@ drafts, and artifact materialization remain explicit callbacks. A
 browser should receive projected state from a trusted host rather than instantiate a local
 controller or gain filesystem authority.
 
+Native continuation is headless by default. A host with a real terminal provider can add
+`terminal` to `continuationModes` and handle `onResumeTerminal`; the continuation bar then exposes
+that strategy beside “Continue here.” The UI never infers terminal support from a generic runtime
+handoff, and never presents a terminal strategy when the host cannot create one.
+
+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

@@ -17,6 +17,7 @@ var DEFAULT_LABELS = Object.freeze({
   searchChats: "Search chats",
   askAgent: "Ask your agent\u2026",
   continueHere: "Continue here",
+  continueWithTerminal: "Continue with terminal",
   joinLive: "Join live",
   forkHere: "Fork here"
 });
@@ -32,6 +33,7 @@ var EMPTY_UI_STATE = Object.freeze({
   strategy: null,
   canSend: false,
   canResume: false,
+  continuationModes: Object.freeze([]),
   canBranch: false,
   canAttach: false,
   canDetach: false,
@@ -704,6 +706,8 @@ function normalizeUiState(value) {
   const pill = record(raw.pill);
   const history = record(raw.history);
   const attachError = record(raw.attachError);
+  const canResume = raw.canResume === true;
+  const continuationModes = Array.isArray(raw.continuationModes) ? [...new Set(raw.continuationModes.filter((mode) => mode === "headless" || mode === "terminal"))] : canResume ? ["headless"] : [];
   return {
     pill: { tone: ["live", "warn", "dead"].includes(pill?.tone) ? pill.tone : "off", label: string(pill?.label, "connecting\u2026") },
     startup: STARTUP.has(raw.startup) ? raw.startup : "connecting",
@@ -715,7 +719,8 @@ function normalizeUiState(value) {
     mode: MODES.has(raw.mode) ? raw.mode : "none",
     strategy: STRATEGIES.has(raw.strategy) ? raw.strategy : null,
     canSend: raw.canSend === true,
-    canResume: raw.canResume === true,
+    canResume,
+    continuationModes,
     canBranch: raw.canBranch === true,
     canAttach: raw.canAttach === true,
     canDetach: raw.canDetach === true,
@@ -739,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),
@@ -763,9 +772,9 @@ function sessionDisplayName(session) {
 function sessionActivity(state, row) {
   if (state.needsInput && row.active) return "needs-input";
   if (state.busy && row.active) return "working";
+  if (row.runtimeStatus === "busy") return "working";
   const attention = state.attention.find((item) => item.key === row.key)?.kind;
   if (attention) return attention;
-  if (row.runtimeStatus === "busy") return "working";
   if (row.runtimeStatus === "running") return "running";
   if (row.live || row.runtimeStatus === "idle") return "recent";
   return "idle";
@@ -1173,6 +1182,7 @@ function ContinuationBar({ state, adapter, labels = DEFAULT_LABELS }) {
   const row = attached?.key ? state.sessions.find((item) => item.key === attached.key) : null;
   const activeElsewhere = row?.runtimeStatus === "running" || row?.runtimeStatus === "busy" || row?.runtimeStatus === "idle";
   const resume = canContinueHere(state);
+  const terminal = resume && state.continuationModes?.includes("terminal");
   const join = state.canAttach;
   const branch = state.canBranch;
   if (!resume && !join && !branch) return /* @__PURE__ */ jsx3("div", { class: "scui-continuation", children: /* @__PURE__ */ jsxs3("span", { children: [
@@ -1184,7 +1194,10 @@ function ContinuationBar({ state, adapter, labels = DEFAULT_LABELS }) {
       /* @__PURE__ */ jsx3("strong", { children: activeElsewhere ? "Active elsewhere" : "Read-only" }),
       /* @__PURE__ */ jsx3("small", { children: join ? "Join the proven live runtime without taking it over." : resume ? `Resume this ${harnessDisplayName(state.harness)} session here.` : "Start an independent continuation." })
     ] }),
-    /* @__PURE__ */ jsx3("button", { type: "button", disabled: Boolean(state.operation), onClick: () => adapter.onIntent(join ? { action: "join" } : resume ? { action: "resume" } : { action: "branch" }), children: join ? labels.joinLive : resume ? labels.continueHere : labels.forkHere })
+    /* @__PURE__ */ jsxs3("span", { class: "scui-continuation-actions", children: [
+      /* @__PURE__ */ jsx3("button", { type: "button", disabled: Boolean(state.operation), onClick: () => adapter.onIntent(join ? { action: "join" } : resume ? { action: "resume", mode: "headless" } : { action: "branch" }), children: join ? labels.joinLive : resume ? labels.continueHere : labels.forkHere }),
+      terminal ? /* @__PURE__ */ jsx3("button", { type: "button", class: "scui-secondary", disabled: Boolean(state.operation), onClick: () => adapter.onIntent({ action: "resume", mode: "terminal" }), children: labels.continueWithTerminal ?? DEFAULT_LABELS.continueWithTerminal }) : null
+    ] })
   ] });
 }
 function Composer({ state, adapter, labels = DEFAULT_LABELS, memoryKey = state.attached?.key || `${state.harness}:${state.workspace}`, pendingStatus = null, restoreDraft = null, onPending, onDraftRestored }) {
@@ -2541,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);
@@ -2575,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) => {
@@ -2584,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));
@@ -2597,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.");
@@ -2610,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;
@@ -2624,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));
     }
   };
@@ -2644,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" }),
@@ -2658,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();
@@ -2685,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 }) }) })
       ] })
     ] })
   ] });
@@ -2733,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/composer.mjs

@@ -17,6 +17,7 @@ var DEFAULT_LABELS = Object.freeze({
   searchChats: "Search chats",
   askAgent: "Ask your agent\u2026",
   continueHere: "Continue here",
+  continueWithTerminal: "Continue with terminal",
   joinLive: "Join live",
   forkHere: "Fork here"
 });
@@ -32,6 +33,7 @@ var EMPTY_UI_STATE = Object.freeze({
   strategy: null,
   canSend: false,
   canResume: false,
+  continuationModes: Object.freeze([]),
   canBranch: false,
   canAttach: false,
   canDetach: false,
@@ -257,6 +259,7 @@ function ContinuationBar({ state, adapter, labels = DEFAULT_LABELS }) {
   const row = attached?.key ? state.sessions.find((item) => item.key === attached.key) : null;
   const activeElsewhere = row?.runtimeStatus === "running" || row?.runtimeStatus === "busy" || row?.runtimeStatus === "idle";
   const resume = canContinueHere(state);
+  const terminal = resume && state.continuationModes?.includes("terminal");
   const join = state.canAttach;
   const branch = state.canBranch;
   if (!resume && !join && !branch) return /* @__PURE__ */ jsx3("div", { class: "scui-continuation", children: /* @__PURE__ */ jsxs3("span", { children: [
@@ -268,7 +271,10 @@ function ContinuationBar({ state, adapter, labels = DEFAULT_LABELS }) {
       /* @__PURE__ */ jsx3("strong", { children: activeElsewhere ? "Active elsewhere" : "Read-only" }),
       /* @__PURE__ */ jsx3("small", { children: join ? "Join the proven live runtime without taking it over." : resume ? `Resume this ${harnessDisplayName(state.harness)} session here.` : "Start an independent continuation." })
     ] }),
-    /* @__PURE__ */ jsx3("button", { type: "button", disabled: Boolean(state.operation), onClick: () => adapter.onIntent(join ? { action: "join" } : resume ? { action: "resume" } : { action: "branch" }), children: join ? labels.joinLive : resume ? labels.continueHere : labels.forkHere })
+    /* @__PURE__ */ jsxs3("span", { class: "scui-continuation-actions", children: [
+      /* @__PURE__ */ jsx3("button", { type: "button", disabled: Boolean(state.operation), onClick: () => adapter.onIntent(join ? { action: "join" } : resume ? { action: "resume", mode: "headless" } : { action: "branch" }), children: join ? labels.joinLive : resume ? labels.continueHere : labels.forkHere }),
+      terminal ? /* @__PURE__ */ jsx3("button", { type: "button", class: "scui-secondary", disabled: Boolean(state.operation), onClick: () => adapter.onIntent({ action: "resume", mode: "terminal" }), children: labels.continueWithTerminal ?? DEFAULT_LABELS.continueWithTerminal }) : null
+    ] })
   ] });
 }
 function Composer({ state, adapter, labels = DEFAULT_LABELS, memoryKey = state.attached?.key || `${state.harness}:${state.workspace}`, pendingStatus = null, restoreDraft = null, onPending, onDraftRestored }) {

package/controller.d.ts

@@ -8,6 +8,7 @@ import type {
 } from '@volter-ai-dev/supercode-client';
 import type {
   AttachedSessionModel,
+  ContinuationMode,
   SessionAttention,
   SessionRowModel,
   StartupPhase,
@@ -40,6 +41,8 @@ export interface ClientProjectionOptions {
   exportBackTarget?: SessionFormat | null;
   exportReceipt?: SupercodeUiState['exportReceipt'];
   reductionReceipt?: SupercodeUiState['reductionReceipt'];
+  /** Host-provided execution strategies. A plain controller projects headless resume only. */
+  continuationModes?: ContinuationMode[];
   /** Trusted-host inventory and lifecycle overlays (for example a machine-wide session catalog). */
   sessions?: SessionRowModel[];
   attached?: AttachedSessionModel | null;
@@ -81,6 +84,8 @@ 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

@@ -366,6 +366,7 @@ function projectClientSnapshotInternal(snapshot, options, imageRegistry) {
     strategy: snapshot.connection?.strategy ?? null,
     canSend: actions.send === true,
     canResume: actions.resume === true,
+    continuationModes: options.continuationModes ?? (actions.resume === true ? ['headless'] : []),
     canBranch: actions.branch === true,
     canAttach: actions.attach === true,
     canDetach: actions.detach === true,
@@ -446,10 +447,22 @@ 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 } : {}) });
   }
-  if (intent.action === 'resume' && active) return controller.dispatch({ type: 'resume', sessionKey: active });
+  if (intent.action === 'resume' && active) {
+    if (intent.mode === 'terminal') {
+      return options.onResumeTerminal
+        ? options.onResumeTerminal(intent)
+        : options.onUnsupported?.(intent);
+    }
+    return controller.dispatch({ type: 'resume', sessionKey: active });
+  }
   if (intent.action === 'join' && active) return controller.dispatch({ type: 'attach', sessionKey: active });
   if (intent.action === 'detach') return controller.dispatch({ type: 'detach' });
   if (intent.action === 'branch' && active) return controller.dispatch({ type: 'branch', sessionKey: active, ...(intent.targetHarness ? { targetHarness: intent.targetHarness } : {}) });

package/conversation.mjs

@@ -18,6 +18,7 @@ var DEFAULT_LABELS = Object.freeze({
   searchChats: "Search chats",
   askAgent: "Ask your agent\u2026",
   continueHere: "Continue here",
+  continueWithTerminal: "Continue with terminal",
   joinLive: "Join live",
   forkHere: "Fork here"
 });
@@ -33,6 +34,7 @@ var EMPTY_UI_STATE = Object.freeze({
   strategy: null,
   canSend: false,
   canResume: false,
+  continuationModes: Object.freeze([]),
   canBranch: false,
   canAttach: false,
   canDetach: false,

package/core.d.ts

@@ -1,5 +1,6 @@
 export type {
   AttachedSessionModel,
+  ContinuationMode,
   ControlStrategy,
   HarnessId,
   HarnessOption,

package/core.mjs

@@ -14,6 +14,7 @@ export const DEFAULT_LABELS = Object.freeze({
   searchChats: 'Search chats',
   askAgent: 'Ask your agent…',
   continueHere: 'Continue here',
+  continueWithTerminal: 'Continue with terminal',
   joinLive: 'Join live',
   forkHere: 'Fork here',
 });
@@ -30,6 +31,7 @@ export const EMPTY_UI_STATE = Object.freeze({
   strategy: null,
   canSend: false,
   canResume: false,
+  continuationModes: Object.freeze([]),
   canBranch: false,
   canAttach: false,
   canDetach: false,
@@ -754,6 +756,10 @@ export function normalizeUiState(value) {
   const pill = record(raw.pill);
   const history = record(raw.history);
   const attachError = record(raw.attachError);
+  const canResume = raw.canResume === true;
+  const continuationModes = Array.isArray(raw.continuationModes)
+    ? [...new Set(raw.continuationModes.filter((mode) => mode === 'headless' || mode === 'terminal'))]
+    : canResume ? ['headless'] : [];
   return {
     pill: { tone: ['live', 'warn', 'dead'].includes(pill?.tone) ? pill.tone : 'off', label: string(pill?.label, 'connecting…') },
     startup: STARTUP.has(raw.startup) ? raw.startup : 'connecting',
@@ -765,7 +771,8 @@ export function normalizeUiState(value) {
     mode: MODES.has(raw.mode) ? raw.mode : 'none',
     strategy: STRATEGIES.has(raw.strategy) ? raw.strategy : null,
     canSend: raw.canSend === true,
-    canResume: raw.canResume === true,
+    canResume,
+    continuationModes,
     canBranch: raw.canBranch === true,
     canAttach: raw.canAttach === true,
     canDetach: raw.canDetach === true,
@@ -789,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),
@@ -818,9 +833,11 @@ export function sessionDisplayName(session) {
 export function sessionActivity(state, row) {
   if (state.needsInput && row.active) return 'needs-input';
   if (state.busy && row.active) return 'working';
+  // Unread/finished attention has its own badge. It must not suppress the
+  // transient working indicator when the harness proves this row is busy.
+  if (row.runtimeStatus === 'busy') return 'working';
   const attention = state.attention.find((item) => item.key === row.key)?.kind;
   if (attention) return attention;
-  if (row.runtimeStatus === 'busy') return 'working';
   if (row.runtimeStatus === 'running') return 'running';
   if (row.live || row.runtimeStatus === 'idle') return 'recent';
   return 'idle';

package/embed.mjs

@@ -20,6 +20,7 @@ var DEFAULT_LABELS = Object.freeze({
   searchChats: "Search chats",
   askAgent: "Ask your agent\u2026",
   continueHere: "Continue here",
+  continueWithTerminal: "Continue with terminal",
   joinLive: "Join live",
   forkHere: "Fork here"
 });
@@ -35,6 +36,7 @@ var EMPTY_UI_STATE = Object.freeze({
   strategy: null,
   canSend: false,
   canResume: false,
+  continuationModes: Object.freeze([]),
   canBranch: false,
   canAttach: false,
   canDetach: false,
@@ -707,6 +709,8 @@ function normalizeUiState(value) {
   const pill = record(raw.pill);
   const history = record(raw.history);
   const attachError = record(raw.attachError);
+  const canResume = raw.canResume === true;
+  const continuationModes = Array.isArray(raw.continuationModes) ? [...new Set(raw.continuationModes.filter((mode) => mode === "headless" || mode === "terminal"))] : canResume ? ["headless"] : [];
   return {
     pill: { tone: ["live", "warn", "dead"].includes(pill?.tone) ? pill.tone : "off", label: string(pill?.label, "connecting\u2026") },
     startup: STARTUP.has(raw.startup) ? raw.startup : "connecting",
@@ -718,7 +722,8 @@ function normalizeUiState(value) {
     mode: MODES.has(raw.mode) ? raw.mode : "none",
     strategy: STRATEGIES.has(raw.strategy) ? raw.strategy : null,
     canSend: raw.canSend === true,
-    canResume: raw.canResume === true,
+    canResume,
+    continuationModes,
     canBranch: raw.canBranch === true,
     canAttach: raw.canAttach === true,
     canDetach: raw.canDetach === true,
@@ -742,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),
@@ -766,9 +775,9 @@ function sessionDisplayName(session) {
 function sessionActivity(state, row) {
   if (state.needsInput && row.active) return "needs-input";
   if (state.busy && row.active) return "working";
+  if (row.runtimeStatus === "busy") return "working";
   const attention = state.attention.find((item) => item.key === row.key)?.kind;
   if (attention) return attention;
-  if (row.runtimeStatus === "busy") return "working";
   if (row.runtimeStatus === "running") return "running";
   if (row.live || row.runtimeStatus === "idle") return "recent";
   return "idle";
@@ -1179,6 +1188,7 @@ function ContinuationBar({ state, adapter, labels = DEFAULT_LABELS }) {
   const row = attached?.key ? state.sessions.find((item) => item.key === attached.key) : null;
   const activeElsewhere = row?.runtimeStatus === "running" || row?.runtimeStatus === "busy" || row?.runtimeStatus === "idle";
   const resume = canContinueHere(state);
+  const terminal = resume && state.continuationModes?.includes("terminal");
   const join = state.canAttach;
   const branch = state.canBranch;
   if (!resume && !join && !branch) return /* @__PURE__ */ jsx3("div", { class: "scui-continuation", children: /* @__PURE__ */ jsxs3("span", { children: [
@@ -1190,7 +1200,10 @@ function ContinuationBar({ state, adapter, labels = DEFAULT_LABELS }) {
       /* @__PURE__ */ jsx3("strong", { children: activeElsewhere ? "Active elsewhere" : "Read-only" }),
       /* @__PURE__ */ jsx3("small", { children: join ? "Join the proven live runtime without taking it over." : resume ? `Resume this ${harnessDisplayName(state.harness)} session here.` : "Start an independent continuation." })
     ] }),
-    /* @__PURE__ */ jsx3("button", { type: "button", disabled: Boolean(state.operation), onClick: () => adapter.onIntent(join ? { action: "join" } : resume ? { action: "resume" } : { action: "branch" }), children: join ? labels.joinLive : resume ? labels.continueHere : labels.forkHere })
+    /* @__PURE__ */ jsxs3("span", { class: "scui-continuation-actions", children: [
+      /* @__PURE__ */ jsx3("button", { type: "button", disabled: Boolean(state.operation), onClick: () => adapter.onIntent(join ? { action: "join" } : resume ? { action: "resume", mode: "headless" } : { action: "branch" }), children: join ? labels.joinLive : resume ? labels.continueHere : labels.forkHere }),
+      terminal ? /* @__PURE__ */ jsx3("button", { type: "button", class: "scui-secondary", disabled: Boolean(state.operation), onClick: () => adapter.onIntent({ action: "resume", mode: "terminal" }), children: labels.continueWithTerminal ?? DEFAULT_LABELS.continueWithTerminal }) : null
+    ] })
   ] });
 }
 function Composer({ state, adapter, labels = DEFAULT_LABELS, memoryKey = state.attached?.key || `${state.harness}:${state.workspace}`, pendingStatus = null, restoreDraft = null, onPending, onDraftRestored }) {
@@ -2520,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);
@@ -2554,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) => {
@@ -2563,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));
@@ -2576,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.");
@@ -2589,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;
@@ -2603,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));
     }
   };
@@ -2623,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" }),
@@ -2637,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();
@@ -2664,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 }) }) })
       ] })
     ] })
   ] });
@@ -2712,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,6 +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 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 {
@@ -13,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 {
@@ -234,6 +241,8 @@ export interface SupercodeUiState {
   strategy: ControlStrategy;
   canSend: boolean;
   canResume: boolean;
+  /** Execution strategies the current host can actually provide. Headless is the default. */
+  continuationModes: ContinuationMode[];
   canBranch: boolean;
   canAttach: boolean;
   canDetach: boolean;
@@ -284,8 +293,8 @@ 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: 'resume' }
+  | { action: 'new'; harness: HarnessId; mode?: ExecutionMode; text: string; context?: TranscriptContext[]; images?: Array<TranscriptImage & { url: string }> }
+  | { action: 'resume'; mode?: ContinuationMode }
   | { action: 'join' }
   | { action: 'detach' }
   | { action: 'branch'; targetHarness?: HarnessId }
@@ -316,6 +325,7 @@ export interface MessengerLabels {
   searchChats: string;
   askAgent: string;
   continueHere: string;
+  continueWithTerminal?: string;
   joinLive: string;
   forkHere: string;
 }

package/messenger.mjs

@@ -17,6 +17,7 @@ var DEFAULT_LABELS = Object.freeze({
   searchChats: "Search chats",
   askAgent: "Ask your agent\u2026",
   continueHere: "Continue here",
+  continueWithTerminal: "Continue with terminal",
   joinLive: "Join live",
   forkHere: "Fork here"
 });
@@ -32,6 +33,7 @@ var EMPTY_UI_STATE = Object.freeze({
   strategy: null,
   canSend: false,
   canResume: false,
+  continuationModes: Object.freeze([]),
   canBranch: false,
   canAttach: false,
   canDetach: false,
@@ -704,6 +706,8 @@ function normalizeUiState(value) {
   const pill = record(raw.pill);
   const history = record(raw.history);
   const attachError = record(raw.attachError);
+  const canResume = raw.canResume === true;
+  const continuationModes = Array.isArray(raw.continuationModes) ? [...new Set(raw.continuationModes.filter((mode) => mode === "headless" || mode === "terminal"))] : canResume ? ["headless"] : [];
   return {
     pill: { tone: ["live", "warn", "dead"].includes(pill?.tone) ? pill.tone : "off", label: string(pill?.label, "connecting\u2026") },
     startup: STARTUP.has(raw.startup) ? raw.startup : "connecting",
@@ -715,7 +719,8 @@ function normalizeUiState(value) {
     mode: MODES.has(raw.mode) ? raw.mode : "none",
     strategy: STRATEGIES.has(raw.strategy) ? raw.strategy : null,
     canSend: raw.canSend === true,
-    canResume: raw.canResume === true,
+    canResume,
+    continuationModes,
     canBranch: raw.canBranch === true,
     canAttach: raw.canAttach === true,
     canDetach: raw.canDetach === true,
@@ -739,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),
@@ -763,9 +772,9 @@ function sessionDisplayName(session) {
 function sessionActivity(state, row) {
   if (state.needsInput && row.active) return "needs-input";
   if (state.busy && row.active) return "working";
+  if (row.runtimeStatus === "busy") return "working";
   const attention = state.attention.find((item) => item.key === row.key)?.kind;
   if (attention) return attention;
-  if (row.runtimeStatus === "busy") return "working";
   if (row.runtimeStatus === "running") return "running";
   if (row.live || row.runtimeStatus === "idle") return "recent";
   return "idle";
@@ -1176,6 +1185,7 @@ function ContinuationBar({ state, adapter, labels = DEFAULT_LABELS }) {
   const row = attached?.key ? state.sessions.find((item) => item.key === attached.key) : null;
   const activeElsewhere = row?.runtimeStatus === "running" || row?.runtimeStatus === "busy" || row?.runtimeStatus === "idle";
   const resume = canContinueHere(state);
+  const terminal = resume && state.continuationModes?.includes("terminal");
   const join = state.canAttach;
   const branch = state.canBranch;
   if (!resume && !join && !branch) return /* @__PURE__ */ jsx3("div", { class: "scui-continuation", children: /* @__PURE__ */ jsxs3("span", { children: [
@@ -1187,7 +1197,10 @@ function ContinuationBar({ state, adapter, labels = DEFAULT_LABELS }) {
       /* @__PURE__ */ jsx3("strong", { children: activeElsewhere ? "Active elsewhere" : "Read-only" }),
       /* @__PURE__ */ jsx3("small", { children: join ? "Join the proven live runtime without taking it over." : resume ? `Resume this ${harnessDisplayName(state.harness)} session here.` : "Start an independent continuation." })
     ] }),
-    /* @__PURE__ */ jsx3("button", { type: "button", disabled: Boolean(state.operation), onClick: () => adapter.onIntent(join ? { action: "join" } : resume ? { action: "resume" } : { action: "branch" }), children: join ? labels.joinLive : resume ? labels.continueHere : labels.forkHere })
+    /* @__PURE__ */ jsxs3("span", { class: "scui-continuation-actions", children: [
+      /* @__PURE__ */ jsx3("button", { type: "button", disabled: Boolean(state.operation), onClick: () => adapter.onIntent(join ? { action: "join" } : resume ? { action: "resume", mode: "headless" } : { action: "branch" }), children: join ? labels.joinLive : resume ? labels.continueHere : labels.forkHere }),
+      terminal ? /* @__PURE__ */ jsx3("button", { type: "button", class: "scui-secondary", disabled: Boolean(state.operation), onClick: () => adapter.onIntent({ action: "resume", mode: "terminal" }), children: labels.continueWithTerminal ?? DEFAULT_LABELS.continueWithTerminal }) : null
+    ] })
   ] });
 }
 function Composer({ state, adapter, labels = DEFAULT_LABELS, memoryKey = state.attached?.key || `${state.harness}:${state.workspace}`, pendingStatus = null, restoreDraft = null, onPending, onDraftRestored }) {
@@ -2517,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);
@@ -2551,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) => {
@@ -2560,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));
@@ -2573,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.");
@@ -2586,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;
@@ -2600,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));
     }
   };
@@ -2620,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" }),
@@ -2634,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();
@@ -2661,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 }) }) })
       ] })
     ] })
   ] });
@@ -2709,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.31",
+  "version": "0.1.33",
   "type": "module",
   "description": "Composable default UI kit for Supercode-powered coding-agent experiences",
   "exports": {

package/sessions.mjs

@@ -17,6 +17,7 @@ var DEFAULT_LABELS = Object.freeze({
   searchChats: "Search chats",
   askAgent: "Ask your agent\u2026",
   continueHere: "Continue here",
+  continueWithTerminal: "Continue with terminal",
   joinLive: "Join live",
   forkHere: "Fork here"
 });
@@ -32,6 +33,7 @@ var EMPTY_UI_STATE = Object.freeze({
   strategy: null,
   canSend: false,
   canResume: false,
+  continuationModes: Object.freeze([]),
   canBranch: false,
   canAttach: false,
   canDetach: false,
@@ -81,9 +83,9 @@ function sessionDisplayName(session) {
 function sessionActivity(state, row) {
   if (state.needsInput && row.active) return "needs-input";
   if (state.busy && row.active) return "working";
+  if (row.runtimeStatus === "busy") return "working";
   const attention = state.attention.find((item) => item.key === row.key)?.kind;
   if (attention) return attention;
-  if (row.runtimeStatus === "busy") return "working";
   if (row.runtimeStatus === "running") return "running";
   if (row.live || row.runtimeStatus === "idle") return "recent";
   return "idle";

package/settings.mjs

@@ -17,6 +17,7 @@ var DEFAULT_LABELS = Object.freeze({
   searchChats: "Search chats",
   askAgent: "Ask your agent\u2026",
   continueHere: "Continue here",
+  continueWithTerminal: "Continue with terminal",
   joinLive: "Join live",
   forkHere: "Fork here"
 });
@@ -32,6 +33,7 @@ var EMPTY_UI_STATE = Object.freeze({
   strategy: null,
   canSend: false,
   canResume: false,
+  continuationModes: Object.freeze([]),
   canBranch: false,
   canAttach: false,
   canDetach: false,

package/styles.css

@@ -179,7 +179,7 @@
 .scui-plan > summary { display:flex; justify-content:space-between; padding:6px 8px; border:1px solid var(--scui-border); border-radius:7px; background:var(--scui-bg-raised) }.scui-plan ol { display:grid; gap:4px; box-sizing:border-box; max-height:140px; margin:5px 0 0; padding:7px 8px 7px 25px; overflow:auto; border:1px solid var(--scui-border); border-radius:7px }.scui-plan li[data-status="completed"] { color:var(--scui-fg); text-decoration:line-through }
 .scui-working { display:flex; align-items:center; gap:4px; color:var(--scui-muted) }.scui-working > span { color:var(--scui-accent) }.scui-working > i { width:4px; height:4px; border-radius:50%; background:currentColor; animation:scui-dots 1.2s infinite }.scui-working > i:nth-of-type(2) { animation-delay:.15s }.scui-working > i:nth-of-type(3) { animation-delay:.3s }
 
-.scui-continuation { display:flex; align-items:center; gap:8px; padding:7px 9px; border-top:1px solid var(--scui-border); background:var(--scui-bg-raised) }.scui-continuation > span { display:grid; flex:1 }.scui-continuation small { color:var(--scui-muted); font-size:10px }.scui-continuation button { padding:5px 8px; border:1px solid var(--scui-accent); border-radius:7px; background:transparent; color:var(--scui-accent); cursor:pointer }
+.scui-continuation { display:flex; align-items:center; gap:8px; padding:7px 9px; border-top:1px solid var(--scui-border); background:var(--scui-bg-raised) }.scui-continuation > span:not(.scui-continuation-actions) { display:grid; flex:1 }.scui-continuation small { color:var(--scui-muted); font-size:10px }.scui-continuation-actions { display:flex; align-items:center; gap:5px; flex-wrap:wrap; justify-content:flex-end }.scui-continuation button { padding:5px 8px; border:1px solid var(--scui-accent); border-radius:7px; background:transparent; color:var(--scui-accent); cursor:pointer; white-space:nowrap }.scui-continuation button.scui-secondary { border-color:var(--scui-border-strong); color:var(--scui-fg) }
 .scui-compose { flex:none; padding:8px; border-top:1px solid var(--scui-border); background:var(--scui-bg-raised) }
 .scui-envelope { display:flex; align-items:flex-end; gap:7px; padding:7px; border:1px solid var(--scui-border-strong); border-radius:16px; background:var(--scui-bg) }.scui-envelope textarea { flex:1; min-width:0; min-height:34px; max-height:150px; resize:none; overflow-y:hidden; border:0; outline:0; background:transparent; color:var(--scui-fg) }.scui-envelope > span { display:flex; gap:4px }
 .scui-envelope.scui-drop-target { border-color:var(--scui-accent); background:color-mix(in srgb,var(--scui-accent) 7%,var(--scui-bg)); box-shadow:0 0 0 2px color-mix(in srgb,var(--scui-accent) 16%,transparent) }
@@ -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 }