@pellux/goodvibes-agent 1.0.4 → 1.0.6

package/dist/package/main.js

@@ -389257,23 +389257,6 @@ function createSchema2(db) {
   `);
   db.run(`CREATE INDEX IF NOT EXISTS idx_knowledge_schedules_job_id ON knowledge_schedules(job_id)`);
 }
-function getKnowledgeSchemaStatements() {
-  const statements = [];
-  createSchema2({
-    run(sql) {
-      const normalized = sql.trim();
-      if (normalized.length > 0)
-        statements.push(normalized);
-    }
-  });
-  return statements;
-}
-function renderKnowledgeSchemaSql() {
-  return `${getKnowledgeSchemaStatements().map((statement) => statement.endsWith(";") ? statement : `${statement};`).join(`
-
-`)}
-`;
-}
 function rowObject(columns, values2) {
   return Object.fromEntries(columns.map((column, index) => [column, values2[index]]));
 }
@@ -702611,9 +702594,6 @@ var init_ingest = __esm(() => {
 // node_modules/@pellux/goodvibes-sdk/dist/platform/knowledge/browser-history/index.js
 var init_browser_history = __esm(() => {
   init_ingest();
-  init_discover();
-  init_readers();
-  init_paths2();
 });
 
 // node_modules/graphql/jsutils/devAssert.mjs
@@ -720253,7 +720233,6 @@ var init_semantic = __esm(() => {
   init_llm();
   init_gap_repair();
   init_service4();
-  init_self_improvement();
 });
 
 // node_modules/@pellux/goodvibes-sdk/dist/platform/knowledge/home-graph/helpers.js
@@ -724222,40 +724201,8 @@ var init_map_view = __esm(() => {
 });
 
 // node_modules/@pellux/goodvibes-sdk/dist/platform/knowledge/home-graph/types.js
-var HOME_GRAPH_NODE_KINDS, HOME_GRAPH_RELATIONS, HOME_GRAPH_CAPABILITIES;
+var HOME_GRAPH_CAPABILITIES;
 var init_types6 = __esm(() => {
-  HOME_GRAPH_NODE_KINDS = [
-    "ha_home",
-    "ha_entity",
-    "ha_device",
-    "ha_area",
-    "ha_automation",
-    "ha_script",
-    "ha_scene",
-    "ha_label",
-    "ha_integration",
-    "ha_room",
-    "ha_device_passport",
-    "ha_maintenance_item",
-    "ha_troubleshooting_case",
-    "ha_purchase",
-    "ha_network_node"
-  ];
-  HOME_GRAPH_RELATIONS = [
-    "controls",
-    "located_in",
-    "belongs_to_device",
-    "has_manual",
-    "has_receipt",
-    "has_warranty",
-    "has_issue",
-    "fixed_by",
-    "uses_battery",
-    "connected_via",
-    "part_of_network",
-    "mentioned_by",
-    "source_for"
-  ];
   HOME_GRAPH_CAPABILITIES = [
     "knowledge-space-isolation",
     "snapshot-sync",
@@ -725662,7 +725609,6 @@ var init_service5 = __esm(() => {
 var init_home_graph = __esm(() => {
   init_service5();
   init_extension();
-  init_types6();
 });
 
 // node_modules/@pellux/goodvibes-sdk/dist/platform/knowledge/store-refinement.js
@@ -727990,14 +727936,10 @@ var init_service6 = __esm(() => {
 var init_project_planning = __esm(() => {
   init_service6();
   init_helpers3();
-  init_readiness();
 });
 
 // node_modules/@pellux/goodvibes-sdk/dist/platform/knowledge/persistence.js
-var init_persistence = __esm(() => {
-  init_store_schema();
-  init_store_load();
-});
+var init_persistence = () => {};
 
 // node_modules/@pellux/goodvibes-sdk/dist/platform/knowledge/projections.js
 class KnowledgeProjectionService {
@@ -731505,21 +731447,21 @@ var init_service7 = __esm(() => {
 var exports_knowledge = {};
 __export(exports_knowledge, {
   withKnowledgeSpace: () => withKnowledgeSpace,
-  uniqKnowledgeValues: () => uniq2,
-  stabilizeKnowledgeText: () => stableText,
-  runKnowledgeSemanticSelfImprovement: () => runKnowledgeSemanticSelfImprovement,
+  uniqKnowledgeValues: () => uniq3,
+  stabilizeKnowledgeText: () => stableText2,
+  runKnowledgeSemanticSelfImprovement: () => runKnowledgeSemanticSelfImprovement2,
   resolveProjectPlanningSpace: () => resolveProjectPlanningSpace,
-  resolveKnowledgeDbPathFromControlPlaneDir: () => resolveKnowledgeDbPathFromControlPlaneDir,
+  resolveKnowledgeDbPathFromControlPlaneDir: () => resolveKnowledgeDbPathFromControlPlaneDir2,
   renderPacket: () => renderPacket,
   renderKnowledgeSchemaSql: () => renderKnowledgeSchemaSql,
   renderKnowledgeMap: () => renderKnowledgeMap,
   readKnowledgeSearchText: () => readKnowledgeSearchText,
-  readBrowserKnowledgeProfile: () => readBrowserKnowledgeProfile,
+  readBrowserKnowledgeProfile: () => readBrowserKnowledgeProfile2,
   projectPlanningSourceId: () => projectPlanningSourceId,
   projectPlanningProjectIdFromPath: () => projectPlanningProjectIdFromPath,
   projectPlanningCanonicalUri: () => projectPlanningCanonicalUri,
   projectKnowledgeSpaceId: () => projectKnowledgeSpaceId,
-  parseKnowledgeJsonValue: () => parseJsonValue,
+  parseKnowledgeJsonValue: () => parseJsonValue2,
   normalizeProjectId: () => normalizeProjectId,
   normalizeKnowledgeSpaceId: () => normalizeKnowledgeSpaceId,
   normalizeHomeAssistantInstallationId: () => normalizeHomeAssistantInstallationId,
@@ -731527,12 +731469,12 @@ __export(exports_knowledge, {
   materializeGeneratedKnowledgeProjection: () => materializeGeneratedKnowledgeProjection,
   looksLikeRawPdfPayload: () => looksLikeRawPdfPayload,
   looksBinaryLikeText: () => looksBinaryLikeText,
-  loadKnowledgeStoreSnapshot: () => loadKnowledgeStoreSnapshot,
+  loadKnowledgeStoreSnapshot: () => loadKnowledgeStoreSnapshot2,
   listGeneratedKnowledgePages: () => listGeneratedKnowledgePages,
-  listBrowserKinds: () => listBrowserKinds,
+  listBrowserKinds: () => listBrowserKinds2,
   knowledgeSpaceMetadata: () => knowledgeSpaceMetadata,
   knowledgePageSourceWeight: () => knowledgePageSourceWeight,
-  knowledgeNowMs: () => nowMs,
+  knowledgeNowMs: () => nowMs2,
   knowledgeExtractionNeedsRefresh: () => knowledgeExtractionNeedsRefresh,
   isUsefulKnowledgePageSourceCandidate: () => isUsefulKnowledgePageSourceCandidate,
   isUsefulKnowledgePageSource: () => isUsefulKnowledgePageSource,
@@ -731552,12 +731494,12 @@ __export(exports_knowledge, {
   generatedKnowledgeSourceId: () => generatedKnowledgeSourceId,
   generatedKnowledgeCanonicalUri: () => generatedKnowledgeCanonicalUri,
   extractKnowledgeArtifact: () => extractKnowledgeArtifact,
-  evaluateProjectPlanningReadiness: () => evaluateProjectPlanningReadiness,
-  discoverBrowserKnowledgeProfiles: () => discoverBrowserKnowledgeProfiles,
+  evaluateProjectPlanningReadiness: () => evaluateProjectPlanningReadiness2,
+  discoverBrowserKnowledgeProfiles: () => discoverBrowserKnowledgeProfiles2,
   createWebKnowledgeGapRepairer: () => createWebKnowledgeGapRepairer,
   createProviderBackedKnowledgeSemanticLlm: () => createProviderBackedKnowledgeSemanticLlm,
   createMemoryApi: () => createMemoryApi,
-  createKnowledgeSchema: () => createSchema2,
+  createKnowledgeSchema: () => createSchema3,
   createKnowledgeApi: () => createKnowledgeApi,
   createDefaultKnowledgeConnectorRegistry: () => createDefaultKnowledgeConnectorRegistry,
   compareKnowledgePageSources: () => compareKnowledgePageSources,
@@ -733995,7 +733937,7 @@ var init_delivery_manager = __esm(() => {
 });
 
 // node_modules/@pellux/goodvibes-sdk/dist/platform/automation/scheduler-capacity.js
-function computeSchedulerCapacity(slotsTotal, runs, nowMs2 = Date.now()) {
+function computeSchedulerCapacity(slotsTotal, runs, nowMs3 = Date.now()) {
   let slotsInUse = 0;
   const queuedRuns = [];
   for (const run7 of runs) {
@@ -734005,7 +733947,7 @@ function computeSchedulerCapacity(slotsTotal, runs, nowMs2 = Date.now()) {
       queuedRuns.push(run7);
   }
   const queueDepth = queuedRuns.length;
-  const oldestQueuedAgeMs = queueDepth > 0 ? nowMs2 - Math.min(...queuedRuns.map((r5) => r5.queuedAt)) : null;
+  const oldestQueuedAgeMs = queueDepth > 0 ? nowMs3 - Math.min(...queuedRuns.map((r5) => r5.queuedAt)) : null;
   return { slotsTotal, slotsInUse, queueDepth, oldestQueuedAgeMs };
 }
 
@@ -816566,7 +816508,7 @@ var createStyledCell = (char, overrides = {}) => ({
 // src/version.ts
 import { readFileSync } from "fs";
 import { join } from "path";
-var _version = "1.0.4";
+var _version = "1.0.6";
 var _sdkVersion = "0.33.35";
 try {
   const pkg = JSON.parse(readFileSync(join(import.meta.dir, "..", "package.json"), "utf-8"));
@@ -821197,7 +821139,7 @@ var INBOUND_EVENT_SURFACE_KINDS = new Set([
 ]);
 // src/runtime/onboarding/apply.ts
 init_config8();
-import { existsSync as existsSync85, readFileSync as readFileSync91, rmSync as rmSync10 } from "fs";
+import { existsSync as existsSync86, readFileSync as readFileSync92, rmSync as rmSync10 } from "fs";
 
 // src/agent/runtime-profile.ts
 import { existsSync as existsSync43, mkdirSync as mkdirSync32, readFileSync as readFileSync48, readdirSync as readdirSync15, rmSync as rmSync5, statSync as statSync13, writeFileSync as writeFileSync29 } from "fs";
@@ -839428,7 +839370,7 @@ var WORK_PLAN_STATUSES = [
   "failed",
   "cancelled"
 ];
-function nowMs2() {
+function nowMs3() {
   return Date.now();
 }
 function isObject5(value) {
@@ -839534,7 +839476,7 @@ class WorkPlanStore {
     if (!normalizedTitle)
       throw new Error("Work plan item title is required.");
     const plan = this.readPlan();
-    const time4 = nowMs2();
+    const time4 = nowMs3();
     const item = {
       id: createItemId(),
       title: normalizedTitle,
@@ -839558,7 +839500,7 @@ class WorkPlanStore {
   updateItem(idOrPrefix, patch2) {
     const plan = this.readPlan();
     const item = this.resolveItem(plan, idOrPrefix);
-    const time4 = nowMs2();
+    const time4 = nowMs3();
     const nextStatus = patch2.status ?? item.status;
     const next = this.pruneItem({
       ...item,
@@ -839591,7 +839533,7 @@ class WorkPlanStore {
   removeItem(idOrPrefix) {
     const plan = this.readPlan();
     const item = this.resolveItem(plan, idOrPrefix);
-    const time4 = nowMs2();
+    const time4 = nowMs3();
     const remaining = plan.items.filter((candidate) => candidate.id !== item.id);
     this.writePlan({
       ...plan,
@@ -839611,7 +839553,7 @@ class WorkPlanStore {
       ...plan,
       items: remaining,
       activeItemId: remaining[0]?.id,
-      updatedAt: nowMs2()
+      updatedAt: nowMs3()
     });
     return removed;
   }
@@ -839650,7 +839592,7 @@ class WorkPlanStore {
     const parsed = JSON.parse(raw);
     if (!isObject5(parsed))
       return this.createEmptyPlan();
-    const time4 = nowMs2();
+    const time4 = nowMs3();
     const createdAt = typeof parsed.createdAt === "number" ? parsed.createdAt : time4;
     const updatedAt = typeof parsed.updatedAt === "number" ? parsed.updatedAt : createdAt;
     const items = Array.isArray(parsed.items) ? parsed.items.map((item) => normalizeItem(item, createdAt)).filter((item) => item !== null) : [];
@@ -839669,7 +839611,7 @@ class WorkPlanStore {
     };
   }
   createEmptyPlan() {
-    const time4 = nowMs2();
+    const time4 = nowMs3();
     return {
       id: createPlanId(this.options.projectId, this.options.projectRoot),
       projectId: this.options.projectId,
@@ -847775,13 +847717,13 @@ init_state3();
 
 // src/input/commands/recall-shared.ts
 var VALID_CLASSES = ["decision", "constraint", "incident", "pattern", "fact", "risk", "runbook", "architecture", "ownership"];
-var VALID_SCOPES = ["session", "project", "team"];
+var VALID_SCOPES2 = ["session", "project", "team"];
 var VALID_REVIEW_STATES = ["fresh", "reviewed", "stale", "contradicted"];
 function isValidClass(s4) {
   return VALID_CLASSES.includes(s4);
 }
 function isValidScope(s4) {
-  return VALID_SCOPES.includes(s4);
+  return VALID_SCOPES2.includes(s4);
 }
 function isValidReviewState(s4) {
   return VALID_REVIEW_STATES.includes(s4);
@@ -847824,7 +847766,7 @@ function handleRecallSearch(args2, context) {
     if (isValidScope(scope))
       filter.scope = scope;
     else {
-      context.print(`[memory] Unknown scope "${scope}". Valid values ${VALID_SCOPES.join(", ")}.`);
+      context.print(`[memory] Unknown scope "${scope}". Valid values ${VALID_SCOPES2.join(", ")}.`);
       return;
     }
   }
@@ -847999,7 +847941,7 @@ function handleRecallList(args2, context) {
   if (scopeIdx !== -1 && args2[scopeIdx + 1]) {
     const scope = args2[scopeIdx + 1];
     if (!isValidScope(scope)) {
-      context.print(`[memory] Unknown scope "${scope}". Valid values ${VALID_SCOPES.join(", ")}.`);
+      context.print(`[memory] Unknown scope "${scope}". Valid values ${VALID_SCOPES2.join(", ")}.`);
       return;
     }
     filter.scope = scope;
@@ -848049,7 +847991,7 @@ async function handleRecallAdd(args2, context) {
   const tags = tagsRaw ? tagsRaw.split(",").map((token) => token.trim()).filter(Boolean) : [];
   const scope = scopeRaw && isValidScope(scopeRaw) ? scopeRaw : "project";
   if (scopeRaw && !isValidScope(scopeRaw)) {
-    context.print(`[memory] Invalid scope "${scopeRaw}". Valid values ${VALID_SCOPES.join(", ")}.`);
+    context.print(`[memory] Invalid scope "${scopeRaw}". Valid values ${VALID_SCOPES2.join(", ")}.`);
     return;
   }
   const provenance = [];
@@ -848183,7 +848125,7 @@ function handleRecallExport(args2, context) {
   if (scopeIdx !== -1 && commandArgs[scopeIdx + 1]) {
     const scope = commandArgs[scopeIdx + 1];
     if (!isValidScope(scope)) {
-      context.print(`[memory] Unknown scope "${scope}". Valid values ${VALID_SCOPES.join(", ")}.`);
+      context.print(`[memory] Unknown scope "${scope}". Valid values ${VALID_SCOPES2.join(", ")}.`);
       return;
     }
     filter.scope = scope;
@@ -848262,7 +848204,7 @@ function handleRecallHandoffExport(args2, context) {
   const scopeIdx = commandArgs.indexOf("--scope");
   const scopeRaw = scopeIdx !== -1 ? commandArgs[scopeIdx + 1] : "team";
   if (!scopeRaw || !isValidScope(scopeRaw)) {
-    context.print(`[memory] Unknown scope "${scopeRaw ?? ""}". Valid values ${VALID_SCOPES.join(", ")}.`);
+    context.print(`[memory] Unknown scope "${scopeRaw ?? ""}". Valid values ${VALID_SCOPES2.join(", ")}.`);
     return;
   }
   const bundle = memory.exportBundle({ scope: scopeRaw });
@@ -848378,7 +848320,7 @@ function handleRecallPromote(args2, context) {
   const id = parsed.rest[0];
   const scope = parsed.rest[1];
   if (!id || !scope || !isValidScope(scope)) {
-    context.print(`[memory] Usage: /memory promote <id> <${VALID_SCOPES.join("|")}> --yes`);
+    context.print(`[memory] Usage: /memory promote <id> <${VALID_SCOPES2.join("|")}> --yes`);
     return;
   }
   if (!parsed.yes) {
@@ -862154,7 +862096,7 @@ import { mkdirSync as mkdirSync64, readFileSync as readFileSync86, writeFileSync
 import { dirname as dirname63, resolve as resolve39 } from "path";
 init_state3();
 var VALID_CLASSES2 = ["decision", "constraint", "incident", "pattern", "fact", "risk", "runbook", "architecture", "ownership"];
-var VALID_SCOPES3 = ["session", "project", "team"];
+var VALID_SCOPES4 = ["session", "project", "team"];
 var VALID_REVIEW_STATES3 = ["fresh", "reviewed", "stale", "contradicted"];
 var VALID_PROVENANCE_KINDS = ["session", "turn", "task", "event", "file"];
 var VALUE_OPTIONS = new Set([
@@ -862254,7 +862196,7 @@ function isMemoryClass2(value) {
   return VALID_CLASSES2.includes(value);
 }
 function isMemoryScope2(value) {
-  return VALID_SCOPES3.includes(value);
+  return VALID_SCOPES4.includes(value);
 }
 function isReviewState(value) {
   return VALID_REVIEW_STATES3.includes(value);
@@ -862269,7 +862211,7 @@ function requireClass(value) {
 }
 function requireScope(value) {
   if (!value || !isMemoryScope2(value))
-    throw new Error(`Invalid memory scope "${value ?? ""}". Valid values ${VALID_SCOPES3.join(", ")}`);
+    throw new Error(`Invalid memory scope "${value ?? ""}". Valid values ${VALID_SCOPES4.join(", ")}`);
   return value;
 }
 function optionalScope(value) {
@@ -879549,6 +879491,7 @@ function connectedHostSummary(context, toolRegistry) {
     tokenPath: connection5.tokenPath,
     ownership: "external-connected-host",
     lifecycle: "GoodVibes Agent can use public connected-host operator routes, but does not start, stop, restart, install, expose, or mutate the host listener.",
+    statusMode: 'Use agent_harness mode:"connected_host_status" for live read-only reachability, SDK compatibility, token posture, and Agent Knowledge route readiness.',
     routeFamilies: connectedHostRouteFamilies(),
     capabilities: connectedHostCapabilityMap(toolRegistry),
     blockedCapabilities: blockedConnectedHostCapabilities()
@@ -880062,6 +880005,274 @@ function openHarnessPanel(context, args2) {
   };
 }
 
+// src/cli/external-runtime.ts
+import { existsSync as existsSync83, readFileSync as readFileSync90 } from "fs";
+import { join as join98 } from "path";
+function isRecord42(value) {
+  return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+}
+function readString53(record2, key) {
+  const value = record2?.[key];
+  return typeof value === "string" ? value : null;
+}
+function resolveBaseUrl2(configManager) {
+  const host = String(configManager.get("controlPlane.host") ?? "127.0.0.1");
+  const port = Number(configManager.get("controlPlane.port") ?? 3421);
+  return `http://${host}:${Number.isFinite(port) ? port : 3421}`;
+}
+function readOperatorToken2(homeDirectory) {
+  const path7 = join98(homeDirectory, ".goodvibes", "daemon", "operator-tokens.json");
+  if (!existsSync83(path7))
+    return { token: null, path: path7 };
+  try {
+    const parsed = JSON.parse(readFileSync90(path7, "utf-8"));
+    const token = isRecord42(parsed) && typeof parsed.token === "string" ? parsed.token : null;
+    return { token, path: path7 };
+  } catch {
+    return { token: null, path: path7 };
+  }
+}
+async function fetchJson2(url2, token, timeoutMs) {
+  const controller = new AbortController;
+  const timer = setTimeout(() => controller.abort(), timeoutMs);
+  try {
+    const response5 = await fetch(url2, {
+      headers: token ? { authorization: `Bearer ${token}` } : undefined,
+      signal: controller.signal
+    });
+    const text = await response5.text();
+    let body2 = text;
+    if (text.trim().length > 0) {
+      try {
+        body2 = JSON.parse(text);
+      } catch {
+        body2 = text;
+      }
+    }
+    return { ok: response5.ok, status: response5.status, body: body2 };
+  } finally {
+    clearTimeout(timer);
+  }
+}
+async function inspectCliExternalRuntime(options) {
+  const baseUrl = resolveBaseUrl2(options.configManager);
+  const token = readOperatorToken2(options.homeDirectory);
+  const timeoutMs = options.timeoutMs ?? 1500;
+  const route = "/api/goodvibes-agent/knowledge/status";
+  try {
+    const status = await fetchJson2(`${baseUrl}/status`, token.token, timeoutMs);
+    const statusRecord = isRecord42(status.body) ? status.body : {};
+    const version6 = readString53(statusRecord, "version") ?? "unknown";
+    const compatible = status.ok && version6 === SDK_VERSION;
+    if (!status.ok) {
+      return {
+        baseUrl,
+        statusCode: status.status,
+        reachable: false,
+        version: version6,
+        expectedVersion: SDK_VERSION,
+        compatible: false,
+        operatorToken: { present: Boolean(token.token), path: token.path },
+        agentKnowledge: {
+          route,
+          ready: false,
+          kind: status.status === 401 ? "auth_required" : "connected_host_unavailable",
+          statusCode: status.status
+        },
+        error: typeof status.body === "string" ? status.body : `HTTP ${status.status}`
+      };
+    }
+    if (!token.token) {
+      return {
+        baseUrl,
+        statusCode: status.status,
+        reachable: true,
+        version: version6,
+        expectedVersion: SDK_VERSION,
+        compatible,
+        operatorToken: { present: false, path: token.path },
+        agentKnowledge: {
+          route,
+          ready: false,
+          kind: "auth_required",
+          statusCode: null
+        },
+        error: null
+      };
+    }
+    if (!compatible) {
+      return {
+        baseUrl,
+        statusCode: status.status,
+        reachable: true,
+        version: version6,
+        expectedVersion: SDK_VERSION,
+        compatible: false,
+        operatorToken: { present: true, path: token.path },
+        agentKnowledge: {
+          route,
+          ready: false,
+          kind: "version_mismatch",
+          statusCode: null
+        },
+        error: null
+      };
+    }
+    const knowledge2 = await fetchJson2(`${baseUrl}${route}`, token.token, timeoutMs);
+    return {
+      baseUrl,
+      statusCode: status.status,
+      reachable: true,
+      version: version6,
+      expectedVersion: SDK_VERSION,
+      compatible,
+      operatorToken: { present: true, path: token.path },
+      agentKnowledge: {
+        route,
+        ready: knowledge2.ok,
+        kind: knowledge2.ok ? "ok" : knowledge2.status === 401 ? "auth_required" : knowledge2.status === 404 ? "connected_host_route_unavailable" : "connected_host_error",
+        statusCode: knowledge2.status
+      },
+      error: knowledge2.ok ? null : typeof knowledge2.body === "string" ? knowledge2.body : `HTTP ${knowledge2.status}`
+    };
+  } catch (error51) {
+    return {
+      baseUrl,
+      statusCode: null,
+      reachable: false,
+      version: "unknown",
+      expectedVersion: SDK_VERSION,
+      compatible: false,
+      operatorToken: { present: Boolean(token.token), path: token.path },
+      agentKnowledge: {
+        route,
+        ready: false,
+        kind: "connected_host_unavailable",
+        statusCode: null
+      },
+      error: summarizeError(error51)
+    };
+  }
+}
+
+// src/tools/agent-harness-connected-host-status.ts
+var CONNECTED_HOST_STATUS_TIMEOUT_MS = 1500;
+function resolveHomeDirectory(context) {
+  return context.workspace.shellPaths?.homeDirectory ?? context.platform.configManager.getHomeDirectory() ?? "";
+}
+function resolveWorkingDirectory(context) {
+  return context.workspace.shellPaths?.workingDirectory ?? context.platform.configManager.getWorkingDirectory() ?? "";
+}
+function connectedHostFindings(runtime3, tokenUsable) {
+  const findings = [];
+  if (!runtime3.reachable) {
+    findings.push({
+      id: "connected-host-unreachable",
+      severity: "warning",
+      summary: "Connected host is not reachable.",
+      cause: runtime3.error ?? `No response from ${runtime3.baseUrl}.`,
+      action: "Start or repair the owning GoodVibes host outside Agent, then recheck connected-host status."
+    });
+  } else if (!runtime3.compatible) {
+    findings.push({
+      id: "connected-host-version-mismatch",
+      severity: "warning",
+      summary: "Connected host SDK version does not match Agent.",
+      cause: `Connected host reports SDK ${runtime3.version}; Agent expects ${runtime3.expectedVersion}.`,
+      action: "Update the owning GoodVibes host so its /status route reports the Agent SDK pin."
+    });
+  }
+  if (!tokenUsable) {
+    findings.push({
+      id: "connected-host-token-missing",
+      severity: "warning",
+      summary: "Connected-host operator token is missing or unreadable.",
+      cause: `No usable operator token was found at ${runtime3.operatorToken.path}.`,
+      action: "Provision or repair connected-host access through the owning GoodVibes host."
+    });
+  }
+  if (runtime3.reachable && tokenUsable && !runtime3.agentKnowledge.ready) {
+    findings.push({
+      id: "agent-knowledge-route-not-ready",
+      severity: "warning",
+      summary: "Isolated Agent Knowledge route is not ready.",
+      cause: `${runtime3.agentKnowledge.route} returned ${runtime3.agentKnowledge.kind}${runtime3.agentKnowledge.statusCode === null ? "" : ` (${runtime3.agentKnowledge.statusCode})`}.`,
+      action: "Update or repair the connected host, then recheck Agent Knowledge compatibility."
+    });
+  }
+  return findings;
+}
+async function connectedHostStatusSummary(context, toolRegistry) {
+  const homeDirectory = resolveHomeDirectory(context);
+  const workingDirectory = resolveWorkingDirectory(context);
+  const token = readConnectedHostOperatorToken(homeDirectory);
+  const runtime3 = await inspectCliExternalRuntime({
+    configManager: context.platform.configManager,
+    homeDirectory,
+    timeoutMs: CONNECTED_HOST_STATUS_TIMEOUT_MS
+  });
+  const tokenUsable = Boolean(token.token);
+  return {
+    ownership: "external-connected-host",
+    readOnly: true,
+    timeoutMs: CONNECTED_HOST_STATUS_TIMEOUT_MS,
+    lifecycle: "GoodVibes Agent can inspect connected-host readiness and use public operator routes, but does not start, stop, restart, install, expose, or mutate the host listener.",
+    paths: {
+      workingDirectory,
+      homeDirectory
+    },
+    endpoints: {
+      controlPlane: {
+        enabled: context.platform.configManager.get("controlPlane.enabled"),
+        ...resolveRuntimeEndpointBinding(context.platform.configManager, "controlPlane")
+      },
+      httpListener: {
+        enabled: context.platform.configManager.get("danger.httpListener"),
+        ...resolveRuntimeEndpointBinding(context.platform.configManager, "httpListener")
+      },
+      web: {
+        enabled: context.platform.configManager.get("web.enabled"),
+        ...resolveRuntimeEndpointBinding(context.platform.configManager, "web")
+      }
+    },
+    operatorToken: {
+      present: token.present,
+      usable: tokenUsable,
+      path: token.path,
+      fingerprint: token.token ? `sha256:${connectedHostOperatorTokenFingerprint(token.token)}` : null,
+      error: token.error ?? null
+    },
+    liveStatus: runtime3,
+    routeReadiness: [
+      {
+        id: "status",
+        route: "/status",
+        reachable: runtime3.reachable,
+        statusCode: runtime3.statusCode,
+        sdkVersion: runtime3.version,
+        expectedSdkVersion: runtime3.expectedVersion,
+        compatible: runtime3.compatible
+      },
+      {
+        id: "agent-knowledge",
+        route: runtime3.agentKnowledge.route,
+        ready: runtime3.agentKnowledge.ready,
+        kind: runtime3.agentKnowledge.kind,
+        statusCode: runtime3.agentKnowledge.statusCode
+      }
+    ],
+    findings: connectedHostFindings(runtime3, tokenUsable),
+    modelAccess: {
+      diagnostics: 'Use mode:"connected_host_status" for live read-only host readiness. Use mode:"connected_host" for capability and boundary inventory.',
+      cliMirrors: ["goodvibes-agent status --json", "goodvibes-agent doctor", "goodvibes-agent compat"],
+      tuiMirrors: ["Agent Workspace -> Home -> Host compatibility", "Agent Workspace -> Home -> Doctor diagnostics", "Agent Workspace -> Home -> Review health"]
+    },
+    routeFamilies: connectedHostRouteFamilies(),
+    capabilities: connectedHostCapabilityMap(toolRegistry),
+    blockedCapabilities: blockedConnectedHostCapabilities()
+  };
+}
+
 // src/tools/agent-harness-local-operations.ts
 function output6(value) {
   return { success: true, output: typeof value === "string" ? value : JSON.stringify(value, null, 2) };
@@ -880069,7 +880280,7 @@ function output6(value) {
 function error51(message) {
   return { success: false, error: message };
 }
-function readString53(value) {
+function readString54(value) {
   return typeof value === "string" ? value.trim() : "";
 }
 function readFieldMap2(value) {
@@ -880096,10 +880307,10 @@ function describeEditor(editor) {
 }
 function readRecordId(args2) {
   const fields = readFieldMap2(args2.fields);
-  return readString53(args2.recordId ?? args2.id ?? fields.recordId ?? fields.id);
+  return readString54(args2.recordId ?? args2.id ?? fields.recordId ?? fields.id);
 }
 function requireConfirmed(args2, label) {
-  if (!readString53(args2.explicitUserRequest))
+  if (!readString54(args2.explicitUserRequest))
     return `${label} requires explicitUserRequest with the user's exact request or a short faithful summary.`;
   if (args2.confirm !== true)
     return `${label} requires confirm:true after an explicit user request.`;
@@ -880227,7 +880438,7 @@ function localRegistryArgsForTarget(target, args2, recordId) {
     ...base2,
     ...edit,
     ...target.action === "stale" && fields.reason ? { reason: fields.reason } : {},
-    ...target.action === "delete" ? { confirm: args2.confirm, explicitUserRequest: readString53(args2.explicitUserRequest) } : {}
+    ...target.action === "delete" ? { confirm: args2.confirm, explicitUserRequest: readString54(args2.explicitUserRequest) } : {}
   };
 }
 async function executeTool(toolRegistry, name51, toolArgs) {
@@ -880272,7 +880483,7 @@ async function runLocalWorkspaceAction(deps, action2, args2) {
     if (missing.length > 0)
       return output6({ status: "missing_required_fields", missing, action: action2.id, editor: describeEditor(editor) });
     if (editor.kind === "knowledge-url")
-      return executeTool(deps.toolRegistry, "agent_knowledge_ingest", { sourceKind: "url", url: fieldReader(editor, fields)("url"), tags: splitList5(fieldReader(editor, fields)("tags")), folderPath: fieldReader(editor, fields)("folder"), confirm: args2.confirm, explicitUserRequest: readString53(args2.explicitUserRequest) });
+      return executeTool(deps.toolRegistry, "agent_knowledge_ingest", { sourceKind: "url", url: fieldReader(editor, fields)("url"), tags: splitList5(fieldReader(editor, fields)("tags")), folderPath: fieldReader(editor, fields)("folder"), confirm: args2.confirm, explicitUserRequest: readString54(args2.explicitUserRequest) });
     return executeTool(deps.toolRegistry, "agent_local_registry", localRegistryArgsFromEditor(editor, fields, recordId));
   }
   if (!target)
@@ -880281,7 +880492,7 @@ async function runLocalWorkspaceAction(deps, action2, args2) {
 }
 
 // src/tools/agent-harness-model-tool-catalog.ts
-function readString54(value) {
+function readString55(value) {
   return typeof value === "string" ? value.trim() : "";
 }
 function readLimit8(value, fallback) {
@@ -880291,7 +880502,7 @@ function readLimit8(value, fallback) {
   return Math.max(1, Math.min(500, Math.trunc(parsed)));
 }
 function listHarnessModelTools(toolRegistry, args2) {
-  const query2 = readString54(args2.query).toLowerCase();
+  const query2 = readString55(args2.query).toLowerCase();
   const includeParameters = args2.includeParameters === true;
   const limit3 = readLimit8(args2.limit, 200);
   return toolRegistry.getToolDefinitions().filter((tool2) => !query2 || [tool2.name, tool2.description, ...tool2.sideEffects ?? []].join(`
@@ -880306,14 +880517,17 @@ function listHarnessModelTools(toolRegistry, args2) {
   }));
 }
 
-// src/tools/agent-harness-tool.ts
-var MODES = [
+// src/tools/agent-harness-tool-schema.ts
+var AGENT_HARNESS_MODES = [
   "summary",
   "cli_commands",
   "cli_command",
   "panels",
   "panel",
   "open_panel",
+  "ui_surfaces",
+  "ui_surface",
+  "open_ui_surface",
   "shortcuts",
   "keybindings",
   "keybinding",
@@ -880332,15 +880546,451 @@ var MODES = [
   "workspace_action",
   "run_workspace_action",
   "tools",
-  "connected_host"
+  "connected_host",
+  "connected_host_status"
+];
+var KEY_COMBO_PARAMETER_SCHEMA = {
+  type: "object",
+  properties: { key: { type: "string" }, ctrl: { type: "boolean" }, shift: { type: "boolean" }, alt: { type: "boolean" } },
+  required: ["key"],
+  additionalProperties: false
+};
+var AGENT_HARNESS_PARAMETER_PROPERTIES = {
+  mode: {
+    type: "string",
+    enum: AGENT_HARNESS_MODES,
+    description: "Harness operation to perform."
+  },
+  query: {
+    type: "string",
+    description: "Search text for command, setting, tool, or UI surface catalogs."
+  },
+  command: {
+    type: "string",
+    description: 'Full slash command string for mode run_command, for example "/settings get provider.model". In cli_command mode this may also hold a top-level CLI string such as "goodvibes-agent status --json".'
+  },
+  cliCommand: {
+    type: "string",
+    description: 'Top-level CLI command string for mode cli_command, for example "goodvibes-agent status --json" or "profiles list". This mode is read-only metadata/parse inspection.'
+  },
+  commandName: {
+    type: "string",
+    description: "Slash command root without the leading slash for mode command or run_command, or a top-level CLI command token for cli_command."
+  },
+  args: {
+    type: "array",
+    items: { type: "string" },
+    description: "Slash command argument tokens for mode run_command when commandName is used."
+  },
+  categoryId: {
+    type: "string",
+    description: "Agent workspace category id for workspace action filtering or ui surface routing."
+  },
+  surfaceId: {
+    type: "string",
+    description: "UI surface id for ui_surface or open_ui_surface modes."
+  },
+  panelId: {
+    type: "string",
+    description: "Built-in panel id for panel or open_panel modes."
+  },
+  actionId: {
+    type: "string",
+    description: "Agent workspace action id for workspace_action or run_workspace_action, or keybinding action id for keybinding/set_keybinding/reset_keybinding."
+  },
+  fields: {
+    type: "object",
+    additionalProperties: { type: "string" },
+    description: "Field values for run_workspace_action when the workspace action opens an editor form."
+  },
+  combo: {
+    ...KEY_COMBO_PARAMETER_SCHEMA,
+    description: 'Single key combo for set_keybinding, for example { "key": "g", "ctrl": true }.'
+  },
+  combos: {
+    type: "array",
+    items: KEY_COMBO_PARAMETER_SCHEMA,
+    description: "Multiple key combos for set_keybinding."
+  },
+  recordId: {
+    type: "string",
+    description: "Selected Agent-local record id for selection-based local workspace operations."
+  },
+  key: {
+    type: "string",
+    description: "Agent setting key for get_setting, set_setting, or reset_setting."
+  },
+  value: {
+    anyOf: [
+      { type: "string" },
+      { type: "number" },
+      { type: "boolean" }
+    ],
+    description: "Setting value for set_setting. Strings, booleans, numbers, and enum strings are accepted."
+  },
+  target: {
+    type: "string",
+    description: "Optional UI target, such as a model-picker target or settings target key."
+  },
+  category: {
+    type: "string",
+    description: "Setting category filter such as provider, behavior, tools, ui, tts, permissions, automation, or surfaces."
+  },
+  prefix: {
+    type: "string",
+    description: "Setting key prefix filter such as surfaces.slack."
+  },
+  includeHidden: {
+    type: "boolean",
+    description: "Include settings hidden from the Agent workspace because they are host-owned or non-Agent lifecycle settings."
+  },
+  includeParameters: {
+    type: "boolean",
+    description: "Include model tool JSON schemas in tools mode, or workspace editor field schemas in workspace_actions mode."
+  },
+  limit: {
+    type: "number",
+    description: "Maximum catalog entries to return."
+  },
+  pane: {
+    type: "string",
+    enum: ["top", "bottom"],
+    description: "Preferred panel pane for open_panel when the current shell supports panel routing."
+  },
+  confirm: {
+    type: "boolean",
+    description: "Required true for set_setting, reset_setting, run_command, open_panel, open_ui_surface, and mutating run_workspace_action calls after an explicit user request."
+  },
+  explicitUserRequest: {
+    type: "string",
+    description: "Exact user request or faithful short summary authorizing a setting mutation or harness UI/command invocation."
+  }
+};
+
+// src/tools/agent-harness-ui-surface-metadata.ts
+function readString56(value) {
+  return typeof value === "string" ? value.trim() : "";
+}
+function readLimit9(value, fallback) {
+  const parsed = typeof value === "string" && value.trim() ? Number(value) : value;
+  if (typeof parsed !== "number" || !Number.isFinite(parsed))
+    return fallback;
+  return Math.max(1, Math.min(500, Math.trunc(parsed)));
+}
+function routeUnavailable(surface) {
+  return {
+    status: "route_unavailable",
+    surface: surface.id,
+    note: "The current runtime did not provide the shell opener for this UI surface."
+  };
+}
+function opened(surface, extra = {}) {
+  return {
+    status: "opened",
+    surface: surface.id,
+    kind: surface.kind,
+    ...extra,
+    note: "UI routing was handed to the current Agent shell bridge."
+  };
+}
+function optionalModelTarget(args2) {
+  const target = readString56(args2.target);
+  return target === "main" || target === "helper" || target === "tool" || target === "tts" ? target : undefined;
+}
+function optionalOnboardingMode(args2) {
+  const target = readString56(args2.target);
+  return target === "new" || target === "edit" || target === "reopen" ? target : undefined;
+}
+function workspaceCategory(args2) {
+  return readString56(args2.categoryId || args2.category || args2.target) || undefined;
+}
+function settingsTarget(args2) {
+  return readString56(args2.target || args2.key || args2.prefix) || undefined;
+}
+var UI_SURFACES = [
+  {
+    id: "agent-workspace",
+    label: "Agent Workspace",
+    kind: "workspace",
+    summary: "Fullscreen operator workspace with setup, knowledge, local state, channels, automation, and delegation routes.",
+    command: "/agent",
+    preferredModelRoute: "Use workspace_actions/workspace_action/run_workspace_action for model operation; use open_ui_surface only to visibly navigate.",
+    parameters: ["categoryId"],
+    available: (context) => typeof context.openAgentWorkspace === "function",
+    open: (context, args2) => {
+      const surface = findSurfaceById("agent-workspace");
+      if (!context.openAgentWorkspace)
+        return routeUnavailable(surface);
+      const categoryId = workspaceCategory(args2);
+      context.openAgentWorkspace(categoryId);
+      return opened(surface, { categoryId: categoryId ?? "default" });
+    }
+  },
+  {
+    id: "settings",
+    label: "Settings",
+    kind: "modal",
+    summary: "Fullscreen settings workspace for Agent-owned configuration, subscriptions, secrets, MCP, tools, and surface settings.",
+    command: "/settings",
+    preferredModelRoute: "Use settings/get_setting/set_setting/reset_setting for model operation; use open_ui_surface only to visibly navigate.",
+    parameters: ["target", "key", "prefix"],
+    available: (context) => typeof context.openSettingsModal === "function",
+    open: (context, args2) => {
+      const surface = findSurfaceById("settings");
+      if (!context.openSettingsModal)
+        return routeUnavailable(surface);
+      const target = settingsTarget(args2);
+      context.openSettingsModal(target);
+      return opened(surface, { target: target ?? "default" });
+    }
+  },
+  {
+    id: "mcp-workspace",
+    label: "MCP Workspace",
+    kind: "workspace",
+    summary: "MCP server setup, trust posture, and tool inventory workspace.",
+    command: "/mcp",
+    preferredModelRoute: "Use workspace_actions, tools, and settings modes for model operation.",
+    available: (context) => typeof context.openMcpWorkspace === "function",
+    open: (context) => {
+      const surface = findSurfaceById("mcp-workspace");
+      if (!context.openMcpWorkspace)
+        return routeUnavailable(surface);
+      context.openMcpWorkspace();
+      return opened(surface);
+    }
+  },
+  {
+    id: "model-picker",
+    label: "Model Picker",
+    kind: "picker",
+    summary: "Interactive model picker for main, helper, tool, and TTS model routes.",
+    command: "/model",
+    preferredModelRoute: "Use settings mode for direct provider.model changes, or run_command /model with confirmation when a concrete model id is known.",
+    parameters: ["target"],
+    available: (context) => typeof context.openModelPicker === "function" || typeof context.openModelPickerWithTarget === "function",
+    open: (context, args2) => {
+      const surface = findSurfaceById("model-picker");
+      const target = optionalModelTarget(args2);
+      if (target && context.openModelPickerWithTarget) {
+        const openedForTarget = context.openModelPickerWithTarget(target);
+        return opened(surface, { target, openedForTarget });
+      }
+      if (!context.openModelPicker)
+        return routeUnavailable(surface);
+      context.openModelPicker();
+      return opened(surface, { target: "main" });
+    }
+  },
+  {
+    id: "provider-picker",
+    label: "Provider Picker",
+    kind: "picker",
+    summary: "Interactive provider picker for model route setup.",
+    command: "/provider",
+    preferredModelRoute: "Use settings mode for direct provider routing changes, or run confirmed slash-command mirrors for concrete provider changes.",
+    parameters: ["target"],
+    available: (context) => typeof context.openProviderPicker === "function" || typeof context.openProviderModelPickerWithTarget === "function",
+    open: (context, args2) => {
+      const surface = findSurfaceById("provider-picker");
+      const target = optionalModelTarget(args2);
+      if (target && context.openProviderModelPickerWithTarget) {
+        context.openProviderModelPickerWithTarget(target);
+        return opened(surface, { target });
+      }
+      if (!context.openProviderPicker)
+        return routeUnavailable(surface);
+      context.openProviderPicker();
+      return opened(surface, { target: "main" });
+    }
+  },
+  {
+    id: "session-picker",
+    label: "Session Picker",
+    kind: "picker",
+    summary: "Saved session browser and loader.",
+    command: "/sessions",
+    preferredModelRoute: "Use session slash-command mirrors with confirmation for concrete save/load/export actions.",
+    available: (context) => typeof context.openSessionPicker === "function",
+    open: (context) => {
+      const surface = findSurfaceById("session-picker");
+      if (!context.openSessionPicker)
+        return routeUnavailable(surface);
+      context.openSessionPicker();
+      return opened(surface);
+    }
+  },
+  {
+    id: "profile-picker",
+    label: "Profile Picker",
+    kind: "picker",
+    summary: "Agent profile picker for local isolated profile selection.",
+    command: "/agent-profile",
+    preferredModelRoute: "Use workspace profile actions or profile slash-command mirrors for concrete model operation.",
+    available: (context) => typeof context.openProfilePicker === "function",
+    open: (context) => {
+      const surface = findSurfaceById("profile-picker");
+      if (!context.openProfilePicker)
+        return routeUnavailable(surface);
+      context.openProfilePicker();
+      return opened(surface);
+    }
+  },
+  {
+    id: "bookmark-modal",
+    label: "Bookmarks",
+    kind: "modal",
+    summary: "Transcript bookmark browser.",
+    command: "/bookmarks",
+    preferredModelRoute: "Use slash-command mirrors for concrete bookmark inspection; opening is visible navigation only.",
+    available: (context) => typeof context.openBookmarkModal === "function",
+    open: (context) => {
+      const surface = findSurfaceById("bookmark-modal");
+      if (!context.openBookmarkModal)
+        return routeUnavailable(surface);
+      context.openBookmarkModal();
+      return opened(surface);
+    }
+  },
+  {
+    id: "context-inspector",
+    label: "Context Inspector",
+    kind: "modal",
+    summary: "Context-window usage and token breakdown inspector.",
+    command: "/context",
+    preferredModelRoute: "Use slash-command mirrors for text output; opening is visible navigation only.",
+    available: (context) => typeof context.openContextInspector === "function",
+    open: (context) => {
+      const surface = findSurfaceById("context-inspector");
+      if (!context.openContextInspector)
+        return routeUnavailable(surface);
+      context.openContextInspector();
+      return opened(surface);
+    }
+  },
+  {
+    id: "help-overlay",
+    label: "Help Overlay",
+    kind: "overlay",
+    summary: "Registry-driven command and shortcut help overlay.",
+    command: "/help",
+    preferredModelRoute: "Use commands/command and shortcuts modes for model-readable discovery.",
+    available: (context) => typeof context.openHelpOverlay === "function",
+    open: (context) => {
+      const surface = findSurfaceById("help-overlay");
+      if (!context.openHelpOverlay)
+        return routeUnavailable(surface);
+      context.openHelpOverlay();
+      return opened(surface);
+    }
+  },
+  {
+    id: "shortcuts-overlay",
+    label: "Shortcuts Overlay",
+    kind: "overlay",
+    summary: "Keyboard shortcut reference overlay.",
+    command: "/shortcuts",
+    preferredModelRoute: "Use shortcuts/keybindings modes for model-readable discovery and confirmed keybinding edits.",
+    available: (context) => typeof context.openShortcutsOverlay === "function",
+    open: (context) => {
+      const surface = findSurfaceById("shortcuts-overlay");
+      if (!context.openShortcutsOverlay)
+        return routeUnavailable(surface);
+      context.openShortcutsOverlay();
+      return opened(surface);
+    }
+  },
+  {
+    id: "onboarding",
+    label: "Onboarding Wizard",
+    kind: "modal",
+    summary: "First-run and setup review wizard for Agent readiness.",
+    command: "/setup",
+    preferredModelRoute: "Use workspace setup actions and settings modes for concrete model operation.",
+    parameters: ["target=new|edit|reopen"],
+    available: (context) => typeof context.openOnboardingWizard === "function",
+    open: (context, args2) => {
+      const surface = findSurfaceById("onboarding");
+      if (!context.openOnboardingWizard)
+        return routeUnavailable(surface);
+      const mode = optionalOnboardingMode(args2);
+      context.openOnboardingWizard(mode);
+      return opened(surface, { mode: mode ?? "default" });
+    }
+  }
 ];
+function findSurfaceById(surfaceId) {
+  return UI_SURFACES.find((surface) => surface.id === surfaceId);
+}
+function surfaceMatches(surface, query2) {
+  if (!query2)
+    return true;
+  return [
+    surface.id,
+    surface.label,
+    surface.kind,
+    surface.summary,
+    surface.command,
+    surface.preferredModelRoute
+  ].map((value) => String(value ?? "")).join(`
+`).toLowerCase().includes(query2.toLowerCase());
+}
+function describeSurface(context, surface) {
+  return {
+    id: surface.id,
+    label: surface.label,
+    kind: surface.kind,
+    summary: surface.summary,
+    command: surface.command,
+    preferredModelRoute: surface.preferredModelRoute,
+    parameters: surface.parameters ?? [],
+    available: surface.available(context),
+    policy: {
+      effect: "visible-ui-navigation",
+      confirmation: 'agent_harness mode:"open_ui_surface" requires confirm:true and explicitUserRequest.',
+      boundary: "UI surface routing opens the same visible Agent shell surface the user can open. Use first-class model tools, settings modes, workspace actions, or confirmed slash-command mirrors for actual operations."
+    }
+  };
+}
+function totalHarnessUiSurfaces() {
+  return UI_SURFACES.length;
+}
+function listHarnessUiSurfaces(context, args2) {
+  const query2 = readString56(args2.query);
+  const limit3 = readLimit9(args2.limit, 200);
+  return UI_SURFACES.map((surface) => describeSurface(context, surface)).filter((surface) => surfaceMatches(surface, query2)).slice(0, limit3);
+}
+function describeHarnessUiSurface(context, args2) {
+  const surfaceId = readString56(args2.surfaceId || args2.query);
+  if (!surfaceId)
+    return null;
+  const surface = UI_SURFACES.find((entry) => entry.id === surfaceId || entry.label.toLowerCase() === surfaceId.toLowerCase());
+  return surface ? describeSurface(context, surface) : null;
+}
+function openHarnessUiSurface(context, args2) {
+  const surfaceId = readString56(args2.surfaceId || args2.query);
+  const surface = UI_SURFACES.find((entry) => entry.id === surfaceId || entry.label.toLowerCase() === surfaceId.toLowerCase());
+  if (!surface) {
+    return {
+      status: "unknown_ui_surface",
+      surfaceId: surfaceId || "<missing>",
+      availableSurfaces: UI_SURFACES.map((entry) => entry.id)
+    };
+  }
+  return {
+    ...surface.open(context, args2),
+    descriptor: describeSurface(context, surface)
+  };
+}
+
+// src/tools/agent-harness-tool.ts
 function isMode(value) {
-  return typeof value === "string" && MODES.includes(value);
+  return typeof value === "string" && AGENT_HARNESS_MODES.includes(value);
 }
-function readString55(value) {
+function readString57(value) {
   return typeof value === "string" ? value.trim() : "";
 }
-function readLimit9(value, fallback) {
+function readLimit10(value, fallback) {
   const parsed = typeof value === "string" && value.trim() ? Number(value) : value;
   if (typeof parsed !== "number" || !Number.isFinite(parsed))
     return fallback;
@@ -880365,12 +881015,6 @@ function output7(value) {
 function error52(message) {
   return { success: false, error: message };
 }
-var KEY_COMBO_PARAMETER_SCHEMA = {
-  type: "object",
-  properties: { key: { type: "string" }, ctrl: { type: "boolean" }, shift: { type: "boolean" }, alt: { type: "boolean" } },
-  required: ["key"],
-  additionalProperties: false
-};
 function commandMatches(command8, query2) {
   if (!query2)
     return true;
@@ -880427,7 +881071,7 @@ function describeWorkspaceEditor(editor) {
 }
 function selectedRoutineFromArgs(snapshot, args2) {
   const fields = readFieldMap3(args2.fields);
-  const routineId = readString55(args2.recordId) || readString55(fields.routineId) || readString55(fields.id);
+  const routineId = readString57(args2.recordId) || readString57(fields.routineId) || readString57(fields.id);
   if (!routineId)
     return null;
   return snapshot.localRoutines.find((routine) => routine.id === routineId || routine.name.toLowerCase() === routineId.toLowerCase()) ?? null;
@@ -880495,17 +881139,17 @@ function localEditorModelExecution(editorKind) {
   return "Use the command field, editor schema, or a first-class Agent model tool when available.";
 }
 function listWorkspaceActions(deps, args2) {
-  const query2 = readString55(args2.query);
-  const categoryId = readString55(args2.categoryId || args2.category);
-  const limit3 = readLimit9(args2.limit, 200);
+  const query2 = readString57(args2.query);
+  const categoryId = readString57(args2.categoryId || args2.category);
+  const limit3 = readLimit10(args2.limit, 200);
   const includeEditor = args2.includeParameters === true;
   const editorContext = includeEditor ? buildWorkspaceEditorContext(deps.commandContext, args2) : null;
   const source = query2 ? searchAgentWorkspaceActions(AGENT_WORKSPACE_CATEGORIES, query2).map((result2) => ({ category: result2.category, action: result2.action })) : allWorkspaceActions();
   return source.filter((entry) => !categoryId || entry.category.id === categoryId).slice(0, limit3).map((entry) => describeWorkspaceAction(entry.category, entry.action, { includeEditor, editorContext }));
 }
 function findWorkspaceAction(args2) {
-  const actionId = readString55(args2.actionId || args2.query);
-  const categoryId = readString55(args2.categoryId || args2.category);
+  const actionId = readString57(args2.actionId || args2.query);
+  const categoryId = readString57(args2.categoryId || args2.category);
   if (!actionId)
     return null;
   return allWorkspaceActions().find((entry) => {
@@ -880515,12 +881159,12 @@ function findWorkspaceAction(args2) {
   }) ?? null;
 }
 function listCommands(commandRegistry, args2) {
-  const query2 = readString55(args2.query);
-  const limit3 = readLimit9(args2.limit, 200);
+  const query2 = readString57(args2.query);
+  const limit3 = readLimit10(args2.limit, 200);
   return commandRegistry.list().filter((command8) => commandMatches(command8, query2)).sort((a4, b3) => a4.name.localeCompare(b3.name)).slice(0, limit3).map(describeCommand);
 }
 function requireConfirmedAction(args2, action2) {
-  const explicitUserRequest = readString55(args2.explicitUserRequest);
+  const explicitUserRequest = readString57(args2.explicitUserRequest);
   if (!explicitUserRequest)
     return `${action2} requires explicitUserRequest with the user's exact request or a short faithful summary.`;
   if (args2.confirm !== true)
@@ -880528,7 +881172,7 @@ function requireConfirmedAction(args2, action2) {
   return null;
 }
 function commandFromArgs(args2) {
-  const rawCommand = readString55(args2.command);
+  const rawCommand = readString57(args2.command);
   if (rawCommand) {
     const parsed = parseSlashCommand(rawCommand);
     if (!parsed.name)
@@ -880538,7 +881182,7 @@ function commandFromArgs(args2) {
       args: parsed.args
     };
   }
-  const commandName = readString55(args2.commandName).replace(/^\//, "");
+  const commandName = readString57(args2.commandName).replace(/^\//, "");
   if (!commandName)
     return null;
   const commandArgs = readStringArray12(args2.args);
@@ -880726,115 +881370,13 @@ function createAgentHarnessTool(deps) {
       name: "agent_harness",
       description: [
         "Discover and operate the GoodVibes Agent harness from the main conversation.",
-        "Use this tool to inspect Agent workspace actions, built-in panels, top-level CLI mirrors, keybindings, slash commands with policy metadata, model tools, connected-host capabilities, and Agent settings, or to invoke a workspace action/command through the same in-process command registry the user uses in the TUI.",
-        "Discovery modes are read-only. Setting/keybinding writes, resets, slash command invocation, and workspace action invocation require confirm:true plus explicitUserRequest.",
+        "Use this tool to inspect Agent workspace actions, built-in panels, top-level CLI mirrors, UI surfaces, keybindings, slash commands with policy metadata, model tools, connected-host capabilities, and Agent settings, or to invoke a workspace action/command through the same in-process command registry the user uses in the TUI.",
+        "Discovery modes are read-only. Setting/keybinding writes, resets, UI routing, slash command invocation, and workspace action invocation require confirm:true plus explicitUserRequest.",
         "This tool preserves Agent product boundaries: connected-host lifecycle and listener posture stay externally owned, connected-host mode reports allowed and blocked route families, and secret-backed settings store raw values through the secret manager while config receives only a secret reference."
       ].join(" "),
       parameters: {
         type: "object",
-        properties: {
-          mode: {
-            type: "string",
-            enum: MODES,
-            description: "Harness operation to perform."
-          },
-          query: {
-            type: "string",
-            description: "Search text for command, setting, or tool catalogs."
-          },
-          command: {
-            type: "string",
-            description: 'Full slash command string for mode run_command, for example "/settings get provider.model". In cli_command mode this may also hold a top-level CLI string such as "goodvibes-agent status --json".'
-          },
-          cliCommand: {
-            type: "string",
-            description: 'Top-level CLI command string for mode cli_command, for example "goodvibes-agent status --json" or "profiles list". This mode is read-only metadata/parse inspection.'
-          },
-          commandName: {
-            type: "string",
-            description: "Slash command root without the leading slash for mode command or run_command, or a top-level CLI command token for cli_command."
-          },
-          args: {
-            type: "array",
-            items: { type: "string" },
-            description: "Slash command argument tokens for mode run_command when commandName is used."
-          },
-          categoryId: {
-            type: "string",
-            description: "Agent workspace category id for workspace action filtering."
-          },
-          panelId: {
-            type: "string",
-            description: "Built-in panel id for panel or open_panel modes."
-          },
-          actionId: {
-            type: "string",
-            description: "Agent workspace action id for workspace_action or run_workspace_action, or keybinding action id for keybinding/set_keybinding/reset_keybinding."
-          },
-          fields: {
-            type: "object",
-            additionalProperties: { type: "string" },
-            description: "Field values for run_workspace_action when the workspace action opens an editor form."
-          },
-          combo: {
-            ...KEY_COMBO_PARAMETER_SCHEMA,
-            description: 'Single key combo for set_keybinding, for example { "key": "g", "ctrl": true }.'
-          },
-          combos: {
-            type: "array",
-            items: KEY_COMBO_PARAMETER_SCHEMA,
-            description: "Multiple key combos for set_keybinding."
-          },
-          recordId: {
-            type: "string",
-            description: "Selected Agent-local record id for selection-based local workspace operations."
-          },
-          key: {
-            type: "string",
-            description: "Agent setting key for get_setting, set_setting, or reset_setting."
-          },
-          value: {
-            anyOf: [
-              { type: "string" },
-              { type: "number" },
-              { type: "boolean" }
-            ],
-            description: "Setting value for set_setting. Strings, booleans, numbers, and enum strings are accepted."
-          },
-          category: {
-            type: "string",
-            description: "Setting category filter such as provider, behavior, tools, ui, tts, permissions, automation, or surfaces."
-          },
-          prefix: {
-            type: "string",
-            description: "Setting key prefix filter such as surfaces.slack."
-          },
-          includeHidden: {
-            type: "boolean",
-            description: "Include settings hidden from the Agent workspace because they are host-owned or non-Agent lifecycle settings."
-          },
-          includeParameters: {
-            type: "boolean",
-            description: "Include model tool JSON schemas in tools mode, or workspace editor field schemas in workspace_actions mode."
-          },
-          limit: {
-            type: "number",
-            description: "Maximum catalog entries to return."
-          },
-          pane: {
-            type: "string",
-            enum: ["top", "bottom"],
-            description: "Preferred panel pane for open_panel when the current shell supports panel routing."
-          },
-          confirm: {
-            type: "boolean",
-            description: "Required true for set_setting, reset_setting, run_command, open_panel, and mutating run_workspace_action calls after an explicit user request."
-          },
-          explicitUserRequest: {
-            type: "string",
-            description: "Exact user request or faithful short summary authorizing a setting mutation or slash command invocation."
-          }
-        },
+        properties: AGENT_HARNESS_PARAMETER_PROPERTIES,
         required: ["mode"],
         additionalProperties: false
       },
@@ -880851,6 +881393,7 @@ function createAgentHarnessTool(deps) {
             cliCommands: totalHarnessCliCommands(),
             blockedCliCommandTokens: blockedHarnessCliCommandTokens(),
             panels: totalHarnessPanels(deps.commandContext),
+            uiSurfaces: totalHarnessUiSurfaces(),
             shortcuts: totalHarnessShortcuts(deps.commandContext),
             keybindings: totalHarnessKeybindings(deps.commandContext),
             commands: deps.commandRegistry.list().length,
@@ -880861,12 +881404,14 @@ function createAgentHarnessTool(deps) {
             modelAccess: {
               cliCommands: 'Use mode:"cli_commands" and mode:"cli_command" to inspect package CLI mirrors and their preferred in-process model routes. CLI modes are discovery-only.',
               panels: 'Use mode:"panels" and mode:"panel" to inspect built-in panel catalog/open state; use mode:"open_panel" with confirm:true plus explicitUserRequest to route a visible panel/workspace change.',
+              uiSurfaces: 'Use mode:"ui_surfaces" and mode:"ui_surface" to inspect modal/overlay/picker/workspace surfaces; use mode:"open_ui_surface" with confirm:true plus explicitUserRequest to route visible UI navigation.',
               shortcuts: 'Use mode:"shortcuts" to inspect fixed shortcuts plus configurable keybindings. Use mode:"set_keybinding" and mode:"reset_keybinding" with confirm:true plus explicitUserRequest to edit the same config file the user edits.',
               slashCommands: 'Use mode:"commands" and mode:"command" to inspect; use mode:"run_command" with confirm:true plus explicitUserRequest to execute.',
               workspace: 'Use mode:"workspace_actions" to list and mode:"workspace_action" for editor schemas; set includeParameters:true on workspace_actions to inline editor schemas.',
               settings: 'Use mode:"settings", mode:"get_setting", mode:"set_setting", and mode:"reset_setting".',
               tools: 'Use mode:"tools" with includeParameters:true to inspect first-class model tool schemas.',
-              connectedHost: 'Use mode:"connected_host" for the connected-host capability map and blocked boundaries.'
+              connectedHost: 'Use mode:"connected_host" for the connected-host capability map and blocked boundaries.',
+              connectedHostStatus: 'Use mode:"connected_host_status" for live read-only host reachability, SDK compatibility, token posture, and Agent Knowledge route readiness.'
             },
             settingsPolicy: settingsPolicySummary(),
             connectedHost: connectedHostSummary(deps.commandContext, deps.toolRegistry)
@@ -880896,7 +881441,7 @@ function createAgentHarnessTool(deps) {
         }
         if (args2.mode === "panel") {
           const panel = describeHarnessPanel(deps.commandContext, args2);
-          return panel ? output7(panel) : error52(`Unknown panel ${readString55(args2.panelId || args2.query) || "<missing>"}.`);
+          return panel ? output7(panel) : error52(`Unknown panel ${readString57(args2.panelId || args2.query) || "<missing>"}.`);
         }
         if (args2.mode === "open_panel") {
           const confirmationError2 = requireConfirmedAction(args2, "Panel routing");
@@ -880904,13 +881449,27 @@ function createAgentHarnessTool(deps) {
             return error52(confirmationError2);
           return output7(openHarnessPanel(deps.commandContext, args2));
         }
+        if (args2.mode === "ui_surfaces") {
+          const surfaces2 = listHarnessUiSurfaces(deps.commandContext, args2);
+          return output7({ surfaces: surfaces2, returned: surfaces2.length, total: totalHarnessUiSurfaces() });
+        }
+        if (args2.mode === "ui_surface") {
+          const surface = describeHarnessUiSurface(deps.commandContext, args2);
+          return surface ? output7(surface) : error52(`Unknown UI surface ${readString57(args2.surfaceId || args2.query) || "<missing>"}.`);
+        }
+        if (args2.mode === "open_ui_surface") {
+          const confirmationError2 = requireConfirmedAction(args2, "UI surface routing");
+          if (confirmationError2)
+            return error52(confirmationError2);
+          return output7(openHarnessUiSurface(deps.commandContext, args2));
+        }
         if (args2.mode === "shortcuts")
           return output7(listHarnessShortcuts(deps.commandContext, args2));
         if (args2.mode === "keybindings")
           return output7(listHarnessKeybindings(deps.commandContext, args2));
         if (args2.mode === "keybinding") {
           const binding = describeHarnessKeybinding(deps.commandContext, args2);
-          return binding ? output7(binding) : error52(`Unknown keybinding action ${readString55(args2.actionId || args2.key || args2.query) || "<missing>"}.`);
+          return binding ? output7(binding) : error52(`Unknown keybinding action ${readString57(args2.actionId || args2.key || args2.query) || "<missing>"}.`);
         }
         if (args2.mode === "set_keybinding") {
           const confirmationError2 = requireConfirmedAction(args2, "Keybinding mutation");
@@ -880929,7 +881488,7 @@ function createAgentHarnessTool(deps) {
           return output7({ commands: commands3, returned: commands3.length, total: deps.commandRegistry.list().length });
         }
         if (args2.mode === "command") {
-          const name51 = readString55(args2.commandName).replace(/^\//, "");
+          const name51 = readString57(args2.commandName).replace(/^\//, "");
           const command8 = name51 ? deps.commandRegistry.get(name51) : null;
           return command8 ? output7(describeCommand(command8)) : error52(`Unknown slash command /${name51 || "<missing>"}.`);
         }
@@ -880937,16 +881496,16 @@ function createAgentHarnessTool(deps) {
           return runCommand2(deps, args2);
         if (args2.mode === "settings") {
           const settings = listHarnessSettings(deps.commandContext.platform.configManager, {
-            category: readString55(args2.category) || undefined,
-            prefix: readString55(args2.prefix) || undefined,
-            query: readString55(args2.query) || undefined,
+            category: readString57(args2.category) || undefined,
+            prefix: readString57(args2.prefix) || undefined,
+            query: readString57(args2.query) || undefined,
             includeHidden: args2.includeHidden === true,
-            limit: readLimit9(args2.limit, 100)
+            limit: readLimit10(args2.limit, 100)
           });
           return output7({ settings, returned: settings.length, policy: settingsPolicySummary() });
         }
         if (args2.mode === "get_setting") {
-          const key = readString55(args2.key);
+          const key = readString57(args2.key);
           const setting = getHarnessSetting(deps.commandContext.platform.configManager, key);
           return setting ? output7(setting) : error52(`Unknown setting ${key || "<missing>"}.`);
         }
@@ -880956,7 +881515,7 @@ function createAgentHarnessTool(deps) {
             return error52(confirmationError2);
           if (args2.value === undefined)
             return error52("set_setting requires value.");
-          const key = readString55(args2.key);
+          const key = readString57(args2.key);
           const result2 = await setHarnessSetting(deps.commandContext.platform.configManager, deps.commandContext.platform.secretsManager, key, args2.value);
           return output7(result2);
         }
@@ -880964,7 +881523,7 @@ function createAgentHarnessTool(deps) {
           const confirmationError2 = requireConfirmedAction(args2, "Setting reset");
           if (confirmationError2)
             return error52(confirmationError2);
-          const key = readString55(args2.key);
+          const key = readString57(args2.key);
           const result2 = await resetHarnessSetting(deps.commandContext.platform.configManager, deps.commandContext.platform.secretsManager, key);
           return output7(result2);
         }
@@ -880981,7 +881540,7 @@ function createAgentHarnessTool(deps) {
         if (args2.mode === "workspace_action") {
           const found = findWorkspaceAction(args2);
           const editorContext = buildWorkspaceEditorContext(deps.commandContext, args2);
-          return found ? output7(describeWorkspaceAction(found.category, found.action, { includeEditor: true, editorContext })) : error52(`Unknown Agent workspace action ${readString55(args2.actionId || args2.query) || "<missing>"}.`);
+          return found ? output7(describeWorkspaceAction(found.category, found.action, { includeEditor: true, editorContext })) : error52(`Unknown Agent workspace action ${readString57(args2.actionId || args2.query) || "<missing>"}.`);
         }
         if (args2.mode === "run_workspace_action")
           return runWorkspaceAction(deps, args2);
@@ -880991,6 +881550,8 @@ function createAgentHarnessTool(deps) {
         }
         if (args2.mode === "connected_host")
           return output7(connectedHostSummary(deps.commandContext, deps.toolRegistry));
+        if (args2.mode === "connected_host_status")
+          return output7(await connectedHostStatusSummary(deps.commandContext, deps.toolRegistry));
         return error52(`Unhandled agent_harness mode: ${args2.mode}`);
       } catch (err2) {
         return error52(formatHarnessError(err2));
@@ -882767,7 +883328,7 @@ var MAX_INPUT_LENGTH2 = exports_security2.MAX_INPUT_LENGTH;
 var MAX_TOKEN_COUNT2 = exports_security2.MAX_TOKEN_COUNT;
 
 // src/runtime/surface-feature-flags.ts
-function isRecord42(value) {
+function isRecord43(value) {
   return Boolean(value) && typeof value === "object" && !Array.isArray(value);
 }
 function isFeatureFlagConfigKey(key) {
@@ -882784,7 +883345,7 @@ function readFeatureFlagConfigValue(config6, key) {
 }
 function mergeFeatureFlagConfigValue(config6, key, value) {
   if (key === "featureFlags") {
-    if (!isRecord42(value))
+    if (!isRecord43(value))
       throw new Error("featureFlags expects an object value.");
     const patch2 = {};
     for (const [flagId, state3] of Object.entries(value)) {
@@ -882804,8 +883365,8 @@ function mergeFeatureFlagConfigValue(config6, key, value) {
 
 // src/runtime/onboarding/verify.ts
 init_config8();
-import { existsSync as existsSync83 } from "fs";
-import { join as join98 } from "path";
+import { existsSync as existsSync84 } from "fs";
+import { join as join99 } from "path";
 function getNow(deps) {
   return deps.clock?.() ?? Date.now();
 }
@@ -882886,7 +883447,7 @@ function verifyAuthOperation(_deps, operation) {
 }
 function verifyCreateAgentProfileOperation(deps, operation) {
   const resolution2 = resolveAgentRuntimeProfileHome(deps.shellPaths.homeDirectory, operation.name);
-  const ok3 = existsSync83(join98(resolution2.homeDirectory, "profile.json"));
+  const ok3 = existsSync84(join99(resolution2.homeDirectory, "profile.json"));
   return {
     id: `agent-profile:${resolution2.id}`,
     status: ok3 ? "pass" : "fail",
@@ -882984,15 +883545,15 @@ async function verifyOnboardingRequest(deps, request2) {
 }
 
 // src/runtime/onboarding/apply-file-helpers.ts
-import { existsSync as existsSync84, mkdirSync as mkdirSync68, readFileSync as readFileSync90, unlinkSync as unlinkSync11, writeFileSync as writeFileSync59 } from "fs";
+import { existsSync as existsSync85, mkdirSync as mkdirSync68, readFileSync as readFileSync91, unlinkSync as unlinkSync11, writeFileSync as writeFileSync59 } from "fs";
 import { dirname as dirname67 } from "path";
 function isPlainObject3(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function readJsonObject(path7) {
-  if (!existsSync84(path7))
+  if (!existsSync85(path7))
     return {};
-  const parsed = JSON.parse(readFileSync90(path7, "utf-8"));
+  const parsed = JSON.parse(readFileSync91(path7, "utf-8"));
   if (!isPlainObject3(parsed))
     throw new Error(`Expected an object JSON payload at ${path7}.`);
   return parsed;
@@ -883020,7 +883581,7 @@ function setNestedValue(root, key, value) {
 }
 function restoreFile(path7, previous, reload) {
   if (previous === null) {
-    if (existsSync84(path7))
+    if (existsSync85(path7))
       unlinkSync11(path7);
   } else {
     mkdirSync68(dirname67(path7), { recursive: true });
@@ -883029,7 +883590,7 @@ function restoreFile(path7, previous, reload) {
   reload?.();
 }
 function snapshotFileRollback(path7, reload) {
-  const previous = existsSync84(path7) ? readFileSync90(path7, "utf-8") : null;
+  const previous = existsSync85(path7) ? readFileSync91(path7, "utf-8") : null;
   return () => restoreFile(path7, previous, reload);
 }
 async function runRollbacks(rollbacks) {
@@ -883148,7 +883709,7 @@ function validateCreateAgentProfileOperation(deps, operation) {
   if (name51.length === 0)
     throw new Error("Agent profile name is required.");
   const resolution2 = resolveAgentRuntimeProfileHome(deps.shellPaths.homeDirectory, name51);
-  if (existsSync85(resolution2.homeDirectory)) {
+  if (existsSync86(resolution2.homeDirectory)) {
     throw new Error(`Agent profile already exists: ${resolution2.id}`);
   }
   const templateId = operation.templateId?.trim();
@@ -883160,7 +883721,7 @@ function validateSelectAgentProfileOperation(deps, operation) {
   if (name51.length === 0)
     throw new Error("Agent profile name is required.");
   const resolution2 = resolveAgentRuntimeProfileHome(deps.shellPaths.homeDirectory, name51);
-  if (!existsSync85(resolution2.homeDirectory)) {
+  if (!existsSync86(resolution2.homeDirectory)) {
     throw new Error(`Agent profile does not exist: ${resolution2.id}`);
   }
 }
@@ -883268,7 +883829,7 @@ async function buildSecretRollbackAction(deps, operation) {
     throw new Error(`Secret storage locations for ${scope} scope are unavailable.`);
   const snapshots = locations.map((location) => ({
     path: location.path,
-    previous: existsSync85(location.path) ? readFileSync91(location.path, "utf-8") : null
+    previous: existsSync86(location.path) ? readFileSync92(location.path, "utf-8") : null
   }));
   return () => {
     for (const snapshot of snapshots)
@@ -883302,7 +883863,7 @@ async function buildRollbackAction(deps, operation) {
   if (operation.kind === "create-agent-profile") {
     const resolution2 = resolveAgentRuntimeProfileHome(deps.shellPaths.homeDirectory, operation.name);
     return () => {
-      if (existsSync85(resolution2.homeDirectory))
+      if (existsSync86(resolution2.homeDirectory))
         rmSync10(resolution2.homeDirectory, { recursive: true, force: true });
     };
   }
@@ -883638,7 +884199,7 @@ async function applyOnboardingRequest(deps, request2) {
   };
 }
 // src/runtime/onboarding/markers.ts
-import { existsSync as existsSync86, mkdirSync as mkdirSync69, readFileSync as readFileSync92, writeFileSync as writeFileSync60 } from "fs";
+import { existsSync as existsSync87, mkdirSync as mkdirSync69, readFileSync as readFileSync93, writeFileSync as writeFileSync60 } from "fs";
 import { dirname as dirname68 } from "path";
 var ONBOARDING_CHECK_MARKER_FILE = "onboarding-checked.json";
 function resolveMarkerPath(shellPaths3, scope) {
@@ -883682,10 +884243,10 @@ function getOnboardingCheckMarkerPath(shellPaths3, scope = "user") {
 }
 function readOnboardingCheckMarker(shellPaths3, scope = "user") {
   const path7 = resolveMarkerPath(shellPaths3, scope);
-  if (!existsSync86(path7))
+  if (!existsSync87(path7))
     return buildMissingMarkerState(scope, path7);
   try {
-    const parsed = JSON.parse(readFileSync92(path7, "utf-8"));
+    const parsed = JSON.parse(readFileSync93(path7, "utf-8"));
     if (!isCheckMarkerPayload(parsed)) {
       return buildParseErrorState(scope, path7, "Invalid onboarding check marker payload.");
     }
@@ -883727,7 +884288,7 @@ function writeOnboardingCheckMarker(shellPaths3, options = {}) {
   return readOnboardingCheckMarker(shellPaths3, scope);
 }
 // src/input/handler-content-actions.ts
-import { existsSync as existsSync87, lstatSync as lstatSync3, readFileSync as readFileSync93, readdirSync as readdirSync22 } from "fs";
+import { existsSync as existsSync88, lstatSync as lstatSync3, readFileSync as readFileSync94, readdirSync as readdirSync22 } from "fs";
 import { basename as basename6, relative as relative15 } from "path";
 var MARKER_REGEX = /\[(TEXT|IMAGE): [^\]]+\]/g;
 var IMAGE_PREFIXES = [
@@ -883787,7 +884348,7 @@ function readContextFileBlock(reference, projectRoot) {
     logger.debug("expandPrompt: context reference rejected", { reference, error: summarizeError(error53) });
     return null;
   }
-  if (!existsSync87(resolvedPath3))
+  if (!existsSync88(resolvedPath3))
     return null;
   const stat6 = lstatSync3(resolvedPath3);
   const label = escapeContextAttribute(relative15(projectRoot, resolvedPath3) || basename6(resolvedPath3));
@@ -883806,14 +884367,14 @@ function readContextFileBlock(reference, projectRoot) {
   if (stat6.size > MAX_CONTEXT_FILE_BYTES) {
     return [
       `<context-file path="${label}" truncated="true" bytes="${stat6.size}">`,
-      readFileSync93(resolvedPath3, "utf-8").slice(0, MAX_CONTEXT_FILE_BYTES),
+      readFileSync94(resolvedPath3, "utf-8").slice(0, MAX_CONTEXT_FILE_BYTES),
       "</context-file>"
     ].join(`
 `);
   }
   return [
     `<context-file path="${label}" bytes="${stat6.size}">`,
-    readFileSync93(resolvedPath3, "utf-8"),
+    readFileSync94(resolvedPath3, "utf-8"),
     "</context-file>"
   ].join(`
 `);
@@ -883870,8 +884431,8 @@ function registerPaste(state4, content, projectRoot) {
   if (IMAGE_EXTENSIONS2.some((ext) => trimmed2.toLowerCase().endsWith(ext))) {
     try {
       const resolvedPath3 = resolveAndValidatePath(trimmed2, projectRoot);
-      if (existsSync87(resolvedPath3)) {
-        const data = readFileSync93(resolvedPath3);
+      if (existsSync88(resolvedPath3)) {
+        const data = readFileSync94(resolvedPath3);
         const base644 = data.toString("base64");
         const ext = trimmed2.slice(trimmed2.lastIndexOf("."));
         const mediaType = mediaTypeFromExt(ext);
@@ -883921,7 +884482,7 @@ function expandPrompt(pasteRegistry, imageRegistry, text, projectRoot) {
     const filePath = injectMatch[1];
     try {
       const resolvedPath3 = resolveAndValidatePath(filePath, projectRoot);
-      const content = readFileSync93(resolvedPath3, "utf-8");
+      const content = readFileSync94(resolvedPath3, "utf-8");
       expanded = expanded.slice(0, injectMatch.index) + content + expanded.slice(injectMatch.index + injectMatch[0].length);
       injectRegex.lastIndex = injectMatch.index + content.length;
     } catch (err2) {
@@ -885259,7 +885820,7 @@ class AutocompleteEngine {
 
 // src/input/file-picker.ts
 import { readdir as readdir6 } from "fs/promises";
-import { join as join99, relative as relative16 } from "path";
+import { join as join100, relative as relative16 } from "path";
 
 class FilePickerModal {
   shellPaths;
@@ -885392,7 +885953,7 @@ class FilePickerModal {
         continue;
       if (entry.name === "node_modules" || entry.name === "dist")
         continue;
-      const fullPath = join99(dir, entry.name);
+      const fullPath = join100(dir, entry.name);
       const relPath = relative16(this.shellPaths.workingDirectory, fullPath);
       if (entry.isDirectory()) {
         files.push(relPath + "/");
@@ -893194,7 +893755,7 @@ function handleProfilePickerToken(state4, token) {
 }
 
 // src/input/handler-picker-routes.ts
-import { readFileSync as readFileSync94 } from "fs";
+import { readFileSync as readFileSync95 } from "fs";
 
 // src/renderer/model-picker-overlay.ts
 var MODEL_PICKER_CHROME_LINES = 7;
@@ -893486,7 +894047,7 @@ function handleFilePickerToken(state4, token) {
               throw new Error("working directory is unavailable");
             }
             const resolvedPath3 = resolveAndValidatePath(selected, projectRoot);
-            const data = readFileSync94(resolvedPath3);
+            const data = readFileSync95(resolvedPath3);
             const base644 = data.toString("base64");
             const mediaType = state4.mediaTypeFromExt(ext);
             const filename = selected.split("/").pop() ?? selected;
@@ -899445,155 +900006,6 @@ function renderOnboardingCliStatus(options) {
   ].join(`
 `);
 }
-// src/cli/external-runtime.ts
-import { existsSync as existsSync88, readFileSync as readFileSync95 } from "fs";
-import { join as join100 } from "path";
-function isRecord43(value) {
-  return Boolean(value) && typeof value === "object" && !Array.isArray(value);
-}
-function readString56(record2, key) {
-  const value = record2?.[key];
-  return typeof value === "string" ? value : null;
-}
-function resolveBaseUrl2(configManager) {
-  const host = String(configManager.get("controlPlane.host") ?? "127.0.0.1");
-  const port = Number(configManager.get("controlPlane.port") ?? 3421);
-  return `http://${host}:${Number.isFinite(port) ? port : 3421}`;
-}
-function readOperatorToken2(homeDirectory) {
-  const path7 = join100(homeDirectory, ".goodvibes", "daemon", "operator-tokens.json");
-  if (!existsSync88(path7))
-    return { token: null, path: path7 };
-  try {
-    const parsed = JSON.parse(readFileSync95(path7, "utf-8"));
-    const token = isRecord43(parsed) && typeof parsed.token === "string" ? parsed.token : null;
-    return { token, path: path7 };
-  } catch {
-    return { token: null, path: path7 };
-  }
-}
-async function fetchJson2(url2, token, timeoutMs) {
-  const controller = new AbortController;
-  const timer = setTimeout(() => controller.abort(), timeoutMs);
-  try {
-    const response5 = await fetch(url2, {
-      headers: token ? { authorization: `Bearer ${token}` } : undefined,
-      signal: controller.signal
-    });
-    const text = await response5.text();
-    let body2 = text;
-    if (text.trim().length > 0) {
-      try {
-        body2 = JSON.parse(text);
-      } catch {
-        body2 = text;
-      }
-    }
-    return { ok: response5.ok, status: response5.status, body: body2 };
-  } finally {
-    clearTimeout(timer);
-  }
-}
-async function inspectCliExternalRuntime(options) {
-  const baseUrl = resolveBaseUrl2(options.configManager);
-  const token = readOperatorToken2(options.homeDirectory);
-  const timeoutMs = options.timeoutMs ?? 1500;
-  const route = "/api/goodvibes-agent/knowledge/status";
-  try {
-    const status = await fetchJson2(`${baseUrl}/status`, token.token, timeoutMs);
-    const statusRecord = isRecord43(status.body) ? status.body : {};
-    const version6 = readString56(statusRecord, "version") ?? "unknown";
-    const compatible = status.ok && version6 === SDK_VERSION;
-    if (!status.ok) {
-      return {
-        baseUrl,
-        statusCode: status.status,
-        reachable: false,
-        version: version6,
-        expectedVersion: SDK_VERSION,
-        compatible: false,
-        operatorToken: { present: Boolean(token.token), path: token.path },
-        agentKnowledge: {
-          route,
-          ready: false,
-          kind: status.status === 401 ? "auth_required" : "connected_host_unavailable",
-          statusCode: status.status
-        },
-        error: typeof status.body === "string" ? status.body : `HTTP ${status.status}`
-      };
-    }
-    if (!token.token) {
-      return {
-        baseUrl,
-        statusCode: status.status,
-        reachable: true,
-        version: version6,
-        expectedVersion: SDK_VERSION,
-        compatible,
-        operatorToken: { present: false, path: token.path },
-        agentKnowledge: {
-          route,
-          ready: false,
-          kind: "auth_required",
-          statusCode: null
-        },
-        error: null
-      };
-    }
-    if (!compatible) {
-      return {
-        baseUrl,
-        statusCode: status.status,
-        reachable: true,
-        version: version6,
-        expectedVersion: SDK_VERSION,
-        compatible: false,
-        operatorToken: { present: true, path: token.path },
-        agentKnowledge: {
-          route,
-          ready: false,
-          kind: "version_mismatch",
-          statusCode: null
-        },
-        error: null
-      };
-    }
-    const knowledge2 = await fetchJson2(`${baseUrl}${route}`, token.token, timeoutMs);
-    return {
-      baseUrl,
-      statusCode: status.status,
-      reachable: true,
-      version: version6,
-      expectedVersion: SDK_VERSION,
-      compatible,
-      operatorToken: { present: true, path: token.path },
-      agentKnowledge: {
-        route,
-        ready: knowledge2.ok,
-        kind: knowledge2.ok ? "ok" : knowledge2.status === 401 ? "auth_required" : knowledge2.status === 404 ? "connected_host_route_unavailable" : "connected_host_error",
-        statusCode: knowledge2.status
-      },
-      error: knowledge2.ok ? null : typeof knowledge2.body === "string" ? knowledge2.body : `HTTP ${knowledge2.status}`
-    };
-  } catch (error53) {
-    return {
-      baseUrl,
-      statusCode: null,
-      reachable: false,
-      version: "unknown",
-      expectedVersion: SDK_VERSION,
-      compatible: false,
-      operatorToken: { present: Boolean(token.token), path: token.path },
-      agentKnowledge: {
-        route,
-        ready: false,
-        kind: "connected_host_unavailable",
-        statusCode: null
-      },
-      error: summarizeError(error53)
-    };
-  }
-}
 // src/cli/completion.ts
 var COMMANDS = [
   "run",