@pellux/goodvibes-tui 0.19.96 → 0.19.98

package/CHANGELOG.md

@@ -4,6 +4,16 @@ All notable changes to GoodVibes TUI.
 
 ---
 
+## [0.19.98] — 2026-05-11
+
+### Changes
+- 6fa4c84b fix: pass owned project root to command paste
+
+## [0.19.97] — 2026-05-11
+
+### Changes
+- 256454c2 fix: support explicit clipboard image paste
+
 ## [0.19.96] — 2026-05-11
 
 ### Changes

package/README.md

@@ -2,7 +2,7 @@
 
 [![CI](https://github.com/mgd34msu/goodvibes-tui/actions/workflows/ci.yml/badge.svg)](https://github.com/mgd34msu/goodvibes-tui/actions/workflows/ci.yml)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-[![Version](https://img.shields.io/badge/version-0.19.96-blue.svg)](https://github.com/mgd34msu/goodvibes-tui)
+[![Version](https://img.shields.io/badge/version-0.19.98-blue.svg)](https://github.com/mgd34msu/goodvibes-tui)
 
 A terminal-native AI coding, operations, automation, knowledge, and integration console with a typed runtime, omnichannel surfaces, structured memory/knowledge, and a raw ANSI renderer.
 
@@ -1278,6 +1278,7 @@ Those pieces cover conversation-noise routing, panel-health/performance budgets,
 | `/keybindings` | `/kb` | List current keyboard bindings and their config file path |
 | `/schedule [action]` | `/sched` | Manage scheduled agent tasks (cron): add, list, remove, enable, disable, run |
 | `/image <path>` | `/img` | Attach an image file to the next message |
+| `/paste` | `/clip` | Pull supported text or image data directly from the system clipboard into the prompt |
 | `/refresh-models` | — | Refresh model catalog, benchmarks, and token limits |
 | `/notify [action]` | `/ntf` | Manage webhook notifications (ntfy.sh): add, remove, list, clear, test |
 | `/voice [action]` | — | Review optional voice posture and export/inspect voice bundles |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pellux/goodvibes-tui",
-  "version": "0.19.96",
+  "version": "0.19.98",
   "description": "Terminal-native GoodVibes product for coding, operations, automation, knowledge, channels, and daemon-backed control-plane workflows.",
   "type": "module",
   "main": "src/main.ts",

package/src/input/command-registry.ts

@@ -61,6 +61,11 @@ export interface CommandUiActions {
   submitInput?: (text: string, content?: import('@pellux/goodvibes-sdk/platform/providers').ContentPart[]) => void;
   submitSpokenInput?: (text: string, content?: import('@pellux/goodvibes-sdk/platform/providers').ContentPart[]) => void;
   stopSpokenOutput?: () => void;
+  pasteFromClipboard?: () => {
+    pasted: boolean;
+    kind: 'image' | 'text' | 'none';
+    marker?: string;
+  };
   executeCommand?: (name: string, args: string[]) => Promise<boolean>;
   cancelGeneration?: () => void;
   completeModelSelection?: (selection: {

package/src/input/commands/shell-core.ts

@@ -91,6 +91,22 @@ export function registerShellCoreCommands(registry: CommandRegistry): void {
     },
   });
 
+  registry.register({
+    name: 'paste',
+    aliases: ['clip'],
+    description: 'Insert clipboard text or image into the prompt',
+    handler(_args, ctx) {
+      if (!ctx.pasteFromClipboard) {
+        ctx.print('Paste is not available in this context.');
+        return;
+      }
+      const result = ctx.pasteFromClipboard();
+      if (!result.pasted) {
+        ctx.print('Clipboard does not contain supported text or image data.');
+      }
+    },
+  });
+
   registry.register({
     name: 'help',
     aliases: ['h', '?'],
@@ -135,6 +151,7 @@ export function registerShellCoreCommands(registry: CommandRegistry): void {
           { id: '/template save', label: '/template save <name>', detail: 'Save prompt as template', category: 'Templates' },
           { id: '/template use', label: '/template use <name>', detail: 'Execute template', category: 'Templates' },
           { id: '/tools', label: '/tools', detail: 'List available tools', category: 'Tools & System' },
+          { id: '/paste', label: '/paste', detail: 'Insert clipboard text or image into the prompt', category: 'Tools & System' },
           { id: '/shortcuts', label: '/shortcuts', detail: 'View keyboard shortcuts reference', category: 'Tools & System' },
           { id: '/commands', label: '/commands', detail: 'Browse all commands in a scrollable list', category: 'Tools & System' },
           { id: '/secrets', label: '/secrets set|link|get|test|list|delete', detail: 'Manage encrypted and provider-backed secrets', category: 'Tools & System' },
@@ -154,7 +171,7 @@ export function registerShellCoreCommands(registry: CommandRegistry): void {
         });
         return;
       }
-      ctx.print('Use /help to open the help modal. Commands: /model, /provider, /config, /template, /tools, /sessions, /bookmarks, /save, /load, /undo, /redo, /retry, /clear, /reset, /compact, /export, /title, /effort, /expand, /collapse, /debug, /quit, /wq');
+      ctx.print('Use /help to open the help modal. Commands: /model, /provider, /config, /template, /tools, /paste, /sessions, /bookmarks, /save, /load, /undo, /redo, /retry, /clear, /reset, /compact, /export, /title, /effort, /expand, /collapse, /debug, /quit, /wq');
     },
   });
 

package/src/input/feed-context-factory.ts

@@ -98,6 +98,7 @@ export interface FeedContextStableRefs {
   selection: SelectionManager;
   pasteRegistry: Map<string, string>;
   imageRegistry: Map<string, { data: string; mediaType: string }>;
+  projectRoot: string;
   selectionModal: SelectionModal;
   bookmarkModal: BookmarkModal;
   settingsModal: SettingsModal;

package/src/input/handler-command-route.ts

@@ -4,6 +4,7 @@ import type { AutocompleteEngine } from './autocomplete.ts';
 import type { InputToken } from '@pellux/goodvibes-sdk/platform/core';
 import type { ConversationManager } from '../core/conversation';
 import type { PanelManager } from '../panels/panel-manager.ts';
+import { handleClipboardPaste, type ClipboardPasteSource } from './handler-content-actions.ts';
 
 export type CommandModeRouteState = {
   commandMode: boolean;
@@ -18,6 +19,14 @@ export type CommandModeRouteState = {
   conversationManager: ConversationManager | null;
   requestRender: () => void;
   handleEscape: () => void;
+  projectRoot: string;
+  pasteRegistry: Map<string, string>;
+  imageRegistry: Map<string, { data: string; mediaType: string }>;
+  nextPasteId: number;
+  nextImageId: number;
+  saveUndoState: () => void;
+  ensureInputCursorVisible: () => void;
+  clipboard?: ClipboardPasteSource;
 };
 
 export function handleCommandModeToken(state: CommandModeRouteState, token: InputToken): boolean {
@@ -141,6 +150,24 @@ function withPanelFocusSync(context: CommandContext, state: CommandModeRouteStat
           state.panelFocused = false;
         }
       : undefined,
+    pasteFromClipboard: () => {
+      const result = handleClipboardPaste({
+        prompt: state.prompt,
+        cursorPos: state.cursorPos,
+        pasteRegistry: state.pasteRegistry,
+        nextPasteId: state.nextPasteId,
+        imageRegistry: state.imageRegistry,
+        nextImageId: state.nextImageId,
+        saveUndoState: state.saveUndoState,
+        ensureInputCursorVisible: state.ensureInputCursorVisible,
+        requestRender: state.requestRender,
+      }, context.workspace.shellPaths?.workingDirectory ?? state.projectRoot, state.clipboard);
+      state.prompt = result.prompt;
+      state.cursorPos = result.cursorPos;
+      state.nextImageId = result.nextImageId;
+      state.nextPasteId = result.nextPasteId;
+      return result;
+    },
     executeCommand: async (name, args) => {
       const wrapped = withPanelFocusSync(context, state);
       const handled = state.commandRegistry?.get(name)

package/src/input/handler-content-actions.ts

@@ -56,6 +56,23 @@ export type PasteRegistryState = {
   nextImageId: number;
 };
 
+export type ClipboardPasteKind = 'image' | 'text' | 'none';
+
+export interface ClipboardPasteResult {
+  prompt: string;
+  cursorPos: number;
+  nextImageId: number;
+  nextPasteId: number;
+  pasted: boolean;
+  kind: ClipboardPasteKind;
+  marker?: string;
+}
+
+export interface ClipboardPasteSource {
+  pasteImageFromClipboard: typeof pasteImageFromClipboard;
+  pasteFromClipboard: typeof pasteFromClipboard;
+}
+
 export function registerPaste(
   state: PasteRegistryState,
   content: string,
@@ -436,22 +453,34 @@ export function handleClipboardPaste(
     requestRender: () => void;
   },
   projectRoot: string,
-): { prompt: string; cursorPos: number; nextImageId: number; nextPasteId: number } {
-  state.saveUndoState();
-  const img = pasteImageFromClipboard();
+  clipboard: ClipboardPasteSource = { pasteImageFromClipboard, pasteFromClipboard },
+): ClipboardPasteResult {
+  const img = clipboard.pasteImageFromClipboard();
+  let pasted = false;
+  let kind: ClipboardPasteKind = 'none';
+  let insertedMarker: string | undefined;
+
   if (img) {
+    state.saveUndoState();
     const id = `img${state.nextImageId++}`;
     const sizeKB = Math.round(img.data.length * 3 / 4 / 1024);
     state.imageRegistry.set(id, img);
     const marker = `[IMAGE: ${id}, clipboard, ${sizeKB}KB]`;
     state.prompt = state.prompt.slice(0, state.cursorPos) + marker + state.prompt.slice(state.cursorPos);
     state.cursorPos += marker.length;
+    pasted = true;
+    kind = 'image';
+    insertedMarker = marker;
   } else {
-    const raw = pasteFromClipboard();
+    const raw = clipboard.pasteFromClipboard();
     if (raw) {
+      state.saveUndoState();
       const { marker } = registerPaste(state, raw, projectRoot);
       state.prompt = state.prompt.slice(0, state.cursorPos) + marker + state.prompt.slice(state.cursorPos);
       state.cursorPos += marker.length;
+      pasted = true;
+      kind = marker.startsWith('[IMAGE:') ? 'image' : 'text';
+      insertedMarker = marker;
     }
   }
   state.ensureInputCursorVisible();
@@ -461,5 +490,8 @@ export function handleClipboardPaste(
     cursorPos: state.cursorPos,
     nextImageId: state.nextImageId,
     nextPasteId: state.nextPasteId,
+    pasted,
+    kind,
+    marker: insertedMarker,
   };
 }

package/src/input/handler-feed.ts

@@ -100,6 +100,7 @@ export interface InputFeedContext {
   contentWidth: number;
   readonly pasteRegistry: Map<string, string>;
   readonly imageRegistry: Map<string, { data: string; mediaType: string }>;
+  readonly projectRoot: string;
   readonly selection: SelectionManager;
   readonly selectionModal: SelectionModal;
   selectionCallback: ((result: SelectionResult | null) => void) | null;
@@ -354,12 +355,21 @@ export function feedInputTokens(context: InputFeedContext, tokens: readonly Inpu
         conversationManager: context.conversationManager,
         requestRender: context.requestRender,
         handleEscape: context.handleEscape,
+        projectRoot: context.projectRoot,
+        pasteRegistry: context.pasteRegistry,
+        imageRegistry: context.imageRegistry,
+        nextPasteId: context.nextPasteId,
+        nextImageId: context.nextImageId,
+        saveUndoState: context.saveUndoState,
+        ensureInputCursorVisible: () => context.ensureInputCursorVisible(),
       };
       if (handleCommandModeToken(commandState, token)) {
         context.commandMode = commandState.commandMode;
         context.prompt = commandState.prompt;
         context.cursorPos = commandState.cursorPos;
         context.panelFocused = commandState.panelFocused;
+        context.nextPasteId = commandState.nextPasteId;
+        context.nextImageId = commandState.nextImageId;
         continue;
       }
 

package/src/input/handler.ts

@@ -271,6 +271,7 @@ export class InputHandler {
         selection: this.selection,
         pasteRegistry: this.pasteRegistry,
         imageRegistry: this.imageRegistry,
+        projectRoot: this.uiServices.environment.shellPaths.workingDirectory,
         selectionModal: this.selectionModal,
         bookmarkModal: this.bookmarkModal,
         settingsModal: this.settingsModal,
@@ -502,7 +503,7 @@ export class InputHandler {
    * handlePaste - Shared paste logic for Ctrl+V and middle-click.
    * Tries image clipboard first, falls back to text paste.
    */
-  public handlePaste(): void {
+  public handlePaste(): ReturnType<typeof handleClipboardPaste> {
     const result = handleClipboardPaste({
       prompt: this.prompt,
       cursorPos: this.cursorPos,
@@ -518,6 +519,11 @@ export class InputHandler {
     this.cursorPos = result.cursorPos;
     this.nextImageId = result.nextImageId;
     this.nextPasteId = result.nextPasteId;
+    if (!result.pasted) {
+      this.conversationManager?.log('[Paste: clipboard does not contain supported text or image data]', { fg: '240' });
+      this.requestRender();
+    }
+    return result;
   }
 
   /** Content width for wrapping — set by main.ts via setContentWidth(). */

package/src/main.ts

@@ -376,6 +376,7 @@ async function main() {
   commandContext.submitInput = submitInput;
   commandContext.submitSpokenInput = (text, content) => submitInput(text, content, { spokenOutput: true });
   commandContext.stopSpokenOutput = () => spokenTurns.stop();
+  commandContext.pasteFromClipboard = () => input.handlePaste();
   commandContext.executeCommand = (name, args) => commandRegistry.execute(name, args, commandContext);
   commandContext.cancelGeneration = cancelGeneration;
   commandContext.jumpToBookmark = jumpToBookmark;

package/src/version.ts

@@ -6,7 +6,7 @@ import { join } from 'node:path';
 // The prebuild script updates the fallback value before compilation.
 // Uses import.meta.dir (Bun) to locate package.json relative to this file,
 // which is correct regardless of the process working directory.
-let _version = '0.19.96';
+let _version = '0.19.98';
 try {
   const pkg = JSON.parse(readFileSync(join(import.meta.dir, '..', 'package.json'), 'utf-8'));
   _version = pkg.version ?? _version;