@parhelia/core 0.1.12762 → 0.1.12766

package/dist/editor/ai/agentDialogRegistry.js

@@ -0,0 +1,221 @@
+// Per-instance dialog registries.
+//
+// Background: AgentDialogHandler dispatches "agent:dialog:show" as a broadcast
+// CustomEvent. Every mounted AgentTerminal receives it and decides whether to
+// accept based on agent-id match + focus. Pre-multi-pane there was at most
+// one mount per agent, so the registries below were keyed only by agent id.
+//
+// With multi-pane, the same agent can be shown in two panes. We must:
+//   1. Keep the agent "mounted" in the global registry as long as ANY pane
+//      mounts it. Removing one mount must not flip "mounted" to false.
+//   2. When a dialog fires, exactly ONE pane accepts. Election order:
+//      focused pane first; otherwise the first visible (insertion-order) mount.
+//
+// Globals retain the same names for back-compat with consumer reads, but
+// values are now Maps keyed by terminalInstanceId. Old consumers that read
+// the legacy shapes (string[] / Record<id, entry>) get adapter views via
+// the get* helpers below.
+import { normalizeDialogAgentId } from "./agentMessageHelpers";
+function globals() {
+    return globalThis;
+}
+function getMountedMap() {
+    const g = globals();
+    if (!g.__agentDialogMountedAgentsMap) {
+        g.__agentDialogMountedAgentsMap = new Map();
+    }
+    return g.__agentDialogMountedAgentsMap;
+}
+function getVisibleMap() {
+    const g = globals();
+    if (!g.__agentDialogVisibleCallbacksMap) {
+        g.__agentDialogVisibleCallbacksMap = new Map();
+    }
+    return g.__agentDialogVisibleCallbacksMap;
+}
+// Keep the legacy `__agentDialogMountedAgents: string[]` view in sync for any
+// reader still using the old shape. The list contains every agent id with at
+// least one mounted instance.
+function syncMountedLegacy() {
+    const list = [];
+    for (const [agentId, set] of getMountedMap()) {
+        if (set.size > 0)
+            list.push(agentId);
+    }
+    globals().__agentDialogMountedAgents = list;
+}
+// Keep the legacy `__agentDialogVisibleCallbacks: Record<id, entry>` in sync.
+// For each agent we expose the elected entry (focused first, else earliest
+// visible).
+function syncVisibleLegacy() {
+    const flat = {};
+    for (const [agentId, entries] of getVisibleMap()) {
+        const elected = electInstance(agentId, entries);
+        if (elected) {
+            flat[agentId] = {
+                callbackId: elected.entry.callbackId,
+                terminalInstanceId: elected.instanceId,
+            };
+        }
+    }
+    globals().__agentDialogVisibleCallbacks = flat;
+}
+function electInstance(_agentId, entries) {
+    let chosen = null;
+    for (const [instanceId, entry] of entries) {
+        if (!chosen) {
+            chosen = { instanceId, entry };
+            continue;
+        }
+        // Focused beats unfocused.
+        if (entry.isFocused && !chosen.entry.isFocused) {
+            chosen = { instanceId, entry };
+            continue;
+        }
+        if (!entry.isFocused && chosen.entry.isFocused) {
+            continue;
+        }
+        // Same focus state: earlier registration wins.
+        if (entry.registeredAt < chosen.entry.registeredAt) {
+            chosen = { instanceId, entry };
+        }
+    }
+    return chosen;
+}
+export function registerMountedInstance(agentId, instanceId) {
+    const normalized = normalizeDialogAgentId(agentId);
+    if (!normalized)
+        return;
+    const map = getMountedMap();
+    let set = map.get(normalized);
+    if (!set) {
+        set = new Set();
+        map.set(normalized, set);
+    }
+    set.add(instanceId);
+    syncMountedLegacy();
+}
+export function unregisterMountedInstance(agentId, instanceId) {
+    const normalized = normalizeDialogAgentId(agentId);
+    if (!normalized)
+        return;
+    const map = getMountedMap();
+    const set = map.get(normalized);
+    if (!set)
+        return;
+    set.delete(instanceId);
+    if (set.size === 0) {
+        map.delete(normalized);
+    }
+    syncMountedLegacy();
+}
+/** Returns true if at least one terminal is mounted for the given agent id. */
+export function isAgentDialogMounted(agentId) {
+    const set = getMountedMap().get(normalizeDialogAgentId(agentId));
+    return !!set && set.size > 0;
+}
+export function getMountedAgentIds() {
+    const out = [];
+    for (const [agentId, set] of getMountedMap()) {
+        if (set.size > 0)
+            out.push(agentId);
+    }
+    return out;
+}
+export function setVisibleDialogEntry(agentId, instanceId, callbackId, isFocused) {
+    const normalized = normalizeDialogAgentId(agentId);
+    if (!normalized)
+        return;
+    const map = getVisibleMap();
+    let entries = map.get(normalized);
+    if (!entries) {
+        entries = new Map();
+        map.set(normalized, entries);
+    }
+    if (callbackId) {
+        const existing = entries.get(instanceId);
+        entries.set(instanceId, {
+            callbackId,
+            isFocused,
+            registeredAt: existing?.registeredAt ?? Date.now(),
+        });
+    }
+    else {
+        entries.delete(instanceId);
+        if (entries.size === 0)
+            map.delete(normalized);
+    }
+    syncVisibleLegacy();
+}
+export function clearVisibleDialogEntriesForInstance(agentIds, instanceId) {
+    const map = getVisibleMap();
+    for (const id of agentIds) {
+        const normalized = normalizeDialogAgentId(id);
+        if (!normalized)
+            continue;
+        const entries = map.get(normalized);
+        if (!entries)
+            continue;
+        entries.delete(instanceId);
+        if (entries.size === 0)
+            map.delete(normalized);
+    }
+    syncVisibleLegacy();
+}
+export function updateInstanceFocus(agentIds, instanceId, isFocused) {
+    const map = getVisibleMap();
+    let changed = false;
+    for (const id of agentIds) {
+        const normalized = normalizeDialogAgentId(id);
+        if (!normalized)
+            continue;
+        const entries = map.get(normalized);
+        if (!entries)
+            continue;
+        const entry = entries.get(instanceId);
+        if (!entry)
+            continue;
+        if (entry.isFocused !== isFocused) {
+            entries.set(instanceId, { ...entry, isFocused });
+            changed = true;
+        }
+    }
+    if (changed)
+        syncVisibleLegacy();
+}
+/**
+ * Determines whether the given instance should accept an incoming
+ * `agent:dialog:show` event for the given agent id. Election rule:
+ *   - Among all mounted instances for the agent, the focused one wins.
+ *   - If none is focused, the earliest-registered one wins (first visible).
+ *
+ * Note: this consults the *mounted* registry (via the visibility entries
+ * we've registered alongside it). A terminal mount that has not yet called
+ * `setVisibleDialogEntry` won't participate in election; that's fine because
+ * those mounts also wouldn't have a callback attached.
+ */
+export function isElectedDialogReceiver(agentId, instanceId) {
+    const normalized = normalizeDialogAgentId(agentId);
+    if (!normalized)
+        return true;
+    // Prefer election over visibility entries (which only exist while a dialog
+    // is active). For incoming requests we elect over the *mounted* set.
+    const mountedSet = getMountedMap().get(normalized);
+    if (!mountedSet || mountedSet.size === 0)
+        return false;
+    if (mountedSet.size === 1)
+        return mountedSet.has(instanceId);
+    // Fall back to the visible map for focus / insertion order; if a dialog is
+    // already shown elsewhere, that one keeps owning subsequent events.
+    const entries = getVisibleMap().get(normalized);
+    if (entries && entries.size > 0) {
+        const chosen = electInstance(normalized, entries);
+        if (chosen)
+            return chosen.instanceId === instanceId;
+    }
+    // No active dialog: pick the first-mounted instance via insertion order.
+    // Set iteration preserves insertion order in JS, so the first iterated id wins.
+    const firstId = mountedSet.values().next().value;
+    return firstId === instanceId;
+}
+//# sourceMappingURL=agentDialogRegistry.js.map

package/dist/editor/ai/agentDialogRegistry.js.map

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

package/dist/editor/ai/agentPanesTypes.d.ts

@@ -0,0 +1,27 @@
+export type PaneId = string;
+export type PaneViewState = {
+    kind: "agent";
+    agentId: string;
+} | {
+    kind: "profile-selector";
+} | {
+    kind: "overview";
+};
+export interface AgentPane {
+    id: PaneId;
+    view: PaneViewState;
+}
+export interface AgentPanesLayout {
+    orientation: "horizontal" | "vertical" | "grid";
+    /**
+     * Outer dimension is rows. For "horizontal" / "vertical", `rows.length === 1`.
+     * For "grid", multiple rows are stacked vertically and each row is a
+     * horizontal split.
+     */
+    rows: AgentPane[][];
+    focusedPaneId: PaneId;
+}
+/** localStorageService key (will be prefixed with "parhelia."). */
+export declare const AGENT_PANES_LAYOUT_STORAGE_KEY = "editor.agentPanesLayout";
+/** Legacy single-active-id key. Read once for migration, then removed. */
+export declare const LEGACY_ACTIVE_AGENT_STORAGE_KEY = "editor.activeAgentId";

package/dist/editor/ai/agentPanesTypes.js

@@ -0,0 +1,16 @@
+// Multi-pane layout for agent terminals.
+//
+// V1 ships orientation = "horizontal" | "vertical" (single row) via "Open in
+// split right" / "Open in split down" context-menu actions on tabs. The
+// "grid" orientation uses N rows of horizontal panes; the renderer nests
+// two Splitters (outer vertical, inner horizontal per row).
+//
+// No `weight` field on AgentPane — Splitter (`editor/ui/Splitter.tsx`) owns
+// panel-size persistence via its own localStorageKey. The layout model owns
+// only which panes exist and which is focused; sizes round-trip through
+// Splitter independently.
+/** localStorageService key (will be prefixed with "parhelia."). */
+export const AGENT_PANES_LAYOUT_STORAGE_KEY = "editor.agentPanesLayout";
+/** Legacy single-active-id key. Read once for migration, then removed. */
+export const LEGACY_ACTIVE_AGENT_STORAGE_KEY = "editor.activeAgentId";
+//# sourceMappingURL=agentPanesTypes.js.map

package/dist/editor/ai/agentPanesTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentPanesTypes.js","sourceRoot":"","sources":["../../../src/editor/ai/agentPanesTypes.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,EAAE;AACF,6EAA6E;AAC7E,wEAAwE;AACxE,yEAAyE;AACzE,4DAA4D;AAC5D,EAAE;AACF,4EAA4E;AAC5E,4EAA4E;AAC5E,wEAAwE;AACxE,0BAA0B;AA2B1B,mEAAmE;AACnE,MAAM,CAAC,MAAM,8BAA8B,GAAG,yBAAyB,CAAC;AAExE,0EAA0E;AAC1E,MAAM,CAAC,MAAM,+BAA+B,GAAG,sBAAsB,CAAC"}

package/dist/editor/ai/useAgentPanes.d.ts

@@ -0,0 +1,33 @@
+import type { Agent } from "../services/agentService";
+import { type AgentPanesLayout, type PaneId } from "./agentPanesTypes";
+export interface UseAgentPanesOptions {
+    /** localStorageService key (will be prefixed). Defaults to the tabbed
+     *  Agents UI key. Pass a different key to keep view-scoped layouts
+     *  separate (e.g. `${AGENT_PANES_LAYOUT_STORAGE_KEY}.workspace`). */
+    storageKey?: string;
+    /** When true, on first load (no stored layout) reads the legacy
+     *  `editor.activeAgentId` key and synthesizes a single-pane layout from it.
+     *  Default false: secondary views start with a single overview pane. */
+    migrateLegacy?: boolean;
+}
+export interface UseAgentPanesResult {
+    layout: AgentPanesLayout;
+    focusedPaneId: PaneId;
+    /** Map of agentId -> ordered list of pane ids that show that agent. */
+    panesByAgentId: Map<string, PaneId[]>;
+    /** Set of agent ids visible in any pane. */
+    visibleAgentIds: Set<string>;
+    /** The agent currently shown in the focused pane (if any). */
+    focusedAgentId: string | null;
+    setFocusedPane: (paneId: PaneId) => void;
+    showAgentInFocusedPane: (agentId: string) => void;
+    showProfileSelectorInFocusedPane: () => void;
+    showOverviewInFocusedPane: () => void;
+    splitPane: (sourcePaneId: PaneId, 
+    /** Agent to put in the new pane. Pass `null` for an empty (overview) pane. */
+    agentId: string | null, direction: "right" | "down") => void;
+    closePane: (paneId: PaneId) => void;
+    closeAgentEverywhere: (agentId: string) => void;
+    pruneMissingAgents: (existingAgentIds: Iterable<string>) => void;
+}
+export declare function useAgentPanes(_agents: Agent[], options?: UseAgentPanesOptions): UseAgentPanesResult;

package/dist/editor/ai/useAgentPanes.js

@@ -0,0 +1,357 @@
+// Hook owning the multi-pane agent layout. Replaces the single
+// `activeAgentId` state and `setActiveAgentIdWithStorage` plumbing in
+// Agents.tsx with a layout of N panes plus a focused pane id.
+//
+// Persistence: layout JSON in localStorageService under
+// `editor.agentPanesLayout`. On first run, migrates from legacy
+// `editor.activeAgentId` (a single agent id) into a single-pane layout.
+//
+// Splitter sizes are NOT persisted here — Splitter.tsx owns its own
+// localStorage. This hook only owns which panes exist and which is focused.
+import { useCallback, useEffect, useMemo, useRef, useState } from "react";
+import { localStorageService } from "../services/localStorageService";
+import { AGENT_PANES_LAYOUT_STORAGE_KEY, LEGACY_ACTIVE_AGENT_STORAGE_KEY, } from "./agentPanesTypes";
+let paneCounter = 0;
+function newPaneId() {
+    paneCounter += 1;
+    return `pane-${Date.now().toString(36)}-${paneCounter}`;
+}
+function makeOverviewLayout() {
+    const id = newPaneId();
+    return {
+        orientation: "horizontal",
+        rows: [[{ id, view: { kind: "overview" } }]],
+        focusedPaneId: id,
+    };
+}
+function makeAgentLayout(agentId) {
+    const id = newPaneId();
+    return {
+        orientation: "horizontal",
+        rows: [[{ id, view: { kind: "agent", agentId } }]],
+        focusedPaneId: id,
+    };
+}
+function makeProfileSelectorLayout() {
+    const id = newPaneId();
+    return {
+        orientation: "horizontal",
+        rows: [[{ id, view: { kind: "profile-selector" } }]],
+        focusedPaneId: id,
+    };
+}
+/**
+ * Validate a layout that was just loaded from localStorage. Returns null if
+ * it's structurally invalid, or a sanitized copy if it's mostly fine.
+ */
+function sanitizeStoredLayout(raw) {
+    if (!raw || typeof raw !== "object")
+        return null;
+    const candidate = raw;
+    if (candidate.orientation !== "horizontal" &&
+        candidate.orientation !== "vertical" &&
+        candidate.orientation !== "grid") {
+        return null;
+    }
+    if (!Array.isArray(candidate.rows) || candidate.rows.length === 0) {
+        return null;
+    }
+    const cleanedRows = [];
+    for (const row of candidate.rows) {
+        if (!Array.isArray(row) || row.length === 0)
+            continue;
+        const cleanedRow = [];
+        for (const pane of row) {
+            if (!pane || typeof pane !== "object")
+                continue;
+            const p = pane;
+            if (typeof p.id !== "string" || !p.id)
+                continue;
+            const view = p.view;
+            if (!view || typeof view !== "object")
+                continue;
+            if (view.kind !== "agent" &&
+                view.kind !== "profile-selector" &&
+                view.kind !== "overview") {
+                continue;
+            }
+            if (view.kind === "agent" && typeof view.agentId !== "string")
+                continue;
+            cleanedRow.push({ id: p.id, view });
+        }
+        if (cleanedRow.length > 0)
+            cleanedRows.push(cleanedRow);
+    }
+    if (cleanedRows.length === 0)
+        return null;
+    const allIds = new Set();
+    for (const row of cleanedRows)
+        for (const pane of row)
+            allIds.add(pane.id);
+    const firstPane = cleanedRows[0]?.[0];
+    if (!firstPane)
+        return null;
+    const focusedPaneId = typeof candidate.focusedPaneId === "string" &&
+        allIds.has(candidate.focusedPaneId)
+        ? candidate.focusedPaneId
+        : firstPane.id;
+    return {
+        orientation: candidate.orientation,
+        rows: cleanedRows,
+        focusedPaneId,
+    };
+}
+function loadInitialLayout(options) {
+    const stored = localStorageService.getItem(options.storageKey);
+    const sanitized = sanitizeStoredLayout(stored);
+    if (sanitized)
+        return sanitized;
+    if (options.migrateLegacy) {
+        // Migrate from the legacy single-active-id key. Possible values:
+        //   - missing: show overview
+        //   - "" (sentinel): profile selector
+        //   - <agent id>: single-pane agent
+        const legacy = localStorageService.getString(LEGACY_ACTIVE_AGENT_STORAGE_KEY);
+        if (legacy === null || legacy === undefined) {
+            return makeOverviewLayout();
+        }
+        if (legacy === "") {
+            return makeProfileSelectorLayout();
+        }
+        return makeAgentLayout(legacy);
+    }
+    return makeOverviewLayout();
+}
+function findPane(layout, paneId) {
+    for (const [r, row] of layout.rows.entries()) {
+        for (const [c, pane] of row.entries()) {
+            if (pane.id === paneId)
+                return { rowIndex: r, colIndex: c, pane };
+        }
+    }
+    return null;
+}
+function flattenPanes(layout) {
+    const out = [];
+    for (const row of layout.rows)
+        for (const pane of row)
+            out.push(pane);
+    return out;
+}
+function paneCount(layout) {
+    return flattenPanes(layout).length;
+}
+/**
+ * After mutating rows, ensure focus still points to a real pane. If not,
+ * fall back to the first pane in row-major order.
+ */
+function fixFocus(rows, previous) {
+    for (const row of rows)
+        for (const pane of row)
+            if (pane.id === previous)
+                return previous;
+    return rows[0]?.[0]?.id ?? previous;
+}
+/**
+ * Collapse to a sensible empty state: a single overview pane.
+ */
+function ensureNonEmpty(rows) {
+    if (rows.length === 0) {
+        return [[{ id: newPaneId(), view: { kind: "overview" } }]];
+    }
+    return rows;
+}
+export function useAgentPanes(_agents, options = {}) {
+    const storageKey = options.storageKey ?? AGENT_PANES_LAYOUT_STORAGE_KEY;
+    const migrateLegacy = options.migrateLegacy ?? false;
+    const [layout, setLayout] = useState(() => loadInitialLayout({ storageKey, migrateLegacy }));
+    const layoutRef = useRef(layout);
+    layoutRef.current = layout;
+    // Persist the layout. Splitter sizes round-trip through Splitter's own
+    // localStorage; this only persists pane structure + focus.
+    useEffect(() => {
+        localStorageService.setItem(storageKey, layout);
+        // Drop the legacy single-active-id key on first save of the new layout
+        // (only applicable for the primary tabbed view).
+        if (migrateLegacy) {
+            localStorageService.removeItem(LEGACY_ACTIVE_AGENT_STORAGE_KEY);
+        }
+    }, [layout, storageKey, migrateLegacy]);
+    const panesByAgentId = useMemo(() => {
+        const map = new Map();
+        for (const row of layout.rows) {
+            for (const pane of row) {
+                if (pane.view.kind === "agent") {
+                    const existing = map.get(pane.view.agentId);
+                    if (existing)
+                        existing.push(pane.id);
+                    else
+                        map.set(pane.view.agentId, [pane.id]);
+                }
+            }
+        }
+        return map;
+    }, [layout]);
+    const visibleAgentIds = useMemo(() => new Set(panesByAgentId.keys()), [panesByAgentId]);
+    const focusedAgentId = useMemo(() => {
+        const found = findPane(layout, layout.focusedPaneId);
+        if (found && found.pane.view.kind === "agent") {
+            return found.pane.view.agentId;
+        }
+        return null;
+    }, [layout]);
+    const setFocusedPane = useCallback((paneId) => {
+        setLayout((prev) => {
+            if (prev.focusedPaneId === paneId)
+                return prev;
+            // Confirm the pane exists before switching.
+            if (!findPane(prev, paneId))
+                return prev;
+            return { ...prev, focusedPaneId: paneId };
+        });
+    }, []);
+    const replaceFocusedPaneView = useCallback((view) => {
+        setLayout((prev) => {
+            const found = findPane(prev, prev.focusedPaneId);
+            if (!found)
+                return prev;
+            const newRows = prev.rows.map((row) => row.map((pane) => pane.id === prev.focusedPaneId ? { ...pane, view } : pane));
+            return { ...prev, rows: newRows };
+        });
+    }, []);
+    const showAgentInFocusedPane = useCallback((agentId) => {
+        replaceFocusedPaneView({ kind: "agent", agentId });
+    }, [replaceFocusedPaneView]);
+    const showProfileSelectorInFocusedPane = useCallback(() => {
+        replaceFocusedPaneView({ kind: "profile-selector" });
+    }, [replaceFocusedPaneView]);
+    const showOverviewInFocusedPane = useCallback(() => {
+        replaceFocusedPaneView({ kind: "overview" });
+    }, [replaceFocusedPaneView]);
+    const splitPane = useCallback((sourcePaneId, agentId, direction) => {
+        setLayout((prev) => {
+            const found = findPane(prev, sourcePaneId);
+            if (!found)
+                return prev;
+            const newPane = {
+                id: newPaneId(),
+                view: agentId === null
+                    ? { kind: "overview" }
+                    : { kind: "agent", agentId },
+            };
+            if (direction === "right") {
+                const rows = prev.rows.map((row, r) => r === found.rowIndex
+                    ? [
+                        ...row.slice(0, found.colIndex + 1),
+                        newPane,
+                        ...row.slice(found.colIndex + 1),
+                    ]
+                    : row);
+                // Single-row + horizontal split = "horizontal" orientation. With
+                // multiple rows we must be in grid mode.
+                const orientation = rows.length > 1 ? "grid" : "horizontal";
+                return {
+                    ...prev,
+                    rows,
+                    orientation,
+                    focusedPaneId: newPane.id,
+                };
+            }
+            // direction === "down": insert a new row below the source's row,
+            // containing only the new pane. This becomes a 2-D grid.
+            const rows = [
+                ...prev.rows.slice(0, found.rowIndex + 1),
+                [newPane],
+                ...prev.rows.slice(found.rowIndex + 1),
+            ];
+            const orientation = rows.length > 1
+                ? rows.some((r) => r.length > 1)
+                    ? "grid"
+                    : "vertical"
+                : "horizontal";
+            return {
+                ...prev,
+                rows,
+                orientation,
+                focusedPaneId: newPane.id,
+            };
+        });
+    }, []);
+    const closePane = useCallback((paneId) => {
+        setLayout((prev) => {
+            if (paneCount(prev) <= 1) {
+                // Last pane: never remove it; reset its view to overview instead.
+                const rows = prev.rows.map((row) => row.map((pane) => pane.id === paneId ? { ...pane, view: { kind: "overview" } } : pane));
+                return { ...prev, rows, focusedPaneId: paneId };
+            }
+            const filteredRows = prev.rows
+                .map((row) => row.filter((pane) => pane.id !== paneId))
+                .filter((row) => row.length > 0);
+            const rows = ensureNonEmpty(filteredRows);
+            const orientation = rows.length > 1
+                ? rows.some((r) => r.length > 1)
+                    ? "grid"
+                    : "vertical"
+                : "horizontal";
+            return {
+                ...prev,
+                rows,
+                orientation,
+                focusedPaneId: fixFocus(rows, prev.focusedPaneId),
+            };
+        });
+    }, []);
+    const closeAgentEverywhere = useCallback((agentId) => {
+        setLayout((prev) => {
+            let changed = false;
+            const rows = prev.rows.map((row) => row.map((pane) => {
+                if (pane.view.kind === "agent" && pane.view.agentId === agentId) {
+                    changed = true;
+                    return {
+                        ...pane,
+                        view: { kind: "profile-selector" },
+                    };
+                }
+                return pane;
+            }));
+            return changed ? { ...prev, rows } : prev;
+        });
+    }, []);
+    const pruneMissingAgents = useCallback((existingAgentIds) => {
+        const existingSet = new Set(existingAgentIds);
+        setLayout((prev) => {
+            let changed = false;
+            const rows = prev.rows.map((row) => row.map((pane) => {
+                if (pane.view.kind === "agent" &&
+                    !existingSet.has(pane.view.agentId)) {
+                    changed = true;
+                    return { ...pane, view: { kind: "profile-selector" } };
+                }
+                return pane;
+            }));
+            if (!changed)
+                return prev;
+            return { ...prev, rows, focusedPaneId: fixFocus(rows, prev.focusedPaneId) };
+        });
+    }, []);
+    // Test-only escape hatch. Note: paneCounter resets between page loads,
+    // not between tests; tests should rely on stable-shaped IDs rather than
+    // exact matching.
+    void layoutRef;
+    return {
+        layout,
+        focusedPaneId: layout.focusedPaneId,
+        panesByAgentId,
+        visibleAgentIds,
+        focusedAgentId,
+        setFocusedPane,
+        showAgentInFocusedPane,
+        showProfileSelectorInFocusedPane,
+        showOverviewInFocusedPane,
+        splitPane,
+        closePane,
+        closeAgentEverywhere,
+        pruneMissingAgents,
+    };
+}
+//# sourceMappingURL=useAgentPanes.js.map