@pellux/goodvibes-agent 0.1.116 → 1.0.0

package/src/renderer/onboarding/onboarding-wizard.ts

@@ -161,16 +161,28 @@ function fieldHint(
     const rawValue = wizard.editBuffer.length > 0 ? wizard.editBuffer : field.placeholder;
     const editingValue = field.kind === 'masked' && wizard.editBuffer.length > 0
       ? '•'.repeat(Math.min(12, Math.max(4, wizard.editBuffer.length)))
-      : rawValue;
+      : formatEditingValue(rawValue, field.kind === 'text' && field.multiline === true);
     return `Editing: ${editingValue}█`;
   }
 
   if (selected && field.kind === 'modelPicker') return `${field.hint} Press Enter to open picker.`;
-  if (selected && field.kind === 'text') return `${field.hint} Press Enter to edit inline.`;
+  if (selected && field.kind === 'text') {
+    return field.multiline === true
+      ? `${field.hint} Press Enter to edit; Ctrl-J inserts a new line.`
+      : `${field.hint} Press Enter to edit inline.`;
+  }
   if (selected && field.kind === 'masked') return `${field.hint} Press Enter to edit inline.`;
   return field.hint;
 }
 
+function formatEditingValue(value: string, multiline: boolean): string {
+  if (!multiline) return value;
+  const lines = value.split(/\r?\n/);
+  if (lines.length <= 1) return value;
+  const preview = lines[lines.length - 1] ?? '';
+  return `${preview} (${lines.length} lines)`;
+}
+
 function fieldRowPrefix(
   wizard: OnboardingWizardController,
   field: OnboardingWizardFieldDefinition,
@@ -255,7 +267,9 @@ function renderFieldRow(
 
 function footerText(wizard: OnboardingWizardController): string {
   if (wizard.isEditingTextField()) {
-    return '[Enter] Save value  [Esc] Cancel edit  [Backspace] Delete char  [Del/Ctrl+U] Clear value';
+    return wizard.isEditingMultilineTextField()
+      ? '[Enter] Save value  [Ctrl-J] New line  [Esc] Cancel edit  [Backspace] Delete char  [Del/Ctrl+U] Clear value'
+      : '[Enter] Save value  [Esc] Cancel edit  [Backspace] Delete char  [Del/Ctrl+U] Clear value';
   }
 
   return '[Enter] Toggle/open  [Esc] Close  [Tab/Shift+Tab] Screen  [↑↓] Move  [Del/Ctrl+U] Clear input';
@@ -263,7 +277,9 @@ function footerText(wizard: OnboardingWizardController): string {
 
 function controlsText(wizard: OnboardingWizardController): string {
   if (wizard.isEditingTextField()) {
-    return 'Controls: Enter saves, Esc cancels, Backspace deletes, Del clears.';
+    return wizard.isEditingMultilineTextField()
+      ? 'Controls: Enter saves, Ctrl-J inserts a line, Esc cancels, Backspace deletes, Del clears.'
+      : 'Controls: Enter saves, Esc cancels, Backspace deletes, Del clears.';
   }
   return 'Controls: Enter selects, Del clears, Tab moves.';
 }

package/src/renderer/process-modal.ts

@@ -15,6 +15,11 @@ export interface ProcessEntry {
 
 const MAX_LABEL_LENGTH = 80;
 const MODAL_BORDER_WIDTH = 8;
+const PROCESS_MODAL_TITLE = 'Runtime Activity';
+const PROCESS_MODAL_EMPTY_MESSAGE = 'No running shell processes.';
+const PROCESS_MODAL_EMPTY_HINTS = ['[Esc] Close'];
+const PROCESS_MODAL_ACTIVE_HINTS = ['[Up/Down] Navigate', '[Enter] Output', '[k] Stop process', '[Esc] Close'];
+const PROCESS_MODAL_TYPE_TAG = '[exec]';
 
 export interface ProcessModalDeps {
   readonly processManager: Pick<ProcessManager, 'list' | 'getStatus' | 'stop'>;
@@ -101,6 +106,22 @@ export class ProcessModal {
   }
 }
 
+export function renderProcessModalPackageText(): string {
+  return [
+    PROCESS_MODAL_TITLE,
+    PROCESS_MODAL_EMPTY_MESSAGE,
+    PROCESS_MODAL_TYPE_TAG,
+    '*',
+    '!',
+    '-',
+    'running',
+    'failed',
+    '<duration>',
+    ...PROCESS_MODAL_EMPTY_HINTS,
+    ...PROCESS_MODAL_ACTIVE_HINTS,
+  ].join('\n');
+}
+
 export function renderProcessModal(modal: ProcessModal, width: number, viewportHeight = 24): Line[] {
   modal.refresh();
 
@@ -118,14 +139,14 @@ export function renderProcessModal(modal: ProcessModal, width: number, viewportH
 
   if (modal.entries.length === 0) {
     return ModalFactory.createModal({
-      title: 'Runtime Activity',
+      title: PROCESS_MODAL_TITLE,
       width: boxW,
       margin: boxMargin,
       targetContentRows,
       sections: [
-        { type: 'text', content: 'No running shell processes.' },
+        { type: 'text', content: PROCESS_MODAL_EMPTY_MESSAGE },
       ],
-      hints: ['[Esc] Close'],
+      hints: PROCESS_MODAL_EMPTY_HINTS,
     }, width);
   }
 
@@ -138,7 +159,7 @@ export function renderProcessModal(modal: ProcessModal, width: number, viewportH
     const statusIcon = entry.status === 'running' ? '*' : entry.status === 'failed' ? '!' : '-';
     const dur = formatDuration(entry.elapsedMs);
     const suffix = `  ${entry.status}  ${dur}`;
-    const typeTag = '[exec]';
+    const typeTag = PROCESS_MODAL_TYPE_TAG;
     const maxDescW = Math.max(0, maxLabelW - typeTag.length - suffix.length - 4);
     const desc = entry.label.length > maxDescW ? `${entry.label.slice(0, Math.max(0, maxDescW - 3))}...` : entry.label;
     return {
@@ -150,7 +171,7 @@ export function renderProcessModal(modal: ProcessModal, width: number, viewportH
   if (modal.entries.length > maxVisibleRows) sections.push({ type: 'separator' });
 
   return ModalFactory.createModal({
-    title: 'Runtime Activity',
+    title: PROCESS_MODAL_TITLE,
     width: boxW,
     margin: boxMargin,
     targetContentRows,
@@ -158,6 +179,6 @@ export function renderProcessModal(modal: ProcessModal, width: number, viewportH
     helpers: modal.entries.length > maxVisibleRows
       ? [{ content: `[${window.start + 1}-${window.end} of ${modal.entries.length}]` }]
       : undefined,
-    hints: ['[Up/Down] Navigate', '[Enter] Output', '[k] Stop process', '[Esc] Close'],
+    hints: PROCESS_MODAL_ACTIVE_HINTS,
   }, width);
 }

package/src/renderer/profile-picker-modal.ts

@@ -1,5 +1,5 @@
 /**
- * renderProfilePickerModal — renders the /profiles picker modal as Line[]
+ * renderProfilePickerModal — renders the Agent profile picker modal as Line[]
  * using ModalFactory.
  *
  * Shows a list of saved profiles with:
@@ -10,6 +10,7 @@
 import type { Line } from '../types/grid.ts';
 import { ModalFactory } from './modal-factory.ts';
 import type { ProfilePickerModal } from '../input/profile-picker-modal.ts';
+import { renderProfilePickerStatePackageText } from '../input/profile-picker-modal.ts';
 import { formatTimestamp } from './modal-utils.ts';
 import { fitDisplay } from '../utils/terminal-width.ts';
 import { getOverlaySurfaceMetrics, getStableOverlayContentRows } from './overlay-viewport.ts';
@@ -18,6 +19,23 @@ import { getOverlaySurfaceMetrics, getStableOverlayContentRows } from './overlay
 // Renderer
 // ---------------------------------------------------------------------------
 
+export function renderProfilePickerPackageText(): string {
+  return [
+    'Profiles',
+    'No saved profiles.',
+    'Open Agent Workspace -> Profiles to create and manage isolated Agent profile homes.',
+    'Name',
+    'Saved',
+    'Settings',
+    '(display/provider/behavior)',
+    '[Up/Down] Navigate',
+    '[Enter] Load',
+    'Agent profiles: /agent profiles',
+    '[Esc] Close',
+    renderProfilePickerStatePackageText(),
+  ].join('\n');
+}
+
 /**
  * Render the profile picker modal as Line[] for overlay in the viewport.
  *
@@ -51,7 +69,7 @@ export function renderProfilePickerModal(
     });
     sections.push({
       type: 'text',
-      content: 'Use /profiles save <name> --yes to save the current settings as a profile.',
+      content: 'Open Agent Workspace -> Profiles to create and manage isolated Agent profile homes.',
       style: { fg: '240', dim: true },
     });
   } else {
@@ -79,8 +97,6 @@ export function renderProfilePickerModal(
 
       const tsStr = fitDisplay(formatTimestamp(prof.timestamp), tsW);
 
-      // Read the profile file to get a preview of settings
-      // (We only have name/timestamp in ProfileInfo, so show a placeholder)
       const preview = fitDisplay('(display/provider/behavior)', previewW);
 
       const label = `${nameStr}  ${tsStr}  ${preview}`;
@@ -114,7 +130,7 @@ export function renderProfilePickerModal(
       margin: boxMargin,
       targetContentRows,
       sections,
-      hints: ['[Up/Down] Navigate', '[Enter] Load', '/profiles save|delete --yes', '[Esc] Close'],
+      hints: ['[Up/Down] Navigate', '[Enter] Load', 'Agent profiles: /agent profiles', '[Esc] Close'],
     },
     width,
   );

package/src/renderer/search-overlay.ts

@@ -3,6 +3,26 @@ import { fitDisplay, getDisplayWidth, truncateDisplay } from '../utils/terminal-
 import type { SearchManager } from '../input/search.ts';
 import { createBottomBarLine, writeBottomBarText } from './bottom-bar.ts';
 
+const SEARCH_OVERLAY_LABEL = ' Find: ';
+const SEARCH_OVERLAY_NO_MATCHES = 'No matches';
+const SEARCH_OVERLAY_COUNT_SUFFIX = 'up/down';
+const SEARCH_OVERLAY_LOCKED_HINTS = '  [Up/Down] or [jk] navigate  [Bksp] edit  [Esc] close';
+const SEARCH_OVERLAY_UNLOCKED_HINTS = '  [Enter/Tab] lock  [Esc] close';
+
+function searchOverlayMatchCount(current: string | number, total: string | number): string {
+  return `${current}/${total} ${SEARCH_OVERLAY_COUNT_SUFFIX}`;
+}
+
+export function renderSearchOverlayPackageText(): string {
+  return [
+    SEARCH_OVERLAY_LABEL.trim(),
+    searchOverlayMatchCount('<current>', '<total>'),
+    SEARCH_OVERLAY_NO_MATCHES,
+    SEARCH_OVERLAY_LOCKED_HINTS.trim(),
+    SEARCH_OVERLAY_UNLOCKED_HINTS.trim(),
+  ].join('\n');
+}
+
 /**
  * Render the search bar as a single Line[] overlay at the bottom of the viewport.
  * Format: [ Find: <query>   3/17 up/down  [n] next [N] prev [Esc] close ]
@@ -14,18 +34,18 @@ export function renderSearchOverlay(
 ): Line[] {
   // Match count text — displayed in dim grey, right of query, left of hints
   const matchCount = manager.matches?.length > 0
-    ? `${manager.currentMatch + 1}/${manager.matches.length} up/down`
+    ? searchOverlayMatchCount(manager.currentMatch + 1, manager.matches.length)
     : manager.query.length > 0
-      ? 'No matches'
+      ? SEARCH_OVERLAY_NO_MATCHES
       : '';
 
   const locked = manager.locked;
   const cursor = locked ? '' : '█';
   const queryDisplay = manager.query + cursor;
   const hints = locked
-    ? '  [Up/Down] or [jk] navigate  [Bksp] edit  [Esc] close'
-    : '  [Enter/Tab] lock  [Esc] close';
-  const label = ' Find: ';
+    ? SEARCH_OVERLAY_LOCKED_HINTS
+    : SEARCH_OVERLAY_UNLOCKED_HINTS;
+  const label = SEARCH_OVERLAY_LABEL;
   const matchStr = matchCount ? ` ${matchCount}` : '';
 
   // Build left portion: label + query (no match count — that gets separate styling)

package/src/renderer/selection-modal-overlay.ts

@@ -1,6 +1,6 @@
 import { type Line } from '../types/grid.ts';
 import { fitDisplay, getDisplayWidth, truncateDisplay } from '../utils/terminal-width.ts';
-import type { SelectionModal } from '../input/selection-modal.ts';
+import type { SelectionAction, SelectionModal } from '../input/selection-modal.ts';
 import {
   createOverlayBoxLayout,
   createOverlayContentLine,
@@ -18,6 +18,14 @@ const BODY_FG = DEFAULT_OVERLAY_PALETTE.bodyFg;
 const MUTED_FG = DEFAULT_OVERLAY_PALETTE.mutedFg;
 const CATEGORY_FG = '#4488cc';
 const SELECTED_BG = DEFAULT_OVERLAY_PALETTE.selectedBg;
+const SELECTION_MODAL_SEARCH_LABEL = ' Search';
+const SELECTION_MODAL_RESULTS_LABEL = ' Results';
+const SELECTION_MODAL_NO_MATCHING_ITEMS = 'No matching items';
+const SELECTION_MODAL_NO_ITEMS = 'No items';
+const SELECTION_MODAL_NAVIGATION_HINT = '[Up/Down] Navigate';
+const SELECTION_MODAL_CLOSE_HINT = '[Esc] Close';
+const SELECTION_MODAL_SEARCH_HINT = '[/] Search';
+const SELECTION_MODAL_SPACE_TOGGLE_HINT = '[Space] Toggle';
 
 interface CellStyle {
   fg: string;
@@ -30,6 +38,36 @@ function putText(line: Line, startX: number, maxWidth: number, text: string, sty
   putOverlayText(line, startX, maxWidth, text, style);
 }
 
+function primaryVerbForAction(primaryAction: SelectionAction | undefined): string {
+  return primaryAction === 'toggle'
+    ? '[Enter] Toggle'
+    : primaryAction === 'edit'
+    ? '[Enter] Edit'
+    : primaryAction === 'delete'
+    ? '[Enter] Delete'
+    : '[Enter] Select';
+}
+
+export function renderSelectionModalPackageText(): string {
+  return [
+    SELECTION_MODAL_SEARCH_LABEL.trim(),
+    SELECTION_MODAL_RESULTS_LABEL.trim(),
+    SELECTION_MODAL_NO_MATCHING_ITEMS,
+    SELECTION_MODAL_NO_ITEMS,
+    '(<above> above, <below> below)',
+    '(<below> below)',
+    '(<above> above)',
+    SELECTION_MODAL_NAVIGATION_HINT,
+    primaryVerbForAction(undefined),
+    primaryVerbForAction('toggle'),
+    primaryVerbForAction('edit'),
+    primaryVerbForAction('delete'),
+    SELECTION_MODAL_CLOSE_HINT,
+    SELECTION_MODAL_SEARCH_HINT,
+    SELECTION_MODAL_SPACE_TOGGLE_HINT,
+  ].join('\n');
+}
+
 /**
  * Render the selection modal as Line[] for overlay in the viewport.
  */
@@ -62,7 +100,7 @@ export function renderSelectionModalOverlay(
 
   if (modal.allowSearch) {
     const labelLine = createOverlayContentLine(width, layout, BORDER_FG, DEFAULT_OVERLAY_PALETTE.sectionBg);
-    putText(labelLine, layout.margin + 2, layout.innerWidth, fitDisplay(' Search', layout.innerWidth), {
+    putText(labelLine, layout.margin + 2, layout.innerWidth, fitDisplay(SELECTION_MODAL_SEARCH_LABEL, layout.innerWidth), {
       fg: CATEGORY_FG,
       dim: true,
     });
@@ -86,7 +124,7 @@ export function renderSelectionModalOverlay(
   }
 
   const listTitle = createOverlayContentLine(width, layout, BORDER_FG, DEFAULT_OVERLAY_PALETTE.sectionBg);
-  putText(listTitle, layout.margin + 2, layout.innerWidth, fitDisplay(' Results', layout.innerWidth), {
+  putText(listTitle, layout.margin + 2, layout.innerWidth, fitDisplay(SELECTION_MODAL_RESULTS_LABEL, layout.innerWidth), {
     fg: CATEGORY_FG,
     dim: true,
   });
@@ -95,7 +133,7 @@ export function renderSelectionModalOverlay(
   const items = modal.filteredItems;
   if (items.length === 0) {
     const line = createOverlayContentLine(width, layout, BORDER_FG, DEFAULT_OVERLAY_PALETTE.bodyBg);
-    const message = modal.query ? 'No matching items' : 'No items';
+    const message = modal.query ? SELECTION_MODAL_NO_MATCHING_ITEMS : SELECTION_MODAL_NO_ITEMS;
     putText(line, layout.margin + 2, layout.innerWidth, fitDisplay(message, layout.innerWidth), { fg: MUTED_FG, dim: true });
     lines.push(line);
   } else {
@@ -189,16 +227,10 @@ export function renderSelectionModalOverlay(
 
   const footerLine = createOverlayContentLine(width, layout, BORDER_FG, DEFAULT_OVERLAY_PALETTE.sectionBg);
   const selectedItem = modal.getSelected();
-  const primaryVerb = selectedItem?.primaryAction === 'toggle'
-    ? '[Enter] Toggle'
-    : selectedItem?.primaryAction === 'edit'
-    ? '[Enter] Edit'
-    : selectedItem?.primaryAction === 'delete'
-    ? '[Enter] Delete'
-    : '[Enter] Select';
-  let hints = `[Up/Down] Navigate  ${primaryVerb}  [Esc] Close`;
-  if (modal.allowSearch) hints += '  [/] Search';
-  if (selectedItem?.primaryAction === 'toggle' && !selectedItem.actions) hints += '  [Space] Toggle';
+  const primaryVerb = primaryVerbForAction(selectedItem?.primaryAction);
+  let hints = `${SELECTION_MODAL_NAVIGATION_HINT}  ${primaryVerb}  ${SELECTION_MODAL_CLOSE_HINT}`;
+  if (modal.allowSearch) hints += `  ${SELECTION_MODAL_SEARCH_HINT}`;
+  if (selectedItem?.primaryAction === 'toggle' && !selectedItem.actions) hints += `  ${SELECTION_MODAL_SPACE_TOGGLE_HINT}`;
   if (selectedItem?.actions) hints += `  ${selectedItem.actions}`;
   putText(
     footerLine,

package/src/renderer/session-picker-modal.ts

@@ -10,6 +10,7 @@
 import type { Line } from '../types/grid.ts';
 import { ModalFactory } from './modal-factory.ts';
 import type { SessionPickerModal } from '../input/session-picker-modal.ts';
+import { renderSessionPickerStatePackageText } from '../input/session-picker-modal.ts';
 import { formatTimestamp } from './modal-utils.ts';
 import { fitDisplay } from '../utils/terminal-width.ts';
 import { getOverlaySurfaceMetrics, getStableOverlayContentRows } from './overlay-viewport.ts';
@@ -18,6 +19,22 @@ import { getOverlaySurfaceMetrics, getStableOverlayContentRows } from './overlay
 // Renderer
 // ---------------------------------------------------------------------------
 
+export function renderSessionPickerPackageText(): string {
+  return [
+    'Sessions',
+    'No saved sessions.',
+    'Open Agent Workspace -> Conversation -> Save current session.',
+    'Name',
+    'Saved',
+    'Msgs',
+    '[\u2191\u2193] Navigate',
+    '[Enter] Load',
+    'Delete: /session delete <id> --yes',
+    '[Esc] Close',
+    renderSessionPickerStatePackageText(),
+  ].join('\n');
+}
+
 /**
  * Render the session picker modal as Line[] for overlay in the viewport.
  *
@@ -51,7 +68,7 @@ export function renderSessionPickerModal(
     });
     sections.push({
       type: 'text',
-      content: 'Use /save [name] to save the current session.',
+      content: 'Open Agent Workspace -> Conversation -> Save current session.',
       style: { fg: '240', dim: true },
     });
   } else {

package/src/renderer/settings-modal-helpers.ts

@@ -82,33 +82,21 @@ export const CATEGORY_LABELS: Record<(typeof SETTINGS_CATEGORIES)[number], strin
   behavior: 'Behavior',
   storage: 'Storage',
   permissions: 'Permissions',
-  orchestration: 'Orchestration',
-  wrfc: 'WRFC Delegation',
   helper: 'Helper',
   tts: 'TTS',
-  service: 'Runtime Install',
-  controlPlane: 'Runtime API',
-  httpListener: 'Inbound Events',
-  web: 'Browser Companion',
-  batch: 'Batch',
   automation: 'Automation',
-  watchers: 'Watchers',
-  runtime: 'Runtime',
   telemetry: 'Telemetry',
   cache: 'Cache',
   mcp: 'MCP',
   surfaces: 'Channels',
-  release: 'Release',
-  danger: 'Danger',
+  release: 'Update Channel',
   tools: 'Tools',
-  flags: 'Feature Flags',
-  network: 'Network',
+  flags: 'Feature Controls',
 };
 
 export const SETTING_LABELS: Partial<Record<string, string>> = {
   'ui.systemMessages': 'System Message Target',
   'ui.operationalMessages': 'Operational Message Target',
-  'ui.wrfcMessages': 'Delegated WRFC Message Target',
   'ui.voiceEnabled': 'Voice Interaction',
   'behavior.autoCompactThreshold': 'Auto-Compact %',
   'behavior.staleContextWarnings': 'Context Warnings',
@@ -123,32 +111,6 @@ export const SETTING_LABELS: Partial<Record<string, string>> = {
   'helper.enabled': 'Helper Enabled',
   'helper.globalProvider': 'Helper Provider',
   'helper.globalModel': 'Helper Model',
-  // Runtime API
-  'controlPlane.enabled': 'Runtime API Enabled',
-  'controlPlane.hostMode': 'Runtime API Host Mode',
-  'controlPlane.host': 'Runtime API Host',
-  'controlPlane.port': 'Runtime API Port',
-  'controlPlane.baseUrl': 'Runtime API Base URL',
-  'controlPlane.streamMode': 'Runtime API Stream Mode',
-  'controlPlane.allowRemote': 'Runtime API Allow Remote',
-  'controlPlane.trustProxy': 'Runtime API Trust Proxy',
-  'controlPlane.tls.mode': 'Runtime API TLS Mode',
-  'controlPlane.tls.certFile': 'Runtime API TLS Cert',
-  'controlPlane.tls.keyFile': 'Runtime API TLS Key',
-  // Inbound event endpoint
-  'httpListener.hostMode': 'HTTP Host Mode',
-  'httpListener.host': 'HTTP Host',
-  'httpListener.port': 'HTTP Port',
-  'httpListener.trustProxy': 'HTTP Trust Proxy',
-  'httpListener.tls.mode': 'HTTP TLS Mode',
-  'httpListener.tls.certFile': 'HTTP TLS Cert',
-  // Browser companion
-  'web.enabled': 'Web Enabled',
-  'web.hostMode': 'Web Host Mode',
-  'web.host': 'Web Host',
-  'web.port': 'Web Port',
-  'web.publicBaseUrl': 'Web Public Base URL',
-  'web.staticAssetsDir': 'Web Static Assets Dir',
   'surfaces.ntfy.enabled': 'ntfy Enabled',
   'surfaces.ntfy.baseUrl': 'ntfy Base URL',
   'surfaces.ntfy.topic': 'ntfy Default Delivery Topic',