@pellux/goodvibes-agent 1.0.10 → 1.0.11

package/CHANGELOG.md

@@ -2,6 +2,12 @@
 
 Product-facing release notes for GoodVibes Agent.
 
+## 1.0.11 - 2026-06-03
+
+- Model-visible harness parity now opens conversation search, prompt history search, slash-command mode, file picker, and nearest-block actions through confirmation-gated visible shell routes.
+- Documentation now names the current UI surface inventory for 1.0.x so users and the model share the same harness map.
+- Harness assertions cover the new visible surface routes and preserve the existing safety boundary.
+
 ## 1.0.10 - 2026-06-03
 
 - Expose the runtime activity monitor as a model-visible, confirmation-gated harness UI surface, wire the shell opener through CommandContext, and refresh package-facing docs and focused coverage for the current 1.0.x surface map.

package/README.md

@@ -66,7 +66,7 @@ Use the workspace as the primary product surface:
 
 Inside the Agent workspace, press `/` to search every workspace action by name, category, command, or detail. This is the primary discovery path for product actions; slash commands and CLI subcommands remain power-user/scriptable mirrors.
 
-The model has the same harness map through `agent_harness`: it can list Agent workspace actions, list built-in panels and their workspace routes, inspect modal/overlay/picker UI surfaces, list top-level CLI mirrors, inspect fixed shortcuts and configurable keybindings, list slash commands, inspect command policy metadata, inspect model tool definitions, inspect or change Agent settings with confirmation, run concrete workspace or slash-command mirrors with confirmation, and report connected-host capability and live readiness posture. CLI mirror modes are read-only catalog and parser inspection; inside the main conversation, the model uses the returned preferred model tool, workspace action, setting mode, or confirmed slash-command mirror instead of launching hidden nested CLI processes. Panel modes expose catalog/open state and route visible panel/workspace changes through the current Agent shell bridge with confirmation. UI surface modes expose help, shortcuts, context, runtime activity, bookmarks, model/provider pickers, TTS provider/voice pickers, session/profile pickers, the panel-picker compatibility route, security/knowledge/subscription operator surfaces, settings, MCP workspace, onboarding, and Agent workspace entrypoints; `open_ui_surface` is confirmation-gated and only performs visible shell navigation. Shortcut modes expose fixed runtime/editor controls plus the live resolved keybinding table; `set_keybinding` and `reset_keybinding` write the same `keybindings.json` file the user edits and require confirmation. Workspace action discovery can inline editor field schemas with `includeParameters:true`; profile editors use the current starter-template inventory, and routine schedule editors can prefill a selected local routine from `recordId`. Selection-based local workspace actions accept a local `recordId` so the model can use the same note promotion and local registry flows as the TUI. The `connected_host` report includes route families, allowed capabilities, blocked lifecycle/non-Agent surfaces, and availability for the first-class Agent tools. The `connected_host_status` report performs a read-only live check of the connected-host status route and the isolated Agent Knowledge status route, reports SDK compatibility, token posture, endpoint bindings, route readiness, and actionable findings, and still refuses connected-host lifecycle control. The model uses those first-class tools for product workflows where they exist, such as Agent Knowledge, local memory/notes/personas/skills/routines, channel sends, notifications, reminders, media generation, work plans, and connected-host operator actions.
+The model has the same harness map through `agent_harness`: it can list Agent workspace actions, list built-in panels and their workspace routes, inspect modal/overlay/picker UI surfaces, list top-level CLI mirrors, inspect fixed shortcuts and configurable keybindings, list slash commands, inspect command policy metadata, inspect model tool definitions, inspect or change Agent settings with confirmation, run concrete workspace or slash-command mirrors with confirmation, and report connected-host capability and live readiness posture. CLI mirror modes are read-only catalog and parser inspection; inside the main conversation, the model uses the returned preferred model tool, workspace action, setting mode, or confirmed slash-command mirror instead of launching hidden nested CLI processes. Panel modes expose catalog/open state and route visible panel/workspace changes through the current Agent shell bridge with confirmation. UI surface modes expose help, shortcuts, conversation search, prompt-history search, slash-command mode, file picker, block actions, context, runtime activity, bookmarks, model/provider pickers, TTS provider/voice pickers, session/profile pickers, the panel-picker compatibility route, security/knowledge/subscription operator surfaces, settings, MCP workspace, onboarding, and Agent workspace entrypoints; `open_ui_surface` is confirmation-gated and only performs visible shell navigation. Shortcut modes expose fixed runtime/editor controls plus the live resolved keybinding table; `set_keybinding` and `reset_keybinding` write the same `keybindings.json` file the user edits and require confirmation. Workspace action discovery can inline editor field schemas with `includeParameters:true`; profile editors use the current starter-template inventory, and routine schedule editors can prefill a selected local routine from `recordId`. Selection-based local workspace actions accept a local `recordId` so the model can use the same note promotion and local registry flows as the TUI. The `connected_host` report includes route families, allowed capabilities, blocked lifecycle/non-Agent surfaces, and availability for the first-class Agent tools. The `connected_host_status` report performs a read-only live check of the connected-host status route and the isolated Agent Knowledge status route, reports SDK compatibility, token posture, endpoint bindings, route readiness, and actionable findings, and still refuses connected-host lifecycle control. The model uses those first-class tools for product workflows where they exist, such as Agent Knowledge, local memory/notes/personas/skills/routines, channel sends, notifications, reminders, media generation, work plans, and connected-host operator actions.
 
 The setup workspace surfaces discovered Agent-local persona, skill, and routine markdown files so day-one setup can import useful behavior instead of starting from blank records. It can also create one initial scratchpad note, local persona, skill, and routine directly during first-run setup; those records stay in Agent-local registries and never write to default knowledge or non-Agent segments.
 

package/dist/package/main.js

@@ -816508,7 +816508,7 @@ var createStyledCell = (char, overrides = {}) => ({
 // src/version.ts
 import { readFileSync } from "fs";
 import { join } from "path";
-var _version = "1.0.10";
+var _version = "1.0.11";
 var _sdkVersion = "0.33.35";
 try {
   const pkg = JSON.parse(readFileSync(join(import.meta.dir, "..", "package.json"), "utf-8"));
@@ -847717,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);
@@ -847766,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;
     }
   }
@@ -847941,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;
@@ -847991,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 = [];
@@ -848125,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;
@@ -848204,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 });
@@ -848320,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) {
@@ -862165,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_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([
@@ -862265,7 +862265,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);
@@ -862280,7 +862280,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) {
@@ -880878,6 +880878,17 @@ function optionalPane(args2) {
   const pane = readString56(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;
+}
+function filePickerOptions(args2) {
+  const target = readString56(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
+  };
+}
 function openAgentWorkspaceCategory(context, surface, categoryId, extra = {}) {
   if (!context.openAgentWorkspace)
     return routeUnavailable(surface);
@@ -881187,6 +881198,105 @@ var UI_SURFACES = [
       return opened(surface);
     }
   },
+  {
+    id: "conversation-search",
+    label: "Conversation Search",
+    kind: "overlay",
+    summary: "Visible transcript search overlay opened by the same shell route as Ctrl+F.",
+    command: "Ctrl+F",
+    preferredModelRoute: "Use conversation/session/content modes for model-readable inspection; use this surface for visible transcript search navigation.",
+    parameters: ["query", "prefix", "key"],
+    available: (context) => typeof context.openConversationSearch === "function",
+    open: (context, args2) => {
+      const surface = findSurfaceById("conversation-search");
+      if (!context.openConversationSearch)
+        return routeUnavailable(surface);
+      const query2 = surfaceInputText(args2);
+      context.openConversationSearch(query2);
+      return opened(surface, { query: query2 ?? "" });
+    }
+  },
+  {
+    id: "prompt-history-search",
+    label: "Prompt History Search",
+    kind: "overlay",
+    summary: "Visible reverse prompt-history search opened by the same shell route as Ctrl+R.",
+    command: "Ctrl+R",
+    preferredModelRoute: "Use this only for visible prompt recall; accepting a result remains an explicit interactive shell action.",
+    parameters: ["query", "prefix", "key"],
+    available: (context) => typeof context.openPromptHistorySearch === "function",
+    open: (context, args2) => {
+      const surface = findSurfaceById("prompt-history-search");
+      if (!context.openPromptHistorySearch)
+        return routeUnavailable(surface);
+      const query2 = surfaceInputText(args2);
+      context.openPromptHistorySearch(query2);
+      return opened(surface, { query: query2 ?? "" });
+    }
+  },
+  {
+    id: "slash-command-mode",
+    label: "Slash Command Mode",
+    kind: "overlay",
+    summary: "Slash-command autocomplete route opened by the same shell path as typing / in an empty prompt.",
+    command: "/",
+    preferredModelRoute: "Use commands/command for model-readable command discovery and run_command for confirmed command execution.",
+    parameters: ["query", "prefix", "key"],
+    available: (context) => typeof context.openSlashCommandMode === "function",
+    open: (context, args2) => {
+      const surface = findSurfaceById("slash-command-mode");
+      if (!context.openSlashCommandMode)
+        return routeUnavailable(surface);
+      const query2 = surfaceInputText(args2);
+      const openedCommandMode = context.openSlashCommandMode(query2);
+      return openedCommandMode ? opened(surface, { query: query2 ?? "" }) : {
+        status: "not_opened",
+        surface: surface.id,
+        kind: surface.kind,
+        query: query2 ?? "",
+        note: "The current prompt contains a non-command draft, so the shell opener refused to replace it."
+      };
+    }
+  },
+  {
+    id: "file-picker",
+    label: "File Picker",
+    kind: "picker",
+    summary: "Visible project file picker opened by the same prompt route as @ and !@ references.",
+    command: "@",
+    preferredModelRoute: "Use first-class file, workspace, or artifact tools for model operation; use this for visible file reference navigation.",
+    parameters: ["target=reference|inject", "query", "prefix", "key"],
+    available: (context) => typeof context.openFilePicker === "function",
+    open: (context, args2) => {
+      const surface = findSurfaceById("file-picker");
+      if (!context.openFilePicker)
+        return routeUnavailable(surface);
+      const options = filePickerOptions(args2);
+      const openedFilePicker = context.openFilePicker(options);
+      return openedFilePicker ? opened(surface, { mode: options.injectMode ? "inject" : "reference", query: options.query ?? "" }) : routeUnavailable(surface);
+    }
+  },
+  {
+    id: "block-actions",
+    label: "Block Actions",
+    kind: "overlay",
+    summary: "Visible nearest-block action menu opened by the same shell route as pressing Enter on an empty prompt near transcript content.",
+    command: "Enter on empty prompt",
+    preferredModelRoute: "Use conversation/session/content modes or confirmed slash-command mirrors for concrete block operations; use this surface for visible block-action navigation.",
+    available: (context) => typeof context.openBlockActions === "function",
+    open: (context) => {
+      const surface = findSurfaceById("block-actions");
+      if (!context.openBlockActions)
+        return routeUnavailable(surface);
+      const openedBlockActions = context.openBlockActions();
+      return openedBlockActions ? opened(surface) : {
+        status: "not_opened",
+        surface: surface.id,
+        kind: surface.kind,
+        note: "The shell opener requires an empty prompt and a nearby rendered conversation block."
+      };
+    }
+  },
   {
     id: "help-overlay",
     label: "Help Overlay",
@@ -899921,6 +900031,75 @@ function wireShellUiOpeners(options) {
     input.processModal.open();
     render();
   };
+  commandContext.openConversationSearch = (query2) => {
+    input.searchManager.open();
+    const searchQuery = query2?.trim() ?? "";
+    if (searchQuery.length > 0) {
+      input.searchManager.search(searchQuery, input.getHistory());
+    }
+    render();
+  };
+  commandContext.openPromptHistorySearch = (query2) => {
+    input.historySearch.open(input.prompt);
+    const searchQuery = query2?.trim() ?? "";
+    if (searchQuery.length > 0) {
+      input.historySearch.search(searchQuery);
+    }
+    render();
+  };
+  commandContext.openSlashCommandMode = (query2) => {
+    const normalizedQuery = query2?.trim().replace(/^\/+/, "") ?? "";
+    if (input.prompt.length > 0 && !input.prompt.startsWith("/")) {
+      return false;
+    }
+    input.modalOpened("command");
+    input.commandMode = true;
+    if (input.prompt.length === 0 || !input.prompt.startsWith("/") || normalizedQuery.length > 0) {
+      input.saveUndoState();
+      input.prompt = `/${normalizedQuery}`;
+      input.cursorPos = input.prompt.length;
+    }
+    const commandQuery = input.prompt.startsWith("/") ? input.prompt.slice(1) : "";
+    const hasArgs = commandQuery.includes(" ");
+    if (hasArgs)
+      input.autocomplete?.reset();
+    else
+      input.autocomplete?.update(commandQuery);
+    input.ensureInputCursorVisible();
+    input.syncFeedContextMutableFields();
+    render();
+    return true;
+  };
+  commandContext.openFilePicker = (options2) => {
+    const injectMode = Boolean(options2?.injectMode);
+    const query2 = options2?.query?.trim() ?? "";
+    const marker = `${injectMode ? "!@" : "@"}${query2}`;
+    const insertPos = input.cursorPos;
+    input.saveUndoState();
+    input.prompt = input.prompt.slice(0, insertPos) + marker + input.prompt.slice(insertPos);
+    input.cursorPos = insertPos + marker.length;
+    input.modalOpened("filePicker");
+    input.filePicker.open(insertPos, injectMode);
+    if (query2.length > 0)
+      input.filePicker.setQuery(query2);
+    input.ensureInputCursorVisible();
+    input.syncFeedContextMutableFields();
+    render();
+    return true;
+  };
+  commandContext.openBlockActions = () => {
+    if (input.prompt.trim().length > 0 || input.commandMode) {
+      return false;
+    }
+    const nearest = conversation.findNearestBlock(input.getScrollTop());
+    if (!nearest) {
+      return false;
+    }
+    input.modalOpened("blockActions");
+    input.blockActionsMenu.open(nearest);
+    render();
+    return true;
+  };
   commandContext.openHelpOverlay = () => {
     if (!input.helpOverlayActive)
       input.modalOpened("help");

package/docs/getting-started.md

@@ -44,7 +44,7 @@ After setup has been applied once, the TUI opens directly into the Agent operato
 
 Press `/` inside the Agent workspace to search every workspace action by name, category, command, or detail. Use that finder before reaching for shell commands; CLI subcommands are scriptable mirrors of these TUI workflows.
 
-The model can inspect and use the same harness surface through Agent-owned tools. `agent_harness` exposes workspace action discovery, built-in panel discovery/routing, modal/overlay/picker UI surface discovery/routing, top-level CLI mirror discovery, fixed shortcut and configurable keybinding discovery, keybinding mutation with confirmation, slash-command discovery, command policy metadata, command execution with confirmation, model tool discovery, settings inspection/mutation, connected-host capability inventory, and live connected-host readiness posture. CLI mirror modes are read-only catalog/parser inspection and point the model to the matching in-process tool, workspace action, setting mode, or slash-command mirror. Panel modes expose catalog/open state and route visible panel/workspace changes through the current Agent shell bridge with confirmation. UI surface modes expose help, shortcuts, context, runtime activity, bookmarks, model/provider pickers, TTS provider/voice pickers, session/profile pickers, the panel-picker compatibility route, security/knowledge/subscription operator surfaces, settings, MCP workspace, onboarding, and Agent workspace entrypoints; `open_ui_surface` is confirmation-gated and only performs visible shell navigation. Shortcut modes expose the fixed runtime/editor shortcuts and the live keybindings table; confirmed keybinding edits write the same `keybindings.json` file the user edits and reload the runtime manager. Workspace action discovery can include editor field schemas with `includeParameters:true`, including starter-template defaults for profile creation and selected-routine defaults for routine schedule promotion when `recordId` is supplied. Selection-based local workspace actions accept a local `recordId`, so the model can use the same note promotion and local registry flows as the TUI. First-class model tools cover the main product workflows directly: Agent Knowledge, Agent Knowledge ingest, Agent-local memory/notes/personas/skills/routines, operator actions, notifications, channel sends, reminders, generated media, and work plans.
+The model can inspect and use the same harness surface through Agent-owned tools. `agent_harness` exposes workspace action discovery, built-in panel discovery/routing, modal/overlay/picker UI surface discovery/routing, top-level CLI mirror discovery, fixed shortcut and configurable keybinding discovery, keybinding mutation with confirmation, slash-command discovery, command policy metadata, command execution with confirmation, model tool discovery, settings inspection/mutation, connected-host capability inventory, and live connected-host readiness posture. CLI mirror modes are read-only catalog/parser inspection and point the model to the matching in-process tool, workspace action, setting mode, or slash-command mirror. Panel modes expose catalog/open state and route visible panel/workspace changes through the current Agent shell bridge with confirmation. UI surface modes expose help, shortcuts, conversation search, prompt-history search, slash-command mode, file picker, block actions, context, runtime activity, bookmarks, model/provider pickers, TTS provider/voice pickers, session/profile pickers, the panel-picker compatibility route, security/knowledge/subscription operator surfaces, settings, MCP workspace, onboarding, and Agent workspace entrypoints; `open_ui_surface` is confirmation-gated and only performs visible shell navigation. Shortcut modes expose the fixed runtime/editor shortcuts and the live keybindings table; confirmed keybinding edits write the same `keybindings.json` file the user edits and reload the runtime manager. Workspace action discovery can include editor field schemas with `includeParameters:true`, including starter-template defaults for profile creation and selected-routine defaults for routine schedule promotion when `recordId` is supplied. Selection-based local workspace actions accept a local `recordId`, so the model can use the same note promotion and local registry flows as the TUI. First-class model tools cover the main product workflows directly: Agent Knowledge, Agent Knowledge ingest, Agent-local memory/notes/personas/skills/routines, operator actions, notifications, channel sends, reminders, generated media, and work plans.
 
 Use the Artifacts area for concrete files and generated output: attach images to prompts, export conversations or saved sessions, ingest local source files and URL lists into Agent Knowledge, import bookmarks or browser history, inspect source records, and generate media artifacts from confirmed prompts.
 

package/docs/tools-and-commands.md

@@ -52,7 +52,7 @@ The main Agent model has an Agent-owned harness bridge rather than generic SDK s
 
 `agent_harness` discovery modes are read-only. `summary` reports the model access map; `panels` and `panel` return the built-in panel catalog, current open/focused state, and each panel's matching Agent workspace route; `ui_surfaces` and `ui_surface` return modal, overlay, picker, and workspace entrypoints with shell-opener availability and preferred model routes; `cli_commands` and `cli_command` return top-level package CLI mirror metadata, parser output, blocked command tokens, and preferred in-process model routes; `shortcuts` returns fixed runtime/editor shortcuts plus configurable keybindings; `keybindings` and `keybinding` return the live resolved keybinding table, default bindings, custom state, and config path; `commands` and `command` return slash-command descriptions plus effect/confirmation/preferred-tool/boundary policy metadata; `workspace_actions` lists Agent workspace actions and can inline editor field schemas with `includeParameters:true`; `workspace_action` returns one action with its editor schema; `tools` can inline model tool JSON schemas with `includeParameters:true`; `settings` returns setting descriptors plus setting policy; `connected_host` returns the connected-host route families, allowed capabilities, blocked capabilities, and first-class tool availability; and `connected_host_status` performs a live read-only check of the connected-host status and Agent Knowledge status routes and reports endpoint bindings, token posture, SDK compatibility, route readiness, and findings without printing token values.
 
-`open_ui_surface` is a confirmation-gated visible navigation mode for the same shell surfaces the user can open: Agent workspace, settings, MCP workspace, model/provider pickers, TTS provider/voice pickers, session/profile pickers, the panel-picker compatibility route, security/knowledge/subscription operator surfaces, bookmarks, context inspector, runtime activity monitor, help, shortcuts, and onboarding. It does not perform hidden operations; use first-class model tools, settings modes, workspace actions, or confirmed slash-command mirrors for actual state changes.
+`open_ui_surface` is a confirmation-gated visible navigation mode for the same shell surfaces the user can open: Agent workspace, settings, MCP workspace, model/provider pickers, TTS provider/voice pickers, session/profile pickers, the panel-picker compatibility route, security/knowledge/subscription operator surfaces, conversation search, prompt-history search, slash-command mode, file picker, block actions, bookmarks, context inspector, runtime activity monitor, help, shortcuts, and onboarding. It does not perform hidden operations; use first-class model tools, settings modes, workspace actions, or confirmed slash-command mirrors for actual state changes.
 
 `set_keybinding` and `reset_keybinding` are confirmation-gated control modes. They write the same Agent `keybindings.json` file exposed by `/keybindings`, reload the runtime keybinding manager, and leave fixed runtime/editor shortcuts read-only.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pellux/goodvibes-agent",
-  "version": "1.0.10",
+  "version": "1.0.11",
   "private": false,
   "description": "GoodVibes personal operator assistant TUI with a proactive Agent product brain, isolated Agent Knowledge, local profiles, routines, skills, personas, and explicit build delegation.",
   "type": "module",

package/src/input/command-registry.ts

@@ -93,6 +93,11 @@ export interface CommandShellUiOpeners {
   openContextInspector?: () => void;
   openBookmarkModal?: () => void;
   openProcessModal?: () => void;
+  openConversationSearch?: (query?: string) => void;
+  openPromptHistorySearch?: (query?: string) => void;
+  openSlashCommandMode?: (query?: string) => boolean;
+  openFilePicker?: (options?: { injectMode?: boolean; query?: string }) => boolean;
+  openBlockActions?: () => boolean;
   jumpToBookmark?: (key: string) => void;
   scrollToLine?: (line: number) => void;
   openHelpOverlay?: () => void;

package/src/shell/ui-openers.ts

@@ -255,6 +255,79 @@ export function wireShellUiOpeners(options: WireShellUiOpenersOptions): void {
     render();
   };
 
+  commandContext.openConversationSearch = (query?: string) => {
+    input.searchManager.open();
+    const searchQuery = query?.trim() ?? '';
+    if (searchQuery.length > 0) {
+      input.searchManager.search(searchQuery, input.getHistory());
+    }
+    render();
+  };
+
+  commandContext.openPromptHistorySearch = (query?: string) => {
+    input.historySearch.open(input.prompt);
+    const searchQuery = query?.trim() ?? '';
+    if (searchQuery.length > 0) {
+      input.historySearch.search(searchQuery);
+    }
+    render();
+  };
+
+  commandContext.openSlashCommandMode = (query?: string): boolean => {
+    const normalizedQuery = query?.trim().replace(/^\/+/, '') ?? '';
+    if (input.prompt.length > 0 && !input.prompt.startsWith('/')) {
+      return false;
+    }
+
+    input.modalOpened('command');
+    input.commandMode = true;
+    if (input.prompt.length === 0 || !input.prompt.startsWith('/') || normalizedQuery.length > 0) {
+      input.saveUndoState();
+      input.prompt = `/${normalizedQuery}`;
+      input.cursorPos = input.prompt.length;
+    }
+
+    const commandQuery = input.prompt.startsWith('/') ? input.prompt.slice(1) : '';
+    const hasArgs = commandQuery.includes(' ');
+    if (hasArgs) input.autocomplete?.reset();
+    else input.autocomplete?.update(commandQuery);
+    input.ensureInputCursorVisible();
+    input.syncFeedContextMutableFields();
+    render();
+    return true;
+  };
+
+  commandContext.openFilePicker = (options): boolean => {
+    const injectMode = Boolean(options?.injectMode);
+    const query = options?.query?.trim() ?? '';
+    const marker = `${injectMode ? '!@' : '@'}${query}`;
+    const insertPos = input.cursorPos;
+    input.saveUndoState();
+    input.prompt = input.prompt.slice(0, insertPos) + marker + input.prompt.slice(insertPos);
+    input.cursorPos = insertPos + marker.length;
+    input.modalOpened('filePicker');
+    input.filePicker.open(insertPos, injectMode);
+    if (query.length > 0) input.filePicker.setQuery(query);
+    input.ensureInputCursorVisible();
+    input.syncFeedContextMutableFields();
+    render();
+    return true;
+  };
+
+  commandContext.openBlockActions = (): boolean => {
+    if (input.prompt.trim().length > 0 || input.commandMode) {
+      return false;
+    }
+    const nearest = conversation.findNearestBlock(input.getScrollTop());
+    if (!nearest) {
+      return false;
+    }
+    input.modalOpened('blockActions');
+    input.blockActionsMenu.open(nearest);
+    render();
+    return true;
+  };
+
   commandContext.openHelpOverlay = () => {
     if (!input.helpOverlayActive) input.modalOpened('help');
     input.helpOverlayActive = !input.helpOverlayActive;

package/src/tools/agent-harness-ui-surface-metadata.ts

@@ -82,6 +82,19 @@ function optionalPane(args: AgentHarnessUiSurfaceArgs): 'top' | 'bottom' | undef
   return pane === 'top' || pane === 'bottom' ? pane : undefined;
 }
 
+function surfaceInputText(args: AgentHarnessUiSurfaceArgs): string | undefined {
+  return readString(args.prefix || args.key || (args.surfaceId ? args.query : undefined) || args.target) || undefined;
+}
+
+function filePickerOptions(args: AgentHarnessUiSurfaceArgs): { injectMode: boolean; query?: string } {
+  const target = readString(args.target).toLowerCase();
+  const injectMode = target === 'inject' || target === 'inject-mode' || target === '!@';
+  return {
+    injectMode,
+    query: readString(args.prefix || args.key || (args.surfaceId ? args.query : undefined)) || undefined,
+  };
+}
+
 function openAgentWorkspaceCategory(
   context: CommandContext,
   surface: UiSurfaceDefinition,
@@ -408,6 +421,106 @@ const UI_SURFACES: readonly UiSurfaceDefinition[] = [
       return opened(surface);
     },
   },
+  {
+    id: 'conversation-search',
+    label: 'Conversation Search',
+    kind: 'overlay',
+    summary: 'Visible transcript search overlay opened by the same shell route as Ctrl+F.',
+    command: 'Ctrl+F',
+    preferredModelRoute: 'Use conversation/session/content modes for model-readable inspection; use this surface for visible transcript search navigation.',
+    parameters: ['query', 'prefix', 'key'],
+    available: (context) => typeof context.openConversationSearch === 'function',
+    open: (context, args) => {
+      const surface = findSurfaceById('conversation-search')!;
+      if (!context.openConversationSearch) return routeUnavailable(surface);
+      const query = surfaceInputText(args);
+      context.openConversationSearch(query);
+      return opened(surface, { query: query ?? '' });
+    },
+  },
+  {
+    id: 'prompt-history-search',
+    label: 'Prompt History Search',
+    kind: 'overlay',
+    summary: 'Visible reverse prompt-history search opened by the same shell route as Ctrl+R.',
+    command: 'Ctrl+R',
+    preferredModelRoute: 'Use this only for visible prompt recall; accepting a result remains an explicit interactive shell action.',
+    parameters: ['query', 'prefix', 'key'],
+    available: (context) => typeof context.openPromptHistorySearch === 'function',
+    open: (context, args) => {
+      const surface = findSurfaceById('prompt-history-search')!;
+      if (!context.openPromptHistorySearch) return routeUnavailable(surface);
+      const query = surfaceInputText(args);
+      context.openPromptHistorySearch(query);
+      return opened(surface, { query: query ?? '' });
+    },
+  },
+  {
+    id: 'slash-command-mode',
+    label: 'Slash Command Mode',
+    kind: 'overlay',
+    summary: 'Slash-command autocomplete route opened by the same shell path as typing / in an empty prompt.',
+    command: '/',
+    preferredModelRoute: 'Use commands/command for model-readable command discovery and run_command for confirmed command execution.',
+    parameters: ['query', 'prefix', 'key'],
+    available: (context) => typeof context.openSlashCommandMode === 'function',
+    open: (context, args) => {
+      const surface = findSurfaceById('slash-command-mode')!;
+      if (!context.openSlashCommandMode) return routeUnavailable(surface);
+      const query = surfaceInputText(args);
+      const openedCommandMode = context.openSlashCommandMode(query);
+      return openedCommandMode
+        ? opened(surface, { query: query ?? '' })
+        : {
+          status: 'not_opened',
+          surface: surface.id,
+          kind: surface.kind,
+          query: query ?? '',
+          note: 'The current prompt contains a non-command draft, so the shell opener refused to replace it.',
+        };
+    },
+  },
+  {
+    id: 'file-picker',
+    label: 'File Picker',
+    kind: 'picker',
+    summary: 'Visible project file picker opened by the same prompt route as @ and !@ references.',
+    command: '@',
+    preferredModelRoute: 'Use first-class file, workspace, or artifact tools for model operation; use this for visible file reference navigation.',
+    parameters: ['target=reference|inject', 'query', 'prefix', 'key'],
+    available: (context) => typeof context.openFilePicker === 'function',
+    open: (context, args) => {
+      const surface = findSurfaceById('file-picker')!;
+      if (!context.openFilePicker) return routeUnavailable(surface);
+      const options = filePickerOptions(args);
+      const openedFilePicker = context.openFilePicker(options);
+      return openedFilePicker
+        ? opened(surface, { mode: options.injectMode ? 'inject' : 'reference', query: options.query ?? '' })
+        : routeUnavailable(surface);
+    },
+  },
+  {
+    id: 'block-actions',
+    label: 'Block Actions',
+    kind: 'overlay',
+    summary: 'Visible nearest-block action menu opened by the same shell route as pressing Enter on an empty prompt near transcript content.',
+    command: 'Enter on empty prompt',
+    preferredModelRoute: 'Use conversation/session/content modes or confirmed slash-command mirrors for concrete block operations; use this surface for visible block-action navigation.',
+    available: (context) => typeof context.openBlockActions === 'function',
+    open: (context) => {
+      const surface = findSurfaceById('block-actions')!;
+      if (!context.openBlockActions) return routeUnavailable(surface);
+      const openedBlockActions = context.openBlockActions();
+      return openedBlockActions
+        ? opened(surface)
+        : {
+          status: 'not_opened',
+          surface: surface.id,
+          kind: surface.kind,
+          note: 'The shell opener requires an empty prompt and a nearby rendered conversation block.',
+        };
+    },
+  },
   {
     id: 'help-overlay',
     label: 'Help Overlay',

package/src/version.ts

@@ -6,7 +6,7 @@ import { join } from 'node:path';
 // The prebuild script updates the fallback value before compilation.
 // Uses import.meta.dir (Bun) to locate package.json relative to this file,
 // which is correct regardless of the process working directory.
-let _version = '1.0.10';
+let _version = '1.0.11';
 let _sdkVersion = '0.33.35';
 try {
   const pkg = JSON.parse(readFileSync(join(import.meta.dir, '..', 'package.json'), 'utf-8')) as {