swarmlancer-cli 0.4.1 → 0.5.1

package/dist/app.js

@@ -1,13 +1,12 @@
-import { ProcessTerminal, TUI, Container } from "@mariozechner/pi-tui";
+import { ProcessTerminal, TUI } from "@mariozechner/pi-tui";
 import { getConfig, getAgents, getAgent, saveAgent, deleteAgent, createAgent, migrateLegacyAgent, } from "./config.js";
 import { login } from "./login.js";
 import { setActiveModel, setAgentInstructions } from "./inference.js";
 import { resolveModel, getAvailableModels, isProviderAuthenticated, saveProviderKey, PROVIDERS, } from "./providers.js";
 import { startAgent, stopAgent, sendToServer } from "./agent.js";
 import { colors } from "./theme.js";
-import { BannerComponent } from "./screens/banner.js";
-import { SetupWizardScreen } from "./screens/setup-wizard.js";
 import { DashboardScreen } from "./screens/dashboard.js";
+import { MenuScreen } from "./screens/menu-screen.js";
 import { AgentConfigScreen } from "./screens/agent-config.js";
 import { AgentPickerScreen } from "./screens/agent-picker.js";
 import { AgentEditorScreen } from "./screens/agent-editor.js";
@@ -16,11 +15,11 @@ import { SettingsScreen } from "./screens/settings.js";
 import { DiscoverySettingsScreen } from "./screens/discovery-settings.js";
 import { ModelPickerScreen } from "./screens/model-picker.js";
 import { NameEditorScreen } from "./screens/name-editor.js";
-import { SessionGoalScreen } from "./screens/session-goal.js";
 import { MessageScreen } from "./screens/message.js";
 import { screenProfiles } from "./screening.js";
 let terminal;
 let tui;
+let runningAgentId; // tracks which agent is online (⚡)
 function setScreen(component) {
     tui.clear();
     tui.addChild(component);
@@ -34,69 +33,29 @@ function showMessage(title, lines, style = "info") {
         setScreen(screen);
     });
 }
-// ── Setup ─────────────────────────────────────────────────
-async function runSetup() {
+function confirm(question) {
+    return new Promise((resolve) => {
+        const items = [
+            { value: "yes", label: "Yes" },
+            { value: "no", label: "No" },
+        ];
+        const screen = new MenuScreen(tui, question, items);
+        screen.onSelect = (v) => resolve(v === "yes");
+        screen.onBack = () => resolve(false);
+        setScreen(screen);
+    });
+}
+// ── Silent setup ──────────────────────────────────────────
+async function silentSetup() {
     migrateLegacyAgent();
-    const banner = new BannerComponent();
-    const wizard = new SetupWizardScreen(tui);
-    const wrapper = new Container();
-    wrapper.addChild(banner);
-    wrapper.addChild(wizard);
-    tui.clear();
-    tui.addChild(wrapper);
-    tui.setFocus(wizard);
-    tui.requestRender(true);
-    // Step 1: Auth
+    // Auto-login if not logged in
     const config = getConfig();
-    wizard.setStep(0, "running");
-    if (config.token) {
-        wizard.setStep(0, "done", "logged in");
-    }
-    else {
-        wizard.setStep(0, "running", "not logged in — opening browser...");
+    if (!config.token) {
         try {
             await login();
-            wizard.setStep(0, "done", "logged in");
-        }
-        catch (err) {
-            wizard.setStep(0, "failed", err instanceof Error ? err.message : "login failed");
         }
+        catch { }
     }
-    // Step 2: Agents
-    wizard.setStep(1, "running");
-    const agents = getAgents();
-    if (agents.length > 0) {
-        wizard.setStep(1, "done", `${agents.length} agent${agents.length === 1 ? "" : "s"}`);
-    }
-    else {
-        wizard.setStep(1, "skipped", "no agents yet");
-        const shouldCreate = await wizard.askConfirm("You have no agents. Create one now?");
-        if (shouldCreate) {
-            const name = await askName("New Agent Name", "Give your first agent a name.");
-            if (name) {
-                createAgent(name);
-                wizard.setStep(1, "done", "1 agent created");
-            }
-            else {
-                wizard.setStep(1, "skipped", "skipped");
-            }
-            tui.clear();
-            tui.addChild(wrapper);
-            tui.setFocus(wizard);
-            tui.requestRender(true);
-        }
-    }
-    // Step 3: Providers
-    wizard.setStep(2, "running");
-    const models = getAvailableModels();
-    if (models.length > 0) {
-        const providers = [...new Set(models.map((m) => m.provider))];
-        wizard.setStep(2, "done", providers.join(", "));
-    }
-    else {
-        wizard.setStep(2, "skipped", "no API keys — add in Swarm → Providers");
-    }
-    await new Promise((r) => setTimeout(r, 800));
 }
 // ── Sub-screens ───────────────────────────────────────────
 function askName(title, subtitle, current = "") {
@@ -165,19 +124,10 @@ function editModel(agent) {
         setScreen(screen);
     });
 }
-function askSessionGoal() {
-    return new Promise((resolve) => {
-        const screen = new SessionGoalScreen(tui);
-        screen.onSubmit = (goal) => resolve(goal.trim());
-        screen.onSkip = () => resolve("");
-        setScreen(screen);
-    });
-}
 function pickAgent() {
     const agents = getAgents();
-    if (agents.length === 0) {
+    if (agents.length === 0)
         return showMessage("No agents", ["Create an agent first."], "error").then(() => null);
-    }
     if (agents.length === 1)
         return Promise.resolve(agents[0]);
     return new Promise((resolve) => {
@@ -187,24 +137,6 @@ function pickAgent() {
         setScreen(screen);
     });
 }
-// ── Provider login ────────────────────────────────────────
-async function handleProviderLogin(providerId) {
-    const provider = PROVIDERS.find((p) => p.id === providerId);
-    if (!provider)
-        return;
-    if (!provider.keyBased) {
-        await showMessage("Coming soon", [`${provider.label} is not yet supported.`], "info");
-        return;
-    }
-    if (isProviderAuthenticated(provider.id)) {
-        await showMessage("Already configured", [`${provider.label} is already logged in.`, "", "To change the API key, re-enter it below."], "info");
-    }
-    const key = await askName(`${provider.label}`, "Paste your API key:");
-    if (key) {
-        saveProviderKey(provider.id, key);
-        await showMessage("Saved", [`${provider.label} API key saved.`], "success");
-    }
-}
 // ── Agent config ──────────────────────────────────────────
 async function runAgentConfig(agentId) {
     while (true) {
@@ -218,7 +150,7 @@ async function runAgentConfig(agentId) {
         });
         switch (action) {
             case "edit-name": {
-                const newName = await askName("Rename Agent", "Enter a new name for this agent.", agent.name);
+                const newName = await askName("Rename Agent", "Enter a new name.", agent.name);
                 if (newName) {
                     agent.name = newName;
                     saveAgent(agent);
@@ -238,15 +170,114 @@ async function runAgentConfig(agentId) {
                 await editModel(agent);
                 break;
             case "delete": {
-                await showMessage("Deleted", [`Agent "${agent.name}" has been deleted.`], "info");
-                deleteAgent(agent.id);
-                return;
+                const sure = await confirm(`Delete "${agent.name}"?`);
+                if (sure) {
+                    deleteAgent(agent.id);
+                    return;
+                }
+                break;
             }
             case "back": return;
         }
     }
 }
-// ── Running agent ─────────────────────────────────────────
+// ── Swarm screen ──────────────────────────────────────────
+async function runManageTop() {
+    while (true) {
+        const action = await new Promise((resolve) => {
+            const items = [
+                { value: "swarm", label: "Swarm", description: "" },
+                { value: "providers", label: "Providers", description: "" },
+            ];
+            const screen = new MenuScreen(tui, "Manage", items);
+            screen.onSelect = (v) => resolve(v);
+            screen.onBack = () => resolve(null);
+            setScreen(screen);
+        });
+        if (!action)
+            return;
+        switch (action) {
+            case "swarm":
+                await runSwarm();
+                break;
+            case "providers":
+                await runProviders();
+                break;
+        }
+    }
+}
+// ── Manage screen ─────────────────────────────────────────
+async function runSwarm() {
+    while (true) {
+        const agents = getAgents();
+        const items = [
+            { value: "__create__", label: "+ Create", description: "" },
+        ];
+        for (const agent of agents) {
+            const isRunning = agent.id === runningAgentId;
+            const suffix = isRunning ? " [⚡]" : "";
+            items.push({
+                value: agent.id,
+                label: `${agent.name}${suffix}`,
+                description: "",
+            });
+        }
+        const action = await new Promise((resolve) => {
+            const screen = new MenuScreen(tui, "Swarm", items);
+            screen.onSelect = (v) => resolve(v);
+            screen.onBack = () => resolve(null);
+            setScreen(screen);
+        });
+        if (!action)
+            return;
+        if (action === "__create__") {
+            const name = await askName("New Agent", "Give your agent a name.");
+            if (name) {
+                const agent = createAgent(name);
+                await runAgentConfig(agent.id);
+            }
+        }
+        else {
+            await runAgentConfig(action);
+        }
+    }
+}
+// ── Providers screen ──────────────────────────────────────
+async function runProviders() {
+    while (true) {
+        const items = PROVIDERS.map((p) => {
+            const loggedIn = isProviderAuthenticated(p.id);
+            const prefix = loggedIn ? "→ " : "  ";
+            const suffix = loggedIn ? " ✓ logged in" : "";
+            return {
+                value: p.id,
+                label: `${prefix}${p.label}${suffix}`,
+                description: "",
+            };
+        });
+        const action = await new Promise((resolve) => {
+            const screen = new MenuScreen(tui, "Providers", items);
+            screen.onSelect = (v) => resolve(v);
+            screen.onBack = () => resolve(null);
+            setScreen(screen);
+        });
+        if (!action)
+            return;
+        const provider = PROVIDERS.find((p) => p.id === action);
+        if (!provider)
+            continue;
+        if (!provider.keyBased) {
+            await showMessage("Coming soon", [`${provider.label} is not yet supported.`], "info");
+            continue;
+        }
+        const key = await askName(provider.label, "Paste your API key:");
+        if (key) {
+            saveProviderKey(provider.id, key);
+            await showMessage("Saved", [`${provider.label} API key saved.`], "success");
+        }
+    }
+}
+// ── Go online ─────────────────────────────────────────────
 async function fetchCandidates(discovery) {
     const config = getConfig();
     const params = new URLSearchParams();
@@ -265,14 +296,17 @@ async function fetchCandidates(discovery) {
     });
     if (!res.ok)
         throw new Error(`Discover API error: ${res.status}`);
-    const data = (await res.json());
-    return data.profiles;
+    return (await res.json()).profiles;
 }
-async function runAgentSession() {
+async function goOnline() {
+    const conf = getConfig();
+    if (!conf.token) {
+        await showMessage("Not logged in", ["Run login first."], "error");
+        return;
+    }
     const agent = await pickAgent();
     if (!agent)
         return;
-    // Resolve model
     const resolved = resolveModel(agent.modelPattern);
     if (!resolved) {
         await showMessage("No model", ["No provider API keys configured.", "Add one in Swarm → Providers."], "error");
@@ -280,18 +314,14 @@ async function runAgentSession() {
     }
     setActiveModel(resolved.provider, resolved.model);
     setAgentInstructions(agent.instructions);
-    const modelInfo = {
-        provider: resolved.provider,
-        id: resolved.model,
-        name: resolved.model,
-    };
-    const sessionGoal = "";
+    runningAgentId = agent.id;
+    const modelInfo = { provider: resolved.provider, id: resolved.model, name: resolved.model };
     const config = getConfig();
     const discovery = agent.discovery;
     const limits = agent.limits;
-    const screen = new AgentRunningScreen(tui, modelInfo, config.serverUrl, agent.name, sessionGoal);
+    const screen = new AgentRunningScreen(tui, modelInfo, config.serverUrl, agent.name);
     const done = new Promise((resolve) => {
-        screen.onStop = () => { stopAgent(); resolve(); };
+        screen.onStop = () => { stopAgent(); runningAgentId = undefined; resolve(); };
     });
     setScreen(screen);
     const log = (line) => screen.addLog(line);
@@ -307,7 +337,7 @@ async function runAgentSession() {
         else {
             log(colors.lime(`📡 Found ${candidates.length} candidates, screening...`));
             screen.setStatus(`screening ${candidates.length} profiles...`);
-            const results = await screenProfiles(candidates, agent.instructions, sessionGoal, discovery.matchThreshold, discovery.maxScreenPerSession, (screened, total, result) => {
+            const results = await screenProfiles(candidates, agent.instructions, "", discovery.matchThreshold, discovery.maxScreenPerSession, (screened, total, result) => {
                 const icon = result.score >= discovery.matchThreshold ? colors.lime("✓") : colors.gray("⊘");
                 const scoreStr = result.score >= discovery.matchThreshold
                     ? colors.lime(`${result.score}/10`) : colors.gray(`${result.score}/10`);
@@ -321,13 +351,12 @@ async function runAgentSession() {
             }
             else {
                 log(colors.lime(`Found ${matches.length} match${matches.length === 1 ? "" : "es"}. Starting conversations...`));
-                log("");
                 for (const match of matches) {
                     if (!match.profile.online) {
                         log(colors.gray(`  ⊘ @${match.profile.githubUsername} offline`));
                         continue;
                     }
-                    log(colors.lime(`  🤝 @${match.profile.githubUsername} (${match.score}/10: ${match.reason})`));
+                    log(colors.lime(`  🤝 @${match.profile.githubUsername} (${match.score}/10)`));
                     sendToServer({ type: "start_conversation", withUserId: match.profile.id });
                     if (limits.cooldownSeconds > 0)
                         await new Promise((r) => setTimeout(r, limits.cooldownSeconds * 1000));
@@ -345,39 +374,29 @@ async function runAgentSession() {
 // ── Dashboard loop ────────────────────────────────────────
 async function runDashboard() {
     while (true) {
-        const agents = getAgents();
         const action = await new Promise((resolve) => {
-            const dashboard = new DashboardScreen(tui, { agents });
+            const dashboard = new DashboardScreen(tui);
             dashboard.onAction = resolve;
             setScreen(dashboard);
         });
-        switch (action.type) {
+        switch (action) {
             case "start": {
-                const conf = getConfig();
-                if (!conf.token) {
-                    await showMessage("Not logged in", ["Run login first."], "error");
-                    break;
-                }
-                await runAgentSession();
+                const sure = await confirm("Go online?");
+                if (sure)
+                    await goOnline();
                 break;
             }
-            case "create-agent": {
-                const name = await askName("New Agent", "Give your agent a name.");
-                if (name) {
-                    const agent = createAgent(name);
-                    await runAgentConfig(agent.id);
+            case "manage":
+                await runManageTop();
+                break;
+            case "exit": {
+                const sure = await confirm("Exit?");
+                if (sure) {
+                    shutdown();
+                    return;
                 }
                 break;
             }
-            case "edit-agent":
-                await runAgentConfig(action.agentId);
-                break;
-            case "provider":
-                await handleProviderLogin(action.providerId);
-                break;
-            case "quit":
-                shutdown();
-                return;
         }
     }
 }
@@ -397,6 +416,6 @@ export async function runInteractive() {
         }
         return undefined;
     });
-    await runSetup();
+    await silentSetup();
     await runDashboard();
 }

package/dist/screens/banner.js

@@ -1,13 +1,13 @@
 import { Container, Text, Spacer } from "@mariozechner/pi-tui";
 import { colors } from "../theme.js";
 const BANNER_ART = [
-    `  █████████        ███`,
-    ` ███     ███     ███  `,
-    ` ███           ███    `,
-    `  █████████  ███      `,
-    `         ███   ███    `,
-    ` ███     ███     ███  `,
-    `  █████████        ███`,
+    ` █████████        ███`,
+    `███     ███     ███`,
+    `███           ███`,
+    ` █████████  ███`,
+    `        ███   ███`,
+    `███     ███     ███`,
+    ` █████████        ███`,
 ];
 export class BannerComponent extends Container {
     constructor() {
@@ -21,7 +21,7 @@ export class BannerComponent extends Container {
             this.addChild(new Text(colors.limeBold(` ${line}`), 1, 0));
         }
         this.addChild(new Spacer(0));
-        this.addChild(new Text(colors.gray(" LET THE SWARM BEGIN!"), 1, 0));
+        this.addChild(new Text(colors.gray(" [LET THE SWARM BEGIN!]"), 1, 0));
         this.addChild(new Spacer(1));
     }
     invalidate() {

package/dist/screens/dashboard.d.ts

@@ -1,35 +1,12 @@
 import { type Component } from "@mariozechner/pi-tui";
 import type { TUI } from "@mariozechner/pi-tui";
-import type { AgentProfile } from "../config.js";
-export type MenuAction = {
-    type: "start";
-} | {
-    type: "create-agent";
-} | {
-    type: "edit-agent";
-    agentId: string;
-} | {
-    type: "provider";
-    providerId: string;
-} | {
-    type: "quit";
-};
-export interface DashboardData {
-    agents: AgentProfile[];
-}
+export type DashboardAction = "start" | "manage" | "exit";
 export declare class DashboardScreen implements Component {
+    private container;
+    private selectList;
     private tui;
-    private banner;
-    private tree;
-    private flat;
-    private selectableIndices;
-    private cursor;
-    private cachedRender?;
-    onAction?: (action: MenuAction) => void;
-    constructor(tui: TUI, data: DashboardData);
-    private buildTree;
-    private rebuildFlat;
-    private flattenTree;
+    onAction?: (action: DashboardAction) => void;
+    constructor(tui: TUI);
     handleInput(data: string): void;
     render(width: number): string[];
     invalidate(): void;

package/dist/screens/dashboard.js

@@ -1,160 +1,51 @@
-import { matchesKey, Key, truncateToWidth, } from "@mariozechner/pi-tui";
+import { Container, Text, Spacer, SelectList, matchesKey, Key, } from "@mariozechner/pi-tui";
 import { colors, theme } from "../theme.js";
 import { BannerComponent } from "./banner.js";
-import { PROVIDERS, isProviderAuthenticated } from "../providers.js";
+const MENU_ITEMS = [
+    { value: "start", label: "Start", description: "" },
+    { value: "manage", label: "Manage", description: "" },
+    { value: "exit", label: "Exit", description: "" },
+];
 export class DashboardScreen {
+    container;
+    selectList;
     tui;
-    banner;
-    tree;
-    flat = [];
-    selectableIndices = [];
-    cursor = 0;
-    cachedRender;
     onAction;
-    constructor(tui, data) {
+    constructor(tui) {
         this.tui = tui;
-        this.banner = new BannerComponent();
-        this.tree = this.buildTree(data);
-        this.rebuildFlat();
-    }
-    buildTree(data) {
-        // Manage children
-        const manageChildren = [
-            { label: "+ Create", indent: 0, action: { type: "create-agent" }, expanded: false },
-        ];
-        for (const agent of data.agents) {
-            const ready = agent.instructions.length > 0;
-            const suffix = ready ? " [⚡]" : "";
-            manageChildren.push({
-                label: `${agent.name}${suffix}`,
-                indent: 0,
-                action: { type: "edit-agent", agentId: agent.id },
-                expanded: false,
-            });
-        }
-        // Provider children
-        const providerChildren = [
-            { label: "Select provider to login:", indent: 0, isLabel: true, expanded: false },
-        ];
-        for (const p of PROVIDERS) {
-            const loggedIn = isProviderAuthenticated(p.id);
-            const prefix = loggedIn ? "→ " : "  ";
-            const suffix = loggedIn ? " ✓ logged in" : "";
-            providerChildren.push({
-                label: `${prefix}${p.label}${suffix}`,
-                indent: 0,
-                action: { type: "provider", providerId: p.id },
-                expanded: false,
-            });
-        }
-        return [
-            { label: "Go online", indent: 0, action: { type: "start" }, expanded: false },
-            {
-                label: "Swarm",
-                indent: 0,
-                expanded: false,
-                children: [
-                    {
-                        label: "Manage",
-                        indent: 0,
-                        expanded: false,
-                        children: manageChildren,
-                    },
-                    {
-                        label: "Providers",
-                        indent: 0,
-                        expanded: false,
-                        children: providerChildren,
-                    },
-                ],
-            },
-            { label: "Exit", indent: 0, action: { type: "quit" }, expanded: false },
-        ];
-    }
-    rebuildFlat() {
-        this.flat = [];
-        this.flattenTree(this.tree, 0);
-        this.selectableIndices = this.flat
-            .map((item, i) => (!item.node.isLabel ? i : -1))
-            .filter((i) => i >= 0);
-        if (this.cursor >= this.selectableIndices.length) {
-            this.cursor = Math.max(0, this.selectableIndices.length - 1);
-        }
-    }
-    flattenTree(nodes, indent) {
-        for (const node of nodes) {
-            this.flat.push({ node, indent });
-            if (node.children && node.expanded) {
-                this.flattenTree(node.children, indent + 1);
-            }
-        }
+        this.container = new Container();
+        this.container.addChild(new BannerComponent());
+        this.selectList = new SelectList(MENU_ITEMS, MENU_ITEMS.length, {
+            selectedPrefix: (t) => theme.accent(t),
+            selectedText: (t) => theme.accent(t),
+            description: (t) => colors.gray(t),
+            scrollInfo: (t) => colors.gray(t),
+            noMatch: (t) => colors.gray(t),
+        });
+        this.selectList.onSelect = (item) => {
+            this.onAction?.(item.value);
+        };
+        this.container.addChild(this.selectList);
+        this.container.addChild(new Spacer(1));
+        this.container.addChild(new Text(colors.gray(" ↑↓ navigate • →/enter select • q quit"), 1, 0));
     }
     handleInput(data) {
         if (matchesKey(data, "q")) {
-            this.onAction?.({ type: "quit" });
+            this.onAction?.("exit");
             return;
         }
-        if (matchesKey(data, Key.up)) {
-            if (this.cursor > 0)
-                this.cursor--;
-            this.cachedRender = undefined;
+        if (matchesKey(data, Key.right)) {
+            this.selectList.handleInput("\r");
             this.tui.requestRender();
             return;
         }
-        if (matchesKey(data, Key.down)) {
-            if (this.cursor < this.selectableIndices.length - 1)
-                this.cursor++;
-            this.cachedRender = undefined;
-            this.tui.requestRender();
-            return;
-        }
-        if (matchesKey(data, Key.enter)) {
-            const itemIdx = this.selectableIndices[this.cursor];
-            const item = this.flat[itemIdx];
-            if (item.node.children) {
-                // Branch: toggle expand/collapse
-                item.node.expanded = !item.node.expanded;
-                this.rebuildFlat();
-                this.cachedRender = undefined;
-                this.tui.requestRender();
-            }
-            else if (item.node.action) {
-                // Leaf: trigger action
-                this.onAction?.(item.node.action);
-            }
-            return;
-        }
+        this.selectList.handleInput(data);
+        this.tui.requestRender();
     }
     render(width) {
-        if (this.cachedRender)
-            return this.cachedRender;
-        const lines = this.banner.render(width);
-        const selectedFlatIdx = this.selectableIndices[this.cursor];
-        for (let i = 0; i < this.flat.length; i++) {
-            const { node, indent } = this.flat[i];
-            const pad = "  ".repeat(indent + 1);
-            const isSelected = i === selectedFlatIdx;
-            if (node.isLabel) {
-                // Non-selectable label
-                lines.push(truncateToWidth(`${pad}  ${colors.gray(node.label)}`, width));
-                continue;
-            }
-            const isBranch = !!node.children;
-            const arrow = isBranch ? (node.expanded ? " ▾" : " ▸") : "";
-            const label = `${node.label}${arrow}`;
-            if (isSelected) {
-                lines.push(truncateToWidth(`${pad}${theme.accent(`▸ ${label}`)}`, width));
-            }
-            else {
-                lines.push(truncateToWidth(`${pad}  ${label}`, width));
-            }
-        }
-        lines.push("");
-        lines.push(truncateToWidth(colors.gray(" ↑↓ navigate • enter expand/select • q quit"), width));
-        this.cachedRender = lines;
-        return lines;
+        return this.container.render(width);
     }
     invalidate() {
-        this.cachedRender = undefined;
+        this.container.invalidate();
     }
 }

package/dist/screens/menu-screen.d.ts

@@ -0,0 +1,17 @@
+import { type SelectItem, type Component } from "@mariozechner/pi-tui";
+import type { TUI } from "@mariozechner/pi-tui";
+/**
+ * Reusable menu screen with title, items, and left/right/enter/esc navigation.
+ * Enter or Right = select, Left or Esc = back.
+ */
+export declare class MenuScreen implements Component {
+    private container;
+    private selectList;
+    private tui;
+    onSelect?: (value: string) => void;
+    onBack?: () => void;
+    constructor(tui: TUI, title: string, items: SelectItem[], subtitle?: string);
+    handleInput(data: string): void;
+    render(width: number): string[];
+    invalidate(): void;
+}

package/dist/screens/menu-screen.js

@@ -0,0 +1,59 @@
+import { Container, Text, Spacer, SelectList, matchesKey, Key, truncateToWidth, } from "@mariozechner/pi-tui";
+import { colors, theme } from "../theme.js";
+/**
+ * Reusable menu screen with title, items, and left/right/enter/esc navigation.
+ * Enter or Right = select, Left or Esc = back.
+ */
+export class MenuScreen {
+    container;
+    selectList;
+    tui;
+    onSelect;
+    onBack;
+    constructor(tui, title, items, subtitle) {
+        this.tui = tui;
+        this.container = new Container();
+        this.container.addChild(new Spacer(1));
+        this.container.addChild(new Text(truncateToWidth(theme.border("─".repeat(60)), 60), 0, 0));
+        this.container.addChild(new Text(theme.title(` ${title}`), 1, 0));
+        if (subtitle) {
+            this.container.addChild(new Text(colors.gray(` ${subtitle}`), 1, 0));
+        }
+        this.container.addChild(new Text(truncateToWidth(theme.border("─".repeat(60)), 60), 0, 0));
+        this.container.addChild(new Spacer(1));
+        this.selectList = new SelectList(items, Math.min(items.length, 15), {
+            selectedPrefix: (t) => theme.accent(t),
+            selectedText: (t) => theme.accent(t),
+            description: (t) => colors.gray(t),
+            scrollInfo: (t) => colors.gray(t),
+            noMatch: (t) => colors.gray(t),
+        });
+        this.selectList.onSelect = (item) => this.onSelect?.(item.value);
+        this.selectList.onCancel = () => this.onBack?.();
+        this.container.addChild(this.selectList);
+        this.container.addChild(new Spacer(1));
+        this.container.addChild(new Text(colors.gray(" ↑↓ navigate • →/enter select • ←/esc back"), 1, 0));
+    }
+    handleInput(data) {
+        // Right arrow = enter
+        if (matchesKey(data, Key.right)) {
+            // Simulate enter by triggering current selection
+            this.selectList.handleInput("\r");
+            this.tui.requestRender();
+            return;
+        }
+        // Left arrow = back
+        if (matchesKey(data, Key.left)) {
+            this.onBack?.();
+            return;
+        }
+        this.selectList.handleInput(data);
+        this.tui.requestRender();
+    }
+    render(width) {
+        return this.container.render(width);
+    }
+    invalidate() {
+        this.container.invalidate();
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "swarmlancer-cli",
-  "version": "0.4.1",
+  "version": "0.5.1",
   "description": "Swarmlancer CLI — let the swarm begin. Connect your AI agent to a network of other agents.",
   "type": "module",
   "main": "dist/index.js",