@pi-unipi/unipi 3.0.0-alpha.38 → 3.0.0-alpha.39

package/CHANGELOG.md

@@ -6,6 +6,12 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
 ## [Unreleased]
 
+## [3.0.0-alpha.39] — 2026-10-11
+
+### Added
+- UniPi app: switch a session's working mode from the app. The app sees the current mode and changes it live (`none` returns to regular mode; another work mode is entered without a prompt). A mode switch is refused while another paused task already holds the park slot.
+- Long-horizon: new `unipi:lh-mode` runner used for that switch.
+
 ## [3.0.0-alpha.38] — 2026-10-11
 
 ### Fixed

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/unipi",
-  "version": "3.0.0-alpha.38",
+  "version": "3.0.0-alpha.39",
   "description": "All-in-one extension suite for Pi coding agent",
   "type": "module",
   "license": "MIT",
@@ -80,28 +80,28 @@
     "typebox": "^1.1.38"
   },
   "dependencies": {
-    "@pi-unipi/app-bridge": "3.0.0-alpha.38",
-    "@pi-unipi/ask-user": "3.0.0-alpha.38",
-    "@pi-unipi/background-tasks": "3.0.0-alpha.38",
-    "@pi-unipi/btw": "3.0.0-alpha.38",
-    "@pi-unipi/command-enchantment": "3.0.0-alpha.38",
-    "@pi-unipi/compactor": "3.0.0-alpha.38",
-    "@pi-unipi/core": "3.0.0-alpha.38",
-    "@pi-unipi/dream": "3.0.0-alpha.38",
-    "@pi-unipi/footer": "3.0.0-alpha.38",
-    "@pi-unipi/fusion": "3.0.0-alpha.38",
-    "@pi-unipi/info-screen": "3.0.0-alpha.38",
-    "@pi-unipi/input-shortcuts": "3.0.0-alpha.38",
-    "@pi-unipi/kanboard": "3.0.0-alpha.38",
-    "@pi-unipi/mcp": "3.0.0-alpha.38",
-    "@pi-unipi/memory": "3.0.0-alpha.38",
-    "@pi-unipi/notify": "3.0.0-alpha.38",
-    "@pi-unipi/skill-registry": "3.0.0-alpha.38",
-    "@pi-unipi/subagents": "3.0.0-alpha.38",
-    "@pi-unipi/updater": "3.0.0-alpha.38",
-    "@pi-unipi/utility": "3.0.0-alpha.38",
-    "@pi-unipi/web-api": "3.0.0-alpha.38",
-    "@pi-unipi/workflow": "3.0.0-alpha.38",
+    "@pi-unipi/app-bridge": "3.0.0-alpha.39",
+    "@pi-unipi/ask-user": "3.0.0-alpha.39",
+    "@pi-unipi/background-tasks": "3.0.0-alpha.39",
+    "@pi-unipi/btw": "3.0.0-alpha.39",
+    "@pi-unipi/command-enchantment": "3.0.0-alpha.39",
+    "@pi-unipi/compactor": "3.0.0-alpha.39",
+    "@pi-unipi/core": "3.0.0-alpha.39",
+    "@pi-unipi/dream": "3.0.0-alpha.39",
+    "@pi-unipi/footer": "3.0.0-alpha.39",
+    "@pi-unipi/fusion": "3.0.0-alpha.39",
+    "@pi-unipi/info-screen": "3.0.0-alpha.39",
+    "@pi-unipi/input-shortcuts": "3.0.0-alpha.39",
+    "@pi-unipi/kanboard": "3.0.0-alpha.39",
+    "@pi-unipi/mcp": "3.0.0-alpha.39",
+    "@pi-unipi/memory": "3.0.0-alpha.39",
+    "@pi-unipi/notify": "3.0.0-alpha.39",
+    "@pi-unipi/skill-registry": "3.0.0-alpha.39",
+    "@pi-unipi/subagents": "3.0.0-alpha.39",
+    "@pi-unipi/updater": "3.0.0-alpha.39",
+    "@pi-unipi/utility": "3.0.0-alpha.39",
+    "@pi-unipi/web-api": "3.0.0-alpha.39",
+    "@pi-unipi/workflow": "3.0.0-alpha.39",
     "@resvg/resvg-wasm": "^2.6.2",
     "beautiful-mermaid": "^1.1.3"
   },

package/packages/app-bridge/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/app-bridge",
-  "version": "3.0.0-alpha.38",
+  "version": "3.0.0-alpha.39",
   "description": "Live bridge between a pi TUI session and the UniPi phone app — streaming chat, prompts, steering and dialogs from the phone",
   "type": "module",
   "main": "index.ts",
@@ -31,7 +31,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@pi-unipi/core": "3.0.0-alpha.38"
+    "@pi-unipi/core": "3.0.0-alpha.39"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "^0.87.1",

package/packages/app-bridge/src/bridge.ts

@@ -24,6 +24,7 @@ import {
   type FusionPresetInfo,
   type FusionStatusInfo,
   type LhProgressInfo,
+  type LhModeInfo,
   type DreamDetailInfo,
   type DreamStatusInfo,
   type InMsg,
@@ -43,7 +44,7 @@ import { fileSuggestions } from "./files.js";
 import { statPaths } from "./paths.js";
 import { registerPath, resolveMedia } from "./media.js";
 import { listWorkItems, stopWorkItem, backgroundWorkItem, workLogPage } from "./work.js";
-import { bus, pendingWorkLabel, silenceCommandEcho, subscribePendingWork, UNIPI_EVENTS } from "@pi-unipi/core";
+import { bus, callCommandRunner, pendingWorkLabel, silenceCommandEcho, subscribePendingWork, UNIPI_EVENTS } from "@pi-unipi/core";
 import type { BtwListPage } from "./wire.js";
 
 /** `media_chunk.data` (base64) stays well under the 900 KiB bridge line
@@ -51,6 +52,15 @@ import type { BtwListPage } from "./wire.js";
 const MEDIA_CHUNK_CHARS = 700 * 1024;
 /** UNI-222: lh_progress pushes coalesce within this window (≤ 4/s). */
 export const LH_PROGRESS_COALESCE_MS = 250;
+/** UNI-269: the discovery record's `lhMode`/`lhPaused` (host → chat_list → list badge). */
+export function recordLhMode(state: LhModeInfo | undefined): { lhMode: string | null; lhPaused: string | null } {
+  const mode = typeof state?.mode === "string" && state.mode && state.mode !== "none" ? state.mode : null;
+  const paused = typeof state?.paused === "string" && state.paused && state.paused !== "none" && state.paused !== mode ? state.paused : null;
+  return { lhMode: mode, lhPaused: paused };
+}
+
+/** UNI-269: long-horizon's command runner behind `set_lh_mode` (packages/long-horizon/src/commands.ts). */
+export const LH_MODE_RUNNER = "unipi:lh-mode";
 /** UNI-118: dream_status pushes coalesce within this window. */
 export const DREAM_COALESCE_MS = 250;
 
@@ -645,6 +655,8 @@ export function createBridge(pi: ExtensionAPI, deps: BridgeDeps = defaultDeps) {
 
   // UNI-222: long-horizon progress (sticky LH_PROGRESS on the core bus).
   const lhProgress = (): LhProgressInfo | undefined => bus.get(UNIPI_EVENTS.LH_PROGRESS) as LhProgressInfo | undefined;
+  // UNI-269: the working mode (sticky LH_STATE — the footer's "Graph Mode").
+  const lhMode = (): LhModeInfo | undefined => bus.get(UNIPI_EVENTS.LH_STATE) as LhModeInfo | undefined;
 
   const hello = (): OutMsg => {
     const c = ctx!;
@@ -664,6 +676,7 @@ export function createBridge(pi: ExtensionAPI, deps: BridgeDeps = defaultDeps) {
       fusion: fusionPreset(),
       work: workItems(),
       ...(lhProgress() ? { lhProgress: lhProgress() } : {}),
+      ...(lhMode() ? { lhMode: lhMode() } : {}),
       ...(() => {
         const dream = dreamStatus();
         return dream ? { dream } : {};
@@ -751,6 +764,9 @@ export function createBridge(pi: ExtensionAPI, deps: BridgeDeps = defaultDeps) {
       // background subagent, a fusion handoff) — the host passes it into
       // chat_list so lists show "Working…" instead of idle/finished.
       pendingWork: currentPendingWork(),
+      // UNI-269: the working mode for the host's chat_list badge (null =
+      // regular / long-horizon not loaded); a parked owner's mode apart.
+      ...recordLhMode(lhMode()),
     };
     try {
       const file = join(dir, `${process.pid}.json`);
@@ -1516,6 +1532,23 @@ export function createBridge(pi: ExtensionAPI, deps: BridgeDeps = defaultDeps) {
       case "lh_progress_get":
         write(sock, { t: "lh_progress", progress: lhProgress(), ref: msg.ref });
         return;
+      case "set_lh_mode": {
+        // Through long-horizon's own runner (no hard dependency on the package).
+        try {
+          const out = await callCommandRunner<{ ok: boolean; reason?: string }>(LH_MODE_RUNNER, ctx, { mode: msg.mode });
+          if (!out.found) return fail("Long-horizon modes need a newer unipi on this PC.");
+          if (!out.result?.ok) return fail(out.result?.reason ?? "Could not switch the mode.");
+          ack();
+          // The runner's LH_STATE emit already queued a coalesced push; send
+          // the fresh value now too so the phone's chip settles at once.
+          lastLhMode = JSON.stringify(lhMode() ?? null);
+          writeRecord();
+          send({ t: "lh_mode", mode: lhMode() });
+        } catch (error) {
+          fail(error instanceof Error ? error.message : String(error));
+        }
+        return;
+      }
       case "dream_get":
         write(sock, { t: "dream_status", status: dreamStatus(), ref: msg.ref });
         return;
@@ -1791,6 +1824,23 @@ export function createBridge(pi: ExtensionAPI, deps: BridgeDeps = defaultDeps) {
     lhTimer.unref?.();
   });
 
+  // UNI-269: working-mode pushes, coalesced and only on a real change (the
+  // owner lifecycle re-publishes LH_STATE with the same payload often).
+  let lhModeTimer: ReturnType<typeof setTimeout> | undefined;
+  let lastLhMode = JSON.stringify(lhMode() ?? null);
+  bus.on(pi, UNIPI_EVENTS.LH_STATE, () => {
+    if (lhModeTimer) return;
+    lhModeTimer = setTimeout(() => {
+      lhModeTimer = undefined;
+      const now = JSON.stringify(lhMode() ?? null);
+      if (now === lastLhMode) return;
+      lastLhMode = now;
+      writeRecord();
+      send({ t: "lh_mode", mode: lhMode() });
+    }, LH_PROGRESS_COALESCE_MS);
+    lhModeTimer.unref?.();
+  });
+
   // UNI-118: Dream status pushes (run started/finished, proposal decided…),
   // coalesced. Subscribed lazily: the dream module may load after us.
   let dreamTimer: ReturnType<typeof setTimeout> | undefined;

package/packages/app-bridge/src/wire.ts

@@ -131,6 +131,20 @@ export type LhProgressInfo = {
   updatedAt: number;
 };
 
+/** UNI-269: the session's long-horizon working mode (`@pi-unipi/core`
+ *  LhStateEvent), relayed verbatim. `mode` = what the next turn runs in
+ *  (`none` = regular); `paused` = a parked owner's mode. */
+export type LhModeInfo = {
+  mode: string;
+  paused?: string;
+  owner?: { kind: string; status: "active" | "parked" };
+  lastStop?: { kind: string; at: number };
+};
+
+/** UNI-269: the modes `set_lh_mode` accepts. */
+export const LH_MODE_IDS = ["goal", "ralph", "swarm", "graph", "none"] as const;
+export type LhModeId = (typeof LH_MODE_IDS)[number];
+
 /** One row of the phone's "Running" section (UNI-160 §4): a background task,
  *  a subagent, or the Fusion sidekick, in one shape. */
 export interface WorkItemInfo {
@@ -231,6 +245,8 @@ export type OutMsg =
       work: WorkItemInfo[];
       /** UNI-222: the long-horizon progress snapshot at connect time; absent when long-horizon never published one. */
       lhProgress?: LhProgressInfo;
+      /** UNI-269: the working mode at connect time; absent when long-horizon isn't loaded. */
+      lhMode?: LhModeInfo;
       /** UNI-118: Dream status at connect time; absent when the dream module isn't loaded. */
       dream?: DreamStatusInfo;
     }
@@ -303,6 +319,8 @@ export type OutMsg =
    *  client, coalesced ≤ 4/s), or the reply to `lh_progress_get` (`ref`).
    *  `progress` undefined = long-horizon isn't loaded / never published. */
   | { t: "lh_progress"; progress: LhProgressInfo | undefined; ref?: string }
+  /** UNI-269: the working mode changed (pushed to every client, coalesced). */
+  | { t: "lh_mode"; mode: LhModeInfo | undefined }
   /** UNI-118: Dream status changed (pushed to every client, coalesced), or the
    *  reply to `dream_get` (`ref`). `status` undefined = the dream module isn't loaded. */
   | { t: "dream_status"; status: DreamStatusInfo | undefined; ref?: string }
@@ -437,6 +455,9 @@ export type InMsg =
   | { t: "work_background"; id: string; ref?: string }
   /** UNI-222: the current long-horizon progress snapshot; replies `lh_progress{progress, ref}`. */
   | { t: "lh_progress_get"; ref?: string }
+  /** UNI-269: switch the working mode (no prompt); `none` = /unipi:regular.
+   *  Replies `ack` (then an `lh_mode` push) or `error{message}`. */
+  | { t: "set_lh_mode"; mode: LhModeId; ref?: string }
   /** UNI-118: the current Dream status; replies `dream_status{status, ref}`. */
   | { t: "dream_get"; ref?: string }
   /** UNI-118: one run's report + trajectory; replies `dream_detail` (or `error`). */
@@ -480,6 +501,7 @@ const IN_TYPES = new Set([
   "work_rerun",
   "work_background",
   "lh_progress_get",
+  "set_lh_mode",
   "dream_get",
   "dream_detail",
   "dream_action",
@@ -613,6 +635,11 @@ export function parseIn(line: string): InMsg | { bad: string; ref?: string } | u
       return { t: "work_background", id: m.id, ref };
     case "lh_progress_get":
       return { t: "lh_progress_get", ref };
+    case "set_lh_mode":
+      if (typeof m.mode !== "string" || !(LH_MODE_IDS as readonly string[]).includes(m.mode)) {
+        return { bad: "set_lh_mode.mode must be goal|ralph|swarm|graph|none", ref };
+      }
+      return { t: "set_lh_mode", mode: m.mode as LhModeId, ref };
     case "dream_get":
       return { t: "dream_get", ref };
     case "dream_detail":

package/packages/ask-user/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/ask-user",
-  "version": "3.0.0-alpha.38",
+  "version": "3.0.0-alpha.39",
   "description": "Structured user input tool for Pi coding agent — single-select, multi-select, freeform",
   "type": "module",
   "main": "index.ts",
@@ -42,7 +42,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@pi-unipi/core": "3.0.0-alpha.38"
+    "@pi-unipi/core": "3.0.0-alpha.39"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "^0.87.1",

package/packages/autocomplete/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/command-enchantment",
-  "version": "3.0.0-alpha.38",
+  "version": "3.0.0-alpha.39",
   "description": "Enhanced TUI autocomplete for /unipi:* commands — colored, sorted, and grouped by package",
   "type": "module",
   "main": "src/index.ts",

package/packages/background-tasks/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/background-tasks",
-  "version": "3.0.0-alpha.38",
+  "version": "3.0.0-alpha.39",
   "description": "Background tasks for UniPi — durable shell jobs and delegated background agents with a footer dock",
   "type": "module",
   "main": "src/index.ts",
@@ -10,7 +10,7 @@
   },
   "dependencies": {
     "@earendil-works/pi-ai": "^0.87.1",
-    "@pi-unipi/core": "3.0.0-alpha.38",
+    "@pi-unipi/core": "3.0.0-alpha.39",
     "turndown": "^7.2.4"
   },
   "devDependencies": {

package/packages/btw/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/btw",
-  "version": "3.0.0-alpha.38",
+  "version": "3.0.0-alpha.39",
   "description": "A pi extension for parallel side conversations with /unipi:btw — part of the Unipi suite",
   "type": "module",
   "main": "extensions/btw.ts",
@@ -37,7 +37,7 @@
     "@earendil-works/pi-tui": "^0.87.1"
   },
   "dependencies": {
-    "@pi-unipi/core": "3.0.0-alpha.38"
+    "@pi-unipi/core": "3.0.0-alpha.39"
   },
   "pi": {
     "extensions": [

package/packages/compactor/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/compactor",
-  "version": "3.0.0-alpha.38",
+  "version": "3.0.0-alpha.39",
   "description": "Compaction for Pi — lossless zero-LLM or model summaries, rebuilt from full history, with session recall",
   "type": "module",
   "main": "src/index.ts",
@@ -33,8 +33,8 @@
     "access": "public"
   },
   "dependencies": {
-    "@pi-unipi/core": "3.0.0-alpha.38",
-    "@pi-unipi/info-screen": "3.0.0-alpha.38",
+    "@pi-unipi/core": "3.0.0-alpha.39",
+    "@pi-unipi/info-screen": "3.0.0-alpha.39",
     "@earendil-works/pi-agent-core": "^0.87.1"
   },
   "peerDependencies": {

package/packages/core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/core",
-  "version": "3.0.0-alpha.38",
+  "version": "3.0.0-alpha.39",
   "description": "Shared utilities, event types, and constants for Unipi extension suite",
   "type": "module",
   "license": "MIT",

package/packages/dream/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/dream",
-  "version": "3.0.0-alpha.38",
+  "version": "3.0.0-alpha.39",
   "description": "A pi extension that dreams: reviews past session struggles in the background, turns repeated false paths into memory lessons, and crafts skills from errors — part of the Unipi suite",
   "type": "module",
   "main": "extensions/dream.ts",
@@ -39,7 +39,7 @@
     "@earendil-works/pi-tui": "^0.87.1"
   },
   "dependencies": {
-    "@pi-unipi/core": "3.0.0-alpha.38"
+    "@pi-unipi/core": "3.0.0-alpha.39"
   },
   "pi": {
     "extensions": [

package/packages/footer/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/footer",
-  "version": "3.0.0-alpha.38",
+  "version": "3.0.0-alpha.39",
   "description": "Persistent status bar for Unipi — subscribes to UNIPI_EVENTS and renders key stats from all unipi packages",
   "type": "module",
   "main": "index.ts",
@@ -32,8 +32,8 @@
     "access": "public"
   },
   "dependencies": {
-    "@pi-unipi/core": "3.0.0-alpha.38",
-    "@pi-unipi/background-tasks": "3.0.0-alpha.38"
+    "@pi-unipi/core": "3.0.0-alpha.39",
+    "@pi-unipi/background-tasks": "3.0.0-alpha.39"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "^0.87.1",

package/packages/fusion/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/fusion",
-  "version": "3.0.0-alpha.38",
+  "version": "3.0.0-alpha.39",
   "description": "Devin-style model picker, fusion presets (lead + sidekick), and Local Fusion runtime for UniPi",
   "type": "module",
   "main": "src/index.ts",
@@ -32,9 +32,9 @@
     "access": "public"
   },
   "dependencies": {
-    "@pi-unipi/core": "3.0.0-alpha.38",
-    "@pi-unipi/subagents": "3.0.0-alpha.38",
-    "@pi-unipi/utility": "3.0.0-alpha.38"
+    "@pi-unipi/core": "3.0.0-alpha.39",
+    "@pi-unipi/subagents": "3.0.0-alpha.39",
+    "@pi-unipi/utility": "3.0.0-alpha.39"
   },
   "peerDependencies": {
     "@earendil-works/pi-ai": "^0.87.1",

package/packages/info-screen/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/info-screen",
-  "version": "3.0.0-alpha.38",
+  "version": "3.0.0-alpha.39",
   "description": "Unicrab startup splash and the /unipi:info dashboard — this session, context, usage, compaction savings",
   "type": "module",
   "main": "index.ts",
@@ -33,7 +33,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@pi-unipi/core": "3.0.0-alpha.38"
+    "@pi-unipi/core": "3.0.0-alpha.39"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "^0.87.1",

package/packages/input-shortcuts/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/input-shortcuts",
-  "version": "3.0.0-alpha.38",
+  "version": "3.0.0-alpha.39",
   "description": "Keyboard shortcuts for stash/restore, undo/redo, clipboard, and thinking toggle — chord-based overlay system",
   "type": "module",
   "main": "src/index.ts",
@@ -33,7 +33,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@pi-unipi/core": "3.0.0-alpha.38"
+    "@pi-unipi/core": "3.0.0-alpha.39"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "^0.87.1",

package/packages/kanboard/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/kanboard",
-  "version": "3.0.0-alpha.38",
+  "version": "3.0.0-alpha.39",
   "description": "Kanboard v3 — deferred-work board: CLI/daemon bridge, task runner and skill",
   "type": "module",
   "main": "index.ts",
@@ -31,7 +31,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@pi-unipi/core": "3.0.0-alpha.38"
+    "@pi-unipi/core": "3.0.0-alpha.39"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "^0.87.1",
@@ -48,10 +48,10 @@
     "themes": []
   },
   "optionalDependencies": {
-    "@pi-unipi/kanboard-linux-x64": "3.0.0-alpha.38",
-    "@pi-unipi/kanboard-linux-arm64": "3.0.0-alpha.38",
-    "@pi-unipi/kanboard-darwin-x64": "3.0.0-alpha.38",
-    "@pi-unipi/kanboard-darwin-arm64": "3.0.0-alpha.38",
-    "@pi-unipi/kanboard-win32-x64": "3.0.0-alpha.38"
+    "@pi-unipi/kanboard-linux-x64": "3.0.0-alpha.39",
+    "@pi-unipi/kanboard-linux-arm64": "3.0.0-alpha.39",
+    "@pi-unipi/kanboard-darwin-x64": "3.0.0-alpha.39",
+    "@pi-unipi/kanboard-darwin-arm64": "3.0.0-alpha.39",
+    "@pi-unipi/kanboard-win32-x64": "3.0.0-alpha.39"
   }
 }

package/packages/long-horizon/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/long-horizon",
-  "version": "3.0.0-alpha.38",
+  "version": "3.0.0-alpha.39",
   "description": "Long-horizon execution for Pi — mode-gated /goal /ralph /swarm /graph orchestration with a TypeSafe prompt judge",
   "type": "module",
   "main": "index.ts",
@@ -37,7 +37,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@pi-unipi/core": "3.0.0-alpha.38",
+    "@pi-unipi/core": "3.0.0-alpha.39",
     "@resvg/resvg-wasm": "^2.6.2",
     "beautiful-mermaid": "^1.1.3"
   },

package/packages/long-horizon/src/commands.ts

@@ -16,9 +16,9 @@
  */
 
 import type { ExtensionAPI, ExtensionCommandContext } from "@earendil-works/pi-coding-agent";
-import { bus, appendProgress, sendHarnessUserMessage, UNIPI_EVENTS, type ProgressData } from "@pi-unipi/core";
+import { bus, appendProgress, registerCommandRunner, sendHarnessUserMessage, UNIPI_EVENTS, type ProgressData } from "@pi-unipi/core";
 import type { LhMode, OwnerKind } from "./modes.js";
-import { MODE_REGISTRY } from "./modes.js";
+import { isLhMode, MODE_REGISTRY, modeForOwnerKind } from "./modes.js";
 import type { Gate } from "./gate.js";
 import type { OwnerCoordinator } from "./owner.js";
 import type { RalphLoop } from "./engine/ralph.js";
@@ -324,4 +324,59 @@ export function registerLongHorizonCommands(
     },
   });
 
+  // UNI-269: the app's mode chip (app-bridge `set_lh_mode`) — switch the
+  // session's working mode without sending a prompt.
+  registerCommandRunner(LH_MODE_RUNNER, async (_ctx, args) =>
+    selectSessionMode(gate, owner, String((args as { mode?: unknown } | undefined)?.mode ?? ""), stopActiveOwnerFor, machine),
+  );
+}
+
+/** Runner name the app bridge calls for `set_lh_mode` (UNI-269). */
+export const LH_MODE_RUNNER = "unipi:lh-mode";
+
+export type SelectModeResult = { ok: true; mode: LhMode } | { ok: false; reason: string };
+
+/**
+ * UNI-269: pick the session's working mode from outside the TUI (the app's
+ * mode chip), with no prompt. Mirrors the slash commands:
+ *  - `none` = /unipi:regular: ends the active owner (terminal) and pins
+ *    regular mode.
+ *  - a work mode = /unipi:<mode> minus the prompt: an active owner of
+ *    another mode is parked first (refused when the park slot is held),
+ *    then the mode is sticky for the next turns and shows at once.
+ *  - the active owner's own mode is a no-op.
+ */
+export function selectSessionMode(
+  gate: Gate,
+  owner: OwnerCoordinator,
+  mode: string,
+  stopActive: () => string | undefined,
+  machine?: GoalMachine,
+): SelectModeResult {
+  if (!isLhMode(mode)) return { ok: false, reason: `unknown mode "${mode}"` };
+  if (mode === "none") {
+    stopActive();
+    gate.setSessionMode("none");
+    return { ok: true, mode };
+  }
+  const active = owner.getActive();
+  if (active && modeForOwnerKind(active.kind) === mode) return { ok: true, mode };
+  if (active) {
+    // Same as the gate's suspend-and-switch hook: a goal pauses with its owner.
+    if (active.kind === "goal") machine?.pause("paused(superseded)");
+    const reason = `paused(superseded_by:${mode})`;
+    const suspended = owner.suspend(reason);
+    if (!suspended) {
+      const parked = owner.getParked();
+      return {
+        ok: false,
+        reason: parked
+          ? `A ${parked.kind === "ralph-loop" ? "ralph loop" : parked.kind} ("${parked.label}") is already parked — resume or clear it first.`
+          : "The running work could not be parked.",
+      };
+    }
+    bus.emit(UNIPI_EVENTS.LONG_HORIZON_OWNER_CHANGED, { event: "suspended", ownerId: suspended.ownerId, reason });
+  }
+  gate.selectMode(mode);
+  return { ok: true, mode };
 }

package/packages/long-horizon/src/gate.ts

@@ -197,6 +197,16 @@ export class Gate {
     if (this.pi) syncModeTools(this.pi, mode);
   }
 
+  /** UNI-269: the app's mode chip picked a work mode with no prompt. Same
+   *  sticky override as setExplicit (the next turn resolves to it, badge and
+   *  all), but the display flips NOW so the footer and the app's chip show
+   *  the pick before any turn runs. */
+  selectMode(mode: LhMode): void {
+    this.setExplicit(mode);
+    this.display = mode;
+    this.deps.onDisplayChanged?.();
+  }
+
   /** Pin the session to a mode (/unipi:regular, goal stop): every later turn resolves to it. */
   setSessionMode(mode: LhMode): void {
     this.sessionOverride = mode;

package/packages/mcp/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/mcp",
-  "version": "3.0.0-alpha.38",
+  "version": "3.0.0-alpha.39",
   "description": "MCP server management extension for Pi coding agent — browse, add, configure, and use MCP servers",
   "type": "module",
   "main": "src/index.ts",
@@ -30,7 +30,7 @@
     "test": "npx tsx --test tests/**/*.test.ts"
   },
   "dependencies": {
-    "@pi-unipi/core": "3.0.0-alpha.38"
+    "@pi-unipi/core": "3.0.0-alpha.39"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "^0.87.1",

package/packages/memory/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/memory",
-  "version": "3.0.0-alpha.38",
+  "version": "3.0.0-alpha.39",
   "description": "Persistent cross-session memory on MemPalace (auto-installed): daemon-routed writes, shared palace with other agents, for Pi coding agent",
   "type": "module",
   "main": "index.ts",
@@ -44,8 +44,8 @@
     "README.md"
   ],
   "dependencies": {
-    "@pi-unipi/core": "3.0.0-alpha.38",
-    "@pi-unipi/info-screen": "3.0.0-alpha.38",
+    "@pi-unipi/core": "3.0.0-alpha.39",
+    "@pi-unipi/info-screen": "3.0.0-alpha.39",
     "js-yaml": "^4.1.0"
   },
   "peerDependencies": {

package/packages/notify/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/notify",
-  "version": "3.0.0-alpha.38",
+  "version": "3.0.0-alpha.39",
   "description": "Cross-platform notification extension for Pi — native OS, Gotify, and Telegram notifications for agent lifecycle events",
   "type": "module",
   "main": "index.ts",
@@ -34,7 +34,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@pi-unipi/core": "3.0.0-alpha.38",
+    "@pi-unipi/core": "3.0.0-alpha.39",
     "node-notifier": "^10.0.1"
   },
   "peerDependencies": {

package/packages/skill-registry/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/skill-registry",
-  "version": "3.0.0-alpha.38",
+  "version": "3.0.0-alpha.39",
   "description": "Skill registry for pi — per-project skill on/off, a skill vault, and jev-judged skill exposure",
   "type": "module",
   "license": "MIT",
@@ -33,7 +33,7 @@
   },
   "main": "index.ts",
   "dependencies": {
-    "@pi-unipi/core": "3.0.0-alpha.38"
+    "@pi-unipi/core": "3.0.0-alpha.39"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "^0.87.1",

package/packages/subagents/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/subagents",
-  "version": "3.0.0-alpha.38",
+  "version": "3.0.0-alpha.39",
   "description": "Subagents for UniPi — Devin-model independent child agents",
   "type": "module",
   "main": "src/index.ts",
@@ -9,8 +9,8 @@
     "test": "npx tsx --test src/__tests__/*.test.ts"
   },
   "dependencies": {
-    "@pi-unipi/core": "3.0.0-alpha.38",
-    "@pi-unipi/utility": "3.0.0-alpha.38",
+    "@pi-unipi/core": "3.0.0-alpha.39",
+    "@pi-unipi/utility": "3.0.0-alpha.39",
     "@earendil-works/pi-agent-core": "^0.87.1",
     "acorn": "8.18.0"
   },

package/packages/unipi/bundled.js

@@ -16863,6 +16863,15 @@ var Gate = class {
     this.sessionOverride = mode;
     if (this.pi) syncModeTools(this.pi, mode);
   }
+  /** UNI-269: the app's mode chip picked a work mode with no prompt. Same
+   *  sticky override as setExplicit (the next turn resolves to it, badge and
+   *  all), but the display flips NOW so the footer and the app's chip show
+   *  the pick before any turn runs. */
+  selectMode(mode) {
+    this.setExplicit(mode);
+    this.display = mode;
+    this.deps.onDisplayChanged?.();
+  }
   /** Pin the session to a mode (/unipi:regular, goal stop): every later turn resolves to it. */
   setSessionMode(mode) {
     this.sessionOverride = mode;
@@ -17264,6 +17273,36 @@ Settings: ~/.pi/agent/settings.json \u2192 unipi.longHorizon`
       notify(ctx, "Regular mode.");
     }
   });
+  registerCommandRunner(
+    LH_MODE_RUNNER,
+    async (_ctx, args) => selectSessionMode(gate, owner, String(args?.mode ?? ""), stopActiveOwnerFor, machine)
+  );
+}
+var LH_MODE_RUNNER = "unipi:lh-mode";
+function selectSessionMode(gate, owner, mode, stopActive, machine) {
+  if (!isLhMode(mode)) return { ok: false, reason: `unknown mode "${mode}"` };
+  if (mode === "none") {
+    stopActive();
+    gate.setSessionMode("none");
+    return { ok: true, mode };
+  }
+  const active = owner.getActive();
+  if (active && modeForOwnerKind(active.kind) === mode) return { ok: true, mode };
+  if (active) {
+    if (active.kind === "goal") machine?.pause("paused(superseded)");
+    const reason = `paused(superseded_by:${mode})`;
+    const suspended = owner.suspend(reason);
+    if (!suspended) {
+      const parked = owner.getParked();
+      return {
+        ok: false,
+        reason: parked ? `A ${parked.kind === "ralph-loop" ? "ralph loop" : parked.kind} ("${parked.label}") is already parked \u2014 resume or clear it first.` : "The running work could not be parked."
+      };
+    }
+    bus.emit(UNIPI_EVENTS.LONG_HORIZON_OWNER_CHANGED, { event: "suspended", ownerId: suspended.ownerId, reason });
+  }
+  gate.selectMode(mode);
+  return { ok: true, mode };
 }
 
 // packages/long-horizon/src/engine/goal-state.ts
@@ -57602,6 +57641,7 @@ function historyPage(branch, before, budget = ENTRIES_BUDGET) {
 
 // packages/app-bridge/src/wire.ts
 var BRIDGE_PROTOCOL = 1;
+var LH_MODE_IDS = ["goal", "ralph", "swarm", "graph", "none"];
 var IN_TYPES = /* @__PURE__ */ new Set([
   "prompt",
   "abort",
@@ -57636,6 +57676,7 @@ var IN_TYPES = /* @__PURE__ */ new Set([
   "work_rerun",
   "work_background",
   "lh_progress_get",
+  "set_lh_mode",
   "dream_get",
   "dream_detail",
   "dream_action"
@@ -57763,6 +57804,11 @@ function parseIn(line) {
       return { t: "work_background", id: m.id, ref };
     case "lh_progress_get":
       return { t: "lh_progress_get", ref };
+    case "set_lh_mode":
+      if (typeof m.mode !== "string" || !LH_MODE_IDS.includes(m.mode)) {
+        return { bad: "set_lh_mode.mode must be goal|ralph|swarm|graph|none", ref };
+      }
+      return { t: "set_lh_mode", mode: m.mode, ref };
     case "dream_get":
       return { t: "dream_get", ref };
     case "dream_detail":
@@ -58122,6 +58168,12 @@ init_core();
 init_core();
 var MEDIA_CHUNK_CHARS = 700 * 1024;
 var LH_PROGRESS_COALESCE_MS = 250;
+function recordLhMode(state2) {
+  const mode = typeof state2?.mode === "string" && state2.mode && state2.mode !== "none" ? state2.mode : null;
+  const paused = typeof state2?.paused === "string" && state2.paused && state2.paused !== "none" && state2.paused !== mode ? state2.paused : null;
+  return { lhMode: mode, lhPaused: paused };
+}
+var LH_MODE_RUNNER2 = "unipi:lh-mode";
 var DREAM_COALESCE_MS = 250;
 var DREAM_API_KEY2 = /* @__PURE__ */ Symbol.for("unipi.dream.api");
 var getDreamApi = () => globalThis[DREAM_API_KEY2];
@@ -58498,6 +58550,7 @@ function createBridge(pi, deps = defaultDeps2) {
     }
   };
   const lhProgress = () => bus.get(UNIPI_EVENTS.LH_PROGRESS);
+  const lhMode = () => bus.get(UNIPI_EVENTS.LH_STATE);
   const hello = () => {
     const c2 = ctx;
     const rest = {
@@ -58516,6 +58569,7 @@ function createBridge(pi, deps = defaultDeps2) {
       fusion: fusionPreset(),
       work: workItems(),
       ...lhProgress() ? { lhProgress: lhProgress() } : {},
+      ...lhMode() ? { lhMode: lhMode() } : {},
       ...(() => {
         const dream = dreamStatus();
         return dream ? { dream } : {};
@@ -58591,7 +58645,10 @@ function createBridge(pi, deps = defaultDeps2) {
       // UNI-221: wake-capable work still pending (bg task with a wake, a
       // background subagent, a fusion handoff) — the host passes it into
       // chat_list so lists show "Working…" instead of idle/finished.
-      pendingWork: currentPendingWork()
+      pendingWork: currentPendingWork(),
+      // UNI-269: the working mode for the host's chat_list badge (null =
+      // regular / long-horizon not loaded); a parked owner's mode apart.
+      ...recordLhMode(lhMode())
     };
     try {
       const file = join89(dir, `${process.pid}.json`);
@@ -59208,6 +59265,20 @@ function createBridge(pi, deps = defaultDeps2) {
       case "lh_progress_get":
         write(sock, { t: "lh_progress", progress: lhProgress(), ref: msg.ref });
         return;
+      case "set_lh_mode": {
+        try {
+          const out = await callCommandRunner(LH_MODE_RUNNER2, ctx, { mode: msg.mode });
+          if (!out.found) return fail("Long-horizon modes need a newer unipi on this PC.");
+          if (!out.result?.ok) return fail(out.result?.reason ?? "Could not switch the mode.");
+          ack();
+          lastLhMode = JSON.stringify(lhMode() ?? null);
+          writeRecord();
+          send({ t: "lh_mode", mode: lhMode() });
+        } catch (error) {
+          fail(error instanceof Error ? error.message : String(error));
+        }
+        return;
+      }
       case "dream_get":
         write(sock, { t: "dream_status", status: dreamStatus(), ref: msg.ref });
         return;
@@ -59426,6 +59497,20 @@ function createBridge(pi, deps = defaultDeps2) {
     }, LH_PROGRESS_COALESCE_MS);
     lhTimer.unref?.();
   });
+  let lhModeTimer;
+  let lastLhMode = JSON.stringify(lhMode() ?? null);
+  bus.on(pi, UNIPI_EVENTS.LH_STATE, () => {
+    if (lhModeTimer) return;
+    lhModeTimer = setTimeout(() => {
+      lhModeTimer = void 0;
+      const now2 = JSON.stringify(lhMode() ?? null);
+      if (now2 === lastLhMode) return;
+      lastLhMode = now2;
+      writeRecord();
+      send({ t: "lh_mode", mode: lhMode() });
+    }, LH_PROGRESS_COALESCE_MS);
+    lhModeTimer.unref?.();
+  });
   let dreamTimer;
   let unsubDream;
   let lastDream = "";

package/packages/updater/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/updater",
-  "version": "3.0.0-alpha.38",
+  "version": "3.0.0-alpha.39",
   "description": "Auto-updater, changelog browser, and readme browser for Unipi — checks npm registry, renders CHANGELOG.md and README.md files in TUI overlays",
   "type": "module",
   "main": "index.ts",
@@ -34,7 +34,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@pi-unipi/core": "3.0.0-alpha.38"
+    "@pi-unipi/core": "3.0.0-alpha.39"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "^0.87.1",

package/packages/utility/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/utility",
-  "version": "3.0.0-alpha.38",
+  "version": "3.0.0-alpha.39",
   "description": "Utility commands and tools for Pi coding agent — lifecycle, diagnostics, cache, analytics, display, batch execution",
   "type": "module",
   "main": "src/index.ts",
@@ -36,7 +36,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@pi-unipi/core": "3.0.0-alpha.38"
+    "@pi-unipi/core": "3.0.0-alpha.39"
   },
   "devDependencies": {},
   "peerDependencies": {

package/packages/watchdog/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/watchdog",
-  "version": "3.0.0-alpha.38",
+  "version": "3.0.0-alpha.39",
   "description": "Jev watchdog for long-running tool calls and background tasks — judges stuck work via TypeSafe System One and kills or warns",
   "type": "module",
   "main": "index.ts",
@@ -32,8 +32,8 @@
     "access": "public"
   },
   "dependencies": {
-    "@pi-unipi/background-tasks": "3.0.0-alpha.38",
-    "@pi-unipi/core": "3.0.0-alpha.38"
+    "@pi-unipi/background-tasks": "3.0.0-alpha.39",
+    "@pi-unipi/core": "3.0.0-alpha.39"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "^0.87.1",

package/packages/web-api/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/web-api",
-  "version": "3.0.0-alpha.38",
+  "version": "3.0.0-alpha.39",
   "description": "Web search, read, and summarize tools with provider-based backend selection for Pi coding agent",
   "type": "module",
   "main": "src/index.ts",
@@ -31,7 +31,7 @@
     "README.md"
   ],
   "dependencies": {
-    "@pi-unipi/core": "3.0.0-alpha.38",
+    "@pi-unipi/core": "3.0.0-alpha.39",
     "defuddle": "^0.18.1",
     "linkedom": "^0.18.12",
     "wreq-js": "^2.3.0"

package/packages/workflow/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/workflow",
-  "version": "3.0.0-alpha.38",
+  "version": "3.0.0-alpha.39",
   "description": "Plan mode and permission modes for the Pi coding agent",
   "type": "module",
   "main": "index.ts",
@@ -27,7 +27,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@pi-unipi/core": "3.0.0-alpha.38"
+    "@pi-unipi/core": "3.0.0-alpha.39"
   },
   "peerDependencies": {
     "@earendil-works/pi-ai": "^0.87.1",