@pellux/goodvibes-agent 1.0.3 → 1.0.4

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.4";
 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";
@@ -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,
@@ -880071,6 +880314,11 @@ var MODES = [
   "panels",
   "panel",
   "open_panel",
+  "shortcuts",
+  "keybindings",
+  "keybinding",
+  "set_keybinding",
+  "reset_keybinding",
   "commands",
   "command",
   "run_command",
@@ -880089,10 +880337,10 @@ var MODES = [
 function isMode(value) {
   return typeof value === "string" && MODES.includes(value);
 }
-function readString54(value) {
+function readString55(value) {
   return typeof value === "string" ? value.trim() : "";
 }
-function readLimit8(value, fallback) {
+function readLimit9(value, fallback) {
   const parsed = typeof value === "string" && value.trim() ? Number(value) : value;
   if (typeof parsed !== "number" || !Number.isFinite(parsed))
     return fallback;
@@ -880103,7 +880351,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)]));
@@ -880117,6 +880365,12 @@ 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;
@@ -880172,8 +880426,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 = readString55(args2.recordId) || readString55(fields.routineId) || readString55(fields.id);
   if (!routineId)
     return null;
   return snapshot.localRoutines.find((routine) => routine.id === routineId || routine.name.toLowerCase() === routineId.toLowerCase()) ?? null;
@@ -880241,17 +880495,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 = readString55(args2.query);
+  const categoryId = readString55(args2.categoryId || args2.category);
+  const limit3 = readLimit9(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 = readString55(args2.actionId || args2.query);
+  const categoryId = readString55(args2.categoryId || args2.category);
   if (!actionId)
     return null;
   return allWorkspaceActions().find((entry) => {
@@ -880261,12 +880515,12 @@ function findWorkspaceAction(args2) {
   }) ?? null;
 }
 function listCommands(commandRegistry, args2) {
-  const query2 = readString54(args2.query);
-  const limit3 = readLimit8(args2.limit, 200);
+  const query2 = readString55(args2.query);
+  const limit3 = readLimit9(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 = readString55(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 +880528,7 @@ function requireConfirmedAction(args2, action2) {
   return null;
 }
 function commandFromArgs(args2) {
-  const rawCommand = readString54(args2.command);
+  const rawCommand = readString55(args2.command);
   if (rawCommand) {
     const parsed = parseSlashCommand(rawCommand);
     if (!parsed.name)
@@ -880284,7 +880538,7 @@ function commandFromArgs(args2) {
       args: parsed.args
     };
   }
-  const commandName = readString54(args2.commandName).replace(/^\//, "");
+  const commandName = readString55(args2.commandName).replace(/^\//, "");
   if (!commandName)
     return null;
   const commandArgs = readStringArray12(args2.args);
@@ -880334,7 +880588,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,8 +880726,8 @@ 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, 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.",
         "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: {
@@ -880515,13 +880769,22 @@ function createAgentHarnessTool(deps) {
           },
           actionId: {
             type: "string",
-            description: "Agent workspace action id for workspace_action or run_workspace_action."
+            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."
@@ -880588,6 +880851,8 @@ function createAgentHarnessTool(deps) {
             cliCommands: totalHarnessCliCommands(),
             blockedCliCommandTokens: blockedHarnessCliCommandTokens(),
             panels: totalHarnessPanels(deps.commandContext),
+            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 +880861,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.',
+              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 +880896,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 ${readString55(args2.panelId || args2.query) || "<missing>"}.`);
         }
         if (args2.mode === "open_panel") {
           const confirmationError2 = requireConfirmedAction(args2, "Panel routing");
@@ -880638,12 +880904,32 @@ function createAgentHarnessTool(deps) {
             return error52(confirmationError2);
           return output7(openHarnessPanel(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>"}.`);
+        }
+        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 = readString55(args2.commandName).replace(/^\//, "");
           const command8 = name51 ? deps.commandRegistry.get(name51) : null;
           return command8 ? output7(describeCommand(command8)) : error52(`Unknown slash command /${name51 || "<missing>"}.`);
         }
@@ -880651,16 +880937,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: readString55(args2.category) || undefined,
+            prefix: readString55(args2.prefix) || undefined,
+            query: readString55(args2.query) || undefined,
             includeHidden: args2.includeHidden === true,
-            limit: readLimit8(args2.limit, 100)
+            limit: readLimit9(args2.limit, 100)
           });
           return output7({ settings, returned: settings.length, policy: settingsPolicySummary() });
         }
         if (args2.mode === "get_setting") {
-          const key = readString54(args2.key);
+          const key = readString55(args2.key);
           const setting = getHarnessSetting(deps.commandContext.platform.configManager, key);
           return setting ? output7(setting) : error52(`Unknown setting ${key || "<missing>"}.`);
         }
@@ -880670,7 +880956,7 @@ function createAgentHarnessTool(deps) {
             return error52(confirmationError2);
           if (args2.value === undefined)
             return error52("set_setting requires value.");
-          const key = readString54(args2.key);
+          const key = readString55(args2.key);
           const result2 = await setHarnessSetting(deps.commandContext.platform.configManager, deps.commandContext.platform.secretsManager, key, args2.value);
           return output7(result2);
         }
@@ -880678,7 +880964,7 @@ function createAgentHarnessTool(deps) {
           const confirmationError2 = requireConfirmedAction(args2, "Setting reset");
           if (confirmationError2)
             return error52(confirmationError2);
-          const key = readString54(args2.key);
+          const key = readString55(args2.key);
           const result2 = await resetHarnessSetting(deps.commandContext.platform.configManager, deps.commandContext.platform.secretsManager, key);
           return output7(result2);
         }
@@ -880695,7 +880981,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 ${readString55(args2.actionId || args2.query) || "<missing>"}.`);
         }
         if (args2.mode === "run_workspace_action")
           return runWorkspaceAction(deps, args2);
@@ -882518,7 +882804,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 +882886,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 +882984,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 +883020,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 +883148,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 +883160,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 +883268,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 +883302,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 +883638,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 +883682,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 +883721,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 +883787,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 +883806,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 +883870,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 +883921,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 +893194,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 +893486,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 +899200,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 +899446,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 readString56(record2, key) {
   const value = record2?.[key];
   return typeof value === "string" ? value : null;
 }
@@ -899176,10 +899462,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 +899502,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 = readString56(statusRecord, "version") ?? "unknown";
     const compatible = status.ok && version6 === SDK_VERSION;
     if (!status.ok) {
       return {
@@ -899671,11 +899957,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,