tmux-ide 2.9.2 → 2.9.4

package/packages/daemon/src/tui/mirror/runtime/application-machine-authority.ts

@@ -41,9 +41,9 @@ export interface ApplicationMachineAuthorityManagerDependencies {
 }
 interface Machine {
   readonly id: string;
-  readonly label: string;
+  label: string;
   readonly kind: "local" | "ssh";
-  readonly profile?: SavedMachine;
+  profile?: SavedMachine;
   owner: Owner;
   readonly handle: ApplicationMachineAuthorityHandle;
   readonly listeners: Set<GenerationListener>;
@@ -51,6 +51,7 @@ interface Machine {
   stopObserver: (() => void) | null;
   observingOwner: Owner | null;
   stopStatus: (() => void) | null;
+  retired: boolean;
 }
 
 /** Owns independent transport lifetimes; selecting a machine changes only the active route. */
@@ -67,6 +68,7 @@ export function createApplicationMachineAuthorityManager(
   let selectedId: string = LOCAL_MACHINE_ID;
   let selectedEpoch = 0;
   let disposed = false;
+  let stopProfiles: (() => void) | null = null;
   const safe = (callback: () => void) => {
     try {
       callback();
@@ -81,7 +83,7 @@ export function createApplicationMachineAuthorityManager(
     for (const listener of selectedObservers) safe(() => listener(generation));
   };
   const changed = (machine: Machine, generation: string | null) => {
-    if (disposed) return;
+    if (disposed || machine.retired) return;
     machine.epoch++;
     for (const listener of machine.listeners) safe(() => listener(generation));
     if (machine.id === selectedId) {
@@ -99,7 +101,7 @@ export function createApplicationMachineAuthorityManager(
       })
       .then(
         (stop) => {
-          if (disposed || machine.owner !== owner) stop();
+          if (disposed || machine.retired || machine.owner !== owner) stop();
           else machine.stopObserver = stop;
         },
         () => {
@@ -127,25 +129,30 @@ export function createApplicationMachineAuthorityManager(
       stopObserver: null,
       observingOwner: null,
       stopStatus: null,
+      retired: false,
     } as Machine;
     const handle: ApplicationMachineAuthorityHandle = Object.freeze({
       id,
-      label,
+      get label() {
+        return machine.label;
+      },
       kind: machine.kind,
       ready,
-      read: () => (disposed ? null : machine.owner.read()),
+      read: () => (disposed || machine.retired ? null : machine.owner.read()),
       isAlive: (info: CanonicalDaemonInfo) =>
-        disposed ? Promise.resolve(false) : machine.owner.isAlive(info),
+        disposed || machine.retired ? Promise.resolve(false) : machine.owner.isAlive(info),
       endpoint: () =>
         Object.freeze({
           ...machine.owner.endpoint(),
           kind: machine.kind,
-          label: profile ? label : null,
+          label: machine.profile ? machine.label : null,
           epoch: machine.epoch,
-          ...(disposed ? { state: "disconnected" as const, remote: null, localBaseUrl: null } : {}),
+          ...(disposed || machine.retired
+            ? { state: "disconnected" as const, remote: null, localBaseUrl: null }
+            : {}),
         }),
       observe: async (listener: GenerationListener) => {
-        if (disposed) return () => {};
+        if (disposed || machine.retired) return () => {};
         if (machine.kind === "local") observe(machine, machine.owner);
         listeners.add(listener);
         return () => {
@@ -166,7 +173,7 @@ export function createApplicationMachineAuthorityManager(
     observe(machine, owner);
     publish();
     void initializing.then(
-      () => settle(!disposed),
+      () => settle(!disposed && !machine.retired),
       () => settle(false),
     );
     return machine;
@@ -255,6 +262,46 @@ export function createApplicationMachineAuthorityManager(
       SavedMachineRegistrySchema.parse({ version: 1, machines: profiles });
       for (const profile of profiles) if (profile.enabled) manager.add(profile);
     },
+    reconcile(profiles: readonly SavedMachine[]): void {
+      if (disposed) return;
+      const next = SavedMachineRegistrySchema.parse({ version: 1, machines: profiles });
+      const previousSelection = selectedId;
+      for (const machine of [...machines.values()]) {
+        if (!machine.profile) continue;
+        const profile = next.machines.find(
+          (candidate) => candidate.id === machine.id && candidate.enabled,
+        );
+        if (
+          profile &&
+          profile.sshTarget === machine.profile.sshTarget &&
+          profile.expectedEnvironmentId === machine.profile.expectedEnvironmentId
+        ) {
+          // Labels are presentation metadata, not transport identity. Preserve
+          // the connected owner and every consumer holding its stable handle.
+          machine.label = profile.label;
+          machine.profile = profile;
+          continue;
+        }
+        if (selectedId === machine.id) manager.select(LOCAL_MACHINE_ID);
+        machine.retired = true;
+        machine.stopStatus?.();
+        machine.stopObserver?.();
+        for (const listener of machine.listeners) safe(() => listener(null));
+        machine.owner.dispose();
+        machine.listeners.clear();
+        machines.delete(machine.id);
+      }
+      for (const profile of next.machines) if (profile.enabled) manager.add(profile);
+      if (machines.has(previousSelection)) manager.select(previousSelection);
+      publish();
+    },
+    followProfiles(
+      subscribe: (onChange: (profiles: readonly SavedMachine[]) => void) => () => void,
+    ): void {
+      if (disposed) return;
+      stopProfiles?.();
+      stopProfiles = subscribe(manager.reconcile);
+    },
     read: (): CanonicalDaemonInfo | null => machines.get(selectedId)?.handle.read() ?? null,
     isAlive: (info: CanonicalDaemonInfo): Promise<boolean> =>
       machines.get(selectedId)?.handle.isAlive(info) ?? Promise.resolve(false),
@@ -272,6 +319,8 @@ export function createApplicationMachineAuthorityManager(
     dispose(): void {
       if (disposed) return;
       disposed = true;
+      stopProfiles?.();
+      stopProfiles = null;
       lifetime.abort();
       selectedEpoch++;
       selectedGeneration(null);

package/packages/daemon/src/tui/mirror/runtime/application-machine-navigation.ts

@@ -157,7 +157,10 @@ export function createApplicationMachineNavigation(options: {
       return false;
     }
     const selected = candidates[0]!;
-    const sameSelection = activeSessionKey() === selected.id && options.sessionName() === name;
+    const sameSelection =
+      manager.snapshot().selectedMachineId === id &&
+      activeSessionKey() === selected.id &&
+      options.sessionName() === name;
     setActiveSessionKey(selected.id);
     expectedLiveSessionId = selected.liveSessionId;
     server = selected.server;
@@ -269,25 +272,27 @@ export function createApplicationMachineNavigation(options: {
     for (const tab of tabs.snapshot().tabs) tabs.observe(tab.key, tabAgents(tab));
   });
   const sidebar: ApplicationMachineSidebarModel = {
-    groups: () =>
-      snapshot().groups.map((group) => ({
-        ...group,
-        agentsAvailable:
-          group.sessions.some((session) => isDefaultSession(group.id, session)) &&
-          (agentGroups().find((value) => value.machineId === group.id)?.available ?? false),
-        agents: !group.sessions.some((session) => isDefaultSession(group.id, session))
-          ? []
-          : (agentGroups().find((value) => value.machineId === group.id)?.agents ?? []).map(
-              (agent) => ({
-                ...agent,
-                server: group.sessions.find(
-                  (session) =>
-                    session.liveSessionId === agent.liveSessionId &&
-                    isDefaultSession(group.id, session),
-                )?.server,
-              }),
-            ),
-      })),
+    groups: () => {
+      const groupsById = new Map(agentGroups().map((group) => [group.machineId, group]));
+      return snapshot().groups.map((group) => {
+        // Read once per projection: local authority reads validate the record on disk.
+        // The next projection (and action admission) still observes replacement immediately.
+        const instanceId = manager.getMachine(group.id)?.read()?.instanceId;
+        const defaultSessions = group.sessions.filter(
+          (session) => !session.server || session.server.generation === instanceId,
+        );
+        const agents = defaultSessions.length ? groupsById.get(group.id) : undefined;
+        return {
+          ...group,
+          agentsAvailable: agents?.available ?? false,
+          agents: (agents?.agents ?? []).map((agent) => ({
+            ...agent,
+            server: defaultSessions.find((session) => session.liveSessionId === agent.liveSessionId)
+              ?.server,
+          })),
+        };
+      });
+    },
     tabs: () => {
       tabRevision();
       const value = tabs.snapshot();
@@ -479,7 +484,10 @@ export function createApplicationMachineNavigation(options: {
     paletteCommands(): readonly ApplicationPaletteCommand[] {
       const groupsById = new Map(agentGroups().map((group) => [group.machineId, group]));
       return snapshot().groups.flatMap((group) => {
-        const agentGroup = !group.sessions.some((session) => isDefaultSession(group.id, session))
+        const daemon = manager.getMachine(group.id)?.read();
+        const isDefault = (session: { server?: TmuxServerScope }) =>
+          !session.server || session.server.generation === daemon?.instanceId;
+        const agentGroup = !group.sessions.some((session) => isDefault(session))
           ? undefined
           : groupsById.get(group.id);
         const agentsBySession = new Map<string, ApplicationMachineAgent[]>();
@@ -489,7 +497,6 @@ export function createApplicationMachineNavigation(options: {
           list.push(agent);
           agentsBySession.set(agent.liveSessionId, list);
         }
-        const daemon = manager.getMachine(group.id)?.read();
         const sessions = group.sessions.flatMap((session): ApplicationPaletteCommand[] => {
           if (!session.liveSessionId) return [];
           const fleet = {
@@ -502,7 +509,7 @@ export function createApplicationMachineNavigation(options: {
             server: session.server,
             hostLabel: `${group.label}${session.serverLabel ? ` / ${session.serverLabel}` : ""}`,
             agentActivities:
-              isDefaultSession(group.id, session) && agentGroup?.available
+              isDefault(session) && agentGroup?.available
                 ? (agentsBySession.get(session.liveSessionId) ?? []).map((a) => ({
                     paneId: a.paneId!,
                     attention: a.attention,
@@ -514,16 +521,15 @@ export function createApplicationMachineNavigation(options: {
           };
           return [
             { kind: "open-session", sessionName: session.name, label: session.name, fleet },
-            ...(isDefaultSession(group.id, session)
-              ? (agentsBySession.get(session.liveSessionId) ?? [])
-              : []
-            ).map((a) => ({
-              kind: "jump-agent" as const,
-              sessionName: session.name,
-              paneId: a.paneId!,
-              label: a.name,
-              fleet: { ...fleet, disabled: fleet.disabled || a.disabled },
-            })),
+            ...(isDefault(session) ? (agentsBySession.get(session.liveSessionId) ?? []) : []).map(
+              (a) => ({
+                kind: "jump-agent" as const,
+                sessionName: session.name,
+                paneId: a.paneId!,
+                label: a.name,
+                fleet: { ...fleet, disabled: fleet.disabled || a.disabled },
+              }),
+            ),
           ];
         });
         return [

package/packages/daemon/src/tui/mirror/runtime/application-machine-sidebar.tsx

@@ -25,7 +25,7 @@ import {
   type Accessor,
   type JSX,
 } from "solid-js";
-import { friendlySessionLabel } from "../terminal-text.ts";
+import { friendlySessionLabel, wrapText } from "../terminal-text.ts";
 import type { SemanticThemeSnapshot } from "../theme.ts";
 import { KeyHint } from "../ui/key-hint.tsx";
 import { NavigationRow } from "../ui/navigation-row.tsx";
@@ -124,6 +124,9 @@ export function ApplicationMachineSidebar(props: {
   readonly agentRows?: number;
   readonly onHelp?: (source: "keyboard" | "mouse") => void;
 }) {
+  // All visible sections share one projection for the current reactive inputs.
+  // Event handlers retain the model's fresh authority checks at action time.
+  const groups = createMemo(() => props.model.groups());
   const [localFocused, setLocalFocused] = createSignal(false);
   const focused = () => props.model.focused?.() ?? localFocused();
   const [localCollapsed, setCollapsed] = createSignal<ReadonlySet<string>>(new Set());
@@ -133,22 +136,22 @@ export function ApplicationMachineSidebar(props: {
   let scroll: ScrollBoxRenderable | undefined;
   const agentHeight = () =>
     (props.agentRows ?? 0) > 0
-      ? Math.min((props.agentRows ?? 0) + 2, Math.max(0, Math.floor(props.height / 2)))
+      ? Math.min(
+          (props.agentRows ?? 0) + 2,
+          Math.max(0, Math.floor(props.height / 2)),
+          Math.max(0, props.height - fixedHeight() - controlsHeight() - 2),
+        )
       : 0;
-  const controlsHeight = () => (props.height >= 8 && controlGroup() ? 4 : 0);
+  const controlsHeight = () => (props.height >= 8 && controlGroup() ? controlTextHeight() + 2 : 0);
   const searchHeight = () =>
     (props.model.onOpenSwitcher ? 1 : 0) + (props.model.onOpenAttention ? 1 : 0);
+  const fixedHeight = () => 1 + (props.model.onAddMachine ? 1 : 0) + searchHeight();
+  // Keep both action rows and at least two machine rows available on short terminals.
+  const controlTextHeight = () =>
+    Math.min(controlTextLines().length, Math.max(1, props.height - fixedHeight() - 4));
 
   const machineHeight = () =>
-    Math.max(
-      0,
-      props.height -
-        1 -
-        (props.model.onAddMachine ? 1 : 0) -
-        agentHeight() -
-        controlsHeight() -
-        searchHeight(),
-    );
+    Math.max(0, props.height - fixedHeight() - agentHeight() - controlsHeight());
   const active = (row: Row) =>
     row.group.id === props.model.activeMachineId() &&
     (row.agent
@@ -170,7 +173,7 @@ export function ApplicationMachineSidebar(props: {
         : row.session?.name === props.model.activeSessionName());
   const preferenceKey = (group: ApplicationMachineGroup) => group.environmentId ?? group.id;
   const rows = createMemo<readonly Row[]>(() => [
-    ...props.model.groups().flatMap((group) =>
+    ...groups().flatMap((group) =>
       groupApplicationTeamRows(group.agents ?? []).map((agent) => ({
         key: JSON.stringify([
           group.id,
@@ -183,7 +186,7 @@ export function ApplicationMachineSidebar(props: {
         agent,
       })),
     ),
-    ...props.model.groups().flatMap((group) => [
+    ...groups().flatMap((group) => [
       { key: JSON.stringify([group.id]), group },
       ...group.sessions
         .filter(
@@ -255,6 +258,15 @@ export function ApplicationMachineSidebar(props: {
         : "disconnected"
       : diagnostic.phase;
   };
+  const controlTextLines = createMemo(() => {
+    const group = controlGroup();
+    return group
+      ? wrapText(
+          group.diagnostic ? fleetConnectionMessage(group.diagnostic) : connectionDetail(group),
+          Math.max(1, props.width),
+        )
+      : [];
+  });
   const toggle = (
     group: ApplicationMachineGroup,
     value = !collapsed().has(preferenceKey(group)),
@@ -303,7 +315,7 @@ export function ApplicationMachineSidebar(props: {
   const rowHeight = (row: Row) =>
     (row.agent ? 2 : row.serverHeading ? 2 : 1) +
     sectionGap(row) +
-    (hasAgents() && row.key === JSON.stringify([props.model.groups()[0]?.id]) ? 1 : 0);
+    (hasAgents() && row.key === JSON.stringify([groups()[0]?.id]) ? 1 : 0);
   const revealFocusedRow = () => {
     if (!focused() || !scroll) return;
     const y = rows()
@@ -528,9 +540,7 @@ export function ApplicationMachineSidebar(props: {
                     }}
                   />
                 </Show>
-                <Show
-                  when={hasAgents() && row.key === JSON.stringify([props.model.groups()[0]?.id])}
-                >
+                <Show when={hasAgents() && row.key === JSON.stringify([groups()[0]?.id])}>
                   <text height={1} fg={props.theme.roles.text.secondary}>
                     {" "}
                     Machines
@@ -646,7 +656,7 @@ export function ApplicationMachineSidebar(props: {
         <KeyHint
           theme={props.theme}
           keys={CHROME_ACTIONS.attention.keys}
-          label={`${CHROME_ACTIONS.attention.label} (${props.model.groups().reduce((sum, group) => sum + (group.state === "ready" ? (group.agents ?? []).filter((agent) => agent.attention && !agent.disabled).length : 0), 0)})`}
+          label={`${CHROME_ACTIONS.attention.label} (${groups().reduce((sum, group) => sum + (group.state === "ready" ? (group.agents ?? []).filter((agent) => agent.attention && !agent.disabled).length : 0), 0)})`}
           width={props.width}
           quiet
           button
@@ -656,10 +666,8 @@ export function ApplicationMachineSidebar(props: {
       <Show when={controlsHeight() > 0 && controlGroup()}>
         {(group) => (
           <>
-            <text height={2} fg={props.theme.roles.text.secondary}>
-              {group().diagnostic
-                ? fleetConnectionMessage(group().diagnostic!)
-                : connectionDetail(group())}
+            <text height={controlTextHeight()} flexShrink={0} fg={props.theme.roles.text.secondary}>
+              {controlTextLines().join("\n")}
             </text>
             <KeyHint
               theme={props.theme}

package/packages/daemon/src/tui/mirror/runtime/application-machine-startup.ts

@@ -1,8 +1,9 @@
 import { resolveRuntimeNamespace } from "../../../lib/runtime-namespace.ts";
 import { randomUUID } from "node:crypto";
 import { SavedMachineSchema, type SavedMachine } from "@tmux-ide/contracts";
-import { loadSavedMachines } from "../../../lib/saved-machines.ts";
+import { loadSavedMachines, watchSavedMachines } from "../../../lib/saved-machines.ts";
 import { applicationMachineAuthorityManager } from "./application-machine-authority.ts";
+import { tuiPerfMark } from "./application-performance-log.ts";
 
 /** Labels describe access routes; they never become routing identities. */
 export function ephemeralMachineProfile(
@@ -25,16 +26,51 @@ export function ephemeralMachineProfile(
 
 /** Local discovery and rendering never wait for any remote handshake. */
 export function initializeApplicationMachines(aliases: readonly string[]): void {
-  const profiles = resolveRuntimeNamespace().development ? [] : [...loadSavedMachines().machines];
+  const development = resolveRuntimeNamespace().development;
+  const profiles = development ? [] : [...loadSavedMachines().machines];
+  const ephemeral: SavedMachine[] = [];
   let preferred: string | null = null;
   for (const alias of aliases) {
     let profile = profiles.find((p) => p.sshTarget === alias && p.enabled);
     if (!profile) {
       profile = ephemeralMachineProfile(alias, profiles);
       profiles.push(profile);
+      ephemeral.push(profile);
     }
     preferred ??= profile.id;
   }
   applicationMachineAuthorityManager.initialize(profiles);
   if (preferred) applicationMachineAuthorityManager.select(preferred);
+  if (!development) {
+    const failed = () =>
+      tuiPerfMark("machine-registry-error", { reason: "registry-unavailable-or-invalid" });
+    try {
+      applicationMachineAuthorityManager.followProfiles((onChange) =>
+        watchSavedMachines((registry) => {
+          const next = [...registry.machines];
+          for (let index = 0; index < ephemeral.length; index++) {
+            let profile = ephemeral[index]!;
+            // A newly saved route may claim an ephemeral display label. Keep the
+            // explicit connection's identity while making the label unambiguous.
+            if (
+              next.some(
+                (entry) =>
+                  entry.label.normalize("NFKC").toLowerCase() ===
+                  profile.label.normalize("NFKC").toLowerCase(),
+              )
+            )
+              profile = {
+                ...profile,
+                label: ephemeralMachineProfile(profile.sshTarget, next).label,
+              };
+            ephemeral[index] = profile;
+            next.push(profile);
+          }
+          onChange(next);
+        }, failed),
+      );
+    } catch {
+      failed();
+    }
+  }
 }

package/packages/daemon/src/tui/mirror/runtime/application-palette-search-owner.ts

@@ -1,4 +1,4 @@
-import { createMemo, createSignal } from "solid-js";
+import { createMemo, createSignal, untrack } from "solid-js";
 import {
   applicationCommandDescription,
   filterApplicationCommands,
@@ -28,7 +28,7 @@ export function createApplicationPaletteSearchOwner(options: {
   const [help, setHelp] = createSignal(false);
   const [query, setQuery] = createSignal("");
   const [selectedId, setSelectedId] = createSignal<string | null>(null);
-  const commands = createMemo(() =>
+  const readCommands = () =>
     filterApplicationCommands(
       options
         .commands()
@@ -36,8 +36,11 @@ export function createApplicationPaletteSearchOwner(options: {
           (c) => !localOnly() || typeof c === "string" || !c.fleet || c.fleet.machineId === "local",
         ),
       query(),
-    ),
-  );
+    );
+  // Closed overlays must not subscribe to catalog churn. Explicit reads still
+  // resolve current commands, including reset() before the open action commits.
+  const activeCommands = createMemo(() => (options.open() ? readCommands() : null));
+  const commands = () => activeCommands() ?? untrack(readCommands);
   const selection = () =>
     Math.max(
       0,

package/packages/daemon/src/tui/mirror/runtime/application-performance-log.ts

@@ -34,6 +34,8 @@ export const tuiLifecycleStream = stream ? Object.freeze({ enabled: true as cons
 export const tuiPerfStream = TUI_PERF_LOG ? tuiLifecycleStream : null;
 
 const LIFECYCLE_PHASES = new Set([
+  "machine-connection-status",
+  "machine-registry-error",
   "generation-status",
   "generation-connection-start",
   "generation-connection-resolved",
@@ -170,6 +172,7 @@ export function closeTuiPerfMarks(): Promise<void> {
   closing = true;
   closePromise = (async () => {
     if (!stream) return;
+    await writer?.flush();
     await flushTuiPerfMarks();
     // No drain callback may enqueue another critical record after end().
     stream.off("drain", drain);

package/packages/daemon/src/tui/mirror/runtime/application-root-v2.tsx

@@ -427,7 +427,7 @@ export async function startApplicationRoot(options: StartApplicationRootOptions
           const currentShell = shell();
           semanticViewportResize.adopt(dimensions(), currentShell.semantic, generation());
           focusedPane();
-          terminalInputIngress.adopt();
+          terminalInputIngress.adopt(activeSurface() === "terminals");
         });
         const sidebarShortcut = createApplicationSidebarShortcuts(
           activeSurface,

package/packages/daemon/src/tui/mirror/runtime/application-shell-view.tsx

@@ -497,52 +497,53 @@ export function ApplicationShellView(props: ApplicationShellViewProps): JSX.Elem
                     />
                   }
                 >
-                  {(model) => (
-                    <ApplicationMachineSidebar
-                      model={model()}
-                      paneName={(endpoint) =>
-                        nameForCurrentEndpoint(
-                          model()
-                            .groups()
-                            .flatMap((group) => group.agents ?? []),
-                          endpoint,
-                        )
-                      }
-                      interactionForAgent={(agent) =>
-                        interactionForCurrentPane(
-                          props.paneInteractions?.(),
-                          agent.interactionEndpoint,
-                          agent.nativeIdentity,
-                        )
-                      }
-                      onHelp={(source) => {
-                        props.onSetPaletteOpen(true, source);
-                        props.onPaletteReferenceChange?.("help");
-                      }}
-                      agentRows={
-                        model()
-                          .groups()
-                          .some((group) => group.agents !== undefined)
-                          ? 0
-                          : shell.semantic.sidebar.agents.length
-                      }
-                      agents={
-                        <ApplicationSidebarAgents
-                          shell={shell}
-                          theme={appearance.theme}
-                          width={Math.max(1, shell.layout.sidebar.width - 1)}
-                          onIntent={(intent) => {
-                            if (intent.type !== "agent.open") return;
-                            model().onBlur?.();
-                            props.onOpenAgent?.(intent.sessionName, intent.paneId, intent.source);
-                          }}
-                        />
-                      }
-                      width={shell.layout.sidebar.width}
-                      height={shell.layout.sidebar.height}
-                      theme={appearance.theme}
-                    />
-                  )}
+                  {(model) => {
+                    // Sizing, rows and pane labels share this render projection.
+                    // Keep the navigation model and its action-time reads intact.
+                    const groups = createMemo(() => model().groups());
+                    return (
+                      <ApplicationMachineSidebar
+                        model={{ ...model(), groups }}
+                        paneName={(endpoint) =>
+                          nameForCurrentEndpoint(
+                            groups().flatMap((group) => group.agents ?? []),
+                            endpoint,
+                          )
+                        }
+                        interactionForAgent={(agent) =>
+                          interactionForCurrentPane(
+                            props.paneInteractions?.(),
+                            agent.interactionEndpoint,
+                            agent.nativeIdentity,
+                          )
+                        }
+                        onHelp={(source) => {
+                          props.onSetPaletteOpen(true, source);
+                          props.onPaletteReferenceChange?.("help");
+                        }}
+                        agentRows={
+                          groups().some((group) => group.agents !== undefined)
+                            ? 0
+                            : shell.semantic.sidebar.agents.length
+                        }
+                        agents={
+                          <ApplicationSidebarAgents
+                            shell={shell}
+                            theme={appearance.theme}
+                            width={Math.max(1, shell.layout.sidebar.width - 1)}
+                            onIntent={(intent) => {
+                              if (intent.type !== "agent.open") return;
+                              model().onBlur?.();
+                              props.onOpenAgent?.(intent.sessionName, intent.paneId, intent.source);
+                            }}
+                          />
+                        }
+                        width={shell.layout.sidebar.width}
+                        height={shell.layout.sidebar.height}
+                        theme={appearance.theme}
+                      />
+                    );
+                  }}
                 </Show>
               }
             >