@stigmer/react 0.4.1 → 0.4.2

package/models/registry.js

@@ -43,7 +43,8 @@ export function parseModelKey(key) {
     return { harness, modelId: key.slice(idx + 1) };
 }
 const VALID_COST_TIERS = new Set(["economy", "standard", "premium"]);
-const VALID_HARNESSES = new Set(["native", "cursor"]);
+const VALID_SPEED_TIERS = new Set(["fastest", "fast", "balanced", "slow"]);
+const VALID_HARNESSES = new Set(["native", "cursor", "copilot", "claude_code", "codex", "devin"]);
 function isModelEntry(entry) {
     return (typeof entry.id === "string" &&
         typeof entry.displayName === "string" &&
@@ -64,12 +65,53 @@ export const MODEL_REGISTRY = registryData.models
     modelId: m.id,
     provider: m.provider,
     displayName: m.displayName,
+    shortDescription: m.shortDescription ?? "",
+    speedTier: (VALID_SPEED_TIERS.has(m.speedTier ?? "") ? m.speedTier : "fast"),
     costTier: m.costTier,
     harness: m.harness,
     featured: m.featured ?? false,
 }));
-/** Model ID used when no user preference is set (native harness). */
-export const DEFAULT_MODEL_ID = "claude-sonnet-4.5";
+/**
+ * Model ID used when no user preference is set (native harness).
+ *
+ * @deprecated Use {@link resolveDefaultModelId} for dynamic resolution
+ * based on the active harness and featured models. This constant is kept
+ * as the last-resort platform fallback.
+ */
+export const DEFAULT_MODEL_ID = "claude-sonnet-4.6";
 /** Model ID used when the Cursor harness is selected and no user preference is set. */
 export const DEFAULT_CURSOR_MODEL_ID = "default";
+/**
+ * Resolve the default model for a given harness using a priority chain.
+ *
+ * Priority (Phase 1 — no backend):
+ * 1. localStorage user preference (passed in as `userPreference`)
+ * 2. First featured model for the harness from the registry
+ * 3. Hardcoded platform fallback
+ *
+ * Future phases will add org-level and agent-level defaults between
+ * user preference and harness default.
+ */
+export function resolveDefaultModelId(harness, options) {
+    if (options?.userPreference) {
+        const model = MODEL_REGISTRY.find((m) => m.harness === harness && m.modelId === options.userPreference);
+        if (model)
+            return { modelId: model.modelId, source: "user_preference" };
+    }
+    if (options?.orgDefault) {
+        const model = MODEL_REGISTRY.find((m) => m.harness === harness && m.modelId === options.orgDefault);
+        if (model)
+            return { modelId: model.modelId, source: "org_default" };
+    }
+    if (options?.agentDefault) {
+        const model = MODEL_REGISTRY.find((m) => m.harness === harness && m.modelId === options.agentDefault);
+        if (model)
+            return { modelId: model.modelId, source: "agent_default" };
+    }
+    const featured = MODEL_REGISTRY.find((m) => m.harness === harness && m.featured);
+    if (featured)
+        return { modelId: featured.modelId, source: "harness_default" };
+    const fallbackId = harness === "cursor" ? DEFAULT_CURSOR_MODEL_ID : DEFAULT_MODEL_ID;
+    return { modelId: fallbackId, source: "platform_fallback" };
+}
 //# sourceMappingURL=registry.js.map

package/models/registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/models/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,YAAY,MAAM,gCAAgC,CAAC;AA0B1D;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAA0B,IAAI,GAAG,CAAC;IAC/D,QAAQ;CACT,CAAC,CAAC;AA4CH;;;;;GAKG;AACH,MAAM,UAAU,QAAQ,CAAC,OAAsB,EAAE,OAAe;IAC9D,OAAO,GAAG,OAAO,IAAI,OAAO,EAAE,CAAC;AACjC,CAAC;AAUD;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,GAAW;IACvC,MAAM,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC7B,IAAI,GAAG,GAAG,CAAC;QAAE,OAAO,SAAS,CAAC;IAC9B,MAAM,OAAO,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAClC,IAAI,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IACnE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,EAAE,CAAC;AAClD,CAAC;AAsBD,MAAM,gBAAgB,GAAG,IAAI,GAAG,CAAC,CAAC,SAAS,EAAE,UAAU,EAAE,SAAS,CAAC,CAAC,CAAC;AACrE,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC;AAEtD,SAAS,YAAY,CAAC,KAAwB;IAC5C,OAAO,CACL,OAAO,KAAK,CAAC,EAAE,KAAK,QAAQ;QAC5B,OAAO,KAAK,CAAC,WAAW,KAAK,QAAQ;QACrC,OAAO,KAAK,CAAC,QAAQ,KAAK,QAAQ;QAClC,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ,IAAI,eAAe,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC;QACvE,OAAO,KAAK,CAAC,QAAQ,KAAK,QAAQ,IAAI,gBAAgB,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,CAC3E,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,cAAc,GACzB,YAAY,CAAC,MACd;KACE,MAAM,CAAC,YAAY,CAAC;KACpB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACX,OAAO,EAAE,CAAC,CAAC,EAAE;IACb,QAAQ,EAAE,CAAC,CAAC,QAAoB;IAChC,WAAW,EAAE,CAAC,CAAC,WAAW;IAC1B,QAAQ,EAAE,CAAC,CAAC,QAAoB;IAChC,OAAO,EAAE,CAAC,CAAC,OAAwB;IACnC,QAAQ,EAAE,CAAC,CAAC,QAAQ,IAAI,KAAK;CAC9B,CAAC,CAAC,CAAC;AAEN,qEAAqE;AACrE,MAAM,CAAC,MAAM,gBAAgB,GAAG,mBAAmB,CAAC;AAEpD,uFAAuF;AACvF,MAAM,CAAC,MAAM,uBAAuB,GAAG,SAAS,CAAC"}
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/models/registry.ts"],"names":[],"mappings":"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"}

package/models/useModelRegistry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useModelRegistry.d.ts","sourceRoot":"","sources":["../../src/models/useModelRegistry.ts"],"names":[],"mappings":"AAGA,OAAO,EAML,KAAK,SAAS,EACd,KAAK,QAAQ,EACd,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE/C,4CAA4C;AAC5C,MAAM,WAAW,uBAAuB;IACtC;;;;;;OAMG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,aAAa,CAAC;CAClC;AAED,gDAAgD;AAChD,MAAM,WAAW,sBAAsB;IACrC,gDAAgD;IAChD,QAAQ,CAAC,MAAM,EAAE,SAAS,SAAS,EAAE,CAAC;IACtC,0DAA0D;IAC1D,QAAQ,CAAC,UAAU,EAAE,WAAW,CAAC,QAAQ,EAAE,SAAS,SAAS,EAAE,CAAC,CAAC;IACjE,uDAAuD;IACvD,QAAQ,CAAC,YAAY,EAAE,SAAS,CAAC;IACjC;;;;;;;OAOG;IACH,QAAQ,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,SAAS,GAAG,SAAS,CAAC;IAC9D,oDAAoD;IACpD,QAAQ,CAAC,SAAS,EAAE,SAAS,QAAQ,EAAE,CAAC;IACxC,qEAAqE;IACrE,QAAQ,CAAC,QAAQ,EAAE,SAAS,SAAS,EAAE,CAAC;IACxC;;;OAGG;IACH,QAAQ,CAAC,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,SAAS,GAAG,SAAS,CAAC;CAC3D;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,CAAC,EAAE,uBAAuB,GAAG,sBAAsB,CA8D1F"}
+{"version":3,"file":"useModelRegistry.d.ts","sourceRoot":"","sources":["../../src/models/useModelRegistry.ts"],"names":[],"mappings":"AAGA,OAAO,EAOL,KAAK,SAAS,EACd,KAAK,QAAQ,EACd,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE/C,4CAA4C;AAC5C,MAAM,WAAW,uBAAuB;IACtC;;;;;;OAMG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,aAAa,CAAC;CAClC;AAED,gDAAgD;AAChD,MAAM,WAAW,sBAAsB;IACrC,gDAAgD;IAChD,QAAQ,CAAC,MAAM,EAAE,SAAS,SAAS,EAAE,CAAC;IACtC,0DAA0D;IAC1D,QAAQ,CAAC,UAAU,EAAE,WAAW,CAAC,QAAQ,EAAE,SAAS,SAAS,EAAE,CAAC,CAAC;IACjE,uDAAuD;IACvD,QAAQ,CAAC,YAAY,EAAE,SAAS,CAAC;IACjC;;;;;;;OAOG;IACH,QAAQ,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,SAAS,GAAG,SAAS,CAAC;IAC9D,oDAAoD;IACpD,QAAQ,CAAC,SAAS,EAAE,SAAS,QAAQ,EAAE,CAAC;IACxC,qEAAqE;IACrE,QAAQ,CAAC,QAAQ,EAAE,SAAS,SAAS,EAAE,CAAC;IACxC;;;OAGG;IACH,QAAQ,CAAC,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,SAAS,GAAG,SAAS,CAAC;CAC3D;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,CAAC,EAAE,uBAAuB,GAAG,sBAAsB,CA2D1F"}

package/models/useModelRegistry.js

@@ -1,6 +1,6 @@
 "use client";
 import { useMemo } from "react";
-import { MODEL_REGISTRY, DEFAULT_MODEL_ID, DEFAULT_CURSOR_MODEL_ID, DISABLED_PROVIDERS, modelKey, } from "./registry";
+import { MODEL_REGISTRY, DEFAULT_MODEL_ID, DISABLED_PROVIDERS, resolveDefaultModelId, modelKey, } from "./registry";
 /**
  * Data hook that exposes the platform model registry with grouping
  * and lookup helpers.
@@ -26,10 +26,10 @@ import { MODEL_REGISTRY, DEFAULT_MODEL_ID, DEFAULT_CURSOR_MODEL_ID, DISABLED_PRO
 export function useModelRegistry(options) {
     const harness = options?.harness;
     return useMemo(() => {
-        const isCursor = harness === "cursor";
-        const isNative = harness === "native";
         const isUnified = harness === undefined;
-        const defaultId = isCursor ? DEFAULT_CURSOR_MODEL_ID : DEFAULT_MODEL_ID;
+        const { modelId: defaultId } = harness
+            ? resolveDefaultModelId(harness)
+            : { modelId: DEFAULT_MODEL_ID };
         const byProvider = new Map();
         const byId = new Map();
         const byCompoundKey = new Map();
@@ -37,18 +37,13 @@ export function useModelRegistry(options) {
         const featuredModels = [];
         let defaultModel;
         for (const model of MODEL_REGISTRY) {
-            if (isCursor) {
-                if (model.harness !== "cursor")
-                    continue;
-            }
-            else if (isNative) {
-                if (model.harness !== "native")
-                    continue;
+            if (isUnified) {
                 if (DISABLED_PROVIDERS.has(model.provider))
                     continue;
             }
             else {
-                // Unified — include both harnesses, still respect DISABLED_PROVIDERS
+                if (model.harness !== harness)
+                    continue;
                 if (DISABLED_PROVIDERS.has(model.provider))
                     continue;
             }

package/models/useModelRegistry.js.map

@@ -1 +1 @@
-{"version":3,"file":"useModelRegistry.js","sourceRoot":"","sources":["../../src/models/useModelRegistry.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"useModelRegistry.js","sourceRoot":"","sources":["../../src/models/useModelRegistry.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stigmer/react",
-  "version": "0.4.1",
+  "version": "0.4.2",
   "description": "React provider and client hook for the Stigmer platform SDK",
   "license": "Apache-2.0",
   "type": "module",
@@ -35,7 +35,7 @@
     }
   },
   "dependencies": {
-    "@stigmer/theme": "0.4.1",
+    "@stigmer/theme": "0.4.2",
     "react-markdown": "^10.1.0",
     "remark-gfm": "^4.0.1",
     "streamdown": "^2.5.0",
@@ -44,8 +44,8 @@
   "peerDependencies": {
     "@base-ui/react": "^1.0.0",
     "@bufbuild/protobuf": "^2.0.0",
-    "@stigmer/protos": "0.4.1",
-    "@stigmer/sdk": "0.4.1",
+    "@stigmer/protos": "0.4.2",
+    "@stigmer/sdk": "0.4.2",
     "lucide-react": ">=0.400.0",
     "react": "^19.0.0",
     "react-dom": "^19.0.0",

package/src/models/ModelSelector.tsx

@@ -4,8 +4,8 @@ import { useCallback, useEffect, useMemo, useRef, useState } from "react";
 import { Popover } from "@base-ui/react/popover";
 import { cn } from "@stigmer/theme";
 import { useModelRegistry } from "./useModelRegistry";
-import { modelKey, parseModelKey, type ModelInfo, type CostTier } from "./registry";
-import { HARNESS_LABELS, type HarnessOption } from "./harness";
+import type { ModelInfo, CostTier, SpeedTier } from "./registry";
+import { HARNESS_META, HARNESS_OPTIONS, type HarnessOption } from "./harness";
 
 const COST_TIER_LABEL: Record<CostTier, string> = {
   economy: "$",
@@ -13,46 +13,70 @@ const COST_TIER_LABEL: Record<CostTier, string> = {
   premium: "$$$",
 };
 
+const SPEED_TIER_LABEL: Record<SpeedTier, string> = {
+  fastest: "Fastest",
+  fast: "Fast",
+  balanced: "Balanced",
+  slow: "Powerful",
+};
+
 /** Props for {@link ModelSelector}. */
 export interface ModelSelectorProps {
-  /** Currently selected compound key (`"native/claude-sonnet-4.6"`) or plain `modelId`. */
+  /** Currently selected model ID. */
   readonly value?: string;
   /** Called when the user picks a different model. Receives the `modelId`. */
   readonly onValueChange: (modelId: string) => void;
   /**
-   * When provided, restricts the catalog to a single harness (backward compat).
-   * When omitted, shows the unified picker with models from both engines.
+   * Current harness. When provided as a single value, locks the selector
+   * to that harness (dropdown hidden). When omitted, shows the harness dropdown.
    */
   readonly harness?: HarnessOption;
+  /** Called when user changes harness in the dropdown. */
+  readonly onHarnessChange?: (harness: HarnessOption) => void;
   /**
-   * Fires when the selected model belongs to a different harness than
-   * the previous selection. Only relevant in unified mode (no `harness` prop).
+   * Restrict which harnesses appear in the dropdown.
+   * When omitted, shows all registered harnesses that have models in the registry.
    */
-  readonly onHarnessResolved?: (harness: HarnessOption) => void;
+  readonly availableHarnesses?: readonly HarnessOption[];
+  /** Override the curated (featured) list for the current harness. */
+  readonly curatedModels?: readonly string[];
+  /** Grouping in the "Show All" expanded view. Default: "provider". */
+  readonly groupBy?: "provider" | "tier" | "none";
+  /** Show speed tier badge. Default: true. */
+  readonly showSpeedBadge?: boolean;
+  /** Show short descriptions in curated view. Default: true. */
+  readonly showDescriptions?: boolean;
+  /** Compact mode: smaller trigger, no descriptions. Default: false. */
+  readonly compact?: boolean;
   /** Additional CSS class names for the trigger button. */
   readonly className?: string;
   /** When true, disables the selector. */
   readonly disabled?: boolean;
+
+  /**
+   * @deprecated Use {@link onHarnessChange} instead.
+   */
+  readonly onHarnessResolved?: (harness: HarnessOption) => void;
 }
 
 /**
- * Cursor-style model picker: a flat searchable list inside a popover.
- *
- * Shows a curated list of featured models by default. The user can
- * expand via "Show All Models" or type to search the full catalog.
+ * Combined harness + model picker with a compact trigger button.
  *
- * Each model row shows the display name, an engine tag
- * ("Stigmer" / "Cursor"), and a cost-tier indicator.
+ * Shows a harness dropdown at the top of the popover (when not locked
+ * to a single harness), followed by a curated model list scoped to
+ * the selected harness. Supports search and progressive disclosure
+ * via "Show All Models."
  *
- * In unified mode (no `harness` prop), selecting a model implicitly
- * resolves the harness via {@link ModelSelectorProps.onHarnessResolved}.
+ * The trigger button displays the current selection in compact format:
+ * `Harness · Model Name ▾` (or just `Model Name ▾` when harness is locked).
  *
  * @example
  * ```tsx
  * <ModelSelector
- *   value={selectedModelId}
- *   onValueChange={setSelectedModelId}
- *   onHarnessResolved={setHarness}
+ *   value={modelId}
+ *   onValueChange={setModelId}
+ *   harness={harness}
+ *   onHarnessChange={setHarness}
  * />
  * ```
  */
@@ -60,13 +84,23 @@ export function ModelSelector({
   value,
   onValueChange,
   harness,
+  onHarnessChange,
   onHarnessResolved,
+  availableHarnesses,
+  curatedModels,
+  groupBy = "provider",
+  showSpeedBadge = true,
+  showDescriptions = true,
+  compact = false,
   className,
   disabled,
 }: ModelSelectorProps) {
-  const isUnified = harness === undefined;
-  const { models, featured, defaultModel, getModel, getByKey } = useModelRegistry(
-    isUnified ? undefined : { harness },
+  const isHarnessLocked = harness !== undefined;
+  const [internalHarness, setInternalHarness] = useState<HarnessOption>(harness ?? "native");
+  const activeHarness = harness ?? internalHarness;
+
+  const { models, featured, defaultModel, getModel, byProvider } = useModelRegistry(
+    { harness: activeHarness },
   );
 
   const [open, setOpen] = useState(false);
@@ -77,31 +111,56 @@ export function ModelSelector({
   const searchRef = useRef<HTMLInputElement>(null);
   const listRef = useRef<HTMLDivElement>(null);
 
-  const resolveSelected = useCallback((): ModelInfo | undefined => {
-    if (!value) return undefined;
-    if (isUnified) {
-      const byKey = getByKey(value);
-      if (byKey) return byKey;
-    }
-    return getModel(value);
-  }, [value, isUnified, getByKey, getModel]);
+  const resolvedHarnesses = useMemo(() => {
+    if (availableHarnesses) return availableHarnesses;
+    // For now, show native and cursor (the two harnesses with models in the registry).
+    // Future harnesses will be added to the registry and appear here automatically.
+    return HARNESS_OPTIONS.filter((h) => h === "native" || h === "cursor");
+  }, [availableHarnesses]);
 
-  const selectedModel = resolveSelected() ?? defaultModel;
+  const selectedModel = (value ? getModel(value) : undefined) ?? defaultModel;
 
   const isSearching = searchQuery.length > 0;
   const lowerQuery = searchQuery.toLowerCase();
 
+  const curatedSet = useMemo(() => {
+    if (curatedModels) return new Set(curatedModels);
+    return null;
+  }, [curatedModels]);
+
+  const featuredModels = useMemo(() => {
+    if (curatedSet) {
+      return models.filter((m) => curatedSet.has(m.modelId));
+    }
+    return featured;
+  }, [models, featured, curatedSet]);
+
   const visibleModels: readonly ModelInfo[] = useMemo(() => {
     if (isSearching) {
       return models.filter((m) =>
         m.displayName.toLowerCase().includes(lowerQuery)
         || m.modelId.toLowerCase().includes(lowerQuery)
-        || HARNESS_LABELS[m.harness].toLowerCase().includes(lowerQuery),
+        || m.shortDescription.toLowerCase().includes(lowerQuery),
       );
     }
     if (showAll) return models;
-    return featured.length > 0 ? featured : models;
-  }, [models, featured, isSearching, showAll, lowerQuery]);
+    return featuredModels.length > 0 ? featuredModels : models;
+  }, [models, featuredModels, isSearching, showAll, lowerQuery]);
+
+  const groupedModels = useMemo(() => {
+    if (!showAll || groupBy === "none" || isSearching) return null;
+    const groups = new Map<string, ModelInfo[]>();
+    for (const model of models) {
+      const key = groupBy === "provider" ? model.provider : model.costTier;
+      const group = groups.get(key);
+      if (group) {
+        group.push(model);
+      } else {
+        groups.set(key, [model]);
+      }
+    }
+    return groups;
+  }, [models, showAll, groupBy, isSearching]);
 
   useEffect(() => {
     setHighlightIdx(-1);
@@ -121,16 +180,23 @@ export function ModelSelector({
     }
   }, [open]);
 
+  const handleHarnessChange = useCallback(
+    (newHarness: HarnessOption) => {
+      setInternalHarness(newHarness);
+      onHarnessChange?.(newHarness);
+      onHarnessResolved?.(newHarness);
+      setShowAll(false);
+      setSearchQuery("");
+    },
+    [onHarnessChange, onHarnessResolved],
+  );
+
   const selectModel = useCallback(
     (model: ModelInfo) => {
-      const key = isUnified ? modelKey(model.harness, model.modelId) : model.modelId;
-      onValueChange(key);
-      if (isUnified && onHarnessResolved && model.harness !== selectedModel?.harness) {
-        onHarnessResolved(model.harness);
-      }
+      onValueChange(model.modelId);
       setOpen(false);
     },
-    [isUnified, onValueChange, onHarnessResolved, selectedModel],
+    [onValueChange],
   );
 
   const scrollHighlightIntoView = useCallback((idx: number) => {
@@ -175,11 +241,10 @@ export function ModelSelector({
     [visibleModels, highlightIdx, selectModel, scrollHighlightIntoView],
   );
 
-  const showShowAllButton = !isSearching && !showAll && featured.length > 0 && featured.length < models.length;
+  const showShowAllButton = !isSearching && !showAll && featuredModels.length > 0 && featuredModels.length < models.length;
 
   const triggerLabel = selectedModel.displayName;
-  const triggerHarness = isUnified ? HARNESS_LABELS[selectedModel.harness] : undefined;
-  const triggerCost = COST_TIER_LABEL[selectedModel.costTier];
+  const triggerHarness = !isHarnessLocked ? HARNESS_META[activeHarness].label : undefined;
 
   return (
     <Popover.Root open={open} onOpenChange={setOpen}>
@@ -190,17 +255,17 @@ export function ModelSelector({
           "bg-background px-2.5 py-1.5 text-xs text-foreground",
           "hover:bg-accent-hover focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring",
           "disabled:pointer-events-none disabled:opacity-50",
-          "transition-colors max-w-[18rem] max-sm:max-w-[10rem]",
+          "transition-colors max-w-[20rem] max-sm:max-w-[12rem]",
           className,
         )}
       >
-        <span className="truncate">{triggerLabel}</span>
         {triggerHarness && (
-          <span className="shrink-0 rounded bg-muted px-1 py-0.5 text-[0.6rem] font-medium text-muted-foreground">
-            {triggerHarness}
-          </span>
+          <span className="shrink-0 text-muted-foreground">{triggerHarness}</span>
         )}
-        <span className="shrink-0 text-[0.6rem] text-muted-foreground">{triggerCost}</span>
+        {triggerHarness && (
+          <span className="shrink-0 text-border" aria-hidden>·</span>
+        )}
+        <span className="truncate">{triggerLabel}</span>
         <ChevronIcon />
       </Popover.Trigger>
 
@@ -210,12 +275,36 @@ export function ModelSelector({
             role="dialog"
             aria-label="Model selector"
             className={cn(
-              "z-popover w-72 rounded-lg border border-border bg-popover shadow-md",
+              "z-popover w-80 rounded-lg border border-border bg-popover shadow-md",
               "text-popover-foreground",
             )}
           >
+            {/* Harness dropdown (only when not locked) */}
+            {!isHarnessLocked && (
+              <div className="border-b border-border px-3 py-2">
+                <label className="mb-1 block text-[0.6rem] font-medium uppercase tracking-wider text-muted-foreground">
+                  Harness
+                </label>
+                <select
+                  value={activeHarness}
+                  onChange={(e) => handleHarnessChange(e.target.value as HarnessOption)}
+                  className={cn(
+                    "w-full rounded-md border border-border bg-background px-2 py-1.5 text-xs text-foreground",
+                    "focus:outline-none focus:ring-2 focus:ring-ring",
+                  )}
+                  aria-label="Select harness"
+                >
+                  {resolvedHarnesses.map((h) => (
+                    <option key={h} value={h}>
+                      {HARNESS_META[h].label}
+                    </option>
+                  ))}
+                </select>
+              </div>
+            )}
+
             {/* Search input */}
-            <div className="border-b border-border px-2 py-1.5">
+            <div className="border-b border-border px-3 py-1.5">
               <input
                 ref={searchRef}
                 role="searchbox"
@@ -236,59 +325,47 @@ export function ModelSelector({
               ref={listRef}
               role="listbox"
               aria-label="Available models"
-              className="max-h-64 overflow-y-auto p-1"
+              className="max-h-72 overflow-y-auto p-1"
             >
               {visibleModels.length === 0 && (
                 <div className="px-2 py-3 text-center text-xs text-muted-foreground">
                   No models found
                 </div>
               )}
-              {visibleModels.map((model, idx) => {
-                const key = modelKey(model.harness, model.modelId);
-                const isSelected = selectedModel
-                  ? model.harness === selectedModel.harness && model.modelId === selectedModel.modelId
-                  : false;
-                const isHighlighted = idx === highlightIdx;
-
-                return (
-                  <button
-                    key={key}
-                    data-model-option=""
-                    role="option"
-                    aria-selected={isSelected}
-                    type="button"
-                    className={cn(
-                      "flex w-full cursor-pointer items-center gap-2 rounded-md px-2 py-1.5 text-xs outline-none",
-                      "transition-colors",
-                      isHighlighted && "bg-accent text-accent-foreground",
-                      !isHighlighted && "hover:bg-accent-hover",
-                      isSelected && "font-medium",
-                    )}
+
+              {/* Grouped rendering */}
+              {groupedModels ? (
+                Array.from(groupedModels.entries()).map(([group, groupModels]) => (
+                  <div key={group}>
+                    <div className="px-2 pb-0.5 pt-2 text-[0.6rem] font-medium uppercase tracking-wider text-muted-foreground">
+                      {group}
+                    </div>
+                    {groupModels.map((model) => (
+                      <ModelRow
+                        key={model.modelId}
+                        model={model}
+                        isSelected={model.modelId === selectedModel.modelId}
+                        showDescription={false}
+                        showSpeedBadge={showSpeedBadge}
+                        onClick={() => selectModel(model)}
+                      />
+                    ))}
+                  </div>
+                ))
+              ) : (
+                visibleModels.map((model, idx) => (
+                  <ModelRow
+                    key={model.modelId}
+                    model={model}
+                    isSelected={model.modelId === selectedModel.modelId}
+                    isHighlighted={idx === highlightIdx}
+                    showDescription={showDescriptions && !compact && !isSearching && !showAll}
+                    showSpeedBadge={showSpeedBadge}
                     onClick={() => selectModel(model)}
                     onMouseEnter={() => setHighlightIdx(idx)}
-                  >
-                    {/* Model name */}
-                    <span className="flex-1 truncate text-left">{model.displayName}</span>
-
-                    {/* Engine tag (unified mode only) */}
-                    {isUnified && (
-                      <span className="shrink-0 rounded bg-muted px-1 py-0.5 text-[0.55rem] font-medium text-muted-foreground">
-                        {HARNESS_LABELS[model.harness]}
-                      </span>
-                    )}
-
-                    {/* Cost tier */}
-                    <span className="shrink-0 text-[0.6rem] text-muted-foreground">
-                      {COST_TIER_LABEL[model.costTier]}
-                    </span>
-
-                    {/* Selected checkmark */}
-                    {isSelected && (
-                      <CheckIcon className="shrink-0 text-primary" />
-                    )}
-                  </button>
-                );
-              })}
+                  />
+                ))
+              )}
 
               {/* Show All Models */}
               {showShowAllButton && (
@@ -301,7 +378,7 @@ export function ModelSelector({
                   )}
                   onClick={() => setShowAll(true)}
                 >
-                  Show All Models
+                  Show all models
                 </button>
               )}
             </div>
@@ -312,6 +389,66 @@ export function ModelSelector({
   );
 }
 
+interface ModelRowProps {
+  model: ModelInfo;
+  isSelected: boolean;
+  isHighlighted?: boolean;
+  showDescription: boolean;
+  showSpeedBadge: boolean;
+  onClick: () => void;
+  onMouseEnter?: () => void;
+}
+
+function ModelRow({
+  model,
+  isSelected,
+  isHighlighted,
+  showDescription,
+  showSpeedBadge,
+  onClick,
+  onMouseEnter,
+}: ModelRowProps) {
+  return (
+    <button
+      data-model-option=""
+      role="option"
+      aria-selected={isSelected}
+      type="button"
+      className={cn(
+        "flex w-full cursor-pointer flex-col rounded-md px-2 py-1.5 text-xs outline-none",
+        "transition-colors",
+        isHighlighted && "bg-accent text-accent-foreground",
+        !isHighlighted && "hover:bg-accent-hover",
+        isSelected && "font-medium",
+      )}
+      onClick={onClick}
+      onMouseEnter={onMouseEnter}
+    >
+      <div className="flex w-full items-center gap-2">
+        <span className="flex-1 truncate text-left">{model.displayName}</span>
+
+        {showSpeedBadge && (
+          <span className="shrink-0 text-[0.6rem] text-muted-foreground">
+            {SPEED_TIER_LABEL[model.speedTier]}
+          </span>
+        )}
+
+        <span className="shrink-0 text-[0.6rem] text-muted-foreground">
+          {COST_TIER_LABEL[model.costTier]}
+        </span>
+
+        {isSelected && <CheckIcon className="shrink-0 text-primary" />}
+      </div>
+
+      {showDescription && model.shortDescription && (
+        <span className="mt-0.5 block text-left text-[0.6rem] text-muted-foreground">
+          {model.shortDescription}
+        </span>
+      )}
+    </button>
+  );
+}
+
 function ChevronIcon() {
   return (
     <svg

package/src/models/__tests__/useModelRegistry.test.tsx

@@ -137,11 +137,13 @@ describe("useModelRegistry", () => {
       expect(cursorModels).toHaveLength(0);
     });
 
-    it("resolves defaultModel to DEFAULT_MODEL_ID", () => {
+    it("resolves defaultModel to the first featured native model", () => {
       const { result } = renderHook(() =>
         useModelRegistry({ harness: "native" }),
       );
-      expect(result.current.defaultModel.modelId).toBe(DEFAULT_MODEL_ID);
+      const featured = result.current.featured;
+      expect(featured.length).toBeGreaterThan(0);
+      expect(result.current.defaultModel.modelId).toBe(featured[0].modelId);
     });
   });