@pellux/goodvibes-agent 1.0.16 → 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.16";
+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,
@@ -851011,6 +851069,36 @@ function findSetting(configManager, rawKey) {
     return null;
   return configManager.getSchema().find((setting) => setting.key === rawKey) ?? null;
 }
+function settingLookupText(setting) {
+  return [setting.key, setting.description, setting.type, ...setting.enumValues ?? []].join(`
+`).toLowerCase();
+}
+function settingMatchesSearch(setting, query2) {
+  return settingLookupText(setting).includes(query2);
+}
+function settingCandidate(setting) {
+  const hostOwned = isExternalHostOwnedSettingKey(setting.key);
+  return {
+    key: setting.key,
+    category: setting.key.split(".")[0] ?? "",
+    type: setting.type,
+    writable: !hostOwned,
+    visibleInWorkspace: !isAgentHiddenSettingKey(setting.key),
+    description: setting.description
+  };
+}
+function settingLookupFromArgs(args2) {
+  const key = args2.key?.trim();
+  if (key)
+    return { source: "key", input: key };
+  const target = args2.target?.trim();
+  if (target)
+    return { source: "target", input: target };
+  const query2 = args2.query?.trim();
+  if (query2)
+    return { source: "query", input: query2 };
+  return null;
+}
 function redactHarnessSettingValue(key, value) {
   if (typeof value !== "string")
     return value;
@@ -851023,7 +851111,7 @@ function redactHarnessSettingValue(key, value) {
   }
   return value;
 }
-function describeHarnessSetting(configManager, setting) {
+function describeHarnessSetting(configManager, setting, options = {}) {
   const value = configManager.get(setting.key);
   const hostOwned = isExternalHostOwnedSettingKey(setting.key);
   return {
@@ -851037,7 +851125,8 @@ function describeHarnessSetting(configManager, setting) {
     visibleInWorkspace: !isAgentHiddenSettingKey(setting.key),
     ...hostOwned ? { lockReason: AGENT_EXTERNAL_HOST_SETTING_LOCK_REASON } : {},
     description: setting.description,
-    ...setting.enumValues ? { enumValues: setting.enumValues } : {}
+    ...setting.enumValues ? { enumValues: setting.enumValues } : {},
+    ...options.lookup ? { lookup: options.lookup } : {}
   };
 }
 function listHarnessSettings(configManager, filters = {}) {
@@ -851056,17 +851145,74 @@ function listHarnessSettings(configManager, filters = {}) {
     if (!filters.includeHidden && isAgentHiddenSettingKey(setting.key))
       return false;
     if (query2) {
-      const text = [setting.key, setting.description, setting.type, ...setting.enumValues ?? []].join(`
-`).toLowerCase();
-      if (!text.includes(query2))
+      if (!settingMatchesSearch(setting, query2))
         return false;
     }
     return true;
   }).map((setting) => describeHarnessSetting(configManager, setting)).slice(0, limit3);
 }
-function getHarnessSetting(configManager, key) {
+function getHarnessSetting(configManager, key, lookup) {
   const setting = findSetting(configManager, key);
-  return setting ? describeHarnessSetting(configManager, setting) : null;
+  return setting ? describeHarnessSetting(configManager, setting, { lookup }) : null;
+}
+function resolveHarnessSetting(configManager, args2) {
+  const lookup = settingLookupFromArgs(args2);
+  if (!lookup)
+    return null;
+  const exact = findSetting(configManager, lookup.input);
+  if (exact) {
+    const resolvedLookup = { ...lookup, resolvedBy: "key" };
+    return {
+      status: "found",
+      setting: describeHarnessSetting(configManager, exact, { lookup: resolvedLookup }),
+      lookup: resolvedLookup
+    };
+  }
+  const inputLower = lookup.input.toLowerCase();
+  const schema3 = configManager.getSchema();
+  const caseInsensitiveMatches = schema3.filter((setting) => setting.key.toLowerCase() === inputLower);
+  if (caseInsensitiveMatches.length === 1) {
+    const resolvedLookup = { ...lookup, resolvedBy: "case-insensitive-key" };
+    return {
+      status: "found",
+      setting: describeHarnessSetting(configManager, caseInsensitiveMatches[0], { lookup: resolvedLookup }),
+      lookup: resolvedLookup
+    };
+  }
+  if (caseInsensitiveMatches.length > 1) {
+    return {
+      status: "ambiguous",
+      input: lookup.input,
+      candidates: caseInsensitiveMatches.map(settingCandidate).slice(0, 8)
+    };
+  }
+  const category = args2.category?.trim();
+  const prefix = args2.prefix?.trim();
+  const searchMatches = schema3.filter((setting) => {
+    if (category && setting.key.split(".")[0] !== category)
+      return false;
+    if (prefix && !setting.key.startsWith(prefix))
+      return false;
+    if (!args2.includeHidden && isAgentHiddenSettingKey(setting.key))
+      return false;
+    return settingMatchesSearch(setting, inputLower);
+  });
+  if (searchMatches.length === 1) {
+    const resolvedLookup = { ...lookup, resolvedBy: "search" };
+    return {
+      status: "found",
+      setting: describeHarnessSetting(configManager, searchMatches[0], { lookup: resolvedLookup }),
+      lookup: resolvedLookup
+    };
+  }
+  if (searchMatches.length > 1) {
+    return {
+      status: "ambiguous",
+      input: lookup.input,
+      candidates: searchMatches.map(settingCandidate).slice(0, 8)
+    };
+  }
+  return null;
 }
 function coerceBoolean(value) {
   if (typeof value === "boolean")
@@ -879638,8 +879784,8 @@ function blockedConnectedHostCapabilities() {
 }
 function settingsPolicySummary() {
   return {
-    discovery: 'Use mode:"settings" for the setting catalog and mode:"get_setting" for one key. Hidden/scriptable settings require includeHidden:true.',
-    mutation: 'Use mode:"set_setting" or mode:"reset_setting" with confirm:true and explicitUserRequest.',
+    discovery: 'Use mode:"settings" for the setting catalog and mode:"get_setting" with key, target, or query for one setting. Hidden/scriptable settings require includeHidden:true unless the exact key is supplied.',
+    mutation: 'Use mode:"set_setting" or mode:"reset_setting" with key, target, or query plus confirm:true and explicitUserRequest; ambiguous setting lookups are refused.',
     secretHandling: "Raw secret values are persisted through the secret manager; config receives only a secret reference and tool output is redacted.",
     writablePolicy: "Each setting descriptor includes writable, visibleInWorkspace, and lockReason when applicable.",
     readOnlyHostOwnedPrefixes: ["service.*", "controlPlane.*", "httpListener.*", "web.*", "danger.daemon.*", "danger.httpListener.*"]
@@ -879932,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;
@@ -880024,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)),
@@ -880085,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,
@@ -880096,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
   };
 }
 
@@ -880161,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;
@@ -880175,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,
@@ -880204,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) {
@@ -880839,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."
+    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",
@@ -880864,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",
@@ -880894,7 +881154,7 @@ var AGENT_HARNESS_PARAMETER_PROPERTIES = {
   },
   key: {
     type: "string",
-    description: "Agent setting key for get_setting, set_setting, or reset_setting."
+    description: "Agent setting key for get_setting, set_setting, or reset_setting. target or query can also look up one setting when the exact key is not known."
   },
   value: {
     anyOf: [
@@ -880906,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, settings key, 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",
@@ -881656,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),
@@ -881682,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)
   };
 }
 
@@ -881712,6 +882027,16 @@ function isMode(value) {
 function readString58(value) {
   return typeof value === "string" ? value.trim() : "";
 }
+function settingLookupArgs(args2) {
+  return {
+    key: readString58(args2.key) || undefined,
+    target: readString58(args2.target) || undefined,
+    query: readString58(args2.query) || undefined,
+    category: readString58(args2.category) || undefined,
+    prefix: readString58(args2.prefix) || undefined,
+    includeHidden: args2.includeHidden === true
+  };
+}
 function readLimit11(value, fallback) {
   const parsed = typeof value === "string" && value.trim() ? Number(value) : value;
   if (typeof parsed !== "number" || !Number.isFinite(parsed))
@@ -882151,12 +882476,12 @@ 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", mode:"get_setting", mode:"set_setting", and mode:"reset_setting".',
+              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.',
               tools: 'Use mode:"tools" to list first-class model tools, or mode:"tool" with toolName, target, or query to inspect one schema.',
               connectedHost: 'Use mode:"connected_host" for the connected-host capability map and blocked boundaries. Use mode:"connected_host_capability" with capabilityId, target, or query for one allowed or blocked capability.',
               connectedHostStatus: 'Use mode:"connected_host_status" for live read-only host reachability, SDK compatibility, token posture, and Agent Knowledge route readiness.'
@@ -882189,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");
@@ -882203,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");
@@ -882217,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");
@@ -882253,9 +882578,13 @@ function createAgentHarnessTool(deps) {
           return output7({ settings, returned: settings.length, policy: settingsPolicySummary() });
         }
         if (args2.mode === "get_setting") {
-          const key = readString58(args2.key);
-          const setting = getHarnessSetting(deps.commandContext.platform.configManager, key);
-          return setting ? output7(setting) : error52(`Unknown setting ${key || "<missing>"}.`);
+          const setting = resolveHarnessSetting(deps.commandContext.platform.configManager, settingLookupArgs(args2));
+          if (setting?.status === "found")
+            return output7(setting.setting);
+          if (setting?.status === "ambiguous") {
+            return error52(`Ambiguous setting ${setting.input}. Candidates: ${JSON.stringify(setting.candidates)}`);
+          }
+          return error52(`Unknown setting ${readString58(args2.key || args2.target || args2.query) || "<missing>"}. Use mode:"settings" to inspect available settings.`);
         }
         if (args2.mode === "set_setting") {
           const confirmationError2 = requireConfirmedAction(args2, "Setting mutation");
@@ -882263,17 +882592,29 @@ function createAgentHarnessTool(deps) {
             return error52(confirmationError2);
           if (args2.value === undefined)
             return error52("set_setting requires value.");
-          const key = readString58(args2.key);
-          const result2 = await setHarnessSetting(deps.commandContext.platform.configManager, deps.commandContext.platform.secretsManager, key, args2.value);
-          return output7(result2);
+          const setting = resolveHarnessSetting(deps.commandContext.platform.configManager, settingLookupArgs(args2));
+          if (setting?.status === "ambiguous") {
+            return error52(`Ambiguous setting ${setting.input}. Candidates: ${JSON.stringify(setting.candidates)}`);
+          }
+          if (setting?.status !== "found") {
+            return error52(`Unknown setting ${readString58(args2.key || args2.target || args2.query) || "<missing>"}. Use mode:"settings" to inspect available settings.`);
+          }
+          const result2 = await setHarnessSetting(deps.commandContext.platform.configManager, deps.commandContext.platform.secretsManager, setting.setting.key, args2.value);
+          return output7({ ...result2, lookup: setting.lookup });
         }
         if (args2.mode === "reset_setting") {
           const confirmationError2 = requireConfirmedAction(args2, "Setting reset");
           if (confirmationError2)
             return error52(confirmationError2);
-          const key = readString58(args2.key);
-          const result2 = await resetHarnessSetting(deps.commandContext.platform.configManager, deps.commandContext.platform.secretsManager, key);
-          return output7(result2);
+          const setting = resolveHarnessSetting(deps.commandContext.platform.configManager, settingLookupArgs(args2));
+          if (setting?.status === "ambiguous") {
+            return error52(`Ambiguous setting ${setting.input}. Candidates: ${JSON.stringify(setting.candidates)}`);
+          }
+          if (setting?.status !== "found") {
+            return error52(`Unknown setting ${readString58(args2.key || args2.target || args2.query) || "<missing>"}. Use mode:"settings" to inspect available settings.`);
+          }
+          const result2 = await resetHarnessSetting(deps.commandContext.platform.configManager, deps.commandContext.platform.secretsManager, setting.setting.key);
+          return output7({ ...result2, lookup: setting.lookup });
         }
         if (args2.mode === "workspace" || args2.mode === "workspace_categories") {
           return output7({