@pellux/goodvibes-agent 1.0.19 → 1.0.21

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.19";
+var _version = "1.0.21";
 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,
@@ -880225,9 +880283,133 @@ function describeBinding(manager5, action2, combos, lookup) {
     labels: combos.map((combo) => manager5.formatCombo(combo)),
     defaultBindings: defaults3.map((combo) => describeCombo(manager5, combo)),
     customized,
-    source: customized ? "custom" : "default"
+    source: customized ? "custom" : "default",
+    modelOperation: keybindingOperationRoute(action2)
   };
 }
+function keybindingOperationRoute(action2) {
+  switch (action2) {
+    case "clear-cancel":
+      return {
+        supported: true,
+        effect: "shell-action",
+        preferredMode: "run_keybinding",
+        confirmation: 'agent_harness mode:"run_keybinding" requires confirm:true and explicitUserRequest.',
+        note: "Routes the cancel-generation side of this shortcut through commandContext.cancelGeneration. Prompt clearing and double-press exit remain direct user interaction."
+      };
+    case "screen-clear":
+      return {
+        supported: true,
+        effect: "shell-action",
+        preferredMode: "run_keybinding",
+        confirmation: 'agent_harness mode:"run_keybinding" requires confirm:true and explicitUserRequest.',
+        note: "Routes through commandContext.clearScreen."
+      };
+    case "panel-picker":
+      return {
+        supported: true,
+        effect: "visible-ui-navigation",
+        preferredMode: "run_keybinding",
+        surfaceId: "agent-workspace",
+        confirmation: 'agent_harness mode:"run_keybinding" requires confirm:true and explicitUserRequest.',
+        note: "Opens the same Agent workspace home route as the panel-picker shortcut."
+      };
+    case "panel-close":
+      return {
+        supported: true,
+        effect: "visible-ui-navigation",
+        preferredMode: "run_keybinding",
+        confirmation: 'agent_harness mode:"run_keybinding" requires confirm:true and explicitUserRequest.',
+        note: "Closes the active legacy panel if present, then focuses the prompt when the shell bridge exposes focusPrompt."
+      };
+    case "panel-close-all":
+      return {
+        supported: true,
+        effect: "visible-ui-navigation",
+        preferredMode: "run_keybinding",
+        confirmation: 'agent_harness mode:"run_keybinding" requires confirm:true and explicitUserRequest.',
+        note: "Closes all legacy panels if present, hides the panel manager, then focuses the prompt when the shell bridge exposes focusPrompt."
+      };
+    case "history-search":
+      return {
+        supported: true,
+        effect: "visible-ui-navigation",
+        preferredMode: "run_keybinding",
+        surfaceId: "prompt-history-search",
+        confirmation: 'agent_harness mode:"run_keybinding" requires confirm:true and explicitUserRequest.',
+        note: "Opens the visible prompt-history search overlay; optional search text may be supplied with value."
+      };
+    case "search":
+      return {
+        supported: true,
+        effect: "visible-ui-navigation",
+        preferredMode: "run_keybinding",
+        surfaceId: "conversation-search",
+        confirmation: 'agent_harness mode:"run_keybinding" requires confirm:true and explicitUserRequest.',
+        note: "Opens the visible conversation search overlay; optional search text may be supplied with value."
+      };
+    case "paste":
+      return {
+        supported: true,
+        effect: "shell-action",
+        preferredMode: "run_keybinding",
+        command: "/paste",
+        confirmation: 'agent_harness mode:"run_keybinding" requires confirm:true and explicitUserRequest.',
+        note: "Routes through commandContext.pasteFromClipboard and reports whether text, image, or nothing was pasted."
+      };
+    case "block-copy":
+    case "bookmark":
+    case "block-save":
+      return {
+        supported: true,
+        effect: "visible-ui-interaction",
+        preferredMode: "run_keybinding",
+        surfaceId: "block-actions",
+        confirmation: 'agent_harness mode:"run_keybinding" requires confirm:true and explicitUserRequest.',
+        note: "Opens the visible nearest-block actions surface. The exact block action remains an interactive visible-shell selection because it depends on cursor/scroll position."
+      };
+    case "panel-tab-next":
+    case "panel-tab-prev":
+      return {
+        supported: false,
+        effect: "visible-ui-navigation",
+        preferredMode: "open_ui_surface",
+        surfaceId: "agent-workspace",
+        confirmation: "Use open_ui_surface with confirm:true and an explicit categoryId/target instead of cycling hidden UI state.",
+        note: "Category cycling depends on the live workspace focus position. The model should open the intended Agent workspace category directly."
+      };
+    case "copy-selection":
+      return {
+        supported: false,
+        effect: "clipboard-selection",
+        preferredMode: "direct-user-interaction",
+        confirmation: "No model operation is exposed.",
+        note: "Terminal text selection is outside the Agent command context. Use transcript/session export or a content-specific model route when a concrete artifact is needed."
+      };
+    case "delete-word":
+    case "line-start":
+    case "next-error-line-end":
+    case "kill-line":
+    case "clear-prompt":
+    case "undo":
+    case "redo":
+      return {
+        supported: false,
+        effect: "prompt-editor-state",
+        preferredMode: "direct-user-interaction",
+        confirmation: "No model operation is exposed.",
+        note: "This shortcut mutates live prompt-buffer cursor/edit state that is not part of the model tool contract."
+      };
+    case "replay-panel":
+      return {
+        supported: false,
+        effect: "reserved",
+        preferredMode: "direct-user-interaction",
+        confirmation: "No model operation is exposed.",
+        note: "This shortcut is reserved and has no current Agent operation route."
+      };
+  }
+}
 function readOverrideFile(configPath) {
   if (!existsSync82(configPath))
     return {};
@@ -880259,7 +880441,7 @@ ${shortcut.description}`.toLowerCase().includes(query2)).slice(0, readLimit7(arg
     configurableKeybindings: keybindings.keybindings,
     returned: fixed.length + Number(keybindings.returned ?? 0),
     total: totalHarnessShortcuts(context),
-    policy: "Fixed shortcuts are runtime/editor controls. Configurable keybindings can be changed with set_keybinding/reset_keybinding."
+    policy: "Fixed shortcuts are runtime/editor controls. Configurable keybindings can be inspected, supported shell-safe actions can be run with run_keybinding, and bindings can be changed with set_keybinding/reset_keybinding."
   };
 }
 function listHarnessKeybindings(context, args2) {
@@ -880271,7 +880453,7 @@ function listHarnessKeybindings(context, args2) {
     keybindings: entries,
     returned: entries.length,
     total: manager5.getAll().length,
-    policy: "Reads the live resolved keybindings. set_keybinding/reset_keybinding write the same keybindings.json file the user can edit and reload the runtime manager."
+    policy: "Reads the live resolved keybindings, including modelOperation route metadata. run_keybinding executes only supported shell-safe actions. set_keybinding/reset_keybinding write the same keybindings.json file the user can edit and reload the runtime manager."
   };
 }
 function describeHarnessKeybinding(context, args2) {
@@ -880287,6 +880469,143 @@ function describeHarnessKeybinding(context, args2) {
     ...describeBinding(manager5, entry.action, entry.combos, resolved.lookup)
   } : null;
 }
+function runUnavailable(action2, route, reason) {
+  return {
+    status: "keybinding_route_unavailable",
+    action: action2,
+    modelOperation: route,
+    ...reason ? { reason } : {}
+  };
+}
+function runHarnessKeybinding(context, args2) {
+  const manager5 = requireKeybindingsManager2(context);
+  const resolved = resolveHarnessKeybinding(context, args2);
+  if (resolved?.status === "ambiguous")
+    return { status: "ambiguous", input: resolved.input, candidates: resolved.candidates };
+  if (!resolved)
+    throw new Error("run_keybinding requires a valid keybinding action id, target, key, or query.");
+  const entry = manager5.getAll().find((candidate) => candidate.action === resolved.action);
+  if (!entry)
+    throw new Error(`No live keybinding entry found for ${resolved.action}.`);
+  const route = keybindingOperationRoute(resolved.action);
+  const descriptor = {
+    configPath: manager5.getConfigPath(),
+    ...describeBinding(manager5, entry.action, entry.combos, resolved.lookup)
+  };
+  if (!route.supported) {
+    return {
+      status: "unsupported_keybinding_action",
+      action: resolved.action,
+      keybinding: descriptor,
+      modelOperation: route
+    };
+  }
+  switch (resolved.action) {
+    case "clear-cancel":
+      if (!context.cancelGeneration)
+        return runUnavailable(resolved.action, route, "commandContext.cancelGeneration is unavailable.");
+      context.cancelGeneration();
+      return { status: "executed", action: resolved.action, effect: "cancel-generation", keybinding: descriptor };
+    case "screen-clear":
+      if (!context.clearScreen)
+        return runUnavailable(resolved.action, route, "commandContext.clearScreen is unavailable.");
+      context.clearScreen();
+      return { status: "executed", action: resolved.action, effect: "screen-clear", keybinding: descriptor };
+    case "panel-picker":
+      if (context.openPanelPicker) {
+        context.openPanelPicker();
+        return { status: "executed", action: resolved.action, effect: "agent-workspace-opened", route: "openPanelPicker", keybinding: descriptor };
+      }
+      if (context.openAgentWorkspace) {
+        context.openAgentWorkspace("home");
+        return { status: "executed", action: resolved.action, effect: "agent-workspace-opened", route: "openAgentWorkspace", categoryId: "home", keybinding: descriptor };
+      }
+      return runUnavailable(resolved.action, route, "No panel picker or Agent workspace opener is available.");
+    case "panel-close": {
+      const active = context.workspace.panelManager?.getActivePanel() ?? null;
+      if (active)
+        context.workspace.panelManager?.close(active.id);
+      if (!active && !context.focusPrompt)
+        return runUnavailable(resolved.action, route, "No active legacy panel or prompt focus route is available.");
+      if (context.focusPrompt)
+        context.focusPrompt();
+      context.renderRequest();
+      return {
+        status: "executed",
+        action: resolved.action,
+        effect: active ? "active-panel-closed" : "prompt-focused",
+        ...active ? { panelId: active.id } : {},
+        keybinding: descriptor
+      };
+    }
+    case "panel-close-all": {
+      const managerPanel = context.workspace.panelManager;
+      const openPanels = managerPanel?.getAllOpen() ?? [];
+      for (const panel of openPanels)
+        managerPanel?.close(panel.id);
+      managerPanel?.hide();
+      if (openPanels.length === 0 && !context.focusPrompt)
+        return runUnavailable(resolved.action, route, "No open legacy panels or prompt focus route is available.");
+      if (context.focusPrompt)
+        context.focusPrompt();
+      context.renderRequest();
+      return {
+        status: "executed",
+        action: resolved.action,
+        effect: "all-panels-closed",
+        closedPanels: openPanels.map((panel) => panel.id),
+        keybinding: descriptor
+      };
+    }
+    case "history-search": {
+      if (!context.openPromptHistorySearch)
+        return runUnavailable(resolved.action, route, "commandContext.openPromptHistorySearch is unavailable.");
+      const query2 = readString52(args2.value);
+      context.openPromptHistorySearch(query2 || undefined);
+      return { status: "executed", action: resolved.action, effect: "prompt-history-search-opened", query: query2, keybinding: descriptor };
+    }
+    case "search": {
+      if (!context.openConversationSearch)
+        return runUnavailable(resolved.action, route, "commandContext.openConversationSearch is unavailable.");
+      const query2 = readString52(args2.value);
+      context.openConversationSearch(query2 || undefined);
+      return { status: "executed", action: resolved.action, effect: "conversation-search-opened", query: query2, keybinding: descriptor };
+    }
+    case "paste": {
+      if (!context.pasteFromClipboard)
+        return runUnavailable(resolved.action, route, "commandContext.pasteFromClipboard is unavailable.");
+      const pasted = context.pasteFromClipboard();
+      return { status: "executed", action: resolved.action, effect: "paste-from-clipboard", pasted, keybinding: descriptor };
+    }
+    case "block-copy":
+    case "bookmark":
+    case "block-save": {
+      if (!context.openBlockActions)
+        return runUnavailable(resolved.action, route, "commandContext.openBlockActions is unavailable.");
+      const opened = context.openBlockActions();
+      return opened ? {
+        status: "visible_interaction_required",
+        action: resolved.action,
+        effect: "block-actions-opened",
+        keybinding: descriptor,
+        note: "The block action surface is open. Selecting the exact nearest-block action remains visible interactive shell work."
+      } : {
+        status: "not_opened",
+        action: resolved.action,
+        effect: "block-actions",
+        keybinding: descriptor,
+        note: "The current shell did not have an empty prompt plus nearby block required for block actions."
+      };
+    }
+    default:
+      return {
+        status: "unsupported_keybinding_action",
+        action: resolved.action,
+        keybinding: descriptor,
+        modelOperation: route
+      };
+  }
+}
 function setHarnessKeybinding(context, args2) {
   const manager5 = requireKeybindingsManager2(context);
   const resolved = resolveHarnessKeybinding(context, args2);
@@ -881056,6 +881375,7 @@ var AGENT_HARNESS_MODES = [
   "shortcuts",
   "keybindings",
   "keybinding",
+  "run_keybinding",
   "set_keybinding",
   "reset_keybinding",
   "commands",
@@ -881094,7 +881414,7 @@ var AGENT_HARNESS_PARAMETER_PROPERTIES = {
   },
   command: {
     type: "string",
-    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".'
+    description: 'Full slash command string for mode command, workspace_action/run_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",
@@ -881123,7 +881443,7 @@ var AGENT_HARNESS_PARAMETER_PROPERTIES = {
   },
   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. target or query can also look up one keybinding action."
+    description: "Agent workspace action id for workspace_action or run_workspace_action, or keybinding action id for keybinding/run_keybinding/set_keybinding/reset_keybinding. command, target, or query can also look up one workspace action; target or query can also look up one keybinding action."
   },
   fields: {
     type: "object",
@@ -881153,7 +881473,7 @@ var AGENT_HARNESS_PARAMETER_PROPERTIES = {
       { type: "number" },
       { type: "boolean" }
     ],
-    description: "Setting value for set_setting. Strings, booleans, numbers, and enum strings are accepted."
+    description: "Setting value for set_setting. Strings, booleans, numbers, and enum strings are accepted. In run_keybinding, value can provide visible search text for search/history-search shortcut routes."
   },
   target: {
     type: "string",
@@ -881194,11 +881514,11 @@ var AGENT_HARNESS_PARAMETER_PROPERTIES = {
   },
   confirm: {
     type: "boolean",
-    description: "Required true for set_setting, reset_setting, run_command, open_panel, open_ui_surface, and mutating run_workspace_action calls after an explicit user request."
+    description: "Required true for set_setting, reset_setting, run_keybinding, run_command, open_panel, open_ui_surface, and mutating run_workspace_action calls after an explicit user request."
   },
   explicitUserRequest: {
     type: "string",
-    description: "Exact user request or faithful short summary authorizing a setting mutation or harness UI/command invocation."
+    description: "Exact user request or faithful short summary authorizing a setting mutation, keybinding action, or harness UI/command invocation."
   }
 };
 
@@ -881862,7 +882182,7 @@ var UI_SURFACES = [
     kind: "overlay",
     summary: "Keyboard shortcut reference overlay.",
     command: "/shortcuts",
-    preferredModelRoute: "Use shortcuts/keybindings modes for model-readable discovery and confirmed keybinding edits.",
+    preferredModelRoute: "Use shortcuts/keybindings modes for model-readable discovery, run_keybinding for supported shell-safe actions, and confirmed keybinding edits for binding changes.",
     available: (context) => typeof context.openShortcutsOverlay === "function",
     open: (context) => {
       const surface = findSurfaceById("shortcuts-overlay");
@@ -882162,17 +882482,6 @@ function listWorkspaceActions(deps, args2) {
   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 = readString58(args2.actionId || args2.query);
-  const categoryId = readString58(args2.categoryId || args2.category);
-  if (!actionId)
-    return null;
-  return allWorkspaceActions().find((entry) => {
-    if (categoryId && entry.category.id !== categoryId)
-      return false;
-    return entry.action.id === actionId || entry.action.label.toLowerCase() === actionId.toLowerCase();
-  }) ?? null;
-}
 function workspaceActionLookupFromArgs(args2) {
   const actionId = readString58(args2.actionId);
   if (actionId)
@@ -882380,10 +882689,12 @@ async function runWorkspaceEditorAction(deps, action2, editor, args2) {
   });
 }
 async function runWorkspaceAction(deps, args2) {
-  const found = findWorkspaceAction(args2);
-  if (!found)
-    return error52('run_workspace_action requires a valid actionId. Use mode:"workspace_actions" to inspect available actions.');
-  const { category, action: action2 } = found;
+  const resolved = resolveWorkspaceActionDetail(args2);
+  if (resolved?.status === "ambiguous")
+    return error52(`Ambiguous Agent workspace action ${resolved.input}. Candidates: ${JSON.stringify(resolved.candidates)}`);
+  if (!resolved)
+    return error52('run_workspace_action requires a valid actionId, command, target, or query. Use mode:"workspace_actions" to inspect available actions.');
+  const { category, action: action2, lookup } = resolved;
   if (action2.safety === "blocked") {
     return error52(`Workspace action ${action2.id} is blocked in Agent: ${action2.detail}`);
   }
@@ -882391,14 +882702,14 @@ async function runWorkspaceAction(deps, args2) {
     const editorContext2 = buildWorkspaceEditorContext(deps.commandContext, args2);
     return output7({
       status: "guidance",
-      action: describeWorkspaceAction(category, action2, { includeEditor: true, editorContext: editorContext2 })
+      action: describeWorkspaceAction(category, action2, { includeEditor: true, editorContext: editorContext2, lookup })
     });
   }
   if (action2.kind === "workspace" && action2.targetCategoryId) {
     const target = AGENT_WORKSPACE_CATEGORIES.find((entry) => entry.id === action2.targetCategoryId);
     return output7({
       status: "workspace_target",
-      action: describeWorkspaceAction(category, action2),
+      action: describeWorkspaceAction(category, action2, { lookup }),
       targetCategory: target ? describeWorkspaceCategory(target) : action2.targetCategoryId,
       targetActions: target ? target.actions.map((entry) => describeWorkspaceAction(target, entry)).slice(0, 40) : []
     });
@@ -882407,7 +882718,7 @@ async function runWorkspaceAction(deps, args2) {
     if (/<[^>\s]+(?:\s+[^>]*)?>/.test(action2.command)) {
       return output7({
         status: "needs_concrete_command",
-        action: describeWorkspaceAction(category, action2),
+        action: describeWorkspaceAction(category, action2, { lookup }),
         note: 'This workspace action is a command template. Provide concrete values with mode:"run_command" once the exact command is known.'
       });
     }
@@ -882425,7 +882736,7 @@ async function runWorkspaceAction(deps, args2) {
   const editorContext = buildWorkspaceEditorContext(deps.commandContext, args2);
   return output7({
     status: "no_direct_effect",
-    action: describeWorkspaceAction(category, action2, { includeEditor: true, editorContext })
+    action: describeWorkspaceAction(category, action2, { includeEditor: true, editorContext, lookup })
   });
 }
 function createAgentHarnessTool(deps) {
@@ -882435,7 +882746,7 @@ function createAgentHarnessTool(deps) {
       description: [
         "Discover and operate the GoodVibes Agent harness from the main conversation.",
         "Use this tool to inspect Agent workspace actions, built-in panels, top-level CLI mirrors, UI surfaces, keybindings, slash commands with policy metadata, model tools or one model tool schema, connected-host capabilities or one connected-host capability detail, and Agent settings, or to invoke a workspace action/command through the same in-process command registry the user uses in the TUI.",
-        "Discovery modes are read-only. Setting/keybinding writes, resets, UI routing, slash command invocation, and workspace action invocation require confirm:true plus explicitUserRequest.",
+        "Discovery modes are read-only. Setting/keybinding writes, resets, keybinding actions, UI routing, slash command invocation, and workspace action invocation require confirm:true plus explicitUserRequest.",
         "This tool preserves Agent product boundaries: connected-host lifecycle and listener posture stay externally owned, connected-host mode reports allowed and blocked route families, and secret-backed settings store raw values through the secret manager while config receives only a secret reference."
       ].join(" "),
       parameters: {
@@ -882469,9 +882780,9 @@ function createAgentHarnessTool(deps) {
               cliCommands: 'Use mode:"cli_commands" to list and mode:"cli_command" with cliCommand, command, commandName, target, or query to inspect package CLI mirrors and their preferred in-process model routes. CLI modes are discovery-only.',
               panels: 'Use mode:"panels" to list and mode:"panel" with panelId, target, or query to inspect built-in panel catalog/open state; use mode:"open_panel" with confirm:true plus explicitUserRequest to route a visible panel/workspace change.',
               uiSurfaces: 'Use mode:"ui_surfaces" to list and mode:"ui_surface" with surfaceId, target, or query to inspect modal/overlay/picker/workspace surfaces; use mode:"open_ui_surface" with confirm:true plus explicitUserRequest to route visible UI navigation.',
-              shortcuts: 'Use mode:"shortcuts" to inspect fixed shortcuts plus configurable keybindings. Use mode:"keybinding" with actionId, target, key, or query; use mode:"set_keybinding" and mode:"reset_keybinding" with confirm:true plus explicitUserRequest to edit the same config file the user edits.',
+              shortcuts: 'Use mode:"shortcuts" to inspect fixed shortcuts plus configurable keybindings. Use mode:"keybinding" with actionId, target, key, or query; use mode:"run_keybinding" for confirmation-gated shell-safe shortcut equivalents; 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.',
+              workspace: 'Use mode:"workspace_actions" to list, mode:"workspace_action" with actionId, command, target, or query for one action and editor schema, and mode:"run_workspace_action" with the same lookup fields plus confirmation for executable actions; set includeParameters:true on workspace_actions to inline editor schemas.',
               settings: 'Use mode:"settings" to list and mode:"get_setting" with key, target, or query for one setting. Use mode:"set_setting" or mode:"reset_setting" with key, target, or query plus confirm:true and explicitUserRequest.',
               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.',
@@ -882537,15 +882848,15 @@ function createAgentHarnessTool(deps) {
         }
         if (args2.mode === "set_keybinding") {
           const confirmationError2 = requireConfirmedAction(args2, "Keybinding mutation");
-          if (confirmationError2)
-            return error52(confirmationError2);
-          return output7(setHarnessKeybinding(deps.commandContext, args2));
+          return confirmationError2 ? error52(confirmationError2) : output7(setHarnessKeybinding(deps.commandContext, args2));
         }
         if (args2.mode === "reset_keybinding") {
           const confirmationError2 = requireConfirmedAction(args2, "Keybinding reset");
-          if (confirmationError2)
-            return error52(confirmationError2);
-          return output7(resetHarnessKeybinding(deps.commandContext, args2));
+          return confirmationError2 ? error52(confirmationError2) : output7(resetHarnessKeybinding(deps.commandContext, args2));
+        }
+        if (args2.mode === "run_keybinding") {
+          const confirmationError2 = requireConfirmedAction(args2, "Keybinding action");
+          return confirmationError2 ? error52(confirmationError2) : output7(runHarnessKeybinding(deps.commandContext, args2));
         }
         if (args2.mode === "commands") {
           const commands3 = listHarnessCommands(deps.commandRegistry, args2);