@pellux/goodvibes-tui 1.27.0 → 2.0.1

package/src/panels/plugins-panel.ts

@@ -1,5 +1,5 @@
-import type { Line } from '../types/grid.ts';
-import { createEmptyLine } from '../types/grid.ts';
+import type { Line } from '@pellux/goodvibes-sdk/platform/types';
+import { createEmptyLine } from '@pellux/goodvibes-sdk/platform/types';
 import { truncateDisplay } from '../utils/terminal-width.ts';
 import { ScrollableListPanel } from './scrollable-list-panel.ts';
 import type { PanelIntegrationContext } from './types.ts';

package/src/panels/polish-core.ts

@@ -1,5 +1,5 @@
-import type { Line } from '../types/grid.ts';
-import { createEmptyLine, createStyledCell } from '../types/grid.ts';
+import type { Line } from '@pellux/goodvibes-sdk/platform/types';
+import { createEmptyLine, createStyledCell } from '@pellux/goodvibes-sdk/platform/types';
 import { getDisplayWidth } from '../utils/terminal-width.ts';
 import { activeUiTones, registerThemeRefresh } from '../renderer/theme.ts';
 

package/src/panels/polish-tables.ts

@@ -1,4 +1,4 @@
-import type { Line } from '../types/grid.ts';
+import type { Line } from '@pellux/goodvibes-sdk/platform/types';
 import { getDisplayWidth, truncateDisplay } from '../utils/terminal-width.ts';
 import { GLYPHS, UI_TONES } from '../renderer/ui-primitives.ts';
 // Build on the leaf primitives in ./polish-core.ts (palette + base line

package/src/panels/polish.ts

@@ -1,5 +1,5 @@
-import type { Line } from '../types/grid.ts';
-import { createEmptyLine, createStyledCell } from '../types/grid.ts';
+import type { Line } from '@pellux/goodvibes-sdk/platform/types';
+import { createEmptyLine, createStyledCell } from '@pellux/goodvibes-sdk/platform/types';
 import { getDisplayWidth, wrapText } from '../utils/terminal-width.ts';
 import { getSurfaceContentRows, getTrackedVisibleWindow, getVisibleWindow, type VisibleWindow } from '../renderer/surface-layout.ts';
 import { GLYPHS } from '../renderer/ui-primitives.ts';

package/src/panels/scrollable-list-panel.ts

@@ -1,8 +1,8 @@
-import type { Line } from '../types/grid.ts';
-import { createEmptyLine, createStyledCell } from '../types/grid.ts';
+import type { Line } from '@pellux/goodvibes-sdk/platform/types';
+import { createEmptyLine, createStyledCell } from '@pellux/goodvibes-sdk/platform/types';
 import { BasePanel } from './base-panel.ts';
 import type { PanelCategory } from './types.ts';
-import type { ComponentHealthMonitor } from '../runtime/perf/panel-health-monitor.ts';
+import type { ComponentHealthMonitor } from '@pellux/goodvibes-sdk/platform/runtime/observability';
 import {
   buildEmptyState,
   buildKeyboardHints,

package/src/panels/skills-panel.ts

@@ -1,11 +1,11 @@
 import { promises as fsPromises } from 'node:fs';
 import { join, sep } from 'node:path';
-import type { Line } from '../types/grid.ts';
-import { createEmptyLine } from '../types/grid.ts';
+import type { Line } from '@pellux/goodvibes-sdk/platform/types';
+import { createEmptyLine } from '@pellux/goodvibes-sdk/platform/types';
 import { type ConfirmState, handleConfirmInput, renderConfirmLines } from './confirm-state.ts';
 import { getDisplayWidth, truncateDisplay } from '../utils/terminal-width.ts';
 import { ScrollableListPanel } from './scrollable-list-panel.ts';
-import type { ComponentHealthMonitor } from '../runtime/perf/panel-health-monitor.ts';
+import type { ComponentHealthMonitor } from '@pellux/goodvibes-sdk/platform/runtime/observability';
 import { listInstalledEcosystemEntries, type EcosystemCatalogPathOptions, type ShellPathService } from '@/runtime/index.ts';
 import {
   buildPanelLine,

package/src/panels/token-budget-panel.ts

@@ -1,13 +1,13 @@
 import type { ConfigManager } from '@pellux/goodvibes-sdk/platform/config';
 import { BasePanel } from './base-panel.ts';
-import { createEmptyLine, createStyledCell, type Line } from '../types/grid.ts';
-import type { Orchestrator } from '../core/orchestrator';
+import { createEmptyLine, createStyledCell, type Line } from '@pellux/goodvibes-sdk/platform/types';
+import type { Orchestrator } from '@pellux/goodvibes-sdk/platform/core';
 import { evaluateSessionMaintenance } from '@/runtime/index.ts';
 import type { TurnEvent } from '@/runtime/index.ts';
-import type { UiEventFeed } from '../runtime/ui-events.ts';
+import type { UiEventFeed } from '@/runtime/index.ts';
 import type { UiReadModel, UiSessionSnapshot } from '../runtime/ui-read-models.ts';
-import type { SessionMemoryQuery } from '../runtime/ui-service-queries.ts';
-import { calcSessionCost, describePricingSource, isModelPriced } from '../export/cost-utils.ts';
+import type { SessionMemoryQuery } from '@/runtime/index.ts';
+import { calcSessionCost, describePricingSource, isModelPriced } from '@pellux/goodvibes-sdk/platform/providers';
 import { type ConfirmState, handleConfirmInput, renderConfirmLines } from './confirm-state.ts';
 import type { PanelIntegrationContext } from './types.ts';
 import {

package/src/panels/types.ts

@@ -1,4 +1,4 @@
-import type { Line } from '../types/grid.ts';
+import type { Line } from '@pellux/goodvibes-sdk/platform/types';
 import type { StatusState } from '../renderer/status-glyphs.ts';
 import type { ComponentResourceContract, ComponentHealthState } from '../runtime/perf/panel-contracts.ts';
 // Routed through the `@/` alias (not `./panel-manager.ts`) so this foundational
@@ -65,7 +65,6 @@ export type KeyName = NamedKey | (string & {});
  *   - automation-control:     hooks, plugins, marketplace, automation jobs, worktrees
  *   - incidents-diagnostics:  failure review, eval gates, API call debugging
  *   - runtime-ops:            live operator consoles (cockpit, tasks, orchestration, comms)
- * 'development' | 'agent' | 'session' | 'ai' are unchanged from before the split.
  */
 export type PanelCategory =
   | 'development'

package/src/permissions/prompt.ts

@@ -1,4 +1,4 @@
-import { type Line } from '../types/grid.ts';
+import { type Line } from '@pellux/goodvibes-sdk/platform/types';
 import { UIFactory } from '../renderer/ui-factory.ts';
 import type { PermissionCategory, PermissionRequestAnalysis } from '@pellux/goodvibes-sdk/platform/permissions';
 import { buildPermissionApprovalBrief, getDisplayArg } from '@pellux/goodvibes-sdk/platform/permissions';

package/src/renderer/autocomplete-overlay.ts

@@ -1,4 +1,4 @@
-import { type Line } from '../types/grid.ts';
+import { type Line } from '@pellux/goodvibes-sdk/platform/types';
 import { fitDisplay, getDisplayWidth, truncateDisplay } from '../utils/terminal-width.ts';
 import { wrapWithHangingIndent } from './text-layout.ts';
 import type { AutocompleteEngine } from '../input/autocomplete.ts';

package/src/renderer/block-actions-overlay.ts

@@ -7,7 +7,7 @@
  * block summary and action list are always shown in full.
  */
 
-import { type Line } from '../types/grid.ts';
+import { type Line } from '@pellux/goodvibes-sdk/platform/types';
 import { ModalFactory, type ModalSection } from './modal-factory.ts';
 import type { BlockActionsMenu } from './block-actions.ts';
 import { describeBlockForReceipt } from '../input/handler-content-actions.ts';

package/src/renderer/bookmark-modal.ts

@@ -7,7 +7,7 @@
  * Footer hints: [Up/Down] Navigate  [Enter] Jump  [o] Open File  [d] Remove  [Esc] Close
  */
 
-import { type Line } from '../types/grid.ts';
+import { type Line } from '@pellux/goodvibes-sdk/platform/types';
 import { ModalFactory } from './modal-factory.ts';
 import { BookmarkModal } from '../input/bookmark-modal.ts';
 import type { BookmarkEntry } from '@pellux/goodvibes-sdk/platform/bookmarks';

package/src/renderer/buffer.ts

@@ -1,4 +1,4 @@
-import { type Line, type Cell, createEmptyLine, createEmptyCell } from '../types/grid.ts';
+import { type Line, type Cell, createEmptyLine, createEmptyCell } from '@pellux/goodvibes-sdk/platform/types';
 
 /**
  * TerminalBuffer - Represents a 2D grid of styled cells.

package/src/renderer/code-block.ts

@@ -1,4 +1,4 @@
-import { type Line, type Cell, createStyledCell, createEmptyLine } from '../types/grid.ts';
+import { type Line, type Cell, createStyledCell, createEmptyLine } from '@pellux/goodvibes-sdk/platform/types';
 import { UIFactory } from './ui-factory.ts';
 import { getDisplayWidth } from '../utils/terminal-width.ts';
 import { LAYOUT } from './layout.ts';

package/src/renderer/composer-fragments.ts

@@ -5,7 +5,7 @@
 // UIFactory static methods are thin wrappers over these.
 // ---------------------------------------------------------------------------
 
-import { type Line } from '../types/grid.ts';
+import { type Line } from '@pellux/goodvibes-sdk/platform/types';
 import { renderConversationFragment } from './conversation-surface.ts';
 import { activeUiTones } from './theme.ts';
 import { activeTheme } from './theme.ts';

package/src/renderer/compositor.ts

@@ -1,9 +1,9 @@
 import { TerminalBuffer } from './buffer.ts';
 import { DiffEngine } from './diff.ts';
-import { type Line, createEmptyCell, createEmptyLine, createStyledCell } from '../types/grid.ts';
+import { type Line, createEmptyCell, createEmptyLine, createStyledCell } from '@pellux/goodvibes-sdk/platform/types';
 import { getDisplayWidth } from '../utils/terminal-width.ts';
 import type { SearchManager } from '../input/search.ts';
-import { allowTerminalWrite } from '../runtime/terminal-output-guard.ts';
+import { allowTerminalWrite } from '@pellux/goodvibes-terminal-shell/terminal-output-guard';
 import { probeTermCaps, type TermColorCaps } from './term-caps.ts';
 import { activeTheme } from './theme.ts';
 import { UI_TONES } from './ui-primitives.ts';

package/src/renderer/config-modal.ts

@@ -1,4 +1,4 @@
-import type { Line } from '../types/grid.ts';
+import type { Line } from '@pellux/goodvibes-sdk/platform/types';
 import { ModalFactory, type ModalSection, type ModalTab } from './modal-factory.ts';
 import { getOverlayMaxWidth } from './overlay-viewport.ts';
 import { activeUiTones } from './theme.ts';

package/src/renderer/context-inspector.ts

@@ -1,4 +1,4 @@
-import { type Line } from '../types/grid.ts';
+import { type Line } from '@pellux/goodvibes-sdk/platform/types';
 import { ModalFactory } from './modal-factory.ts';
 import type { ConversationManager } from '../core/conversation';
 import { getOverlayContentBudget, getOverlaySurfaceMetrics, getStableOverlayContentRows } from './overlay-viewport.ts';

package/src/renderer/conversation-layout.ts

@@ -1,5 +1,5 @@
-import type { Line } from '../types/grid.ts';
-import { createEmptyLine } from '../types/grid.ts';
+import type { Line } from '@pellux/goodvibes-sdk/platform/types';
+import { createEmptyLine } from '@pellux/goodvibes-sdk/platform/types';
 import type { ConversationManager } from '../core/conversation';
 
 export interface ConversationViewportRequest {

package/src/renderer/conversation-overlays.ts

@@ -1,4 +1,4 @@
-import type { Line } from '../types/grid.ts';
+import type { Line } from '@pellux/goodvibes-sdk/platform/types';
 import type { ConversationManager } from '../core/conversation';
 import type { CommandRegistry } from '../input/command-registry.ts';
 import type { InputHandler } from '../input/handler.ts';

package/src/renderer/conversation-surface.ts

@@ -1,8 +1,8 @@
-import { type Line, createEmptyLine, createStyledCell } from '../types/grid.ts';
+import { type Line, createEmptyLine, createStyledCell } from '@pellux/goodvibes-sdk/platform/types';
 import { getDisplayWidth, wrapText } from '../utils/terminal-width.ts';
 import { LAYOUT } from './layout.ts';
 import { GLYPHS } from './ui-primitives.ts';
-import { treeBranchCol, treeContentCol } from './conversation-tree.ts';
+import { treeBranchCol, treeContentCol } from '@pellux/goodvibes-terminal-shell';
 
 export interface ConversationSurfacePalette {
   readonly accent: string;

package/src/renderer/diff-view.ts

@@ -1,4 +1,4 @@
-import { type Line, type Cell, createStyledCell } from '../types/grid.ts';
+import { type Line, type Cell, createStyledCell } from '@pellux/goodvibes-sdk/platform/types';
 import { UIFactory } from './ui-factory.ts';
 import { getDisplayWidth, padDisplayEnd } from '../utils/terminal-width.ts';
 import { DIFF_TONES } from './ui-primitives.ts';

package/src/renderer/diff.ts

@@ -1,5 +1,5 @@
 import { TerminalBuffer } from './buffer.ts';
-import { type Cell } from '../types/grid.ts';
+import { type Cell } from '@pellux/goodvibes-sdk/platform/types';
 import {
   type TermColorCaps,
   downsampleColor,

package/src/renderer/file-picker-overlay.ts

@@ -1,4 +1,4 @@
-import { type Line } from '../types/grid.ts';
+import { type Line } from '@pellux/goodvibes-sdk/platform/types';
 import { fitDisplay, getDisplayWidth, truncateDisplay } from '../utils/terminal-width.ts';
 import type { FilePickerModal } from '../input/file-picker.ts';
 import {

package/src/renderer/fleet-tab-strip.ts

@@ -9,7 +9,7 @@
 // that distinction for the operator.
 // ---------------------------------------------------------------------------
 
-import type { Line } from '../types/grid.ts';
+import type { Line } from '@pellux/goodvibes-sdk/platform/types';
 import type { FleetTabsState } from '../panels/fleet-tabs.ts';
 import { renderTabStrip, type TabHitRegion } from './tab-strip.ts';
 import { UI_TONES } from './ui-primitives.ts';

package/src/renderer/fullscreen-primitives.ts

@@ -1,5 +1,5 @@
-import type { Line } from '../types/grid.ts';
-import { createEmptyLine, createStyledCell } from '../types/grid.ts';
+import type { Line } from '@pellux/goodvibes-sdk/platform/types';
+import { createEmptyLine, createStyledCell } from '@pellux/goodvibes-sdk/platform/types';
 import { getDisplayWidth } from '../utils/terminal-width.ts';
 import { GLYPHS } from './ui-primitives.ts';
 import { activeUiTones, registerThemeRefresh } from './theme.ts';

package/src/renderer/fullscreen-workspace.ts

@@ -1,4 +1,4 @@
-import type { Line } from '../types/grid.ts';
+import type { Line } from '@pellux/goodvibes-sdk/platform/types';
 import { GLYPHS } from './ui-primitives.ts';
 import {
   borderLine,

package/src/renderer/header-line.ts

@@ -14,7 +14,7 @@
  * has moved off it.
  */
 
-import { type Line, createEmptyLine } from '../types/grid.ts';
+import { type Line, createEmptyLine } from '@pellux/goodvibes-sdk/platform/types';
 import { VERSION } from '../version.ts';
 import { getDisplayWidth } from '../utils/terminal-width.ts';
 import type { GitHeaderInfo } from './git-status.ts';

package/src/renderer/help-overlay.ts

@@ -6,7 +6,7 @@
  * are a different, complementary surface, not this one.
  */
 
-import { type Line } from '../types/grid.ts';
+import { type Line } from '@pellux/goodvibes-sdk/platform/types';
 import { ModalFactory } from './modal-factory.ts';
 import type { SlashCommand } from '../input/command-registry.ts';
 import type { KeybindingsManager } from '../input/keybindings.ts';

package/src/renderer/history-search-overlay.ts

@@ -1,7 +1,7 @@
-import type { Line } from '../types/grid.ts';
+import type { Line } from '@pellux/goodvibes-sdk/platform/types';
 import { fitDisplay, getDisplayWidth } from '../utils/terminal-width.ts';
 import type { HistorySearch } from '../input/input-history.ts';
-import { createBottomBarLine, writeBottomBarText } from './bottom-bar.ts';
+import { createBottomBarLine, writeBottomBarText } from '@pellux/goodvibes-terminal-shell';
 import { formatHints } from './hint-grammar.ts';
 
 /**

package/src/renderer/layout.ts

@@ -2,15 +2,12 @@ import { GLYPHS, SPINNER_FRAMES, UI_TONES } from './ui-primitives.ts';
 
 /**
  * Layout constants — single source of truth for margins and content width.
- * All renderers import these instead of hardcoding indent values.
+ * All renderers import these instead of hardcoding indent values. The object
+ * itself lives in @pellux/goodvibes-terminal-shell alongside the transcript
+ * tree geometry that reads LEFT_MARGIN/RIGHT_MARGIN out of it, so the margins
+ * and the glyph columns derived from them cannot drift apart.
  */
-export const LAYOUT = {
-  LEFT_MARGIN: 4,
-  RIGHT_MARGIN: 2,
-  contentWidth: (termWidth: number) => termWidth - LAYOUT.LEFT_MARGIN - LAYOUT.RIGHT_MARGIN,
-  /** Used by createMessageBar in ui-factory.ts for user message ghost boxes. */
-  USER_BOX_MARGIN: 2,
-} as const;
+export { TRANSCRIPT_LAYOUT as LAYOUT } from '@pellux/goodvibes-terminal-shell';
 
 export const TOOL_STATUS = {
   SUCCESS_ICON: GLYPHS.status.success,

package/src/renderer/markdown-inline.ts

@@ -8,7 +8,7 @@
  * renderInlineMarkdown so existing importers are unaffected.
  */
 
-import type { Cell } from '../types/grid.ts';
+import type { Cell } from '@pellux/goodvibes-sdk/platform/types';
 
 /** Module-level set of inline markdown special characters (hoisted out of hot loop). */
 const INLINE_SPECIAL_CHARS = new Set(['[', '`', '*', '_', '~']);

package/src/renderer/markdown-table.ts

@@ -38,7 +38,7 @@
  * still emitted in full.
  */
 
-import { type Line, type Cell, createStyledCell } from '../types/grid.ts';
+import { type Line, type Cell, createStyledCell } from '@pellux/goodvibes-sdk/platform/types';
 import { UIFactory } from './ui-factory.ts';
 import { getDisplayWidth } from '../utils/terminal-width.ts';
 import { activeTheme } from './theme.ts';

package/src/renderer/markdown.ts

@@ -1,4 +1,4 @@
-import { type Line, type Cell, createStyledCell } from '../types/grid.ts';
+import { type Line, type Cell, createStyledCell } from '@pellux/goodvibes-sdk/platform/types';
 import { UIFactory } from './ui-factory.ts';
 import { renderCodeBlock } from './code-block.ts';
 import { getDisplayWidth } from '../utils/terminal-width.ts';

package/src/renderer/mcp-workspace.ts

@@ -1,5 +1,5 @@
 import type { McpWorkspace, McpWorkspaceRow } from '../input/mcp-workspace.ts';
-import type { Line } from '../types/grid.ts';
+import type { Line } from '@pellux/goodvibes-sdk/platform/types';
 import { wrapText } from '../utils/terminal-width.ts';
 import { GLYPHS } from './ui-primitives.ts';
 import {

package/src/renderer/modal-factory.ts

@@ -1,5 +1,5 @@
-import type { Line, Cell } from '../types/grid.ts';
-import { createStyledCell } from '../types/grid.ts';
+import type { Line, Cell } from '@pellux/goodvibes-sdk/platform/types';
+import { createStyledCell } from '@pellux/goodvibes-sdk/platform/types';
 import { fitDisplay, getDisplayWidth, truncateDisplay, wrapText } from '../utils/terminal-width.ts';
 import {
   createOverlayBorderLine,

package/src/renderer/model-workspace.ts

@@ -8,8 +8,8 @@
 import type { ModelDefinition } from '@pellux/goodvibes-sdk/platform/providers';
 import type { ModelPickerModal } from '../input/model-picker.ts';
 import type { ModelPickerTargetInfo } from '../input/model-picker.ts';
-import type { Line } from '../types/grid.ts';
-import { createEmptyLine, createStyledCell } from '../types/grid.ts';
+import type { Line } from '@pellux/goodvibes-sdk/platform/types';
+import { createEmptyLine, createStyledCell } from '@pellux/goodvibes-sdk/platform/types';
 import { fitDisplay, getDisplayWidth, wrapText } from '../utils/terminal-width.ts';
 import { abbreviateCount } from '../utils/format-number.ts';
 import { GLYPHS, UI_TONES } from './ui-primitives.ts';

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

@@ -1,4 +1,4 @@
-import type { Line } from '../../types/grid.ts';
+import type { Line } from '@pellux/goodvibes-sdk/platform/types';
 import { fitDisplay, getDisplayWidth, truncateDisplay, wrapText } from '../../utils/terminal-width.ts';
 import {
   createOverlayBoxLayout,

package/src/renderer/overlay-box.ts

@@ -1,4 +1,4 @@
-import { createStyledCell, type Line } from '../types/grid.ts';
+import { createStyledCell, type Line } from '@pellux/goodvibes-sdk/platform/types';
 import { getOverlayMaxWidth } from './overlay-viewport.ts';
 import { GLYPHS } from './ui-primitives.ts';
 import { activeUiTones, registerThemeRefresh } from './theme.ts';

package/src/renderer/panel-composite.ts

@@ -1,4 +1,4 @@
-import type { Line } from '../types/grid.ts';
+import type { Line } from '@pellux/goodvibes-sdk/platform/types';
 import type { Panel } from '../panels/types.ts';
 import type { InputHandler } from '../input/handler.ts';
 import type { PanelManager } from '../panels/panel-manager.ts';

package/src/renderer/panel-workspace-bar.ts

@@ -1,4 +1,4 @@
-import type { Line } from '../types/grid.ts';
+import type { Line } from '@pellux/goodvibes-sdk/platform/types';
 import type { WorkspaceTab } from '../panels/panel-manager.ts';
 import { renderTabStrip, type TabHitRegion } from './tab-strip.ts';
 import { UI_TONES } from './ui-primitives.ts';

package/src/renderer/process-indicator.ts

@@ -1,4 +1,4 @@
-import { type Line } from '../types/grid.ts';
+import { type Line } from '@pellux/goodvibes-sdk/platform/types';
 import { UIFactory } from './ui-factory.ts';
 import { truncateDisplay } from '../utils/terminal-width.ts';
 import { GLYPHS, UI_TONES } from './ui-primitives.ts';

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

@@ -7,7 +7,7 @@
  * Footer hints: [Up/Down] Navigate  [Enter] Load  [d] Arm/Delete  [s] Save current  [Esc] Close
  */
 
-import type { Line } from '../types/grid.ts';
+import type { Line } from '@pellux/goodvibes-sdk/platform/types';
 import { ModalFactory } from './modal-factory.ts';
 import type { ProfilePickerModal } from '../input/profile-picker-modal.ts';
 import { formatTimestamp } from './modal-utils.ts';

package/src/renderer/search-overlay.ts

@@ -1,7 +1,7 @@
-import type { Line } from '../types/grid.ts';
+import type { Line } from '@pellux/goodvibes-sdk/platform/types';
 import { fitDisplay, getDisplayWidth, truncateDisplay } from '../utils/terminal-width.ts';
 import type { SearchManager } from '../input/search.ts';
-import { createBottomBarLine, writeBottomBarText } from './bottom-bar.ts';
+import { createBottomBarLine, writeBottomBarText } from '@pellux/goodvibes-terminal-shell';
 
 /**
  * Render the search bar as a single Line[] overlay at the bottom of the viewport.

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

@@ -1,4 +1,4 @@
-import { type Line } from '../types/grid.ts';
+import { type Line } from '@pellux/goodvibes-sdk/platform/types';
 import { fitDisplay, getDisplayWidth, truncateDisplay } from '../utils/terminal-width.ts';
 import type { SelectionItem, SelectionModal } from '../input/selection-modal.ts';
 import {

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

@@ -15,7 +15,7 @@
  * this section is entirely absent and the box sizing is unchanged.
  */
 
-import type { Line } from '../types/grid.ts';
+import type { Line } from '@pellux/goodvibes-sdk/platform/types';
 import type { SharedSessionRecord } from '@pellux/goodvibes-sdk/platform/control-plane';
 import { ModalFactory } from './modal-factory.ts';
 import { UI_TONES } from './ui-primitives.ts';
@@ -92,10 +92,84 @@ function statusLabel(record: SharedSessionRecord): string {
 }
 
 const MAX_CROSS_SURFACE_ROWS = 5;
+const MAX_HOSTED_ROWS = 5;
+
+// ---------------------------------------------------------------------------
+// Daemon-hosted sessions
+// ---------------------------------------------------------------------------
+
+/**
+ * The exact honest state of the hosted section, or null when the rows speak for
+ * themselves. "Never read" and "the daemon hosts nothing" are different facts
+ * and are never collapsed into each other.
+ */
+function hostedRosterNote(roster: SessionPickerModal['hostedRoster']): string | null {
+  if (roster.note) return roster.note;
+  if (roster.capturedAt === null) return 'Not read yet.';
+  if (roster.sessions.length === 0) return 'The daemon is hosting no sessions.';
+  return null;
+}
+
+/**
+ * One hosted row: the id first, then what it is doing, what leaving it would
+ * do, and finally its title.
+ *
+ * The id leads because it is the ACTIONABLE part — the row exists so `/hosted
+ * attach <id>` can be typed off it — and a narrow terminal clips the tail. What
+ * gets clipped must therefore be the descriptive end of the line, never the
+ * thing the user has to retype.
+ */
+function hostedRowLabel(
+  record: SessionPickerModal['hostedRoster']['sessions'][number],
+  contentWidth: number,
+): string {
+  const policy = record.effectiveDetachPolicy === 'survive' ? 'survives detach' : 'ends on detach';
+  const attached = record.attachedClients.length > 0 ? `${record.attachedClients.length} attached` : 'nobody attached';
+  // Fitted to the content width MINUS the list indent modal-factory adds: at
+  // the full width the row wraps to a second line, which the section's row
+  // accounting does not reserve, and the trailing attach hint is then what the
+  // tail clip eats.
+  return fitDisplay(
+    `${record.id} · ${record.status} · ${policy} · ${attached} · ${record.title || 'untitled'}`,
+    Math.max(8, contentWidth - 4),
+  );
+}
+
+/**
+ * Whether the hosted section renders at all.
+ *
+ * Absent when NOTHING is known: no roster was wired (every pre-existing caller
+ * and test), so the box size and content are unchanged for them. The moment the
+ * roster has an answer — rows, an empty-but-read list, or a reason it could not
+ * read — the section appears, because each of those is a fact worth showing.
+ */
+function hostedSectionVisible(modal: SessionPickerModal): boolean {
+  const roster = modal.hostedRoster;
+  return roster.sessions.length > 0 || roster.capturedAt !== null || roster.note !== null;
+}
+
+function hostedRowCount(modal: SessionPickerModal): number {
+  return Math.min(MAX_HOSTED_ROWS, modal.hostedRoster.sessions.length);
+}
+
+/**
+ * Extra content rows the hosted section needs: separator + header (+note)
+ * + rows (+overflow line + the attach hint). Counted for the same reason the
+ * cross-surface section counts its own — an uncounted trailing row is silently
+ * eaten by modal-factory's tail clip.
+ */
+function hostedExtraRows(modal: SessionPickerModal): number {
+  if (!hostedSectionVisible(modal)) return 0;
+  const rows = hostedRowCount(modal);
+  const noteRow = hostedRosterNote(modal.hostedRoster) ? 1 : 0;
+  const overflowRow = modal.hostedRoster.sessions.length > MAX_HOSTED_ROWS ? 1 : 0;
+  const hintRow = rows > 0 ? 1 : 0;
+  return 2 + noteRow + overflowRow + hintRow + rows;
+}
 
 /**
  * The exact honest note for the current state, or null when the union view
- * needs no caveat (fresh/embedded with rows). Precedence: offline > stale >
+ * needs no caveat (fresh, with rows). Precedence: offline > stale >
  * true-empty — the three designed states, never collapsed into
  * each other (an offline view never silently renders as "no sessions yet").
  */
@@ -149,7 +223,7 @@ export function renderSessionPickerModal(
   width: number,
   viewportHeight = 24,
 ): Line[] {
-  const extraRows = crossSurfaceExtraRows(modal);
+  const extraRows = crossSurfaceExtraRows(modal) + hostedExtraRows(modal);
   const metrics = getOverlaySurfaceMetrics(width, viewportHeight, {
     chromeRows: 6,
     minContentRows: 5,
@@ -290,6 +364,53 @@ export function renderSessionPickerModal(
     }
   }
 
+  // Daemon-hosted sessions — conversations whose loop runs in the daemon rather
+  // than in this terminal. Read-only here: joining one is `/hosted attach <id>`,
+  // which opens a live stream this modal has no business owning, so the full id
+  // is rendered for the command to be typed straight off the row.
+  if (hostedSectionVisible(modal)) {
+    sections.push({ type: 'separator' });
+    sections.push({
+      type: 'text',
+      content: 'Daemon-hosted sessions',
+      style: { fg: '240', dim: true, bold: true },
+    });
+    const note = hostedRosterNote(modal.hostedRoster);
+    if (note) {
+      sections.push({
+        type: 'text',
+        content: note,
+        style: { fg: modal.hostedRoster.note ? UI_TONES.state.warn : '244', dim: !modal.hostedRoster.note },
+      });
+    }
+    if (modal.hostedRoster.sessions.length > 0) {
+      const rows = modal.hostedRoster.sessions.slice(0, MAX_HOSTED_ROWS);
+      sections.push({
+        type: 'list',
+        items: rows.map((record) => ({
+          label: hostedRowLabel(record, contentW),
+          // A terminated hosted session is kept with its reason until retention
+          // retires it; dimming it keeps it readable without looking live.
+          style: record.status === 'terminated'
+            ? { fg: '244', dim: true }
+            : record.status === 'running' ? { fg: UI_TONES.state.good } : undefined,
+        })),
+      });
+      if (modal.hostedRoster.sessions.length > MAX_HOSTED_ROWS) {
+        sections.push({
+          type: 'text',
+          content: `[showing ${MAX_HOSTED_ROWS} of ${modal.hostedRoster.sessions.length}]`,
+          style: { fg: '244', dim: true },
+        });
+      }
+      sections.push({
+        type: 'text',
+        content: 'Join one with /hosted attach <id>',
+        style: { fg: '244', dim: true },
+      });
+    }
+  }
+
   // Status message if present
   if (modal.statusMessage) {
     sections.push({ type: 'separator' });