@pellux/goodvibes-agent 1.2.0 → 1.4.1

package/src/input/agent-workspace-setup.ts

@@ -7,7 +7,7 @@ export interface AgentWorkspaceSetupChecklistItem {
   readonly label: string;
   readonly status: AgentWorkspaceSetupStatus;
   readonly detail: string;
-  readonly command?: string;
+  readonly breadcrumb?: string;
 }
 
 export interface AgentWorkspaceSetupChecklistInput {
@@ -18,6 +18,7 @@ export interface AgentWorkspaceSetupChecklistInput {
   readonly connectedHostTokenReadable: boolean;
   readonly connectedHostTokenPath: string;
   readonly connectedHostTokenError?: string | null;
+  readonly connectedHostAuthReceiptReady?: boolean;
   readonly activeSubscriptionCount: number;
   readonly pendingSubscriptionCount: number;
   readonly availableSubscriptionProviderCount: number;
@@ -58,12 +59,12 @@ function sampleNames(summary: AgentBehaviorDiscoverySummary): string {
 export function buildAgentWorkspaceSetupChecklist(input: AgentWorkspaceSetupChecklistInput): readonly AgentWorkspaceSetupChecklistItem[] {
   const providerReady = input.provider !== 'unknown' && input.model !== 'unknown';
   const tokenPathKnown = input.connectedHostTokenPath !== '(Agent home unavailable)';
-  const connectedHostAuthStatus: AgentWorkspaceSetupStatus = input.connectedHostTokenReadable
+  const connectedHostAuthReceiptReady = input.connectedHostAuthReceiptReady === true;
+  const connectedHostAuthStatus: AgentWorkspaceSetupStatus = input.connectedHostTokenReadable || connectedHostAuthReceiptReady
     ? 'ready'
     : tokenPathKnown
       ? 'blocked'
       : 'recommended';
-  const installSmokeReady = providerReady && input.connectedHostTokenReadable;
   const hasActivePersona = input.activePersonaName !== '(none)' && input.activePersonaName !== '(unavailable)';
   const discoveredBehaviorCount = input.discoveredPersonas.count + input.discoveredSkills.count + input.discoveredRoutines.count;
   return [
@@ -72,20 +73,22 @@ export function buildAgentWorkspaceSetupChecklist(input: AgentWorkspaceSetupChec
       label: 'Connected host',
       status: 'ready',
       detail: `Agent will connect to ${input.runtimeBaseUrl}; protected host routes also need the Agent companion token below.`,
-      command: 'Home -> Review health',
+      breadcrumb: 'Home -> Review health',
     },
     {
       id: 'connected-host-auth',
       label: 'Connected-host auth',
       status: connectedHostAuthStatus,
-      detail: input.connectedHostTokenReadable
+      detail: connectedHostAuthReceiptReady
+        ? `Durable connected-host auth receipt is ready${input.connectedHostTokenReadable ? ` and Agent has a readable operator token at ${input.connectedHostTokenPath}` : ''}.`
+        : input.connectedHostTokenReadable
         ? `Agent has a readable connected-host operator token at ${input.connectedHostTokenPath}.`
         : input.connectedHostTokenError
           ? `The connected-host operator token exists but cannot be read at ${input.connectedHostTokenPath}. Use the confirmed setup token provisioning route, then rerun auth review.`
           : tokenPathKnown
             ? `Provision Agent's local connected-host operator token at ${input.connectedHostTokenPath} before pairing channels, Knowledge, schedules, or protected daemon routes.`
             : 'Shell paths are unavailable in this runtime, so connected-host auth cannot be verified from the workspace snapshot.',
-      command: 'Host -> Connected-host auth owner',
+      breadcrumb: 'Host -> Connected-host auth owner',
     },
     {
       id: 'provider-model',
@@ -94,16 +97,7 @@ export function buildAgentWorkspaceSetupChecklist(input: AgentWorkspaceSetupChec
       detail: providerReady
         ? `Current chat route is ${input.provider} / ${input.model}.`
         : 'Choose a provider and model before relying on assistant turns.',
-      command: 'Setup -> Provider and model',
-    },
-    {
-      id: 'install-smoke',
-      label: 'Install smoke',
-      status: installSmokeReady ? 'recommended' : tokenPathKnown ? 'blocked' : 'recommended',
-      detail: installSmokeReady
-        ? 'Run setup smoke after install or migration to prove package start, connected host, auth, model route, setup posture, and first assistant turn.'
-        : 'Resolve connected-host auth and provider/model setup before treating the first assistant turn as install-ready.',
-      command: 'Start -> Install smoke',
+      breadcrumb: 'Setup -> Provider and model',
     },
     {
       id: 'subscriptions',
@@ -120,14 +114,14 @@ export function buildAgentWorkspaceSetupChecklist(input: AgentWorkspaceSetupChec
           : input.availableSubscriptionProviderCount > 0
             ? `${input.availableSubscriptionProviderCount} subscription-capable provider(s) are available. Start login if you want subscription routing.`
             : 'No subscription-capable providers are available yet. Use API keys or add an OAuth provider service.',
-      command: 'Start -> Start subscription login',
+      breadcrumb: 'Start -> Start subscription login',
     },
     {
       id: 'agent-knowledge',
       label: 'Agent Knowledge',
       status: 'recommended',
       detail: 'Check isolated Agent Knowledge status, then ingest source-backed material into the Agent segment only.',
-      command: 'Knowledge',
+      breadcrumb: 'Knowledge',
     },
     {
       id: 'profile',
@@ -138,7 +132,7 @@ export function buildAgentWorkspaceSetupChecklist(input: AgentWorkspaceSetupChec
         : discoveredBehaviorCount > 0
           ? `${discoveredBehaviorCount} discovered behavior file(s) can seed an isolated Agent profile from the Profiles workspace.`
         : `${input.runtimeStarterTemplateCount} starter template(s) are available if this machine needs separate operator identities.`,
-      command: 'Profiles',
+      breadcrumb: 'Profiles',
     },
     {
       id: 'persona',
@@ -149,7 +143,7 @@ export function buildAgentWorkspaceSetupChecklist(input: AgentWorkspaceSetupChec
         : input.discoveredPersonas.count > 0
           ? `${input.discoveredPersonas.count} discovered persona file(s) can be imported into the Agent-local registry.${sampleNames(input.discoveredPersonas)}`
           : 'Create or choose a persona to make the assistant voice and policy explicit.',
-      command: 'Personas',
+      breadcrumb: 'Personas',
     },
     {
       id: 'skills',
@@ -166,7 +160,7 @@ export function buildAgentWorkspaceSetupChecklist(input: AgentWorkspaceSetupChec
         : input.discoveredSkills.count > 0
           ? `${input.discoveredSkills.count} discovered skill file(s) can be imported as local reusable procedures.${sampleNames(input.discoveredSkills)}`
           : 'Create reusable local skills and bundles for repeated workflows.',
-      command: 'Skills',
+      breadcrumb: 'Skills',
     },
     {
       id: 'routines',
@@ -179,7 +173,7 @@ export function buildAgentWorkspaceSetupChecklist(input: AgentWorkspaceSetupChec
         : input.discoveredRoutines.count > 0
           ? `${input.discoveredRoutines.count} discovered routine file(s) can be imported as main-conversation workflows.${sampleNames(input.discoveredRoutines)}`
           : 'Create local routines first; promote schedules only with explicit confirmation.',
-      command: 'Routines',
+      breadcrumb: 'Routines',
     },
     {
       id: 'memory',
@@ -188,7 +182,7 @@ export function buildAgentWorkspaceSetupChecklist(input: AgentWorkspaceSetupChec
       detail: input.localMemoryCount > 0
         ? `${input.localMemoryCount} Agent memory record(s) are available; ${input.localMemoryReviewQueueCount} need review.`
         : 'Memory starts empty; durable facts should be stored deliberately and never include secrets.',
-      command: 'Memory',
+      breadcrumb: 'Memory',
     },
     {
       id: 'notes',
@@ -197,7 +191,7 @@ export function buildAgentWorkspaceSetupChecklist(input: AgentWorkspaceSetupChec
       detail: input.localNoteCount > 0
         ? `${input.localNoteCount} Agent scratchpad note(s) are available; ${input.localNoteReviewQueueCount} need review.`
         : 'Notes start empty; use them for source triage, temporary decisions, and handoff before promoting anything durable.',
-      command: 'Notes',
+      breadcrumb: 'Notes',
     },
     {
       id: 'channels',
@@ -206,14 +200,14 @@ export function buildAgentWorkspaceSetupChecklist(input: AgentWorkspaceSetupChec
       detail: input.readyChannelCount > 0
         ? `${input.readyChannelCount} external channel(s) are ready.`
         : 'Pair or review channels only when you want the assistant reachable outside this terminal.',
-      command: 'Channels',
+      breadcrumb: 'Channels',
     },
     {
       id: 'voice-media',
       label: 'Voice and media',
       status: input.voiceProviderCount > 0 || input.mediaProviderCount > 0 ? 'ready' : 'optional',
       detail: `${input.voiceProviderCount} voice provider(s), ${input.mediaProviderCount} media provider(s). Configure these only when useful.`,
-      command: 'Voice & Media',
+      breadcrumb: 'Voice & Media',
     },
   ];
 }

package/src/input/agent-workspace-snapshot.ts

@@ -24,6 +24,8 @@ import type { PromptContextReceipt } from '../agent/prompt-context-receipts.ts';
 import { discoverProjectContextFiles } from '../agent/project-context-files.ts';
 import { getAgentRuntimeProfilesRoot, listAgentRuntimeProfiles, listAgentRuntimeProfileTemplates, readAgentRuntimeProfileSelection } from '../agent/runtime-profile.ts';
 import { RoutineScheduleReceiptStore } from '../agent/routine-schedule-receipts.ts';
+import { buildSetupWizardDurableReceipts } from '../agent/setup-wizard-artifact-receipts.ts';
+import { mergeSetupWizardDurableReceipts, setupWizardLiveDurableReceipts } from './setup-wizard-live-receipts.ts';
 import { readSetupWizardCheckpoint } from '../agent/setup-wizard-checkpoint.ts';
 import { discoverVibeFiles } from '../agent/vibe-file.ts';
 import {
@@ -35,6 +37,7 @@ import {
   buildAgentSetupWizard,
   emptyAgentSetupSmokeHistory,
   emptyAgentSetupWizardCheckpoint,
+  setupStepHasSatisfyingReceipt,
   type AgentSetupWizard,
   type AgentSetupWizardBlockedCheckFrequency,
   type AgentSetupWizardCheckpoint,
@@ -266,6 +269,11 @@ export function buildAgentWorkspaceRuntimeSnapshot(context: CommandContext): Age
       return { available: false, items: [] };
     }
   })();
+  const setupSmokeHistory = buildSetupSmokeHistory(artifactListSnapshot.items, artifactListSnapshot.available);
+  const durableSetupReceipts = mergeSetupWizardDurableReceipts(
+    buildSetupWizardDurableReceipts(artifactListSnapshot.items),
+    setupWizardLiveDurableReceipts(context),
+  );
   const recentReviewerHandoffs = (() => {
     try {
       const handoffs = artifactListSnapshot.items
@@ -452,6 +460,9 @@ export function buildAgentWorkspaceRuntimeSnapshot(context: CommandContext): Age
     voiceProviders: voiceProviderDescriptors,
     mediaProviders: mediaProviderDescriptors,
   });
+  const browserPwaEnabled = readConfigBoolean(context, 'web.enabled', false);
+  const browserPwaPublicBaseUrl = readConfigString(context, 'web.publicBaseUrl', '(not configured)');
+  const connectedHostAuthReceiptReady = setupStepHasSatisfyingReceipt(durableSetupReceipts, 'connected-host-auth');
   const setupChecklist = buildAgentWorkspaceSetupChecklist({
     provider,
     model,
@@ -460,6 +471,7 @@ export function buildAgentWorkspaceRuntimeSnapshot(context: CommandContext): Age
     connectedHostTokenReadable: companionAccess.tokenReadable,
     connectedHostTokenPath: companionAccess.tokenPath,
     connectedHostTokenError: companionAccess.tokenError,
+    connectedHostAuthReceiptReady,
     activeSubscriptionCount: subscriptionSnapshot.active,
     pendingSubscriptionCount: subscriptionSnapshot.pending,
     availableSubscriptionProviderCount: subscriptionSnapshot.available,
@@ -488,9 +500,10 @@ export function buildAgentWorkspaceRuntimeSnapshot(context: CommandContext): Age
   });
   const setupWizard = buildWorkspaceSetupWizard(
     setupChecklist,
-    buildSetupSmokeHistory(artifactListSnapshot.items, artifactListSnapshot.available),
+    setupSmokeHistory,
     buildSetupWizardCheckpoint(context),
     setupCompletionMarkerExists(context),
+    durableSetupReceipts,
   );
   const researchBrowserRunnerContract = buildResearchBrowserRunnerContract(context);
   const researchVisualReportContract = buildResearchVisualReportContract(researchSourceSnapshot);
@@ -619,8 +632,8 @@ export function buildAgentWorkspaceRuntimeSnapshot(context: CommandContext): Age
     mcpConnectedServerCount: mcpSnapshot.connectedCount,
     mcpQuarantinedServerCount: mcpSnapshot.quarantinedCount,
     mcpAllowAllServerCount: mcpSnapshot.allowAllCount,
-    browserToolExposureEnabled: readConfigBoolean(context, 'web.enabled', false),
-    browserToolPublicBaseUrl: readConfigString(context, 'web.publicBaseUrl', '(not configured)'),
+    browserToolExposureEnabled: browserPwaEnabled,
+    browserToolPublicBaseUrl: browserPwaPublicBaseUrl,
     activeRuntimeProfile: inferActiveRuntimeProfile(context.workspace?.shellPaths?.homeDirectory ?? ''),
     selectedRuntimeProfile: selectedRuntimeProfile?.id ?? null,
     selectedRuntimeProfileExists: selectedRuntimeProfile?.exists ?? false,

package/src/input/agent-workspace-types.ts

@@ -7,6 +7,8 @@ import type { AgentSetupWizard } from '../agent/setup-wizard.ts';
 
 export const AGENT_WORKSPACE_MODAL_NAME = 'agentWorkspace';
 
+export type AgentWorkspaceCategoryGroup = 'START' | 'ONBOARDING' | 'DAY-TO-DAY' | 'CAPABILITIES' | 'LOCAL BEHAVIOR' | 'OPERATIONS' | 'FINISH';
+
 export type AgentWorkspaceFocusPane = 'categories' | 'actions';
 
 export const AGENT_WORKSPACE_CATEGORY_IDS = [
@@ -310,11 +312,12 @@ export interface AgentWorkspaceAction {
   readonly localOperation?: AgentWorkspaceLocalOperation;
   readonly kind: AgentWorkspaceActionKind;
   readonly safety: 'safe' | 'read-only' | 'delegates' | 'blocked';
+  readonly commandBehavior?: 'inline' | 'compose' | 'exit';
 }
 
 export interface AgentWorkspaceCategory {
   readonly id: AgentWorkspaceCategoryId;
-  readonly group: string;
+  readonly group: AgentWorkspaceCategoryGroup;
   readonly label: string;
   readonly summary: string;
   readonly detail: string;
@@ -328,7 +331,7 @@ export interface AgentWorkspaceActionSearchResult {
   readonly actionIndex: number;
 }
 
-export type AgentWorkspaceCommandDispatcher = (command: string) => void;
+export type AgentWorkspaceCommandDispatcher = (command: string, behavior?: 'inline' | 'compose' | 'exit') => void;
 export type AgentWorkspacePromptDispatcher = (prompt: string) => void;
 
 export type AgentWorkspaceActionResultKind = 'guidance' | 'blocked' | 'dispatched' | 'refreshed' | 'error';

package/src/input/agent-workspace.ts

@@ -19,10 +19,11 @@ import { deleteAgentWorkspaceMemoryEditor, submitAgentWorkspaceMemoryEditor } fr
 import { jumpAgentWorkspaceSelection, moveAgentWorkspaceSelection, selectAgentWorkspaceCategory } from './agent-workspace-navigation.ts';
 import { appendAgentWorkspaceActionSearchText, backspaceAgentWorkspaceActionSearch, beginAgentWorkspaceActionSearch, clearAgentWorkspaceActionSearch, commitAgentWorkspaceActionSearchSelection, searchAgentWorkspaceActions } from './agent-workspace-search.ts';
 import { applyAgentWorkspaceSetupCheckpointAction } from './agent-workspace-setup-checkpoint-action.ts';
-import { agentWorkspaceSettingSchema, applyAgentWorkspaceSettingValue, buildAgentWorkspaceSettingActionEffect, importAgentWorkspaceTuiSettings, isAgentWorkspaceActionVisible } from './agent-workspace-settings.ts';
+import { agentWorkspaceSettingSchema, applyAgentWorkspaceSettingValue, buildAgentWorkspaceSettingActionDisplay, buildAgentWorkspaceSettingActionEffect, importAgentWorkspaceTuiSettings, isAgentWorkspaceActionVisible, type AgentWorkspaceSettingActionDisplay } from './agent-workspace-settings.ts';
 import { buildAgentWorkspaceRuntimeSnapshot } from './agent-workspace-snapshot.ts';
 import { submitAgentWorkspaceSubscriptionLoginFinishEditor, submitAgentWorkspaceSubscriptionLoginStartEditor, submitAgentWorkspaceSubscriptionLogoutEditor } from './agent-workspace-subscription-editor.ts';
-import type { AgentWorkspaceAction, AgentWorkspaceActionResult, AgentWorkspaceActionSearchResult, AgentWorkspaceCategory, AgentWorkspaceCommandDispatcher, AgentWorkspaceEditorField, AgentWorkspaceFocusPane, AgentWorkspaceLocalEditor, AgentWorkspaceLocalEditorKind, AgentWorkspaceLocalLibraryItem, AgentWorkspaceLocalOperation, AgentWorkspacePromptDispatcher, AgentWorkspaceRuntimeSnapshot } from './agent-workspace-types.ts';
+import type { AgentWorkspaceAction, AgentWorkspaceActionResult, AgentWorkspaceActionSearchResult, AgentWorkspaceCategory, AgentWorkspaceCategoryGroup, AgentWorkspaceCommandDispatcher, AgentWorkspaceEditorField, AgentWorkspaceFocusPane, AgentWorkspaceLocalEditor, AgentWorkspaceLocalEditorKind, AgentWorkspaceLocalLibraryItem, AgentWorkspaceLocalOperation, AgentWorkspacePromptDispatcher, AgentWorkspaceRuntimeSnapshot } from './agent-workspace-types.ts';
+import { ONBOARDING_COMPLETE_SYNTHETIC_ACTION, shouldShowOnboardingFinishFooter } from './agent-workspace-onboarding-finish.ts';
 import { writeOnboardingCheckMarker, writeOnboardingCompletionMarker } from '../runtime/onboarding/index.ts';
 
 export type { AgentWorkspaceChannelRisk, AgentWorkspaceChannelStatus } from './agent-workspace-channels.ts';
@@ -46,11 +47,13 @@ export class AgentWorkspace {
   private context: CommandContext | null = null;
   private dispatchCommand: AgentWorkspaceCommandDispatcher | null = null;
   private dispatchPrompt: AgentWorkspacePromptDispatcher | null = null;
+  private _onlyGroup: AgentWorkspaceCategoryGroup | null = null;
 
-  open(context: CommandContext, dispatchCommand: AgentWorkspaceCommandDispatcher, categoryId?: string, dispatchPrompt?: AgentWorkspacePromptDispatcher): void {
+  open(context: CommandContext, dispatchCommand: AgentWorkspaceCommandDispatcher, categoryId?: string, dispatchPrompt?: AgentWorkspacePromptDispatcher, onlyGroup?: AgentWorkspaceCategoryGroup): void {
     this.context = context;
     this.dispatchCommand = dispatchCommand;
     this.dispatchPrompt = dispatchPrompt ?? null;
+    this._onlyGroup = onlyGroup ?? null;
     this.runtimeSnapshot = buildAgentWorkspaceRuntimeSnapshot(context);
     this.active = true;
     this.focusPane = 'actions';
@@ -85,9 +88,13 @@ export class AgentWorkspace {
     this.localEditor = null;
     this.actionSearchActive = false;
     this.actionSearchQuery = '';
+    this._onlyGroup = null;
   }
 
   get categories(): readonly AgentWorkspaceCategory[] {
+    if (this._onlyGroup) {
+      return AGENT_WORKSPACE_CATEGORIES.filter((category) => category.group === this._onlyGroup);
+    }
     return AGENT_WORKSPACE_CATEGORIES;
   }
 
@@ -97,7 +104,11 @@ export class AgentWorkspace {
 
   get actions(): readonly AgentWorkspaceAction[] {
     if (this.actionSearchActive) return this.actionSearchResults.map((result) => result.action);
-    return this.selectedCategory.actions.filter((action) => isAgentWorkspaceActionVisible(this.context, action));
+    const base = this.selectedCategory.actions.filter((action) => isAgentWorkspaceActionVisible(this.context, action));
+    if (shouldShowOnboardingFinishFooter(this.selectedCategory, base)) {
+      return [...base, ONBOARDING_COMPLETE_SYNTHETIC_ACTION];
+    }
+    return base;
   }
 
   get selectedAction(): AgentWorkspaceAction | null {
@@ -142,6 +153,10 @@ export class AgentWorkspace {
     return selectedAgentWorkspaceLocalLibraryItem(this.runtimeSnapshot, this.selectedLibraryItemIndexes, kind);
   }
 
+  settingActionDisplay(action: AgentWorkspaceAction): AgentWorkspaceSettingActionDisplay | null {
+    return buildAgentWorkspaceSettingActionDisplay(this.context, action);
+  }
+
   focusCategories(): void {
     this.focusPane = 'categories';
   }
@@ -275,8 +290,8 @@ export class AgentWorkspace {
     return Boolean(this.context?.submitInput && this.dispatchPrompt);
   }
 
-  dispatchWorkspaceCommand(command: string): void {
-    this.dispatchCommand?.(command);
+  dispatchWorkspaceCommand(command: string, behavior?: 'inline' | 'compose' | 'exit'): void {
+    this.dispatchCommand?.(command, behavior);
   }
 
   dispatchWorkspacePrompt(prompt: string): void {

package/src/input/handler.ts

@@ -366,15 +366,16 @@ export class InputHandler {
     this.mcpWorkspace.open(context);
     this.requestRender();
   }
-  public openAgentWorkspace(context: CommandContext, categoryId?: string): void {
+  public openAgentWorkspace(context: CommandContext, categoryId?: string, onlyGroup?: string): void {
     this.panelFocused = false;
     this.indicatorFocused = false;
     this.modalOpened('agentWorkspace');
     this.agentWorkspace.open(
       context,
-      (command) => this.dispatchAgentWorkspaceCommand(command, context),
+      (command, behavior) => this.dispatchAgentWorkspaceCommand(command, context, behavior),
       categoryId,
       (prompt) => this.dispatchAgentWorkspacePrompt(prompt, context),
+      onlyGroup as import('./agent-workspace-types.ts').AgentWorkspaceCategoryGroup | undefined,
     );
     this.requestRender();
   }
@@ -395,10 +396,71 @@ export class InputHandler {
     return true;
   }
 
-  private dispatchAgentWorkspaceCommand(command: string, context: CommandContext): void {
-    this.closeAgentWorkspaceModal();
+  public dispatchAgentWorkspaceCommand(command: string, context: CommandContext, behavior?: 'inline' | 'compose' | 'exit'): void {
+    const resolved = behavior ?? 'compose';
     const { name, args } = parseSlashCommand(command);
     if (!name) return;
+    if (resolved === 'exit') {
+      this.closeAgentWorkspaceModal();
+      void context.executeCommand?.(name, [...args]).catch((error: unknown) => {
+        context.print(`Agent workspace command failed: ${error instanceof Error ? error.message : String(error)}`);
+        this.requestRender();
+      });
+      this.requestRender();
+      return;
+    }
+    if (resolved === 'inline') {
+      const capturedLines: string[] = [];
+      const originalPrint = context.print;
+      if (typeof context.executeCommand !== 'function') {
+        this.agentWorkspace.lastActionResult = {
+          kind: 'error',
+          title: `Command unavailable: ${command}`,
+          detail: 'No command dispatcher is configured for this runtime.',
+          command,
+          safety: 'safe',
+        };
+        this.requestRender();
+        return;
+      }
+      context.print = (text: string): void => {
+        capturedLines.push(text);
+      };
+      const buildCapturedDetail = (): string => {
+        const MAX_CHARS = 1500;
+        const MAX_LINES = 12;
+        const lines = capturedLines.slice(-MAX_LINES);
+        const joined = lines.join('\n');
+        if (joined.length > MAX_CHARS) {
+          return joined.slice(0, MAX_CHARS) + '\n… (output truncated)';
+        }
+        const omitted = capturedLines.length - lines.length;
+        return omitted > 0 ? `… (${omitted} line(s) truncated)\n${joined}` : joined || '(no output)';
+      };
+      void context.executeCommand(name, [...args]).then(() => {
+        context.print = originalPrint;
+        this.agentWorkspace.lastActionResult = {
+          kind: 'dispatched',
+          title: `Result: ${command}`,
+          detail: buildCapturedDetail(),
+          command,
+          safety: 'safe',
+        };
+        this.requestRender();
+      }).catch((error: unknown) => {
+        context.print = originalPrint;
+        this.agentWorkspace.lastActionResult = {
+          kind: 'error',
+          title: `${command} failed`,
+          detail: error instanceof Error ? error.message : String(error),
+          command,
+        };
+        this.requestRender();
+      });
+      return;
+    }
+    // compose (default): close workspace then execute
+    this.closeAgentWorkspaceModal();
     void context.executeCommand?.(name, [...args]).catch((error: unknown) => {
       context.print(`Agent workspace command failed: ${error instanceof Error ? error.message : String(error)}`);
       this.requestRender();
@@ -674,7 +736,7 @@ export class InputHandler {
       this.modalOpened('agentWorkspace');
       this.agentWorkspace.open(
         context,
-        (command) => this.dispatchAgentWorkspaceCommand(command, context),
+        (command, behavior) => this.dispatchAgentWorkspaceCommand(command, context, behavior),
         undefined,
         (prompt) => this.dispatchAgentWorkspacePrompt(prompt, context),
       );

package/src/input/setup-wizard-live-receipts.ts

@@ -0,0 +1,76 @@
+import type { CommandContext } from './command-registry.ts';
+import { buildSetupWizardDurableReceiptsFromReadModel, mergeSetupWizardDurableReceipts } from '../agent/setup-wizard-artifact-receipts.ts';
+import type { AgentSetupWizardDurableReceipt } from '../agent/setup-wizard.ts';
+
+interface SetupReceiptReadModelSource {
+  readonly path: string;
+  readonly source: unknown;
+}
+
+function readRecord(value: unknown): Record<string, unknown> {
+  return value && typeof value === 'object' && !Array.isArray(value) ? value as Record<string, unknown> : {};
+}
+
+function setupReceiptReadModelSources(context: CommandContext): readonly SetupReceiptReadModelSource[] {
+  const contextRecord = context as unknown as Record<string, unknown>;
+  const platform = readRecord(contextRecord.platform);
+  const clients = readRecord(contextRecord.clients);
+  const readModels = readRecord(platform.readModels);
+  const setup = readRecord(readModels.setup);
+  const setupWizard = readRecord(readModels.setupWizard);
+  const firstRun = readRecord(readModels.firstRun);
+  const browserPwa = readRecord(readModels.browserPwa);
+  const operator = readRecord(clients.operator);
+  return [
+    { path: 'context.platform.readModels.setup.receipts', source: setup.receipts },
+    { path: 'context.platform.readModels.setup.setupReceipts', source: setup.setupReceipts },
+    { path: 'context.platform.readModels.setup.receiptEvents', source: setup.receiptEvents },
+    { path: 'context.platform.readModels.setup.eventStream', source: setup.eventStream },
+    { path: 'context.platform.readModels.setup', source: readModels.setup },
+    { path: 'context.platform.readModels.setupWizard.receipts', source: setupWizard.receipts },
+    { path: 'context.platform.readModels.setupWizard.durableReceipts', source: setupWizard.durableReceipts },
+    { path: 'context.platform.readModels.setupWizard.receiptEvents', source: setupWizard.receiptEvents },
+    { path: 'context.platform.readModels.setupWizard.eventStream', source: setupWizard.eventStream },
+    { path: 'context.platform.readModels.setupReceipts', source: readModels.setupReceipts },
+    { path: 'context.platform.readModels.setupReceiptEvents', source: readModels.setupReceiptEvents },
+    { path: 'context.platform.readModels.setupReceiptEventStream', source: readModels.setupReceiptEventStream },
+    { path: 'context.platform.readModels.durableSetupReceipts', source: readModels.durableSetupReceipts },
+    { path: 'context.platform.readModels.firstRun.receipts', source: firstRun.receipts },
+    { path: 'context.platform.readModels.browserPwa.firstRunReceipts', source: browserPwa.firstRunReceipts },
+    { path: 'context.platform.setupReceipts', source: platform.setupReceipts },
+    { path: 'context.platform.setupReceiptEvents', source: platform.setupReceiptEvents },
+    { path: 'context.clients.operator.setupReceipts', source: operator.setupReceipts },
+    { path: 'context.clients.operator.setupReceiptEvents', source: operator.setupReceiptEvents },
+  ];
+}
+
+function readSnapshot(source: unknown): unknown {
+  if (typeof source === 'function') {
+    const result = (source as () => unknown)();
+    return result instanceof Promise ? undefined : result;
+  }
+  const record = readRecord(source);
+  for (const methodName of ['getSnapshot', 'snapshot', 'list', 'listReceipts', 'listEvents', 'listReceiptEvents', 'readEvents']) {
+    const method = record[methodName];
+    if (typeof method === 'function') {
+      const result = (method as () => unknown)();
+      return result instanceof Promise ? undefined : result;
+    }
+  }
+  return source;
+}
+
+export function setupWizardLiveDurableReceipts(context: CommandContext): readonly AgentSetupWizardDurableReceipt[] {
+  const receipts: AgentSetupWizardDurableReceipt[][] = [];
+  for (const entry of setupReceiptReadModelSources(context)) {
+    if (entry.source === undefined || entry.source === null) continue;
+    try {
+      receipts.push([...buildSetupWizardDurableReceiptsFromReadModel(readSnapshot(entry.source), entry.path)]);
+    } catch {
+      // Broken host read models should not hide local setup posture.
+    }
+  }
+  return mergeSetupWizardDurableReceipts(...receipts);
+}
+
+export { mergeSetupWizardDurableReceipts };

package/src/renderer/agent-workspace-context-lines.ts

@@ -46,43 +46,27 @@ function setupAttentionItems(snapshot: AgentWorkspaceRuntimeSnapshot, limit: num
 
 function setupOverviewLines(snapshot: AgentWorkspaceRuntimeSnapshot): ContextLine[] {
   const counts = setupCounts(snapshot);
-  const nextItems = setupAttentionItems(snapshot, 3);
-  const wizard = snapshot.setupWizard;
+  const attentionItems = setupAttentionItems(snapshot, 1);
+  const doneCount = counts.ready;
+  const totalCount = snapshot.setupChecklist.length;
+  const attentionCount = counts.blocked + counts.recommended;
+  const progressDetail = attentionCount > 0
+    ? `${doneCount} of ${totalCount} done — ${attentionCount} need attention`
+    : `${doneCount} of ${totalCount} done`;
   const lines: ContextLine[] = [
     { text: 'Onboarding', fg: PALETTE.title, bold: true },
-    { text: `${counts.ready}/${snapshot.setupChecklist.length} ready; ${counts.recommended} recommended; ${counts.optional} optional; ${counts.blocked} blocked.`, fg: counts.blocked > 0 ? PALETTE.warn : PALETTE.info },
-    { text: `Setup wizard: ${wizard.completedSteps}/${wizard.totalSteps} done; ${wizard.currentStepLabel ? `current ${wizard.currentStepLabel}` : wizard.status}.`, fg: wizard.status === 'complete' ? PALETTE.good : wizard.status === 'blocked' ? PALETTE.warn : PALETTE.info },
-    { text: `Wizard next: ${compactText(wizard.next, 112)}`, fg: wizard.status === 'complete' ? PALETTE.good : wizard.status === 'blocked' ? PALETTE.warn : PALETTE.info },
-    { text: `Setup closeout: ${wizard.closeout.label}; ${compactText(wizard.closeout.nextAction, 104)}`, fg: wizard.closeout.status === 'complete' || wizard.closeout.status === 'ready-to-finish' ? PALETTE.good : wizard.closeout.status === 'blocked' ? PALETTE.warn : PALETTE.info },
+    { text: progressDetail, fg: counts.blocked > 0 ? PALETTE.warn : doneCount === totalCount ? PALETTE.good : PALETTE.info },
     { text: `Chat: ${snapshot.provider} / ${snapshot.modelDisplayName}.`, fg: PALETTE.info },
     { text: `Local: ${snapshot.localPersonaCount} personas, ${snapshot.localSkillCount} skills, ${snapshot.localRoutineCount} routines, ${snapshot.localMemoryCount} memories.`, fg: PALETTE.info },
   ];
-  if (nextItems.length > 0) {
-    const item = nextItems[0]!;
+  if (attentionItems.length > 0) {
+    const item = attentionItems[0]!;
     lines.push({
       text: `Next: ${item.label} (${setupStatusLabel(item.status).toLowerCase()})`,
       fg: setupStatusColor(item.status),
       bold: item.status === 'blocked',
     });
   }
-  if (wizard.repeatedBlocker) {
-    lines.push({
-      text: `Repeated blocker: ${wizard.repeatedBlocker.checkId} in ${wizard.repeatedBlocker.count} saved smoke run(s).`,
-      fg: PALETTE.warn,
-    });
-  }
-  if (wizard.checkpoint.status !== 'none') {
-    lines.push({
-      text: `Setup checkpoint: ${compactText(wizard.checkpoint.summary, 112)}`,
-      fg: wizard.checkpoint.status === 'stale' || wizard.checkpoint.status === 'unavailable' ? PALETTE.warn : PALETTE.info,
-    });
-  }
-  if (wizard.smokeHistory.status === 'available') {
-    lines.push({
-      text: `Smoke history: ${wizard.smokeHistory.total} run(s); trend ${wizard.smokeHistory.trend}; latest ${wizard.smokeHistory.latestResult ?? 'unknown'}.`,
-      fg: wizard.smokeHistory.latestResult === 'blocked' ? PALETTE.warn : PALETTE.info,
-    });
-  }
   return lines;
 }
 
@@ -257,13 +241,13 @@ function promptReceiptTimelineLines(snapshot: AgentWorkspaceRuntimeSnapshot): Co
     fg: promptReceiptOutcomeColor(latest.outcomeStatus),
     bold: latest.outcomeStatus === 'error' || latest.outcomeStatus === 'cancelled',
   });
-  lines.push({ text: `Inspect latest prompt receipt: ${latest.inspectRoute}`, fg: PALETTE.good });
+  lines.push({ text: `Latest prompt receipt: ${latest.receiptId}; inspect it from Prompt context.`, fg: PALETTE.good });
   if (timeline.errorCount > 0) {
-    lines.push({ text: `Filter prompt receipt errors: ${timeline.filterRoutes.error}`, fg: PALETTE.warn });
+    lines.push({ text: 'Prompt receipt filter: show errors.', fg: PALETTE.warn });
   } else if (timeline.cancelledCount > 0) {
-    lines.push({ text: `Filter cancelled prompt receipts: ${timeline.filterRoutes.cancelled}`, fg: PALETTE.warn });
+    lines.push({ text: 'Prompt receipt filter: show cancelled turns.', fg: PALETTE.warn });
   } else if (timeline.pendingCount > 0) {
-    lines.push({ text: `Filter pending prompt receipts: ${timeline.filterRoutes.pending}`, fg: PALETTE.info });
+    lines.push({ text: 'Prompt receipt filter: show pending turns.', fg: PALETTE.info });
   }
   for (const receipt of timeline.items.slice(0, 3)) {
     lines.push({
@@ -274,7 +258,7 @@ function promptReceiptTimelineLines(snapshot: AgentWorkspaceRuntimeSnapshot): Co
   if (latest.detail) {
     lines.push({ text: `Latest outcome detail: ${compactText(latest.detail, 104)}`, fg: PALETTE.warn });
   }
-  lines.push({ text: `Inspect: ${timeline.inspectRoute}`, fg: PALETTE.good });
+  lines.push({ text: 'Prompt context controls stay read-only from this setup page.', fg: PALETTE.good });
   return lines;
 }
 
@@ -478,7 +462,7 @@ export function snapshotLines(workspace: AgentWorkspace, category: AgentWorkspac
       { text: `VIBE.md: ${vibe.applied} applied; ${vibe.blocked} blocked; ${vibe.truncated} truncated.`, fg: vibe.blocked > 0 ? PALETTE.warn : vibe.applied > 0 ? PALETTE.good : PALETTE.muted },
       { text: `Project context: ${projectContext.loaded} loaded; ${projectContext.blocked} blocked; ${projectContext.truncated} truncated.`, fg: projectContext.blocked > 0 ? PALETTE.warn : projectContext.loaded > 0 ? PALETTE.good : PALETTE.muted },
       ...promptReceiptTimelineLines(snapshot),
-      { text: 'Context routes: context prompt/files/file/receipt, /vibe status.', fg: PALETTE.good },
+      { text: 'Context controls: prompt receipts, project files, one-file inspection, and VIBE.md review.', fg: PALETTE.good },
     );
   } else if (category.id === 'onboarding-automation') {
     base.push(
@@ -536,7 +520,7 @@ export function snapshotLines(workspace: AgentWorkspace, category: AgentWorkspac
       companionAccessLine(snapshot),
       { text: `Channels: ${readyCount}/${snapshot.channels.length} ready; ${enabledCount} enabled; ${configuredDefaults} target(s).`, fg: PALETTE.info },
       { text: `Setup guide: ${guide.progressLabel}; ${guide.currentChannelLabel ?? 'choose a channel'}.`, fg: guide.status === 'ready' ? PALETTE.good : PALETTE.warn },
-      { text: `Next: ${currentGuideStep ? `${currentGuideStep.label} - ${compactText(currentGuideStep.userRoute)}` : 'All enabled channels ready.'}`, fg: currentGuideStep ? PALETTE.warn : PALETTE.good },
+      { text: `Next: ${currentGuideStep ? currentGuideStep.label : 'All enabled channels ready.'}`, fg: currentGuideStep ? PALETTE.warn : PALETTE.good },
       { text: 'Guide checks setup schema, accounts, allowlist policy, live status, and explicit test sends.', fg: PALETTE.good },
       { text: 'Triage: /channels triage shows blockers, delivery retries, surface messages, route bindings, and receipts.', fg: PALETTE.good },
       { text: 'Secrets hidden; sends require explicit action.', fg: PALETTE.warn },