@pellux/goodvibes-agent 1.0.4 → 1.0.5

package/dist/package/main.js

@@ -816566,7 +816566,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.5";
 var _sdkVersion = "0.33.35";
 try {
   const pkg = JSON.parse(readFileSync(join(import.meta.dir, "..", "package.json"), "utf-8"));
@@ -847775,13 +847775,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 +847824,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 +847999,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 +848049,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 +848183,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 +848262,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 +848378,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 +862154,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 +862254,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 +862269,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) {
@@ -880306,14 +880306,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",
@@ -880334,9 +880337,125 @@ var MODES = [
   "tools",
   "connected_host"
 ];
-function isMode(value) {
-  return typeof value === "string" && MODES.includes(value);
-}
+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 readString55(value) {
   return typeof value === "string" ? value.trim() : "";
 }
@@ -880346,6 +880465,325 @@ function readLimit9(value, fallback) {
     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 = readString55(args2.target);
+  return target === "main" || target === "helper" || target === "tool" || target === "tts" ? target : undefined;
+}
+function optionalOnboardingMode(args2) {
+  const target = readString55(args2.target);
+  return target === "new" || target === "edit" || target === "reopen" ? target : undefined;
+}
+function workspaceCategory(args2) {
+  return readString55(args2.categoryId || args2.category || args2.target) || undefined;
+}
+function settingsTarget(args2) {
+  return readString55(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 = readString55(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 = readString55(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 = readString55(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" && AGENT_HARNESS_MODES.includes(value);
+}
+function readString56(value) {
+  return typeof value === "string" ? value.trim() : "";
+}
+function readLimit10(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 readStringArray12(value) {
   if (!Array.isArray(value))
     return [];
@@ -880365,12 +880803,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 +880859,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 = readString56(args2.recordId) || readString56(fields.routineId) || readString56(fields.id);
   if (!routineId)
     return null;
   return snapshot.localRoutines.find((routine) => routine.id === routineId || routine.name.toLowerCase() === routineId.toLowerCase()) ?? null;
@@ -880495,17 +880927,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 = readString56(args2.query);
+  const categoryId = readString56(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 = readString56(args2.actionId || args2.query);
+  const categoryId = readString56(args2.categoryId || args2.category);
   if (!actionId)
     return null;
   return allWorkspaceActions().find((entry) => {
@@ -880515,12 +880947,12 @@ function findWorkspaceAction(args2) {
   }) ?? null;
 }
 function listCommands(commandRegistry, args2) {
-  const query2 = readString55(args2.query);
-  const limit3 = readLimit9(args2.limit, 200);
+  const query2 = readString56(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 = readString56(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 +880960,7 @@ function requireConfirmedAction(args2, action2) {
   return null;
 }
 function commandFromArgs(args2) {
-  const rawCommand = readString55(args2.command);
+  const rawCommand = readString56(args2.command);
   if (rawCommand) {
     const parsed = parseSlashCommand(rawCommand);
     if (!parsed.name)
@@ -880538,7 +880970,7 @@ function commandFromArgs(args2) {
       args: parsed.args
     };
   }
-  const commandName = readString55(args2.commandName).replace(/^\//, "");
+  const commandName = readString56(args2.commandName).replace(/^\//, "");
   if (!commandName)
     return null;
   const commandArgs = readStringArray12(args2.args);
@@ -880726,115 +881158,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 +881181,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,6 +881192,7 @@ 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.',
@@ -880896,7 +881228,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 ${readString56(args2.panelId || args2.query) || "<missing>"}.`);
         }
         if (args2.mode === "open_panel") {
           const confirmationError2 = requireConfirmedAction(args2, "Panel routing");
@@ -880904,13 +881236,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 ${readString56(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 ${readString56(args2.actionId || args2.key || args2.query) || "<missing>"}.`);
         }
         if (args2.mode === "set_keybinding") {
           const confirmationError2 = requireConfirmedAction(args2, "Keybinding mutation");
@@ -880929,7 +881275,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 = readString56(args2.commandName).replace(/^\//, "");
           const command8 = name51 ? deps.commandRegistry.get(name51) : null;
           return command8 ? output7(describeCommand(command8)) : error52(`Unknown slash command /${name51 || "<missing>"}.`);
         }
@@ -880937,16 +881283,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: readString56(args2.category) || undefined,
+            prefix: readString56(args2.prefix) || undefined,
+            query: readString56(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 = readString56(args2.key);
           const setting = getHarnessSetting(deps.commandContext.platform.configManager, key);
           return setting ? output7(setting) : error52(`Unknown setting ${key || "<missing>"}.`);
         }
@@ -880956,7 +881302,7 @@ function createAgentHarnessTool(deps) {
             return error52(confirmationError2);
           if (args2.value === undefined)
             return error52("set_setting requires value.");
-          const key = readString55(args2.key);
+          const key = readString56(args2.key);
           const result2 = await setHarnessSetting(deps.commandContext.platform.configManager, deps.commandContext.platform.secretsManager, key, args2.value);
           return output7(result2);
         }
@@ -880964,7 +881310,7 @@ function createAgentHarnessTool(deps) {
           const confirmationError2 = requireConfirmedAction(args2, "Setting reset");
           if (confirmationError2)
             return error52(confirmationError2);
-          const key = readString55(args2.key);
+          const key = readString56(args2.key);
           const result2 = await resetHarnessSetting(deps.commandContext.platform.configManager, deps.commandContext.platform.secretsManager, key);
           return output7(result2);
         }
@@ -880981,7 +881327,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 ${readString56(args2.actionId || args2.query) || "<missing>"}.`);
         }
         if (args2.mode === "run_workspace_action")
           return runWorkspaceAction(deps, args2);
@@ -899451,7 +899797,7 @@ import { join as join100 } from "path";
 function isRecord43(value) {
   return Boolean(value) && typeof value === "object" && !Array.isArray(value);
 }
-function readString56(record2, key) {
+function readString57(record2, key) {
   const value = record2?.[key];
   return typeof value === "string" ? value : null;
 }
@@ -899502,7 +899848,7 @@ async function inspectCliExternalRuntime(options) {
   try {
     const status = await fetchJson2(`${baseUrl}/status`, token.token, timeoutMs);
     const statusRecord = isRecord43(status.body) ? status.body : {};
-    const version6 = readString56(statusRecord, "version") ?? "unknown";
+    const version6 = readString57(statusRecord, "version") ?? "unknown";
     const compatible = status.ok && version6 === SDK_VERSION;
     if (!status.ok) {
       return {