@pi-unipi/unipi 3.0.0-alpha.41 → 3.0.0-alpha.43

package/CHANGELOG.md

@@ -6,6 +6,26 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
 ## [Unreleased]
 
+## [3.0.0-alpha.43] — 2026-10-16
+
+### Added
+- Cron: scheduled, unattended pi runs on your PC, run by the UniPi host (needs UniPi host 0.5.1). `skill:cron` sets jobs up from a plain request ("every weekday at 18:30 summarize my inbox"), with plain-language schedules, per-job notifications (ntfy, Gotify, Telegram) and an optional wake-up message to the session that set it. `/unipi:cron` lists jobs, their runs and results, and runs, stops, enables or pauses them. Cron settings are in `/unipi:settings`. (UNI-288, UNI-314–318)
+- `/skill:craft-skill` and `/skill:web` are listed as normal skills. (UNI-307)
+
+### Fixed
+- The UniPi app now gets argument suggestions for every extension's commands (e.g. `/usage `), not only UniPi's own. (UNI-304)
+- The app's model list stayed partial (only openrouter) when a provider such as OmniRoute registered after the app connected; the list is now pushed again when it changes.
+- Removing a steered message from the app no longer stops the run. (UNI-305)
+- `/reload` from the app reloads pi instead of being sent as a message. (UNI-308)
+
+## [3.0.0-alpha.42] — 2026-10-16
+
+### Added
+- `skill:browser`: the agent uses the PC's browser, the one you see in the UniPi app, with `agent-browser`. While the browser is on, UniPi points agent-browser at it (`AGENT_BROWSER_CDP`), so `agent-browser open <url>` just works, with no start or connect step. The browser is CloakBrowser, a stealthy Chromium shown only in the app; the agent's clicks and typing look human, and you can take over. Needs UniPi host 0.5.0. (UNI-295, UNI-303)
+- The agent sees `skill:browser` and a one-line note only while the PC's browser is on. Turning it off hides both from the next prompt, and `/skill:browser` explains how to turn it on. Any skill can now be shown only when a condition holds (`registerSkillCondition`). (UNI-300)
+- The work tray has a hint again: while it has items, one dim line under the input reads, for example, "Background tasks 1 running · Subagents 2 · ↓ open". (UNI-291)
+- App: "Start from here" on one of your messages puts that message, with its images, back in the app's input, like `/tree` in the terminal. (UNI-290)
+
 ## [3.0.0-alpha.41] — 2026-10-13
 
 ### Changed

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/unipi",
-  "version": "3.0.0-alpha.41",
+  "version": "3.0.0-alpha.43",
   "description": "All-in-one extension suite for Pi coding agent",
   "type": "module",
   "license": "MIT",
@@ -70,7 +70,9 @@
       "packages/notify/skills",
       "packages/kanboard/skills",
       "packages/updater/skills",
-      "packages/subagents/skills"
+      "packages/subagents/skills",
+      "packages/web-api/skills",
+      "packages/dream/skills"
     ]
   },
   "peerDependencies": {
@@ -80,28 +82,28 @@
     "typebox": "^1.1.38"
   },
   "dependencies": {
-    "@pi-unipi/app-bridge": "3.0.0-alpha.41",
-    "@pi-unipi/ask-user": "3.0.0-alpha.41",
-    "@pi-unipi/background-tasks": "3.0.0-alpha.41",
-    "@pi-unipi/btw": "3.0.0-alpha.41",
-    "@pi-unipi/command-enchantment": "3.0.0-alpha.41",
-    "@pi-unipi/compactor": "3.0.0-alpha.41",
-    "@pi-unipi/core": "3.0.0-alpha.41",
-    "@pi-unipi/dream": "3.0.0-alpha.41",
-    "@pi-unipi/footer": "3.0.0-alpha.41",
-    "@pi-unipi/fusion": "3.0.0-alpha.41",
-    "@pi-unipi/info-screen": "3.0.0-alpha.41",
-    "@pi-unipi/input-shortcuts": "3.0.0-alpha.41",
-    "@pi-unipi/kanboard": "3.0.0-alpha.41",
-    "@pi-unipi/mcp": "3.0.0-alpha.41",
-    "@pi-unipi/memory": "3.0.0-alpha.41",
-    "@pi-unipi/notify": "3.0.0-alpha.41",
-    "@pi-unipi/skill-registry": "3.0.0-alpha.41",
-    "@pi-unipi/subagents": "3.0.0-alpha.41",
-    "@pi-unipi/updater": "3.0.0-alpha.41",
-    "@pi-unipi/utility": "3.0.0-alpha.41",
-    "@pi-unipi/web-api": "3.0.0-alpha.41",
-    "@pi-unipi/workflow": "3.0.0-alpha.41",
+    "@pi-unipi/app-bridge": "3.0.0-alpha.43",
+    "@pi-unipi/ask-user": "3.0.0-alpha.43",
+    "@pi-unipi/background-tasks": "3.0.0-alpha.43",
+    "@pi-unipi/btw": "3.0.0-alpha.43",
+    "@pi-unipi/command-enchantment": "3.0.0-alpha.43",
+    "@pi-unipi/compactor": "3.0.0-alpha.43",
+    "@pi-unipi/core": "3.0.0-alpha.43",
+    "@pi-unipi/dream": "3.0.0-alpha.43",
+    "@pi-unipi/footer": "3.0.0-alpha.43",
+    "@pi-unipi/fusion": "3.0.0-alpha.43",
+    "@pi-unipi/info-screen": "3.0.0-alpha.43",
+    "@pi-unipi/input-shortcuts": "3.0.0-alpha.43",
+    "@pi-unipi/kanboard": "3.0.0-alpha.43",
+    "@pi-unipi/mcp": "3.0.0-alpha.43",
+    "@pi-unipi/memory": "3.0.0-alpha.43",
+    "@pi-unipi/notify": "3.0.0-alpha.43",
+    "@pi-unipi/skill-registry": "3.0.0-alpha.43",
+    "@pi-unipi/subagents": "3.0.0-alpha.43",
+    "@pi-unipi/updater": "3.0.0-alpha.43",
+    "@pi-unipi/utility": "3.0.0-alpha.43",
+    "@pi-unipi/web-api": "3.0.0-alpha.43",
+    "@pi-unipi/workflow": "3.0.0-alpha.43",
     "@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.41",
+  "version": "3.0.0-alpha.43",
   "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.41"
+    "@pi-unipi/core": "3.0.0-alpha.43"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "^0.87.1",

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

@@ -14,7 +14,7 @@ import { chmodSync, existsSync, mkdirSync, readdirSync, readFileSync, renameSync
 import { homedir } from "node:os";
 import { join, relative, resolve as resolvePath } from "node:path";
 import { DialogHub, wrapUi } from "./dialogs.js";
-import { ENTRIES_BUDGET, HELLO_ENTRIES_BUDGET, LINE_BUDGET, fitLine, historyPage, jsonBytes, phoneSafe, snapshotEntries, clipText, editedAway, wantedEntry } from "./snapshot.js";
+import { ENTRIES_BUDGET, HELLO_ENTRIES_BUDGET, LINE_BUDGET, fitLine, historyPage, jsonBytes, phoneSafe, snapshotEntries, clipText, editedAway, wantedEntry, treeGoRestore, type TreeGoRestore } from "./snapshot.js";
 import { searchSession } from "./search.js";
 import {
   BRIDGE_PROTOCOL,
@@ -658,6 +658,23 @@ export function createBridge(pi: ExtensionAPI, deps: BridgeDeps = defaultDeps) {
     }
   };
 
+  // The model list changes after `hello`: providers that register late
+  // (pi-omniroute-bridge refreshes its provider in session_start, after this
+  // bridge's hello) or a /model in the TUI that loads more. A phone that
+  // connected early kept the first, partial list (only openrouter) until
+  // something forced a new hello. Push a `models` line whenever the list
+  // differs from the last one sent, and check a few times after start.
+  let lastModelsKey = "";
+  const modelsKey = (list: ModelInfo[]) => list.map((m) => `${m.provider}/${m.id}`).join("\n");
+  const pushModelsIfChanged = () => {
+    if (!ctx || clients.size === 0) return;
+    const list = models();
+    const key = modelsKey(list);
+    if (key === lastModelsKey) return;
+    lastModelsKey = key;
+    send({ t: "models", models: list } as OutMsg);
+  };
+
   // 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").
@@ -675,7 +692,11 @@ export function createBridge(pi: ExtensionAPI, deps: BridgeDeps = defaultDeps) {
       streaming: streaming ? { id: streaming.id, role: "assistant" as const, content: phoneSafe(streaming.content) as unknown[] } : undefined,
       tools: [...tools.values()].map((t) => ({ ...t, text: t.text ? clipText(t.text, 8 * 1024) : t.text })),
       commands: commands().map((x) => ({ ...x, description: x.description ? clipText(x.description, 160) : x.description })),
-      models: models(),
+      models: (() => {
+        const list = models();
+        lastModelsKey = modelsKey(list);
+        return list;
+      })(),
       dialogs: hub.list(),
       queue: queueView(),
       fusion: fusionPreset(),
@@ -1121,12 +1142,32 @@ export function createBridge(pi: ExtensionAPI, deps: BridgeDeps = defaultDeps) {
     if (!c) return fail("pi is gone.");
     const i = tuiQueue.findIndex((q) => q.id === id);
     if (i < 0) return fail("That queued message is gone.");
-    const [target] = tuiQueue.splice(i, 1);
+    // UNI-305: pi has no API to drop ONE item from its own live steer/followUp
+    // queue — the only way to edit it is to abort the whole run and re-send
+    // what's left (see the class comment above `tuiQueue`). That's fine
+    // between tool calls (there is nothing running to lose), but aborting
+    // WHILE a tool is executing kills it mid-flight — real, unsaved work —
+    // and if the removed item was the queue's only entry nothing is left to
+    // re-send: the run just dies instead of continuing. So this waits a
+    // short beat for the in-flight tool to reach its own end (the next safe
+    // boundary) before touching the queue; a tool still running past that
+    // is left alone and the edit is refused instead of destroying it.
+    if (tools.size > 0) {
+      const deadline = Date.now() + 4_000;
+      while (tools.size > 0 && Date.now() < deadline) await sleep(100);
+      if (tools.size > 0) return fail("That message was already handed to pi — it can't be taken back while a tool is running.");
+    }
+    // The wait above may have let pi drain this very item into a real turn
+    // (the message_start handler below removes it from tuiQueue once pi
+    // actually sends it) — re-check instead of operating on a stale index.
+    const liveIndex = tuiQueue.findIndex((q) => q.id === id);
+    if (liveIndex < 0) return fail("That message was already handed to pi — it can't be taken back now.");
+    const [target] = tuiQueue.splice(liveIndex, 1);
     const action = apply(target!) ?? undefined;
     // Keep the edited/kept target in its original slot (promote: first).
     const rest = tuiQueue.splice(0, tuiQueue.length);
     if (action === "promote") rest.unshift(target!);
-    else if (action !== "drop") rest.splice(i, 0, target!);
+    else if (action !== "drop") rest.splice(liveIndex, 0, target!);
     if (!c.isIdle()) {
       await abortKeepingEditor(c);
       const deadline = Date.now() + 10_000;
@@ -1507,14 +1548,36 @@ export function createBridge(pi: ExtensionAPI, deps: BridgeDeps = defaultDeps) {
         }
         return;
       }
+      case "reload": {
+        // UNI-308: `/reload` must work from the app, not fall through to a plain
+        // prompt. `ctx.reload()` (ExtensionCommandContext) is the same call the
+        // terminal's built-in `/reload` makes.
+        if (!(await ensureIdle(msg.force))) return write(sock, { t: "error", message: "pi is busy. Stop the current run first.", code: "busy", ref: msg.ref });
+        try {
+          await runCommandOp(async (cctx) => {
+            await cctx.reload();
+          });
+          ack();
+        } catch (error) {
+          fail(error instanceof Error ? error.message : String(error));
+        }
+        return;
+      }
       case "tree_go": {
         if (!(await ensureIdle(msg.force))) return write(sock, { t: "error", message: "pi is busy. Stop the current run first.", code: "busy", ref: msg.ref });
         try {
+          let restore: TreeGoRestore | undefined;
           await runCommandOp(async (cctx) => {
+            // Read before navigating: the target is a user message → pi moves
+            // the leaf to just before it, and (like /tree) its text goes back
+            // to the composer (UNI-290).
+            const target = cctx.sessionManager.getEntry?.(msg.id);
             const result = await cctx.navigateTree(msg.id, { summarize: msg.summarize });
             if (result.cancelled) throw new Error("Cancelled");
+            const leaf = cctx.sessionManager.getLeafId?.() ?? null;
+            restore = treeGoRestore(target, (result as { editorText?: unknown }).editorText, leaf);
           });
-          ack();
+          write(sock, { t: "ack", ref: msg.ref, ...(restore ?? {}) });
         } catch (error) {
           fail(error instanceof Error ? error.message : String(error));
         }
@@ -1815,6 +1878,8 @@ export function createBridge(pi: ExtensionAPI, deps: BridgeDeps = defaultDeps) {
       setRemoteDialogs(hub);
       listen();
       writeRecord();
+      // Late providers (registered after this hello): re-check the model list.
+      for (const ms of [1500, 5000, 15000]) setTimeout(() => safe(pushModelsIfChanged)(), ms).unref?.();
       if (event?.reason && event.reason !== "startup") {
         streaming = undefined;
         tools.clear();
@@ -1981,6 +2046,7 @@ export function createBridge(pi: ExtensionAPI, deps: BridgeDeps = defaultDeps) {
   });
 
   on("agent_start", safe(() => {
+    pushModelsIfChanged();
     // A fresh run after a phone Stop: the queue delivers after THIS one.
     releaseHold();
     running = true;
@@ -2148,7 +2214,10 @@ export function createBridge(pi: ExtensionAPI, deps: BridgeDeps = defaultDeps) {
 
   // The preset's `active` changes with the model (Fusion leaves fusion mode
   // on a /model switch), so it rides along (UNI-212).
-  on("model_select", safe(() => stateWithFusion()));
+  on("model_select", safe(() => {
+    stateWithFusion();
+    pushModelsIfChanged();
+  }));
   on("thinking_level_select", safe(() => send({ t: "state", ...runState() })));
   on("session_compact", safe(() => {
     if (!ctx) return;

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

@@ -273,3 +273,29 @@ export function historyPage(branch: readonly unknown[], before: string, budget =
   }
   return { entries: out.reverse(), more };
 }
+
+/** UNI-290: what goes back into the app's composer after `tree_go` to a user
+ * message — its text (pi's own `editorText` when the runtime passes it on,
+ * else read off the entry, joined the same way pi does) and its images as
+ * the usual phone-safe refs (inline thumbnail or a `mediaRef`). */
+export type TreeGoRestore = { restore: { text: string; images?: Array<{ mime: string; data?: string; mediaRef?: string; bytes?: number }> } };
+
+/** The ack extras for a `tree_go` that landed: only when `target` is a user
+ * message and pi really moved the leaf off it (to its parent) — a no-op
+ * navigation (already there) restores nothing. */
+export function treeGoRestore(target: unknown, editorText: unknown, leafAfter: string | null): TreeGoRestore | undefined {
+  const e = target as { id?: string; type?: string; message?: { role?: string; content?: unknown } } | null | undefined;
+  if (!e || e.type !== "message" || e.message?.role !== "user") return undefined;
+  if (leafAfter !== null && leafAfter === e.id) return undefined;
+  const content = e.message.content;
+  const parts = Array.isArray(content) ? (content as Array<{ type?: string; text?: unknown }>) : [];
+  const fromEntry = typeof content === "string" ? content : parts.filter((p) => p?.type === "text" && typeof p.text === "string").map((p) => p.text as string).join("");
+  const text = typeof editorText === "string" ? editorText : fromEntry;
+  const images = parts
+    .filter((p) => p?.type === "image")
+    .map((p) => phoneSafe(p) as { mime?: string; data?: string; mediaRef?: string; bytes?: number } | null)
+    .filter((p): p is { mime?: string; data?: string; mediaRef?: string; bytes?: number } => !!p && (typeof p.data === "string" || typeof p.mediaRef === "string"))
+    .map((p) => ({ mime: p.mime ?? "image/*", ...(p.data ? { data: p.data } : {}), ...(p.mediaRef ? { mediaRef: p.mediaRef } : {}), ...(typeof p.bytes === "number" ? { bytes: p.bytes } : {}) }));
+  if (!text && !images.length) return undefined;
+  return { restore: { text: clipText(text, TEXT_CLIP), ...(images.length ? { images } : {}) } };
+}

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

@@ -251,6 +251,8 @@ export type OutMsg =
       dream?: DreamStatusInfo;
     }
   | ({ t: "state" } & Partial<RunState>)
+  /** The model list changed after `hello` (a late provider, a /model in the TUI). */
+  | { t: "models"; models: ModelInfo[] }
   | ({ t: "session"; reason: string } & SessionInfo)
   | { t: "entry"; entry: unknown }
   | { t: "msg_start"; id: string; role: string }
@@ -275,8 +277,11 @@ export type OutMsg =
   | { t: "btw_list"; pages: BtwListPage[]; complete?: true; ref?: string }
   /** `code: "busy"`: new/resume/fork/tree_go while pi is running — the phone may retry with `force:true`. */
   | { t: "error"; message: string; ref?: string; code?: "busy" }
-  /** `as: "command"`: the prompt ran an extension command (no chat message follows). */
-  | { t: "ack"; ref?: string; as?: "command" }
+  /** `as: "command"`: the prompt ran an extension command (no chat message follows).
+   * `restore` (UNI-290, `tree_go` only): the target was a user message, so pi
+   * moved the leaf to just before it — its text (and images, phone-safe refs)
+   * go back into the phone's composer, like /tree puts it in the TUI editor. */
+  | { t: "ack"; ref?: string; as?: "command"; restore?: { text: string; images?: Array<{ mime: string; data?: string; mediaRef?: string; bytes?: number }> } }
   /** The session is being replaced (new/resume/fork/reload): reconnect to get the new session's hello. */
   | { t: "reconnect"; reason: string }
   /** A page of older entries (oldest first) ending right before `before`. */
@@ -410,6 +415,10 @@ export type InMsg =
   | { t: "tree"; ref?: string }
   /** Navigate to a different point in the tree. `force`: abort the current run first. */
   | { t: "tree_go"; id: string; summarize?: boolean; force?: boolean; ref?: string }
+  /** UNI-308: `/reload` sent from the app — re-reads extensions, skills, prompts, context files
+   *  via `ctx.reload()` (the same thing the terminal's `/reload` built-in does). `force`: abort
+   *  the current run first, like the other session ops. */
+  | { t: "reload"; force?: boolean; ref?: string }
   /** Fetches the full bytes behind an image `mediaRef` the bridge sent in a
    *  `media`-omitted placeholder (see `phoneSafe`): replies with one or more
    *  `media_chunk` (≤ 700 KB of base64 per chunk) ending in `done:true`, or a
@@ -498,6 +507,7 @@ const IN_TYPES = new Set([
   "session_fork",
   "tree",
   "tree_go",
+  "reload",
   "session_rename",
   "media",
   "file_share",
@@ -591,6 +601,8 @@ export function parseIn(line: string): InMsg | { bad: string; ref?: string } | u
     case "tree_go":
       if (typeof m.id !== "string" || !m.id) return { bad: "tree_go.id must be a string", ref };
       return { t: "tree_go", id: m.id, summarize: m.summarize === true, force: m.force === true, ref };
+    case "reload":
+      return { t: "reload", force: m.force === true, ref };
     case "session_rename":
       if (typeof m.name !== "string") return { bad: "session_rename.name must be a string", ref };
       return { t: "session_rename", name: m.name.slice(0, 200), ref };

package/packages/ask-user/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/ask-user",
-  "version": "3.0.0-alpha.41",
+  "version": "3.0.0-alpha.43",
   "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.41"
+    "@pi-unipi/core": "3.0.0-alpha.43"
   },
   "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.41",
+  "version": "3.0.0-alpha.43",
   "description": "Enhanced TUI autocomplete for /unipi:* commands — colored, sorted, and grouped by package",
   "type": "module",
   "main": "src/index.ts",

package/packages/autocomplete/src/constants.ts

@@ -77,6 +77,7 @@ export const COMMAND_REGISTRY: Record<string, string> = {
   "unipi:dream":      "utility",
   "unipi:answer":     "utility",
   "unipi:summarize":  "utility",
+  "unipi:cron":       "utility",
   "unipi:move":       "utility",
 
   // skill-registry
@@ -165,6 +166,7 @@ export const COMMAND_DESCRIPTIONS: Record<string, string> = {
   "unipi:doctor":     "Check UniPi's runtime: config, model cache, Decision Model, skills",
   "unipi:answer":     "Answer the last reply — fixed input under the scrollable reply, per question, or web form",
   "unipi:summarize":  "Summarize your last reply again (answer first, then findings, open items, questions). Add text to ask about it",
+  "unipi:cron":       "Scheduled pi runs on this PC — jobs, next runs, results; run, stop, enable, pause",
   "unipi:skills":     "Manage skills — on/off per project, listed or not, the skill vault",
   "unipi:move":       "Re-link sessions, trust, worktrees, boards and memories after moving this project",
 

package/packages/background-tasks/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/background-tasks",
-  "version": "3.0.0-alpha.41",
+  "version": "3.0.0-alpha.43",
   "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.41",
+    "@pi-unipi/core": "3.0.0-alpha.43",
     "turndown": "^7.2.4"
   },
   "devDependencies": {

package/packages/btw/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/btw",
-  "version": "3.0.0-alpha.41",
+  "version": "3.0.0-alpha.43",
   "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.41"
+    "@pi-unipi/core": "3.0.0-alpha.43"
   },
   "pi": {
     "extensions": [

package/packages/compactor/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/compactor",
-  "version": "3.0.0-alpha.41",
+  "version": "3.0.0-alpha.43",
   "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.41",
-    "@pi-unipi/info-screen": "3.0.0-alpha.41",
+    "@pi-unipi/core": "3.0.0-alpha.43",
+    "@pi-unipi/info-screen": "3.0.0-alpha.43",
     "@earendil-works/pi-agent-core": "^0.87.1"
   },
   "peerDependencies": {

package/packages/core/command-echo.ts

@@ -12,7 +12,7 @@
  * failures never block the command itself.
  */
 
-import type { ExtensionAPI, ExtensionCommandContext, RegisteredCommand } from "@earendil-works/pi-coding-agent";
+import { ExtensionRunner, type ExtensionAPI, type ExtensionCommandContext, type RegisteredCommand } from "@earendil-works/pi-coding-agent";
 import { Text } from "@earendil-works/pi-tui";
 
 export const COMMAND_ECHO_TYPE = "unipi-command-echo";
@@ -96,6 +96,48 @@ export function commandArgCompleters(): Map<string, ArgCompleter> {
   return (g[COMPLETERS_KEY] ??= new Map<string, ArgCompleter>());
 }
 
+/**
+ * UNI-304: `commandArgCompleters()` used to only ever hold the commands
+ * this module's own `withCommandEcho` wrapper saw (UniPi's commands). Other
+ * extensions' commands — pi-omniroute-bridge's `/usage`, a future `/skill:*`
+ * completer, anything not registered through `withCommandEcho` — never got
+ * an entry, so the app (which can only ask the bridge, never pi's live
+ * in-memory command registry) got nothing for them.
+ *
+ * `ExtensionRunner.resolveRegisteredCommands()` is where pi itself resolves
+ * every extension's registered command (with its real `getArgumentCompletions`,
+ * see `RegisteredCommand`) into the de-duplicated list the TUI's own
+ * autocomplete reads (`interactive-mode.js` calls `getRegisteredCommands()`,
+ * which calls this). It runs on every keystroke in a command's argument area,
+ * so it is already a safe, repeatedly-called hook. Patching it here — once,
+ * idempotently, on the shared class — is the least invasive way to see every
+ * extension's completer: no extension author needs to go through
+ * `withCommandEcho`, and pi needs no API change. UniPi's `unipi/index.ts`
+ * calls `withCommandEcho` (which calls this) before any other module loads,
+ * so the patch is in place before any extension — ours or a third party's —
+ * registers a single command.
+ */
+let runnerPatched = false;
+export function patchExtensionRunnerCommandCompleters(): void {
+  if (runnerPatched) return;
+  runnerPatched = true;
+  const proto = ExtensionRunner.prototype as unknown as {
+    resolveRegisteredCommands: () => Array<{ invocationName: string; name: string; getArgumentCompletions?: ArgCompleter }>;
+  };
+  const original = proto.resolveRegisteredCommands;
+  if (typeof original !== "function") return; // Unknown/future pi build: no-op rather than throw.
+  proto.resolveRegisteredCommands = function (this: unknown, ...args: unknown[]) {
+    const resolved = original.apply(this, args as []);
+    const map = commandArgCompleters();
+    for (const command of resolved) {
+      if (typeof command.getArgumentCompletions === "function") {
+        map.set(command.invocationName, command.getArgumentCompletions.bind(command));
+      }
+    }
+    return resolved;
+  } as typeof original;
+}
+
 /** Never echo `/name` (internal, programmatic commands). Call before or after registering. */
 export function silenceCommandEcho(name: string): void {
   silentSet().add(name.replace(/^\//, ""));
@@ -114,6 +156,10 @@ export function isSilentEcho(text: unknown): boolean {
 }
 
 export function withCommandEcho(pi: ExtensionAPI): ExtensionAPI {
+  // UNI-304: patch once, before any command is registered, so every
+  // extension's own completer (not just ones that happen to go through this
+  // wrapper) ends up in commandArgCompleters().
+  patchExtensionRunnerCommandCompleters();
   try {
     pi.registerEntryRenderer<{ text?: string }>(
       COMMAND_ECHO_TYPE,

package/packages/core/constants.ts

@@ -110,6 +110,7 @@ export const UTILITY_COMMANDS = {
   ANSWER: "answer",
   SUMMARIZE: "summarize",
   MOVE: "move",
+  CRON: "cron",
 } as const;
 
 /** Ask-user tool names */

package/packages/core/index.ts

@@ -54,3 +54,4 @@ export * from "./src/hints/store.js";
 export { CRAB_14_LINES_256, CRAB_14_LINES_TRUECOLOR, CRAB_22_LINES_256, CRAB_22_LINES_TRUECOLOR } from "./src/hints/crab-data.js";
 export * from "./harness-messages.js";
 export * from "./remote-dialogs.js";
+export * from "./src/skill-conditions.js";

package/packages/core/package.json

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

package/packages/core/src/skill-conditions.ts

@@ -0,0 +1,68 @@
+/**
+ * @pi-unipi/core — skill visibility conditions (UNI-300)
+ *
+ * A generic, tiny gate any module can use to hide one of its bundled
+ * skills from the model when some runtime fact says it can't be used
+ * right now (e.g. the PC's browser is off). Skill-registry (and anything
+ * else shaping `options.skills`) calls `skillConditionsPass` per skill
+ * name; a module that owns the fact calls `registerSkillCondition` once
+ * at load time with a cheap, synchronous predicate.
+ *
+ * Deliberately process-global like the rest of core's small registries
+ * (command-runner, settings): modules load once per process, and this
+ * needs no session/ctx threading. A condition must never throw or block;
+ * callers treat a throwing condition as "false" (hidden) defensively but
+ * conditions should fail open themselves when unsure.
+ */
+
+export type SkillCondition = () => boolean;
+
+const conditions = new Map<string, SkillCondition>();
+
+/** Registers (or replaces) the visibility condition for a skill name. */
+export function registerSkillCondition(skillName: string, condition: SkillCondition): void {
+  conditions.set(skillName, condition);
+}
+
+export function unregisterSkillCondition(skillName: string): void {
+  conditions.delete(skillName);
+}
+
+/** True when the skill has no registered condition, or its condition returns true. A throwing
+ *  condition counts as false (hidden) — safer than crashing the turn to show a broken skill. */
+export function skillConditionPasses(skillName: string): boolean {
+  const condition = conditions.get(skillName);
+  if (!condition) return true;
+  try {
+    return condition();
+  } catch {
+    return false;
+  }
+}
+
+/** Reason a skill is currently hidden (for a clear `/skill:name` refusal), or undefined when
+ *  it isn't gated by a condition, or its condition is registered but no reason was given. */
+export type SkillConditionReason = () => string | undefined;
+
+const reasons = new Map<string, SkillConditionReason>();
+
+/** Optional: a human reason shown when `/skill:name` is blocked because the condition is false. */
+export function registerSkillConditionReason(skillName: string, reason: SkillConditionReason): void {
+  reasons.set(skillName, reason);
+}
+
+export function skillConditionReason(skillName: string): string | undefined {
+  const fn = reasons.get(skillName);
+  if (!fn) return undefined;
+  try {
+    return fn();
+  } catch {
+    return undefined;
+  }
+}
+
+/** Test hook. */
+export function resetSkillConditionsForTests(): void {
+  conditions.clear();
+  reasons.clear();
+}