pilotswarm 0.0.1 → 0.4.1

package/ui/core/src/index.js

@@ -0,0 +1,13 @@
+export * from "./commands.js";
+export * from "./context-usage.js";
+export * from "./formatting.js";
+export * from "./history.js";
+export * from "./layout.js";
+export * from "./session-tree.js";
+export * from "./state.js";
+export * from "./reducer.js";
+export * from "./store.js";
+export * from "./selectors.js";
+export * from "./controller.js";
+export { isThemeLight } from "./themes/helpers.js";
+export * from "./themes/index.js";

package/ui/core/src/layout.js

@@ -0,0 +1,332 @@
+import { FOCUS_REGIONS } from "./commands.js";
+
+export const DEFAULT_LEFT_PANE_RATIO = 0.7;
+export const MIN_LEFT_WIDTH = 30;
+export const MIN_RIGHT_WIDTH = 36;
+export const COLLAPSE_LEFT_THRESHOLD = 18;
+export const COLLAPSE_RIGHT_THRESHOLD = 18;
+export const PANE_GAP_X = 0;
+export const PANE_GAP_Y = 0;
+export const MAX_PROMPT_INPUT_ROWS = 3;
+export const MIN_SESSION_PANE_HEIGHT = 6;
+export const MIN_CHAT_PANE_HEIGHT = 10;
+export const DEFAULT_SESSION_PANE_RATIO = 0.25;
+export const MAX_SESSION_PANE_WINDOW_RATIO = 0.5;
+export const MIN_ACTIVITY_PANE_HEIGHT = 6;
+export const MIN_INSPECTOR_PANE_HEIGHT = 10;
+export const DEFAULT_ACTIVITY_PANE_RATIO = 0.336;
+export const COLLAPSE_ACTIVITY_THRESHOLD = MIN_ACTIVITY_PANE_HEIGHT;
+export const COLLAPSE_INSPECTOR_THRESHOLD = MIN_INSPECTOR_PANE_HEIGHT;
+export const COLLAPSE_SESSION_THRESHOLD = MIN_SESSION_PANE_HEIGHT;
+export const COLLAPSE_CHAT_THRESHOLD = MIN_CHAT_PANE_HEIGHT;
+
+function clamp(value, min, max) {
+    return Math.max(min, Math.min(max, value));
+}
+
+function normalizeFullscreenPane(fullscreenPane) {
+    return [
+        FOCUS_REGIONS.SESSIONS,
+        FOCUS_REGIONS.CHAT,
+        FOCUS_REGIONS.INSPECTOR,
+        FOCUS_REGIONS.ACTIVITY,
+    ].includes(fullscreenPane)
+        ? fullscreenPane
+        : null;
+}
+
+export function normalizeViewport(viewport = {}) {
+    return {
+        width: Math.max(40, Number(viewport.width) || 120),
+        height: Math.max(18, Number(viewport.height) || 40),
+    };
+}
+
+export function getPromptInputRows(prompt = "") {
+    const explicitLines = String(prompt || "").split("\n").length;
+    return clamp(explicitLines, 1, MAX_PROMPT_INPUT_ROWS);
+}
+
+export function getBaseSessionPaneHeight(bodyHeight) {
+    return Math.max(MIN_SESSION_PANE_HEIGHT, Math.floor(bodyHeight * DEFAULT_SESSION_PANE_RATIO));
+}
+
+export function getMaxSessionPaneHeight(totalHeight, bodyHeight) {
+    const maxByWindow = Math.floor(Math.max(0, Number(totalHeight) || 0) * MAX_SESSION_PANE_WINDOW_RATIO);
+    const maxByChatMinimum = Math.max(MIN_SESSION_PANE_HEIGHT, bodyHeight - MIN_CHAT_PANE_HEIGHT);
+    return Math.max(MIN_SESSION_PANE_HEIGHT, Math.min(maxByChatMinimum, maxByWindow));
+}
+
+export function computeLegacyLayout(viewport, paneAdjust = 0, promptRows = 1, sessionPaneAdjust = 0, activityPaneAdjust = 0, fullscreenPane = null) {
+    const safeViewport = normalizeViewport(viewport);
+    const totalWidth = safeViewport.width;
+    const totalHeight = safeViewport.height;
+    const safePromptRows = clamp(Number(promptRows) || 1, 1, MAX_PROMPT_INPUT_ROWS);
+    const safeFullscreenPane = normalizeFullscreenPane(fullscreenPane);
+    const reservedRows = 5 + safePromptRows;
+    const bodyHeight = Math.max(18, totalHeight - reservedRows);
+    const baseLeftWidth = Math.floor(totalWidth * DEFAULT_LEFT_PANE_RATIO);
+    const desiredLeftWidth = baseLeftWidth + (Number(paneAdjust) || 0);
+    const desiredRightWidth = totalWidth - desiredLeftWidth - PANE_GAP_X;
+
+    let leftHidden = false;
+    let rightHidden = false;
+
+    if (desiredLeftWidth <= COLLAPSE_LEFT_THRESHOLD && desiredRightWidth > COLLAPSE_RIGHT_THRESHOLD) {
+        leftHidden = true;
+    } else if (desiredRightWidth <= COLLAPSE_RIGHT_THRESHOLD && desiredLeftWidth > COLLAPSE_LEFT_THRESHOLD) {
+        rightHidden = true;
+    } else if (desiredLeftWidth <= COLLAPSE_LEFT_THRESHOLD && desiredRightWidth <= COLLAPSE_RIGHT_THRESHOLD) {
+        rightHidden = paneAdjust >= 0;
+        leftHidden = !rightHidden;
+    }
+
+    let leftWidth;
+    let rightWidth;
+
+    if (leftHidden) {
+        leftWidth = 0;
+        rightWidth = totalWidth;
+    } else if (rightHidden) {
+        leftWidth = totalWidth;
+        rightWidth = 0;
+    } else {
+        leftWidth = clamp(desiredLeftWidth, MIN_LEFT_WIDTH, totalWidth - MIN_RIGHT_WIDTH - PANE_GAP_X);
+        rightWidth = Math.max(MIN_RIGHT_WIDTH, totalWidth - leftWidth - PANE_GAP_X);
+    }
+
+    const baseSessionPaneHeight = getBaseSessionPaneHeight(bodyHeight);
+    const desiredSessionPaneHeight = baseSessionPaneHeight + (Number(sessionPaneAdjust) || 0);
+    const desiredChatPaneHeight = bodyHeight - desiredSessionPaneHeight;
+
+    let sessionHidden = false;
+    let chatHidden = false;
+
+    if (desiredChatPaneHeight <= COLLAPSE_CHAT_THRESHOLD && desiredSessionPaneHeight > COLLAPSE_SESSION_THRESHOLD) {
+        chatHidden = true;
+    } else if (desiredSessionPaneHeight <= COLLAPSE_SESSION_THRESHOLD && desiredChatPaneHeight > COLLAPSE_CHAT_THRESHOLD) {
+        sessionHidden = true;
+    } else if (desiredChatPaneHeight <= COLLAPSE_CHAT_THRESHOLD && desiredSessionPaneHeight <= COLLAPSE_SESSION_THRESHOLD) {
+        chatHidden = (Number(sessionPaneAdjust) || 0) >= 0;
+        sessionHidden = !chatHidden;
+    }
+
+    let sessionPaneHeight;
+    let chatPaneHeight;
+    if (sessionHidden) {
+        sessionPaneHeight = 0;
+        chatPaneHeight = bodyHeight;
+    } else if (chatHidden) {
+        sessionPaneHeight = bodyHeight;
+        chatPaneHeight = 0;
+    } else {
+        const maxSessionPaneHeight = getMaxSessionPaneHeight(totalHeight, bodyHeight);
+        sessionPaneHeight = clamp(
+            desiredSessionPaneHeight,
+            MIN_SESSION_PANE_HEIGHT,
+            maxSessionPaneHeight,
+        );
+        chatPaneHeight = Math.max(MIN_CHAT_PANE_HEIGHT, bodyHeight - sessionPaneHeight);
+    }
+    const baseActivityPaneHeight = Math.max(MIN_ACTIVITY_PANE_HEIGHT, Math.floor(bodyHeight * DEFAULT_ACTIVITY_PANE_RATIO));
+    const desiredActivityPaneHeight = baseActivityPaneHeight + (Number(activityPaneAdjust) || 0);
+    const desiredInspectorPaneHeight = bodyHeight - desiredActivityPaneHeight;
+
+    let inspectorHidden = false;
+    let activityHidden = false;
+
+    if (desiredInspectorPaneHeight <= COLLAPSE_INSPECTOR_THRESHOLD && desiredActivityPaneHeight > COLLAPSE_ACTIVITY_THRESHOLD) {
+        inspectorHidden = true;
+    } else if (desiredActivityPaneHeight <= COLLAPSE_ACTIVITY_THRESHOLD && desiredInspectorPaneHeight > COLLAPSE_INSPECTOR_THRESHOLD) {
+        activityHidden = true;
+    } else if (desiredInspectorPaneHeight <= COLLAPSE_INSPECTOR_THRESHOLD && desiredActivityPaneHeight <= COLLAPSE_ACTIVITY_THRESHOLD) {
+        inspectorHidden = (Number(activityPaneAdjust) || 0) >= 0;
+        activityHidden = !inspectorHidden;
+    }
+
+    let activityPaneHeight;
+    let inspectorPaneHeight;
+    if (inspectorHidden) {
+        activityPaneHeight = bodyHeight;
+        inspectorPaneHeight = 0;
+    } else if (activityHidden) {
+        inspectorPaneHeight = bodyHeight;
+        activityPaneHeight = 0;
+    } else {
+        activityPaneHeight = clamp(
+            desiredActivityPaneHeight,
+            MIN_ACTIVITY_PANE_HEIGHT,
+            Math.max(MIN_ACTIVITY_PANE_HEIGHT, bodyHeight - MIN_INSPECTOR_PANE_HEIGHT),
+        );
+        inspectorPaneHeight = Math.max(MIN_INSPECTOR_PANE_HEIGHT, bodyHeight - activityPaneHeight);
+    }
+
+    return {
+        viewport: safeViewport,
+        totalWidth,
+        totalHeight,
+        reservedRows,
+        bodyHeight,
+        promptRows: safePromptRows,
+        fullscreenPane: safeFullscreenPane,
+        paneAdjust: Number(paneAdjust) || 0,
+        sessionPaneAdjust: Number(sessionPaneAdjust) || 0,
+        activityPaneAdjust: Number(activityPaneAdjust) || 0,
+        leftHidden,
+        rightHidden,
+        inspectorHidden,
+        activityHidden,
+        sessionHidden,
+        chatHidden,
+        leftWidth,
+        rightWidth,
+        sessionPaneHeight,
+        chatPaneHeight,
+        activityPaneHeight,
+        inspectorPaneHeight,
+    };
+}
+
+export function getFocusOrderForLayout(layout) {
+    if (layout?.fullscreenPane) {
+        return [layout.fullscreenPane, FOCUS_REGIONS.PROMPT];
+    }
+    if (layout?.leftHidden) {
+        return [FOCUS_REGIONS.INSPECTOR, FOCUS_REGIONS.ACTIVITY, FOCUS_REGIONS.PROMPT];
+    }
+    if (layout?.rightHidden) {
+        const left = layout?.sessionHidden
+            ? [FOCUS_REGIONS.CHAT]
+            : layout?.chatHidden
+                ? [FOCUS_REGIONS.SESSIONS]
+                : [FOCUS_REGIONS.SESSIONS, FOCUS_REGIONS.CHAT];
+        return [...left, FOCUS_REGIONS.PROMPT];
+    }
+    if (layout?.sessionHidden) {
+        const right = layout?.inspectorHidden
+            ? [FOCUS_REGIONS.ACTIVITY]
+            : layout?.activityHidden
+                ? [FOCUS_REGIONS.INSPECTOR]
+                : [FOCUS_REGIONS.INSPECTOR, FOCUS_REGIONS.ACTIVITY];
+        return [FOCUS_REGIONS.CHAT, ...right, FOCUS_REGIONS.PROMPT];
+    }
+    if (layout?.chatHidden) {
+        const right = layout?.inspectorHidden
+            ? [FOCUS_REGIONS.ACTIVITY]
+            : layout?.activityHidden
+                ? [FOCUS_REGIONS.INSPECTOR]
+                : [FOCUS_REGIONS.INSPECTOR, FOCUS_REGIONS.ACTIVITY];
+        return [FOCUS_REGIONS.SESSIONS, ...right, FOCUS_REGIONS.PROMPT];
+    }
+    if (layout?.inspectorHidden) {
+        return [
+            FOCUS_REGIONS.SESSIONS,
+            FOCUS_REGIONS.CHAT,
+            FOCUS_REGIONS.ACTIVITY,
+            FOCUS_REGIONS.PROMPT,
+        ];
+    }
+    if (layout?.activityHidden) {
+        return [
+            FOCUS_REGIONS.SESSIONS,
+            FOCUS_REGIONS.CHAT,
+            FOCUS_REGIONS.INSPECTOR,
+            FOCUS_REGIONS.PROMPT,
+        ];
+    }
+    return [
+        FOCUS_REGIONS.SESSIONS,
+        FOCUS_REGIONS.CHAT,
+        FOCUS_REGIONS.INSPECTOR,
+        FOCUS_REGIONS.ACTIVITY,
+        FOCUS_REGIONS.PROMPT,
+    ];
+}
+
+export function normalizeFocusRegion(focusRegion, layout) {
+    const order = getFocusOrderForLayout(layout);
+    if (order.includes(focusRegion)) return focusRegion;
+    return order[0] || FOCUS_REGIONS.PROMPT;
+}
+
+export function getFocusLeftTarget(focusRegion, layout) {
+    if (layout?.fullscreenPane) {
+        return layout.fullscreenPane;
+    }
+    if (layout?.leftHidden) {
+        const map = {
+            [FOCUS_REGIONS.PROMPT]: FOCUS_REGIONS.PROMPT,
+            [FOCUS_REGIONS.ACTIVITY]: FOCUS_REGIONS.INSPECTOR,
+            [FOCUS_REGIONS.INSPECTOR]: FOCUS_REGIONS.INSPECTOR,
+        };
+        return map[focusRegion] || FOCUS_REGIONS.INSPECTOR;
+    }
+
+    if (layout?.rightHidden) {
+        const map = {
+            [FOCUS_REGIONS.PROMPT]: FOCUS_REGIONS.PROMPT,
+            [FOCUS_REGIONS.CHAT]: layout?.sessionHidden ? FOCUS_REGIONS.CHAT : FOCUS_REGIONS.SESSIONS,
+            [FOCUS_REGIONS.SESSIONS]: FOCUS_REGIONS.SESSIONS,
+        };
+        return map[focusRegion] || (layout?.sessionHidden ? FOCUS_REGIONS.CHAT : FOCUS_REGIONS.SESSIONS);
+    }
+
+    const map = {
+        [FOCUS_REGIONS.PROMPT]: layout?.sessionHidden ? FOCUS_REGIONS.CHAT : FOCUS_REGIONS.SESSIONS,
+        [FOCUS_REGIONS.ACTIVITY]: layout?.chatHidden ? FOCUS_REGIONS.SESSIONS : FOCUS_REGIONS.CHAT,
+        [FOCUS_REGIONS.INSPECTOR]: layout?.chatHidden ? FOCUS_REGIONS.SESSIONS : FOCUS_REGIONS.CHAT,
+        [FOCUS_REGIONS.CHAT]: layout?.sessionHidden ? FOCUS_REGIONS.CHAT : FOCUS_REGIONS.SESSIONS,
+        [FOCUS_REGIONS.SESSIONS]: FOCUS_REGIONS.SESSIONS,
+    };
+    return map[focusRegion] || (layout?.sessionHidden ? FOCUS_REGIONS.CHAT : FOCUS_REGIONS.SESSIONS);
+}
+
+export function getFocusRightTarget(focusRegion, layout) {
+    if (layout?.fullscreenPane) {
+        return layout.fullscreenPane;
+    }
+    if (layout?.leftHidden) {
+        const map = {
+            [FOCUS_REGIONS.PROMPT]: FOCUS_REGIONS.PROMPT,
+            [FOCUS_REGIONS.INSPECTOR]: FOCUS_REGIONS.ACTIVITY,
+            [FOCUS_REGIONS.ACTIVITY]: FOCUS_REGIONS.ACTIVITY,
+        };
+        return map[focusRegion] || FOCUS_REGIONS.INSPECTOR;
+    }
+
+    if (layout?.rightHidden) {
+        const map = {
+            [FOCUS_REGIONS.PROMPT]: FOCUS_REGIONS.PROMPT,
+            [FOCUS_REGIONS.SESSIONS]: layout?.chatHidden ? FOCUS_REGIONS.SESSIONS : FOCUS_REGIONS.CHAT,
+            [FOCUS_REGIONS.CHAT]: FOCUS_REGIONS.CHAT,
+        };
+        return map[focusRegion] || (layout?.chatHidden ? FOCUS_REGIONS.SESSIONS : FOCUS_REGIONS.CHAT);
+    }
+    if (layout?.inspectorHidden) {
+        const map = {
+            [FOCUS_REGIONS.PROMPT]: FOCUS_REGIONS.PROMPT,
+            [FOCUS_REGIONS.SESSIONS]: FOCUS_REGIONS.CHAT,
+            [FOCUS_REGIONS.CHAT]: FOCUS_REGIONS.ACTIVITY,
+            [FOCUS_REGIONS.ACTIVITY]: FOCUS_REGIONS.ACTIVITY,
+        };
+        return map[focusRegion] || FOCUS_REGIONS.CHAT;
+    }
+    if (layout?.activityHidden) {
+        const map = {
+            [FOCUS_REGIONS.PROMPT]: FOCUS_REGIONS.PROMPT,
+            [FOCUS_REGIONS.SESSIONS]: FOCUS_REGIONS.CHAT,
+            [FOCUS_REGIONS.CHAT]: FOCUS_REGIONS.INSPECTOR,
+            [FOCUS_REGIONS.INSPECTOR]: FOCUS_REGIONS.INSPECTOR,
+        };
+        return map[focusRegion] || FOCUS_REGIONS.CHAT;
+    }
+
+    const map = {
+        [FOCUS_REGIONS.PROMPT]: FOCUS_REGIONS.PROMPT,
+        [FOCUS_REGIONS.SESSIONS]: FOCUS_REGIONS.CHAT,
+        [FOCUS_REGIONS.CHAT]: FOCUS_REGIONS.INSPECTOR,
+        [FOCUS_REGIONS.INSPECTOR]: FOCUS_REGIONS.ACTIVITY,
+        [FOCUS_REGIONS.ACTIVITY]: FOCUS_REGIONS.ACTIVITY,
+    };
+    return map[focusRegion] || FOCUS_REGIONS.CHAT;
+}