@pellux/goodvibes-agent 1.0.18 → 1.0.20

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.18";
+var _version = "1.0.20";
 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_SCOPES2 = ["session", "project", "team"];
+var VALID_SCOPES = ["session", "project", "team"];
 var VALID_REVIEW_STATES = ["fresh", "reviewed", "stale", "contradicted"];
 function isValidClass(s4) {
   return VALID_CLASSES.includes(s4);
 }
 function isValidScope(s4) {
-  return VALID_SCOPES2.includes(s4);
+  return VALID_SCOPES.includes(s4);
 }
 function isValidReviewState(s4) {
   return VALID_REVIEW_STATES.includes(s4);
@@ -847824,7 +847766,7 @@ function handleRecallSearch(args2, context) {
     if (isValidScope(scope))
       filter.scope = scope;
     else {
-      context.print(`[memory] Unknown scope "${scope}". Valid values ${VALID_SCOPES2.join(", ")}.`);
+      context.print(`[memory] Unknown scope "${scope}". Valid values ${VALID_SCOPES.join(", ")}.`);
       return;
     }
   }
@@ -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_SCOPES2.join(", ")}.`);
+      context.print(`[memory] Unknown scope "${scope}". Valid values ${VALID_SCOPES.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_SCOPES2.join(", ")}.`);
+    context.print(`[memory] Invalid scope "${scopeRaw}". Valid values ${VALID_SCOPES.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_SCOPES2.join(", ")}.`);
+      context.print(`[memory] Unknown scope "${scope}". Valid values ${VALID_SCOPES.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_SCOPES2.join(", ")}.`);
+    context.print(`[memory] Unknown scope "${scopeRaw ?? ""}". Valid values ${VALID_SCOPES.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_SCOPES2.join("|")}> --yes`);
+    context.print(`[memory] Usage: /memory promote <id> <${VALID_SCOPES.join("|")}> --yes`);
     return;
   }
   if (!parsed.yes) {
@@ -862311,7 +862253,7 @@ import { mkdirSync as mkdirSync64, readFileSync as readFileSync86, writeFileSync
 import { dirname as dirname63, resolve as resolve39 } from "path";
 init_state3();
 var VALID_CLASSES2 = ["decision", "constraint", "incident", "pattern", "fact", "risk", "runbook", "architecture", "ownership"];
-var VALID_SCOPES4 = ["session", "project", "team"];
+var VALID_SCOPES3 = ["session", "project", "team"];
 var VALID_REVIEW_STATES3 = ["fresh", "reviewed", "stale", "contradicted"];
 var VALID_PROVENANCE_KINDS = ["session", "turn", "task", "event", "file"];
 var VALUE_OPTIONS = new Set([
@@ -862411,7 +862353,7 @@ function isMemoryClass2(value) {
   return VALID_CLASSES2.includes(value);
 }
 function isMemoryScope2(value) {
-  return VALID_SCOPES4.includes(value);
+  return VALID_SCOPES3.includes(value);
 }
 function isReviewState(value) {
   return VALID_REVIEW_STATES3.includes(value);
@@ -862426,7 +862368,7 @@ function requireClass(value) {
 }
 function requireScope(value) {
   if (!value || !isMemoryScope2(value))
-    throw new Error(`Invalid memory scope "${value ?? ""}". Valid values ${VALID_SCOPES4.join(", ")}`);
+    throw new Error(`Invalid memory scope "${value ?? ""}". Valid values ${VALID_SCOPES3.join(", ")}`);
   return value;
 }
 function optionalScope(value) {
@@ -879802,6 +879744,9 @@ function readLimit5(value, fallback) {
     return fallback;
   return Math.max(1, Math.min(500, Math.trunc(parsed)));
 }
+function redactCliLookupInput(input) {
+  return input.replace(/(--config=)([^=\s]+)=\S+/g, "$1$2=<redacted>").replace(/(--config\s+)([^=\s]+)=\S+/g, "$1$2=<redacted>");
+}
 function cliCommandTokens(command8) {
   if (command8 === "unknown")
     return [];
@@ -879818,13 +879763,14 @@ function fallbackCliSummary(command8) {
     return "Print the installed Agent package version.";
   return "Inspect the CLI help for this Agent package command.";
 }
-function describeCliCommand(command8) {
+function describeCliCommand(command8, lookup) {
   const help = describeGoodVibesCommandHelp(command8);
   const tokens = cliCommandTokens(command8);
   return {
     name: command8,
     tokens,
     invocation: command8 === "tui" ? "goodvibes-agent" : `goodvibes-agent ${tokens[0] ?? command8}`,
+    ...lookup ? { lookup } : {},
     helpTopic: help?.command ?? command8,
     summary: help?.summary ?? fallbackCliSummary(command8),
     usage: help?.usage ?? (command8 === "tui" ? ["goodvibes-agent [OPTIONS]"] : [`goodvibes-agent ${command8} [ARGS]`]),
@@ -879849,6 +879795,14 @@ function cliCommandMatches(command8, query2) {
   ].map((value) => JSON.stringify(value)).join(`
 `).toLowerCase().includes(query2.toLowerCase());
 }
+function cliCommandCandidate(command8) {
+  return {
+    name: command8.name,
+    tokens: command8.tokens,
+    invocation: command8.invocation,
+    summary: command8.summary
+  };
+}
 function totalHarnessCliCommands() {
   return listGoodVibesCliCommands().filter((command8) => command8 !== "unknown").length;
 }
@@ -879858,23 +879812,60 @@ function blockedHarnessCliCommandTokens() {
 function listHarnessCliCommands(args2) {
   const query2 = readString50(args2.query);
   const limit3 = readLimit5(args2.limit, 200);
-  return listGoodVibesCliCommands().filter((command8) => command8 !== "unknown").map(describeCliCommand).filter((command8) => cliCommandMatches(command8, query2)).sort((a4, b3) => String(a4.name).localeCompare(String(b3.name))).slice(0, limit3);
+  return listGoodVibesCliCommands().filter((command8) => command8 !== "unknown").map((command8) => describeCliCommand(command8)).filter((command8) => cliCommandMatches(command8, query2)).sort((a4, b3) => String(a4.name).localeCompare(String(b3.name))).slice(0, limit3);
 }
-function cliTokensFromArgs(args2) {
-  const raw = readString50(args2.cliCommand) || readString50(args2.command) || readString50(args2.commandName) || readString50(args2.query);
-  if (!raw)
-    return [];
+function cliInputFromArgs(args2) {
+  const cliCommand = readString50(args2.cliCommand);
+  if (cliCommand)
+    return { source: "cliCommand", input: cliCommand };
+  const command8 = readString50(args2.command);
+  if (command8)
+    return { source: "command", input: command8 };
+  const commandName = readString50(args2.commandName);
+  if (commandName)
+    return { source: "commandName", input: commandName };
+  const target = readString50(args2.target);
+  if (target)
+    return { source: "target", input: target };
+  const query2 = readString50(args2.query);
+  if (query2)
+    return { source: "query", input: query2 };
+  return null;
+}
+function cliTokensFromRaw(raw) {
   const tokens = raw.split(/\s+/).filter((token) => token.length > 0);
   if (tokens[0] === "goodvibes-agent" || tokens[0]?.endsWith("/goodvibes-agent"))
     return tokens.slice(1);
   return tokens;
 }
+function isConcreteCliSource(source) {
+  return source === "cliCommand" || source === "command" || source === "commandName";
+}
 function describeHarnessCliCommand(args2) {
-  const tokens = cliTokensFromArgs(args2);
-  if (tokens.length === 0)
-    return describeCliCommand("tui");
+  const input = cliInputFromArgs(args2);
+  if (!input)
+    return describeCliCommand("tui", { source: "default", input: "", resolvedBy: "default" });
+  const lookupInput = redactCliLookupInput(input.input);
+  const tokens = cliTokensFromRaw(input.input);
   const parsed = parseGoodVibesCli(tokens);
-  if (parsed.command === "unknown") {
+  const directInvocation = parsed.command !== "unknown" && (isConcreteCliSource(input.source) || String(parsed.rawCommand ?? "").toLowerCase() === String(tokens[0] ?? "").toLowerCase());
+  if (!directInvocation) {
+    const matches = listGoodVibesCliCommands().filter((command8) => command8 !== "unknown").map((command8) => describeCliCommand(command8)).filter((command8) => cliCommandMatches(command8, input.input)).sort((a4, b3) => String(a4.name).localeCompare(String(b3.name)));
+    if (matches.length === 1) {
+      return {
+        ...matches[0],
+        lookup: { source: input.source, input: lookupInput, resolvedBy: "search" }
+      };
+    }
+    if (matches.length > 1) {
+      return {
+        supported: false,
+        status: "ambiguous",
+        input: lookupInput,
+        candidates: matches.map(cliCommandCandidate).slice(0, 8),
+        note: "Multiple top-level CLI mirrors matched this lookup. Provide cliCommand or commandName with one concrete command token."
+      };
+    }
     return {
       supported: false,
       token: parsed.rawCommand ?? tokens[0],
@@ -879884,7 +879875,7 @@ function describeHarnessCliCommand(args2) {
     };
   }
   return {
-    ...describeCliCommand(parsed.command),
+    ...describeCliCommand(parsed.command, { source: input.source, input: lookupInput, resolvedBy: "invocation" }),
     parsed: {
       command: parsed.command,
       rawCommand: parsed.rawCommand,
@@ -880234,9 +880225,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 {};
@@ -880268,7 +880383,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) {
@@ -880280,7 +880395,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) {
@@ -880296,6 +880411,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);
@@ -881065,6 +881317,7 @@ var AGENT_HARNESS_MODES = [
   "shortcuts",
   "keybindings",
   "keybinding",
+  "run_keybinding",
   "set_keybinding",
   "reset_keybinding",
   "commands",
@@ -881099,7 +881352,7 @@ var AGENT_HARNESS_PARAMETER_PROPERTIES = {
   },
   query: {
     type: "string",
-    description: "Search text for command, panel, UI surface, keybinding, workspace action, setting, or tool catalogs; also slash-command, setting, panel, UI surface, or keybinding lookup for single-item modes."
+    description: "Search text for command, CLI mirror, panel, UI surface, keybinding, workspace action, setting, or tool catalogs; also slash-command, CLI mirror, setting, panel, UI surface, or keybinding lookup for single-item modes."
   },
   command: {
     type: "string",
@@ -881107,7 +881360,7 @@ var AGENT_HARNESS_PARAMETER_PROPERTIES = {
   },
   cliCommand: {
     type: "string",
-    description: 'Top-level CLI command string for mode cli_command, for example "goodvibes-agent status --json" or "profiles list". This mode is read-only metadata/parse inspection.'
+    description: 'Top-level CLI command string for mode cli_command, for example "goodvibes-agent status --json" or "profiles list". target or query can also look up one CLI mirror when the exact command token is not known. This mode is read-only metadata/parse inspection.'
   },
   commandName: {
     type: "string",
@@ -881132,7 +881385,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. target or query can also look up one keybinding action."
   },
   fields: {
     type: "object",
@@ -881162,11 +881415,11 @@ 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",
-    description: "Optional lookup target, such as a model-picker target, panel id/search text, UI surface id/search text, workspace action id/search text, slash command root or invocation, setting key/search text, keybinding action/search text, model tool name, or connected-host capability id."
+    description: "Optional lookup target, such as a model-picker target, top-level CLI mirror/search text, panel id/search text, UI surface id/search text, workspace action id/search text, slash command root or invocation, setting key/search text, keybinding action/search text, model tool name, or connected-host capability id."
   },
   capabilityId: {
     type: "string",
@@ -881203,11 +881456,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."
   }
 };
 
@@ -881871,7 +882124,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");
@@ -882444,7 +882697,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: {
@@ -882475,10 +882728,10 @@ function createAgentHarnessTool(deps) {
             workspaceActions: allWorkspaceActions().length,
             tools: deps.toolRegistry.getToolDefinitions().length,
             modelAccess: {
-              cliCommands: 'Use mode:"cli_commands" and mode:"cli_command" to inspect package CLI mirrors and their preferred in-process model routes. CLI modes are discovery-only.',
+              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.',
               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.',
@@ -882546,15 +882799,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);