@d3ara1n/pi-command-palette 0.4.2 → 0.5.0

package/README.md

@@ -34,13 +34,39 @@ Or add to `~/.pi/agent/settings.json`:
 
 The palette lists:
 
-- **Built-in actions** — Model selector, New session, Compact, Reload, Fork, Tree, Resume
+- **Built-in actions** — curated shortcuts for common operations (detailed below)
 - **Extension commands** — All registered `/command` entries
 - **Skills & Templates** — Skill commands and prompt templates
 
+### Built-in actions
+
+Built-in actions are grouped by how they run:
+
+**Run immediately** — they call pi's API directly, no editor round-trip:
+
+| Action | What it does |
+|--------|--------------|
+| Model: Switch Model | Open a model selector overlay; switch instantly |
+| Session: Compact | Compact the conversation right away |
+| Editor: Copy Content | Copy current editor text to the clipboard |
+| Editor: Clear Content | Clear the editor, saving the current text to the restore buffer |
+| Restore: Previous Editor Text | Bring back text saved before the last command _(appears only when available)_ |
+
+**Fill the editor** — they insert the matching `/command` for you to submit, just like any extension command:
+
+| Action | Inserts |
+|--------|---------|
+| Session: New | `/new` |
+| Session: Reload | `/reload` |
+| Session: Fork | `/fork` |
+| Session: Tree | `/tree` |
+| Session: Resume | `/resume` |
+
+> Pi ships with more built-in slash commands (e.g. `/export`, `/share`, `/name`, `/settings`). This palette only surfaces a curated subset above — for the rest, type them directly into the editor.
+
 ### Editor text preservation
 
-When a command replaces your current editor text, the original content is saved and a **Restore: Previous Editor Text** entry appears at the top of the palette. Select it to get your text back.
+When a command replaces your editor text, or you run **Editor: Clear Content**, the original content is saved and a **Restore: Previous Editor Text** entry appears at the top of the palette. Select it to get your text back.
 
 ### Model selector
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@d3ara1n/pi-command-palette",
-  "version": "0.4.2",
+  "version": "0.5.0",
   "type": "module",
   "description": "Global command palette for pi — press Ctrl+Shift+P to search and run commands from anywhere",
   "main": "src/index.ts",

package/src/index.ts

@@ -10,10 +10,12 @@
  * - Fuzzy search via SelectList
  * - Floating overlay on top of existing content
  * - Saves editor text before overwriting; offers "Restore" in palette
+ * - Clear editor into the restore buffer
  */
 
 import type { ExtensionAPI, ExtensionContext } from "@earendil-works/pi-coding-agent";
 import {
+  copyToClipboard,
   DynamicBorder,
   getAgentDir,
   resolveModelScopeWithDiagnostics,
@@ -37,7 +39,9 @@ type CommandAction =
   | { type: "model-select" }
   | { type: "compact" }
   | { type: "reload" }
-  | { type: "restore" };
+  | { type: "restore" }
+  | { type: "copy-editor" }
+  | { type: "clear-editor" };
 
 interface PaletteItem {
   value: string;
@@ -52,6 +56,18 @@ interface PaletteItem {
 /** Editor text saved before the palette overwrites it. */
 let savedEditorText: string | null = null;
 
+/**
+ * Explicit display order for built-in palette entries (lower = higher up).
+ * Unlisted built-ins fall back to alphabetical, after the listed ones;
+ * non-built-in entries always sort after built-ins.
+ */
+const BUILTIN_ORDER: Record<string, number> = {
+  __model_select: 0,
+  __restore: 1,
+  __copy_editor: 2,
+  __clear_editor: 3,
+};
+
 // ── Helpers ────────────────────────────────────────────────────────
 
 function buildPaletteItems(pi: ExtensionAPI, ctx: ExtensionContext): PaletteItem[] {
@@ -127,6 +143,22 @@ function buildPaletteItems(pi: ExtensionAPI, ctx: ExtensionContext): PaletteItem
     action: { type: "editor", text: "/resume" },
   });
 
+  items.push({
+    value: "__copy_editor",
+    label: "Editor: Copy Content",
+    description: "Copy current editor text to clipboard",
+    category: "Built-in",
+    action: { type: "copy-editor" },
+  });
+
+  items.push({
+    value: "__clear_editor",
+    label: "Editor: Clear Content",
+    description: "Clear editor (recover via Restore)",
+    category: "Built-in",
+    action: { type: "clear-editor" },
+  });
+
   // ── Extension commands, skills, templates ────────────────────
   const commands = pi.getCommands();
   for (const cmd of commands) {
@@ -143,10 +175,17 @@ function buildPaletteItems(pi: ExtensionAPI, ctx: ExtensionContext): PaletteItem
     });
   }
 
-  // Sort: built-in first, then alphabetically within category
+  // Sort: built-in actions first, ordered by BUILTIN_ORDER (then alphabetical
+  // for unlisted built-ins); extension commands follow alphabetically.
   items.sort((a, b) => {
-    if (a.category === "Built-in" && b.category !== "Built-in") return -1;
-    if (a.category !== "Built-in" && b.category === "Built-in") return 1;
+    const aBuilt = a.category === "Built-in";
+    const bBuilt = b.category === "Built-in";
+    if (aBuilt !== bBuilt) return aBuilt ? -1 : 1;
+    if (aBuilt) {
+      const ai = BUILTIN_ORDER[a.value] ?? Number.MAX_SAFE_INTEGER;
+      const bi = BUILTIN_ORDER[b.value] ?? Number.MAX_SAFE_INTEGER;
+      if (ai !== bi) return ai - bi;
+    }
     return a.label.localeCompare(b.label);
   });
 
@@ -454,6 +493,29 @@ async function showCommandPalette(pi: ExtensionAPI, ctx: ExtensionContext): Prom
       ctx.ui.setEditorText("/reload");
       break;
     }
+    case "copy-editor": {
+      const text = ctx.ui.getEditorText();
+      if (text && text.trim()) {
+        await copyToClipboard(text);
+        ctx.ui.notify("Copied editor text to clipboard", "info");
+      } else {
+        ctx.ui.notify("Editor is empty", "warning");
+      }
+      break;
+    }
+    case "clear-editor": {
+      // Save current editor text to the restore buffer before clearing, so
+      // the built-in Restore action can bring it back.
+      const currentText = ctx.ui.getEditorText();
+      if (currentText && currentText.trim()) {
+        savedEditorText = currentText;
+        ctx.ui.setEditorText("");
+        ctx.ui.notify("Cleared editor — use Restore to recover", "info");
+      } else {
+        ctx.ui.notify("Editor is empty", "warning");
+      }
+      break;
+    }
   }
 }