@pellux/goodvibes-agent 1.0.14 → 1.0.16

package/dist/package/main.js

@@ -389257,23 +389257,6 @@ 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]]));
 }
@@ -702611,9 +702594,6 @@ 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
@@ -720253,7 +720233,6 @@ 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
@@ -724222,40 +724201,8 @@ var init_map_view = __esm(() => {
 });
 
 // node_modules/@pellux/goodvibes-sdk/dist/platform/knowledge/home-graph/types.js
-var HOME_GRAPH_NODE_KINDS, HOME_GRAPH_RELATIONS, HOME_GRAPH_CAPABILITIES;
+var 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",
@@ -725662,7 +725609,6 @@ 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
@@ -727990,14 +727936,10 @@ 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 = __esm(() => {
-  init_store_schema();
-  init_store_load();
-});
+var init_persistence = () => {};
 
 // node_modules/@pellux/goodvibes-sdk/dist/platform/knowledge/projections.js
 class KnowledgeProjectionService {
@@ -731505,21 +731447,21 @@ var init_service7 = __esm(() => {
 var exports_knowledge = {};
 __export(exports_knowledge, {
   withKnowledgeSpace: () => withKnowledgeSpace,
-  uniqKnowledgeValues: () => uniq2,
-  stabilizeKnowledgeText: () => stableText,
-  runKnowledgeSemanticSelfImprovement: () => runKnowledgeSemanticSelfImprovement,
+  uniqKnowledgeValues: () => uniq3,
+  stabilizeKnowledgeText: () => stableText2,
+  runKnowledgeSemanticSelfImprovement: () => runKnowledgeSemanticSelfImprovement2,
   resolveProjectPlanningSpace: () => resolveProjectPlanningSpace,
-  resolveKnowledgeDbPathFromControlPlaneDir: () => resolveKnowledgeDbPathFromControlPlaneDir,
+  resolveKnowledgeDbPathFromControlPlaneDir: () => resolveKnowledgeDbPathFromControlPlaneDir2,
   renderPacket: () => renderPacket,
   renderKnowledgeSchemaSql: () => renderKnowledgeSchemaSql,
   renderKnowledgeMap: () => renderKnowledgeMap,
   readKnowledgeSearchText: () => readKnowledgeSearchText,
-  readBrowserKnowledgeProfile: () => readBrowserKnowledgeProfile,
+  readBrowserKnowledgeProfile: () => readBrowserKnowledgeProfile2,
   projectPlanningSourceId: () => projectPlanningSourceId,
   projectPlanningProjectIdFromPath: () => projectPlanningProjectIdFromPath,
   projectPlanningCanonicalUri: () => projectPlanningCanonicalUri,
   projectKnowledgeSpaceId: () => projectKnowledgeSpaceId,
-  parseKnowledgeJsonValue: () => parseJsonValue,
+  parseKnowledgeJsonValue: () => parseJsonValue2,
   normalizeProjectId: () => normalizeProjectId,
   normalizeKnowledgeSpaceId: () => normalizeKnowledgeSpaceId,
   normalizeHomeAssistantInstallationId: () => normalizeHomeAssistantInstallationId,
@@ -731527,12 +731469,12 @@ __export(exports_knowledge, {
   materializeGeneratedKnowledgeProjection: () => materializeGeneratedKnowledgeProjection,
   looksLikeRawPdfPayload: () => looksLikeRawPdfPayload,
   looksBinaryLikeText: () => looksBinaryLikeText,
-  loadKnowledgeStoreSnapshot: () => loadKnowledgeStoreSnapshot,
+  loadKnowledgeStoreSnapshot: () => loadKnowledgeStoreSnapshot2,
   listGeneratedKnowledgePages: () => listGeneratedKnowledgePages,
-  listBrowserKinds: () => listBrowserKinds,
+  listBrowserKinds: () => listBrowserKinds2,
   knowledgeSpaceMetadata: () => knowledgeSpaceMetadata,
   knowledgePageSourceWeight: () => knowledgePageSourceWeight,
-  knowledgeNowMs: () => nowMs,
+  knowledgeNowMs: () => nowMs2,
   knowledgeExtractionNeedsRefresh: () => knowledgeExtractionNeedsRefresh,
   isUsefulKnowledgePageSourceCandidate: () => isUsefulKnowledgePageSourceCandidate,
   isUsefulKnowledgePageSource: () => isUsefulKnowledgePageSource,
@@ -731552,12 +731494,12 @@ __export(exports_knowledge, {
   generatedKnowledgeSourceId: () => generatedKnowledgeSourceId,
   generatedKnowledgeCanonicalUri: () => generatedKnowledgeCanonicalUri,
   extractKnowledgeArtifact: () => extractKnowledgeArtifact,
-  evaluateProjectPlanningReadiness: () => evaluateProjectPlanningReadiness,
-  discoverBrowserKnowledgeProfiles: () => discoverBrowserKnowledgeProfiles,
+  evaluateProjectPlanningReadiness: () => evaluateProjectPlanningReadiness2,
+  discoverBrowserKnowledgeProfiles: () => discoverBrowserKnowledgeProfiles2,
   createWebKnowledgeGapRepairer: () => createWebKnowledgeGapRepairer,
   createProviderBackedKnowledgeSemanticLlm: () => createProviderBackedKnowledgeSemanticLlm,
   createMemoryApi: () => createMemoryApi,
-  createKnowledgeSchema: () => createSchema2,
+  createKnowledgeSchema: () => createSchema3,
   createKnowledgeApi: () => createKnowledgeApi,
   createDefaultKnowledgeConnectorRegistry: () => createDefaultKnowledgeConnectorRegistry,
   compareKnowledgePageSources: () => compareKnowledgePageSources,
@@ -733995,7 +733937,7 @@ var init_delivery_manager = __esm(() => {
 });
 
 // node_modules/@pellux/goodvibes-sdk/dist/platform/automation/scheduler-capacity.js
-function computeSchedulerCapacity(slotsTotal, runs, nowMs2 = Date.now()) {
+function computeSchedulerCapacity(slotsTotal, runs, nowMs3 = Date.now()) {
   let slotsInUse = 0;
   const queuedRuns = [];
   for (const run7 of runs) {
@@ -734005,7 +733947,7 @@ function computeSchedulerCapacity(slotsTotal, runs, nowMs2 = Date.now()) {
       queuedRuns.push(run7);
   }
   const queueDepth = queuedRuns.length;
-  const oldestQueuedAgeMs = queueDepth > 0 ? nowMs2 - Math.min(...queuedRuns.map((r5) => r5.queuedAt)) : null;
+  const oldestQueuedAgeMs = queueDepth > 0 ? nowMs3 - Math.min(...queuedRuns.map((r5) => r5.queuedAt)) : null;
   return { slotsTotal, slotsInUse, queueDepth, oldestQueuedAgeMs };
 }
 
@@ -816566,7 +816508,7 @@ var createStyledCell = (char, overrides = {}) => ({
 // src/version.ts
 import { readFileSync } from "fs";
 import { join } from "path";
-var _version = "1.0.14";
+var _version = "1.0.16";
 var _sdkVersion = "0.33.35";
 try {
   const pkg = JSON.parse(readFileSync(join(import.meta.dir, "..", "package.json"), "utf-8"));
@@ -839428,7 +839370,7 @@ var WORK_PLAN_STATUSES = [
   "failed",
   "cancelled"
 ];
-function nowMs2() {
+function nowMs3() {
   return Date.now();
 }
 function isObject5(value) {
@@ -839534,7 +839476,7 @@ class WorkPlanStore {
     if (!normalizedTitle)
       throw new Error("Work plan item title is required.");
     const plan = this.readPlan();
-    const time4 = nowMs2();
+    const time4 = nowMs3();
     const item = {
       id: createItemId(),
       title: normalizedTitle,
@@ -839558,7 +839500,7 @@ class WorkPlanStore {
   updateItem(idOrPrefix, patch2) {
     const plan = this.readPlan();
     const item = this.resolveItem(plan, idOrPrefix);
-    const time4 = nowMs2();
+    const time4 = nowMs3();
     const nextStatus = patch2.status ?? item.status;
     const next = this.pruneItem({
       ...item,
@@ -839591,7 +839533,7 @@ class WorkPlanStore {
   removeItem(idOrPrefix) {
     const plan = this.readPlan();
     const item = this.resolveItem(plan, idOrPrefix);
-    const time4 = nowMs2();
+    const time4 = nowMs3();
     const remaining = plan.items.filter((candidate) => candidate.id !== item.id);
     this.writePlan({
       ...plan,
@@ -839611,7 +839553,7 @@ class WorkPlanStore {
       ...plan,
       items: remaining,
       activeItemId: remaining[0]?.id,
-      updatedAt: nowMs2()
+      updatedAt: nowMs3()
     });
     return removed;
   }
@@ -839650,7 +839592,7 @@ class WorkPlanStore {
     const parsed = JSON.parse(raw);
     if (!isObject5(parsed))
       return this.createEmptyPlan();
-    const time4 = nowMs2();
+    const time4 = nowMs3();
     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) : [];
@@ -839669,7 +839611,7 @@ class WorkPlanStore {
     };
   }
   createEmptyPlan() {
-    const time4 = nowMs2();
+    const time4 = nowMs3();
     return {
       id: createPlanId(this.options.projectId, this.options.projectRoot),
       projectId: this.options.projectId,
@@ -847775,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_SCOPES = ["session", "project", "team"];
+var VALID_SCOPES2 = ["session", "project", "team"];
 var VALID_REVIEW_STATES = ["fresh", "reviewed", "stale", "contradicted"];
 function isValidClass(s4) {
   return VALID_CLASSES.includes(s4);
 }
 function isValidScope(s4) {
-  return VALID_SCOPES.includes(s4);
+  return VALID_SCOPES2.includes(s4);
 }
 function isValidReviewState(s4) {
   return VALID_REVIEW_STATES.includes(s4);
@@ -847824,7 +847766,7 @@ function handleRecallSearch(args2, context) {
     if (isValidScope(scope))
       filter.scope = scope;
     else {
-      context.print(`[memory] Unknown scope "${scope}". Valid values ${VALID_SCOPES.join(", ")}.`);
+      context.print(`[memory] Unknown scope "${scope}". Valid values ${VALID_SCOPES2.join(", ")}.`);
       return;
     }
   }
@@ -847999,7 +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_SCOPES.join(", ")}.`);
+      context.print(`[memory] Unknown scope "${scope}". Valid values ${VALID_SCOPES2.join(", ")}.`);
       return;
     }
     filter.scope = scope;
@@ -848049,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_SCOPES.join(", ")}.`);
+    context.print(`[memory] Invalid scope "${scopeRaw}". Valid values ${VALID_SCOPES2.join(", ")}.`);
     return;
   }
   const provenance = [];
@@ -848183,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_SCOPES.join(", ")}.`);
+      context.print(`[memory] Unknown scope "${scope}". Valid values ${VALID_SCOPES2.join(", ")}.`);
       return;
     }
     filter.scope = scope;
@@ -848262,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_SCOPES.join(", ")}.`);
+    context.print(`[memory] Unknown scope "${scopeRaw ?? ""}". Valid values ${VALID_SCOPES2.join(", ")}.`);
     return;
   }
   const bundle = memory.exportBundle({ scope: scopeRaw });
@@ -848378,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_SCOPES.join("|")}> --yes`);
+    context.print(`[memory] Usage: /memory promote <id> <${VALID_SCOPES2.join("|")}> --yes`);
     return;
   }
   if (!parsed.yes) {
@@ -862223,7 +862165,7 @@ import { mkdirSync as mkdirSync64, readFileSync as readFileSync86, writeFileSync
 import { dirname as dirname63, resolve as resolve39 } from "path";
 init_state3();
 var VALID_CLASSES2 = ["decision", "constraint", "incident", "pattern", "fact", "risk", "runbook", "architecture", "ownership"];
-var VALID_SCOPES3 = ["session", "project", "team"];
+var VALID_SCOPES4 = ["session", "project", "team"];
 var VALID_REVIEW_STATES3 = ["fresh", "reviewed", "stale", "contradicted"];
 var VALID_PROVENANCE_KINDS = ["session", "turn", "task", "event", "file"];
 var VALUE_OPTIONS = new Set([
@@ -862323,7 +862265,7 @@ function isMemoryClass2(value) {
   return VALID_CLASSES2.includes(value);
 }
 function isMemoryScope2(value) {
-  return VALID_SCOPES3.includes(value);
+  return VALID_SCOPES4.includes(value);
 }
 function isReviewState(value) {
   return VALID_REVIEW_STATES3.includes(value);
@@ -862338,7 +862280,7 @@ function requireClass(value) {
 }
 function requireScope(value) {
   if (!value || !isMemoryScope2(value))
-    throw new Error(`Invalid memory scope "${value ?? ""}". Valid values ${VALID_SCOPES3.join(", ")}`);
+    throw new Error(`Invalid memory scope "${value ?? ""}". Valid values ${VALID_SCOPES4.join(", ")}`);
   return value;
 }
 function optionalScope(value) {
@@ -879834,6 +879776,126 @@ function describeHarnessCliCommand(args2) {
   };
 }
 
+// src/tools/agent-harness-command-catalog.ts
+function readString51(value) {
+  return typeof value === "string" ? value.trim() : "";
+}
+function readLimit6(value, fallback) {
+  const parsed = typeof value === "string" && value.trim() ? Number(value) : value;
+  if (typeof parsed !== "number" || !Number.isFinite(parsed))
+    return fallback;
+  return Math.max(1, Math.min(500, Math.trunc(parsed)));
+}
+function readStringArray12(value) {
+  if (!Array.isArray(value))
+    return [];
+  return value.map((entry) => typeof entry === "string" ? entry : String(entry));
+}
+function commandMatches(command8, query2) {
+  if (!query2)
+    return true;
+  const haystack = [
+    command8.name,
+    ...command8.aliases ?? [],
+    command8.description,
+    command8.usage ?? "",
+    command8.argsHint ?? ""
+  ].join(`
+`).toLowerCase();
+  return haystack.includes(query2.toLowerCase());
+}
+function describeCommand(command8, lookup) {
+  return {
+    name: command8.name,
+    slash: `/${command8.name}`,
+    aliases: command8.aliases ?? [],
+    description: command8.description,
+    usage: command8.usage ?? "",
+    argsHint: command8.argsHint ?? command8.usage ?? "",
+    ...lookup ? {
+      lookup: {
+        source: lookup.source,
+        input: lookup.input,
+        parsedName: lookup.parsedName,
+        parsedArgs: lookup.parsedArgs,
+        resolvedBy: lookup.resolvedBy
+      }
+    } : {},
+    policy: describeCommandPolicy(command8.name)
+  };
+}
+function commandDetailLookupFromArgs(args2) {
+  const rawCommand = readString51(args2.command);
+  if (rawCommand) {
+    const parsed = parseSlashCommand(rawCommand);
+    return { source: "command", input: rawCommand, parsedName: parsed.name, parsedArgs: parsed.args };
+  }
+  const rawCommandName = readString51(args2.commandName);
+  if (rawCommandName) {
+    const parsed = parseSlashCommand(rawCommandName);
+    const explicitArgs = readStringArray12(args2.args);
+    return {
+      source: "commandName",
+      input: rawCommandName,
+      parsedName: parsed.name,
+      parsedArgs: explicitArgs.length > 0 ? explicitArgs : parsed.args
+    };
+  }
+  const rawTarget = readString51(args2.target);
+  if (rawTarget) {
+    const parsed = parseSlashCommand(rawTarget);
+    return { source: "target", input: rawTarget, parsedName: parsed.name, parsedArgs: parsed.args };
+  }
+  const rawQuery = readString51(args2.query);
+  if (rawQuery) {
+    const parsed = parseSlashCommand(rawQuery);
+    return { source: "query", input: rawQuery, parsedName: parsed.name, parsedArgs: parsed.args };
+  }
+  return null;
+}
+function resolveCommandDetail(commandRegistry, args2) {
+  const lookup = commandDetailLookupFromArgs(args2);
+  if (!lookup?.parsedName)
+    return null;
+  const direct = commandRegistry.get(lookup.parsedName);
+  if (direct) {
+    return {
+      command: direct,
+      lookup: {
+        ...lookup,
+        resolvedBy: direct.name === lookup.parsedName ? "name" : "alias"
+      }
+    };
+  }
+  const normalized = lookup.parsedName.toLowerCase();
+  for (const command8 of commandRegistry.list()) {
+    if (command8.name.toLowerCase() === normalized) {
+      return { command: command8, lookup: { ...lookup, resolvedBy: "case-insensitive-name" } };
+    }
+    if ((command8.aliases ?? []).some((alias) => alias.toLowerCase() === normalized)) {
+      return { command: command8, lookup: { ...lookup, resolvedBy: "case-insensitive-alias" } };
+    }
+  }
+  const descriptionMatches = commandRegistry.list().filter((command8) => commandMatches(command8, lookup.input));
+  if (descriptionMatches.length === 1) {
+    return { command: descriptionMatches[0], lookup: { ...lookup, resolvedBy: "description" } };
+  }
+  const prefixMatches = commandRegistry.fuzzyMatch(lookup.parsedName).filter((entry) => entry.score >= 80);
+  if (prefixMatches.length === 1) {
+    return { command: prefixMatches[0].command, lookup: { ...lookup, resolvedBy: "prefix" } };
+  }
+  return null;
+}
+function listHarnessCommands(commandRegistry, args2) {
+  const query2 = readString51(args2.query);
+  const limit3 = readLimit6(args2.limit, 200);
+  return commandRegistry.list().filter((command8) => commandMatches(command8, query2)).sort((a4, b3) => a4.name.localeCompare(b3.name)).slice(0, limit3).map((command8) => describeCommand(command8));
+}
+function describeHarnessCommand(commandRegistry, args2) {
+  const detail = resolveCommandDetail(commandRegistry, args2);
+  return detail ? describeCommand(detail.command, detail.lookup) : null;
+}
+
 // src/tools/agent-harness-keybinding-metadata.ts
 import { existsSync as existsSync82, mkdirSync as mkdirSync67, readFileSync as readFileSync89, writeFileSync as writeFileSync58 } from "fs";
 import { dirname as dirname66 } from "path";
@@ -879847,10 +879909,10 @@ var FIXED_SHORTCUTS = [
   { key: "F2 / /shortcuts", description: "Open keyboard shortcut reference" },
   { key: "/keybindings", description: "List configurable keybindings and config path" }
 ];
-function readString51(value) {
+function readString52(value) {
   return typeof value === "string" ? value.trim() : "";
 }
-function readLimit6(value, fallback) {
+function readLimit7(value, fallback) {
   const parsed = typeof value === "string" && value.trim() ? Number(value) : value;
   if (typeof parsed !== "number" || !Number.isFinite(parsed))
     return fallback;
@@ -879871,7 +879933,7 @@ function isKeyAction2(action2) {
   return Object.hasOwn(ACTION_DESCRIPTIONS, action2);
 }
 function actionFromArgs(args2) {
-  const action2 = readString51(args2.actionId || args2.key || args2.query);
+  const action2 = readString52(args2.actionId || args2.key || args2.query);
   return action2 && isKeyAction2(action2) ? action2 : null;
 }
 function readBoolean15(value) {
@@ -879890,7 +879952,7 @@ function normalizeCombo(value) {
   if (typeof value !== "object" || value === null || Array.isArray(value))
     return null;
   const raw = value;
-  const key = readString51(raw.key);
+  const key = readString52(raw.key);
   if (!key)
     return null;
   const combo = { key };
@@ -879940,7 +880002,7 @@ function combosFromArgs(args2) {
   const fieldCombo = normalizeCombo(fields);
   if (fieldCombo)
     return [fieldCombo];
-  const labelCombo = parseComboLabel(readString51(args2.value));
+  const labelCombo = parseComboLabel(readString52(args2.value));
   if (labelCombo)
     return [labelCombo];
   throw new Error('set_keybinding requires combo, combos, fields.key, or a value such as "Ctrl+G".');
@@ -880008,9 +880070,9 @@ function totalHarnessShortcuts(context) {
 }
 function listHarnessShortcuts(context, args2) {
   const keybindings = listHarnessKeybindings(context, args2);
-  const query2 = readString51(args2.query).toLowerCase();
+  const query2 = readString52(args2.query).toLowerCase();
   const fixed = FIXED_SHORTCUTS.filter((shortcut) => !query2 || `${shortcut.key}
-${shortcut.description}`.toLowerCase().includes(query2)).slice(0, readLimit6(args2.limit, 200)).map((shortcut) => ({ ...shortcut, source: "fixed", userEditable: false }));
+${shortcut.description}`.toLowerCase().includes(query2)).slice(0, readLimit7(args2.limit, 200)).map((shortcut) => ({ ...shortcut, source: "fixed", userEditable: false }));
   return {
     configPath: keybindings.configPath,
     fixedShortcuts: fixed,
@@ -880022,8 +880084,8 @@ ${shortcut.description}`.toLowerCase().includes(query2)).slice(0, readLimit6(arg
 }
 function listHarnessKeybindings(context, args2) {
   const manager5 = requireKeybindingsManager2(context);
-  const query2 = readString51(args2.query);
-  const entries = manager5.getAll().filter((entry) => bindingMatches(entry, query2)).slice(0, readLimit6(args2.limit, 200)).map((entry) => describeBinding(manager5, entry.action, entry.combos));
+  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));
   return {
     configPath: manager5.getConfigPath(),
     keybindings: entries,
@@ -880078,10 +880140,10 @@ function resetHarnessKeybinding(context, args2) {
 }
 
 // src/tools/agent-harness-panel-metadata.ts
-function readString52(value) {
+function readString53(value) {
   return typeof value === "string" ? value.trim() : "";
 }
-function readLimit7(value, fallback) {
+function readLimit8(value, fallback) {
   const parsed = typeof value === "string" && value.trim() ? Number(value) : value;
   if (typeof parsed !== "number" || !Number.isFinite(parsed))
     return fallback;
@@ -880136,16 +880198,16 @@ function listHarnessPanels(context, args2) {
   const manager5 = panelManager(context);
   if (!manager5)
     return [];
-  const query2 = readString52(args2.query);
-  const category = readString52(args2.category);
-  const limit3 = readLimit7(args2.limit, 200);
+  const query2 = readString53(args2.query);
+  const category = readString53(args2.category);
+  const limit3 = readLimit8(args2.limit, 200);
   return manager5.getRegisteredTypes().map((registration) => describePanelRegistration(context, registration)).filter((panel) => !category || panel.category === category).filter((panel) => panelMatches(panel, query2)).sort((a4, b3) => String(a4.id).localeCompare(String(b3.id))).slice(0, limit3);
 }
 function describeHarnessPanel(context, args2) {
   const manager5 = panelManager(context);
   if (!manager5)
     return null;
-  const panelId = readString52(args2.panelId || args2.query);
+  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());
@@ -880156,11 +880218,11 @@ function openHarnessPanel(context, args2) {
   if (!panel) {
     return {
       status: "unknown_panel",
-      panelId: readString52(args2.panelId || args2.query) || "<missing>",
+      panelId: readString53(args2.panelId || args2.query) || "<missing>",
       availablePanels: listHarnessPanels(context, { limit: 50 }).map((entry) => entry.id)
     };
   }
-  const requestedPane = readString52(args2.pane);
+  const requestedPane = readString53(args2.pane);
   const pane = requestedPane === "bottom" || requestedPane === "top" ? requestedPane : undefined;
   if (!context.showPanel) {
     return {
@@ -880184,7 +880246,7 @@ import { join as join98 } from "path";
 function isRecord42(value) {
   return Boolean(value) && typeof value === "object" && !Array.isArray(value);
 }
-function readString53(record2, key) {
+function readString54(record2, key) {
   const value = record2?.[key];
   return typeof value === "string" ? value : null;
 }
@@ -880235,7 +880297,7 @@ async function inspectCliExternalRuntime(options) {
   try {
     const status = await fetchJson2(`${baseUrl}/status`, token.token, timeoutMs);
     const statusRecord = isRecord42(status.body) ? status.body : {};
-    const version6 = readString53(statusRecord, "version") ?? "unknown";
+    const version6 = readString54(statusRecord, "version") ?? "unknown";
     const compatible = status.ok && version6 === SDK_VERSION;
     if (!status.ok) {
       return {
@@ -880453,7 +880515,7 @@ function output6(value) {
 function error51(message) {
   return { success: false, error: message };
 }
-function readString54(value) {
+function readString55(value) {
   return typeof value === "string" ? value.trim() : "";
 }
 function readFieldMap2(value) {
@@ -880480,10 +880542,10 @@ function describeEditor(editor) {
 }
 function readRecordId(args2) {
   const fields = readFieldMap2(args2.fields);
-  return readString54(args2.recordId ?? args2.id ?? fields.recordId ?? fields.id);
+  return readString55(args2.recordId ?? args2.id ?? fields.recordId ?? fields.id);
 }
 function requireConfirmed(args2, label) {
-  if (!readString54(args2.explicitUserRequest))
+  if (!readString55(args2.explicitUserRequest))
     return `${label} requires explicitUserRequest with the user's exact request or a short faithful summary.`;
   if (args2.confirm !== true)
     return `${label} requires confirm:true after an explicit user request.`;
@@ -880611,7 +880673,7 @@ function localRegistryArgsForTarget(target, args2, recordId) {
     ...base2,
     ...edit,
     ...target.action === "stale" && fields.reason ? { reason: fields.reason } : {},
-    ...target.action === "delete" ? { confirm: args2.confirm, explicitUserRequest: readString54(args2.explicitUserRequest) } : {}
+    ...target.action === "delete" ? { confirm: args2.confirm, explicitUserRequest: readString55(args2.explicitUserRequest) } : {}
   };
 }
 async function executeTool(toolRegistry, name51, toolArgs) {
@@ -880677,7 +880739,7 @@ async function runLocalWorkspaceAction(deps, action2, args2) {
     if (missing.length > 0)
       return output6({ status: "missing_required_fields", missing, action: action2.id, editor: describeEditor(editor) });
     if (editor.kind === "knowledge-url")
-      return executeTool(deps.toolRegistry, "agent_knowledge_ingest", { sourceKind: "url", url: fieldReader(editor, fields)("url"), tags: splitList5(fieldReader(editor, fields)("tags")), folderPath: fieldReader(editor, fields)("folder"), confirm: args2.confirm, explicitUserRequest: readString54(args2.explicitUserRequest) });
+      return executeTool(deps.toolRegistry, "agent_knowledge_ingest", { sourceKind: "url", url: fieldReader(editor, fields)("url"), tags: splitList5(fieldReader(editor, fields)("tags")), folderPath: fieldReader(editor, fields)("folder"), confirm: args2.confirm, explicitUserRequest: readString55(args2.explicitUserRequest) });
     return executeTool(deps.toolRegistry, "agent_local_registry", localRegistryArgsFromEditor(editor, fields, recordId));
   }
   if (!target)
@@ -880686,19 +880748,19 @@ async function runLocalWorkspaceAction(deps, action2, args2) {
 }
 
 // src/tools/agent-harness-model-tool-catalog.ts
-function readString55(value) {
+function readString56(value) {
   return typeof value === "string" ? value.trim() : "";
 }
-function readLimit8(value, fallback) {
+function readLimit9(value, fallback) {
   const parsed = typeof value === "string" && value.trim() ? Number(value) : value;
   if (typeof parsed !== "number" || !Number.isFinite(parsed))
     return fallback;
   return Math.max(1, Math.min(500, Math.trunc(parsed)));
 }
 function listHarnessModelTools(toolRegistry, args2) {
-  const query2 = readString55(args2.query).toLowerCase();
+  const query2 = readString56(args2.query).toLowerCase();
   const includeParameters = args2.includeParameters === true;
-  const limit3 = readLimit8(args2.limit, 200);
+  const limit3 = readLimit9(args2.limit, 200);
   return toolRegistry.getToolDefinitions().filter((tool2) => !query2 || [tool2.name, tool2.description, ...tool2.sideEffects ?? []].join(`
 `).toLowerCase().includes(query2)).sort((a4, b3) => a4.name.localeCompare(b3.name)).slice(0, limit3).map((tool2) => ({
     name: tool2.name,
@@ -880711,7 +880773,7 @@ function listHarnessModelTools(toolRegistry, args2) {
   }));
 }
 function describeHarnessModelTool(toolRegistry, args2) {
-  const query2 = readString55(args2.toolName || args2.target || args2.query).toLowerCase();
+  const query2 = readString56(args2.toolName || args2.target || args2.query).toLowerCase();
   if (!query2)
     return null;
   const tool2 = toolRegistry.getToolDefinitions().find((candidate) => candidate.name.toLowerCase() === query2 || candidate.name.toLowerCase().includes(query2));
@@ -880777,11 +880839,11 @@ var AGENT_HARNESS_PARAMETER_PROPERTIES = {
   },
   query: {
     type: "string",
-    description: "Search text for command, setting, tool, or UI surface catalogs."
+    description: "Search text for command, workspace action, setting, tool, or UI surface catalogs; also a slash-command lookup for mode command."
   },
   command: {
     type: "string",
-    description: 'Full slash command string for mode run_command, for example "/settings get provider.model". In cli_command mode this may also hold a top-level CLI string such as "goodvibes-agent status --json".'
+    description: 'Full slash command string for mode command, workspace_action lookup, or run_command, for example "/settings get provider.model". In cli_command mode this may also hold a top-level CLI string such as "goodvibes-agent status --json".'
   },
   cliCommand: {
     type: "string",
@@ -880844,7 +880906,7 @@ var AGENT_HARNESS_PARAMETER_PROPERTIES = {
   },
   target: {
     type: "string",
-    description: "Optional lookup target, such as a model-picker target, settings key, model tool name, or connected-host capability id."
+    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."
   },
   capabilityId: {
     type: "string",
@@ -880985,10 +881047,10 @@ async function openTtsVoicePicker(ctx, providerArg) {
 }
 
 // src/tools/agent-harness-ui-surface-metadata.ts
-function readString56(value) {
+function readString57(value) {
   return typeof value === "string" ? value.trim() : "";
 }
-function readLimit9(value, fallback) {
+function readLimit10(value, fallback) {
   const parsed = typeof value === "string" && value.trim() ? Number(value) : value;
   if (typeof parsed !== "number" || !Number.isFinite(parsed))
     return fallback;
@@ -881011,35 +881073,35 @@ function opened(surface, extra = {}) {
   };
 }
 function optionalModelTarget(args2) {
-  const target = readString56(args2.target);
+  const target = readString57(args2.target);
   return target === "main" || target === "helper" || target === "tool" || target === "tts" ? target : undefined;
 }
 function optionalOnboardingMode(args2) {
-  const target = readString56(args2.target);
+  const target = readString57(args2.target);
   return target === "new" || target === "edit" || target === "reopen" ? target : undefined;
 }
 function workspaceCategory(args2) {
-  return readString56(args2.categoryId || args2.category || args2.target) || undefined;
+  return readString57(args2.categoryId || args2.category || args2.target) || undefined;
 }
 function settingsTarget(args2) {
-  return readString56(args2.target || args2.key || args2.prefix) || undefined;
+  return readString57(args2.target || args2.key || args2.prefix) || undefined;
 }
 function providerTarget(args2) {
-  return readString56(args2.target || args2.key || args2.prefix) || undefined;
+  return readString57(args2.target || args2.key || args2.prefix) || undefined;
 }
 function optionalPane(args2) {
-  const pane = readString56(args2.pane);
+  const pane = readString57(args2.pane);
   return pane === "top" || pane === "bottom" ? pane : undefined;
 }
 function surfaceInputText(args2) {
-  return readString56(args2.prefix || args2.key || (args2.surfaceId ? args2.query : undefined) || args2.target) || undefined;
+  return readString57(args2.prefix || args2.key || (args2.surfaceId ? args2.query : undefined) || args2.target) || undefined;
 }
 function filePickerOptions(args2) {
-  const target = readString56(args2.target).toLowerCase();
+  const target = readString57(args2.target).toLowerCase();
   const injectMode = target === "inject" || target === "inject-mode" || target === "!@";
   return {
     injectMode,
-    query: readString56(args2.prefix || args2.key || (args2.surfaceId ? args2.query : undefined)) || undefined
+    query: readString57(args2.prefix || args2.key || (args2.surfaceId ? args2.query : undefined)) || undefined
   };
 }
 function openAgentWorkspaceCategory(context, surface, categoryId, extra = {}) {
@@ -881615,19 +881677,19 @@ function totalHarnessUiSurfaces() {
   return UI_SURFACES.length;
 }
 function listHarnessUiSurfaces(context, args2) {
-  const query2 = readString56(args2.query);
-  const limit3 = readLimit9(args2.limit, 200);
+  const query2 = readString57(args2.query);
+  const limit3 = readLimit10(args2.limit, 200);
   return UI_SURFACES.map((surface) => describeSurface(context, surface)).filter((surface) => surfaceMatches(surface, query2)).slice(0, limit3);
 }
 function describeHarnessUiSurface(context, args2) {
-  const surfaceId = readString56(args2.surfaceId || args2.query);
+  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;
 }
 async function openHarnessUiSurface(context, args2) {
-  const surfaceId = readString56(args2.surfaceId || args2.query);
+  const surfaceId = readString57(args2.surfaceId || args2.query);
   const surface = UI_SURFACES.find((entry) => entry.id === surfaceId || entry.label.toLowerCase() === surfaceId.toLowerCase());
   if (!surface) {
     return {
@@ -881647,16 +881709,16 @@ async function openHarnessUiSurface(context, args2) {
 function isMode(value) {
   return typeof value === "string" && AGENT_HARNESS_MODES.includes(value);
 }
-function readString57(value) {
+function readString58(value) {
   return typeof value === "string" ? value.trim() : "";
 }
-function readLimit10(value, fallback) {
+function readLimit11(value, fallback) {
   const parsed = typeof value === "string" && value.trim() ? Number(value) : value;
   if (typeof parsed !== "number" || !Number.isFinite(parsed))
     return fallback;
   return Math.max(1, Math.min(500, Math.trunc(parsed)));
 }
-function readStringArray12(value) {
+function readStringArray13(value) {
   if (!Array.isArray(value))
     return [];
   return value.map((entry) => typeof entry === "string" ? entry : String(entry));
@@ -881675,30 +881737,6 @@ function output7(value) {
 function error52(message) {
   return { success: false, error: message };
 }
-function commandMatches(command8, query2) {
-  if (!query2)
-    return true;
-  const haystack = [
-    command8.name,
-    ...command8.aliases ?? [],
-    command8.description,
-    command8.usage ?? "",
-    command8.argsHint ?? ""
-  ].join(`
-`).toLowerCase();
-  return haystack.includes(query2.toLowerCase());
-}
-function describeCommand(command8) {
-  return {
-    name: command8.name,
-    slash: `/${command8.name}`,
-    aliases: command8.aliases ?? [],
-    description: command8.description,
-    usage: command8.usage ?? "",
-    argsHint: command8.argsHint ?? command8.usage ?? "",
-    policy: describeCommandPolicy(command8.name)
-  };
-}
 function allWorkspaceActions() {
   return AGENT_WORKSPACE_CATEGORIES.flatMap((category) => category.actions.map((action2) => ({ category, action: action2 })));
 }
@@ -881731,7 +881769,7 @@ function describeWorkspaceEditor(editor) {
 }
 function selectedRoutineFromArgs(snapshot, args2) {
   const fields = readFieldMap3(args2.fields);
-  const routineId = readString57(args2.recordId) || readString57(fields.routineId) || readString57(fields.id);
+  const routineId = readString58(args2.recordId) || readString58(fields.routineId) || readString58(fields.id);
   if (!routineId)
     return null;
   return snapshot.localRoutines.find((routine) => routine.id === routineId || routine.name.toLowerCase() === routineId.toLowerCase()) ?? null;
@@ -881772,6 +881810,7 @@ function describeWorkspaceAction(category, action2, options = {}) {
     ...action2.editorKind ? { editorKind: action2.editorKind } : {},
     ...action2.localKind ? { localKind: action2.localKind } : {},
     ...action2.localOperation ? { localOperation: action2.localOperation } : {},
+    ...options.lookup ? { lookup: options.lookup } : {},
     ...editor ? { editor: describeWorkspaceEditor(editor) } : {},
     ...action2.kind === "local-selection" || action2.kind === "local-operation" ? {
       modelExecution: describeLocalWorkspaceModelExecution(action2)
@@ -881799,17 +881838,17 @@ function localEditorModelExecution(editorKind) {
   return "Use the command field, editor schema, or a first-class Agent model tool when available.";
 }
 function listWorkspaceActions(deps, args2) {
-  const query2 = readString57(args2.query);
-  const categoryId = readString57(args2.categoryId || args2.category);
-  const limit3 = readLimit10(args2.limit, 200);
+  const query2 = readString58(args2.query);
+  const categoryId = readString58(args2.categoryId || args2.category);
+  const limit3 = readLimit11(args2.limit, 200);
   const includeEditor = args2.includeParameters === true;
   const editorContext = includeEditor ? buildWorkspaceEditorContext(deps.commandContext, args2) : null;
   const source = query2 ? searchAgentWorkspaceActions(AGENT_WORKSPACE_CATEGORIES, query2).map((result2) => ({ category: result2.category, action: result2.action })) : allWorkspaceActions();
   return source.filter((entry) => !categoryId || entry.category.id === categoryId).slice(0, limit3).map((entry) => describeWorkspaceAction(entry.category, entry.action, { includeEditor, editorContext }));
 }
 function findWorkspaceAction(args2) {
-  const actionId = readString57(args2.actionId || args2.query);
-  const categoryId = readString57(args2.categoryId || args2.category);
+  const actionId = readString58(args2.actionId || args2.query);
+  const categoryId = readString58(args2.categoryId || args2.category);
   if (!actionId)
     return null;
   return allWorkspaceActions().find((entry) => {
@@ -881818,13 +881857,59 @@ function findWorkspaceAction(args2) {
     return entry.action.id === actionId || entry.action.label.toLowerCase() === actionId.toLowerCase();
   }) ?? null;
 }
-function listCommands(commandRegistry, args2) {
-  const query2 = readString57(args2.query);
-  const limit3 = readLimit10(args2.limit, 200);
-  return commandRegistry.list().filter((command8) => commandMatches(command8, query2)).sort((a4, b3) => a4.name.localeCompare(b3.name)).slice(0, limit3).map(describeCommand);
+function workspaceActionLookupFromArgs(args2) {
+  const actionId = readString58(args2.actionId);
+  if (actionId)
+    return { source: "actionId", input: actionId };
+  const command8 = readString58(args2.command);
+  if (command8)
+    return { source: "command", input: command8 };
+  const target = readString58(args2.target);
+  if (target)
+    return { source: "target", input: target };
+  const query2 = readString58(args2.query);
+  return query2 ? { source: "query", input: query2 } : null;
+}
+function describeWorkspaceActionCandidates(entries) {
+  return entries.slice(0, 8).map((entry) => ({
+    actionId: entry.action.id,
+    categoryId: entry.category.id,
+    label: entry.action.label,
+    ...entry.action.command ? { command: entry.action.command } : {}
+  }));
+}
+function resolveWorkspaceActionDetail(args2) {
+  const lookup = workspaceActionLookupFromArgs(args2);
+  const categoryId = readString58(args2.categoryId || args2.category);
+  if (!lookup)
+    return null;
+  const entries = allWorkspaceActions().filter((entry) => !categoryId || entry.category.id === categoryId);
+  const normalized = lookup.input.toLowerCase();
+  const commandInput = lookup.source === "command" ? lookup.input.trim() : "";
+  const exactId = entries.find((entry) => entry.action.id === lookup.input);
+  if (exactId)
+    return { status: "found", ...exactId, lookup: { ...lookup, resolvedBy: "id" } };
+  const exactLabel = entries.find((entry) => entry.action.label === lookup.input);
+  if (exactLabel)
+    return { status: "found", ...exactLabel, lookup: { ...lookup, resolvedBy: "label" } };
+  const exactCommand = commandInput ? entries.find((entry) => entry.action.command === commandInput) : null;
+  if (exactCommand)
+    return { status: "found", ...exactCommand, lookup: { ...lookup, resolvedBy: "command" } };
+  const insensitiveId = entries.find((entry) => entry.action.id.toLowerCase() === normalized);
+  if (insensitiveId)
+    return { status: "found", ...insensitiveId, lookup: { ...lookup, resolvedBy: "case-insensitive-id" } };
+  const insensitiveLabel = entries.find((entry) => entry.action.label.toLowerCase() === normalized);
+  if (insensitiveLabel)
+    return { status: "found", ...insensitiveLabel, lookup: { ...lookup, resolvedBy: "case-insensitive-label" } };
+  const searched = searchAgentWorkspaceActions(AGENT_WORKSPACE_CATEGORIES, lookup.input).map((result2) => ({ category: result2.category, action: result2.action })).filter((entry) => !categoryId || entry.category.id === categoryId);
+  if (searched.length === 1)
+    return { status: "found", ...searched[0], lookup: { ...lookup, resolvedBy: "search" } };
+  if (searched.length > 1)
+    return { status: "ambiguous", input: lookup.input, candidates: describeWorkspaceActionCandidates(searched) };
+  return null;
 }
 function requireConfirmedAction(args2, action2) {
-  const explicitUserRequest = readString57(args2.explicitUserRequest);
+  const explicitUserRequest = readString58(args2.explicitUserRequest);
   if (!explicitUserRequest)
     return `${action2} requires explicitUserRequest with the user's exact request or a short faithful summary.`;
   if (args2.confirm !== true)
@@ -881832,7 +881917,7 @@ function requireConfirmedAction(args2, action2) {
   return null;
 }
 function commandFromArgs(args2) {
-  const rawCommand = readString57(args2.command);
+  const rawCommand = readString58(args2.command);
   if (rawCommand) {
     const parsed = parseSlashCommand(rawCommand);
     if (!parsed.name)
@@ -881842,10 +881927,10 @@ function commandFromArgs(args2) {
       args: parsed.args
     };
   }
-  const commandName = readString57(args2.commandName).replace(/^\//, "");
+  const commandName = readString58(args2.commandName).replace(/^\//, "");
   if (!commandName)
     return null;
-  const commandArgs = readStringArray12(args2.args);
+  const commandArgs = readStringArray13(args2.args);
   return {
     name: commandName,
     args: commandArgs
@@ -882069,8 +882154,8 @@ function createAgentHarnessTool(deps) {
               panels: 'Use mode:"panels" and mode:"panel" to inspect built-in panel catalog/open state; use mode:"open_panel" with confirm:true plus explicitUserRequest to route a visible panel/workspace change.',
               uiSurfaces: 'Use mode:"ui_surfaces" and mode:"ui_surface" to inspect modal/overlay/picker/workspace surfaces; use mode:"open_ui_surface" with confirm:true plus explicitUserRequest to route visible UI navigation.',
               shortcuts: 'Use mode:"shortcuts" to inspect fixed shortcuts plus configurable keybindings. Use mode:"set_keybinding" and mode:"reset_keybinding" with confirm:true plus explicitUserRequest to edit the same config file the user edits.',
-              slashCommands: 'Use mode:"commands" and mode:"command" to inspect; use mode:"run_command" with confirm:true plus explicitUserRequest to execute.',
-              workspace: 'Use mode:"workspace_actions" to list and mode:"workspace_action" for editor schemas; set includeParameters:true on workspace_actions to inline editor schemas.',
+              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".',
               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.',
@@ -882104,7 +882189,7 @@ function createAgentHarnessTool(deps) {
         }
         if (args2.mode === "panel") {
           const panel = describeHarnessPanel(deps.commandContext, args2);
-          return panel ? output7(panel) : error52(`Unknown panel ${readString57(args2.panelId || args2.query) || "<missing>"}.`);
+          return panel ? output7(panel) : error52(`Unknown panel ${readString58(args2.panelId || args2.query) || "<missing>"}.`);
         }
         if (args2.mode === "open_panel") {
           const confirmationError2 = requireConfirmedAction(args2, "Panel routing");
@@ -882118,7 +882203,7 @@ function createAgentHarnessTool(deps) {
         }
         if (args2.mode === "ui_surface") {
           const surface = describeHarnessUiSurface(deps.commandContext, args2);
-          return surface ? output7(surface) : error52(`Unknown UI surface ${readString57(args2.surfaceId || args2.query) || "<missing>"}.`);
+          return surface ? output7(surface) : error52(`Unknown UI surface ${readString58(args2.surfaceId || args2.query) || "<missing>"}.`);
         }
         if (args2.mode === "open_ui_surface") {
           const confirmationError2 = requireConfirmedAction(args2, "UI surface routing");
@@ -882132,7 +882217,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 ${readString57(args2.actionId || args2.key || args2.query) || "<missing>"}.`);
+          return binding ? output7(binding) : error52(`Unknown keybinding action ${readString58(args2.actionId || args2.key || args2.query) || "<missing>"}.`);
         }
         if (args2.mode === "set_keybinding") {
           const confirmationError2 = requireConfirmedAction(args2, "Keybinding mutation");
@@ -882147,28 +882232,28 @@ function createAgentHarnessTool(deps) {
           return output7(resetHarnessKeybinding(deps.commandContext, args2));
         }
         if (args2.mode === "commands") {
-          const commands3 = listCommands(deps.commandRegistry, args2);
+          const commands3 = listHarnessCommands(deps.commandRegistry, args2);
           return output7({ commands: commands3, returned: commands3.length, total: deps.commandRegistry.list().length });
         }
         if (args2.mode === "command") {
-          const name51 = readString57(args2.commandName).replace(/^\//, "");
-          const command8 = name51 ? deps.commandRegistry.get(name51) : null;
-          return command8 ? output7(describeCommand(command8)) : error52(`Unknown slash command /${name51 || "<missing>"}.`);
+          const detail = describeHarnessCommand(deps.commandRegistry, args2);
+          const query2 = readString58(args2.command || args2.commandName || args2.target || args2.query);
+          return detail ? output7(detail) : error52(`Unknown slash command ${query2 || "<missing>"}. Use mode:"commands" to inspect available commands.`);
         }
         if (args2.mode === "run_command")
           return runCommand2(deps, args2);
         if (args2.mode === "settings") {
           const settings = listHarnessSettings(deps.commandContext.platform.configManager, {
-            category: readString57(args2.category) || undefined,
-            prefix: readString57(args2.prefix) || undefined,
-            query: readString57(args2.query) || undefined,
+            category: readString58(args2.category) || undefined,
+            prefix: readString58(args2.prefix) || undefined,
+            query: readString58(args2.query) || undefined,
             includeHidden: args2.includeHidden === true,
-            limit: readLimit10(args2.limit, 100)
+            limit: readLimit11(args2.limit, 100)
           });
           return output7({ settings, returned: settings.length, policy: settingsPolicySummary() });
         }
         if (args2.mode === "get_setting") {
-          const key = readString57(args2.key);
+          const key = readString58(args2.key);
           const setting = getHarnessSetting(deps.commandContext.platform.configManager, key);
           return setting ? output7(setting) : error52(`Unknown setting ${key || "<missing>"}.`);
         }
@@ -882178,7 +882263,7 @@ function createAgentHarnessTool(deps) {
             return error52(confirmationError2);
           if (args2.value === undefined)
             return error52("set_setting requires value.");
-          const key = readString57(args2.key);
+          const key = readString58(args2.key);
           const result2 = await setHarnessSetting(deps.commandContext.platform.configManager, deps.commandContext.platform.secretsManager, key, args2.value);
           return output7(result2);
         }
@@ -882186,7 +882271,7 @@ function createAgentHarnessTool(deps) {
           const confirmationError2 = requireConfirmedAction(args2, "Setting reset");
           if (confirmationError2)
             return error52(confirmationError2);
-          const key = readString57(args2.key);
+          const key = readString58(args2.key);
           const result2 = await resetHarnessSetting(deps.commandContext.platform.configManager, deps.commandContext.platform.secretsManager, key);
           return output7(result2);
         }
@@ -882201,9 +882286,15 @@ function createAgentHarnessTool(deps) {
           return output7({ actions, returned: actions.length, total: allWorkspaceActions().length });
         }
         if (args2.mode === "workspace_action") {
-          const found = findWorkspaceAction(args2);
+          const resolved = resolveWorkspaceActionDetail(args2);
           const editorContext = buildWorkspaceEditorContext(deps.commandContext, args2);
-          return found ? output7(describeWorkspaceAction(found.category, found.action, { includeEditor: true, editorContext })) : error52(`Unknown Agent workspace action ${readString57(args2.actionId || args2.query) || "<missing>"}.`);
+          if (resolved?.status === "found") {
+            return output7(describeWorkspaceAction(resolved.category, resolved.action, { includeEditor: true, editorContext, lookup: resolved.lookup }));
+          }
+          if (resolved?.status === "ambiguous") {
+            return error52(`Ambiguous Agent workspace action ${resolved.input}. Candidates: ${JSON.stringify(resolved.candidates)}`);
+          }
+          return error52(`Unknown Agent workspace action ${readString58(args2.actionId || args2.command || args2.target || args2.query) || "<missing>"}. Use mode:"workspace_actions" to inspect available actions.`);
         }
         if (args2.mode === "run_workspace_action")
           return runWorkspaceAction(deps, args2);
@@ -882212,14 +882303,14 @@ function createAgentHarnessTool(deps) {
           return output7({ tools: tools3, returned: tools3.length, total: deps.toolRegistry.getToolDefinitions().length });
         }
         if (args2.mode === "tool") {
-          const query2 = readString57(args2.toolName || args2.target || args2.query);
+          const query2 = readString58(args2.toolName || args2.target || args2.query);
           const tool2 = describeHarnessModelTool(deps.toolRegistry, args2);
           return tool2 ? output7(tool2) : error52(`Unknown model tool ${query2 || "<missing>"}. Use mode:"tools" to inspect available model tools.`);
         }
         if (args2.mode === "connected_host")
           return output7(connectedHostSummary(deps.commandContext, deps.toolRegistry));
         if (args2.mode === "connected_host_capability") {
-          const query2 = readString57(args2.capabilityId || args2.target || args2.query);
+          const query2 = readString58(args2.capabilityId || args2.target || args2.query);
           const capability = describeConnectedHostCapability(deps.toolRegistry, query2);
           return capability ? output7(capability) : error52(`Unknown connected-host capability ${query2 || "<missing>"}. Use mode:"connected_host" to inspect allowed and blocked capability ids.`);
         }