@pi-unipi/unipi 0.1.17 → 0.1.18

package/README.md

@@ -9,39 +9,39 @@ pi install npm:@pi-unipi/unipi
 
 ## What You Get
 
-**Workflow** — 20 commands that take ideas to shipped code. Brainstorm, plan, execute in worktrees, review, consolidate. The agent follows skill files step by step.
+**[Workflow](./packages/workflow/README.md)** — 20 commands that take ideas to shipped code. Brainstorm, plan, execute in worktrees, review, consolidate. The agent follows skill files step by step.
 
-**Ralph** — Long-running loops that persist across sessions. Start a task, iterate through checklist items, resume after crashes. Progress tracked, state saved.
+**[Ralph](./packages/ralph/README.md)** — Long-running loops that persist across sessions. Start a task, iterate through checklist items, resume after crashes. Progress tracked, state saved.
 
-**Memory** — SQLite + vector search stores facts, preferences, and decisions. Project-scoped and global. The agent remembers what you told it last week.
+**[Memory](./packages/memory/README.md)** — SQLite + vector search stores facts, preferences, and decisions. Project-scoped and global. The agent remembers what you told it last week.
 
-**Compactor** — Zero-LLM context engine. 6-stage pipeline hits 95%+ token reduction at zero API cost. Session continuity, sandbox execution, FTS5 search.
+**[Compactor](./packages/compactor/README.md)** — Zero-LLM context engine. 6-stage pipeline hits 95%+ token reduction at zero API cost. Session continuity, sandbox execution, FTS5 search.
 
-**Subagents** — Parallel execution with file locking. Spawn background agents to research, fix, or build while the main agent keeps going.
+**[Subagents](./packages/subagents/README.md)** — Parallel execution with file locking. Spawn background agents to research, fix, or build while the main agent keeps going.
 
-**Web API** — Web search, page reading, content summarization. Smart-fetch engine with browser-grade TLS fingerprinting — free, no API key. Paid providers as fallbacks.
+**[Web API](./packages/web-api/README.md)** — Web search, page reading, content summarization. Smart-fetch engine with browser-grade TLS fingerprinting — free, no API key. Paid providers as fallbacks.
 
-**MCP** — Browse 7,800+ MCP servers, add them interactively. Tools from servers register automatically as Pi tools.
+**[MCP](./packages/mcp/README.md)** — Browse 7,800+ MCP servers, add them interactively. Tools from servers register automatically as Pi tools.
 
-**Notify** — Push notifications to native OS, Gotify, Telegram, or ntfy. Per-event platform routing. Configure once, get alerts everywhere.
+**[Notify](./packages/notify/README.md)** — Push notifications to native OS, Gotify, Telegram, or ntfy. Per-event platform routing. Configure once, get alerts everywhere.
 
-**Footer** — Persistent status bar showing live stats from every package. Responsive layout, presets, per-segment toggling.
+**[Footer](./packages/footer/README.md)** — Persistent status bar showing live stats from every package. Responsive layout, presets, per-segment toggling.
 
-**BTW** — Side conversations that run in parallel. Ask questions without interrupting the main agent.
+**[BTW](./packages/btw/README.md)** — Side conversations that run in parallel. Ask questions without interrupting the main agent.
 
-**Ask User** — Structured input for decision gates. Single-select, multi-select, freeform. The agent asks instead of guessing.
+**[Ask User](./packages/ask-user/README.md)** — Structured input for decision gates. Single-select, multi-select, freeform. The agent asks instead of guessing.
 
-**Milestone** — Track project goals across workflow cycles. MILESTONES.md stays in sync with specs, plans, and completed work.
+**[Milestone](./packages/milestone/README.md)** — Track project goals across workflow cycles. MILESTONES.md stays in sync with specs, plans, and completed work.
 
-**Kanboard** — Web UI and TUI overlay for kanban boards. Parses all workflow documents into cards with progress indicators.
+**[Kanboard](./packages/kanboard/README.md)** — Web UI and TUI overlay for kanban boards. Parses all workflow documents into cards with progress indicators.
 
-**Info Screen** — Dashboard overlay showing module status, tools, and custom data groups.
+**[Info Screen](./packages/info-screen/README.md)** — Dashboard overlay showing module status, tools, and custom data groups.
 
-**Utility** — Environment info, diagnostics, cleanup, name badge, and Shiki-powered diff rendering.
+**[Utility](./packages/utility/README.md)** — Environment info, diagnostics, cleanup, name badge, and Shiki-powered diff rendering.
 
-**Updater** — Checks npm for new versions on session start. Changelog browser and readme browser in TUI overlays.
+**[Updater](./packages/updater/README.md)** — Checks npm for new versions on session start. Changelog browser and readme browser in TUI overlays.
 
-**Input Shortcuts** — Keyboard shortcuts via vim-style chord overlay. Stash/restore, undo/redo, clipboard, thinking toggle.
+**[Input Shortcuts](./packages/input-shortcuts/README.md)** — Keyboard shortcuts via vim-style chord overlay. Stash/restore, undo/redo, clipboard, thinking toggle.
 
 ## Architecture
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/unipi",
-  "version": "0.1.17",
+  "version": "0.1.18",
   "description": "All-in-one extension suite for Pi coding agent",
   "type": "module",
   "license": "MIT",

package/packages/ask-user/ask-ui.ts

@@ -638,7 +638,24 @@ export function createRenderResult() {
           0,
           0,
         );
-      case "new_session":
+      case "new_session": {
+        const launchedWith = (response as any).launchedWith;
+        if (launchedWith === "compact") {
+          return new Text(
+            theme.fg("success", "✓ compacted → ") +
+              theme.fg("accent", response.prefill || ""),
+            0,
+            0,
+          );
+        }
+        if (launchedWith === "direct") {
+          return new Text(
+            theme.fg("success", "✓ running → ") +
+              theme.fg("accent", response.prefill || ""),
+            0,
+            0,
+          );
+        }
         return new Text(
           theme.fg("success", "✓ ") +
             theme.fg("muted", "new session") +
@@ -646,6 +663,7 @@ export function createRenderResult() {
           0,
           0,
         );
+      }
       default:
         return new Text(
           theme.fg("text", JSON.stringify(response)),

package/packages/ask-user/launcher-ui.ts

@@ -0,0 +1,142 @@
+/**
+ * @pi-unipi/ask-user — Session Launcher TUI
+ *
+ * Secondary overlay shown when user selects a new_session option.
+ * Offers Compact & run, Run directly, or Cancel.
+ */
+
+import { Key, matchesKey, truncateToWidth, visibleWidth } from "@mariozechner/pi-tui";
+import type { SessionLauncherResult } from "./types.js";
+
+/** Launcher option definition */
+interface LauncherOption {
+  label: string;
+  icon: string;
+  action: SessionLauncherResult["action"];
+}
+
+const OPTIONS: LauncherOption[] = [
+  { label: "Compact & run", icon: "🧹", action: "compact" },
+  { label: "Run directly", icon: "▶", action: "direct" },
+  { label: "Cancel", icon: "✕", action: "cancel" },
+];
+
+/**
+ * Render the session launcher UI.
+ *
+ * Simple single-select picker with 3 fixed options.
+ * No editor, no timeout, no multi-select.
+ */
+export function renderLauncherUI(params: {
+  prefill: string;
+}): (
+  tui: any,
+  theme: any,
+  kb: any,
+  done: (result: SessionLauncherResult | null) => void,
+) => {
+  render: (width: number) => string[];
+  invalidate: () => void;
+  handleInput: (data: string) => void;
+} {
+  return (_tui, theme, _kb, done) => {
+    const { prefill } = params;
+
+    // State
+    let optionIndex = 0;
+    let cachedLines: string[] | undefined;
+
+    function refresh() {
+      cachedLines = undefined;
+      _tui.requestRender();
+    }
+
+    function handleInput(data: string) {
+      // Navigation
+      if (matchesKey(data, Key.up)) {
+        optionIndex = Math.max(0, optionIndex - 1);
+        refresh();
+        return;
+      }
+      if (matchesKey(data, Key.down)) {
+        optionIndex = Math.min(OPTIONS.length - 1, optionIndex + 1);
+        refresh();
+        return;
+      }
+
+      // Enter: select
+      if (matchesKey(data, Key.enter)) {
+        const opt = OPTIONS[optionIndex];
+        done({ action: opt.action, prefill });
+        return;
+      }
+
+      // Escape: cancel
+      if (matchesKey(data, Key.escape)) {
+        done(null);
+        return;
+      }
+    }
+
+    function render(width: number): string[] {
+      if (cachedLines) return cachedLines;
+
+      const lines: string[] = [];
+      const innerWidth = Math.max(40, width - 2);
+      const border = (s: string) => theme.fg("accent", s);
+
+      function padVisible(content: string, targetWidth: number): string {
+        const vw = visibleWidth(content);
+        const pad = Math.max(0, targetWidth - vw);
+        return content + " ".repeat(pad);
+      }
+
+      const add = (s: string) =>
+        lines.push(
+          border("│") +
+            padVisible(truncateToWidth(s, innerWidth), innerWidth) +
+            border("│"),
+        );
+      const addEmpty = () =>
+        lines.push(border("│") + " ".repeat(innerWidth) + border("│"));
+
+      // Top border
+      lines.push(border(`╭${"─".repeat(innerWidth)}╮`));
+
+      // Header: show prefill command (truncated)
+      const headerPrefix = " 🚀 ";
+      const maxPrefillWidth = innerWidth - headerPrefix.length - 1;
+      const truncatedPrefill = truncateToWidth(prefill || "(no command)", maxPrefillWidth);
+      add(theme.fg("accent", headerPrefix) + theme.fg("text", truncatedPrefill));
+      addEmpty();
+
+      // Options
+      for (let i = 0; i < OPTIONS.length; i++) {
+        const opt = OPTIONS[i];
+        const isSelected = i === optionIndex;
+        const prefix = isSelected ? theme.fg("accent", "> ") : "  ";
+        const label = `${opt.icon} ${opt.label}`;
+        const color = isSelected ? "accent" : "text";
+        add(prefix + theme.fg(color, label));
+      }
+
+      // Footer hint
+      addEmpty();
+      add(theme.fg("dim", " ↑↓ navigate • Enter select • Esc cancel"));
+
+      // Bottom border
+      lines.push(border(`╰${"─".repeat(innerWidth)}╯`));
+
+      cachedLines = lines;
+      return lines;
+    }
+
+    return {
+      render,
+      invalidate: () => {
+        cachedLines = undefined;
+      },
+      handleInput,
+    };
+  };
+}

package/packages/ask-user/skills/ask-user/SKILL.md

@@ -56,7 +56,7 @@ Use the `ask_user` tool to collect structured input from the user.
 | `"select"` | Normal selection (default). Returns immediately. |
 | `"input"` | Enters text input mode. Returns `combined` response with selection + text. |
 | `"end_turn"` | Signals end of agent turn. Returns `end_turn` response kind. |
-| `"new_session"` | Starts a new session. Returns `new_session` response kind with optional `prefill`. |
+| `"new_session"` | Starts a new session. Returns `new_session` response kind with optional `prefill`. Shows a launcher overlay offering **Compact & run** (compacts context first) or **Run directly**. |
 
 ## Examples
 
@@ -150,3 +150,15 @@ ask_user({
 - "I want changes" enters text input mode for the user to explain
 - "Done for now" signals the agent to end its turn
 - "Start fresh" starts a new session with the prefill message
+
+## Session Launcher
+
+When a user selects a `new_session` option, a secondary launcher overlay appears with three choices:
+
+| Choice | Behavior |
+|--------|----------|
+| 🧹 Compact & run | Compacts current context (via `ctx.compact()`), then returns the prefill command to the LLM |
+| ▶ Run directly | Returns the prefill command to the LLM without compaction |
+| ✕ Cancel | Cancels the session launch |
+
+This two-step flow lets the user manage context window usage before starting a new task.

package/packages/ask-user/tools.ts

@@ -11,8 +11,9 @@ import {
   UNIPI_EVENTS,
   emitEvent,
 } from "@pi-unipi/core";
-import type { NormalizedOption, AskUserResponse } from "./types.js";
+import type { NormalizedOption, AskUserResponse, SessionLauncherResult } from "./types.js";
 import { renderAskUI, createRenderCall, createRenderResult } from "./ask-ui.js";
+import { renderLauncherUI } from "./launcher-ui.js";
 import { getAskUserSettings } from "./config.js";
 
 /**
@@ -331,6 +332,57 @@ export function registerAskUserTools(pi: ExtensionAPI): void {
           contentText = "No response";
       }
 
+      // Session launcher intercept: when user selects new_session, offer compact/direct/cancel
+      if (response.kind === "new_session") {
+        const prefill = response.prefill || "";
+        const launcherResult = await ctx.ui.custom<SessionLauncherResult | null>(
+          renderLauncherUI({ prefill }),
+        );
+
+        if (!launcherResult || launcherResult.action === "cancel") {
+          return {
+            content: [{ type: "text", text: "User cancelled the session launch" }],
+            details: {
+              question,
+              options: normalizedOptions.map((o) => o.label),
+              response: {
+                kind: "cancelled",
+                comment: "Session launcher cancelled",
+              } as AskUserResponse,
+            },
+          };
+        }
+
+        if (launcherResult.action === "compact") {
+          try {
+            await new Promise<void>((resolve, reject) => {
+              ctx.compact({
+                customInstructions: `Preparing for new task. Summarize previous work concisely, preserving only what's essential for: ${prefill}`,
+                onComplete: () => resolve(),
+                onError: (err) => reject(err),
+              });
+            });
+          } catch (err) {
+            // Compaction failure shouldn't block the session launch — continue anyway
+          }
+        }
+
+        const actionLabel = launcherResult.action === "compact" ? "compacted" : "running";
+        contentText = `User chose to proceed (${actionLabel}): ${prefill}`;
+
+        return {
+          content: [{ type: "text", text: contentText }],
+          details: {
+            question,
+            options: normalizedOptions.map((o) => o.label),
+            response: {
+              ...response,
+              launchedWith: launcherResult.action,
+            },
+          },
+        };
+      }
+
       return {
         content: [{ type: "text", text: contentText }],
         details: {

package/packages/ask-user/types.ts

@@ -54,6 +54,12 @@ export interface AskUserResponse {
   comment?: string;
 }
 
+/** Result from the session launcher UI */
+export interface SessionLauncherResult {
+  action: "compact" | "direct" | "cancel";
+  prefill: string;
+}
+
 /** Normalized option with resolved value */
 export interface NormalizedOption {
   label: string;