@pellux/goodvibes-agent 1.0.34 → 1.0.36

package/src/agent/reminder-schedule-format.ts

@@ -25,9 +25,9 @@ function scheduleValue(preview: ReminderSchedulePreview): string {
 function formatReminderScheduleFailureKind(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 === 'version_mismatch') return 'version mismatch';
   return kind.replace(/[_-]+/g, ' ');
 }
 
@@ -68,16 +68,13 @@ export function formatReminderScheduleFailure(failure: ReminderScheduleFailure):
     `  ${failure.error}`,
     failure.baseUrl ? `  connected host ${failure.baseUrl}` : null,
     `  route ${REMINDER_SCHEDULE_METHOD} ${failure.route}`,
-    failure.kind === 'version_mismatch' && failure.connectedHostVersion && failure.expectedSdkVersion
-      ? `  versions connected host ${failure.connectedHostVersion}; expected ${failure.expectedSdkVersion}`
-      : null,
     failure.kind === 'auth_required'
       ? '  next pair/authenticate with the connected GoodVibes host, then retry with --yes.'
       : null,
     failure.kind === 'connected_host_unavailable'
       ? '  next make the connected GoodVibes host available outside Agent, then retry.'
       : null,
-    failure.kind === 'version_mismatch' || failure.kind === 'connected_host_route_unavailable'
+    failure.kind === 'connected_host_incompatible' || failure.kind === 'connected_host_route_unavailable'
       ? '  next update the connected GoodVibes host so public schedules.create is available.'
       : null,
   ].filter((line): line is string => Boolean(line)).join('\n');

package/src/agent/reminder-schedule.ts

@@ -2,7 +2,6 @@ import { createBrowserGoodVibesSdk } from '@pellux/goodvibes-sdk/browser';
 import type { OperatorMethodInput, OperatorMethodOutput } from '@pellux/goodvibes-sdk/contracts';
 import { summarizeError } from '@pellux/goodvibes-sdk/platform/utils';
 import { getModelIdFromProviderModel, getProviderIdFromModel } from '../config/provider-model.ts';
-import { SDK_VERSION } from '../version.ts';
 import {
   resolveAgentConnectedHostConnection,
   ROUTINE_SCHEDULE_METHOD,
@@ -59,14 +58,12 @@ export interface ReminderScheduleFailure {
     | 'confirmation_required'
     | 'auth_required'
     | 'connected_host_unavailable'
-    | 'version_mismatch'
+    | 'connected_host_incompatible'
     | 'connected_host_route_unavailable'
     | 'connected_host_error';
   readonly error: string;
   readonly route: typeof REMINDER_SCHEDULE_ROUTE;
   readonly baseUrl?: string;
-  readonly connectedHostVersion?: string;
-  readonly expectedSdkVersion?: string;
 }
 
 export type ReminderScheduleResult = ReminderScheduleSuccess | ReminderScheduleFailure;
@@ -440,17 +437,13 @@ async function classifyReminderScheduleError(
   }
   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.create is unavailable.`,
+        kind: 'connected_host_incompatible',
+        error: 'Connected GoodVibes host compatibility does not satisfy Agent schedule requirements; schedules.create is unavailable.',
         route: REMINDER_SCHEDULE_ROUTE,
         baseUrl: connection.baseUrl,
-        connectedHostVersion,
-        expectedSdkVersion: SDK_VERSION,
       };
     }
     return { ok: false, kind: 'connected_host_route_unavailable', error: message, route: REMINDER_SCHEDULE_ROUTE, baseUrl: connection.baseUrl };

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

@@ -41,9 +41,9 @@ function formatDeliveryTarget(target: {
 function formatRoutineScheduleFailureKind(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 === 'version_mismatch') return 'version mismatch';
   return kind.replace(/[_-]+/g, ' ');
 }
 
@@ -140,7 +140,7 @@ export function formatRoutineScheduleCorrelation(result: RoutineScheduleCorrelat
       result.kind === 'connected_host_unavailable'
         ? '  next make the connected GoodVibes host available outside Agent, then retry.'
         : null,
-      result.kind === 'version_mismatch' || result.kind === 'connected_host_route_unavailable'
+      result.kind === 'connected_host_incompatible' || result.kind === 'connected_host_route_unavailable'
         ? '  next update the connected GoodVibes host so public schedules.list is available.'
         : null,
     ].filter((line): line is string => Boolean(line)).join('\n');
@@ -186,16 +186,13 @@ export function formatRoutineScheduleFailure(failure: RoutineSchedulePromotionFa
     `  ${failure.error}`,
     failure.baseUrl ? `  connected host ${failure.baseUrl}` : null,
     `  route ${ROUTINE_SCHEDULE_METHOD} ${failure.route}`,
-    failure.kind === 'version_mismatch' && failure.connectedHostVersion && failure.expectedSdkVersion
-      ? `  versions connected host ${failure.connectedHostVersion}; expected ${failure.expectedSdkVersion}`
-      : null,
     failure.kind === 'auth_required'
       ? '  next pair/authenticate with the connected GoodVibes host, then retry with --yes.'
       : null,
     failure.kind === 'connected_host_unavailable'
       ? '  next make the connected GoodVibes host available outside Agent, then retry.'
       : null,
-    failure.kind === 'version_mismatch' || failure.kind === 'connected_host_route_unavailable'
+    failure.kind === 'connected_host_incompatible' || failure.kind === 'connected_host_route_unavailable'
       ? '  next update the connected GoodVibes host so public schedules.create is available.'
       : null,
   ].filter((line): line is string => Boolean(line)).join('\n');

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

@@ -4,7 +4,6 @@ import { createBrowserGoodVibesSdk } from '@pellux/goodvibes-sdk/browser';
 import type { OperatorMethodInput, OperatorMethodOutput } from '@pellux/goodvibes-sdk/contracts';
 import { summarizeError } from '@pellux/goodvibes-sdk/platform/utils';
 import { getModelIdFromProviderModel, getProviderIdFromModel } from '../config/provider-model.ts';
-import { SDK_VERSION } from '../version.ts';
 import { formatAgentRecordReviewState } from './record-labels.ts';
 import type { AgentRoutineRecord } from './routine-registry.ts';
 
@@ -108,14 +107,12 @@ export interface RoutineSchedulePromotionFailure {
     | 'confirmation_required'
     | 'auth_required'
     | 'connected_host_unavailable'
-    | 'version_mismatch'
+    | 'connected_host_incompatible'
     | 'connected_host_route_unavailable'
     | 'connected_host_error';
   readonly error: string;
   readonly route: typeof ROUTINE_SCHEDULE_ROUTE;
   readonly baseUrl?: string;
-  readonly connectedHostVersion?: string;
-  readonly expectedSdkVersion?: string;
 }
 
 export type RoutineSchedulePromotionResult =
@@ -194,14 +191,12 @@ export interface RoutineScheduleCorrelationFailure {
   readonly kind:
     | 'auth_required'
     | 'connected_host_unavailable'
-    | 'version_mismatch'
+    | 'connected_host_incompatible'
     | 'connected_host_route_unavailable'
     | 'connected_host_error';
   readonly error: string;
   readonly route: typeof ROUTINE_SCHEDULE_ROUTE;
   readonly baseUrl?: string;
-  readonly connectedHostVersion?: string;
-  readonly expectedSdkVersion?: string;
 }
 
 export type RoutineScheduleCorrelationResult =
@@ -389,17 +384,13 @@ async function classifyScheduleError(
   }
   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.create is unavailable.`,
+        kind: 'connected_host_incompatible',
+        error: 'Connected GoodVibes host compatibility does not satisfy Agent schedule requirements; schedules.create 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/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)})`}`,