@pellux/goodvibes-agent 0.1.117 → 1.0.0

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 /agent profiles to create and manage isolated Agent profile homes.',
+      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}`;

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: 'Build Delegation',
   helper: 'Helper',
   tts: 'TTS',
-  service: 'Connected Host',
-  controlPlane: 'Connected API',
-  httpListener: 'Inbound Delivery',
-  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 Build 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': 'Connected API Enabled',
-  'controlPlane.hostMode': 'Connected API Host Mode',
-  'controlPlane.host': 'Connected API Host',
-  'controlPlane.port': 'Connected API Port',
-  'controlPlane.baseUrl': 'Connected API Base URL',
-  'controlPlane.streamMode': 'Connected API Stream Mode',
-  'controlPlane.allowRemote': 'Connected API Allow Remote',
-  'controlPlane.trustProxy': 'Connected API Trust Proxy',
-  'controlPlane.tls.mode': 'Connected API TLS Mode',
-  'controlPlane.tls.certFile': 'Connected API TLS Cert',
-  'controlPlane.tls.keyFile': 'Connected API TLS Key',
-  // Inbound delivery endpoint
-  'httpListener.hostMode': 'Inbound Delivery Host Mode',
-  'httpListener.host': 'Inbound Delivery Host',
-  'httpListener.port': 'Inbound Delivery Port',
-  'httpListener.trustProxy': 'Inbound Delivery Trust Proxy',
-  'httpListener.tls.mode': 'Inbound Delivery TLS Mode',
-  'httpListener.tls.certFile': 'Inbound Delivery 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',

package/src/renderer/settings-modal.ts

@@ -11,6 +11,7 @@ import { isExternalHostOwnedSettingKey, SETTINGS_CATEGORIES, SETTINGS_CATEGORY_G
 import { getDisplayWidth, wrapText } from '../utils/terminal-width.ts';
 import { CATEGORY_LABELS, describeUiRouting, formatValue, getSettingLabel, inferSubscriptionRouteReason, valueColor } from './settings-modal-helpers.ts';
 import { isSecretConfigKey } from '../config/secret-config.ts';
+import { formatProviderAuthRouteId } from '../provider-auth-route-display.ts';
 import { GLYPHS } from './ui-primitives.ts';
 import {
   clamp,
@@ -30,27 +31,16 @@ const CATEGORY_INFO: Record<SettingsCategory, string> = {
   behavior: 'Day-to-day shell behavior: approval posture, compaction, history, guidance, notifications, stale-context warnings, return context, and Human-in-the-Loop mode.',
   storage: 'Local storage posture, including secret storage policy and maximum artifact size for Agent Knowledge, artifacts, and document ingestion.',
   permissions: 'Permission mode and tool-class policy. These settings decide whether the shell prompts before read/write/exec/network/agent actions.',
-  orchestration: 'Hidden compatibility settings. Normal Agent operation stays serial and does not expose local spawn fanout.',
-  wrfc: 'Build-review routing is external to normal Agent operation. Review these compatibility values only for explicit delegated build work.',
   helper: 'Helper model defaults used by helper subsystems when they do not use the main chat route.',
   tts: 'Text-to-speech provider, voice, and optional spoken-turn LLM overrides.',
-  service: 'Connected-host status posture. Agent inspects these values only and does not install, start, stop, restart, or autostart anything.',
-  controlPlane: 'Connected API settings. Agent uses these values for access and does not mutate bind posture.',
-  httpListener: 'Inbound delivery endpoint settings owned by the connected GoodVibes host. Agent inspects readiness and does not expose endpoints.',
-  web: 'External browser companion settings. Agent does not own browser hosting or network bind lifecycle.',
-  batch: 'Queued execution settings reported from the connected GoodVibes host. Agent does not own remote queue provisioning.',
   automation: 'Scheduled and automated run settings, concurrency, timeout, catch-up, cooldown, and retention behavior.',
-  watchers: 'File/process watcher heartbeat, polling, and recovery-window behavior.',
-  runtime: 'Connected-host guardrails such as companion chat limits and event-stream caps.',
   telemetry: 'Telemetry payload policy.',
   cache: 'Provider and model cache behavior, TTL, and hit-rate monitoring.',
   mcp: 'MCP server trust and scope review. Trust changes can expose local files, tools, databases, browsers, or remote automation depending on the server.',
   surfaces: 'Messaging and notification channel accounts such as Slack, Discord, ntfy, Telegram, chat bridges, and delivery providers.',
-  release: 'Release-channel preference.',
-  danger: 'High-impact host switches. Agent renders host-owned switches read-only; change them outside Agent.',
+  release: 'Update-channel preference.',
   tools: 'Tool LLM and helper model routing. Empty provider/model values inherit the active chat route unless a specific helper/tool route is set.',
-  flags: 'Feature flags are SDK gates. They are separate from normal config keys because they enable or disable staged behavior.',
-  network: 'Read-only view of connected GoodVibes API, inbound delivery, and browser companion bind posture plus editable Agent network settings.',
+  flags: 'Feature controls for optional behavior that can be enabled or disabled separately from normal configuration.',
 };
 
 const ENUM_VALUE_DESCRIPTIONS: Record<string, Record<string, string>> = {
@@ -74,26 +64,6 @@ const ENUM_VALUE_DESCRIPTIONS: Record<string, Record<string, string>> = {
     require_secure: 'Require secure secret storage and reject plaintext fallback.',
     plaintext_allowed: 'Allow plaintext fallback when secure storage is unavailable.',
   },
-  'batch.mode': {
-    off: 'Keep runtime work on the immediate local path.',
-    explicit: 'Use batch only when callers explicitly request batch execution.',
-    'eligible-by-default': 'Allow eligible runtime work to use the batch path unless callers opt out.',
-  },
-  'controlPlane.hostMode': {
-    localhost: 'Bind only to this computer.',
-    network: 'Bind for LAN access using the default network host.',
-    custom: 'Use the explicit host value in the related host setting.',
-  },
-  'httpListener.hostMode': {
-    localhost: 'Bind only to this computer.',
-    network: 'Bind for LAN event delivery using the default network host.',
-    custom: 'Use the explicit host value in the related host setting.',
-  },
-  'web.hostMode': {
-    localhost: 'Serve the browser UI only on this computer.',
-    network: 'Serve the browser UI on the LAN.',
-    custom: 'Use the explicit host value in the related host setting.',
-  },
   'ui.systemMessages': {
     panel: 'Show system messages in panels only.',
     conversation: 'Show system messages inline in the transcript.',
@@ -104,11 +74,6 @@ const ENUM_VALUE_DESCRIPTIONS: Record<string, Record<string, string>> = {
     conversation: 'Show operational messages inline in the transcript.',
     both: 'Show operational messages in both panels and the transcript.',
   },
-  'ui.wrfcMessages': {
-    panel: 'Show explicit delegated build messages in panels only.',
-    conversation: 'Show explicit delegated build messages inline in the transcript.',
-    both: 'Show explicit delegated build messages in both panels and the transcript.',
-  },
   'surfaces.telegram.mode': {
     webhook: 'Receive Telegram updates through externally hosted delivery.',
     polling: 'Poll Telegram for updates from the configured account.',
@@ -155,7 +120,6 @@ function buildSettingContext(modal: SettingsModal, entry: SettingEntry): string[
   if (
     entry.setting.key === 'ui.systemMessages'
     || entry.setting.key === 'ui.operationalMessages'
-    || entry.setting.key === 'ui.wrfcMessages'
   ) {
     lines.push(`Routing meaning: ${describeUiRouting(String(entry.currentValue))}.`);
   }
@@ -194,8 +158,12 @@ function buildSettingContext(modal: SettingsModal, entry: SettingEntry): string[
   return lines;
 }
 
+function formatSubscriptionRoute(route: SubscriptionEntry['activeRoute'] | SubscriptionEntry['preferredRoute']): string {
+  return route ? formatProviderAuthRouteId(route) : 'n/a';
+}
+
 function buildFlagContext(entry: FlagEntry | null): string[] {
-  if (!entry) return ['Feature flags', 'No feature flag is selected.'];
+  if (!entry) return ['Feature Controls', 'No feature control is selected.'];
   return [
     entry.flag.name,
     `ID: ${entry.flag.id}`,
@@ -209,7 +177,7 @@ function buildFlagContext(entry: FlagEntry | null): string[] {
     '',
     entry.flag.runtimeToggleable
       ? 'Impact: changes apply immediately and are also persisted as an override when they differ from the default.'
-      : 'Impact: this flag is persisted as an override and requires restart before startup-only code sees the new state.',
+      : 'Impact: this override is saved for the next Agent launch or owning-host reload, depending on who owns the flag.',
   ];
 }
 
@@ -248,14 +216,14 @@ function buildSubscriptionContext(modal: SettingsModal, entry: SubscriptionEntry
     ? modal.subscriptionLogoutConfirmationTarget === entry.provider
       ? `Press Enter again to sign out ${entry.provider}. Move selection or close config to cancel.`
       : 'Press Enter to review sign-out for this provider session.'
-    : `Open /agent setup and choose Start subscription login for ${entry.provider}.`;
+    : `Open Agent Workspace -> Setup and choose Start subscription login for ${entry.provider}.`;
   return [
     entry.provider,
     `State: ${entry.state}`,
     ...(routeReason ? [routeReason] : []),
     logout,
-    `Active route: ${entry.activeRoute ?? 'n/a'}`,
-    `Preferred route: ${entry.preferredRoute ?? 'n/a'}`,
+    `Active route: ${formatSubscriptionRoute(entry.activeRoute)}`,
+    `Preferred route: ${formatSubscriptionRoute(entry.preferredRoute)}`,
     `OAuth configured: ${entry.oauthConfigured ? 'yes' : 'no'}`,
     `Freshness: ${entry.authFreshness ?? 'n/a'}`,
     `Expires: ${expires}`,
@@ -390,10 +358,10 @@ function renderFlagRows(modal: SettingsModal, width: number, height: number): st
   const nameWidth = clamp(Math.floor(width * 0.40), 24, 58);
   const stateWidth = 10;
   const tierWidth = 6;
-  const runtimeWidth = 9;
+  const runtimeWidth = 10;
   const defaultWidth = 9;
   const idWidth = Math.max(12, width - nameWidth - stateWidth - tierWidth - runtimeWidth - defaultWidth - 14);
-  rows.push(`  ${padDisplay('Feature Flag', nameWidth)}  ${padDisplay('State', stateWidth)}  ${padDisplay('Tier', tierWidth)}  ${padDisplay('Runtime', runtimeWidth)}  ${padDisplay('Default', defaultWidth)}  ${padDisplay('ID', idWidth)}`);
+  rows.push(`  ${padDisplay('Feature Flag', nameWidth)}  ${padDisplay('State', stateWidth)}  ${padDisplay('Tier', tierWidth)}  ${padDisplay('Applies', runtimeWidth)}  ${padDisplay('Default', defaultWidth)}  ${padDisplay('ID', idWidth)}`);
   const visibleCount = Math.max(1, height - 2);
   const window = stableWindow(items.length, selectedIndex, visibleCount);
   if (window.start > 0) rows.push(`${GLYPHS.navigation.moreAbove} ${window.start} more flag(s) above`);
@@ -401,7 +369,7 @@ function renderFlagRows(modal: SettingsModal, width: number, height: number): st
     const entry = items[index]!;
     const selected = index === selectedIndex;
     const marker = selected ? (modal.focusPane === 'settings' ? GLYPHS.navigation.selected : '•') : ' ';
-    rows.push(`${marker} ${padDisplay(entry.flag.name, nameWidth)}  ${padDisplay(entry.state, stateWidth)}  ${padDisplay(String(entry.flag.tier), tierWidth)}  ${padDisplay(entry.flag.runtimeToggleable ? 'yes' : 'restart', runtimeWidth)}  ${padDisplay(entry.flag.defaultState, defaultWidth)}  ${padDisplay(entry.flag.id, idWidth)}`);
+    rows.push(`${marker} ${padDisplay(entry.flag.name, nameWidth)}  ${padDisplay(entry.state, stateWidth)}  ${padDisplay(String(entry.flag.tier), tierWidth)}  ${padDisplay(entry.flag.runtimeToggleable ? 'now' : 'next run', runtimeWidth)}  ${padDisplay(entry.flag.defaultState, defaultWidth)}  ${padDisplay(entry.flag.id, idWidth)}`);
   }
   if (window.end < items.length) rows.push(`${GLYPHS.navigation.moreBelow} ${items.length - window.end} more flag(s) below`);
   return rows.slice(0, height);
@@ -450,7 +418,7 @@ function renderSubscriptionRows(modal: SettingsModal, width: number, height: num
     const entry = items[index]!;
     const selected = index === selectedIndex;
     const marker = selected ? (modal.focusPane === 'settings' ? GLYPHS.navigation.selected : '•') : ' ';
-    rows.push(`${marker} ${padDisplay(entry.provider, providerWidth)}  ${padDisplay(entry.state, stateWidth)}  ${padDisplay(entry.activeRoute ?? 'n/a', routeWidth)}  ${padDisplay(entry.authFreshness ?? 'n/a', freshnessWidth)}  ${padDisplay(entry.oauthConfigured ? 'yes' : 'no', oauthWidth)}  ${padDisplay(inferSubscriptionRouteReason(entry) ?? '', noteWidth)}`);
+    rows.push(`${marker} ${padDisplay(entry.provider, providerWidth)}  ${padDisplay(entry.state, stateWidth)}  ${padDisplay(formatSubscriptionRoute(entry.activeRoute), routeWidth)}  ${padDisplay(entry.authFreshness ?? 'n/a', freshnessWidth)}  ${padDisplay(entry.oauthConfigured ? 'yes' : 'no', oauthWidth)}  ${padDisplay(inferSubscriptionRouteReason(entry) ?? '', noteWidth)}`);
   }
   if (window.end < items.length) rows.push(`${GLYPHS.navigation.moreBelow} ${items.length - window.end} more subscription provider(s) below`);
   return rows.slice(0, height);
@@ -464,7 +432,6 @@ function renderControlRows(modal: SettingsModal, width: number, height: number):
 }
 
 function rowColorForSetting(modal: SettingsModal, rowText: string): string {
-  if (modal.currentCategory === 'danger') return PALETTE.bad;
   if (rowText.startsWith(GLYPHS.navigation.selected)) return PALETTE.text;
   const selected = modal.getSelected();
   if (!selected) return PALETTE.text;
@@ -484,13 +451,79 @@ function footerText(modal: SettingsModal): string {
   return 'Focus settings · Up/Down setting · Left categories · Tab pane · Enter/Space edit/toggle · R reset · Esc close';
 }
 
+export function renderSettingsModalPackageText(): string {
+  const lines: string[] = [
+    'Configuration Workspace / Settings',
+    'Categories',
+    'Setting',
+    'Value',
+    'Type',
+    'Source',
+    'Default',
+    'Feature Flag',
+    'State',
+    'Tier',
+    'Applies',
+    'Server',
+    'Trust',
+    'Status',
+    'Scope',
+    'Provider',
+    'Route',
+    'Freshness',
+    'OAuth',
+    'Note',
+    'No settings in this category.',
+    'No feature flags registered.',
+    'No MCP servers registered.',
+    'No provider subscriptions available or configured.',
+    'No setting is selected in this category.',
+    'No feature control is selected.',
+    'No MCP server is selected.',
+    'No subscription provider is selected.',
+    'Trust meanings:',
+    'constrained: keep MCP activity inside declared paths/hosts and prompt on risk.',
+    'ask-on-risk: allow routine MCP operations but ask before risky behavior.',
+    'allow-all: allow unrestricted MCP operations for this server after explicit confirmation.',
+    'blocked: prevent this MCP server from being used.',
+    'Possible values:',
+    'true: enabled or allowed for this setting.',
+    'false: disabled or not allowed for this setting.',
+    'Secret handling: raw values entered here are stored through the secret manager and the config receives a goodvibes:// secret reference. Empty input clears the config value.',
+    'Editing: Enter opens inline edit, then type the value and press Enter to save. Arrow keys only navigate.',
+    'Editing: Enter opens inline edit. Delete the current text to save an empty value when that is valid for the setting.',
+    'Enter Confirm edit · Esc Cancel edit · text keys edit the selected field',
+    'Focus categories · Up/Down choose · Right/Enter settings · Tab pane · Esc close',
+    'Focus settings · Up/Down provider · Left categories · Tab pane · Enter review/sign out · Esc close',
+    'Focus settings · Up/Down server · Left categories · Tab pane · Enter edit trust · Esc close',
+    'Focus feature flags · Up/Down flag · Left categories · Tab pane · Enter/Space toggle · Esc close',
+    'Read-only connected-host setting · Change from GoodVibes TUI or the owning host · Esc close',
+    'Focus settings · Up/Down setting · Left categories · Tab pane · Enter/Space edit/toggle · R reset · Esc close',
+  ];
+
+  for (const group of SETTINGS_CATEGORY_GROUPS) {
+    lines.push(group.label);
+    for (const category of group.categories) {
+      lines.push(category, CATEGORY_LABELS[category], CATEGORY_INFO[category]);
+    }
+  }
+
+  for (const [key, values] of Object.entries(ENUM_VALUE_DESCRIPTIONS)) {
+    lines.push(key);
+    for (const [value, description] of Object.entries(values)) {
+      lines.push(value, description);
+    }
+  }
+
+  return lines.join('\n');
+}
+
 export function renderSettingsModal(
   modal: SettingsModal,
   width: number,
   viewportHeight = 24,
 ): Line[] {
   const notices = [
-    ...(modal.lastSaveTriggeredRestart ? [`Owning host must restart ${modal.lastSaveTriggeredRestart}`] : []),
     ...(modal.lastSettingEffectMessage ? [modal.lastSettingEffectMessage] : []),
   ];
   const metrics = getFullscreenWorkspaceMetrics({ width, height: viewportHeight });