@volter-ai-dev/supercode-ui 0.1.1 → 0.1.3

package/conversation.mjs

@@ -1,11 +1,12 @@
-// src/components.jsx
-import MarkdownIt from "markdown-it";
-import { useEffect, useId, useLayoutEffect, useMemo, useRef, useState } from "preact/hooks";
+// src/conversation.jsx
+import { useEffect, useId, useLayoutEffect, useRef, useState } from "preact/hooks";
 
 // core.mjs
 var HARNESS_NAMES = Object.freeze({
   "claude-code": "Claude Code",
   codex: "Codex",
+  gemini: "Gemini CLI",
+  goose: "Goose",
   opencode: "OpenCode",
   pi: "Pi",
   grok: "Grok"
@@ -109,8 +110,10 @@ function activitySummary(entries) {
   return `Activity \xB7 ${Object.entries(labels).flatMap(([key, label]) => counts.has(key) ? [`${counts.get(key)} ${label}`] : []).join(" \xB7 ")}`;
 }
 
-// src/components.jsx
-import { jsx, jsxs } from "preact/jsx-runtime";
+// src/markdown.jsx
+import MarkdownIt from "markdown-it";
+import { useMemo } from "preact/hooks";
+import { jsx } from "preact/jsx-runtime";
 var markdown = new MarkdownIt({ html: false, linkify: true, breaks: false });
 var defaultLinkOpen = markdown.renderer.rules.link_open;
 markdown.renderer.rules.link_open = (tokens, index, options, env, self) => {
@@ -122,6 +125,17 @@ function Markdown({ value }) {
   const html = useMemo(() => markdown.render(value), [value]);
   return /* @__PURE__ */ jsx("div", { class: "scui-markdown", dangerouslySetInnerHTML: { __html: html } });
 }
+
+// src/memory.js
+var MEMORY_LIMIT = 100;
+function boundedSet(map, key, value) {
+  map.delete(key);
+  map.set(key, value);
+  while (map.size > MEMORY_LIMIT) map.delete(map.keys().next().value);
+}
+
+// src/conversation.jsx
+import { jsx as jsx2, jsxs } from "preact/jsx-runtime";
 function LoadingStatus({ state, compact = false }) {
   const copy = {
     connecting: ["Connecting to coding agents", "Checking installed harnesses and capabilities.", 0],
@@ -130,12 +144,12 @@ function LoadingStatus({ state, compact = false }) {
     ready: ["Ready", "Coding sessions are up to date.", 3]
   }[state.startup];
   return /* @__PURE__ */ jsxs("div", { class: `scui-loading${compact ? " scui-loading-compact" : ""}`, role: "status", "aria-busy": state.startup !== "ready", children: [
-    /* @__PURE__ */ jsx("span", { class: "scui-orbit", "aria-hidden": "true", children: /* @__PURE__ */ jsx("i", {}) }),
+    /* @__PURE__ */ jsx2("span", { class: "scui-orbit", "aria-hidden": "true", children: /* @__PURE__ */ jsx2("i", {}) }),
     /* @__PURE__ */ jsxs("span", { class: "scui-loading-copy", children: [
-      /* @__PURE__ */ jsx("strong", { children: copy[0] }),
-      /* @__PURE__ */ jsx("small", { children: copy[1] })
+      /* @__PURE__ */ jsx2("strong", { children: copy[0] }),
+      /* @__PURE__ */ jsx2("small", { children: copy[1] })
     ] }),
-    /* @__PURE__ */ jsx("span", { class: "scui-progress", "aria-hidden": "true", children: [1, 2, 3].map((step) => /* @__PURE__ */ jsx("i", { "data-progress": step <= copy[2] ? "done" : step === copy[2] + 1 ? "current" : "waiting" }, step)) })
+    /* @__PURE__ */ jsx2("span", { class: "scui-progress", "aria-hidden": "true", children: [1, 2, 3].map((step) => /* @__PURE__ */ jsx2("i", { "data-progress": step <= copy[2] ? "done" : step === copy[2] + 1 ? "current" : "waiting" }, step)) })
   ] });
 }
 function RequestCard({ entry, adapter, canRespond }) {
@@ -148,11 +162,11 @@ function RequestCard({ entry, adapter, canRespond }) {
     ] });
   }
   return /* @__PURE__ */ jsxs("section", { class: "scui-request", "aria-label": `${request.requestKind} needs input`, children: [
-    /* @__PURE__ */ jsx("strong", { children: "Agent needs input" }),
-    /* @__PURE__ */ jsx(Markdown, { value: request.payloadText || entry.text }),
+    /* @__PURE__ */ jsx2("strong", { children: "Agent needs input" }),
+    /* @__PURE__ */ jsx2(Markdown, { value: request.payloadText || entry.text }),
     /* @__PURE__ */ jsxs("div", { class: "scui-request-actions", children: [
-      request.options.map((option) => /* @__PURE__ */ jsx("button", { type: "button", disabled: !canRespond, onClick: () => adapter.onIntent({ action: "respond", requestId: request.requestId, optionId: option.optionId }), children: option.name }, option.optionId)),
-      request.cancellable ? /* @__PURE__ */ jsx("button", { type: "button", disabled: !canRespond, onClick: () => adapter.onIntent({ action: "respond", requestId: request.requestId, optionId: null }), children: "Cancel" }) : null
+      request.options.map((option) => /* @__PURE__ */ jsx2("button", { type: "button", disabled: !canRespond, onClick: () => adapter.onIntent({ action: "respond", requestId: request.requestId, optionId: option.optionId }), children: option.name }, option.optionId)),
+      request.cancellable ? /* @__PURE__ */ jsx2("button", { type: "button", disabled: !canRespond, onClick: () => adapter.onIntent({ action: "respond", requestId: request.requestId, optionId: null }), children: "Cancel" }) : null
     ] })
   ] });
 }
@@ -163,25 +177,25 @@ function ContextDisclosure({ context }) {
       "Context \xB7 ",
       context.length
     ] }),
-    /* @__PURE__ */ jsx("div", { children: context.map((item, index) => /* @__PURE__ */ jsxs("p", { children: [
-      /* @__PURE__ */ jsx("strong", { children: item.label }),
-      /* @__PURE__ */ jsx("span", { children: item.detail })
+    /* @__PURE__ */ jsx2("div", { children: context.map((item, index) => /* @__PURE__ */ jsxs("p", { children: [
+      /* @__PURE__ */ jsx2("strong", { children: item.label }),
+      /* @__PURE__ */ jsx2("span", { children: item.detail })
     ] }, item.id ?? index)) })
   ] });
 }
 function TranscriptEntry({ entry, state, adapter }) {
-  if (entry.role === "request") return /* @__PURE__ */ jsx(RequestCard, { entry, adapter, canRespond: state.canRespond });
+  if (entry.role === "request") return /* @__PURE__ */ jsx2(RequestCard, { entry, adapter, canRespond: state.canRespond });
   if (entry.role === "reasoning") {
     return /* @__PURE__ */ jsxs("details", { class: "scui-reasoning", open: entry.streaming, children: [
-      /* @__PURE__ */ jsx("summary", { children: entry.streaming ? "Reasoning\u2026" : "Reasoning" }),
-      /* @__PURE__ */ jsx(Markdown, { value: entry.text })
+      /* @__PURE__ */ jsx2("summary", { children: entry.streaming ? "Reasoning\u2026" : "Reasoning" }),
+      /* @__PURE__ */ jsx2(Markdown, { value: entry.text })
     ] });
   }
-  if (entry.role === "notice" || entry.role === "system") return /* @__PURE__ */ jsx("div", { class: "scui-notice", "data-code": entry.code, children: entry.text });
+  if (entry.role === "notice" || entry.role === "system") return /* @__PURE__ */ jsx2("div", { class: "scui-notice", "data-code": entry.code, children: entry.text });
   return /* @__PURE__ */ jsxs("article", { class: "scui-message", "data-role": entry.role, children: [
-    /* @__PURE__ */ jsx(Markdown, { value: entry.text }),
-    /* @__PURE__ */ jsx(ContextDisclosure, { context: entry.context }),
-    entry.truncated ? /* @__PURE__ */ jsx("small", { class: "scui-truncated", children: "Entry truncated by host \xB7 load native session for the complete value" }) : null
+    /* @__PURE__ */ jsx2(Markdown, { value: entry.text }),
+    /* @__PURE__ */ jsx2(ContextDisclosure, { context: entry.context }),
+    entry.truncated ? /* @__PURE__ */ jsx2("small", { class: "scui-truncated", children: "Entry truncated by host \xB7 load native session for the complete value" }) : null
   ] });
 }
 function ToolRow({ entry, workspace }) {
@@ -192,20 +206,20 @@ function ToolRow({ entry, workspace }) {
   const category = toolCategory(entry);
   return /* @__PURE__ */ jsxs("div", { class: "scui-tool", "data-status": entry.status ?? "completed", "data-category": category, children: [
     /* @__PURE__ */ jsxs("button", { type: "button", class: "scui-tool-head", disabled: !hasDetail, "aria-expanded": hasDetail ? open : void 0, "aria-controls": hasDetail ? detailId : void 0, onClick: () => hasDetail && setOpen((value) => !value), children: [
-      /* @__PURE__ */ jsx("span", { class: "scui-tool-glyph", "aria-hidden": "true", children: { read: "\u25A4", search: "\u2315", edit: "\u270E", command: ">_", test: "\u25C7", web: "\u25CE", agent: "\u2659", other: "\u25C6" }[category] }),
-      /* @__PURE__ */ jsx("strong", { children: entry.label?.split(/__|\//).at(-1)?.replaceAll("_", " ") || "Tool" }),
-      target ? /* @__PURE__ */ jsx("span", { class: "scui-tool-target", title: toolTarget(entry.arguments), children: target }) : null,
-      /* @__PURE__ */ jsx("span", { class: "scui-spacer" }),
-      /* @__PURE__ */ jsx("span", { "aria-label": entry.status ?? "completed", children: entry.status === "pending" ? "\u25CC" : entry.status === "error" ? "\xD7" : "\u2713" })
+      /* @__PURE__ */ jsx2("span", { class: "scui-tool-glyph", "aria-hidden": "true", children: { read: "\u25A4", search: "\u2315", edit: "\u270E", command: ">_", test: "\u25C7", web: "\u25CE", agent: "\u2659", other: "\u25C6" }[category] }),
+      /* @__PURE__ */ jsx2("strong", { children: entry.label?.split(/__|\//).at(-1)?.replaceAll("_", " ") || "Tool" }),
+      target ? /* @__PURE__ */ jsx2("span", { class: "scui-tool-target", title: toolTarget(entry.arguments), children: target }) : null,
+      /* @__PURE__ */ jsx2("span", { class: "scui-spacer" }),
+      /* @__PURE__ */ jsx2("span", { "aria-label": entry.status ?? "completed", children: entry.status === "pending" ? "\u25CC" : entry.status === "error" ? "\xD7" : "\u2713" })
     ] }),
     hasDetail && open ? /* @__PURE__ */ jsxs("div", { id: detailId, class: "scui-tool-detail", children: [
       entry.arguments ? /* @__PURE__ */ jsxs("pre", { children: [
-        /* @__PURE__ */ jsx("b", { children: "Input" }),
+        /* @__PURE__ */ jsx2("b", { children: "Input" }),
         "\n",
         entry.arguments
       ] }) : null,
       entry.resultText ? /* @__PURE__ */ jsxs("pre", { "data-error": entry.status === "error", children: [
-        /* @__PURE__ */ jsx("b", { children: "Output" }),
+        /* @__PURE__ */ jsx2("b", { children: "Output" }),
         "\n",
         entry.resultText,
         entry.truncated ? "\n[truncated]" : ""
@@ -222,16 +236,16 @@ function ActivityGroup({ entries, state }) {
   }, [active]);
   return /* @__PURE__ */ jsxs("section", { class: "scui-activity", children: [
     /* @__PURE__ */ jsxs("button", { class: "scui-activity-head", type: "button", "aria-expanded": open, "aria-controls": id, onClick: () => setOpen((value) => !value), children: [
-      /* @__PURE__ */ jsx("span", { class: "scui-fold", "data-open": open, children: "\u203A" }),
-      /* @__PURE__ */ jsx("strong", { children: activitySummary(entries) }),
-      /* @__PURE__ */ jsx("span", { class: "scui-spacer" }),
+      /* @__PURE__ */ jsx2("span", { class: "scui-fold", "data-open": open, children: "\u203A" }),
+      /* @__PURE__ */ jsx2("strong", { children: activitySummary(entries) }),
+      /* @__PURE__ */ jsx2("span", { class: "scui-spacer" }),
       /* @__PURE__ */ jsxs("small", { children: [
         entries.filter((entry) => entry.status === "completed").length,
         "/",
         entries.length
       ] })
     ] }),
-    open ? /* @__PURE__ */ jsx("div", { id, children: entries.map((entry) => /* @__PURE__ */ jsx(ToolRow, { entry, workspace: state.workspace }, entry.id)) }) : null
+    open ? /* @__PURE__ */ jsx2("div", { id, children: entries.map((entry) => /* @__PURE__ */ jsx2(ToolRow, { entry, workspace: state.workspace }, entry.id)) }) : null
   ] });
 }
 function TaskPlan({ plan }) {
@@ -239,43 +253,43 @@ function TaskPlan({ plan }) {
   const complete = plan.items.filter((item) => item.status === "completed" || item.status === "cancelled").length;
   return /* @__PURE__ */ jsxs("details", { class: "scui-plan", children: [
     /* @__PURE__ */ jsxs("summary", { children: [
-      /* @__PURE__ */ jsx("span", { children: "Plan" }),
+      /* @__PURE__ */ jsx2("span", { children: "Plan" }),
       /* @__PURE__ */ jsxs("small", { children: [
         complete,
         "/",
         plan.items.length
       ] })
     ] }),
-    /* @__PURE__ */ jsx("ol", { children: plan.items.map((item) => /* @__PURE__ */ jsxs("li", { "data-status": item.status, children: [
-      /* @__PURE__ */ jsx("i", { "aria-hidden": "true" }),
+    /* @__PURE__ */ jsx2("ol", { tabIndex: 0, "aria-label": "Task plan steps", children: plan.items.map((item) => /* @__PURE__ */ jsxs("li", { "data-status": item.status, children: [
+      /* @__PURE__ */ jsx2("i", { "aria-hidden": "true" }),
       " ",
-      /* @__PURE__ */ jsx("span", { children: item.title })
+      /* @__PURE__ */ jsx2("span", { children: item.title })
     ] }, item.id)) })
   ] });
 }
 function SessionDetails({ semantics }) {
   if (!semantics.fidelity && !semantics.residueCount && !semantics.parseErrors && !semantics.subagents.length) return null;
   return /* @__PURE__ */ jsxs("details", { class: "scui-details", children: [
-    /* @__PURE__ */ jsx("summary", { children: "Session details" }),
+    /* @__PURE__ */ jsx2("summary", { children: "Session details" }),
     /* @__PURE__ */ jsxs("div", { children: [
       semantics.fidelity ? /* @__PURE__ */ jsxs("p", { children: [
-        /* @__PURE__ */ jsx("strong", { children: "Fidelity" }),
-        /* @__PURE__ */ jsx("span", { children: semantics.fidelity.replaceAll("_", " ") })
+        /* @__PURE__ */ jsx2("strong", { children: "Fidelity" }),
+        /* @__PURE__ */ jsx2("span", { children: semantics.fidelity.replaceAll("_", " ") })
       ] }) : null,
       /* @__PURE__ */ jsxs("p", { children: [
-        /* @__PURE__ */ jsx("strong", { children: "Native records" }),
-        /* @__PURE__ */ jsx("span", { children: semantics.rawRecords })
+        /* @__PURE__ */ jsx2("strong", { children: "Native records" }),
+        /* @__PURE__ */ jsx2("span", { children: semantics.rawRecords })
       ] }),
       semantics.residueCount ? /* @__PURE__ */ jsxs("p", { children: [
-        /* @__PURE__ */ jsx("strong", { children: "Residue" }),
+        /* @__PURE__ */ jsx2("strong", { children: "Residue" }),
         /* @__PURE__ */ jsxs("span", { children: [
           semantics.residueCount,
           " retained"
         ] })
       ] }) : null,
       semantics.parseErrors ? /* @__PURE__ */ jsxs("p", { children: [
-        /* @__PURE__ */ jsx("strong", { children: "Parse diagnostics" }),
-        /* @__PURE__ */ jsx("span", { children: semantics.parseErrors })
+        /* @__PURE__ */ jsx2("strong", { children: "Parse diagnostics" }),
+        /* @__PURE__ */ jsx2("span", { children: semantics.parseErrors })
       ] }) : null,
       semantics.subagents.map((agent) => /* @__PURE__ */ jsxs("p", { children: [
         /* @__PURE__ */ jsxs("strong", { children: [
@@ -304,11 +318,12 @@ function Conversation({ state, adapter, components = {}, slots = {}, memoryKey =
   const Before = slots.beforeConversation;
   const After = slots.afterConversation;
   const Empty = slots.emptyConversation;
+  const remember = (value) => boundedSet(conversationMemory, memoryKey, value);
   const pin = () => {
     if (!scroller.current) return;
     scroller.current.scrollTop = scroller.current.scrollHeight;
     setAtBottom(true);
-    conversationMemory.set(memoryKey, { top: scroller.current.scrollTop, atBottom: true });
+    remember({ top: scroller.current.scrollTop, atBottom: true });
   };
   useLayoutEffect(() => {
     const element = scroller.current;
@@ -317,7 +332,7 @@ function Conversation({ state, adapter, components = {}, slots = {}, memoryKey =
     if (anchor && state.transcript.length > anchor.entries) {
       element.scrollTop = anchor.top + (element.scrollHeight - anchor.height);
       earlierAnchor.current = null;
-      conversationMemory.set(memoryKey, { top: element.scrollTop, atBottom: false });
+      remember({ top: element.scrollTop, atBottom: false });
       return;
     }
     if (!restored.current) {
@@ -327,41 +342,41 @@ function Conversation({ state, adapter, components = {}, slots = {}, memoryKey =
     } else if (atBottom) pin();
   }, [memoryKey, state.transcript.length, state.busy]);
   return /* @__PURE__ */ jsxs("div", { class: "scui-conversation-wrap", children: [
-    /* @__PURE__ */ jsx("div", { class: "scui-conversation", ref: scroller, tabIndex: 0, "aria-label": "Conversation", onScroll: (event) => {
+    /* @__PURE__ */ jsx2("div", { class: "scui-conversation", ref: scroller, tabIndex: 0, "aria-label": "Conversation", onScroll: (event) => {
       const element = event.currentTarget;
       const bottom = element.scrollHeight - element.scrollTop - element.clientHeight <= 64;
       setAtBottom(bottom);
-      conversationMemory.set(memoryKey, { top: element.scrollTop, atBottom: bottom });
+      remember({ top: element.scrollTop, atBottom: bottom });
     }, children: /* @__PURE__ */ jsxs("div", { children: [
-      Before ? /* @__PURE__ */ jsx(Before, { state, adapter, value: null }) : null,
-      /* @__PURE__ */ jsx(TaskPlan, { plan: state.taskPlan }),
-      /* @__PURE__ */ jsx(SessionDetails, { semantics: state.semantics }),
-      state.history.hasEarlier ? /* @__PURE__ */ jsx("button", { class: "scui-load", type: "button", disabled: Boolean(state.operation), onClick: () => {
+      Before ? /* @__PURE__ */ jsx2(Before, { state, adapter, value: null }) : null,
+      /* @__PURE__ */ jsx2(TaskPlan, { plan: state.taskPlan }),
+      /* @__PURE__ */ jsx2(SessionDetails, { semantics: state.semantics }),
+      state.history.hasEarlier ? /* @__PURE__ */ jsx2("button", { class: "scui-load", type: "button", disabled: Boolean(state.operation), onClick: () => {
         const element = scroller.current;
         if (element) earlierAnchor.current = { height: element.scrollHeight, top: element.scrollTop, entries: state.transcript.length };
         setAtBottom(false);
         adapter.onIntent({ action: "loadEarlier" });
       }, children: "Load earlier messages" }) : null,
-      !blocks.length && state.startup !== "ready" ? /* @__PURE__ */ jsx(LoadingStatus, { state }) : null,
-      !blocks.length && state.startup === "ready" ? Empty ? /* @__PURE__ */ jsx(Empty, { state, adapter, value: null }) : /* @__PURE__ */ jsx("div", { class: "scui-empty", children: state.error ?? (state.harness ? `${harnessDisplayName(state.harness)} is listening. Say something.` : "No transcript yet.") }) : null,
-      blocks.map((block) => block.kind === "activity" ? /* @__PURE__ */ jsx(Group, { value: block.entries, entries: block.entries, state, adapter }, block.id) : /* @__PURE__ */ jsx(Entry, { value: block.entry, entry: block.entry, state, adapter }, block.id)),
+      !blocks.length && state.startup !== "ready" ? /* @__PURE__ */ jsx2(LoadingStatus, { state }) : null,
+      !blocks.length && state.startup === "ready" ? Empty ? /* @__PURE__ */ jsx2(Empty, { state, adapter, value: null }) : /* @__PURE__ */ jsx2("div", { class: "scui-empty", children: state.error ?? (state.harness ? `${harnessDisplayName(state.harness)} is listening. Say something.` : "No transcript yet.") }) : null,
+      blocks.map((block) => block.kind === "activity" ? /* @__PURE__ */ jsx2(Group, { value: block.entries, entries: block.entries, state, adapter }, block.id) : /* @__PURE__ */ jsx2(Entry, { value: block.entry, entry: block.entry, state, adapter }, block.id)),
       pending ? /* @__PURE__ */ jsxs("article", { class: "scui-message scui-pending", "data-role": "user", children: [
-        /* @__PURE__ */ jsx(Markdown, { value: pending }),
-        /* @__PURE__ */ jsx("small", { children: state.error && !state.busy ? "Not sent" : "Sending\u2026" })
+        /* @__PURE__ */ jsx2(Markdown, { value: pending }),
+        /* @__PURE__ */ jsx2("small", { children: state.error && !state.busy ? "Not sent" : "Sending\u2026" })
       ] }) : null,
       state.busy ? /* @__PURE__ */ jsxs("div", { class: "scui-working", role: "status", children: [
-        /* @__PURE__ */ jsx("span", { "aria-hidden": "true", children: "\u2726" }),
-        /* @__PURE__ */ jsx("i", {}),
-        /* @__PURE__ */ jsx("i", {}),
-        /* @__PURE__ */ jsx("i", {}),
+        /* @__PURE__ */ jsx2("span", { "aria-hidden": "true", children: "\u2726" }),
+        /* @__PURE__ */ jsx2("i", {}),
+        /* @__PURE__ */ jsx2("i", {}),
+        /* @__PURE__ */ jsx2("i", {}),
         /* @__PURE__ */ jsxs("small", { children: [
           harnessDisplayName(state.harness),
           " is working"
         ] })
       ] }) : null,
-      After ? /* @__PURE__ */ jsx(After, { state, adapter, value: null }) : null
+      After ? /* @__PURE__ */ jsx2(After, { state, adapter, value: null }) : null
     ] }) }),
-    !atBottom ? /* @__PURE__ */ jsx("button", { class: "scui-latest", type: "button", onClick: pin, children: "\u2193 Latest" }) : null
+    !atBottom ? /* @__PURE__ */ jsx2("button", { class: "scui-latest", type: "button", onClick: pin, children: "\u2193 Latest" }) : null
   ] });
 }
 export {

package/core.d.ts

@@ -0,0 +1,41 @@
+export type {
+  AttachedSessionModel,
+  ControlStrategy,
+  HarnessId,
+  HarnessOption,
+  MessengerLabels,
+  ReductionReceiptModel,
+  RequestOption,
+  SessionActivity,
+  SessionAttention,
+  SessionMode,
+  SessionRowModel,
+  SessionSemanticsModel,
+  StartupPhase,
+  SupercodeUiIntent,
+  SupercodeUiState,
+  TaskPlanItem,
+  TaskPlanModel,
+  TranscriptContext,
+  TranscriptEntryModel,
+  TranscriptRequest,
+  UiTone,
+} from './index.js';
+export {
+  DEFAULT_LABELS,
+  EMPTY_UI_STATE,
+  activitySummary,
+  canContinueHere,
+  compactToolTarget,
+  filterSessions,
+  groupConversation,
+  harnessDisplayName,
+  isSendKey,
+  normalizeUiState,
+  operationLabel,
+  sessionActivity,
+  sessionDisplayName,
+  terminalCommand,
+  toolCategory,
+  toolTarget,
+} from './index.js';

package/core.mjs

@@ -1,6 +1,8 @@
 const HARNESS_NAMES = Object.freeze({
   'claude-code': 'Claude Code',
   codex: 'Codex',
+  gemini: 'Gemini CLI',
+  goose: 'Goose',
   opencode: 'OpenCode',
   pi: 'Pi',
   grok: 'Grok',
@@ -58,7 +60,7 @@ export const EMPTY_UI_STATE = Object.freeze({
 
 const ROLES = new Set(['system', 'user', 'assistant', 'tool', 'reasoning', 'request', 'notice']);
 const MODES = new Set(['none', 'control', 'mirror']);
-const STRATEGIES = new Set(['start', 'resume', 'attach', 'branch']);
+const STRATEGIES = new Set(['start', 'resume', 'attach', 'branch', 'reduce']);
 const STARTUP = new Set(['connecting', 'starting', 'discovering', 'ready']);
 const FIDELITY = new Set(['byte_lossless', 'value_lossless', 'semantic']);
 
@@ -196,6 +198,72 @@ function readSemantics(value) {
   };
 }
 
+function readTerminalHandoff(value) {
+  const handoff = record(value);
+  if (
+    !handoff ||
+    typeof handoff.program !== 'string' ||
+    !handoff.program.trim() ||
+    !Array.isArray(handoff.arguments) ||
+    !handoff.arguments.every((argument) => typeof argument === 'string') ||
+    typeof handoff.cwd !== 'string'
+  ) return null;
+  return { program: handoff.program, arguments: [...handoff.arguments], cwd: handoff.cwd };
+}
+
+function readExportReceipt(value) {
+  const receipt = record(value);
+  if (
+    !receipt ||
+    typeof receipt.targetHarness !== 'string' ||
+    !['byte_lossless', 'value_lossless'].includes(receipt.fidelity) ||
+    typeof receipt.path !== 'string' ||
+    !receipt.path.trim() ||
+    !Number.isInteger(receipt.files) ||
+    receipt.files < 1 ||
+    !Number.isInteger(receipt.residueCount) ||
+    receipt.residueCount < 0
+  ) return null;
+  return {
+    targetHarness: receipt.targetHarness,
+    fidelity: receipt.fidelity,
+    path: receipt.path,
+    files: receipt.files,
+    residueCount: receipt.residueCount,
+  };
+}
+
+function readReductionReceipt(value) {
+  const receipt = record(value);
+  if (
+    !receipt ||
+    typeof receipt.sourceTokens !== 'number' ||
+    !Number.isFinite(receipt.sourceTokens) ||
+    typeof receipt.reducedTokens !== 'number' ||
+    !Number.isFinite(receipt.reducedTokens) ||
+    receipt.sourceTokens <= receipt.reducedTokens ||
+    receipt.reducedTokens < 0 ||
+    typeof receipt.ratio !== 'number' ||
+    !Number.isFinite(receipt.ratio) ||
+    receipt.ratio <= 1 ||
+    typeof receipt.sidecarId !== 'string' ||
+    !receipt.sidecarId.trim() ||
+    receipt.verified !== true ||
+    receipt.reversible !== true ||
+    typeof receipt.targetHarness !== 'string' ||
+    !receipt.targetHarness.trim()
+  ) return null;
+  return {
+    sourceTokens: receipt.sourceTokens,
+    reducedTokens: receipt.reducedTokens,
+    ratio: receipt.ratio,
+    sidecarId: receipt.sidecarId,
+    verified: true,
+    reversible: true,
+    targetHarness: receipt.targetHarness,
+  };
+}
+
 export function normalizeUiState(value) {
   const raw = record(value) ?? {};
   const pill = record(raw.pill);
@@ -225,10 +293,10 @@ export function normalizeUiState(value) {
     workspace: string(raw.workspace),
     taskPlan: readTaskPlan(raw.taskPlan),
     semantics: readSemantics(raw.semantics),
-    terminalHandoff: record(raw.terminalHandoff),
+    terminalHandoff: readTerminalHandoff(raw.terminalHandoff),
     exportBackTarget: typeof raw.exportBackTarget === 'string' ? raw.exportBackTarget : null,
-    exportReceipt: record(raw.exportReceipt),
-    reductionReceipt: record(raw.reductionReceipt),
+    exportReceipt: readExportReceipt(raw.exportReceipt),
+    reductionReceipt: readReductionReceipt(raw.reductionReceipt),
     error: typeof raw.error === 'string' ? raw.error : null,
     recoverable: raw.recoverable === true,
     harnesses: Array.isArray(raw.harnesses) ? raw.harnesses.flatMap((candidate) => {

package/embed.d.ts

@@ -0,0 +1,2 @@
+export type { MessengerProps, MountedMessenger, SupercodeUiState } from './index.js';
+export { mountSupercodeMessenger } from './index.js';