@pellux/goodvibes-agent 1.0.3 → 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.3";
+var _version = "1.0.5";
 var _sdkVersion = "0.33.35";
 try {
   const pkg = JSON.parse(readFileSync(join(import.meta.dir, "..", "package.json"), "utf-8"));
@@ -821197,7 +821197,7 @@ var INBOUND_EVENT_SURFACE_KINDS = new Set([
 ]);
 // src/runtime/onboarding/apply.ts
 init_config8();
-import { existsSync as existsSync84, readFileSync as readFileSync90, rmSync as rmSync10 } from "fs";
+import { existsSync as existsSync85, readFileSync as readFileSync91, 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";
@@ -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) {
@@ -879718,7 +879718,19 @@ function describeHarnessCliCommand(args2) {
   };
 }
 
-// src/tools/agent-harness-panel-metadata.ts
+// src/tools/agent-harness-keybinding-metadata.ts
+import { existsSync as existsSync82, mkdirSync as mkdirSync67, readFileSync as readFileSync89, writeFileSync as writeFileSync58 } from "fs";
+import { dirname as dirname66 } from "path";
+var FIXED_SHORTCUTS = [
+  { key: "Enter", description: "Send prompt" },
+  { key: "Shift+Enter / Ctrl+J", description: "Insert newline" },
+  { key: "Up / Down", description: "Navigate input history, lists, and scrollable overlays" },
+  { key: "Tab", description: "Autocomplete slash command or file mention" },
+  { key: "Esc", description: "Close overlays, pickers, and transient input modes" },
+  { key: "? / F1", description: "Toggle help overlay" },
+  { key: "F2 / /shortcuts", description: "Open keyboard shortcut reference" },
+  { key: "/keybindings", description: "List configurable keybindings and config path" }
+];
 function readString51(value) {
   return typeof value === "string" ? value.trim() : "";
 }
@@ -879728,6 +879740,237 @@ function readLimit6(value, fallback) {
     return fallback;
   return Math.max(1, Math.min(500, Math.trunc(parsed)));
 }
+function readFieldMap(value) {
+  if (typeof value !== "object" || value === null || Array.isArray(value))
+    return {};
+  return Object.fromEntries(Object.entries(value).map(([key, entry]) => [key, typeof entry === "string" ? entry : String(entry)]));
+}
+function requireKeybindingsManager2(context) {
+  const manager5 = context.workspace.keybindingsManager;
+  if (!manager5)
+    throw new Error("workspace.keybindingsManager is unavailable in this Agent runtime");
+  return manager5;
+}
+function isKeyAction2(action2) {
+  return Object.hasOwn(ACTION_DESCRIPTIONS, action2);
+}
+function actionFromArgs(args2) {
+  const action2 = readString51(args2.actionId || args2.key || args2.query);
+  return action2 && isKeyAction2(action2) ? action2 : null;
+}
+function readBoolean15(value) {
+  if (typeof value === "boolean")
+    return value;
+  if (typeof value !== "string")
+    return;
+  const normalized = value.trim().toLowerCase();
+  if (["true", "yes", "y", "1", "on"].includes(normalized))
+    return true;
+  if (["false", "no", "n", "0", "off"].includes(normalized))
+    return false;
+  return;
+}
+function normalizeCombo(value) {
+  if (typeof value !== "object" || value === null || Array.isArray(value))
+    return null;
+  const raw = value;
+  const key = readString51(raw.key);
+  if (!key)
+    return null;
+  const combo = { key };
+  const ctrl = readBoolean15(raw.ctrl);
+  const shift = readBoolean15(raw.shift);
+  const alt = readBoolean15(raw.alt);
+  if (ctrl !== undefined)
+    combo.ctrl = ctrl;
+  if (shift !== undefined)
+    combo.shift = shift;
+  if (alt !== undefined)
+    combo.alt = alt;
+  return combo;
+}
+function parseComboLabel(value) {
+  const parts2 = value.split("+").map((part) => part.trim()).filter(Boolean);
+  if (parts2.length === 0)
+    return null;
+  const key = parts2.at(-1);
+  if (!key)
+    return null;
+  const combo = { key: key.length === 1 ? key.toLowerCase() : key.toLowerCase() };
+  for (const part of parts2.slice(0, -1)) {
+    const normalized = part.toLowerCase();
+    if (normalized === "ctrl" || normalized === "control")
+      combo.ctrl = true;
+    else if (normalized === "shift")
+      combo.shift = true;
+    else if (normalized === "alt" || normalized === "option")
+      combo.alt = true;
+    else
+      return null;
+  }
+  return combo;
+}
+function combosFromArgs(args2) {
+  if (Array.isArray(args2.combos)) {
+    const combos = args2.combos.map(normalizeCombo);
+    if (combos.every((combo2) => combo2 !== null))
+      return combos;
+    throw new Error("set_keybinding combos must be objects with key and optional boolean ctrl/shift/alt fields.");
+  }
+  const combo = normalizeCombo(args2.combo);
+  if (combo)
+    return [combo];
+  const fields = readFieldMap(args2.fields);
+  const fieldCombo = normalizeCombo(fields);
+  if (fieldCombo)
+    return [fieldCombo];
+  const labelCombo = parseComboLabel(readString51(args2.value));
+  if (labelCombo)
+    return [labelCombo];
+  throw new Error('set_keybinding requires combo, combos, fields.key, or a value such as "Ctrl+G".');
+}
+function comboFingerprint(combo) {
+  return `${combo.key}:${combo.ctrl ? 1 : 0}:${combo.shift ? 1 : 0}:${combo.alt ? 1 : 0}`;
+}
+function combosEqual(left, right) {
+  if (left.length !== right.length)
+    return false;
+  return left.every((combo, index) => comboFingerprint(combo) === comboFingerprint(right[index]));
+}
+function describeCombo(manager5, combo) {
+  return {
+    key: combo.key,
+    ctrl: combo.ctrl === true,
+    shift: combo.shift === true,
+    alt: combo.alt === true,
+    label: manager5.formatCombo(combo)
+  };
+}
+function bindingMatches(entry, query2) {
+  if (!query2)
+    return true;
+  const haystack = [
+    entry.action,
+    entry.description,
+    ...entry.combos.map((combo) => comboFingerprint(combo))
+  ].join(`
+`).toLowerCase();
+  return haystack.includes(query2.toLowerCase());
+}
+function describeBinding(manager5, action2, combos) {
+  const defaults3 = DEFAULT_KEYBINDINGS[action2];
+  const customized = !combosEqual(combos, defaults3);
+  return {
+    action: action2,
+    description: ACTION_DESCRIPTIONS[action2],
+    bindings: combos.map((combo) => describeCombo(manager5, combo)),
+    labels: combos.map((combo) => manager5.formatCombo(combo)),
+    defaultBindings: defaults3.map((combo) => describeCombo(manager5, combo)),
+    customized,
+    source: customized ? "custom" : "default"
+  };
+}
+function readOverrideFile(configPath) {
+  if (!existsSync82(configPath))
+    return {};
+  const parsed = JSON.parse(readFileSync89(configPath, "utf-8"));
+  if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
+    throw new Error(`Keybindings config ${configPath} must contain a JSON object.`);
+  }
+  return parsed;
+}
+function writeOverrideFile(configPath, overrides) {
+  mkdirSync67(dirname66(configPath), { recursive: true });
+  writeFileSync58(configPath, `${JSON.stringify(overrides, null, 2)}
+`, "utf-8");
+}
+function totalHarnessKeybindings(context) {
+  return context.workspace.keybindingsManager?.getAll().length ?? 0;
+}
+function totalHarnessShortcuts(context) {
+  return totalHarnessKeybindings(context) + FIXED_SHORTCUTS.length;
+}
+function listHarnessShortcuts(context, args2) {
+  const keybindings = listHarnessKeybindings(context, args2);
+  const query2 = readString51(args2.query).toLowerCase();
+  const fixed = FIXED_SHORTCUTS.filter((shortcut) => !query2 || `${shortcut.key}
+${shortcut.description}`.toLowerCase().includes(query2)).slice(0, readLimit6(args2.limit, 200)).map((shortcut) => ({ ...shortcut, source: "fixed", userEditable: false }));
+  return {
+    configPath: keybindings.configPath,
+    fixedShortcuts: fixed,
+    configurableKeybindings: keybindings.keybindings,
+    returned: fixed.length + Number(keybindings.returned ?? 0),
+    total: totalHarnessShortcuts(context),
+    policy: "Fixed shortcuts are runtime/editor controls. Configurable keybindings can be changed with set_keybinding/reset_keybinding."
+  };
+}
+function listHarnessKeybindings(context, args2) {
+  const manager5 = requireKeybindingsManager2(context);
+  const query2 = readString51(args2.query);
+  const entries = manager5.getAll().filter((entry) => bindingMatches(entry, query2)).slice(0, readLimit6(args2.limit, 200)).map((entry) => describeBinding(manager5, entry.action, entry.combos));
+  return {
+    configPath: manager5.getConfigPath(),
+    keybindings: entries,
+    returned: entries.length,
+    total: manager5.getAll().length,
+    policy: "Reads the live resolved keybindings. set_keybinding/reset_keybinding write the same keybindings.json file the user can edit and reload the runtime manager."
+  };
+}
+function describeHarnessKeybinding(context, args2) {
+  const manager5 = requireKeybindingsManager2(context);
+  const action2 = actionFromArgs(args2);
+  if (!action2)
+    return null;
+  const entry = manager5.getAll().find((candidate) => candidate.action === action2);
+  return entry ? {
+    configPath: manager5.getConfigPath(),
+    ...describeBinding(manager5, entry.action, entry.combos)
+  } : null;
+}
+function setHarnessKeybinding(context, args2) {
+  const manager5 = requireKeybindingsManager2(context);
+  const action2 = actionFromArgs(args2);
+  if (!action2)
+    throw new Error("set_keybinding requires a valid keybinding action id.");
+  const combos = combosFromArgs(args2);
+  const configPath = manager5.getConfigPath();
+  const overrides = readOverrideFile(configPath);
+  overrides[action2] = combos.length === 1 ? combos[0] : combos;
+  writeOverrideFile(configPath, overrides);
+  manager5.loadFromDisk();
+  return {
+    status: "updated",
+    configPath,
+    keybinding: describeHarnessKeybinding(context, { actionId: action2 })
+  };
+}
+function resetHarnessKeybinding(context, args2) {
+  const manager5 = requireKeybindingsManager2(context);
+  const action2 = actionFromArgs(args2);
+  if (!action2)
+    throw new Error("reset_keybinding requires a valid keybinding action id.");
+  const configPath = manager5.getConfigPath();
+  const overrides = readOverrideFile(configPath);
+  delete overrides[action2];
+  writeOverrideFile(configPath, overrides);
+  manager5.loadFromDisk();
+  return {
+    status: "reset",
+    configPath,
+    keybinding: describeHarnessKeybinding(context, { actionId: action2 })
+  };
+}
+
+// src/tools/agent-harness-panel-metadata.ts
+function readString52(value) {
+  return typeof value === "string" ? value.trim() : "";
+}
+function readLimit7(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 panelManager(context) {
   return context.workspace.panelManager ?? null;
 }
@@ -879777,16 +880020,16 @@ function listHarnessPanels(context, args2) {
   const manager5 = panelManager(context);
   if (!manager5)
     return [];
-  const query2 = readString51(args2.query);
-  const category = readString51(args2.category);
-  const limit3 = readLimit6(args2.limit, 200);
+  const query2 = readString52(args2.query);
+  const category = readString52(args2.category);
+  const limit3 = readLimit7(args2.limit, 200);
   return manager5.getRegisteredTypes().map((registration) => describePanelRegistration(context, registration)).filter((panel) => !category || panel.category === category).filter((panel) => panelMatches(panel, query2)).sort((a4, b3) => String(a4.id).localeCompare(String(b3.id))).slice(0, limit3);
 }
 function describeHarnessPanel(context, args2) {
   const manager5 = panelManager(context);
   if (!manager5)
     return null;
-  const panelId = readString51(args2.panelId || args2.query);
+  const panelId = readString52(args2.panelId || args2.query);
   if (!panelId)
     return null;
   const registration = manager5.getRegisteredTypes().find((panel) => panel.id === panelId || panel.name.toLowerCase() === panelId.toLowerCase());
@@ -879797,11 +880040,11 @@ function openHarnessPanel(context, args2) {
   if (!panel) {
     return {
       status: "unknown_panel",
-      panelId: readString51(args2.panelId || args2.query) || "<missing>",
+      panelId: readString52(args2.panelId || args2.query) || "<missing>",
       availablePanels: listHarnessPanels(context, { limit: 50 }).map((entry) => entry.id)
     };
   }
-  const requestedPane = readString51(args2.pane);
+  const requestedPane = readString52(args2.pane);
   const pane = requestedPane === "bottom" || requestedPane === "top" ? requestedPane : undefined;
   if (!context.showPanel) {
     return {
@@ -879826,10 +880069,10 @@ function output6(value) {
 function error51(message) {
   return { success: false, error: message };
 }
-function readString52(value) {
+function readString53(value) {
   return typeof value === "string" ? value.trim() : "";
 }
-function readFieldMap(value) {
+function readFieldMap2(value) {
   if (typeof value !== "object" || value === null || Array.isArray(value))
     return {};
   return Object.fromEntries(Object.entries(value).map(([key, entry]) => [key, typeof entry === "string" ? entry : String(entry)]));
@@ -879852,11 +880095,11 @@ function describeEditor(editor) {
   };
 }
 function readRecordId(args2) {
-  const fields = readFieldMap(args2.fields);
-  return readString52(args2.recordId ?? args2.id ?? fields.recordId ?? fields.id);
+  const fields = readFieldMap2(args2.fields);
+  return readString53(args2.recordId ?? args2.id ?? fields.recordId ?? fields.id);
 }
 function requireConfirmed(args2, label) {
-  if (!readString52(args2.explicitUserRequest))
+  if (!readString53(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.`;
@@ -879866,7 +880109,7 @@ function fieldReader(editor, fields) {
   return (id) => fields[id] ?? editor.fields.find((field) => field.id === id)?.value ?? "";
 }
 function hasExecutionFields(args2) {
-  return Object.keys(readFieldMap(args2.fields)).some((key) => key !== "id" && key !== "recordId");
+  return Object.keys(readFieldMap2(args2.fields)).some((key) => key !== "id" && key !== "recordId");
 }
 function missingRequiredFields(editor, fields) {
   const read = fieldReader(editor, fields);
@@ -879977,14 +880220,14 @@ function localRegistryArgsFromEditor(editor, fields, id) {
   return { domain: "routine", action: editor.mode === "update" ? "update" : "create", id, name: read("name"), description: read("description"), steps: read("steps"), tags: splitList5(read("tags")), triggers: splitList5(read("triggers")), requiresEnv: splitList5(read("requiresEnv")), requiresCommands: splitList5(read("requiresCommands")), enabled: isAffirmative15(read("enabled")), provenance: editor.recordId ? "agent-harness-local-operation" : "agent-harness-note-promotion" };
 }
 function localRegistryArgsForTarget(target, args2, recordId) {
-  const fields = readFieldMap(args2.fields);
+  const fields = readFieldMap2(args2.fields);
   const base2 = { domain: target.domain, action: target.action, ...recordId ? { id: recordId } : {} };
   const edit = target.action === "update" ? localRegistryArgsFromEditor({ kind: target.domain, mode: "update", recordId, title: "", selectedFieldIndex: 0, message: "", fields: [] }, fields, recordId) : {};
   return {
     ...base2,
     ...edit,
     ...target.action === "stale" && fields.reason ? { reason: fields.reason } : {},
-    ...target.action === "delete" ? { confirm: args2.confirm, explicitUserRequest: readString52(args2.explicitUserRequest) } : {}
+    ...target.action === "delete" ? { confirm: args2.confirm, explicitUserRequest: readString53(args2.explicitUserRequest) } : {}
   };
 }
 async function executeTool(toolRegistry, name51, toolArgs) {
@@ -880024,12 +880267,12 @@ async function runLocalWorkspaceAction(deps, action2, args2) {
   if (confirmationError2)
     return error51(confirmationError2);
   if (editor) {
-    const fields = readFieldMap(args2.fields);
+    const fields = readFieldMap2(args2.fields);
     const missing = missingRequiredFields(editor, fields);
     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: readString52(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: readString53(args2.explicitUserRequest) });
     return executeTool(deps.toolRegistry, "agent_local_registry", localRegistryArgsFromEditor(editor, fields, recordId));
   }
   if (!target)
@@ -880038,19 +880281,19 @@ async function runLocalWorkspaceAction(deps, action2, args2) {
 }
 
 // src/tools/agent-harness-model-tool-catalog.ts
-function readString53(value) {
+function readString54(value) {
   return typeof value === "string" ? value.trim() : "";
 }
-function readLimit7(value, fallback) {
+function readLimit8(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 listHarnessModelTools(toolRegistry, args2) {
-  const query2 = readString53(args2.query).toLowerCase();
+  const query2 = readString54(args2.query).toLowerCase();
   const includeParameters = args2.includeParameters === true;
-  const limit3 = readLimit7(args2.limit, 200);
+  const limit3 = readLimit8(args2.limit, 200);
   return toolRegistry.getToolDefinitions().filter((tool2) => !query2 || [tool2.name, tool2.description, ...tool2.sideEffects ?? []].join(`
 `).toLowerCase().includes(query2)).sort((a4, b3) => a4.name.localeCompare(b3.name)).slice(0, limit3).map((tool2) => ({
     name: tool2.name,
@@ -880063,14 +880306,22 @@ 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",
+  "set_keybinding",
+  "reset_keybinding",
   "commands",
   "command",
   "run_command",
@@ -880086,13 +880337,448 @@ var MODES = [
   "tools",
   "connected_host"
 ];
+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() : "";
+}
+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 = 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" && MODES.includes(value);
+  return typeof value === "string" && AGENT_HARNESS_MODES.includes(value);
 }
-function readString54(value) {
+function readString56(value) {
   return typeof value === "string" ? value.trim() : "";
 }
-function readLimit8(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;
@@ -880103,7 +880789,7 @@ function readStringArray12(value) {
     return [];
   return value.map((entry) => typeof entry === "string" ? entry : String(entry));
 }
-function readFieldMap2(value) {
+function readFieldMap3(value) {
   if (typeof value !== "object" || value === null || Array.isArray(value))
     return {};
   return Object.fromEntries(Object.entries(value).map(([key, entry]) => [key, typeof entry === "string" ? entry : String(entry)]));
@@ -880172,8 +880858,8 @@ function describeWorkspaceEditor(editor) {
   };
 }
 function selectedRoutineFromArgs(snapshot, args2) {
-  const fields = readFieldMap2(args2.fields);
-  const routineId = readString54(args2.recordId) || readString54(fields.routineId) || readString54(fields.id);
+  const fields = readFieldMap3(args2.fields);
+  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;
@@ -880241,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 = readString54(args2.query);
-  const categoryId = readString54(args2.categoryId || args2.category);
-  const limit3 = readLimit8(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 = readString54(args2.actionId || args2.query);
-  const categoryId = readString54(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) => {
@@ -880261,12 +880947,12 @@ function findWorkspaceAction(args2) {
   }) ?? null;
 }
 function listCommands(commandRegistry, args2) {
-  const query2 = readString54(args2.query);
-  const limit3 = readLimit8(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 = readString54(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)
@@ -880274,7 +880960,7 @@ function requireConfirmedAction(args2, action2) {
   return null;
 }
 function commandFromArgs(args2) {
-  const rawCommand = readString54(args2.command);
+  const rawCommand = readString56(args2.command);
   if (rawCommand) {
     const parsed = parseSlashCommand(rawCommand);
     if (!parsed.name)
@@ -880284,7 +880970,7 @@ function commandFromArgs(args2) {
       args: parsed.args
     };
   }
-  const commandName = readString54(args2.commandName).replace(/^\//, "");
+  const commandName = readString56(args2.commandName).replace(/^\//, "");
   if (!commandName)
     return null;
   const commandArgs = readStringArray12(args2.args);
@@ -880334,7 +881020,7 @@ function missingRequiredEditorFields(editor, fields) {
   return editor.fields.filter((field) => field.required && !readField(field.id).trim()).map((field) => field.id);
 }
 async function runWorkspaceEditorAction(deps, action2, editor, args2) {
-  const fields = readFieldMap2(args2.fields);
+  const fields = readFieldMap3(args2.fields);
   const missing = missingRequiredEditorFields(editor, fields);
   if (missing.length > 0) {
     return output7({
@@ -880472,106 +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, 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 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."
-          },
-          fields: {
-            type: "object",
-            additionalProperties: { type: "string" },
-            description: "Field values for run_workspace_action when the workspace action opens an editor form."
-          },
-          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
       },
@@ -880588,6 +881181,9 @@ 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,
             settings: deps.commandContext.platform.configManager.getSchema().length,
             workspaceCategories: AGENT_WORKSPACE_CATEGORIES.length,
@@ -880596,6 +881192,8 @@ 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".',
@@ -880630,7 +881228,7 @@ function createAgentHarnessTool(deps) {
         }
         if (args2.mode === "panel") {
           const panel = describeHarnessPanel(deps.commandContext, args2);
-          return panel ? output7(panel) : error52(`Unknown panel ${readString54(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");
@@ -880638,12 +881236,46 @@ 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 ${readString56(args2.actionId || args2.key || args2.query) || "<missing>"}.`);
+        }
+        if (args2.mode === "set_keybinding") {
+          const confirmationError2 = requireConfirmedAction(args2, "Keybinding mutation");
+          if (confirmationError2)
+            return error52(confirmationError2);
+          return output7(setHarnessKeybinding(deps.commandContext, args2));
+        }
+        if (args2.mode === "reset_keybinding") {
+          const confirmationError2 = requireConfirmedAction(args2, "Keybinding reset");
+          if (confirmationError2)
+            return error52(confirmationError2);
+          return output7(resetHarnessKeybinding(deps.commandContext, args2));
+        }
         if (args2.mode === "commands") {
           const commands3 = listCommands(deps.commandRegistry, args2);
           return output7({ commands: commands3, returned: commands3.length, total: deps.commandRegistry.list().length });
         }
         if (args2.mode === "command") {
-          const name51 = readString54(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>"}.`);
         }
@@ -880651,16 +881283,16 @@ function createAgentHarnessTool(deps) {
           return runCommand2(deps, args2);
         if (args2.mode === "settings") {
           const settings = listHarnessSettings(deps.commandContext.platform.configManager, {
-            category: readString54(args2.category) || undefined,
-            prefix: readString54(args2.prefix) || undefined,
-            query: readString54(args2.query) || undefined,
+            category: readString56(args2.category) || undefined,
+            prefix: readString56(args2.prefix) || undefined,
+            query: readString56(args2.query) || undefined,
             includeHidden: args2.includeHidden === true,
-            limit: readLimit8(args2.limit, 100)
+            limit: readLimit10(args2.limit, 100)
           });
           return output7({ settings, returned: settings.length, policy: settingsPolicySummary() });
         }
         if (args2.mode === "get_setting") {
-          const key = readString54(args2.key);
+          const key = readString56(args2.key);
           const setting = getHarnessSetting(deps.commandContext.platform.configManager, key);
           return setting ? output7(setting) : error52(`Unknown setting ${key || "<missing>"}.`);
         }
@@ -880670,7 +881302,7 @@ function createAgentHarnessTool(deps) {
             return error52(confirmationError2);
           if (args2.value === undefined)
             return error52("set_setting requires value.");
-          const key = readString54(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);
         }
@@ -880678,7 +881310,7 @@ function createAgentHarnessTool(deps) {
           const confirmationError2 = requireConfirmedAction(args2, "Setting reset");
           if (confirmationError2)
             return error52(confirmationError2);
-          const key = readString54(args2.key);
+          const key = readString56(args2.key);
           const result2 = await resetHarnessSetting(deps.commandContext.platform.configManager, deps.commandContext.platform.secretsManager, key);
           return output7(result2);
         }
@@ -880695,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 ${readString54(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);
@@ -882518,7 +883150,7 @@ function mergeFeatureFlagConfigValue(config6, key, value) {
 
 // src/runtime/onboarding/verify.ts
 init_config8();
-import { existsSync as existsSync82 } from "fs";
+import { existsSync as existsSync83 } from "fs";
 import { join as join98 } from "path";
 function getNow(deps) {
   return deps.clock?.() ?? Date.now();
@@ -882600,7 +883232,7 @@ function verifyAuthOperation(_deps, operation) {
 }
 function verifyCreateAgentProfileOperation(deps, operation) {
   const resolution2 = resolveAgentRuntimeProfileHome(deps.shellPaths.homeDirectory, operation.name);
-  const ok3 = existsSync82(join98(resolution2.homeDirectory, "profile.json"));
+  const ok3 = existsSync83(join98(resolution2.homeDirectory, "profile.json"));
   return {
     id: `agent-profile:${resolution2.id}`,
     status: ok3 ? "pass" : "fail",
@@ -882698,22 +883330,22 @@ async function verifyOnboardingRequest(deps, request2) {
 }
 
 // src/runtime/onboarding/apply-file-helpers.ts
-import { existsSync as existsSync83, mkdirSync as mkdirSync67, readFileSync as readFileSync89, unlinkSync as unlinkSync11, writeFileSync as writeFileSync58 } from "fs";
-import { dirname as dirname66 } from "path";
+import { existsSync as existsSync84, mkdirSync as mkdirSync68, readFileSync as readFileSync90, 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 (!existsSync83(path7))
+  if (!existsSync84(path7))
     return {};
-  const parsed = JSON.parse(readFileSync89(path7, "utf-8"));
+  const parsed = JSON.parse(readFileSync90(path7, "utf-8"));
   if (!isPlainObject3(parsed))
     throw new Error(`Expected an object JSON payload at ${path7}.`);
   return parsed;
 }
 function writeJsonObject(path7, payload) {
-  mkdirSync67(dirname66(path7), { recursive: true });
-  writeFileSync58(path7, `${JSON.stringify(payload, null, 2)}
+  mkdirSync68(dirname67(path7), { recursive: true });
+  writeFileSync59(path7, `${JSON.stringify(payload, null, 2)}
 `, "utf-8");
 }
 function setNestedValue(root, key, value) {
@@ -882734,16 +883366,16 @@ function setNestedValue(root, key, value) {
 }
 function restoreFile(path7, previous, reload) {
   if (previous === null) {
-    if (existsSync83(path7))
+    if (existsSync84(path7))
       unlinkSync11(path7);
   } else {
-    mkdirSync67(dirname66(path7), { recursive: true });
-    writeFileSync58(path7, previous, "utf-8");
+    mkdirSync68(dirname67(path7), { recursive: true });
+    writeFileSync59(path7, previous, "utf-8");
   }
   reload?.();
 }
 function snapshotFileRollback(path7, reload) {
-  const previous = existsSync83(path7) ? readFileSync89(path7, "utf-8") : null;
+  const previous = existsSync84(path7) ? readFileSync90(path7, "utf-8") : null;
   return () => restoreFile(path7, previous, reload);
 }
 async function runRollbacks(rollbacks) {
@@ -882862,7 +883494,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 (existsSync84(resolution2.homeDirectory)) {
+  if (existsSync85(resolution2.homeDirectory)) {
     throw new Error(`Agent profile already exists: ${resolution2.id}`);
   }
   const templateId = operation.templateId?.trim();
@@ -882874,7 +883506,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 (!existsSync84(resolution2.homeDirectory)) {
+  if (!existsSync85(resolution2.homeDirectory)) {
     throw new Error(`Agent profile does not exist: ${resolution2.id}`);
   }
 }
@@ -882982,7 +883614,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: existsSync84(location.path) ? readFileSync90(location.path, "utf-8") : null
+    previous: existsSync85(location.path) ? readFileSync91(location.path, "utf-8") : null
   }));
   return () => {
     for (const snapshot of snapshots)
@@ -883016,7 +883648,7 @@ async function buildRollbackAction(deps, operation) {
   if (operation.kind === "create-agent-profile") {
     const resolution2 = resolveAgentRuntimeProfileHome(deps.shellPaths.homeDirectory, operation.name);
     return () => {
-      if (existsSync84(resolution2.homeDirectory))
+      if (existsSync85(resolution2.homeDirectory))
         rmSync10(resolution2.homeDirectory, { recursive: true, force: true });
     };
   }
@@ -883352,8 +883984,8 @@ async function applyOnboardingRequest(deps, request2) {
   };
 }
 // src/runtime/onboarding/markers.ts
-import { existsSync as existsSync85, mkdirSync as mkdirSync68, readFileSync as readFileSync91, writeFileSync as writeFileSync59 } from "fs";
-import { dirname as dirname67 } from "path";
+import { existsSync as existsSync86, mkdirSync as mkdirSync69, readFileSync as readFileSync92, writeFileSync as writeFileSync60 } from "fs";
+import { dirname as dirname68 } from "path";
 var ONBOARDING_CHECK_MARKER_FILE = "onboarding-checked.json";
 function resolveMarkerPath(shellPaths3, scope) {
   return scope === "project" ? shellPaths3.resolveProjectPath(GOODVIBES_AGENT_SURFACE_ROOT, ONBOARDING_CHECK_MARKER_FILE) : shellPaths3.resolveUserPath(GOODVIBES_AGENT_SURFACE_ROOT, ONBOARDING_CHECK_MARKER_FILE);
@@ -883396,10 +884028,10 @@ function getOnboardingCheckMarkerPath(shellPaths3, scope = "user") {
 }
 function readOnboardingCheckMarker(shellPaths3, scope = "user") {
   const path7 = resolveMarkerPath(shellPaths3, scope);
-  if (!existsSync85(path7))
+  if (!existsSync86(path7))
     return buildMissingMarkerState(scope, path7);
   try {
-    const parsed = JSON.parse(readFileSync91(path7, "utf-8"));
+    const parsed = JSON.parse(readFileSync92(path7, "utf-8"));
     if (!isCheckMarkerPayload(parsed)) {
       return buildParseErrorState(scope, path7, "Invalid onboarding check marker payload.");
     }
@@ -883435,13 +884067,13 @@ function writeOnboardingCheckMarker(shellPaths3, options = {}) {
     ...options.mode ? { mode: options.mode } : {},
     ...options.workspaceRoot ? { workspaceRoot: options.workspaceRoot } : {}
   };
-  mkdirSync68(dirname67(path7), { recursive: true });
-  writeFileSync59(path7, `${JSON.stringify(payload, null, 2)}
+  mkdirSync69(dirname68(path7), { recursive: true });
+  writeFileSync60(path7, `${JSON.stringify(payload, null, 2)}
 `, "utf-8");
   return readOnboardingCheckMarker(shellPaths3, scope);
 }
 // src/input/handler-content-actions.ts
-import { existsSync as existsSync86, lstatSync as lstatSync3, readFileSync as readFileSync92, readdirSync as readdirSync22 } from "fs";
+import { existsSync as existsSync87, lstatSync as lstatSync3, readFileSync as readFileSync93, readdirSync as readdirSync22 } from "fs";
 import { basename as basename6, relative as relative15 } from "path";
 var MARKER_REGEX = /\[(TEXT|IMAGE): [^\]]+\]/g;
 var IMAGE_PREFIXES = [
@@ -883501,7 +884133,7 @@ function readContextFileBlock(reference, projectRoot) {
     logger.debug("expandPrompt: context reference rejected", { reference, error: summarizeError(error53) });
     return null;
   }
-  if (!existsSync86(resolvedPath3))
+  if (!existsSync87(resolvedPath3))
     return null;
   const stat6 = lstatSync3(resolvedPath3);
   const label = escapeContextAttribute(relative15(projectRoot, resolvedPath3) || basename6(resolvedPath3));
@@ -883520,14 +884152,14 @@ function readContextFileBlock(reference, projectRoot) {
   if (stat6.size > MAX_CONTEXT_FILE_BYTES) {
     return [
       `<context-file path="${label}" truncated="true" bytes="${stat6.size}">`,
-      readFileSync92(resolvedPath3, "utf-8").slice(0, MAX_CONTEXT_FILE_BYTES),
+      readFileSync93(resolvedPath3, "utf-8").slice(0, MAX_CONTEXT_FILE_BYTES),
       "</context-file>"
     ].join(`
 `);
   }
   return [
     `<context-file path="${label}" bytes="${stat6.size}">`,
-    readFileSync92(resolvedPath3, "utf-8"),
+    readFileSync93(resolvedPath3, "utf-8"),
     "</context-file>"
   ].join(`
 `);
@@ -883584,8 +884216,8 @@ function registerPaste(state4, content, projectRoot) {
   if (IMAGE_EXTENSIONS2.some((ext) => trimmed2.toLowerCase().endsWith(ext))) {
     try {
       const resolvedPath3 = resolveAndValidatePath(trimmed2, projectRoot);
-      if (existsSync86(resolvedPath3)) {
-        const data = readFileSync92(resolvedPath3);
+      if (existsSync87(resolvedPath3)) {
+        const data = readFileSync93(resolvedPath3);
         const base644 = data.toString("base64");
         const ext = trimmed2.slice(trimmed2.lastIndexOf("."));
         const mediaType = mediaTypeFromExt(ext);
@@ -883635,7 +884267,7 @@ function expandPrompt(pasteRegistry, imageRegistry, text, projectRoot) {
     const filePath = injectMatch[1];
     try {
       const resolvedPath3 = resolveAndValidatePath(filePath, projectRoot);
-      const content = readFileSync92(resolvedPath3, "utf-8");
+      const content = readFileSync93(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) {
@@ -892908,7 +893540,7 @@ function handleProfilePickerToken(state4, token) {
 }
 
 // src/input/handler-picker-routes.ts
-import { readFileSync as readFileSync93 } from "fs";
+import { readFileSync as readFileSync94 } from "fs";
 
 // src/renderer/model-picker-overlay.ts
 var MODEL_PICKER_CHROME_LINES = 7;
@@ -893200,7 +893832,7 @@ function handleFilePickerToken(state4, token) {
               throw new Error("working directory is unavailable");
             }
             const resolvedPath3 = resolveAndValidatePath(selected, projectRoot);
-            const data = readFileSync93(resolvedPath3);
+            const data = readFileSync94(resolvedPath3);
             const base644 = data.toString("base64");
             const mediaType = state4.mediaTypeFromExt(ext);
             const filename = selected.split("/").pop() ?? selected;
@@ -898914,7 +899546,7 @@ function wireShellUiOpeners(options) {
 }
 
 // src/cli/entrypoint.ts
-import { existsSync as existsSync88 } from "fs";
+import { existsSync as existsSync89 } from "fs";
 import { join as join101 } from "path";
 // src/cli/status.ts
 function yesNo3(value) {
@@ -899160,12 +899792,12 @@ function renderOnboardingCliStatus(options) {
 `);
 }
 // src/cli/external-runtime.ts
-import { existsSync as existsSync87, readFileSync as readFileSync94 } from "fs";
+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 readString55(record2, key) {
+function readString57(record2, key) {
   const value = record2?.[key];
   return typeof value === "string" ? value : null;
 }
@@ -899176,10 +899808,10 @@ function resolveBaseUrl2(configManager) {
 }
 function readOperatorToken2(homeDirectory) {
   const path7 = join100(homeDirectory, ".goodvibes", "daemon", "operator-tokens.json");
-  if (!existsSync87(path7))
+  if (!existsSync88(path7))
     return { token: null, path: path7 };
   try {
-    const parsed = JSON.parse(readFileSync94(path7, "utf-8"));
+    const parsed = JSON.parse(readFileSync95(path7, "utf-8"));
     const token = isRecord43(parsed) && typeof parsed.token === "string" ? parsed.token : null;
     return { token, path: path7 };
   } catch {
@@ -899216,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 = readString55(statusRecord, "version") ?? "unknown";
+    const version6 = readString57(statusRecord, "version") ?? "unknown";
     const compatible = status.ok && version6 === SDK_VERSION;
     if (!status.ok) {
       return {
@@ -899671,11 +900303,11 @@ async function prepareShellCliRuntime(argv, roots, binary2 = "goodvibes-agent")
       onboardingMarkers,
       auth: {
         userStorePath,
-        userStorePresent: existsSync88(userStorePath),
+        userStorePresent: existsSync89(userStorePath),
         bootstrapCredentialPath,
-        bootstrapCredentialPresent: existsSync88(bootstrapCredentialPath),
+        bootstrapCredentialPresent: existsSync89(bootstrapCredentialPath),
         operatorTokenPath,
-        operatorTokenPresent: existsSync88(operatorTokenPath)
+        operatorTokenPresent: existsSync89(operatorTokenPath)
       },
       service,
       externalRuntime,