@pellux/goodvibes-agent 1.5.5 → 1.5.6

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

@@ -1,292 +1,181 @@
 import { basename, sep } from 'node:path';
-import { listAvailableSubscriptionProviders } from '@pellux/goodvibes-sdk/platform/config';
-import type { ArtifactDescriptor } from '@pellux/goodvibes-sdk/platform/artifacts';
-import type { MemoryRecord } from '@pellux/goodvibes-sdk/platform/state';
 import type { CommandContext } from './command-registry.ts';
-import { AgentNoteRegistry, type AgentNoteRecord } from '../agent/note-registry.ts';
-import { AgentDocumentRegistry, type AgentDocumentRecord } from '../agent/document-registry.ts';
-import { AgentPersonaRegistry, type AgentPersonaRecord } from '../agent/persona-registry.ts';
-import { formatAgentRecordOrigin } from '../agent/record-labels.ts';
-import { AgentRoutineRegistry, evaluateAgentRoutineReadiness, type AgentRoutineRecord } from '../agent/routine-registry.ts';
-import { AgentResearchRunRegistry, researchRunLogTail } from '../agent/research-run-registry.ts';
-import { AgentResearchSourceRegistry } from '../agent/research-source-registry.ts';
-import {
-  AgentSkillRegistry,
-  evaluateAgentSkillBundleReadiness,
-  evaluateAgentSkillReadiness,
-  formatAgentSkillRequirement,
-  type AgentSkillBundleRecord,
-  type AgentSkillRecord,
-} from '../agent/skill-registry.ts';
+import { AgentRoutineRegistry } from '../agent/routine-registry.ts';
+import { describeMemoryPromptEligibility, isPromptActiveMemory } from '../agent/memory-prompt.ts';
 import { summarizeAgentBehaviorDiscovery } from '../agent/behavior-discovery-summary.ts';
-import { isPromptActiveMemory } from '../agent/memory-prompt.ts';
-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 {
-  DEFAULT_AGENT_SETUP_WIZARD_CLEAR_CHECKPOINT_ROUTE,
-  DEFAULT_AGENT_SETUP_WIZARD_INSPECT_CHECKPOINT_ROUTE,
-  DEFAULT_AGENT_SETUP_WIZARD_MARK_CHECKPOINT_ROUTE,
-  DEFAULT_AGENT_SETUP_WIZARD_RERUN_SMOKE_ROUTE,
-  DEFAULT_AGENT_SETUP_WIZARD_SAVE_SMOKE_ROUTE,
-  buildAgentSetupWizard,
-  emptyAgentSetupSmokeHistory,
-  emptyAgentSetupWizardCheckpoint,
-  setupStepHasSatisfyingReceipt,
-  type AgentSetupWizard,
-  type AgentSetupWizardBlockedCheckFrequency,
-  type AgentSetupWizardCheckpoint,
-  type AgentSetupWizardSmokeHistory,
-  type AgentSetupWizardSourceItem,
-} from '../agent/setup-wizard.ts';
-import { GOODVIBES_AGENT_PAIRING_SURFACE } from '../config/surface.ts';
-import { connectedHostOperatorTokenFingerprint, readConnectedHostOperatorToken, type ConnectedHostOperatorToken } from '../runtime/connected-host-auth.ts';
+import { setupStepHasSatisfyingReceipt } from '../agent/setup-wizard.ts';
 import { buildAgentWorkspaceChannelSetupGuide, buildAgentWorkspaceChannels } from './agent-workspace-channels.ts';
-import { getAgentWorkspaceConfigReader } from './agent-workspace-config-reader.ts';
-import { buildAgentWorkspaceSetupChecklist, type AgentWorkspaceSetupChecklistItem } from './agent-workspace-setup.ts';
-import { buildAgentWorkspaceVoiceMediaReadiness, type AgentWorkspaceVoiceMediaProviderDescriptor } from './agent-workspace-voice-media.ts';
+import { buildAgentWorkspaceSetupChecklist } from './agent-workspace-setup.ts';
+import { buildAgentWorkspaceVoiceMediaReadiness } from './agent-workspace-voice-media.ts';
 import { buildProcessSupervisionSummary, buildProjectContextSummary, buildPromptContextReceiptTimeline, buildResearchBrowserRunnerContract, buildResearchVisualReportContract, buildVibeSummary } from './agent-workspace-context-snapshot.ts';
-import { summarizeMemoryItem, summarizeNoteItem, summarizePersonaItem, summarizeResearchRunItem, summarizeRoutineItem, summarizeRoutineScheduleReceipt, summarizeRuntimeProfile, summarizeSkillBundleItem, summarizeSkillItem, summarizeStarterTemplate } from './agent-workspace-local-library-snapshot.ts';
+import { summarizeMemoryItem, summarizeRoutineItem, summarizeRuntimeProfile, summarizeStarterTemplate } from './agent-workspace-local-library-snapshot.ts';
 import { buildReviewPacketDefaults, buildReviewPacketTimeline, buildReviewPacketWizard, readDocumentDrafts, reviewerReadinessBadge } from './agent-workspace-review-packet-snapshot.ts';
-import { isReviewerHandoffArtifact, summarizeReviewerHandoffArtifact } from './agent-workspace-review-packet-utils.ts';
 import { buildSetupSmokeHistory, buildSetupWizardCheckpoint, buildWorkspaceSetupWizard, setupCompletionMarkerExists } from './agent-workspace-setup-snapshot.ts';
-import { readOnboardingCompletionMarker } from '../runtime/onboarding/index.ts';
-import type { AgentWorkspaceRuntimeSnapshot } from './agent-workspace-types.ts';
+import { readConfigNumber, readConfigString } from './agent-workspace-snapshot-config.ts';
+import {
+  buildAgentWorkspaceArtifactListSnapshot,
+  buildAgentWorkspaceCalendarOAuthConfigStatus,
+  buildAgentWorkspaceCompanionAccessSnapshot,
+  buildAgentWorkspaceConfigSettingsSnapshot,
+  buildAgentWorkspaceCurrentModelSnapshot,
+  buildAgentWorkspaceEmailConnectStatus,
+  buildAgentWorkspaceMcpServerSnapshot,
+  buildAgentWorkspaceNoteSnapshot,
+  buildAgentWorkspacePersonaSnapshot,
+  buildAgentWorkspaceRecentReviewerHandoffsSnapshot,
+  buildAgentWorkspaceResearchRunSnapshot,
+  buildAgentWorkspaceResearchSourceSnapshot,
+  buildAgentWorkspaceRoutineScheduleReceiptsSnapshot,
+  buildAgentWorkspaceRuntimeProfilesSnapshot,
+  buildAgentWorkspaceSessionMemoryCount,
+  buildAgentWorkspaceSkillSnapshot,
+  buildAgentWorkspaceSubscriptionSnapshot,
+  buildAgentWorkspaceVoiceMediaProvidersSnapshot,
+} from './agent-workspace-snapshot-builders.ts';
+import type { AgentWorkspaceLocalLibraryItem, AgentWorkspaceRuntimeSnapshot } from './agent-workspace-types.ts';
 
-function readConfigString(context: CommandContext, key: string, fallback: string): string {
-  try {
-    const configManager = getAgentWorkspaceConfigReader(context);
-    const value = configManager?.get(key);
-    return typeof value === 'string' && value.trim().length > 0 ? value.trim() : fallback;
-  } catch {
-    return fallback;
-  }
+// Re-exported so this module's public surface matches the pre-split file (W4-A5
+// added and exported this builder here before the W4-H2 split moved its body to
+// agent-workspace-snapshot-builders.ts).
+export { buildAgentWorkspaceEmailConnectStatus } from './agent-workspace-snapshot-builders.ts';
+
+function inferActiveRuntimeProfile(homeDirectory: string): string {
+  const marker = `${sep}.goodvibes${sep}agent${sep}profile-homes${sep}`;
+  return homeDirectory.includes(marker) ? basename(homeDirectory) : '(default home)';
 }
 
-function readConfigNumber(context: CommandContext, key: string, fallback: number): number {
-  try {
-    const configManager = getAgentWorkspaceConfigReader(context);
-    const value = configManager?.get(key);
-    const numberValue = typeof value === 'number' ? value : Number(value);
-    return Number.isFinite(numberValue) ? numberValue : fallback;
-  } catch {
-    return fallback;
-  }
+function inferRuntimeProfileBaseHome(homeDirectory: string): string {
+  const marker = `${sep}.goodvibes${sep}agent${sep}profile-homes${sep}`;
+  const markerIndex = homeDirectory.indexOf(marker);
+  return markerIndex >= 0 ? homeDirectory.slice(0, markerIndex) : homeDirectory;
+}
+
+export interface AgentWorkspaceLiveMemoryCounters {
+  readonly count: number;
+  readonly reviewQueueCount: number;
+  readonly promptActiveCount: number;
+  readonly items: readonly AgentWorkspaceLocalLibraryItem[];
 }
 
-function readConfigBoolean(context: CommandContext, key: string, fallback: boolean): boolean {
+/**
+ * Reads the Agent memory count + items directly from the live memory API
+ * (no caching). Throws if the read itself fails (e.g. the memory API errors
+ * mid-call) rather than swallowing it — callers that need a best-effort,
+ * never-throws default (the full runtime snapshot builder below) should use
+ * buildAgentWorkspaceMemorySnapshot instead. The render-path live-counter
+ * refresh (AgentWorkspace.syncLiveCountersForRender, W4-A6) calls this
+ * directly so a genuine read failure can be surfaced as "stale" instead of
+ * being silently rewritten to a fabricated 0.
+ *
+ * NOTE (W4-H1 observability flag): these live process/state counters are
+ * flagged as observability-shaped content whose eventual surface home is the
+ * fleet/observability layer, not this admin-console snapshot builder. Nothing
+ * moves today (no observability layer exists yet); this function is kept
+ * intact and separate rather than folded into the sibling sub-builders in
+ * agent-workspace-snapshot-builders.ts extracted alongside it in W4-H2.
+ */
+export function readLiveAgentMemoryCounters(context: CommandContext): AgentWorkspaceLiveMemoryCounters {
+  const memory = context.clients?.agentKnowledgeApi?.memory;
+  if (!memory) return { count: 0, reviewQueueCount: 0, promptActiveCount: 0, items: [] };
+  const records = [...memory.getAll()].sort((left, right) => right.updatedAt - left.updatedAt);
+  return {
+    count: records.length,
+    reviewQueueCount: memory.reviewQueue(100).length,
+    promptActiveCount: records.filter(isPromptActiveMemory).length,
+    // Each item carries the honest, per-record eligibility reason straight from
+    // describeMemoryPromptEligibility (Wave-4 W4-A1B) — the same wording source
+    // prompt-context-receipts.ts and agent-harness-prompt-context.ts use for prompt
+    // recall. No locally invented "not reviewed"/"outside prompt limit" paraphrase here.
+    items: records.map((record) => ({
+      ...summarizeMemoryItem(record),
+      promptEligible: isPromptActiveMemory(record),
+      promptEligibilityReason: describeMemoryPromptEligibility(record).reason,
+    })),
+  };
+}
+
+/**
+ * Best-effort variant of readLiveAgentMemoryCounters for the full runtime
+ * snapshot builder: never throws, defaults to empty on any read failure.
+ */
+export function buildAgentWorkspaceMemorySnapshot(context: CommandContext): AgentWorkspaceLiveMemoryCounters {
   try {
-    const configManager = getAgentWorkspaceConfigReader(context);
-    const value = configManager?.get(key);
-    if (typeof value === 'boolean') return value;
-    if (typeof value === 'string') {
-      const normalized = value.trim().toLowerCase();
-      if (normalized === 'true') return true;
-      if (normalized === 'false') return false;
-    }
-    return fallback;
+    return readLiveAgentMemoryCounters(context);
   } catch {
-    return fallback;
+    return { count: 0, reviewQueueCount: 0, promptActiveCount: 0, items: [] };
   }
 }
 
-function inferActiveRuntimeProfile(homeDirectory: string): string {
-  const marker = `${sep}.goodvibes${sep}agent${sep}profile-homes${sep}`;
-  return homeDirectory.includes(marker) ? basename(homeDirectory) : '(default home)';
+export interface AgentWorkspaceLiveRoutineCounters {
+  readonly count: number;
+  readonly enabled: number;
+  readonly items: readonly AgentWorkspaceLocalLibraryItem[];
 }
 
-function inferRuntimeProfileBaseHome(homeDirectory: string): string {
-  const marker = `${sep}.goodvibes${sep}agent${sep}profile-homes${sep}`;
-  const markerIndex = homeDirectory.indexOf(marker);
-  return markerIndex >= 0 ? homeDirectory.slice(0, markerIndex) : homeDirectory;
+/**
+ * Reads the Agent routine count + items (including each routine's live
+ * startCount) directly from the on-disk routine store (no caching). Throws
+ * if the store read fails (e.g. a corrupt/unreadable routines.json —
+ * AgentRoutineRegistry.snapshot() itself throws in that case) rather than
+ * swallowing it; see readLiveAgentMemoryCounters above for why the
+ * render-path live-counter refresh (W4-A6) wants that.
+ *
+ * NOTE (W4-H1 observability flag): see readLiveAgentMemoryCounters above —
+ * the same flag applies to these routine counters.
+ */
+export function readLiveAgentRoutineCounters(context: CommandContext): AgentWorkspaceLiveRoutineCounters {
+  const shellPaths = context.workspace?.shellPaths;
+  if (!shellPaths) return { count: 0, enabled: 0, items: [] };
+  const snapshot = AgentRoutineRegistry.fromShellPaths(shellPaths).snapshot();
+  return {
+    count: snapshot.routines.length,
+    enabled: snapshot.enabledRoutines.length,
+    items: snapshot.routines.map(summarizeRoutineItem),
+  };
+}
+
+/**
+ * Best-effort variant of readLiveAgentRoutineCounters for the full runtime
+ * snapshot builder: never throws, defaults to empty on any read failure.
+ */
+export function buildAgentWorkspaceRoutineCounters(context: CommandContext): AgentWorkspaceLiveRoutineCounters {
+  try {
+    return readLiveAgentRoutineCounters(context);
+  } catch {
+    return { count: 0, enabled: 0, items: [] };
+  }
 }
 
+/**
+ * Assembles the full Agent workspace runtime snapshot. Composes the
+ * sub-builders in agent-workspace-snapshot-builders.ts (W4-H2 split of what
+ * was previously one ~516-line function) plus the two live-counter builders
+ * above, then maps everything onto the AgentWorkspaceRuntimeSnapshot shape.
+ */
 export function buildAgentWorkspaceRuntimeSnapshot(context: CommandContext): AgentWorkspaceRuntimeSnapshot {
   const host = readConfigString(context, 'controlPlane.host', '127.0.0.1');
   const port = readConfigNumber(context, 'controlPlane.port', 3421);
   const model = context.session?.runtime?.model ?? 'unknown';
   const provider = context.session?.runtime?.provider ?? 'unknown';
-  const currentModel = (() => {
-    try {
-      return context.provider?.providerRegistry?.getCurrentModel?.();
-    } catch {
-      return null;
-    }
-  })();
-  const sessionMemoryCount = (() => {
-    try {
-      return context.session?.sessionMemoryStore?.list?.().length ?? 0;
-    } catch {
-      return 0;
-    }
-  })();
-  const memorySnapshot = (() => {
-    try {
-      const memory = context.clients?.agentKnowledgeApi?.memory;
-      if (!memory) return { count: 0, reviewQueueCount: 0, promptActiveCount: 0, items: [] };
-      const records = [...memory.getAll()].sort((left, right) => right.updatedAt - left.updatedAt);
-      return {
-        count: records.length,
-        reviewQueueCount: memory.reviewQueue(100).length,
-        promptActiveCount: records.filter(isPromptActiveMemory).length,
-        items: records.map(summarizeMemoryItem),
-      };
-    } catch {
-      return { count: 0, reviewQueueCount: 0, promptActiveCount: 0, items: [] };
-    }
-  })();
-  const personaSnapshot = (() => {
-    try {
-      const shellPaths = context.workspace?.shellPaths;
-      if (!shellPaths) return { count: 0, activeName: '(none)', items: [] };
-      const snapshot = AgentPersonaRegistry.fromShellPaths(shellPaths).snapshot();
-      return {
-        count: snapshot.personas.length,
-        activeName: snapshot.activePersona?.name ?? '(none)',
-        items: snapshot.personas.map((persona) => summarizePersonaItem(persona, snapshot.activePersonaId)),
-      };
-    } catch {
-      return { count: 0, activeName: '(unavailable)', items: [] };
-    }
-  })();
-  const noteSnapshot = (() => {
-    try {
-      const shellPaths = context.workspace?.shellPaths;
-      if (!shellPaths) return { count: 0, reviewQueueCount: 0, items: [] };
-      const snapshot = AgentNoteRegistry.fromShellPaths(shellPaths).snapshot();
-      return {
-        count: snapshot.notes.length,
-        reviewQueueCount: snapshot.reviewQueue.length,
-        items: snapshot.notes.map(summarizeNoteItem),
-      };
-    } catch {
-      return { count: 0, reviewQueueCount: 0, items: [] };
-    }
-  })();
-  const skillSnapshot = (() => {
-    try {
-      const shellPaths = context.workspace?.shellPaths;
-      if (!shellPaths) return { count: 0, enabled: 0, active: 0, bundleCount: 0, enabledBundleCount: 0, items: [], bundleItems: [] };
-      const snapshot = AgentSkillRegistry.fromShellPaths(shellPaths).snapshot();
-      return {
-        count: snapshot.skills.length,
-        enabled: snapshot.enabledSkills.length,
-        active: snapshot.activeSkills.length,
-        bundleCount: snapshot.bundles.length,
-        enabledBundleCount: snapshot.enabledBundles.length,
-        items: snapshot.skills.map(summarizeSkillItem),
-        bundleItems: snapshot.bundles.map((bundle) => summarizeSkillBundleItem(bundle, snapshot.skills)),
-      };
-    } catch {
-      return { count: 0, enabled: 0, active: 0, bundleCount: 0, enabledBundleCount: 0, items: [], bundleItems: [] };
-    }
-  })();
-  const routineSnapshot = (() => {
-    try {
-      const shellPaths = context.workspace?.shellPaths;
-      if (!shellPaths) return { count: 0, enabled: 0, items: [] };
-      const snapshot = AgentRoutineRegistry.fromShellPaths(shellPaths).snapshot();
-      return {
-        count: snapshot.routines.length,
-        enabled: snapshot.enabledRoutines.length,
-        items: snapshot.routines.map(summarizeRoutineItem),
-      };
-    } catch {
-      return { count: 0, enabled: 0, items: [] };
-    }
-  })();
-  const routineScheduleReceipts = (() => {
-    try {
-      const shellPaths = context.workspace?.shellPaths;
-      if (!shellPaths) return { count: 0, successful: 0, failed: 0, latest: null };
-      const receipts = RoutineScheduleReceiptStore.fromShellPaths(shellPaths).snapshot().receipts;
-      return {
-        count: receipts.length,
-        successful: receipts.filter((receipt) => receipt.status === 'created').length,
-        failed: receipts.filter((receipt) => receipt.status === 'failed').length,
-        latest: receipts[0] ? summarizeRoutineScheduleReceipt(receipts[0]) : null,
-      };
-    } catch {
-      return { count: 0, successful: 0, failed: 0, latest: null };
-    }
-  })();
-  const researchSourceSnapshot = (() => {
-    try {
-      const shellPaths = context.workspace?.shellPaths;
-      if (!shellPaths) return { count: 0, candidate: 0, reviewed: 0, rejected: 0, used: 0 };
-      const snapshot = AgentResearchSourceRegistry.fromShellPaths(shellPaths).snapshot();
-      return {
-        count: snapshot.sources.length,
-        candidate: snapshot.candidates.length,
-        reviewed: snapshot.reviewed.length,
-        rejected: snapshot.rejected.length,
-        used: snapshot.used.length,
-      };
-    } catch {
-      return { count: 0, candidate: 0, reviewed: 0, rejected: 0, used: 0 };
-    }
-  })();
-  const researchRunSnapshot = (() => {
-    try {
-      const shellPaths = context.workspace?.shellPaths;
-      if (!shellPaths) return { count: 0, planned: 0, running: 0, paused: 0, blocked: 0, terminal: 0, items: [] };
-      const snapshot = AgentResearchRunRegistry.fromShellPaths(shellPaths).snapshot();
-      const actionable = [
-        ...snapshot.blocked,
-        ...snapshot.running,
-        ...snapshot.paused,
-        ...snapshot.planned,
-        ...snapshot.failed,
-        ...snapshot.completed,
-        ...snapshot.cancelled,
-      ];
-      return {
-        count: snapshot.runs.length,
-        planned: snapshot.planned.length,
-        running: snapshot.running.length,
-        paused: snapshot.paused.length,
-        blocked: snapshot.blocked.length,
-        terminal: snapshot.cancelled.length + snapshot.completed.length + snapshot.failed.length,
-        items: actionable.slice(0, 8).map(summarizeResearchRunItem),
-      };
-    } catch {
-      return { count: 0, planned: 0, running: 0, paused: 0, blocked: 0, terminal: 0, items: [] };
-    }
-  })();
-  const artifactListSnapshot = (() => {
-    try {
-      const list = context.platform?.artifactStore?.list;
-      return {
-        available: Boolean(list),
-        items: [...(list?.(100) ?? [])],
-      };
-    } catch {
-      return { available: false, items: [] };
-    }
-  })();
+  const currentModel = buildAgentWorkspaceCurrentModelSnapshot(context);
+  const sessionMemoryCount = buildAgentWorkspaceSessionMemoryCount(context);
+  const memorySnapshot = buildAgentWorkspaceMemorySnapshot(context);
+  const personaSnapshot = buildAgentWorkspacePersonaSnapshot(context);
+  const noteSnapshot = buildAgentWorkspaceNoteSnapshot(context);
+  const skillSnapshot = buildAgentWorkspaceSkillSnapshot(context);
+  const routineSnapshot = buildAgentWorkspaceRoutineCounters(context);
+  const routineScheduleReceipts = buildAgentWorkspaceRoutineScheduleReceiptsSnapshot(context);
+  const researchSourceSnapshot = buildAgentWorkspaceResearchSourceSnapshot(context);
+  const researchRunSnapshot = buildAgentWorkspaceResearchRunSnapshot(context);
+  const artifactListSnapshot = buildAgentWorkspaceArtifactListSnapshot(context);
   const setupSmokeHistory = buildSetupSmokeHistory(artifactListSnapshot.items, artifactListSnapshot.available);
   const durableSetupReceipts = mergeSetupWizardDurableReceipts(
     buildSetupWizardDurableReceipts(artifactListSnapshot.items),
     setupWizardLiveDurableReceipts(context),
   );
-  const recentReviewerHandoffs = (() => {
-    try {
-      const handoffs = artifactListSnapshot.items
-        .filter(isReviewerHandoffArtifact)
-        .sort((left, right) => right.createdAt - left.createdAt);
-      return {
-        count: handoffs.length,
-        items: handoffs.slice(0, 6).map(summarizeReviewerHandoffArtifact),
-      };
-    } catch {
-      return { count: 0, items: [] };
-    }
-  })();
+  const recentReviewerHandoffs = buildAgentWorkspaceRecentReviewerHandoffsSnapshot(artifactListSnapshot.items);
   const documentDrafts = readDocumentDrafts(context);
   const reviewerBadge = reviewerReadinessBadge(
     documentDrafts,
@@ -309,65 +198,15 @@ export function buildAgentWorkspaceRuntimeSnapshot(context: CommandContext): Age
   );
   const discoveredBehavior = summarizeAgentBehaviorDiscovery(context.workspace?.shellPaths);
   const profileBaseHome = inferRuntimeProfileBaseHome(context.workspace?.shellPaths?.homeDirectory ?? '');
-  const runtimeProfiles = (() => {
-    try {
-      return listAgentRuntimeProfiles(profileBaseHome);
-    } catch {
-      return [];
-    }
-  })();
-  const runtimeStarterTemplates = (() => {
-    try {
-      return listAgentRuntimeProfileTemplates(profileBaseHome);
-    } catch {
-      return [];
-    }
-  })();
-  const selectedRuntimeProfile = (() => {
-    try {
-      return readAgentRuntimeProfileSelection(profileBaseHome);
-    } catch {
-      return null;
-    }
-  })();
-  const voiceProviders = (() => {
-    try {
-      return context.platform?.voiceProviderRegistry?.list?.() ?? [];
-    } catch {
-      return [];
-    }
-  })();
-  const mediaProviders = (() => {
-    try {
-      return context.platform?.mediaProviderRegistry?.list?.() ?? [];
-    } catch {
-      return [];
-    }
-  })();
-  const mcpSnapshot = (() => {
-    try {
-      const servers = context.clients?.mcpApi?.listServerSecurity?.() ?? context.extensions?.mcpRegistry?.listServerSecurity?.() ?? [];
-      return {
-        serverCount: servers.length,
-        connectedCount: servers.filter((server) => server.connected).length,
-        quarantinedCount: servers.filter((server) => server.schemaFreshness === 'quarantined').length,
-        allowAllCount: servers.filter((server) => server.trustMode === 'allow-all').length,
-      };
-    } catch {
-      return {
-        serverCount: 0,
-        connectedCount: 0,
-        quarantinedCount: 0,
-        allowAllCount: 0,
-      };
-    }
-  })();
-  const voiceProviderDescriptors: readonly AgentWorkspaceVoiceMediaProviderDescriptor[] = voiceProviders.map((provider) => ({
+  const { runtimeProfiles, runtimeStarterTemplates, selectedRuntimeProfile, runtimeProfileRoot } = buildAgentWorkspaceRuntimeProfilesSnapshot(profileBaseHome);
+  const { voiceProviders, mediaProviders } = buildAgentWorkspaceVoiceMediaProvidersSnapshot(context);
+  const mcpSnapshot = buildAgentWorkspaceMcpServerSnapshot(context);
+  const voiceProviderDescriptors = voiceProviders.map((provider) => ({
     id: provider.id,
     label: provider.label,
     capabilities: provider.capabilities,
   }));
-  const mediaProviderDescriptors: readonly AgentWorkspaceVoiceMediaProviderDescriptor[] = mediaProviders.map((provider) => ({
+  const mediaProviderDescriptors = mediaProviders.map((provider) => ({
     id: provider.id,
     label: provider.label,
     capabilities: provider.capabilities,
@@ -375,84 +214,10 @@ export function buildAgentWorkspaceRuntimeSnapshot(context: CommandContext): Age
   const warnings: string[] = [];
   if (provider === 'unknown' || model === 'unknown') warnings.push('Provider/model unavailable in this runtime context.');
   if (!context.executeCommand) warnings.push('Command dispatch is unavailable; workspace actions will show guidance only.');
-  const ttsProvider = readConfigString(context, 'tts.provider', '(provider default)');
-  const ttsVoice = readConfigString(context, 'tts.voice', '(voice default)');
-  const ttsLlmProvider = readConfigString(context, 'tts.llmProvider', '');
-  const ttsLlmModel = readConfigString(context, 'tts.llmModel', '');
-  const embeddingProvider = readConfigString(context, 'provider.embeddingProvider', '(provider default)');
-  const reasoningEffort = readConfigString(context, 'provider.reasoningEffort', '(default)');
-  const helperEnabled = readConfigBoolean(context, 'helper.enabled', false);
-  const toolLlmEnabled = readConfigBoolean(context, 'tools.llmEnabled', false);
-  const providerFailureHints = readConfigBoolean(context, 'behavior.suggestAlternativeOnProviderFail', false);
-  const cacheEnabled = readConfigBoolean(context, 'cache.enabled', true);
-  const cacheStableTtl = readConfigString(context, 'cache.stableTtl', '(default)');
-  const cacheMonitorHitRate = readConfigBoolean(context, 'cache.monitorHitRate', true);
-  const cacheHitRateWarningThreshold = readConfigNumber(context, 'cache.hitRateWarningThreshold', 0.3);
-  const hitlMode = readConfigString(context, 'behavior.hitlMode', '(default)');
-  const guidanceMode = readConfigString(context, 'behavior.guidanceMode', '(default)');
-  const saveHistory = readConfigBoolean(context, 'behavior.saveHistory', true);
-  const autoApprove = readConfigBoolean(context, 'behavior.autoApprove', false);
-  const autoCompactThreshold = readConfigNumber(context, 'behavior.autoCompactThreshold', 0);
-  const staleContextWarnings = readConfigBoolean(context, 'behavior.staleContextWarnings', false);
-  const showThinking = readConfigBoolean(context, 'display.showThinking', false);
-  const showReasoningSummary = readConfigBoolean(context, 'display.showReasoningSummary', false);
-  const theme = readConfigString(context, 'display.theme', '(default)');
-  const stream = readConfigBoolean(context, 'display.stream', true);
-  const lineNumbers = readConfigString(context, 'display.lineNumbers', '(default)');
-  const operationalMessages = readConfigString(context, 'ui.operationalMessages', '(default)');
-  const systemMessages = readConfigString(context, 'ui.systemMessages', '(default)');
-  const releaseChannel = readConfigString(context, 'release.channel', '(default)');
-  const permissionMode = readConfigString(context, 'permissions.mode', '(default)');
-  const toolAutoHeal = readConfigBoolean(context, 'tools.autoHeal', false);
-  const toolsDefaultTokenBudget = readConfigNumber(context, 'tools.defaultTokenBudget', 5000);
-  const artifactMaxBytes = readConfigNumber(context, 'storage.artifacts.maxBytes', 512 * 1024 * 1024);
-  const rawPromptTelemetry = readConfigBoolean(context, 'telemetry.includeRawPrompts', false);
-  const automationEnabled = readConfigBoolean(context, 'automation.enabled', false);
-  const automationMaxConcurrentRuns = readConfigNumber(context, 'automation.maxConcurrentRuns', 4);
-  const automationRunHistoryLimit = readConfigNumber(context, 'automation.runHistoryLimit', 100);
-  const automationDefaultTimeoutMs = readConfigNumber(context, 'automation.defaultTimeoutMs', 15 * 60 * 1000);
-  const automationCatchUpWindowMinutes = readConfigNumber(context, 'automation.catchUpWindowMinutes', 30);
-  const automationFailureCooldownMs = readConfigNumber(context, 'automation.failureCooldownMs', 5 * 60 * 1000);
-  const automationDeleteAfterRun = readConfigBoolean(context, 'automation.deleteAfterRun', false);
+  const config = buildAgentWorkspaceConfigSettingsSnapshot(context);
   const runtimeBaseUrl = `http://${host}:${port}`;
-  const companionAccess = (() => {
-    const homeDirectory = context.workspace?.shellPaths?.homeDirectory ?? '';
-    const tokenRecord: ConnectedHostOperatorToken = homeDirectory.length > 0
-      ? readConnectedHostOperatorToken(homeDirectory)
-      : { path: '(Agent home unavailable)', present: false, token: null };
-    const tokenFingerprint = tokenRecord.token ? connectedHostOperatorTokenFingerprint(tokenRecord.token) : null;
-    const pairingReady = Boolean(tokenRecord.token);
-    const nextStep = tokenRecord.error
-      ? 'Repair the connected-host operator token file through the owning GoodVibes host, then rerun /pair.'
-      : pairingReady
-        ? 'Use /pair to scan the QR code. Manual token display stays hidden unless /pair --show-token --yes is used.'
-        : 'Pair or provision connected-host access through the owning GoodVibes host, then rerun /pair.';
-    return {
-      surface: GOODVIBES_AGENT_PAIRING_SURFACE,
-      hostUrl: runtimeBaseUrl,
-      tokenPath: tokenRecord.path,
-      tokenPresent: tokenRecord.present,
-      tokenReadable: Boolean(tokenRecord.token),
-      tokenFingerprint,
-      tokenError: tokenRecord.error ?? null,
-      pairingReady,
-      qrCommand: '/pair',
-      manualTokenCommand: '/pair --show-token --yes',
-      nextStep,
-    } as const;
-  })();
-  const subscriptionSnapshot = (() => {
-    try {
-      const manager = context.platform?.subscriptionManager;
-      const services = context.platform?.serviceRegistry;
-      const active = manager?.list?.().length ?? 0;
-      const pending = manager?.listPending?.().length ?? 0;
-      const available = services ? listAvailableSubscriptionProviders(services.getAll()).length : 0;
-      return { active, pending, available };
-    } catch {
-      return { active: 0, pending: 0, available: 0 };
-    }
-  })();
+  const companionAccess = buildAgentWorkspaceCompanionAccessSnapshot(context, runtimeBaseUrl);
+  const subscriptionSnapshot = buildAgentWorkspaceSubscriptionSnapshot(context);
   const channels = buildAgentWorkspaceChannels(context);
   const channelSetupGuide = buildAgentWorkspaceChannelSetupGuide(channels);
   const voiceMediaReadiness = buildAgentWorkspaceVoiceMediaReadiness({
@@ -460,8 +225,6 @@ 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,
@@ -516,41 +279,41 @@ export function buildAgentWorkspaceRuntimeSnapshot(context: CommandContext): Age
     provider,
     model,
     modelDisplayName: currentModel?.displayName ?? model,
-    embeddingProvider,
-    reasoningEffort,
-    helperEnabled,
-    toolLlmEnabled,
-    providerFailureHints,
-    cacheEnabled,
-    cacheStableTtl,
-    cacheMonitorHitRate,
-    cacheHitRateWarningThreshold,
-    hitlMode,
-    guidanceMode,
-    saveHistory,
-    autoApprove,
-    autoCompactThreshold,
-    staleContextWarnings,
-    showThinking,
-    showReasoningSummary,
-    theme,
-    stream,
-    lineNumbers,
-    operationalMessages,
-    systemMessages,
-    releaseChannel,
-    permissionMode,
-    toolAutoHeal,
-    toolsDefaultTokenBudget,
-    artifactMaxBytes,
-    rawPromptTelemetry,
-    automationEnabled,
-    automationMaxConcurrentRuns,
-    automationRunHistoryLimit,
-    automationDefaultTimeoutMs,
-    automationCatchUpWindowMinutes,
-    automationFailureCooldownMs,
-    automationDeleteAfterRun,
+    embeddingProvider: config.embeddingProvider,
+    reasoningEffort: config.reasoningEffort,
+    helperEnabled: config.helperEnabled,
+    toolLlmEnabled: config.toolLlmEnabled,
+    providerFailureHints: config.providerFailureHints,
+    cacheEnabled: config.cacheEnabled,
+    cacheStableTtl: config.cacheStableTtl,
+    cacheMonitorHitRate: config.cacheMonitorHitRate,
+    cacheHitRateWarningThreshold: config.cacheHitRateWarningThreshold,
+    hitlMode: config.hitlMode,
+    guidanceMode: config.guidanceMode,
+    saveHistory: config.saveHistory,
+    autoApprove: config.autoApprove,
+    autoCompactThreshold: config.autoCompactThreshold,
+    staleContextWarnings: config.staleContextWarnings,
+    showThinking: config.showThinking,
+    showReasoningSummary: config.showReasoningSummary,
+    theme: config.theme,
+    stream: config.stream,
+    lineNumbers: config.lineNumbers,
+    operationalMessages: config.operationalMessages,
+    systemMessages: config.systemMessages,
+    releaseChannel: config.releaseChannel,
+    permissionMode: config.permissionMode,
+    toolAutoHeal: config.toolAutoHeal,
+    toolsDefaultTokenBudget: config.toolsDefaultTokenBudget,
+    artifactMaxBytes: config.artifactMaxBytes,
+    rawPromptTelemetry: config.rawPromptTelemetry,
+    automationEnabled: config.automationEnabled,
+    automationMaxConcurrentRuns: config.automationMaxConcurrentRuns,
+    automationRunHistoryLimit: config.automationRunHistoryLimit,
+    automationDefaultTimeoutMs: config.automationDefaultTimeoutMs,
+    automationCatchUpWindowMinutes: config.automationCatchUpWindowMinutes,
+    automationFailureCooldownMs: config.automationFailureCooldownMs,
+    automationDeleteAfterRun: config.automationDeleteAfterRun,
     sessionId: context.session?.runtime?.sessionId ?? 'unknown',
     workingDirectory: context.workspace?.shellPaths?.workingDirectory ?? 'unavailable',
     homeDirectory: context.workspace?.shellPaths?.homeDirectory ?? 'unavailable',
@@ -620,10 +383,10 @@ export function buildAgentWorkspaceRuntimeSnapshot(context: CommandContext): Age
     voiceStreamingProviderCount: voiceProviders.filter((entry) => entry.capabilities.includes('tts-stream')).length,
     voiceSttProviderCount: voiceProviders.filter((entry) => entry.capabilities.includes('stt')).length,
     voiceRealtimeProviderCount: voiceProviders.filter((entry) => entry.capabilities.includes('realtime')).length,
-    ttsProvider,
-    ttsVoice,
-    ttsResponseModel: ttsLlmProvider && ttsLlmModel ? `${ttsLlmProvider}/${ttsLlmModel}` : '(chat route)',
-    voiceSurfaceEnabled: readConfigBoolean(context, 'ui.voiceEnabled', false),
+    ttsProvider: config.ttsProvider,
+    ttsVoice: config.ttsVoice,
+    ttsResponseModel: config.ttsLlmProvider && config.ttsLlmModel ? `${config.ttsLlmProvider}/${config.ttsLlmModel}` : '(chat route)',
+    voiceSurfaceEnabled: config.voiceSurfaceEnabled,
     mediaProviderCount: mediaProviders.length,
     mediaUnderstandingProviderCount: mediaProviders.filter((entry) => entry.capabilities.includes('understand')).length,
     mediaGenerationProviderCount: mediaProviders.filter((entry) => entry.capabilities.includes('generate')).length,
@@ -632,20 +395,23 @@ export function buildAgentWorkspaceRuntimeSnapshot(context: CommandContext): Age
     mcpConnectedServerCount: mcpSnapshot.connectedCount,
     mcpQuarantinedServerCount: mcpSnapshot.quarantinedCount,
     mcpAllowAllServerCount: mcpSnapshot.allowAllCount,
-    browserToolExposureEnabled: browserPwaEnabled,
-    browserToolPublicBaseUrl: browserPwaPublicBaseUrl,
+    browserToolExposureEnabled: config.browserPwaEnabled,
+    browserToolPublicBaseUrl: config.browserPwaPublicBaseUrl,
     activeRuntimeProfile: inferActiveRuntimeProfile(context.workspace?.shellPaths?.homeDirectory ?? ''),
     selectedRuntimeProfile: selectedRuntimeProfile?.id ?? null,
     selectedRuntimeProfileExists: selectedRuntimeProfile?.exists ?? false,
     selectedRuntimeProfileSelectedAt: selectedRuntimeProfile?.selectedAt ?? null,
     runtimeProfileCount: runtimeProfiles.length,
     runtimeProfiles: runtimeProfiles.map(summarizeRuntimeProfile),
-    runtimeProfileRoot: getAgentRuntimeProfilesRoot(profileBaseHome),
+    runtimeProfileRoot,
     runtimeStarterTemplateCount: runtimeStarterTemplates.length,
     localStarterTemplateCount: runtimeStarterTemplates.filter((template) => template.source === 'local').length,
     runtimeStarterTemplates: runtimeStarterTemplates.map(summarizeStarterTemplate),
     setupChecklist,
     setupWizard,
     warnings,
+    liveCountersStale: false,
+    emailConnectStatus: buildAgentWorkspaceEmailConnectStatus(context),
+    calendarOAuthConfigStatus: buildAgentWorkspaceCalendarOAuthConfigStatus(context),
   };
 }