@pellux/goodvibes-agent 1.0.35 → 1.0.36

package/src/agent/routine-schedule-receipts.ts

@@ -6,7 +6,6 @@ import { formatEveryInterval } from '@pellux/goodvibes-sdk/platform/automation';
 import { summarizeError } from '@pellux/goodvibes-sdk/platform/utils';
 import type { ShellPathService } from '@/runtime/index.ts';
 import { GOODVIBES_AGENT_SURFACE_ROOT } from '../config/surface.ts';
-import { SDK_VERSION } from '../version.ts';
 import { isRoutineScheduleDeliverySurfaceKind } from './routine-schedule-args.ts';
 import {
   ROUTINE_SCHEDULE_LIST_METHOD,
@@ -83,7 +82,7 @@ function redactedDeliveryTargets(delivery: ScheduleDeliveryInput | undefined): r
 }
 
 function normalizeFailureKind(value: unknown): RoutineScheduleReceipt['failureKind'] {
-  if (value === 'confirmation_required' || value === 'auth_required' || value === 'version_mismatch') return value;
+  if (value === 'confirmation_required' || value === 'auth_required' || value === 'connected_host_incompatible') return value;
   if (value === 'connected_host_unavailable' || value === 'connected_host_route_unavailable' || value === 'connected_host_error') return value;
   if (value === 'daemon_unavailable') return 'connected_host_unavailable';
   if (value === 'daemon_route_unavailable') return 'connected_host_route_unavailable';
@@ -450,17 +449,13 @@ async function classifyScheduleListError(
   }
   if (lower.includes('404') || lower.includes('not found')) {
     const connectedHost = await fetchConnectedHostStatus(connection);
-    const record = isRecord(connectedHost.body) ? connectedHost.body : {};
-    const connectedHostVersion = readString(record, 'version') ?? 'unknown';
-    if (connectedHost.ok && connectedHostVersion !== SDK_VERSION) {
+    if (connectedHost.ok) {
       return {
         ok: false,
-        kind: 'version_mismatch',
-        error: `Connected GoodVibes host SDK version ${connectedHostVersion} does not match Agent SDK pin ${SDK_VERSION}; schedules.list is unavailable.`,
+        kind: 'connected_host_incompatible',
+        error: 'Connected GoodVibes host compatibility does not satisfy Agent schedule requirements; schedules.list is unavailable.',
         route: ROUTINE_SCHEDULE_ROUTE,
         baseUrl: connection.baseUrl,
-        connectedHostVersion,
-        expectedSdkVersion: SDK_VERSION,
       };
     }
     return { ok: false, kind: 'connected_host_route_unavailable', error: message, route: ROUTINE_SCHEDULE_ROUTE, baseUrl: connection.baseUrl };

package/src/cli/agent-knowledge-command.ts

@@ -484,23 +484,19 @@ export async function handleCompatCommand(runtime: CliCommandRuntime): Promise<C
   const connection = resolveConnectedHostConnection(runtime);
   const metadata = readPackageMetadata();
   const connectedHost = await fetchConnectedHostStatus(connection);
-  const connectedHostRecord = isRecord(connectedHost.body) ? connectedHost.body : {};
-  const connectedHostVersion = readString(connectedHostRecord, 'version') ?? 'unknown';
-  const versionCompatible = connectedHost.ok && connectedHostVersion === metadata.sdkVersion;
   const knowledgeRoute = await runKnowledgeCall(runtime, AGENT_KNOWLEDGE_METHODS.status, async (routeConnection) => (
     await createAgentSdk(routeConnection).knowledge.status()
   ));
   const knowledgeRouteReady = knowledgeRoute.ok;
+  const hostCompatible = connectedHost.ok && knowledgeRouteReady;
   const value = {
-    ok: versionCompatible && knowledgeRouteReady,
+    ok: hostCompatible && knowledgeRouteReady,
     packageVersion: metadata.version,
-    sdkPin: metadata.sdkVersion,
     connectedHost: {
       baseUrl: connection.baseUrl,
       status: connectedHost.status,
-      version: connectedHostVersion,
       reachable: connectedHost.ok,
-      compatible: versionCompatible,
+      compatible: hostCompatible,
     },
     auth: {
       tokenPresent: Boolean(connection.token),
@@ -515,12 +511,11 @@ export async function handleCompatCommand(runtime: CliCommandRuntime): Promise<C
   const text = [
     'GoodVibes Agent compatibility',
     `  package ${metadata.version}`,
-    `  SDK pin ${metadata.sdkVersion}`,
-    `  connected host ${connectedHostVersion} at ${connection.baseUrl} (${connectedHost.ok ? 'reachable' : 'unreachable'})`,
-    `  version compatible ${yesNo(versionCompatible)}`,
+    `  connected host ${connection.baseUrl} (${connectedHost.ok ? 'reachable' : 'unreachable'})`,
+    `  host compatible ${yesNo(hostCompatible)}`,
     `  operator token ${connection.token ? 'present' : 'missing'} (${connection.tokenPath})`,
     `  Agent Knowledge route ${knowledgeRouteReady ? 'ready' : `not ready (${knowledgeRoute.ok ? 'unknown' : formatAgentKnowledgeFailureKind(knowledgeRoute.kind)})`}`,
-    ...(versionCompatible ? [] : ['  next update the connected GoodVibes host so /status matches the Agent SDK pin.']),
+    ...(hostCompatible ? [] : ['  next update the connected GoodVibes host so its public Agent routes are compatible.']),
   ].join('\n');
   return {
     output: runtime.cli.flags.outputFormat === 'json' ? JSON.stringify(value, null, 2) : text,

package/src/cli/agent-knowledge-format.ts

@@ -6,8 +6,6 @@ export interface AgentKnowledgeFailureLike {
   readonly error: string;
   readonly baseUrl: string;
   readonly route: string;
-  readonly connectedHostVersion?: string;
-  readonly expectedSdkVersion?: string;
 }
 
 export function isRecord(value: unknown): value is JsonRecord {
@@ -45,10 +43,10 @@ function yesNo(value: boolean): string {
 export function formatAgentKnowledgeFailureKind(kind: string): string {
   if (kind === 'auth_required') return 'authorization required';
   if (kind === 'connected_host_unavailable') return 'connected host unavailable';
+  if (kind === 'connected_host_incompatible') return 'connected host incompatible';
   if (kind === 'connected_host_route_unavailable') return 'connected host route unavailable';
   if (kind === 'connected_host_error') return 'connected host error';
   if (kind === 'scope_contamination') return 'scope contamination';
-  if (kind === 'version_mismatch') return 'version mismatch';
   return kind.replace(/[_-]+/g, ' ');
 }
 
@@ -384,14 +382,11 @@ export function formatFailure(failure: AgentKnowledgeFailureLike, json: boolean)
     `  ${failure.error}`,
     `  connected host ${failure.baseUrl}`,
     `  route ${failure.route}`,
-    failure.kind === 'version_mismatch' && failure.connectedHostVersion && failure.expectedSdkVersion
-      ? `  versions connected host ${failure.connectedHostVersion}; expected ${failure.expectedSdkVersion}`
-      : null,
-    failure.kind === 'version_mismatch'
-      ? '  next update the connected GoodVibes host so /status matches the Agent SDK pin.'
+    failure.kind === 'connected_host_incompatible'
+      ? '  next update the connected GoodVibes host so its public Agent routes are compatible.'
       : null,
     failure.kind === 'connected_host_route_unavailable'
-      ? '  next update the connected GoodVibes host to the SDK version required by this Agent package.'
+      ? '  next update the connected GoodVibes host so Agent Knowledge routes are available.'
       : null,
     failure.kind === 'scope_contamination'
       ? '  next update the connected GoodVibes host so Agent Knowledge routes return only Agent-owned scope data.'

package/src/cli/agent-knowledge-runtime.ts

@@ -1,6 +1,6 @@
 import { createBrowserAgentSdk } from '@pellux/goodvibes-sdk/browser/agent';
 import { summarizeError } from '@pellux/goodvibes-sdk/platform/utils';
-import { SDK_VERSION, VERSION } from '../version.ts';
+import { VERSION } from '../version.ts';
 import { readConnectedHostOperatorToken } from '../runtime/connected-host-auth.ts';
 import type { ConnectedHostCallMethod } from './agent-knowledge-methods.ts';
 
@@ -24,15 +24,13 @@ export interface AgentKnowledgeFailure {
   readonly kind:
     | 'connected_host_unavailable'
     | 'auth_required'
-    | 'version_mismatch'
+    | 'connected_host_incompatible'
     | 'connected_host_route_unavailable'
     | 'connected_host_error'
     | 'scope_contamination';
   readonly error: string;
   readonly baseUrl: string;
   readonly route: string;
-  readonly connectedHostVersion?: string;
-  readonly expectedSdkVersion?: string;
 }
 
 export interface AgentKnowledgeSuccess<TData> {
@@ -53,8 +51,8 @@ export function readString(record: JsonRecord | null, key: string): string | nul
   return typeof value === 'string' ? value : null;
 }
 
-export function readPackageMetadata(): { readonly version: string; readonly sdkVersion: string } {
-  return { version: VERSION, sdkVersion: SDK_VERSION };
+export function readPackageMetadata(): { readonly version: string } {
+  return { version: VERSION };
 }
 
 export function resolveConnectedHostConnection(runtime: AgentKnowledgeConnectionRuntime): AgentKnowledgeConnection {
@@ -90,19 +88,14 @@ export async function classifyKnowledgeError(error: unknown, connection: AgentKn
     return { ok: false, kind: 'auth_required', error: message, baseUrl: connection.baseUrl, route };
   }
   if (lower.includes('404') || lower.includes('not found')) {
-    const metadata = readPackageMetadata();
     const connectedHost = await fetchConnectedHostStatus(connection);
-    const connectedHostRecord = isRecord(connectedHost.body) ? connectedHost.body : {};
-    const connectedHostVersion = readString(connectedHostRecord, 'version') ?? 'unknown';
-    if (connectedHost.ok && connectedHostVersion !== metadata.sdkVersion) {
+    if (connectedHost.ok) {
       return {
         ok: false,
-        kind: 'version_mismatch',
-        error: `Connected GoodVibes host SDK version ${connectedHostVersion} does not match Agent SDK pin ${metadata.sdkVersion}; Agent Knowledge route is unavailable.`,
+        kind: 'connected_host_incompatible',
+        error: `Connected GoodVibes host compatibility does not satisfy Agent Knowledge requirements; Agent Knowledge route is unavailable.`,
         baseUrl: connection.baseUrl,
         route,
-        connectedHostVersion,
-        expectedSdkVersion: metadata.sdkVersion,
       };
     }
     return { ok: false, kind: 'connected_host_route_unavailable', error: message, baseUrl: connection.baseUrl, route };

package/src/cli/external-runtime.ts

@@ -1,10 +1,7 @@
 import type { ConfigManager } from '@pellux/goodvibes-sdk/platform/config';
 import { summarizeError } from '@pellux/goodvibes-sdk/platform/utils';
-import { SDK_VERSION } from '../version.ts';
 import { readConnectedHostOperatorToken } from '../runtime/connected-host-auth.ts';
 
-type JsonRecord = Record<string, unknown>;
-
 export interface CliExternalRuntimeInspectionOptions {
   readonly configManager: Pick<ConfigManager, 'get'>;
   readonly homeDirectory: string;
@@ -15,8 +12,6 @@ export interface CliExternalRuntimeSnapshot {
   readonly baseUrl: string;
   readonly statusCode: number | null;
   readonly reachable: boolean;
-  readonly version: string;
-  readonly expectedVersion: string;
   readonly compatible: boolean;
   readonly operatorToken: {
     readonly present: boolean;
@@ -25,21 +20,12 @@ export interface CliExternalRuntimeSnapshot {
   readonly agentKnowledge: {
     readonly route: '/api/goodvibes-agent/knowledge/status';
     readonly ready: boolean;
-    readonly kind: 'ok' | 'auth_required' | 'connected_host_unavailable' | 'version_mismatch' | 'connected_host_route_unavailable' | 'connected_host_error';
+    readonly kind: 'ok' | 'auth_required' | 'connected_host_unavailable' | 'connected_host_incompatible' | 'connected_host_route_unavailable' | 'connected_host_error';
     readonly statusCode: number | null;
   };
   readonly error: string | null;
 }
 
-function isRecord(value: unknown): value is JsonRecord {
-  return Boolean(value) && typeof value === 'object' && !Array.isArray(value);
-}
-
-function readString(record: JsonRecord | null, key: string): string | null {
-  const value = record?.[key];
-  return typeof value === 'string' ? value : null;
-}
-
 function resolveBaseUrl(configManager: Pick<ConfigManager, 'get'>): string {
   const host = String(configManager.get('controlPlane.host') ?? '127.0.0.1');
   const port = Number(configManager.get('controlPlane.port') ?? 3421);
@@ -83,17 +69,12 @@ export async function inspectCliExternalRuntime(
 
   try {
     const status = await fetchJson(`${baseUrl}/status`, token.token, timeoutMs);
-    const statusRecord = isRecord(status.body) ? status.body : {};
-    const version = readString(statusRecord, 'version') ?? 'unknown';
-    const compatible = status.ok && version === SDK_VERSION;
 
     if (!status.ok) {
       return {
         baseUrl,
         statusCode: status.status,
         reachable: false,
-        version,
-        expectedVersion: SDK_VERSION,
         compatible: false,
         operatorToken: { present: Boolean(token.token), path: token.path },
         agentKnowledge: {
@@ -111,9 +92,7 @@ export async function inspectCliExternalRuntime(
         baseUrl,
         statusCode: status.status,
         reachable: true,
-        version,
-        expectedVersion: SDK_VERSION,
-        compatible,
+        compatible: false,
         operatorToken: { present: false, path: token.path },
         agentKnowledge: {
           route,
@@ -125,32 +104,12 @@ export async function inspectCliExternalRuntime(
       };
     }
 
-    if (!compatible) {
-      return {
-        baseUrl,
-        statusCode: status.status,
-        reachable: true,
-        version,
-        expectedVersion: SDK_VERSION,
-        compatible: false,
-        operatorToken: { present: true, path: token.path },
-        agentKnowledge: {
-          route,
-          ready: false,
-          kind: 'version_mismatch',
-          statusCode: null,
-        },
-        error: null,
-      };
-    }
-
     const knowledge = await fetchJson(`${baseUrl}${route}`, token.token, timeoutMs);
+    const compatible = knowledge.ok;
     return {
       baseUrl,
       statusCode: status.status,
       reachable: true,
-      version,
-      expectedVersion: SDK_VERSION,
       compatible,
       operatorToken: { present: true, path: token.path },
       agentKnowledge: {
@@ -172,8 +131,6 @@ export async function inspectCliExternalRuntime(
       baseUrl,
       statusCode: null,
       reachable: false,
-      version: 'unknown',
-      expectedVersion: SDK_VERSION,
       compatible: false,
       operatorToken: { present: Boolean(token.token), path: token.path },
       agentKnowledge: {

package/src/cli/help.ts

@@ -56,7 +56,7 @@ export function renderGoodVibesHelp(binary = 'goodvibes-agent'): string {
     '  memory                     Manage Agent-owned durable memory records',
     '  routines                   Inspect local routines and explicitly promote one to a connected schedule',
     '  auth                       Inspect Agent auth posture and connection token state',
-    '  compat                     Inspect Agent SDK pin, connected host version, and Agent Knowledge route readiness',
+    '  compat                     Inspect connected-host compatibility and Agent Knowledge route readiness',
     '  knowledge                  Use isolated Agent Knowledge routes',
     '  ask|search                 Shortcuts for isolated Agent Knowledge ask/search',
     '  delegate                   Explicitly delegate build/fix/review work to GoodVibes TUI',
@@ -296,7 +296,7 @@ const COMMAND_HELP: Record<string, CommandHelp> = {
   },
   compat: {
     usage: ['compat', 'compat --json'],
-    summary: 'Inspect package SDK pin, live runtime version, and Agent-specific knowledge route readiness.',
+    summary: 'Inspect connected-host compatibility and Agent-specific knowledge route readiness.',
     examples: ['compat', 'compat --json'],
   },
   knowledge: {

package/src/cli/status.ts

@@ -114,13 +114,13 @@ export function buildCliDoctorFindings(options: CliStatusOptions): readonly CliD
       });
     } else if (!options.externalRuntime.compatible) {
       findings.push({
-        id: 'external-runtime-version-mismatch',
+        id: 'external-runtime-incompatible',
         area: 'runtime',
         severity: 'warning',
-        summary: 'Connected GoodVibes host SDK version does not match Agent.',
-        cause: `Connected host reports SDK ${options.externalRuntime.version}; Agent expects ${options.externalRuntime.expectedVersion}.`,
-        impact: 'Agent-only routes, especially isolated Agent Knowledge, may be missing or incompatible.',
-        action: 'Update the owning GoodVibes host so /status matches this Agent package SDK pin.',
+        summary: 'Connected GoodVibes host compatibility does not satisfy Agent readiness.',
+        cause: 'Connected host is reachable, but at least one public Agent route is unavailable or incompatible.',
+        impact: 'Agent-only routes, especially isolated Agent Knowledge, may be unavailable.',
+        action: 'Update the owning GoodVibes host so its public Agent routes are compatible.',
       });
     }
 
@@ -144,7 +144,7 @@ export function buildCliDoctorFindings(options: CliStatusOptions): readonly CliD
         summary: 'Isolated Agent Knowledge route is not ready.',
         cause: `${options.externalRuntime.agentKnowledge.route} returned ${options.externalRuntime.agentKnowledge.kind}${options.externalRuntime.agentKnowledge.statusCode === null ? '' : ` (${options.externalRuntime.agentKnowledge.statusCode})`}.`,
         impact: 'Agent Knowledge ask/search will not use default or non-Agent knowledge fallback; it will fail closed until the Agent route is available.',
-        action: 'Update the connected GoodVibes host to the Agent-compatible SDK and verify goodvibes-agent compat.',
+        action: 'Update the connected GoodVibes host so public Agent routes are compatible, then verify goodvibes-agent compat.',
       });
     }
   }
@@ -283,7 +283,6 @@ export function renderCliStatus(options: CliStatusOptions): string {
     ...(externalRuntime ? [
       `  baseUrl: ${externalRuntime.baseUrl}`,
       `  reachable: ${yesNo(externalRuntime.reachable)}${externalRuntime.statusCode === null ? '' : ` (HTTP ${externalRuntime.statusCode})`}`,
-      `  sdk: ${externalRuntime.version} expected ${externalRuntime.expectedVersion}`,
       `  compatible: ${yesNo(externalRuntime.compatible)}`,
       `  access token: ${externalRuntime.operatorToken.present ? 'present' : 'missing'} (${externalRuntime.operatorToken.path})`,
       `  Agent Knowledge: ${externalRuntime.agentKnowledge.ready ? 'ready' : `not ready (${formatAgentKnowledgeFailureKind(externalRuntime.agentKnowledge.kind)})`}`,

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

@@ -3,10 +3,10 @@ import type { AgentWorkspaceCategory } from './agent-workspace-types.ts';
 export const AGENT_WORKSPACE_CATEGORIES: readonly AgentWorkspaceCategory[] = [
   {
     id: 'home',
-    group: 'OPERATE',
+    group: 'HOME',
     label: 'Home',
     summary: 'Main operator workspace for normal assistant work.',
-    detail: 'Use this as the Agent front door: chat in the main conversation, inspect state, choose model/provider, and open setup without switching modes.',
+    detail: 'Use this as the primary Agent workspace: chat in the main conversation, inspect state, choose model/provider, and open setup without switching modes.',
     actions: [
       { id: 'chat', label: 'Continue assistant chat', detail: 'Return to the main composer and type a normal message. Agent work stays serial in the main conversation.', kind: 'guidance', safety: 'safe' },
       { id: 'brief', label: 'Operator briefing', detail: 'Show a concise Agent status and next-actions briefing without mutating the connected host.', command: '/brief', kind: 'command', safety: 'read-only' },
@@ -29,13 +29,13 @@ export const AGENT_WORKSPACE_CATEGORIES: readonly AgentWorkspaceCategory[] = [
       { id: 'welcome', label: 'Welcome and setup guide', detail: 'Open the Agent setup guide from the workspace.', command: '/welcome', kind: 'command', safety: 'safe' },
       { id: 'health', label: 'Review health', detail: 'Show local health and connected-host status without starting or mutating anything.', command: '/health review', kind: 'command', safety: 'read-only' },
       { id: 'doctor', label: 'Doctor diagnostics', detail: 'Run the same Agent doctor diagnostics from the TUI home workspace instead of relying on the CLI.', command: '/doctor', kind: 'command', safety: 'read-only' },
-      { id: 'compat', label: 'Host compatibility', detail: 'Inspect Agent SDK pin, connected-host version, and isolated Agent Knowledge route readiness from the TUI.', command: '/compat', kind: 'command', safety: 'read-only' },
+      { id: 'compat', label: 'Host compatibility', detail: 'Inspect connected-host compatibility and isolated Agent Knowledge route readiness from the TUI.', command: '/compat', kind: 'command', safety: 'read-only' },
       { id: 'quit', label: 'Quit Agent', detail: 'Exit the TUI and restore terminal state.', command: '/quit', kind: 'command', safety: 'safe' },
     ],
   },
   {
     id: 'setup',
-    group: 'SETUP',
+    group: 'CONFIGURE',
     label: 'Setup',
     summary: 'Configuration, auth, provider, and onboarding workspaces.',
     detail: 'Use this to configure the assistant: provider/model, setup checklist, Agent Knowledge, local behavior, channels, and voice/media. Changes here stay Agent-owned.',
@@ -53,7 +53,7 @@ export const AGENT_WORKSPACE_CATEGORIES: readonly AgentWorkspaceCategory[] = [
       { id: 'setup-mode-show', label: 'Interaction mode', detail: 'Review current Agent interaction mode and domain verbosity.', command: '/mode show', kind: 'command', safety: 'read-only' },
       { id: 'setup-mode-preset', label: 'Set interaction mode', detail: 'Open a confirmed form for quiet, balanced, or operator interaction mode.', editorKind: 'mode-preset', kind: 'editor', safety: 'safe' },
       { id: 'setup-mode-domain', label: 'Set domain verbosity', detail: 'Open a confirmed form for one interaction-domain verbosity override.', editorKind: 'mode-domain', kind: 'editor', safety: 'safe' },
-      { id: 'setup-compat', label: 'Compatibility', detail: 'Inspect Agent SDK pin, connected host version, and isolated Agent Knowledge route readiness.', command: '/compat', kind: 'command', safety: 'read-only' },
+      { id: 'setup-compat', label: 'Compatibility', detail: 'Inspect connected-host compatibility and isolated Agent Knowledge route readiness.', command: '/compat', kind: 'command', safety: 'read-only' },
       { id: 'setup-agent-knowledge', label: 'Agent Knowledge', detail: 'Open isolated Agent Knowledge status, ask/search, ingest, source review, and reindex actions.', targetCategoryId: 'knowledge', kind: 'workspace', safety: 'safe' },
       { id: 'setup-runtime-profiles', label: 'Agent profiles', detail: 'Open starter templates, isolated Agent homes, profile defaults, and profile import/export actions.', targetCategoryId: 'profiles', kind: 'workspace', safety: 'safe' },
       { id: 'setup-profile-from-discovered', label: 'Profile from discovered behavior', detail: 'Create an isolated Agent profile directly from reviewed local persona, skill, and routine files.', editorKind: 'profile-from-discovered', kind: 'editor', safety: 'safe' },
@@ -94,7 +94,7 @@ export const AGENT_WORKSPACE_CATEGORIES: readonly AgentWorkspaceCategory[] = [
   },
   {
     id: 'research',
-    group: 'OPERATE',
+    group: 'RESEARCH',
     label: 'Research',
     summary: 'Read-only web research and source triage in the main conversation.',
     detail: 'Use this workspace to ask Agent to search, inspect URLs, compare sources, and decide what belongs in isolated Agent Knowledge. Research requests run in the normal conversation; source ingestion is explicit.',
@@ -113,7 +113,7 @@ export const AGENT_WORKSPACE_CATEGORIES: readonly AgentWorkspaceCategory[] = [
   },
   {
     id: 'artifacts',
-    group: 'OPERATE',
+    group: 'ARTIFACTS',
     label: 'Artifacts',
     summary: 'Files, attachments, exports, source ingest, and generated media.',
     detail: 'Use this workspace to handle concrete user-visible artifacts: attach images, export conversations, ingest source files into Agent Knowledge, inspect source libraries, and generate media with explicit confirmation.',
@@ -136,7 +136,7 @@ export const AGENT_WORKSPACE_CATEGORIES: readonly AgentWorkspaceCategory[] = [
   },
   {
     id: 'conversation',
-    group: 'OPERATE',
+    group: 'CONVERSATION',
     label: 'Conversation',
     summary: 'Transcript, prompt, context, and session controls.',
     detail: 'Use this workspace for the main TUI conversation: context review, compaction, prompt helpers, transcript navigation, session continuity, title, export, undo, redo, and retry.',
@@ -181,7 +181,7 @@ export const AGENT_WORKSPACE_CATEGORIES: readonly AgentWorkspaceCategory[] = [
   },
   {
     id: 'channels',
-    group: 'SETUP',
+    group: 'CHANNELS',
     label: 'Channels',
     summary: 'Companion pairing, channel posture, and delivery safety.',
     detail: 'Agent uses connected channel accounts. Pairing, account inspection, and readiness checks are visible here; inbound delivery and public channel exposure stay policy-gated.',
@@ -209,7 +209,7 @@ export const AGENT_WORKSPACE_CATEGORIES: readonly AgentWorkspaceCategory[] = [
   },
   {
     id: 'tools',
-    group: 'SETUP',
+    group: 'TOOLS',
     label: 'Tools & MCP',
     summary: 'MCP server setup, trust review, and tool inventory.',
     detail: 'Configure and inspect task tools from the Agent TUI. Adding or changing tools requires typed confirmation; normal chat still chooses tools serially in the main conversation.',
@@ -240,7 +240,7 @@ export const AGENT_WORKSPACE_CATEGORIES: readonly AgentWorkspaceCategory[] = [
   },
   {
     id: 'knowledge',
-    group: 'KNOW',
+    group: 'KNOWLEDGE',
     label: 'Knowledge',
     summary: 'Agent Knowledge and source-backed lookup.',
     detail: 'Agent knowledge calls use the isolated Agent Knowledge route family only. Default knowledge and non-Agent knowledge segments are not the Agent knowledge environment.',
@@ -276,7 +276,7 @@ export const AGENT_WORKSPACE_CATEGORIES: readonly AgentWorkspaceCategory[] = [
   },
   {
     id: 'voice-media',
-    group: 'SETUP',
+    group: 'VOICE & MEDIA',
     label: 'Voice & Media',
     summary: 'Voice, TTS, image input, browser tools, and media providers.',
     detail: 'Voice, media, browser tools, and image-capable flows are first-class Agent tools. Connected-host administration stays outside Agent and side effects stay explicit.',
@@ -302,7 +302,7 @@ export const AGENT_WORKSPACE_CATEGORIES: readonly AgentWorkspaceCategory[] = [
   },
   {
     id: 'profiles',
-    group: 'SETUP',
+    group: 'PROFILES',
     label: 'Profiles',
     summary: 'Isolated Agent homes, starter templates, and setup bundles.',
     detail: 'Agent profiles isolate Agent state. Named homes and starter templates let one install behave like separate assistants for household, research, travel, operations, or personal workflows.',
@@ -325,7 +325,7 @@ export const AGENT_WORKSPACE_CATEGORIES: readonly AgentWorkspaceCategory[] = [
   },
   {
     id: 'memory',
-    group: 'LEARN',
+    group: 'MEMORY',
     label: 'Memory & Skills',
     summary: 'Local assistant memory, notes, routines, skills, and reusable behavior.',
     detail: 'Memory, notes, routines, skills, and personas stay Agent-local until stable shared registry contracts exist. Secrets must not be stored as memory or notes.',
@@ -362,7 +362,7 @@ export const AGENT_WORKSPACE_CATEGORIES: readonly AgentWorkspaceCategory[] = [
   },
   {
     id: 'notes',
-    group: 'LEARN',
+    group: 'NOTES',
     label: 'Notes',
     summary: 'Agent-local scratchpad for source triage and temporary context.',
     detail: 'Notes are local working context. They are useful for research notes, decisions in progress, and handoff notes, but they are not memory and are not Agent Knowledge.',
@@ -385,7 +385,7 @@ export const AGENT_WORKSPACE_CATEGORIES: readonly AgentWorkspaceCategory[] = [
   },
   {
     id: 'personas',
-    group: 'LEARN',
+    group: 'PERSONAS',
     label: 'Personas',
     summary: 'Local behavior profiles for the main assistant.',
     detail: 'Personas shape the serial Agent in the main conversation. They are local behavior profiles, not separate Agent identities.',
@@ -408,7 +408,7 @@ export const AGENT_WORKSPACE_CATEGORIES: readonly AgentWorkspaceCategory[] = [
   },
   {
     id: 'skills',
-    group: 'LEARN',
+    group: 'SKILLS',
     label: 'Skills',
     summary: 'Reusable local procedures with setup readiness.',
     detail: 'Skills are local, reviewable procedures with optional env/command requirements. Enabled skills inform the main conversation; secret-looking content is rejected.',
@@ -443,7 +443,7 @@ export const AGENT_WORKSPACE_CATEGORIES: readonly AgentWorkspaceCategory[] = [
   },
   {
     id: 'routines',
-    group: 'LEARN',
+    group: 'ROUTINES',
     label: 'Routines',
     summary: 'Repeatable workflows with setup readiness.',
     detail: 'Routines run in the main conversation by default and can declare env/command requirements. Promotion to a connected schedule requires a real schedule command and --yes.',
@@ -473,7 +473,7 @@ export const AGENT_WORKSPACE_CATEGORIES: readonly AgentWorkspaceCategory[] = [
   },
   {
     id: 'work',
-    group: 'TRACK',
+    group: 'WORK',
     label: 'Work & Approvals',
     summary: 'Visible task state, work plan, and approval posture.',
     detail: 'Use this workspace to inspect active operator state and update visible work-plan items from confirmed TUI forms.',
@@ -527,9 +527,9 @@ export const AGENT_WORKSPACE_CATEGORIES: readonly AgentWorkspaceCategory[] = [
   },
   {
     id: 'host',
-    group: 'WATCH',
+    group: 'HOST',
     label: 'Connected Host',
-    summary: 'Connected-host health, tasks, sessions, channels, automation, and control-plane posture.',
+    summary: 'Connected-host health, tasks, sessions, channels, and automation.',
     detail: 'Use this workspace to inspect the GoodVibes host surfaces that Agent can see: system health, remote routes, host tasks, sessions, channels, schedules, knowledge, media, MCP, provider auth, support bundles, and telemetry/config posture.',
     actions: [
       { id: 'host-overview', label: 'Host overview', detail: 'Review connected-host, provider, settings, continuity, and Agent health without starting or mutating host work.', command: '/health review', kind: 'command', safety: 'read-only' },
@@ -571,7 +571,7 @@ export const AGENT_WORKSPACE_CATEGORIES: readonly AgentWorkspaceCategory[] = [
   },
   {
     id: 'automation',
-    group: 'WATCH',
+    group: 'AUTOMATION',
     label: 'Automation',
     summary: 'Reminders, schedule observability, and explicit routine promotion.',
     detail: 'Agent does not create hidden local automation jobs. Confirmed reminders, reviewed routine promotion, and explicit run/pause/resume controls go through the connected host with confirmation.',
@@ -598,7 +598,7 @@ export const AGENT_WORKSPACE_CATEGORIES: readonly AgentWorkspaceCategory[] = [
   },
   {
     id: 'delegate',
-    group: 'BUILD',
+    group: 'DELEGATE',
     label: 'Build Delegation',
     summary: 'Explicit handoff to GoodVibes TUI for code work.',
     detail: 'Agent does not become the coding TUI. Build, implement, fix, patch, and review work must be handed to GoodVibes TUI with the full original ask and delegated review only when explicitly requested.',

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

@@ -88,7 +88,7 @@ const AGENT_WORKSPACE_CHANNEL_SPECS: readonly AgentWorkspaceChannelSpec[] = [
     requiredKeys: ['surfaces.signal.bridgeUrl', 'surfaces.signal.account'],
     defaultTargetKeys: ['surfaces.signal.defaultRecipient'],
     risk: 'bridge',
-    riskLabel: 'private bridge delivery',
+    riskLabel: 'private routed delivery',
   },
   {
     id: 'whatsapp',
@@ -119,7 +119,7 @@ const AGENT_WORKSPACE_CHANNEL_SPECS: readonly AgentWorkspaceChannelSpec[] = [
     requiredKeys: ['surfaces.imessage.bridgeUrl', 'surfaces.imessage.account'],
     defaultTargetKeys: ['surfaces.imessage.defaultChatId'],
     risk: 'bridge',
-    riskLabel: 'Apple bridge delivery',
+    riskLabel: 'Apple routed delivery',
   },
   {
     id: 'bluebubbles',
@@ -128,7 +128,7 @@ const AGENT_WORKSPACE_CHANNEL_SPECS: readonly AgentWorkspaceChannelSpec[] = [
     requiredKeys: ['surfaces.bluebubbles.serverUrl', 'surfaces.bluebubbles.password'],
     defaultTargetKeys: ['surfaces.bluebubbles.defaultChatGuid'],
     risk: 'bridge',
-    riskLabel: 'iMessage bridge delivery',
+    riskLabel: 'iMessage routed delivery',
   },
   {
     id: 'msteams',

package/src/input/agent-workspace-operations-command-editors.ts

@@ -149,7 +149,7 @@ export function createAgentWorkspaceOperationsCommandEditor(kind: AgentWorkspace
       mode: 'update',
       title: 'Override Planning Strategy',
       selectedFieldIndex: 0,
-      message: 'Override the planner strategy through the runtime bridge. This changes planner state and requires typed confirmation.',
+      message: 'Override the planner strategy through the runtime route. This changes planner state and requires typed confirmation.',
       fields: [
         { id: 'strategy', label: 'Strategy', value: 'serial', required: true, multiline: false, hint: 'Planner strategy, such as serial.' },
         { id: 'confirm', label: 'Confirm', value: '', required: true, multiline: false, hint: 'Type yes to run /plan override with --yes.' },

package/src/input/command-registry.ts

@@ -153,7 +153,7 @@ export interface CommandProviderServices {
 }
 
 /**
- * Compose locally-owned command helpers with the narrower shell bridge-owned
+ * Compose locally-owned command helpers with the narrower runtime-owned
  * runtime surfaces exported from runtime/shell-command-services.ts.
  */
 export interface CommandWorkspaceUiServices {

package/src/input/commands/compat-runtime.ts

@@ -8,7 +8,7 @@ export function registerCompatRuntimeCommands(registry: CommandRegistry): void {
   registry.register({
     name: 'compat',
     aliases: ['compatibility'],
-    description: 'Inspect Agent SDK pin, connected host version, and Agent Knowledge route readiness',
+    description: 'Inspect connected-host compatibility and Agent Knowledge route readiness',
     usage: '[--json]',
     argsHint: '[--json]',
     async handler(args, ctx) {

package/src/input/commands/planning-runtime.ts

@@ -67,7 +67,7 @@ export function registerPlanningRuntimeCommands(registry: CommandRegistry): void
         }
         const result = ctx.ops.planRuntime
           ? ctx.ops.planRuntime(parsed.rest[0] ?? args[0], parsed.rest.slice(1))
-          : { ok: false, output: 'Plan runtime bridge is not available in this runtime.' };
+          : { ok: false, output: 'Plan runtime route is not available in this runtime.' };
         ctx.print(result.output);
         return;
       }

package/src/input/commands/runtime-services.ts

@@ -31,7 +31,7 @@ import type {
 
 function requireContextValue<T>(value: T | null | undefined, name: string): T {
   if (value == null) {
-    throw new Error(`commandContext.${name} is unavailable in this Agent runtime`);
+    throw new Error(`Required Agent runtime service "${name}" is unavailable in this runtime`);
   }
   return value;
 }

package/src/input/mcp-workspace.ts

@@ -266,7 +266,7 @@ export class McpWorkspace {
       { type: 'action', id: 'add', label: 'Add or update server', detail: `Open a confirmed Agent workspace form to save an MCP server in ${this.form.scope} scope.` },
       { type: 'action', id: 'reload', label: 'Reload runtime', detail: 'Confirm an MCP runtime reload from this workspace after external config edits.' },
       { type: 'action', id: 'refresh-tools', label: 'Refresh tools', detail: 'Fetch the currently available MCP tool list from connected servers.' },
-      { type: 'action', id: 'config', label: 'Config locations', detail: 'Show SDK-scanned config files and writable project/global paths.' },
+      { type: 'action', id: 'config', label: 'Config locations', detail: 'Show detected config files and writable project/global paths.' },
     ];
   }
 

package/src/input/submission-router.ts

@@ -43,7 +43,7 @@ export function routeSubmissionIntent(input: SubmissionRouterInput): SubmissionI
       return { kind: 'plan', label: 'plan', commandName, hasAttachments };
     }
     if (DELEGATION_COMMANDS.has(commandName)) {
-      return { kind: 'delegation', label: 'TUI delegation', commandName, hasAttachments };
+      return { kind: 'delegation', label: 'delegation', commandName, hasAttachments };
     }
     if (PANEL_COMMANDS.has(commandName)) {
       return { kind: 'slash-command', label: 'Agent workspace', commandName, hasAttachments };