@pellux/goodvibes-agent 1.0.17 → 1.0.18

package/dist/package/main.js

@@ -389257,6 +389257,23 @@ function createSchema2(db) {
   `);
   db.run(`CREATE INDEX IF NOT EXISTS idx_knowledge_schedules_job_id ON knowledge_schedules(job_id)`);
 }
+function getKnowledgeSchemaStatements() {
+  const statements = [];
+  createSchema2({
+    run(sql) {
+      const normalized = sql.trim();
+      if (normalized.length > 0)
+        statements.push(normalized);
+    }
+  });
+  return statements;
+}
+function renderKnowledgeSchemaSql() {
+  return `${getKnowledgeSchemaStatements().map((statement) => statement.endsWith(";") ? statement : `${statement};`).join(`
+
+`)}
+`;
+}
 function rowObject(columns, values2) {
   return Object.fromEntries(columns.map((column, index) => [column, values2[index]]));
 }
@@ -702594,6 +702611,9 @@ var init_ingest = __esm(() => {
 // node_modules/@pellux/goodvibes-sdk/dist/platform/knowledge/browser-history/index.js
 var init_browser_history = __esm(() => {
   init_ingest();
+  init_discover();
+  init_readers();
+  init_paths2();
 });
 
 // node_modules/graphql/jsutils/devAssert.mjs
@@ -720233,6 +720253,7 @@ var init_semantic = __esm(() => {
   init_llm();
   init_gap_repair();
   init_service4();
+  init_self_improvement();
 });
 
 // node_modules/@pellux/goodvibes-sdk/dist/platform/knowledge/home-graph/helpers.js
@@ -724201,8 +724222,40 @@ var init_map_view = __esm(() => {
 });
 
 // node_modules/@pellux/goodvibes-sdk/dist/platform/knowledge/home-graph/types.js
-var HOME_GRAPH_CAPABILITIES;
+var HOME_GRAPH_NODE_KINDS, HOME_GRAPH_RELATIONS, HOME_GRAPH_CAPABILITIES;
 var init_types6 = __esm(() => {
+  HOME_GRAPH_NODE_KINDS = [
+    "ha_home",
+    "ha_entity",
+    "ha_device",
+    "ha_area",
+    "ha_automation",
+    "ha_script",
+    "ha_scene",
+    "ha_label",
+    "ha_integration",
+    "ha_room",
+    "ha_device_passport",
+    "ha_maintenance_item",
+    "ha_troubleshooting_case",
+    "ha_purchase",
+    "ha_network_node"
+  ];
+  HOME_GRAPH_RELATIONS = [
+    "controls",
+    "located_in",
+    "belongs_to_device",
+    "has_manual",
+    "has_receipt",
+    "has_warranty",
+    "has_issue",
+    "fixed_by",
+    "uses_battery",
+    "connected_via",
+    "part_of_network",
+    "mentioned_by",
+    "source_for"
+  ];
   HOME_GRAPH_CAPABILITIES = [
     "knowledge-space-isolation",
     "snapshot-sync",
@@ -725609,6 +725662,7 @@ var init_service5 = __esm(() => {
 var init_home_graph = __esm(() => {
   init_service5();
   init_extension();
+  init_types6();
 });
 
 // node_modules/@pellux/goodvibes-sdk/dist/platform/knowledge/store-refinement.js
@@ -727936,10 +727990,14 @@ var init_service6 = __esm(() => {
 var init_project_planning = __esm(() => {
   init_service6();
   init_helpers3();
+  init_readiness();
 });
 
 // node_modules/@pellux/goodvibes-sdk/dist/platform/knowledge/persistence.js
-var init_persistence = () => {};
+var init_persistence = __esm(() => {
+  init_store_schema();
+  init_store_load();
+});
 
 // node_modules/@pellux/goodvibes-sdk/dist/platform/knowledge/projections.js
 class KnowledgeProjectionService {
@@ -731447,21 +731505,21 @@ var init_service7 = __esm(() => {
 var exports_knowledge = {};
 __export(exports_knowledge, {
   withKnowledgeSpace: () => withKnowledgeSpace,
-  uniqKnowledgeValues: () => uniq3,
-  stabilizeKnowledgeText: () => stableText2,
-  runKnowledgeSemanticSelfImprovement: () => runKnowledgeSemanticSelfImprovement2,
+  uniqKnowledgeValues: () => uniq2,
+  stabilizeKnowledgeText: () => stableText,
+  runKnowledgeSemanticSelfImprovement: () => runKnowledgeSemanticSelfImprovement,
   resolveProjectPlanningSpace: () => resolveProjectPlanningSpace,
-  resolveKnowledgeDbPathFromControlPlaneDir: () => resolveKnowledgeDbPathFromControlPlaneDir2,
+  resolveKnowledgeDbPathFromControlPlaneDir: () => resolveKnowledgeDbPathFromControlPlaneDir,
   renderPacket: () => renderPacket,
   renderKnowledgeSchemaSql: () => renderKnowledgeSchemaSql,
   renderKnowledgeMap: () => renderKnowledgeMap,
   readKnowledgeSearchText: () => readKnowledgeSearchText,
-  readBrowserKnowledgeProfile: () => readBrowserKnowledgeProfile2,
+  readBrowserKnowledgeProfile: () => readBrowserKnowledgeProfile,
   projectPlanningSourceId: () => projectPlanningSourceId,
   projectPlanningProjectIdFromPath: () => projectPlanningProjectIdFromPath,
   projectPlanningCanonicalUri: () => projectPlanningCanonicalUri,
   projectKnowledgeSpaceId: () => projectKnowledgeSpaceId,
-  parseKnowledgeJsonValue: () => parseJsonValue2,
+  parseKnowledgeJsonValue: () => parseJsonValue,
   normalizeProjectId: () => normalizeProjectId,
   normalizeKnowledgeSpaceId: () => normalizeKnowledgeSpaceId,
   normalizeHomeAssistantInstallationId: () => normalizeHomeAssistantInstallationId,
@@ -731469,12 +731527,12 @@ __export(exports_knowledge, {
   materializeGeneratedKnowledgeProjection: () => materializeGeneratedKnowledgeProjection,
   looksLikeRawPdfPayload: () => looksLikeRawPdfPayload,
   looksBinaryLikeText: () => looksBinaryLikeText,
-  loadKnowledgeStoreSnapshot: () => loadKnowledgeStoreSnapshot2,
+  loadKnowledgeStoreSnapshot: () => loadKnowledgeStoreSnapshot,
   listGeneratedKnowledgePages: () => listGeneratedKnowledgePages,
-  listBrowserKinds: () => listBrowserKinds2,
+  listBrowserKinds: () => listBrowserKinds,
   knowledgeSpaceMetadata: () => knowledgeSpaceMetadata,
   knowledgePageSourceWeight: () => knowledgePageSourceWeight,
-  knowledgeNowMs: () => nowMs2,
+  knowledgeNowMs: () => nowMs,
   knowledgeExtractionNeedsRefresh: () => knowledgeExtractionNeedsRefresh,
   isUsefulKnowledgePageSourceCandidate: () => isUsefulKnowledgePageSourceCandidate,
   isUsefulKnowledgePageSource: () => isUsefulKnowledgePageSource,
@@ -731494,12 +731552,12 @@ __export(exports_knowledge, {
   generatedKnowledgeSourceId: () => generatedKnowledgeSourceId,
   generatedKnowledgeCanonicalUri: () => generatedKnowledgeCanonicalUri,
   extractKnowledgeArtifact: () => extractKnowledgeArtifact,
-  evaluateProjectPlanningReadiness: () => evaluateProjectPlanningReadiness2,
-  discoverBrowserKnowledgeProfiles: () => discoverBrowserKnowledgeProfiles2,
+  evaluateProjectPlanningReadiness: () => evaluateProjectPlanningReadiness,
+  discoverBrowserKnowledgeProfiles: () => discoverBrowserKnowledgeProfiles,
   createWebKnowledgeGapRepairer: () => createWebKnowledgeGapRepairer,
   createProviderBackedKnowledgeSemanticLlm: () => createProviderBackedKnowledgeSemanticLlm,
   createMemoryApi: () => createMemoryApi,
-  createKnowledgeSchema: () => createSchema3,
+  createKnowledgeSchema: () => createSchema2,
   createKnowledgeApi: () => createKnowledgeApi,
   createDefaultKnowledgeConnectorRegistry: () => createDefaultKnowledgeConnectorRegistry,
   compareKnowledgePageSources: () => compareKnowledgePageSources,
@@ -733937,7 +733995,7 @@ var init_delivery_manager = __esm(() => {
 });
 
 // node_modules/@pellux/goodvibes-sdk/dist/platform/automation/scheduler-capacity.js
-function computeSchedulerCapacity(slotsTotal, runs, nowMs3 = Date.now()) {
+function computeSchedulerCapacity(slotsTotal, runs, nowMs2 = Date.now()) {
   let slotsInUse = 0;
   const queuedRuns = [];
   for (const run7 of runs) {
@@ -733947,7 +734005,7 @@ function computeSchedulerCapacity(slotsTotal, runs, nowMs3 = Date.now()) {
       queuedRuns.push(run7);
   }
   const queueDepth = queuedRuns.length;
-  const oldestQueuedAgeMs = queueDepth > 0 ? nowMs3 - Math.min(...queuedRuns.map((r5) => r5.queuedAt)) : null;
+  const oldestQueuedAgeMs = queueDepth > 0 ? nowMs2 - Math.min(...queuedRuns.map((r5) => r5.queuedAt)) : null;
   return { slotsTotal, slotsInUse, queueDepth, oldestQueuedAgeMs };
 }
 
@@ -816508,7 +816566,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.18";
 var _sdkVersion = "0.33.35";
 try {
   const pkg = JSON.parse(readFileSync(join(import.meta.dir, "..", "package.json"), "utf-8"));
@@ -839370,7 +839428,7 @@ var WORK_PLAN_STATUSES = [
   "failed",
   "cancelled"
 ];
-function nowMs3() {
+function nowMs2() {
   return Date.now();
 }
 function isObject5(value) {
@@ -839476,7 +839534,7 @@ class WorkPlanStore {
     if (!normalizedTitle)
       throw new Error("Work plan item title is required.");
     const plan = this.readPlan();
-    const time4 = nowMs3();
+    const time4 = nowMs2();
     const item = {
       id: createItemId(),
       title: normalizedTitle,
@@ -839500,7 +839558,7 @@ class WorkPlanStore {
   updateItem(idOrPrefix, patch2) {
     const plan = this.readPlan();
     const item = this.resolveItem(plan, idOrPrefix);
-    const time4 = nowMs3();
+    const time4 = nowMs2();
     const nextStatus = patch2.status ?? item.status;
     const next = this.pruneItem({
       ...item,
@@ -839533,7 +839591,7 @@ class WorkPlanStore {
   removeItem(idOrPrefix) {
     const plan = this.readPlan();
     const item = this.resolveItem(plan, idOrPrefix);
-    const time4 = nowMs3();
+    const time4 = nowMs2();
     const remaining = plan.items.filter((candidate) => candidate.id !== item.id);
     this.writePlan({
       ...plan,
@@ -839553,7 +839611,7 @@ class WorkPlanStore {
       ...plan,
       items: remaining,
       activeItemId: remaining[0]?.id,
-      updatedAt: nowMs3()
+      updatedAt: nowMs2()
     });
     return removed;
   }
@@ -839592,7 +839650,7 @@ class WorkPlanStore {
     const parsed = JSON.parse(raw);
     if (!isObject5(parsed))
       return this.createEmptyPlan();
-    const time4 = nowMs3();
+    const time4 = nowMs2();
     const createdAt = typeof parsed.createdAt === "number" ? parsed.createdAt : time4;
     const updatedAt = typeof parsed.updatedAt === "number" ? parsed.updatedAt : createdAt;
     const items = Array.isArray(parsed.items) ? parsed.items.map((item) => normalizeItem(item, createdAt)).filter((item) => item !== null) : [];
@@ -839611,7 +839669,7 @@ class WorkPlanStore {
     };
   }
   createEmptyPlan() {
-    const time4 = nowMs3();
+    const time4 = nowMs2();
     return {
       id: createPlanId(this.options.projectId, this.options.projectRoot),
       projectId: this.options.projectId,
@@ -880020,10 +880078,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 +880166,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 +880274,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 +880285,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 +880358,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 +880431,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 +880461,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 +881099,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, panel, UI surface, keybinding, workspace action, setting, or tool catalogs; also slash-command, setting, panel, UI surface, or keybinding lookup for single-item modes."
   },
   command: {
     type: "string",
@@ -880952,15 +881124,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 +881166,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, 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 +881916,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 +881993,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)
   };
 }
 
@@ -882249,9 +882476,9 @@ function createAgentHarnessTool(deps) {
             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.',
+              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 +882514,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 +882528,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 +882542,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");