@shunagent/shun 0.1.145 → 0.1.146

package/README.md

@@ -7,6 +7,8 @@
 Shun brings streaming conversations, coding tools, Agent Skills, and plugins to
 your terminal. Connect a local model server or a hosted model provider.
 
+![Shun terminal interface](https://raw.githubusercontent.com/kyleslight/shun/main/resources/screenshot-tui.png)
+
 ## Install
 
 Requires **Node.js 22.19 or newer** on macOS, Linux, or Windows.
@@ -17,7 +19,10 @@ shun
 ```
 
 Alternatively, use `pnpm add -g @shunagent/shun` or `bun add -g @shunagent/shun`.
-The terminal app can run without Shun Desktop.
+The terminal app can run without Shun Desktop. Browser, PDF, and image-processing
+components download automatically when first needed and are reused from your
+local Shun profile. Basic conversations do not install these components.
+Standalone Browser Preview also downloads its testing browser on first use.
 
 ## Start a conversation
 
@@ -46,6 +51,54 @@ finished conversation to the welcome screen. At the welcome screen, press it
 twice to exit. Ctrl+D on an empty prompt detaches from Shun. Exiting the terminal
 does not stop background tasks; use `/stop` to stop the current run.
 
+## Command reference
+
+### In your shell
+
+| Command | What it does |
+| --- | --- |
+| `shun` | Start a new conversation without choosing a project. |
+| `shun .` or `shun <folder>` | Start in the current directory or a chosen project. |
+| `shun -c` / `--continue` | Continue the most recent conversation in the selected project scope. |
+| `shun -r` / `--resume` | Search and choose a saved conversation. |
+| `shun --session <id>` | Reopen a specific conversation; `--task` is an alias. |
+| `shun run "message" --workspace <folder>` | Send a message and stream the answer to standard output. |
+| `shun run "message" --task <id>` | Continue a saved conversation without opening the TUI. |
+| `shun tasks` | Print conversation IDs, running status, and titles. |
+| `shun service status` | Check whether the local background service is running. |
+| `shun service stop` | Stop the service when its tasks are idle. |
+| `shun desktop` | Open Shun Desktop. |
+| `shun desktop --install` | Download and verify the Desktop installer. |
+| `shun --help` / `-h` | Show commands and their descriptions. |
+| `shun --version` / `-v` | Print the installed CLI version. |
+
+### Inside a conversation
+
+Type `/` for searchable suggestions, or `/help` for the command picker.
+
+| Command | What it does |
+| --- | --- |
+| `/connect` | Add a model provider connection. |
+| `/providers` | Manage provider credentials, settings, and connection tests. |
+| `/model` | Choose the provider and model for this conversation. |
+| `/new [folder]` | Start a new conversation, retaining the current project unless a folder is supplied. |
+| `/new --no-workspace` | Start a new conversation without a project. |
+| `/clear` | Start fresh; preserve the previous conversation in history. |
+| `/resume` | Find and reopen a conversation, initially scoped to the current project. |
+| `/tasks` | Browse conversations across projects. |
+| `/session` | Show this conversation's ID and project. |
+| `/name <title>` | Rename this conversation. |
+| `/trust` | Review project configuration trust. |
+| `/paste` | Attach an image from the local clipboard. |
+| `/attach <path>` | Attach an image file, for example `/attach /tmp/screenshot.png`. |
+| `/images` | Preview or remove images attached to your next message. |
+| `/processes` | Inspect output from or stop task-owned background processes. |
+| `/skills` | Enable, disable, or install Agent Skills. |
+| `/desktop` | Open this conversation in Shun Desktop. |
+| `/stop` | Stop the current generation. |
+| `/quit` | Exit the terminal interface; background tasks can continue. |
+| `/help` | Browse command descriptions and insert a selected command. |
+
 ## Images
 
 On macOS, use **Cmd+V**. If iTerm2 asks how to paste an image, choose **Save to

package/dist/cli.js

@@ -1,8 +1,8 @@
-import { execFile, spawn } from "node:child_process";
-import { readFile, mkdir, writeFile, rename, lstat, copyFile, rm, mkdtemp, access, readdir, stat, realpath, open, appendFile, cp, chmod, unlink } from "node:fs/promises";
+import { spawn, execFile } from "node:child_process";
+import { access, mkdir, mkdtemp, writeFile, rename, rm, readFile, lstat, copyFile, readdir, stat, realpath, open, appendFile, cp, chmod, unlink } from "node:fs/promises";
 import { createHash, randomUUID, randomBytes, timingSafeEqual } from "node:crypto";
 import { homedir, tmpdir, platform } from "node:os";
-import { resolve, join, dirname, basename, sep, relative, extname, win32, delimiter, isAbsolute } from "node:path";
+import { resolve, join, dirname, delimiter, basename, sep, relative, extname, win32, isAbsolute } from "node:path";
 import { createServer, request } from "node:http";
 import { createConnection } from "node:net";
 import { ProjectTrustStore, SettingsManager, DefaultResourceLoader, loadSkillsFromDir, DefaultPackageManager, loadSkills, createAgentSession, ModelRuntime, SessionManager, defineTool, CONFIG_DIR_NAME, createBashToolDefinition, createLocalBashOperations, truncateTail, createEditToolDefinition, withFileMutationQueue, hasTrustRequiringProjectResources } from "@earendil-works/pi-coding-agent";
@@ -15,15 +15,33 @@ import { constants, existsSync, mkdirSync, openSync, closeSync, rmSync, readFile
 import { createProvider } from "@earendil-works/pi-ai";
 import { openAICompletionsApi } from "@earendil-works/pi-ai/api/openai-completions.lazy";
 import { unzipSync, gunzipSync } from "fflate";
+import { createRequire } from "node:module";
+import { pathToFileURL, fileURLToPath } from "node:url";
 import "typebox/value";
-import puppeteer from "puppeteer-core";
-import { PUPPETEER_REVISIONS } from "puppeteer-core/internal/revisions.js";
-import { computeExecutablePath, Browser, install } from "@puppeteer/browsers";
 import { StringDecoder } from "node:string_decoder";
 import { createTwoFilesPatch } from "diff";
-import { fileURLToPath } from "node:url";
 import { truncateToWidth, stripTerminalSequences, Markdown, TuiMainScreen, ProcessTerminal, Container, Text, matchesKey, Editor, CombinedAutocompleteProvider, Spacer, SelectList, Input, Image } from "@earendil-works/pi-tui";
-import { createRequire } from "node:module";
+const slashCommands = [
+  ["help", "Show available commands"],
+  ["connect", "Connect a model provider"],
+  ["providers", "Manage model providers"],
+  ["model", "Choose a model"],
+  ["resume", "Resume a conversation"],
+  ["session", "Show this conversation"],
+  ["name", "Rename this conversation"],
+  ["tasks", "Browse conversations"],
+  ["new", "Start a new conversation"],
+  ["clear", "Start fresh; keep previous conversations"],
+  ["trust", "Manage project trust"],
+  ["paste", "Attach an image from the clipboard"],
+  ["attach", "Attach an image file"],
+  ["images", "Preview or remove attached images"],
+  ["processes", "Manage background processes"],
+  ["skills", "Manage Agent Skills"],
+  ["desktop", "Open this conversation in Shun"],
+  ["stop", "Stop the current task"],
+  ["quit", "Exit the terminal"]
+].map(([name, description]) => ({ name, description }));
 function agentRuntimeHome(homeDirectory, override = "") {
   const root = resolve(override || join(homeDirectory, ".shun"));
   return {
@@ -886,6 +904,74 @@ function contentWindow(content, maxChars, offset, knownHasMore = false) {
   const value = content.slice(offset, offset + maxChars), end = offset + value.length, hasMore = knownHasMore || end < content.length;
   return { content_offset: offset, content_end: end, content_characters: content.length, returned_characters: value.length, truncated: offset > 0 || hasMore, has_more: hasMore, content: value };
 }
+const modules = {
+  "pdfjs-dist/legacy/build/pdf.mjs": { group: "pdf", packages: ["pdfjs-dist@6.2.108"] },
+  "@napi-rs/canvas": { group: "images", packages: ["@napi-rs/canvas@1.0.6"] },
+  "puppeteer-core": { group: "browser", packages: ["puppeteer-core@25.16.0", "@puppeteer/browsers@3.2.6"] },
+  "puppeteer-core/internal/revisions.js": { group: "browser", packages: ["puppeteer-core@25.16.0", "@puppeteer/browsers@3.2.6"] },
+  "@puppeteer/browsers": { group: "browser", packages: ["puppeteer-core@25.16.0", "@puppeteer/browsers@3.2.6"] }
+};
+const pending = /* @__PURE__ */ new Map();
+async function installPackages(directory, packages) {
+  const bundled = join(dirname(process.execPath), "npm", "bin", "npm-cli.js");
+  const candidates = [
+    bundled,
+    join(dirname(process.execPath), "node_modules/npm/bin/npm-cli.js"),
+    ...process.platform === "win32" ? (process.env.PATH || "").split(delimiter).filter(Boolean).map((path) => join(path, "node_modules/npm/bin/npm-cli.js")) : []
+  ];
+  let npmCli;
+  for (const candidate of candidates) if (await access(candidate).then(() => true).catch(() => false)) {
+    npmCli = candidate;
+    break;
+  }
+  if (process.platform === "win32" && !npmCli) throw Error("Install Node.js with npm to enable this optional capability.");
+  const args2 = ["install", "--prefix", directory, "--registry=https://registry.npmjs.org", "--ignore-scripts", "--no-audit", "--no-fund", "--save-exact", ...packages];
+  await new Promise((resolve2, reject) => {
+    const executable = npmCli ? process.execPath : "npm";
+    const commandArgs = npmCli ? [npmCli, ...args2] : args2;
+    const child = spawn(executable, commandArgs, { stdio: ["ignore", "ignore", "pipe"], timeout: 18e4, windowsHide: true });
+    let error = "";
+    child.stderr.on("data", (chunk) => {
+      error = (error + chunk.toString()).slice(-2e3);
+    });
+    child.once("error", () => reject(Error("Could not install this optional capability. Install Node.js with npm and try again.")));
+    child.once("exit", (code) => code === 0 ? resolve2() : reject(Error(`Optional capability installation failed. Retry when npm can reach the registry. ${error.replace(/https?:\/\/\S+/g, "[registry]")}`)));
+  });
+}
+async function capabilityDirectory(specifier, root = join(hostPaths().root, "capabilities"), install = installPackages) {
+  const spec = modules[specifier];
+  if (!spec) throw Error("Unknown optional capability.");
+  const key = `${spec.group}-${spec.packages.join("-").replace(/[^a-zA-Z0-9.-]/g, "_")}`;
+  const directory = join(root, key), marker = join(directory, ".ready");
+  if (await access(marker).then(() => true).catch(() => false)) return directory;
+  let work = pending.get(directory);
+  if (!work) {
+    work = (async () => {
+      await mkdir(root, { recursive: true, mode: 448 });
+      const temporary = await mkdtemp(join(root, ".install-"));
+      try {
+        await writeFile(join(temporary, "package.json"), JSON.stringify({ private: true, name: `shun-${spec.group}-capability`, version: "1.0.0" }));
+        await install(temporary, spec.packages);
+        await writeFile(join(temporary, ".ready"), "ready\n");
+        try {
+          await rename(temporary, directory);
+        } catch (error) {
+          if (!await access(marker).then(() => true).catch(() => false)) throw error;
+        }
+        return directory;
+      } finally {
+        await rm(temporary, { recursive: true, force: true });
+      }
+    })().finally(() => pending.delete(directory));
+    pending.set(directory, work);
+  }
+  return work;
+}
+async function loadCapabilityModule(specifier) {
+  const directory = await capabilityDirectory(specifier);
+  const require2 = createRequire(join(directory, "package.json"));
+  return import(pathToFileURL(require2.resolve(specifier)).href);
+}
 function clean$4(value) {
   return String(value || "").replace(/\s+/g, " ").trim();
 }
@@ -960,7 +1046,7 @@ function pdfPageText(value) {
 const pdfJsParser = {
   id: "pdfjs",
   async read(bytes, options) {
-    const pdfjs = await import("pdfjs-dist/legacy/build/pdf.mjs");
+    const pdfjs = await loadCapabilityModule("pdfjs-dist/legacy/build/pdf.mjs");
     const loading = pdfjs.getDocument({ data: new Uint8Array(bytes), useWorkerFetch: false, useSystemFonts: true });
     const document2 = await loading.promise;
     try {
@@ -1121,8 +1207,8 @@ ${query}`), cached = this.cache.get(key), now = this.now();
       fillSlots();
     }
     if (completedEarly && active.size) {
-      const pending = [...active.values()];
-      void Promise.allSettled(pending).then((rows) => {
+      const pending2 = [...active.values()];
+      void Promise.allSettled(pending2).then((rows) => {
         for (const settled of rows) if (settled.status === "fulfilled") settled.value.row.results.forEach((candidate, rank) => collected.push({ provider: settled.value.row.id, rank, candidate }));
         this.cache.set(key, { createdAt: this.now(), results: select(fuseCandidates(collected)) });
         this.trimCache();
@@ -1589,42 +1675,42 @@ ${addition}
     const source = validSkillSource(sourceValue);
     await pruneSkillInspections();
     if (selection.inspectionToken) {
-      const pending2 = pendingSkillInspections.get(selection.inspectionToken);
-      if (!pending2 || pending2.expiresAt <= Date.now()) throw Error("The Skill selection expired. Inspect the source again.");
-      if (pending2.source !== source || pending2.workspace !== workspace) throw Error("The Skill selection does not match this source and workspace.");
+      const pending22 = pendingSkillInspections.get(selection.inspectionToken);
+      if (!pending22 || pending22.expiresAt <= Date.now()) throw Error("The Skill selection expired. Inspect the source again.");
+      if (pending22.source !== source || pending22.workspace !== workspace) throw Error("The Skill selection does not match this source and workspace.");
       const requested = [...new Set((selection.skills || []).map((value) => String(value || "").trim()).filter(Boolean))];
       if (!requested.length) throw Error("Choose at least one Skill from the inspected source.");
-      const selectedNames = requested.length === 1 && requested[0] === "*" ? pending2.candidates.map((candidate) => candidate.name) : requested.map(validName);
-      const unknown = selectedNames.filter((name) => !pending2.candidates.some((candidate) => candidate.name === name));
+      const selectedNames = requested.length === 1 && requested[0] === "*" ? pending22.candidates.map((candidate) => candidate.name) : requested.map(validName);
+      const unknown = selectedNames.filter((name) => !pending22.candidates.some((candidate) => candidate.name === name));
       if (unknown.length) throw Error(`The inspected source does not contain: ${unknown.join(", ")}.`);
-      const installed = await this.#installInspected(pending2, selectedNames, settings);
+      const installed = await this.#installInspected(pending22, selectedNames, settings);
       pendingSkillInspections.delete(selection.inspectionToken);
-      if (pending2.cleanupPath) await rm(pending2.cleanupPath, { recursive: true, force: true });
+      if (pending22.cleanupPath) await rm(pending22.cleanupPath, { recursive: true, force: true });
       return { status: "installed", installed };
     }
     if (selection.skills?.length) throw Error("Inspect the Skill source before selecting members to install.");
-    const pending = await this.#inspectSource(source, workspace);
-    if (pending.candidates.length === 1) {
+    const pending2 = await this.#inspectSource(source, workspace);
+    if (pending2.candidates.length === 1) {
       try {
-        return { status: "installed", installed: await this.#installInspected(pending, [pending.candidates[0].name], settings) };
+        return { status: "installed", installed: await this.#installInspected(pending2, [pending2.candidates[0].name], settings) };
       } finally {
-        if (pending.cleanupPath) await rm(pending.cleanupPath, { recursive: true, force: true });
+        if (pending2.cleanupPath) await rm(pending2.cleanupPath, { recursive: true, force: true });
       }
     }
     const inspectionToken = randomUUID();
-    pendingSkillInspections.set(inspectionToken, pending);
+    pendingSkillInspections.set(inspectionToken, pending2);
     return {
       status: "selection_required",
       inspectionToken,
-      candidates: pending.candidates.map(({ name, description }) => ({ name, description }))
+      candidates: pending2.candidates.map(({ name, description }) => ({ name, description }))
     };
   }
   async installSource(sourceValue, settings, workspace = "") {
     const outcome = await this.requestInstall(sourceValue, settings, workspace);
     if (outcome.status === "installed") return outcome.installed;
-    const pending = pendingSkillInspections.get(outcome.inspectionToken);
+    const pending2 = pendingSkillInspections.get(outcome.inspectionToken);
     pendingSkillInspections.delete(outcome.inspectionToken);
-    if (pending?.cleanupPath) await rm(pending.cleanupPath, { recursive: true, force: true });
+    if (pending2?.cleanupPath) await rm(pending2.cleanupPath, { recursive: true, force: true });
     const choices = outcome.candidates.map((candidate, index) => `${index + 1}. ${candidate.name} — ${candidate.description}`).join("\n");
     throw Error(`This source contains ${outcome.candidates.length} Skills. Install it from a task and choose which Skills to install:
 ${choices}`);
@@ -1667,26 +1753,26 @@ ${choices}`);
     });
     return { source, workspace, expiresAt: Date.now() + SKILL_INSPECTION_TTL_MS, kind: "package", candidates };
   }
-  async #installInspected(pending, selectedNames, settings) {
+  async #installInspected(pending2, selectedNames, settings) {
     const selected = new Set(selectedNames);
     let installed;
-    if (pending.kind === "github") {
-      if (!pending.target) throw Error("The inspected Skill source is no longer available.");
-      installed = await this.importPath(pending.target, settings, selectedNames);
+    if (pending2.kind === "github") {
+      if (!pending2.target) throw Error("The inspected Skill source is no longer available.");
+      installed = await this.importPath(pending2.target, settings, selectedNames);
     } else {
-      const refs = pending.candidates.filter((candidate) => selected.has(candidate.name)).map((candidate) => candidate.installRef);
-      installed = await this.installPackage(pending.source, settings, pending.workspace, refs);
+      const refs = pending2.candidates.filter((candidate) => selected.has(candidate.name)).map((candidate) => candidate.installRef);
+      installed = await this.installPackage(pending2.source, settings, pending2.workspace, refs);
       const installedNames = new Set(installed.map((skill) => skill.name));
       const missing = selectedNames.filter((name) => !installedNames.has(name));
       if (missing.length) {
-        await this.removePackage(pending.source, pending.workspace).catch(() => false);
+        await this.removePackage(pending2.source, pending2.workspace).catch(() => false);
         throw Error(`Selected Skills were not installed from this source: ${missing.join(", ")}.`);
       }
       installed = installed.filter((skill) => selected.has(skill.name));
     }
     return Promise.all(installed.map(async (skill) => {
       try {
-        await this.prepareRuntime(skill.id, settings, pending.workspace);
+        await this.prepareRuntime(skill.id, settings, pending2.workspace);
         return skill;
       } catch (error) {
         const message = error instanceof Error ? error.message : String(error);
@@ -1808,10 +1894,10 @@ function inspectedCandidates(skills, installRef) {
 }
 async function pruneSkillInspections() {
   const now = Date.now();
-  const expired = [...pendingSkillInspections.entries()].filter(([, pending]) => pending.expiresAt <= now);
-  for (const [token, pending] of expired) {
+  const expired = [...pendingSkillInspections.entries()].filter(([, pending2]) => pending2.expiresAt <= now);
+  for (const [token, pending2] of expired) {
     pendingSkillInspections.delete(token);
-    if (pending.cleanupPath) await rm(pending.cleanupPath, { recursive: true, force: true });
+    if (pending2.cleanupPath) await rm(pending2.cleanupPath, { recursive: true, force: true });
   }
 }
 function validSkillSource(value) {
@@ -2000,10 +2086,10 @@ async function systemPython() {
   throw Error("Python 3 is required to run this Skill, but no Python interpreter was found.");
 }
 function pythonImportModules(content) {
-  const modules = /* @__PURE__ */ new Set();
-  for (const match of content.matchAll(/^\s*(?:from|import)\s+([A-Za-z_][A-Za-z0-9_]*)/gm)) modules.add(match[1]);
-  modules.delete("__future__");
-  return [...modules].sort();
+  const modules2 = /* @__PURE__ */ new Set();
+  for (const match of content.matchAll(/^\s*(?:from|import)\s+([A-Za-z_][A-Za-z0-9_]*)/gm)) modules2.add(match[1]);
+  modules2.delete("__future__");
+  return [...modules2].sort();
 }
 const pythonDistributionAliases = {
   PIL: "Pillow",
@@ -2290,10 +2376,10 @@ async function runAgentSession(req, signal, emitRaw, options) {
     options.outcomePolicy?.observe(event);
     const interruption = options.outcomePolicy?.interrupt?.();
     if (interruption) void session.steer(interruption).catch((error) => console.warn("[outcome-policy]", error));
-    const pending = forwardSessionEvent(req, session, event, toolInputs, emit, cwd, contextState, options.materializeToolResultImages);
-    if (pending) {
-      pendingForwards.add(pending);
-      void pending.finally(() => pendingForwards.delete(pending));
+    const pending2 = forwardSessionEvent(req, session, event, toolInputs, emit, cwd, contextState, options.materializeToolResultImages);
+    if (pending2) {
+      pendingForwards.add(pending2);
+      void pending2.finally(() => pendingForwards.delete(pending2));
     }
   });
   const abort = () => {
@@ -3370,7 +3456,7 @@ function encodeCanvas(canvas, quality) {
 }
 async function rasterImage(bytes, mimeType, options) {
   try {
-    const { createCanvas, loadImage } = await import("@napi-rs/canvas");
+    const { createCanvas, loadImage } = await loadCapabilityModule("@napi-rs/canvas");
     const source = await loadImage(bytes), scale = Math.min(1, options.maxDimension / Math.max(source.width, source.height)), canvas = createCanvas(Math.max(1, Math.round(source.width * scale)), Math.max(1, Math.round(source.height * scale)));
     canvas.getContext("2d").drawImage(source, 0, 0, canvas.width, canvas.height);
     return options.budget ? encodeWithinBudget(canvas, options.budget, createCanvas, mimeType) : encodeCanvas(canvas, options.quality ?? 92);
@@ -3382,7 +3468,7 @@ async function rasterImage(bytes, mimeType, options) {
 async function normalizeImageForModel(bytes, mimeType) {
   if (bytes.length <= MAX_MODEL_OVERVIEW_BYTES && ["image/png", "image/jpeg", "image/gif", "image/webp"].includes(mimeType)) {
     try {
-      const { loadImage } = await import("@napi-rs/canvas"), source = await loadImage(bytes);
+      const { loadImage } = await loadCapabilityModule("@napi-rs/canvas"), source = await loadImage(bytes);
       if (Math.max(source.width, source.height) <= MAX_MODEL_RASTER_DIMENSION) {
         return { bytes, mimeType, width: source.width, height: source.height };
       }
@@ -3393,7 +3479,7 @@ async function normalizeImageForModel(bytes, mimeType) {
   return { bytes: Buffer.from(image.data, "base64"), mimeType: image.mimeType, width: image.width, height: image.height };
 }
 async function pdfPage(bytes, pageValue, maxDimension) {
-  const pdfjs = await import("pdfjs-dist/legacy/build/pdf.mjs"), { createCanvas } = await import("@napi-rs/canvas");
+  const pdfjs = await loadCapabilityModule("pdfjs-dist/legacy/build/pdf.mjs"), { createCanvas } = await loadCapabilityModule("@napi-rs/canvas");
   const loading = pdfjs.getDocument({ data: new Uint8Array(bytes), useWorkerFetch: false, useSystemFonts: true }), document2 = await loading.promise;
   try {
     const pageNumber = Math.max(1, Math.min(document2.numPages, Math.floor(pageValue))), page = await document2.getPage(pageNumber), base = page.getViewport({ scale: 1 });
@@ -6062,21 +6148,21 @@ async function ensurePluginRuntimeExecutable(executable, fetchExecutable, onProg
     } finally {
     }
   }
-  const install2 = { promise: void 0, listeners: /* @__PURE__ */ new Set() };
-  install2.promise = installPluginRuntimeExecutable(executable, fetchExecutable, (progress) => {
-    install2.latest = progress;
-    for (const listener of install2.listeners) {
+  const install = { promise: void 0, listeners: /* @__PURE__ */ new Set() };
+  install.promise = installPluginRuntimeExecutable(executable, fetchExecutable, (progress) => {
+    install.latest = progress;
+    for (const listener of install.listeners) {
       try {
         listener(progress);
       } catch {
       }
     }
   });
-  executableInstalls.set(executable.cachePath, install2);
+  executableInstalls.set(executable.cachePath, install);
   try {
-    return await install2.promise;
+    return await install.promise;
   } finally {
-    if (executableInstalls.get(executable.cachePath) === install2) executableInstalls.delete(executable.cachePath);
+    if (executableInstalls.get(executable.cachePath) === install) executableInstalls.delete(executable.cachePath);
   }
 }
 async function installPluginRuntimeExecutable(executable, fetchExecutable, onProgress) {
@@ -6307,18 +6393,23 @@ class HostBrowserPreview {
     this.root = root;
   }
   async launch() {
+    const [{ default: puppeteer }, { PUPPETEER_REVISIONS }, { Browser: BrowserKind, computeExecutablePath, install }] = await Promise.all([
+      loadCapabilityModule("puppeteer-core"),
+      loadCapabilityModule("puppeteer-core/internal/revisions.js"),
+      loadCapabilityModule("@puppeteer/browsers")
+    ]);
     const cacheDir = join(this.root, "browsers"), buildId = PUPPETEER_REVISIONS.chrome;
-    const executablePath = computeExecutablePath({ browser: Browser.CHROME, buildId, cacheDir });
+    const executablePath = computeExecutablePath({ browser: BrowserKind.CHROME, buildId, cacheDir });
     await access(executablePath).catch(async () => {
-      await install({ browser: Browser.CHROME, buildId, cacheDir });
+      await install({ browser: BrowserKind.CHROME, buildId, cacheDir });
     });
     await mkdir(join(this.root, "preview-profile"), { recursive: true, mode: 448 });
     return puppeteer.launch({ executablePath, headless: true, userDataDir: join(this.root, "preview-profile"), defaultViewport: { width: 1280, height: 800 } });
   }
   page(taskId) {
-    let pending = this.pages.get(taskId);
-    if (!pending) {
-      pending = (async () => {
+    let pending2 = this.pages.get(taskId);
+    if (!pending2) {
+      pending2 = (async () => {
         const browser = await (this.browser ||= this.launch().catch((error) => {
           this.browser = void 0;
           throw error;
@@ -6338,9 +6429,9 @@ class HostBrowserPreview {
         this.pages.delete(taskId);
         throw error;
       });
-      this.pages.set(taskId, pending);
+      this.pages.set(taskId, pending2);
     }
-    return pending;
+    return pending2;
   }
   async inspect(taskId, options = {}) {
     const preview = await this.page(taskId), { page } = preview;
@@ -7619,32 +7710,11 @@ async function gitStatus(workspace) {
     return "";
   }
 }
-const slashCommands = [
-  ["help", "Show available commands"],
-  ["connect", "Connect a model provider"],
-  ["providers", "Manage model providers"],
-  ["model", "Choose a model"],
-  ["resume", "Resume a conversation"],
-  ["session", "Show this conversation"],
-  ["name", "Rename this conversation"],
-  ["tasks", "Browse conversations"],
-  ["new", "Start a new conversation"],
-  ["clear", "Start fresh; keep previous conversations"],
-  ["trust", "Manage project trust"],
-  ["paste", "Attach an image from the clipboard"],
-  ["attach", "Attach an image file"],
-  ["images", "Preview or remove attached images"],
-  ["processes", "Manage background processes"],
-  ["skills", "Manage Agent Skills"],
-  ["desktop", "Open this conversation in Shun"],
-  ["stop", "Stop the current task"],
-  ["quit", "Exit the terminal"]
-].map(([name, description]) => ({ name, description }));
 const clean$1 = (text2) => stripTerminalSequences(text2).replace(/[\x00-\x1f\x7f]/g, "");
 const accent = (text2) => `\x1B[38;5;205m${text2}\x1B[0m`;
 const muted = (text2) => `\x1B[2m${text2}\x1B[0m`;
 const bold = (text2) => `\x1B[1m${text2}\x1B[0m`;
-const version$1 = "0.1.145";
+const version$1 = "0.1.146";
 class WelcomeHeader {
   state = { title: "", model: "", workspace: "", running: false, compact: false, ready: false };
   update(state) {
@@ -7958,10 +8028,10 @@ class TranscriptViewport extends Container {
 async function runTui(call, options = {}) {
   if (!process.stdin.isTTY || !process.stdout.isTTY) throw Error('Interactive Shun needs a terminal. Use shun run "message" for scripts.');
   const tui = new TuiMainScreen(new ProcessTerminal(), true);
-  const header = new WelcomeHeader(), feed = new TranscriptViewport(), pending = new Container(), panel = new Container(), status = new Text("", 1, 0);
+  const header = new WelcomeHeader(), feed = new TranscriptViewport(), pending2 = new Container(), panel = new Container(), status = new Text("", 1, 0);
   const editor = new Composer(tui, { borderColor: cyan, selectList: theme }, { paddingX: 1 });
-  for (const child of [header, feed, pending, panel, editor, status]) tui.addChild(child);
-  feed.limit = () => Math.max(1, (process.stdout.rows || 24) - [header, pending, panel, editor, status].reduce((total, item) => total + item.render(process.stdout.columns || 80).length, 0));
+  for (const child of [header, feed, pending2, panel, editor, status]) tui.addChild(child);
+  feed.limit = () => Math.max(1, (process.stdout.rows || 24) - [header, pending2, panel, editor, status].reduce((total, item) => total + item.render(process.stdout.columns || 80).length, 0));
   let snapshot, attachments = [], activeRun;
   let animatedPhases = [];
   let visibleTurnLimit = 24;
@@ -8065,8 +8135,8 @@ async function runTui(call, options = {}) {
     tui.requestRender();
   };
   const showAttachments = () => {
-    pending.clear();
-    for (const item of attachments) pending.addChild(new Text(`[${plain(attachmentLabel(item))}]`, 1, 0));
+    pending2.clear();
+    for (const item of attachments) pending2.addChild(new Text(`[${plain(attachmentLabel(item))}]`, 1, 0));
     tui.requestRender();
   };
   const ask = (label, initial = "", secret = false) => new Promise((resolve2, reject) => {
@@ -8264,7 +8334,9 @@ async function runTui(call, options = {}) {
       return;
     }
     if (name === "/help") {
-      notice(help);
+      const selected = await choose("Commands · choose to insert", slashCommands.map((item) => ({ value: item.name, label: `/${item.name}`, description: item.description })));
+      editor.setText(`/${selected} `);
+      tui.requestRender();
       return;
     }
     if (name === "/providers") {
@@ -8336,7 +8408,7 @@ async function runTui(call, options = {}) {
       } else {
         const preview = await call("attachment.preview", { taskId: snapshot.task.id, id });
         if (preview.mode !== "image") throw Error("Image preview is unavailable.");
-        pending.addChild(new Image(preview.data, preview.mimeType, { fallbackColor: dim }, { maxWidthCells: 60, maxHeightCells: 16 }));
+        pending2.addChild(new Image(preview.data, preview.mimeType, { fallbackColor: dim }, { maxWidthCells: 60, maxHeightCells: 16 }));
         tui.requestRender();
       }
       return;
@@ -8622,7 +8694,7 @@ ${activeRun ? "Task continues running in Shun.\n" : ""}Resume this conversation:
   process.off("SIGTERM", onSignal);
   process.off("SIGINT", onSignal);
 }
-const version = "0.1.145";
+const version = "0.1.146";
 const args = process.argv.slice(2);
 async function main() {
   if (args.includes("--version") || args.includes("-v")) {
@@ -8648,7 +8720,8 @@ shun service stop          Stop the service when tasks are idle
 shun desktop               Open the desktop interface
 shun desktop --install     Download and verify the desktop installer
 
-In the terminal: /new /clear /resume /providers /model /tasks /skills /help
+In the terminal:
+${slashCommands.map((item) => `/${item.name.padEnd(14)} ${item.description}`).join("\n")}
 /paste attaches a clipboard image locally; /attach imports an image file.
 Ctrl+D detaches; active tasks keep running. Ctrl+C stops generation or returns home; press twice at home to exit. /stop stops the current run.
 

package/package.json

@@ -23,7 +23,6 @@
     "@earendil-works/pi-ai": "0.84.2",
     "@earendil-works/pi-coding-agent": "0.84.2",
     "@earendil-works/pi-tui": "0.84.2",
-    "@napi-rs/canvas": "1.0.6",
     "diff": "^9.0.0",
     "fflate": "0.8.2",
     "typebox": "1.3.7",
@@ -31,10 +30,7 @@
     "https-proxy-agent": "7.0.6",
     "socks-proxy-agent": "8.0.5",
     "defuddle": "0.19.2",
-    "linkedom": "0.18.13",
-    "pdfjs-dist": "^6.2.108",
-    "puppeteer-core": "^25.16.0",
-    "@puppeteer/browsers": "^3.2.6"
+    "linkedom": "0.18.13"
   },
   "optionalDependencies": {
     "@mariozechner/clipboard-darwin-arm64": "0.3.9",
@@ -51,5 +47,18 @@
   "bugs": {
     "url": "https://github.com/kyleslight/shun/issues"
   },
-  "version": "0.1.145"
+  "keywords": [
+    "shun",
+    "ai",
+    "agent",
+    "coding-agent",
+    "cli",
+    "tui",
+    "terminal",
+    "local-first",
+    "local-llm",
+    "mcp",
+    "developer-tools"
+  ],
+  "version": "0.1.146"
 }