@pellux/goodvibes-agent 1.0.17 → 1.0.19

package/dist/package/main.js

@@ -816508,7 +816508,7 @@ var createStyledCell = (char, overrides = {}) => ({
 // src/version.ts
 import { readFileSync } from "fs";
 import { join } from "path";
-var _version = "1.0.17";
+var _version = "1.0.19";
 var _sdkVersion = "0.33.35";
 try {
   const pkg = JSON.parse(readFileSync(join(import.meta.dir, "..", "package.json"), "utf-8"));
@@ -847717,13 +847717,13 @@ init_state3();
 
 // src/input/commands/recall-shared.ts
 var VALID_CLASSES = ["decision", "constraint", "incident", "pattern", "fact", "risk", "runbook", "architecture", "ownership"];
-var VALID_SCOPES2 = ["session", "project", "team"];
+var VALID_SCOPES = ["session", "project", "team"];
 var VALID_REVIEW_STATES = ["fresh", "reviewed", "stale", "contradicted"];
 function isValidClass(s4) {
   return VALID_CLASSES.includes(s4);
 }
 function isValidScope(s4) {
-  return VALID_SCOPES2.includes(s4);
+  return VALID_SCOPES.includes(s4);
 }
 function isValidReviewState(s4) {
   return VALID_REVIEW_STATES.includes(s4);
@@ -847766,7 +847766,7 @@ function handleRecallSearch(args2, context) {
     if (isValidScope(scope))
       filter.scope = scope;
     else {
-      context.print(`[memory] Unknown scope "${scope}". Valid values ${VALID_SCOPES2.join(", ")}.`);
+      context.print(`[memory] Unknown scope "${scope}". Valid values ${VALID_SCOPES.join(", ")}.`);
       return;
     }
   }
@@ -847941,7 +847941,7 @@ function handleRecallList(args2, context) {
   if (scopeIdx !== -1 && args2[scopeIdx + 1]) {
     const scope = args2[scopeIdx + 1];
     if (!isValidScope(scope)) {
-      context.print(`[memory] Unknown scope "${scope}". Valid values ${VALID_SCOPES2.join(", ")}.`);
+      context.print(`[memory] Unknown scope "${scope}". Valid values ${VALID_SCOPES.join(", ")}.`);
       return;
     }
     filter.scope = scope;
@@ -847991,7 +847991,7 @@ async function handleRecallAdd(args2, context) {
   const tags = tagsRaw ? tagsRaw.split(",").map((token) => token.trim()).filter(Boolean) : [];
   const scope = scopeRaw && isValidScope(scopeRaw) ? scopeRaw : "project";
   if (scopeRaw && !isValidScope(scopeRaw)) {
-    context.print(`[memory] Invalid scope "${scopeRaw}". Valid values ${VALID_SCOPES2.join(", ")}.`);
+    context.print(`[memory] Invalid scope "${scopeRaw}". Valid values ${VALID_SCOPES.join(", ")}.`);
     return;
   }
   const provenance = [];
@@ -848125,7 +848125,7 @@ function handleRecallExport(args2, context) {
   if (scopeIdx !== -1 && commandArgs[scopeIdx + 1]) {
     const scope = commandArgs[scopeIdx + 1];
     if (!isValidScope(scope)) {
-      context.print(`[memory] Unknown scope "${scope}". Valid values ${VALID_SCOPES2.join(", ")}.`);
+      context.print(`[memory] Unknown scope "${scope}". Valid values ${VALID_SCOPES.join(", ")}.`);
       return;
     }
     filter.scope = scope;
@@ -848204,7 +848204,7 @@ function handleRecallHandoffExport(args2, context) {
   const scopeIdx = commandArgs.indexOf("--scope");
   const scopeRaw = scopeIdx !== -1 ? commandArgs[scopeIdx + 1] : "team";
   if (!scopeRaw || !isValidScope(scopeRaw)) {
-    context.print(`[memory] Unknown scope "${scopeRaw ?? ""}". Valid values ${VALID_SCOPES2.join(", ")}.`);
+    context.print(`[memory] Unknown scope "${scopeRaw ?? ""}". Valid values ${VALID_SCOPES.join(", ")}.`);
     return;
   }
   const bundle = memory.exportBundle({ scope: scopeRaw });
@@ -848320,7 +848320,7 @@ function handleRecallPromote(args2, context) {
   const id = parsed.rest[0];
   const scope = parsed.rest[1];
   if (!id || !scope || !isValidScope(scope)) {
-    context.print(`[memory] Usage: /memory promote <id> <${VALID_SCOPES2.join("|")}> --yes`);
+    context.print(`[memory] Usage: /memory promote <id> <${VALID_SCOPES.join("|")}> --yes`);
     return;
   }
   if (!parsed.yes) {
@@ -862253,7 +862253,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_SCOPES4 = ["session", "project", "team"];
+var VALID_SCOPES3 = ["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([
@@ -862353,7 +862353,7 @@ function isMemoryClass2(value) {
   return VALID_CLASSES2.includes(value);
 }
 function isMemoryScope2(value) {
-  return VALID_SCOPES4.includes(value);
+  return VALID_SCOPES3.includes(value);
 }
 function isReviewState(value) {
   return VALID_REVIEW_STATES3.includes(value);
@@ -862368,7 +862368,7 @@ function requireClass(value) {
 }
 function requireScope(value) {
   if (!value || !isMemoryScope2(value))
-    throw new Error(`Invalid memory scope "${value ?? ""}". Valid values ${VALID_SCOPES4.join(", ")}`);
+    throw new Error(`Invalid memory scope "${value ?? ""}". Valid values ${VALID_SCOPES3.join(", ")}`);
   return value;
 }
 function optionalScope(value) {
@@ -879744,6 +879744,9 @@ function readLimit5(value, fallback) {
     return fallback;
   return Math.max(1, Math.min(500, Math.trunc(parsed)));
 }
+function redactCliLookupInput(input) {
+  return input.replace(/(--config=)([^=\s]+)=\S+/g, "$1$2=<redacted>").replace(/(--config\s+)([^=\s]+)=\S+/g, "$1$2=<redacted>");
+}
 function cliCommandTokens(command8) {
   if (command8 === "unknown")
     return [];
@@ -879760,13 +879763,14 @@ function fallbackCliSummary(command8) {
     return "Print the installed Agent package version.";
   return "Inspect the CLI help for this Agent package command.";
 }
-function describeCliCommand(command8) {
+function describeCliCommand(command8, lookup) {
   const help = describeGoodVibesCommandHelp(command8);
   const tokens = cliCommandTokens(command8);
   return {
     name: command8,
     tokens,
     invocation: command8 === "tui" ? "goodvibes-agent" : `goodvibes-agent ${tokens[0] ?? command8}`,
+    ...lookup ? { lookup } : {},
     helpTopic: help?.command ?? command8,
     summary: help?.summary ?? fallbackCliSummary(command8),
     usage: help?.usage ?? (command8 === "tui" ? ["goodvibes-agent [OPTIONS]"] : [`goodvibes-agent ${command8} [ARGS]`]),
@@ -879791,6 +879795,14 @@ function cliCommandMatches(command8, query2) {
   ].map((value) => JSON.stringify(value)).join(`
 `).toLowerCase().includes(query2.toLowerCase());
 }
+function cliCommandCandidate(command8) {
+  return {
+    name: command8.name,
+    tokens: command8.tokens,
+    invocation: command8.invocation,
+    summary: command8.summary
+  };
+}
 function totalHarnessCliCommands() {
   return listGoodVibesCliCommands().filter((command8) => command8 !== "unknown").length;
 }
@@ -879800,23 +879812,60 @@ function blockedHarnessCliCommandTokens() {
 function listHarnessCliCommands(args2) {
   const query2 = readString50(args2.query);
   const limit3 = readLimit5(args2.limit, 200);
-  return listGoodVibesCliCommands().filter((command8) => command8 !== "unknown").map(describeCliCommand).filter((command8) => cliCommandMatches(command8, query2)).sort((a4, b3) => String(a4.name).localeCompare(String(b3.name))).slice(0, limit3);
+  return listGoodVibesCliCommands().filter((command8) => command8 !== "unknown").map((command8) => describeCliCommand(command8)).filter((command8) => cliCommandMatches(command8, query2)).sort((a4, b3) => String(a4.name).localeCompare(String(b3.name))).slice(0, limit3);
 }
-function cliTokensFromArgs(args2) {
-  const raw = readString50(args2.cliCommand) || readString50(args2.command) || readString50(args2.commandName) || readString50(args2.query);
-  if (!raw)
-    return [];
+function cliInputFromArgs(args2) {
+  const cliCommand = readString50(args2.cliCommand);
+  if (cliCommand)
+    return { source: "cliCommand", input: cliCommand };
+  const command8 = readString50(args2.command);
+  if (command8)
+    return { source: "command", input: command8 };
+  const commandName = readString50(args2.commandName);
+  if (commandName)
+    return { source: "commandName", input: commandName };
+  const target = readString50(args2.target);
+  if (target)
+    return { source: "target", input: target };
+  const query2 = readString50(args2.query);
+  if (query2)
+    return { source: "query", input: query2 };
+  return null;
+}
+function cliTokensFromRaw(raw) {
   const tokens = raw.split(/\s+/).filter((token) => token.length > 0);
   if (tokens[0] === "goodvibes-agent" || tokens[0]?.endsWith("/goodvibes-agent"))
     return tokens.slice(1);
   return tokens;
 }
+function isConcreteCliSource(source) {
+  return source === "cliCommand" || source === "command" || source === "commandName";
+}
 function describeHarnessCliCommand(args2) {
-  const tokens = cliTokensFromArgs(args2);
-  if (tokens.length === 0)
-    return describeCliCommand("tui");
+  const input = cliInputFromArgs(args2);
+  if (!input)
+    return describeCliCommand("tui", { source: "default", input: "", resolvedBy: "default" });
+  const lookupInput = redactCliLookupInput(input.input);
+  const tokens = cliTokensFromRaw(input.input);
   const parsed = parseGoodVibesCli(tokens);
-  if (parsed.command === "unknown") {
+  const directInvocation = parsed.command !== "unknown" && (isConcreteCliSource(input.source) || String(parsed.rawCommand ?? "").toLowerCase() === String(tokens[0] ?? "").toLowerCase());
+  if (!directInvocation) {
+    const matches = listGoodVibesCliCommands().filter((command8) => command8 !== "unknown").map((command8) => describeCliCommand(command8)).filter((command8) => cliCommandMatches(command8, input.input)).sort((a4, b3) => String(a4.name).localeCompare(String(b3.name)));
+    if (matches.length === 1) {
+      return {
+        ...matches[0],
+        lookup: { source: input.source, input: lookupInput, resolvedBy: "search" }
+      };
+    }
+    if (matches.length > 1) {
+      return {
+        supported: false,
+        status: "ambiguous",
+        input: lookupInput,
+        candidates: matches.map(cliCommandCandidate).slice(0, 8),
+        note: "Multiple top-level CLI mirrors matched this lookup. Provide cliCommand or commandName with one concrete command token."
+      };
+    }
     return {
       supported: false,
       token: parsed.rawCommand ?? tokens[0],
@@ -879826,7 +879875,7 @@ function describeHarnessCliCommand(args2) {
     };
   }
   return {
-    ...describeCliCommand(parsed.command),
+    ...describeCliCommand(parsed.command, { source: input.source, input: lookupInput, resolvedBy: "invocation" }),
     parsed: {
       command: parsed.command,
       rawCommand: parsed.rawCommand,
@@ -880020,10 +880069,6 @@ function requireKeybindingsManager2(context) {
 function isKeyAction2(action2) {
   return Object.hasOwn(ACTION_DESCRIPTIONS, action2);
 }
-function actionFromArgs(args2) {
-  const action2 = readString52(args2.actionId || args2.key || args2.query);
-  return action2 && isKeyAction2(action2) ? action2 : null;
-}
 function readBoolean15(value) {
   if (typeof value === "boolean")
     return value;
@@ -880112,23 +880157,70 @@ function describeCombo(manager5, combo) {
     label: manager5.formatCombo(combo)
   };
 }
-function bindingMatches(entry, query2) {
-  if (!query2)
-    return true;
-  const haystack = [
+function keybindingLookupFromArgs(args2) {
+  const actionId = readString52(args2.actionId);
+  if (actionId)
+    return { source: "actionId", input: actionId };
+  const target = readString52(args2.target);
+  if (target)
+    return { source: "target", input: target };
+  const key = readString52(args2.key);
+  if (key)
+    return { source: "key", input: key };
+  const query2 = readString52(args2.query);
+  if (query2)
+    return { source: "query", input: query2 };
+  return null;
+}
+function bindingSearchText(manager5, entry) {
+  return [
     entry.action,
     entry.description,
-    ...entry.combos.map((combo) => comboFingerprint(combo))
+    ...entry.combos.map((combo) => comboFingerprint(combo)),
+    ...entry.combos.map((combo) => manager5.formatCombo(combo))
   ].join(`
 `).toLowerCase();
-  return haystack.includes(query2.toLowerCase());
 }
-function describeBinding(manager5, action2, combos) {
+function bindingCandidate(manager5, entry) {
+  return {
+    action: entry.action,
+    description: entry.description,
+    labels: entry.combos.map((combo) => manager5.formatCombo(combo))
+  };
+}
+function bindingMatches(manager5, entry, query2) {
+  if (!query2)
+    return true;
+  return bindingSearchText(manager5, entry).includes(query2.toLowerCase());
+}
+function resolveHarnessKeybinding(context, args2) {
+  const manager5 = requireKeybindingsManager2(context);
+  const lookup = keybindingLookupFromArgs(args2);
+  if (!lookup)
+    return null;
+  const entries = manager5.getAll();
+  if (isKeyAction2(lookup.input))
+    return { status: "found", action: lookup.input, lookup: { ...lookup, resolvedBy: "action" } };
+  const inputLower = lookup.input.toLowerCase();
+  const ciActions = entries.filter((entry) => entry.action.toLowerCase() === inputLower);
+  if (ciActions.length === 1)
+    return { status: "found", action: ciActions[0].action, lookup: { ...lookup, resolvedBy: "case-insensitive-action" } };
+  if (ciActions.length > 1)
+    return { status: "ambiguous", input: lookup.input, candidates: ciActions.map((entry) => bindingCandidate(manager5, entry)).slice(0, 8) };
+  const matches = entries.filter((entry) => bindingMatches(manager5, entry, lookup.input));
+  if (matches.length === 1)
+    return { status: "found", action: matches[0].action, lookup: { ...lookup, resolvedBy: "search" } };
+  if (matches.length > 1)
+    return { status: "ambiguous", input: lookup.input, candidates: matches.map((entry) => bindingCandidate(manager5, entry)).slice(0, 8) };
+  return null;
+}
+function describeBinding(manager5, action2, combos, lookup) {
   const defaults3 = DEFAULT_KEYBINDINGS[action2];
   const customized = !combosEqual(combos, defaults3);
   return {
     action: action2,
     description: ACTION_DESCRIPTIONS[action2],
+    ...lookup ? { lookup } : {},
     bindings: combos.map((combo) => describeCombo(manager5, combo)),
     labels: combos.map((combo) => manager5.formatCombo(combo)),
     defaultBindings: defaults3.map((combo) => describeCombo(manager5, combo)),
@@ -880173,7 +880265,7 @@ ${shortcut.description}`.toLowerCase().includes(query2)).slice(0, readLimit7(arg
 function listHarnessKeybindings(context, args2) {
   const manager5 = requireKeybindingsManager2(context);
   const query2 = readString52(args2.query);
-  const entries = manager5.getAll().filter((entry) => bindingMatches(entry, query2)).slice(0, readLimit7(args2.limit, 200)).map((entry) => describeBinding(manager5, entry.action, entry.combos));
+  const entries = manager5.getAll().filter((entry) => bindingMatches(manager5, entry, query2)).slice(0, readLimit7(args2.limit, 200)).map((entry) => describeBinding(manager5, entry.action, entry.combos));
   return {
     configPath: manager5.getConfigPath(),
     keybindings: entries,
@@ -880184,46 +880276,54 @@ function listHarnessKeybindings(context, args2) {
 }
 function describeHarnessKeybinding(context, args2) {
   const manager5 = requireKeybindingsManager2(context);
-  const action2 = actionFromArgs(args2);
-  if (!action2)
+  const resolved = resolveHarnessKeybinding(context, args2);
+  if (resolved?.status === "ambiguous")
+    return { status: "ambiguous", input: resolved.input, candidates: resolved.candidates };
+  if (!resolved)
     return null;
-  const entry = manager5.getAll().find((candidate) => candidate.action === action2);
+  const entry = manager5.getAll().find((candidate) => candidate.action === resolved.action);
   return entry ? {
     configPath: manager5.getConfigPath(),
-    ...describeBinding(manager5, entry.action, entry.combos)
+    ...describeBinding(manager5, entry.action, entry.combos, resolved.lookup)
   } : 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 resolved = resolveHarnessKeybinding(context, args2);
+  if (resolved?.status === "ambiguous")
+    throw new Error(`Ambiguous keybinding action ${resolved.input}. Candidates: ${JSON.stringify(resolved.candidates)}`);
+  if (!resolved)
+    throw new Error("set_keybinding requires a valid keybinding action id, target, or query.");
   const combos = combosFromArgs(args2);
   const configPath = manager5.getConfigPath();
   const overrides = readOverrideFile(configPath);
-  overrides[action2] = combos.length === 1 ? combos[0] : combos;
+  overrides[resolved.action] = combos.length === 1 ? combos[0] : combos;
   writeOverrideFile(configPath, overrides);
   manager5.loadFromDisk();
   return {
     status: "updated",
     configPath,
-    keybinding: describeHarnessKeybinding(context, { actionId: action2 })
+    keybinding: describeHarnessKeybinding(context, { actionId: resolved.action }),
+    lookup: resolved.lookup
   };
 }
 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 resolved = resolveHarnessKeybinding(context, args2);
+  if (resolved?.status === "ambiguous")
+    throw new Error(`Ambiguous keybinding action ${resolved.input}. Candidates: ${JSON.stringify(resolved.candidates)}`);
+  if (!resolved)
+    throw new Error("reset_keybinding requires a valid keybinding action id, target, or query.");
   const configPath = manager5.getConfigPath();
   const overrides = readOverrideFile(configPath);
-  delete overrides[action2];
+  delete overrides[resolved.action];
   writeOverrideFile(configPath, overrides);
   manager5.loadFromDisk();
   return {
     status: "reset",
     configPath,
-    keybinding: describeHarnessKeybinding(context, { actionId: action2 })
+    keybinding: describeHarnessKeybinding(context, { actionId: resolved.action }),
+    lookup: resolved.lookup
   };
 }
 
@@ -880249,10 +880349,69 @@ function panelMatches(panel, query2) {
     panel.category,
     panel.description,
     panel.workspaceRoute
-  ].map((value) => String(value ?? "")).join(`
+  ].map((value) => typeof value === "object" ? JSON.stringify(value) : String(value ?? "")).join(`
 `).toLowerCase().includes(query2.toLowerCase());
 }
-function describePanelRegistration(context, registration) {
+function panelLookupFromArgs(args2) {
+  const panelId = readString53(args2.panelId);
+  if (panelId)
+    return { source: "panelId", input: panelId };
+  const target = readString53(args2.target);
+  if (target)
+    return { source: "target", input: target };
+  const query2 = readString53(args2.query);
+  if (query2)
+    return { source: "query", input: query2 };
+  return null;
+}
+function panelCandidate(registration) {
+  return {
+    id: registration.id,
+    name: registration.name,
+    category: registration.category,
+    description: registration.description,
+    workspaceRoute: {
+      categoryId: agentWorkspaceCategoryForPanel(registration.id),
+      command: agentWorkspaceCommandForPanel(registration.id)
+    }
+  };
+}
+function resolveHarnessPanel(context, args2) {
+  const manager5 = panelManager(context);
+  const lookup = panelLookupFromArgs(args2);
+  if (!manager5 || !lookup)
+    return null;
+  const registrations = manager5.getRegisteredTypes();
+  const exactId = registrations.find((panel) => panel.id === lookup.input);
+  if (exactId)
+    return { status: "found", registration: exactId, lookup: { ...lookup, resolvedBy: "id" } };
+  const inputLower = lookup.input.toLowerCase();
+  const exactName = registrations.find((panel) => panel.name === lookup.input);
+  if (exactName)
+    return { status: "found", registration: exactName, lookup: { ...lookup, resolvedBy: "name" } };
+  const ciId = registrations.filter((panel) => panel.id.toLowerCase() === inputLower);
+  if (ciId.length === 1)
+    return { status: "found", registration: ciId[0], lookup: { ...lookup, resolvedBy: "case-insensitive-id" } };
+  if (ciId.length > 1)
+    return { status: "ambiguous", input: lookup.input, candidates: ciId.map(panelCandidate).slice(0, 8) };
+  const ciName = registrations.filter((panel) => panel.name.toLowerCase() === inputLower);
+  if (ciName.length === 1)
+    return { status: "found", registration: ciName[0], lookup: { ...lookup, resolvedBy: "case-insensitive-name" } };
+  if (ciName.length > 1)
+    return { status: "ambiguous", input: lookup.input, candidates: ciName.map(panelCandidate).slice(0, 8) };
+  const category = readString53(args2.category);
+  const search2 = registrations.filter((registration) => {
+    if (category && registration.category !== category)
+      return false;
+    return panelMatches(panelCandidate(registration), lookup.input);
+  });
+  if (search2.length === 1)
+    return { status: "found", registration: search2[0], lookup: { ...lookup, resolvedBy: "search" } };
+  if (search2.length > 1)
+    return { status: "ambiguous", input: lookup.input, candidates: search2.map(panelCandidate).slice(0, 8) };
+  return null;
+}
+function describePanelRegistration(context, registration, lookup) {
   const manager5 = panelManager(context);
   const openPanel = manager5?.getPanel(registration.id) ?? null;
   const pane = manager5?.getPaneOf(registration.id) ?? null;
@@ -880263,6 +880422,7 @@ function describePanelRegistration(context, registration) {
     icon: registration.icon,
     category: registration.category,
     description: registration.description,
+    ...lookup ? { lookup } : {},
     preload: registration.preload === true,
     open: openPanel !== null,
     pane,
@@ -880292,24 +880452,27 @@ function listHarnessPanels(context, args2) {
   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 = readString53(args2.panelId || args2.query);
-  if (!panelId)
-    return null;
-  const registration = manager5.getRegisteredTypes().find((panel) => panel.id === panelId || panel.name.toLowerCase() === panelId.toLowerCase());
-  return registration ? describePanelRegistration(context, registration) : null;
+  const resolved = resolveHarnessPanel(context, args2);
+  if (resolved?.status === "found")
+    return describePanelRegistration(context, resolved.registration, resolved.lookup);
+  if (resolved?.status === "ambiguous") {
+    return { status: "ambiguous", input: resolved.input, candidates: resolved.candidates };
+  }
+  return null;
 }
 function openHarnessPanel(context, args2) {
-  const panel = describeHarnessPanel(context, args2);
-  if (!panel) {
+  const resolved = resolveHarnessPanel(context, args2);
+  if (resolved?.status === "ambiguous") {
+    return { status: "ambiguous_panel", input: resolved.input, candidates: resolved.candidates };
+  }
+  if (!resolved) {
     return {
       status: "unknown_panel",
-      panelId: readString53(args2.panelId || args2.query) || "<missing>",
+      panelId: readString53(args2.panelId || args2.target || args2.query) || "<missing>",
       availablePanels: listHarnessPanels(context, { limit: 50 }).map((entry) => entry.id)
     };
   }
+  const panel = describePanelRegistration(context, resolved.registration, resolved.lookup);
   const requestedPane = readString53(args2.pane);
   const pane = requestedPane === "bottom" || requestedPane === "top" ? requestedPane : undefined;
   if (!context.showPanel) {
@@ -880927,7 +881090,7 @@ var AGENT_HARNESS_PARAMETER_PROPERTIES = {
   },
   query: {
     type: "string",
-    description: "Search text for command, workspace action, setting, tool, or UI surface catalogs; also a slash-command lookup for mode command or setting lookup for get_setting/set_setting/reset_setting."
+    description: "Search text for command, CLI mirror, panel, UI surface, keybinding, workspace action, setting, or tool catalogs; also slash-command, CLI mirror, setting, panel, UI surface, or keybinding lookup for single-item modes."
   },
   command: {
     type: "string",
@@ -880935,7 +881098,7 @@ var AGENT_HARNESS_PARAMETER_PROPERTIES = {
   },
   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.'
+    description: 'Top-level CLI command string for mode cli_command, for example "goodvibes-agent status --json" or "profiles list". target or query can also look up one CLI mirror when the exact command token is not known. This mode is read-only metadata/parse inspection.'
   },
   commandName: {
     type: "string",
@@ -880952,15 +881115,15 @@ var AGENT_HARNESS_PARAMETER_PROPERTIES = {
   },
   surfaceId: {
     type: "string",
-    description: "UI surface id for ui_surface or open_ui_surface modes."
+    description: "UI surface id for ui_surface or open_ui_surface modes. target or query can also look up one UI surface when the exact id is not known."
   },
   panelId: {
     type: "string",
-    description: "Built-in panel id for panel or open_panel modes."
+    description: "Built-in panel id for panel or open_panel modes. target or query can also look up one panel when the exact id is not known."
   },
   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."
+    description: "Agent workspace action id for workspace_action or run_workspace_action, or keybinding action id for keybinding/set_keybinding/reset_keybinding. target or query can also look up one keybinding action."
   },
   fields: {
     type: "object",
@@ -880994,7 +881157,7 @@ var AGENT_HARNESS_PARAMETER_PROPERTIES = {
   },
   target: {
     type: "string",
-    description: "Optional lookup target, such as a model-picker target, workspace action id/search text, slash command root or invocation, setting key/search text, model tool name, or connected-host capability id."
+    description: "Optional lookup target, such as a model-picker target, top-level CLI mirror/search text, panel id/search text, UI surface id/search text, workspace action id/search text, slash command root or invocation, setting key/search text, keybinding action/search text, model tool name, or connected-host capability id."
   },
   capabilityId: {
     type: "string",
@@ -881744,13 +881907,64 @@ function surfaceMatches(surface, query2) {
   ].map((value) => String(value ?? "")).join(`
 `).toLowerCase().includes(query2.toLowerCase());
 }
-function describeSurface(context, surface) {
+function surfaceLookupFromArgs(args2) {
+  const surfaceId = readString57(args2.surfaceId);
+  if (surfaceId)
+    return { source: "surfaceId", input: surfaceId };
+  const query2 = readString57(args2.query);
+  if (query2)
+    return { source: "query", input: query2 };
+  const target = readString57(args2.target);
+  if (target)
+    return { source: "target", input: target };
+  return null;
+}
+function surfaceCandidate(surface) {
   return {
     id: surface.id,
     label: surface.label,
     kind: surface.kind,
     summary: surface.summary,
     command: surface.command,
+    preferredModelRoute: surface.preferredModelRoute
+  };
+}
+function resolveHarnessUiSurface(args2) {
+  const lookup = surfaceLookupFromArgs(args2);
+  if (!lookup)
+    return null;
+  const exactId = UI_SURFACES.find((surface) => surface.id === lookup.input);
+  if (exactId)
+    return { status: "found", surface: exactId, lookup: { ...lookup, resolvedBy: "id" } };
+  const exactLabel = UI_SURFACES.find((surface) => surface.label === lookup.input);
+  if (exactLabel)
+    return { status: "found", surface: exactLabel, lookup: { ...lookup, resolvedBy: "label" } };
+  const inputLower = lookup.input.toLowerCase();
+  const ciId = UI_SURFACES.filter((surface) => surface.id.toLowerCase() === inputLower);
+  if (ciId.length === 1)
+    return { status: "found", surface: ciId[0], lookup: { ...lookup, resolvedBy: "case-insensitive-id" } };
+  if (ciId.length > 1)
+    return { status: "ambiguous", input: lookup.input, candidates: ciId.map(surfaceCandidate).slice(0, 8) };
+  const ciLabel = UI_SURFACES.filter((surface) => surface.label.toLowerCase() === inputLower);
+  if (ciLabel.length === 1)
+    return { status: "found", surface: ciLabel[0], lookup: { ...lookup, resolvedBy: "case-insensitive-label" } };
+  if (ciLabel.length > 1)
+    return { status: "ambiguous", input: lookup.input, candidates: ciLabel.map(surfaceCandidate).slice(0, 8) };
+  const search2 = UI_SURFACES.filter((surface) => surfaceMatches(surfaceCandidate(surface), lookup.input));
+  if (search2.length === 1)
+    return { status: "found", surface: search2[0], lookup: { ...lookup, resolvedBy: "search" } };
+  if (search2.length > 1)
+    return { status: "ambiguous", input: lookup.input, candidates: search2.map(surfaceCandidate).slice(0, 8) };
+  return null;
+}
+function describeSurface(context, surface, lookup) {
+  return {
+    id: surface.id,
+    label: surface.label,
+    kind: surface.kind,
+    summary: surface.summary,
+    command: surface.command,
+    ...lookup ? { lookup } : {},
     preferredModelRoute: surface.preferredModelRoute,
     parameters: surface.parameters ?? [],
     available: surface.available(context),
@@ -881770,26 +881984,30 @@ function listHarnessUiSurfaces(context, args2) {
   return UI_SURFACES.map((surface) => describeSurface(context, surface)).filter((surface) => surfaceMatches(surface, query2)).slice(0, limit3);
 }
 function describeHarnessUiSurface(context, args2) {
-  const surfaceId = readString57(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;
+  const resolved = resolveHarnessUiSurface(args2);
+  if (resolved?.status === "found")
+    return describeSurface(context, resolved.surface, resolved.lookup);
+  if (resolved?.status === "ambiguous") {
+    return { status: "ambiguous", input: resolved.input, candidates: resolved.candidates };
+  }
+  return null;
 }
 async function openHarnessUiSurface(context, args2) {
-  const surfaceId = readString57(args2.surfaceId || args2.query);
-  const surface = UI_SURFACES.find((entry) => entry.id === surfaceId || entry.label.toLowerCase() === surfaceId.toLowerCase());
-  if (!surface) {
+  const resolved = resolveHarnessUiSurface(args2);
+  if (resolved?.status === "ambiguous") {
+    return { status: "ambiguous_ui_surface", input: resolved.input, candidates: resolved.candidates };
+  }
+  if (!resolved) {
     return {
       status: "unknown_ui_surface",
-      surfaceId: surfaceId || "<missing>",
+      surfaceId: readString57(args2.surfaceId || args2.query || args2.target) || "<missing>",
       availableSurfaces: UI_SURFACES.map((entry) => entry.id)
     };
   }
-  const routed = await surface.open(context, args2);
+  const routed = await resolved.surface.open(context, args2);
   return {
     ...routed,
-    descriptor: describeSurface(context, surface)
+    descriptor: describeSurface(context, resolved.surface, resolved.lookup)
   };
 }
 
@@ -882248,10 +882466,10 @@ function createAgentHarnessTool(deps) {
             workspaceActions: allWorkspaceActions().length,
             tools: deps.toolRegistry.getToolDefinitions().length,
             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.',
+              cliCommands: 'Use mode:"cli_commands" to list and mode:"cli_command" with cliCommand, command, commandName, target, or query to inspect package CLI mirrors and their preferred in-process model routes. CLI modes are discovery-only.',
+              panels: 'Use mode:"panels" to list and mode:"panel" with panelId, target, or query 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" to list and mode:"ui_surface" with surfaceId, target, or query 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:"keybinding" with actionId, target, key, or query; 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" to list slash commands and mode:"command" with command, commandName, target, or query to inspect one command; use mode:"run_command" with confirm:true plus explicitUserRequest to execute.',
               workspace: 'Use mode:"workspace_actions" to list and mode:"workspace_action" with actionId, command, target, or query for one action and editor schema; set includeParameters:true on workspace_actions to inline editor schemas.',
               settings: 'Use mode:"settings" to list and mode:"get_setting" with key, target, or query for one setting. Use mode:"set_setting" or mode:"reset_setting" with key, target, or query plus confirm:true and explicitUserRequest.',
@@ -882287,7 +882505,7 @@ function createAgentHarnessTool(deps) {
         }
         if (args2.mode === "panel") {
           const panel = describeHarnessPanel(deps.commandContext, args2);
-          return panel ? output7(panel) : error52(`Unknown panel ${readString58(args2.panelId || args2.query) || "<missing>"}.`);
+          return panel ? output7(panel) : error52(`Unknown panel ${readString58(args2.panelId || args2.target || args2.query) || "<missing>"}.`);
         }
         if (args2.mode === "open_panel") {
           const confirmationError2 = requireConfirmedAction(args2, "Panel routing");
@@ -882301,7 +882519,7 @@ function createAgentHarnessTool(deps) {
         }
         if (args2.mode === "ui_surface") {
           const surface = describeHarnessUiSurface(deps.commandContext, args2);
-          return surface ? output7(surface) : error52(`Unknown UI surface ${readString58(args2.surfaceId || args2.query) || "<missing>"}.`);
+          return surface ? output7(surface) : error52(`Unknown UI surface ${readString58(args2.surfaceId || args2.query || args2.target) || "<missing>"}.`);
         }
         if (args2.mode === "open_ui_surface") {
           const confirmationError2 = requireConfirmedAction(args2, "UI surface routing");
@@ -882315,7 +882533,7 @@ function createAgentHarnessTool(deps) {
           return output7(listHarnessKeybindings(deps.commandContext, args2));
         if (args2.mode === "keybinding") {
           const binding = describeHarnessKeybinding(deps.commandContext, args2);
-          return binding ? output7(binding) : error52(`Unknown keybinding action ${readString58(args2.actionId || args2.key || args2.query) || "<missing>"}.`);
+          return binding ? output7(binding) : error52(`Unknown keybinding action ${readString58(args2.actionId || args2.target || args2.key || args2.query) || "<missing>"}.`);
         }
         if (args2.mode === "set_keybinding") {
           const confirmationError2 = requireConfirmedAction(args2, "Keybinding mutation");