pilotswarm-cli 0.1.13 → 0.1.15

package/README.md

@@ -22,6 +22,9 @@ npx pilotswarm local --env .env --plugin ./plugin --worker ./worker-module.js
 
 `pilotswarm-cli` provides the shipped TUI. Your app customizes it with `plugin/plugin.json`, `plugin/agents/*.agent.md`, `plugin/skills/*/SKILL.md`, and optional worker-side tools.
 
+Portal/runtime helpers that are intentionally shared with `pilotswarm-web`
+are exported from `pilotswarm-cli/portal`.
+
 Common docs:
 
 - CLI apps: `https://github.com/affandar/PilotSwarm/blob/main/docs/cli/building-cli-apps.md`

package/bin/tui.js

@@ -1,7 +1,10 @@
 #!/usr/bin/env node
 
-import { parseCliIntoEnv } from "../src/bootstrap-env.js";
-import { startTuiApp } from "../src/index.js";
+// Force the shipped TUI onto production React/Ink unless the caller
+// explicitly opts into another environment for debugging.
+process.env.NODE_ENV ??= "production";
 
+const { parseCliIntoEnv } = await import("../src/bootstrap-env.js");
 const config = parseCliIntoEnv(process.argv.slice(2));
+const { startTuiApp } = await import("../src/index.js");
 await startTuiApp(config);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pilotswarm-cli",
-  "version": "0.1.13",
+  "version": "0.1.15",
   "description": "Terminal UI for PilotSwarm.",
   "type": "module",
   "bin": {
@@ -9,7 +9,8 @@
   },
   "main": "./src/index.js",
   "exports": {
-    ".": "./src/index.js"
+    ".": "./src/index.js",
+    "./portal": "./src/portal.js"
   },
   "scripts": {
     "build": "echo 'pilotswarm-cli: no build step (plain JS)'",
@@ -36,7 +37,7 @@
   },
   "dependencies": {
     "ink": "^6.8.0",
-    "pilotswarm-sdk": "^0.1.12",
+    "pilotswarm-sdk": "^0.1.15",
     "pilotswarm-ui-core": "0.1.0",
     "pilotswarm-ui-react": "0.1.0",
     "react": "^19.2.4"

package/src/app.js

@@ -231,6 +231,7 @@ export function PilotSwarmTuiApp({ controller, platform, onRequestExit }) {
         const focus = controller.getState().ui.focusRegion;
         const modal = controller.getState().ui.modal;
         const inspectorTab = controller.getState().ui.inspectorTab;
+        const fullscreenPane = controller.getState().ui.fullscreenPane || null;
         const plainShortcut = isPlainShortcutKey(key);
         const matchesCtrlKey = (name, controlChar) => key.ctrl
             && (key.name === name || input === name || input === controlChar);
@@ -241,6 +242,7 @@ export function PilotSwarmTuiApp({ controller, platform, onRequestExit }) {
         const isCtrlA = matchesCtrlKey("a", "\u0001");
         const isShiftN = input === "N" || (key.shift && key.name === "n");
         const isShiftD = input === "D" || (key.shift && key.name === "d");
+        const isShiftT = !key.ctrl && !key.meta && !key.alt && (input === "T" || (key.shift && key.name === "t"));
         const isAltBackspace = key.meta && (key.backspace || key.delete || key.name === "backspace" || key.name === "delete");
         const isAltLeftWord = key.meta && (key.leftArrow || key.name === "left" || input === "b" || input === "B");
         const isAltRightWord = key.meta && (key.rightArrow || key.name === "right" || input === "f" || input === "F");
@@ -275,6 +277,10 @@ export function PilotSwarmTuiApp({ controller, platform, onRequestExit }) {
         }
 
         if (modal) {
+            if (isShiftT && modal.type === "themePicker") {
+                controller.handleCommand(UI_COMMANDS.CLOSE_MODAL).catch(() => {});
+                return;
+            }
             if (modal.type === "renameSession" || modal.type === "artifactUpload") {
                 if (key.escape) {
                     controller.handleCommand(UI_COMMANDS.CLOSE_MODAL).catch(() => {});
@@ -342,11 +348,19 @@ export function PilotSwarmTuiApp({ controller, platform, onRequestExit }) {
             return;
         }
 
+        if (focus !== "prompt" && isShiftT) {
+            controller.handleCommand(UI_COMMANDS.OPEN_THEME_PICKER).catch(() => {});
+            return;
+        }
+
         if (key.tab && key.shift) {
             controller.handleCommand(UI_COMMANDS.FOCUS_PREV).catch(() => {});
             return;
         }
         if (key.tab) {
+            if (focus === "prompt" && controller.acceptPromptReferenceAutocomplete()) {
+                return;
+            }
             controller.handleCommand(UI_COMMANDS.FOCUS_NEXT).catch(() => {});
             return;
         }
@@ -354,6 +368,15 @@ export function PilotSwarmTuiApp({ controller, platform, onRequestExit }) {
             controller.handleCommand(UI_COMMANDS.TOGGLE_FILE_PREVIEW_FULLSCREEN).catch(() => {});
             return;
         }
+        if (key.escape && fullscreenPane) {
+            if (focus === "prompt") {
+                controller.setPrompt("");
+                controller.setFocus(fullscreenPane);
+                return;
+            }
+            controller.handleCommand(UI_COMMANDS.TOGGLE_PANE_FULLSCREEN).catch(() => {});
+            return;
+        }
         if (key.escape) {
             if (focus === "prompt") {
                 controller.setPrompt("");
@@ -387,10 +410,34 @@ export function PilotSwarmTuiApp({ controller, platform, onRequestExit }) {
             controller.handleCommand(UI_COMMANDS.OPEN_FILES_FILTER).catch(() => {});
             return;
         }
+        if (focus === "inspector" && inspectorTab === "files" && input === "u") {
+            controller.handleCommand(UI_COMMANDS.OPEN_ARTIFACT_UPLOAD).catch(() => {});
+            return;
+        }
+        if (focus === "inspector" && inspectorTab === "files" && input === "a") {
+            controller.handleCommand(UI_COMMANDS.DOWNLOAD_SELECTED_FILE).catch(() => {});
+            return;
+        }
+        if (focus === "inspector" && inspectorTab === "history" && input === "f") {
+            controller.handleCommand(UI_COMMANDS.OPEN_HISTORY_FORMAT).catch(() => {});
+            return;
+        }
+        if (focus === "inspector" && inspectorTab === "history" && input === "r") {
+            controller.handleCommand(UI_COMMANDS.REFRESH_EXECUTION_HISTORY).catch(() => {});
+            return;
+        }
+        if (focus === "inspector" && inspectorTab === "history" && input === "a") {
+            controller.handleCommand(UI_COMMANDS.EXPORT_EXECUTION_HISTORY).catch(() => {});
+            return;
+        }
         if (focus === "inspector" && inspectorTab === "files" && input === "v") {
             controller.handleCommand(UI_COMMANDS.TOGGLE_FILE_PREVIEW_FULLSCREEN).catch(() => {});
             return;
         }
+        if (focus !== "prompt" && input === "v") {
+            controller.handleCommand(UI_COMMANDS.TOGGLE_PANE_FULLSCREEN).catch(() => {});
+            return;
+        }
         if (focus === "inspector" && inspectorTab === "files" && plainShortcut && input === "o") {
             controller.handleCommand(UI_COMMANDS.OPEN_SELECTED_FILE).catch(() => {});
             return;
@@ -414,6 +461,14 @@ export function PilotSwarmTuiApp({ controller, platform, onRequestExit }) {
             controller.handleCommand(UI_COMMANDS.GROW_RIGHT_PANE).catch(() => {});
             return;
         }
+        if (focus !== "prompt" && input === "{") {
+            controller.handleCommand(UI_COMMANDS.SHRINK_SESSION_PANE).catch(() => {});
+            return;
+        }
+        if (focus !== "prompt" && input === "}") {
+            controller.handleCommand(UI_COMMANDS.GROW_SESSION_PANE).catch(() => {});
+            return;
+        }
 
         if (focus === "prompt") {
             if (isCtrlA) {

package/src/bootstrap-env.js

@@ -3,21 +3,10 @@ import { execFileSync } from "node:child_process";
 import fs from "node:fs";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
+import { resolveTuiBranding } from "./plugin-config.js";
 
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 const pkgRoot = path.resolve(__dirname, "..");
-const defaultTuiSplashPath = path.join(pkgRoot, "tui-splash.txt");
-
-function readPluginMetadata(pluginDir) {
-    if (!pluginDir) return null;
-    const pluginJsonPath = path.join(pluginDir, "plugin.json");
-    if (!fs.existsSync(pluginJsonPath)) return null;
-    try {
-        return JSON.parse(fs.readFileSync(pluginJsonPath, "utf-8"));
-    } catch (error) {
-        throw new Error(`Failed to parse plugin metadata: ${pluginJsonPath}: ${error.message}`);
-    }
-}
 
 function resolvePluginDir(flags) {
     if (flags.plugin) return path.resolve(flags.plugin);
@@ -52,31 +41,6 @@ function resolveSystemMessage(flags) {
     return undefined;
 }
 
-function resolveTuiBranding(pluginDir) {
-    const pluginMeta = readPluginMetadata(pluginDir);
-    const tui = pluginMeta?.tui;
-    let defaultSplash = "{bold}{cyan-fg}PilotSwarm{/cyan-fg}{/bold}";
-    if (fs.existsSync(defaultTuiSplashPath)) {
-        defaultSplash = fs.readFileSync(defaultTuiSplashPath, "utf-8").trimEnd();
-    }
-    if (!tui || typeof tui !== "object") {
-        return { title: "PilotSwarm", splash: defaultSplash };
-    }
-
-    const title = typeof tui.title === "string" && tui.title.trim() ? tui.title.trim() : "PilotSwarm";
-    let splash = defaultSplash;
-    if (typeof tui.splash === "string" && tui.splash.trim()) {
-        splash = tui.splash;
-    } else if (typeof tui.splashFile === "string" && tui.splashFile.trim()) {
-        const splashPath = path.resolve(pluginDir, tui.splashFile);
-        if (!fs.existsSync(splashPath)) {
-            throw new Error(`TUI splash file not found: ${splashPath}`);
-        }
-        splash = fs.readFileSync(splashPath, "utf-8").trimEnd();
-    }
-    return { title, splash };
-}
-
 function loadEnvFile(envFile) {
     if (!fs.existsSync(envFile)) return;
     const envContent = fs.readFileSync(envFile, "utf-8");

package/src/index.js

@@ -1,5 +1,7 @@
 import React from "react";
 import fs from "node:fs";
+import path from "node:path";
+import os from "node:os";
 import { createRequire } from "node:module";
 import { render } from "ink";
 import {
@@ -14,6 +16,26 @@ import { NodeSdkTransport } from "./node-sdk-transport.js";
 
 const require = createRequire(import.meta.url);
 
+const CONFIG_DIR = path.join(process.env.XDG_CONFIG_HOME || path.join(os.homedir(), ".config"), "pilotswarm");
+const CONFIG_FILE = path.join(CONFIG_DIR, "config.json");
+
+function readConfig() {
+    try {
+        return JSON.parse(fs.readFileSync(CONFIG_FILE, "utf8"));
+    } catch {
+        return {};
+    }
+}
+
+function writeConfig(patch) {
+    try {
+        const existing = readConfig();
+        const merged = { ...existing, ...patch };
+        fs.mkdirSync(CONFIG_DIR, { recursive: true });
+        fs.writeFileSync(CONFIG_FILE, JSON.stringify(merged, null, 2) + "\n", "utf8");
+    } catch {}
+}
+
 function setupTuiHostRuntime() {
     const logFile = "/tmp/duroxide-tui.log";
     const originalConsole = {
@@ -90,9 +112,11 @@ export async function startTuiApp(config) {
         store: config.store,
         mode: config.mode,
     });
+    const userConfig = readConfig();
     const store = createStore(appReducer, createInitialState({
         mode: config.mode,
         branding: config.branding,
+        themeId: userConfig.themeId,
     }));
     const controller = new PilotSwarmUiController({ store, transport });
     let tuiApp;
@@ -144,6 +168,49 @@ export async function startTuiApp(config) {
         exitOnCtrlC: false,
     });
 
+    // Listen for portal theme-change OSC sequences on stdin:
+    //   \x1b]777;theme;<themeId>\x07
+    let oscBuffer = "";
+    const OSC_PREFIX = "\x1b]777;theme;";
+    const OSC_SUFFIX = "\x07";
+    const stdinThemeHandler = (data) => {
+        const str = typeof data === "string" ? data : data.toString("utf8");
+        oscBuffer += str;
+        while (oscBuffer.includes(OSC_PREFIX) && oscBuffer.includes(OSC_SUFFIX)) {
+            const start = oscBuffer.indexOf(OSC_PREFIX);
+            const end = oscBuffer.indexOf(OSC_SUFFIX, start);
+            if (end < 0) break;
+            const themeId = oscBuffer.slice(start + OSC_PREFIX.length, end);
+            oscBuffer = oscBuffer.slice(end + OSC_SUFFIX.length);
+            if (themeId) {
+                store.dispatch({ type: "ui/theme", themeId });
+            }
+        }
+        // Prevent buffer from growing unbounded
+        if (oscBuffer.length > 1024) oscBuffer = oscBuffer.slice(-256);
+    };
+    process.stdin.on("data", stdinThemeHandler);
+
+    // Sync viewport on terminal resize (SIGWINCH)
+    const syncViewport = () => {
+        controller.setViewport({
+            width: process.stdout.columns || 120,
+            height: process.stdout.rows || 40,
+        });
+    };
+    syncViewport();
+    process.stdout.on("resize", syncViewport);
+
+    // Persist theme changes to config file
+    let lastPersistedThemeId = store.getState().ui.themeId;
+    store.subscribe(() => {
+        const currentThemeId = store.getState().ui.themeId;
+        if (currentThemeId && currentThemeId !== lastPersistedThemeId) {
+            lastPersistedThemeId = currentThemeId;
+            writeConfig({ themeId: currentThemeId });
+        }
+    });
+
     try {
         await exitPromise;
     } finally {