@tangle-network/sandbox-ui 0.61.0 → 0.63.0

package/dist/{WorkflowGraph-VMG2ZEAN.js → WorkflowGraph-M5ZOY43R.js}

@@ -2,11 +2,9 @@ import {
   ProviderIcon
 } from "./chunk-GTJ5PSK5.js";
 import {
-  buildWorkflowGraph
-} from "./chunk-WEYFEMIN.js";
-import {
+  buildWorkflowGraph,
   providerLabel
-} from "./chunk-7JLB7UZ3.js";
+} from "./chunk-34F66QTV.js";
 import "./chunk-U67V476Y.js";
 
 // src/workflows/WorkflowGraph.tsx

package/dist/chat.d.ts

@@ -124,8 +124,21 @@ interface AgentSessionHarnessControl {
      * switch harness.
      */
     locked?: boolean;
-    /** Tooltip shown on the locked trigger. */
+    /** Tooltip shown on the locked trigger when no `onNewChat` is provided. */
     lockReason?: string;
+    /**
+     * Fork action for a locked harness. When provided, the locked trigger turns
+     * into an informative chip: hover or tap opens a small popover explaining the
+     * lock and offering a button that calls this to start a fresh session. When
+     * omitted, the locked trigger stays a plain inert button with `lockReason`.
+     */
+    onNewChat?: () => void;
+    /** Popover heading. Defaults to `Agent fixed to {harness} for this conversation.` */
+    lockTitle?: React.ReactNode;
+    /** Popover sub-line. Defaults to "Conversations stay on one agent." */
+    lockBody?: React.ReactNode;
+    /** Fork button label. Defaults to "New chat to switch agent". */
+    newChatLabel?: string;
 }
 interface AgentSessionModelControl {
     /** Canonical model id (provider-prefixed, e.g. "anthropic/claude-opus-4-8"). */
@@ -180,6 +193,16 @@ interface AgentSessionControlsProps {
     model?: AgentSessionModelControl;
     /** Thinking-effort level applied to subsequent turns. */
     reasoning?: AgentSessionReasoningControl;
+    /**
+     * Restrict the model catalog to what the selected harness can actually run,
+     * the same way `harness.locked` does — but WITHOUT locking the harness
+     * dropdown. Off by default: the strip shows every model and picking an
+     * incompatible one snaps the harness to the model's native backend. Turn it
+     * ON for a harness-first surface (e.g. a workspace-wide, sandbox-bound
+     * harness) where that silent backend swap is undesirable — an incompatible
+     * model is then simply not offered.
+     */
+    filterModelsToHarness?: boolean;
     /** Right-aligned extra content (token meter, cost, status). */
     trailing?: React.ReactNode;
     className?: string;
@@ -218,12 +241,17 @@ interface AgentSessionControlsProps {
  * coherent automatically (see harness-model-compat): picking a harness
  * snaps an incompatible model to that harness's best catalog option;
  * picking a model the current harness can't run switches to the model's
- * native harness — unless the harness is `locked`, in which case the
- * catalog itself is filtered to compatible models.
+ * native harness — unless the catalog is restricted to the harness (when
+ * `locked`, or the consumer sets `filterModelsToHarness`), in which case the
+ * incompatible model is never offered and no swap happens.
+ *
+ * When a reasoning control is also present, the effort is re-clamped into the
+ * set the new (harness, model) pair supports on every harness/model change, so
+ * the effort picker's label never disagrees with the value actually in effect.
  *
  * Designed to slot into `SandboxWorkbench`'s `session.composerControls`.
  */
-declare function AgentSessionControls({ harness, profile, model, reasoning, trailing, className, context, layout, menuPlacement, }: AgentSessionControlsProps): react_jsx_runtime.JSX.Element | null;
+declare function AgentSessionControls({ harness, profile, model, reasoning, filterModelsToHarness, trailing, className, context, layout, menuPlacement, }: AgentSessionControlsProps): react_jsx_runtime.JSX.Element | null;
 
 /** A staged attachment shown as a chip above the input. */
 interface ComposerFile {

package/dist/chat.js

@@ -17,7 +17,7 @@ import {
   modelProvider,
   snapHarnessToModel,
   snapModelToHarness
-} from "./chunk-V5JZOO3W.js";
+} from "./chunk-2E3FJM56.js";
 import "./chunk-HU4B2M4K.js";
 import "./chunk-SF6LPMMN.js";
 import "./chunk-EI44GEQ5.js";

package/dist/{chunk-V5JZOO3W.js → chunk-2E3FJM56.js}

@@ -28,6 +28,12 @@ import * as DropdownMenu from "@radix-ui/react-dropdown-menu";
 import { Brain, ChevronDown, Sparkles } from "lucide-react";
 import { jsx, jsxs } from "react/jsx-runtime";
 var REASONING_LADDER = reasoningLadder;
+function clampReasoningLevel(value, available) {
+  if (value === "auto" || !available || available.includes(value)) {
+    return value;
+  }
+  return available.length ? available[available.length - 1] : "auto";
+}
 function ReasoningGlyph({ level }) {
   if (level === "auto") {
     return /* @__PURE__ */ jsx(Sparkles, { className: "h-3.5 w-3.5 text-muted-foreground" });
@@ -144,9 +150,30 @@ function ReasoningLevelPicker({
 }
 
 // src/chat/agent-session-controls.tsx
-import { reasoningEffortsFor } from "@tangle-network/agent-interface";
+import {
+  harnessHonorsEffort,
+  harnessHonorsModel,
+  reasoningEffortsFor
+} from "@tangle-network/agent-interface";
 import * as DropdownMenu2 from "@radix-ui/react-dropdown-menu";
-import { ChevronDown as ChevronDown3, Lock, SlidersHorizontal } from "lucide-react";
+import { ChevronDown as ChevronDown3, Lock, Plus as Plus2, SlidersHorizontal } from "lucide-react";
+import * as React3 from "react";
+
+// src/lib/use-click-outside.ts
+import * as React from "react";
+function useClickOutside(onOutside) {
+  const ref = React.useRef(null);
+  React.useEffect(() => {
+    function handler(event) {
+      if (ref.current && !ref.current.contains(event.target)) {
+        onOutside();
+      }
+    }
+    document.addEventListener("mousedown", handler);
+    return () => document.removeEventListener("mousedown", handler);
+  }, [onOutside]);
+  return ref;
+}
 
 // src/chat/harness-model-compat.ts
 import {
@@ -163,21 +190,8 @@ function snapModelToHarness(harness, modelId, models) {
 
 // src/chat/agent-profile-picker.tsx
 import { Bot, Check, ChevronDown as ChevronDown2, Pencil, Plus, Trash2 } from "lucide-react";
-import * as React from "react";
+import * as React2 from "react";
 import { jsx as jsx2, jsxs as jsxs2 } from "react/jsx-runtime";
-function useClickOutside(onOutside) {
-  const ref = React.useRef(null);
-  React.useEffect(() => {
-    function handler(event) {
-      if (ref.current && !ref.current.contains(event.target)) {
-        onOutside();
-      }
-    }
-    document.addEventListener("mousedown", handler);
-    return () => document.removeEventListener("mousedown", handler);
-  }, [onOutside]);
-  return ref;
-}
 function profileSubtitle(profile) {
   if (profile.description) return profile.description;
   const count = profile.capabilities?.length ?? 0;
@@ -195,8 +209,8 @@ function AgentProfilePicker({
   className,
   side = "top"
 }) {
-  const [open, setOpen] = React.useState(false);
-  const [composing, setComposing] = React.useState(
+  const [open, setOpen] = React2.useState(false);
+  const [composing, setComposing] = React2.useState(
     null
   );
   const ref = useClickOutside(() => {
@@ -363,11 +377,11 @@ function ProfileForm({
   onCancel,
   onSave
 }) {
-  const [name, setName] = React.useState(initial?.name ?? "");
-  const [caps, setCaps] = React.useState(
+  const [name, setName] = React2.useState(initial?.name ?? "");
+  const [caps, setCaps] = React2.useState(
     initial?.capabilities ? [...initial.capabilities] : capabilities.map((c) => c.id)
   );
-  const [instructions, setInstructions] = React.useState(initial?.instructions ?? "");
+  const [instructions, setInstructions] = React2.useState(initial?.instructions ?? "");
   const toggle = (id) => setCaps(
     (prev) => prev.includes(id) ? prev.filter((c) => c !== id) : [...prev, id]
   );
@@ -448,6 +462,110 @@ function ProfileForm({
 
 // src/chat/agent-session-controls.tsx
 import { jsx as jsx3, jsxs as jsxs3 } from "react/jsx-runtime";
+function selectorIgnoreNote(harness) {
+  const ignoresModel = !harnessHonorsModel(harness);
+  const ignoresEffort = !harnessHonorsEffort(harness);
+  if (ignoresModel && ignoresEffort) return "Ignores model & effort";
+  if (ignoresModel) return "Ignores model selection";
+  if (ignoresEffort) return "Ignores reasoning effort";
+  return null;
+}
+function InformativeLock({
+  label,
+  lockTitle,
+  lockBody,
+  newChatLabel,
+  onNewChat
+}) {
+  const [open, setOpen] = React3.useState(false);
+  const closeTimer = React3.useRef(null);
+  const ref = useClickOutside(() => setOpen(false));
+  const cancelClose = React3.useCallback(() => {
+    if (closeTimer.current) {
+      clearTimeout(closeTimer.current);
+      closeTimer.current = null;
+    }
+  }, []);
+  const scheduleClose = React3.useCallback(() => {
+    cancelClose();
+    closeTimer.current = setTimeout(() => setOpen(false), 150);
+  }, [cancelClose]);
+  React3.useEffect(() => cancelClose, [cancelClose]);
+  return /* @__PURE__ */ jsxs3(
+    "div",
+    {
+      ref,
+      className: "relative inline-flex",
+      onMouseEnter: () => {
+        cancelClose();
+        setOpen(true);
+      },
+      onMouseLeave: scheduleClose,
+      onKeyDown: (event) => {
+        if (event.key === "Escape") setOpen(false);
+      },
+      children: [
+        /* @__PURE__ */ jsxs3(
+          "button",
+          {
+            type: "button",
+            onClick: () => setOpen(true),
+            "data-state": open ? "open" : "closed",
+            "aria-label": "Agent harness (locked)",
+            "aria-haspopup": "dialog",
+            "aria-expanded": open,
+            className: cn(
+              "inline-flex h-8 items-center gap-1.5 rounded-lg border border-[var(--md3-outline-variant)] bg-surface-container px-2.5",
+              "text-xs font-medium text-foreground shadow-sm transition-colors",
+              "hover:border-[var(--md3-outline-variant)] hover:bg-surface-container-high focus:outline-none focus-visible:ring-1 focus-visible:ring-ring",
+              "data-[state=open]:border-[var(--md3-outline-variant)] data-[state=open]:bg-surface-container-high"
+            ),
+            children: [
+              /* @__PURE__ */ jsx3(Lock, { className: "h-3 w-3 text-muted-foreground" }),
+              /* @__PURE__ */ jsx3("span", { children: label })
+            ]
+          }
+        ),
+        open && /* @__PURE__ */ jsxs3(
+          "div",
+          {
+            role: "dialog",
+            className: cn(
+              "absolute bottom-full left-0 z-50 mb-2 w-72 rounded-[var(--radius-md)] border border-[var(--md3-outline-variant)] bg-surface-container-highest p-3",
+              "shadow-[0_8px_30px_rgba(0,0,0,0.45)] ring-1 ring-[#ffffff14]"
+            ),
+            children: [
+              /* @__PURE__ */ jsxs3("p", { className: "flex items-start gap-2 text-sm font-medium text-foreground", children: [
+                /* @__PURE__ */ jsx3(Lock, { className: "mt-0.5 h-3.5 w-3.5 shrink-0 text-muted-foreground" }),
+                /* @__PURE__ */ jsx3("span", { children: lockTitle ?? `Agent fixed to ${label} for this conversation.` })
+              ] }),
+              /* @__PURE__ */ jsx3("p", { className: "mt-1.5 text-xs text-muted-foreground", children: lockBody ?? "Conversations stay on one agent." }),
+              /* @__PURE__ */ jsxs3(
+                "button",
+                {
+                  type: "button",
+                  onClick: () => {
+                    setOpen(false);
+                    onNewChat();
+                  },
+                  className: cn(
+                    "mt-3 flex w-full items-center justify-center gap-1.5 rounded-md px-2.5 py-2 text-sm font-medium text-foreground",
+                    "bg-primary/10 ring-1 ring-inset ring-primary/25 transition-colors",
+                    "hover:bg-primary/15 focus:outline-none focus-visible:ring-1 focus-visible:ring-ring"
+                  ),
+                  children: [
+                    /* @__PURE__ */ jsx3(Plus2, { className: "h-4 w-4" }),
+                    newChatLabel ?? "New chat to switch agent"
+                  ]
+                }
+              )
+            ]
+          }
+        )
+      ]
+    }
+  );
+}
 function HarnessDropdown({
   value,
   onChange,
@@ -455,6 +573,10 @@ function HarnessDropdown({
   disabled,
   locked,
   lockReason,
+  onNewChat,
+  lockTitle,
+  lockBody,
+  newChatLabel,
   side = "bottom",
   align = "start",
   avoidCollisions
@@ -464,6 +586,18 @@ function HarnessDropdown({
   );
   const options = HARNESS_OPTIONS.filter((h) => allowed.has(h.type));
   const selected = options.find((option) => option.type === value);
+  if (locked && onNewChat) {
+    return /* @__PURE__ */ jsx3(
+      InformativeLock,
+      {
+        label: selected?.label ?? value,
+        lockTitle,
+        lockBody,
+        newChatLabel,
+        onNewChat
+      }
+    );
+  }
   return /* @__PURE__ */ jsxs3(DropdownMenu2.Root, { children: [
     /* @__PURE__ */ jsx3(DropdownMenu2.Trigger, { asChild: true, children: /* @__PURE__ */ jsxs3(
       "button",
@@ -520,7 +654,8 @@ function HarnessDropdown({
               /* @__PURE__ */ jsx3(HarnessLogo, { type: option.type, size: 20, className: "mt-0.5" }),
               /* @__PURE__ */ jsxs3("span", { className: "flex min-w-0 flex-col gap-0.5", children: [
                 /* @__PURE__ */ jsx3("span", { className: "text-sm font-medium", children: option.label }),
-                option.description && /* @__PURE__ */ jsx3("span", { className: "text-xs text-muted-foreground", children: option.description })
+                option.description && /* @__PURE__ */ jsx3("span", { className: "text-xs text-muted-foreground", children: option.description }),
+                selectorIgnoreNote(option.type) && /* @__PURE__ */ jsx3("span", { className: "mt-0.5 inline-flex w-fit items-center rounded border border-[var(--md3-outline-variant)] px-1.5 py-0.5 text-[10px] font-medium uppercase tracking-wide text-muted-foreground", children: selectorIgnoreNote(option.type) })
               ] })
             ]
           },
@@ -530,11 +665,20 @@ function HarnessDropdown({
     ) })
   ] });
 }
+function modelReasoningCapability(models, canonicalId) {
+  if (!models || !canonicalId) return null;
+  const entry = models.find((m) => canonicalModelId(m) === canonicalId);
+  return entry ? {
+    supportsReasoning: entry.supportsReasoning,
+    maxEffort: entry.maxReasoningEffort
+  } : null;
+}
 function AgentSessionControls({
   harness,
   profile,
   model,
   reasoning,
+  filterModelsToHarness,
   trailing,
   className,
   context = "chat",
@@ -542,21 +686,45 @@ function AgentSessionControls({
   menuPlacement = "auto"
 }) {
   if (!harness && !profile && !model && !reasoning && !trailing) return null;
+  const restrictModelsToHarness = Boolean(
+    harness && (harness.locked || filterModelsToHarness)
+  );
+  const selectorHonorsModel = !harness || harnessHonorsModel(harness.value);
+  const selectorHonorsEffort = !harness || harnessHonorsEffort(harness.value);
+  const clampEffort = (harnessValue, modelId) => {
+    if (!reasoning) return;
+    const available = reasoningEffortsFor(
+      harnessValue,
+      modelReasoningCapability(model?.models, modelId)
+    );
+    const clamped = clampReasoningLevel(reasoning.value, available);
+    if (clamped !== reasoning.value) reasoning.onChange(clamped);
+  };
   const handleHarnessChange = (next) => {
     harness?.onChange(next);
+    let nextModelId = model?.value;
     if (model) {
       const snapped = snapModelToHarness(next, model.value, model.models);
-      if (snapped !== model.value) model.onChange(snapped);
+      if (snapped !== model.value) {
+        model.onChange(snapped);
+        nextModelId = snapped;
+      }
     }
+    clampEffort(next, nextModelId);
   };
   const handleModelChange = (nextModelId) => {
     model?.onChange(nextModelId);
-    if (harness && !harness.locked) {
+    let nextHarness = harness?.value;
+    if (harness && !restrictModelsToHarness) {
       const snapped = snapHarnessToModel(harness.value, nextModelId);
-      if (snapped !== harness.value) harness.onChange(snapped);
+      if (snapped !== harness.value) {
+        harness.onChange(snapped);
+        nextHarness = snapped;
+      }
     }
+    if (nextHarness) clampEffort(nextHarness, nextModelId);
   };
-  const visibleModels = model && harness?.locked ? model.models.filter(
+  const visibleModels = model && restrictModelsToHarness && harness ? model.models.filter(
     (entry) => isModelCompatibleWithHarness(
       harness.value,
       canonicalModelId(entry)
@@ -603,25 +771,19 @@ function AgentSessionControls({
       loading: model.loading,
       popular: model.popular,
       recents: model.recents,
-      disabled: model.disabled || (visibleModels ?? []).length === 0,
+      disabled: model.disabled || (visibleModels ?? []).length === 0 || !selectorHonorsModel,
       side: layout === "gear" ? void 0 : "bottom",
       avoidCollisions
     }
   );
-  const selectedModel = model?.models.find(
-    (entry) => canonicalModelId(entry) === model.value
-  );
-  const modelReasoning = selectedModel ? {
-    supportsReasoning: selectedModel.supportsReasoning,
-    maxEffort: selectedModel.maxReasoningEffort
-  } : null;
+  const modelReasoning = modelReasoningCapability(model?.models, model?.value);
   const reasoningNode = reasoning && /* @__PURE__ */ jsx3(
     ReasoningLevelPicker,
     {
       value: reasoning.value,
       onChange: reasoning.onChange,
       options: reasoning.options,
-      disabled: reasoning.disabled,
+      disabled: reasoning.disabled || !selectorHonorsEffort,
       available: harness ? reasoningEffortsFor(harness.value, modelReasoning) : reasoning.available,
       side: layout === "gear" ? void 0 : "bottom",
       avoidCollisions
@@ -739,7 +901,7 @@ import {
   Upload,
   X
 } from "lucide-react";
-import * as React2 from "react";
+import * as React4 from "react";
 import { Fragment, jsx as jsx4, jsxs as jsxs4 } from "react/jsx-runtime";
 function AgentComposer({
   value,
@@ -770,22 +932,22 @@ function AgentComposer({
   sendLabel = "Send",
   autoFocus
 }) {
-  const textareaRef = React2.useRef(null);
-  const fileInputRef = React2.useRef(null);
-  const folderInputRef = React2.useRef(null);
-  const [dragOver, setDragOver] = React2.useState(false);
-  const dragDepth = React2.useRef(0);
-  const resize = React2.useCallback(
+  const textareaRef = React4.useRef(null);
+  const fileInputRef = React4.useRef(null);
+  const folderInputRef = React4.useRef(null);
+  const [dragOver, setDragOver] = React4.useState(false);
+  const dragDepth = React4.useRef(0);
+  const resize = React4.useCallback(
     (el) => {
       el.style.height = "auto";
       el.style.height = `${Math.min(el.scrollHeight, maxHeight)}px`;
     },
     [maxHeight]
   );
-  React2.useEffect(() => {
+  React4.useEffect(() => {
     if (textareaRef.current) resize(textareaRef.current);
   }, [value, resize]);
-  React2.useEffect(() => {
+  React4.useEffect(() => {
     if (!focusShortcut || disabled) return;
     function onKeyDown(event) {
       if ((event.metaKey || event.ctrlKey) && event.key.toLowerCase() === "l") {
@@ -1024,7 +1186,7 @@ function AgentComposer({
 }
 
 // src/chat/artifact-agent-dock.tsx
-import * as React3 from "react";
+import * as React5 from "react";
 import { Sparkles as Sparkles2, Send, Square as Square2, X as X2 } from "lucide-react";
 import { ChatMessage } from "@tangle-network/ui/chat";
 import { jsx as jsx5, jsxs as jsxs5 } from "react/jsx-runtime";
@@ -1073,23 +1235,23 @@ function ArtifactAgentDock({
   onError,
   className
 }) {
-  const [threadId, setThreadId] = React3.useState(null);
-  const [messages, setMessages] = React3.useState([]);
-  const [composer, setComposer] = React3.useState(defaultPrompt ?? "");
-  const [streamContent, setStreamContent] = React3.useState("");
-  const [sending, setSending] = React3.useState(false);
-  const [loading, setLoading] = React3.useState(false);
-  const abortRef = React3.useRef(null);
-  const scrollRef = React3.useRef(null);
-  const scopeTokenRef = React3.useRef(0);
-  const reportError = React3.useCallback(
+  const [threadId, setThreadId] = React5.useState(null);
+  const [messages, setMessages] = React5.useState([]);
+  const [composer, setComposer] = React5.useState(defaultPrompt ?? "");
+  const [streamContent, setStreamContent] = React5.useState("");
+  const [sending, setSending] = React5.useState(false);
+  const [loading, setLoading] = React5.useState(false);
+  const abortRef = React5.useRef(null);
+  const scrollRef = React5.useRef(null);
+  const scopeTokenRef = React5.useRef(0);
+  const reportError = React5.useCallback(
     (message) => {
       if (onError) onError(message);
       else if (typeof console !== "undefined") console.error("[ArtifactAgentDock]", message);
     },
     [onError]
   );
-  React3.useEffect(() => {
+  React5.useEffect(() => {
     if (!open) return;
     scopeTokenRef.current += 1;
     abortRef.current?.abort();
@@ -1125,11 +1287,11 @@ function ArtifactAgentDock({
       cancelled = true;
     };
   }, [open, scope.kind, scope.key, transport, reportError]);
-  React3.useEffect(() => {
+  React5.useEffect(() => {
     if (!scrollRef.current) return;
     scrollRef.current.scrollTop = scrollRef.current.scrollHeight;
   }, [messages.length, streamContent]);
-  const send = React3.useCallback(async () => {
+  const send = React5.useCallback(async () => {
     const text = composer.trim();
     if (!text || !threadId || sending) return;
     const token = scopeTokenRef.current;
@@ -1179,7 +1341,7 @@ function ArtifactAgentDock({
       if (abortRef.current === controller) abortRef.current = null;
     }
   }, [composer, threadId, sending, transport, reportError]);
-  const cancel = React3.useCallback(() => {
+  const cancel = React5.useCallback(() => {
     if (threadId && transport.cancel) {
       try {
         void Promise.resolve(transport.cancel({ threadId })).catch(() => {

package/dist/{chunk-WEYFEMIN.js → chunk-34F66QTV.js}

@@ -1,6 +1,17 @@
-import {
-  providerLabel
-} from "./chunk-7JLB7UZ3.js";
+// src/workflows/provider-label.ts
+var PROVIDER_LABELS = {
+  github: "GitHub",
+  gitlab: "GitLab",
+  slack: "Slack",
+  stripe: "Stripe",
+  notion: "Notion",
+  linear: "Linear",
+  discord: "Discord"
+};
+function providerLabel(provider) {
+  const key = provider.toLowerCase();
+  return PROVIDER_LABELS[key] ?? provider.charAt(0).toUpperCase() + provider.slice(1);
+}
 
 // src/workflows/model.ts
 import { parse as parseYaml } from "yaml";
@@ -293,5 +304,6 @@ function buildWorkflowGraph(yaml, options) {
 }
 
 export {
+  providerLabel,
   buildWorkflowGraph
 };

package/dist/{chunk-J36F6LD2.js → chunk-6OJUOEF4.js}

@@ -3,7 +3,7 @@ import {
 } from "./chunk-3J6FG3FJ.js";
 import {
   PortsList
-} from "./chunk-OQZQFSWM.js";
+} from "./chunk-DZA4UBXU.js";
 import {
   TerminalView
 } from "./chunk-VIREDUBF.js";

package/dist/{chunk-OQZQFSWM.js → chunk-DZA4UBXU.js}

@@ -564,13 +564,17 @@ function RailExpandable({
   loadSubItems,
   activeSubIds,
   emptyLabel = "Nothing here yet",
+  defaultOpen,
   onNavigate,
   LinkComponent,
   className
 }) {
   const Link = LinkComponent ?? DefaultLink;
-  const [open, setOpen] = React3.useState(false);
+  const [open, setOpen] = React3.useState(defaultOpen ?? false);
   const { items, loading, ensureLoaded } = useExpandableItems(subItems, loadSubItems);
+  React3.useEffect(() => {
+    if (defaultOpen) ensureLoaded();
+  }, [defaultOpen, ensureLoaded]);
   const activeSet = React3.useMemo(() => new Set(activeSubIds ?? []), [activeSubIds]);
   const triggerRef = React3.useRef(null);
   const closeTimer = React3.useRef(null);
@@ -589,8 +593,8 @@ function RailExpandable({
         onClick: onNavigate,
         ...item.prefetch !== void 0 ? { prefetch: item.prefetch } : {},
         className: cn(
-          "flex h-8 min-w-0 items-center gap-2 rounded-md px-2.5 text-[12px] transition-colors",
-          active ? "bg-[var(--accent-surface-strong)] font-medium text-[var(--accent-text)]" : "text-muted-foreground hover:bg-[var(--accent-surface-soft)] hover:text-foreground"
+          "flex h-7 min-w-0 items-center gap-2 rounded-md px-2.5 text-[12px] transition-colors",
+          active ? "bg-[var(--accent-surface-strong)] font-medium text-[var(--accent-text)]" : item.emphasis ? "font-semibold text-[var(--accent-text)] hover:bg-[var(--accent-surface-soft)]" : "text-muted-foreground hover:bg-[var(--accent-surface-soft)] hover:text-foreground"
         ),
         children: [
           FIcon ? /* @__PURE__ */ jsx3(FIcon, { className: "h-4 w-4 shrink-0" }) : null,
@@ -719,18 +723,15 @@ function RailExpandable({
                 /* @__PURE__ */ jsx3(
                   Icon,
                   {
-                    className: cn(
-                      "h-[17px] w-[17px] shrink-0 transition-opacity duration-150",
-                      open ? "opacity-0" : "opacity-100 group-hover/exp:opacity-0"
-                    )
+                    className: "h-[17px] w-[17px] shrink-0 opacity-100 transition-opacity duration-150 group-hover/exp:opacity-0"
                   }
                 ),
                 /* @__PURE__ */ jsx3(
                   ChevronRightIcon,
                   {
                     className: cn(
-                      "absolute h-4 w-4 transition-all duration-150",
-                      open ? "rotate-90 opacity-100" : "opacity-0 group-hover/exp:opacity-100"
+                      "absolute h-4 w-4 opacity-0 transition-all duration-150 group-hover/exp:opacity-100",
+                      open && "rotate-90"
                     )
                   }
                 )
@@ -2368,6 +2369,7 @@ function SidebarLayoutInner({
                 loadSubItems: item.loadSubItems,
                 activeSubIds: item.subActiveIds,
                 emptyLabel: item.emptyLabel,
+                defaultOpen: item.defaultOpen,
                 onNavigate: handleNavClick,
                 LinkComponent
               },

package/dist/dashboard.d.ts

@@ -185,6 +185,9 @@ interface RailExpandableSubItem {
     prefetch?: "none" | "intent" | "render" | "viewport";
     /** Show a live working indicator on the row while the item is busy. */
     isLoading?: boolean;
+    /** Render the row emphasized (bold + accent) so it stands out — e.g. a
+     *  trailing "view all" action below a capped list. */
+    emphasis?: boolean;
 }
 interface RailExpandableProps {
     icon: React.ComponentType<{
@@ -201,6 +204,8 @@ interface RailExpandableProps {
     subItems?: RailExpandableSubItem[];
     /** Lazy sub-items — called once on first open; the result is cached. */
     loadSubItems?: () => Promise<RailExpandableSubItem[]>;
+    /** Start expanded on mount (labeled rail). Defaults to collapsed. */
+    defaultOpen?: boolean;
     /** Ids of sub-items whose route is active (drives sub-item highlight). */
     activeSubIds?: string[];
     /** Shown when the resolved sub-item list is empty. */
@@ -218,7 +223,7 @@ interface RailExpandableProps {
  * Sub-items can be fixed (`subItems`) or lazy (`loadSubItems`, with a loading
  * skeleton). Used for e.g. a "History" entry fronting recent sessions.
  */
-declare function RailExpandable({ icon: Icon, label, href, isActive, showLabel, subItems, loadSubItems, activeSubIds, emptyLabel, onNavigate, LinkComponent, className, }: RailExpandableProps): react_jsx_runtime.JSX.Element;
+declare function RailExpandable({ icon: Icon, label, href, isActive, showLabel, subItems, loadSubItems, activeSubIds, emptyLabel, defaultOpen, onNavigate, LinkComponent, className, }: RailExpandableProps): react_jsx_runtime.JSX.Element;
 interface RailModeButtonProps {
     mode: string;
     icon: React.ComponentType<{
@@ -913,6 +918,8 @@ interface SidebarLayoutNavItem {
     subActiveIds?: string[];
     /** Empty-state text for an `expandable` item that resolves to no sub-items. */
     emptyLabel?: string;
+    /** Start an `expandable` item expanded on mount (labeled rail). */
+    defaultOpen?: boolean;
     badge?: number;
     /**
      * React Router prefetch behavior for this link, forwarded to the underlying

package/dist/dashboard.js

@@ -54,7 +54,7 @@ import {
   canAdminSandbox,
   parseInsufficientBalance,
   useSidebar
-} from "./chunk-OQZQFSWM.js";
+} from "./chunk-DZA4UBXU.js";
 import {
   BillingDashboard,
   InfoPanel,