@pellux/goodvibes-agent 1.0.13 → 1.0.15

package/CHANGELOG.md

@@ -2,6 +2,18 @@
 
 Product-facing release notes for GoodVibes Agent.
 
+## 1.0.15 - 2026-06-03
+
+- Add forgiving agent_harness slash-command detail lookup by command, commandName, target, or query with parsed invocation metadata.
+- Keep slash-command catalogs lightweight while making one-command inspection work from typed user-style invocations, aliases, case-insensitive roots, and unique description matches.
+- Refresh package-facing docs and focused harness coverage for the updated model-visible slash-command inspection path.
+
+## 1.0.14 - 2026-06-03
+
+- Add agent_harness mode tool to inspect one first-class model tool schema by toolName, target, or query.
+- Keep broad tools discovery lightweight while making individual model tool parameters, side effects, concurrency, and streaming/progress support directly inspectable.
+- Refresh package-facing docs and focused harness coverage for the updated model tool discovery surface.
+
 ## 1.0.13 - 2026-06-03
 
 - Add connected_host_capability to inspect one allowed or blocked connected-host capability by id, target, or query with related route families and boundary text.

package/README.md

@@ -7,7 +7,7 @@ GoodVibes Agent is the personal operator assistant TUI for GoodVibes. It is buil
 
 The Agent product connects to a GoodVibes host owned outside this package. It does not install, start, stop, restart, or own that host.
 
-Most work happens in the interactive TUI. The installed CLI exists to launch that TUI and provide scriptable mirrors for workflows that are already reachable from the workspace. The main Agent model can inspect the same harness surface through Agent-owned tools: workspace actions, built-in panels, modal/overlay/picker UI surfaces, named operator surfaces, top-level CLI mirrors, fixed shortcuts, configurable keybindings, slash commands, command policy metadata, settings, model tools, local registries, connected-host capability boundaries, and live connected-host readiness are all discoverable from the conversation without exposing connected-host lifecycle control.
+Most work happens in the interactive TUI. The installed CLI exists to launch that TUI and provide scriptable mirrors for workflows that are already reachable from the workspace. The main Agent model can inspect the same harness surface through Agent-owned tools: workspace actions, built-in panels, modal/overlay/picker UI surfaces, named operator surfaces, top-level CLI mirrors, fixed shortcuts, configurable keybindings, slash commands, single-command lookup with policy metadata, settings, model tools and individual model tool schemas, local registries, connected-host capability boundaries, and live connected-host readiness are all discoverable from the conversation without exposing connected-host lifecycle control.
 
 ## Install
 
@@ -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, command browser, conversation search, prompt-history search, slash-command mode, file picker, block actions, context, runtime activity, live process output, bookmarks, model/provider/reasoning-effort 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. Direct local create editors for memory, notes, personas, skills, and routines can execute from submitted fields through `run_workspace_action` and `agent_local_registry` with confirmation. The `connected_host` report includes route families, allowed capabilities, blocked lifecycle/non-Agent surfaces, and availability for the first-class Agent tools; `connected_host_capability` inspects one allowed or blocked capability by id, target, or query with its route families and boundary. 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 one slash command by `command`, `commandName`, `target`, or `query` with parsed arguments and policy metadata, inspect model tool definitions or one model tool schema, 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, command browser, conversation search, prompt-history search, slash-command mode, file picker, block actions, context, runtime activity, live process output, bookmarks, model/provider/reasoning-effort 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. Direct local create editors for memory, notes, personas, skills, and routines can execute from submitted fields through `run_workspace_action` and `agent_local_registry` with confirmation. The `connected_host` report includes route families, allowed capabilities, blocked lifecycle/non-Agent surfaces, and availability for the first-class Agent tools; `connected_host_capability` inspects one allowed or blocked capability by id, target, or query with its route families and boundary. 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

@@ -816566,7 +816566,7 @@ var createStyledCell = (char, overrides = {}) => ({
 // src/version.ts
 import { readFileSync } from "fs";
 import { join } from "path";
-var _version = "1.0.13";
+var _version = "1.0.15";
 var _sdkVersion = "0.33.35";
 try {
   const pkg = JSON.parse(readFileSync(join(import.meta.dir, "..", "package.json"), "utf-8"));
@@ -879834,6 +879834,126 @@ function describeHarnessCliCommand(args2) {
   };
 }
 
+// src/tools/agent-harness-command-catalog.ts
+function readString51(value) {
+  return typeof value === "string" ? value.trim() : "";
+}
+function readLimit6(value, fallback) {
+  const parsed = typeof value === "string" && value.trim() ? Number(value) : value;
+  if (typeof parsed !== "number" || !Number.isFinite(parsed))
+    return fallback;
+  return Math.max(1, Math.min(500, Math.trunc(parsed)));
+}
+function readStringArray12(value) {
+  if (!Array.isArray(value))
+    return [];
+  return value.map((entry) => typeof entry === "string" ? entry : String(entry));
+}
+function commandMatches(command8, query2) {
+  if (!query2)
+    return true;
+  const haystack = [
+    command8.name,
+    ...command8.aliases ?? [],
+    command8.description,
+    command8.usage ?? "",
+    command8.argsHint ?? ""
+  ].join(`
+`).toLowerCase();
+  return haystack.includes(query2.toLowerCase());
+}
+function describeCommand(command8, lookup) {
+  return {
+    name: command8.name,
+    slash: `/${command8.name}`,
+    aliases: command8.aliases ?? [],
+    description: command8.description,
+    usage: command8.usage ?? "",
+    argsHint: command8.argsHint ?? command8.usage ?? "",
+    ...lookup ? {
+      lookup: {
+        source: lookup.source,
+        input: lookup.input,
+        parsedName: lookup.parsedName,
+        parsedArgs: lookup.parsedArgs,
+        resolvedBy: lookup.resolvedBy
+      }
+    } : {},
+    policy: describeCommandPolicy(command8.name)
+  };
+}
+function commandDetailLookupFromArgs(args2) {
+  const rawCommand = readString51(args2.command);
+  if (rawCommand) {
+    const parsed = parseSlashCommand(rawCommand);
+    return { source: "command", input: rawCommand, parsedName: parsed.name, parsedArgs: parsed.args };
+  }
+  const rawCommandName = readString51(args2.commandName);
+  if (rawCommandName) {
+    const parsed = parseSlashCommand(rawCommandName);
+    const explicitArgs = readStringArray12(args2.args);
+    return {
+      source: "commandName",
+      input: rawCommandName,
+      parsedName: parsed.name,
+      parsedArgs: explicitArgs.length > 0 ? explicitArgs : parsed.args
+    };
+  }
+  const rawTarget = readString51(args2.target);
+  if (rawTarget) {
+    const parsed = parseSlashCommand(rawTarget);
+    return { source: "target", input: rawTarget, parsedName: parsed.name, parsedArgs: parsed.args };
+  }
+  const rawQuery = readString51(args2.query);
+  if (rawQuery) {
+    const parsed = parseSlashCommand(rawQuery);
+    return { source: "query", input: rawQuery, parsedName: parsed.name, parsedArgs: parsed.args };
+  }
+  return null;
+}
+function resolveCommandDetail(commandRegistry, args2) {
+  const lookup = commandDetailLookupFromArgs(args2);
+  if (!lookup?.parsedName)
+    return null;
+  const direct = commandRegistry.get(lookup.parsedName);
+  if (direct) {
+    return {
+      command: direct,
+      lookup: {
+        ...lookup,
+        resolvedBy: direct.name === lookup.parsedName ? "name" : "alias"
+      }
+    };
+  }
+  const normalized = lookup.parsedName.toLowerCase();
+  for (const command8 of commandRegistry.list()) {
+    if (command8.name.toLowerCase() === normalized) {
+      return { command: command8, lookup: { ...lookup, resolvedBy: "case-insensitive-name" } };
+    }
+    if ((command8.aliases ?? []).some((alias) => alias.toLowerCase() === normalized)) {
+      return { command: command8, lookup: { ...lookup, resolvedBy: "case-insensitive-alias" } };
+    }
+  }
+  const descriptionMatches = commandRegistry.list().filter((command8) => commandMatches(command8, lookup.input));
+  if (descriptionMatches.length === 1) {
+    return { command: descriptionMatches[0], lookup: { ...lookup, resolvedBy: "description" } };
+  }
+  const prefixMatches = commandRegistry.fuzzyMatch(lookup.parsedName).filter((entry) => entry.score >= 80);
+  if (prefixMatches.length === 1) {
+    return { command: prefixMatches[0].command, lookup: { ...lookup, resolvedBy: "prefix" } };
+  }
+  return null;
+}
+function listHarnessCommands(commandRegistry, args2) {
+  const query2 = readString51(args2.query);
+  const limit3 = readLimit6(args2.limit, 200);
+  return commandRegistry.list().filter((command8) => commandMatches(command8, query2)).sort((a4, b3) => a4.name.localeCompare(b3.name)).slice(0, limit3).map((command8) => describeCommand(command8));
+}
+function describeHarnessCommand(commandRegistry, args2) {
+  const detail = resolveCommandDetail(commandRegistry, args2);
+  return detail ? describeCommand(detail.command, detail.lookup) : null;
+}
+
 // src/tools/agent-harness-keybinding-metadata.ts
 import { existsSync as existsSync82, mkdirSync as mkdirSync67, readFileSync as readFileSync89, writeFileSync as writeFileSync58 } from "fs";
 import { dirname as dirname66 } from "path";
@@ -879847,10 +879967,10 @@ var FIXED_SHORTCUTS = [
   { key: "F2 / /shortcuts", description: "Open keyboard shortcut reference" },
   { key: "/keybindings", description: "List configurable keybindings and config path" }
 ];
-function readString51(value) {
+function readString52(value) {
   return typeof value === "string" ? value.trim() : "";
 }
-function readLimit6(value, fallback) {
+function readLimit7(value, fallback) {
   const parsed = typeof value === "string" && value.trim() ? Number(value) : value;
   if (typeof parsed !== "number" || !Number.isFinite(parsed))
     return fallback;
@@ -879871,7 +879991,7 @@ function isKeyAction2(action2) {
   return Object.hasOwn(ACTION_DESCRIPTIONS, action2);
 }
 function actionFromArgs(args2) {
-  const action2 = readString51(args2.actionId || args2.key || args2.query);
+  const action2 = readString52(args2.actionId || args2.key || args2.query);
   return action2 && isKeyAction2(action2) ? action2 : null;
 }
 function readBoolean15(value) {
@@ -879890,7 +880010,7 @@ function normalizeCombo(value) {
   if (typeof value !== "object" || value === null || Array.isArray(value))
     return null;
   const raw = value;
-  const key = readString51(raw.key);
+  const key = readString52(raw.key);
   if (!key)
     return null;
   const combo = { key };
@@ -879940,7 +880060,7 @@ function combosFromArgs(args2) {
   const fieldCombo = normalizeCombo(fields);
   if (fieldCombo)
     return [fieldCombo];
-  const labelCombo = parseComboLabel(readString51(args2.value));
+  const labelCombo = parseComboLabel(readString52(args2.value));
   if (labelCombo)
     return [labelCombo];
   throw new Error('set_keybinding requires combo, combos, fields.key, or a value such as "Ctrl+G".');
@@ -880008,9 +880128,9 @@ function totalHarnessShortcuts(context) {
 }
 function listHarnessShortcuts(context, args2) {
   const keybindings = listHarnessKeybindings(context, args2);
-  const query2 = readString51(args2.query).toLowerCase();
+  const query2 = readString52(args2.query).toLowerCase();
   const fixed = FIXED_SHORTCUTS.filter((shortcut) => !query2 || `${shortcut.key}
-${shortcut.description}`.toLowerCase().includes(query2)).slice(0, readLimit6(args2.limit, 200)).map((shortcut) => ({ ...shortcut, source: "fixed", userEditable: false }));
+${shortcut.description}`.toLowerCase().includes(query2)).slice(0, readLimit7(args2.limit, 200)).map((shortcut) => ({ ...shortcut, source: "fixed", userEditable: false }));
   return {
     configPath: keybindings.configPath,
     fixedShortcuts: fixed,
@@ -880022,8 +880142,8 @@ ${shortcut.description}`.toLowerCase().includes(query2)).slice(0, readLimit6(arg
 }
 function listHarnessKeybindings(context, args2) {
   const manager5 = requireKeybindingsManager2(context);
-  const query2 = readString51(args2.query);
-  const entries = manager5.getAll().filter((entry) => bindingMatches(entry, query2)).slice(0, readLimit6(args2.limit, 200)).map((entry) => describeBinding(manager5, entry.action, entry.combos));
+  const query2 = readString52(args2.query);
+  const entries = manager5.getAll().filter((entry) => bindingMatches(entry, query2)).slice(0, readLimit7(args2.limit, 200)).map((entry) => describeBinding(manager5, entry.action, entry.combos));
   return {
     configPath: manager5.getConfigPath(),
     keybindings: entries,
@@ -880078,10 +880198,10 @@ function resetHarnessKeybinding(context, args2) {
 }
 
 // src/tools/agent-harness-panel-metadata.ts
-function readString52(value) {
+function readString53(value) {
   return typeof value === "string" ? value.trim() : "";
 }
-function readLimit7(value, fallback) {
+function readLimit8(value, fallback) {
   const parsed = typeof value === "string" && value.trim() ? Number(value) : value;
   if (typeof parsed !== "number" || !Number.isFinite(parsed))
     return fallback;
@@ -880136,16 +880256,16 @@ function listHarnessPanels(context, args2) {
   const manager5 = panelManager(context);
   if (!manager5)
     return [];
-  const query2 = readString52(args2.query);
-  const category = readString52(args2.category);
-  const limit3 = readLimit7(args2.limit, 200);
+  const query2 = readString53(args2.query);
+  const category = readString53(args2.category);
+  const limit3 = readLimit8(args2.limit, 200);
   return manager5.getRegisteredTypes().map((registration) => describePanelRegistration(context, registration)).filter((panel) => !category || panel.category === category).filter((panel) => panelMatches(panel, query2)).sort((a4, b3) => String(a4.id).localeCompare(String(b3.id))).slice(0, limit3);
 }
 function describeHarnessPanel(context, args2) {
   const manager5 = panelManager(context);
   if (!manager5)
     return null;
-  const panelId = readString52(args2.panelId || args2.query);
+  const panelId = readString53(args2.panelId || args2.query);
   if (!panelId)
     return null;
   const registration = manager5.getRegisteredTypes().find((panel) => panel.id === panelId || panel.name.toLowerCase() === panelId.toLowerCase());
@@ -880156,11 +880276,11 @@ function openHarnessPanel(context, args2) {
   if (!panel) {
     return {
       status: "unknown_panel",
-      panelId: readString52(args2.panelId || args2.query) || "<missing>",
+      panelId: readString53(args2.panelId || args2.query) || "<missing>",
       availablePanels: listHarnessPanels(context, { limit: 50 }).map((entry) => entry.id)
     };
   }
-  const requestedPane = readString52(args2.pane);
+  const requestedPane = readString53(args2.pane);
   const pane = requestedPane === "bottom" || requestedPane === "top" ? requestedPane : undefined;
   if (!context.showPanel) {
     return {
@@ -880184,7 +880304,7 @@ import { join as join98 } from "path";
 function isRecord42(value) {
   return Boolean(value) && typeof value === "object" && !Array.isArray(value);
 }
-function readString53(record2, key) {
+function readString54(record2, key) {
   const value = record2?.[key];
   return typeof value === "string" ? value : null;
 }
@@ -880235,7 +880355,7 @@ async function inspectCliExternalRuntime(options) {
   try {
     const status = await fetchJson2(`${baseUrl}/status`, token.token, timeoutMs);
     const statusRecord = isRecord42(status.body) ? status.body : {};
-    const version6 = readString53(statusRecord, "version") ?? "unknown";
+    const version6 = readString54(statusRecord, "version") ?? "unknown";
     const compatible = status.ok && version6 === SDK_VERSION;
     if (!status.ok) {
       return {
@@ -880453,7 +880573,7 @@ function output6(value) {
 function error51(message) {
   return { success: false, error: message };
 }
-function readString54(value) {
+function readString55(value) {
   return typeof value === "string" ? value.trim() : "";
 }
 function readFieldMap2(value) {
@@ -880480,10 +880600,10 @@ function describeEditor(editor) {
 }
 function readRecordId(args2) {
   const fields = readFieldMap2(args2.fields);
-  return readString54(args2.recordId ?? args2.id ?? fields.recordId ?? fields.id);
+  return readString55(args2.recordId ?? args2.id ?? fields.recordId ?? fields.id);
 }
 function requireConfirmed(args2, label) {
-  if (!readString54(args2.explicitUserRequest))
+  if (!readString55(args2.explicitUserRequest))
     return `${label} requires explicitUserRequest with the user's exact request or a short faithful summary.`;
   if (args2.confirm !== true)
     return `${label} requires confirm:true after an explicit user request.`;
@@ -880611,7 +880731,7 @@ function localRegistryArgsForTarget(target, args2, recordId) {
     ...base2,
     ...edit,
     ...target.action === "stale" && fields.reason ? { reason: fields.reason } : {},
-    ...target.action === "delete" ? { confirm: args2.confirm, explicitUserRequest: readString54(args2.explicitUserRequest) } : {}
+    ...target.action === "delete" ? { confirm: args2.confirm, explicitUserRequest: readString55(args2.explicitUserRequest) } : {}
   };
 }
 async function executeTool(toolRegistry, name51, toolArgs) {
@@ -880677,7 +880797,7 @@ async function runLocalWorkspaceAction(deps, action2, args2) {
     if (missing.length > 0)
       return output6({ status: "missing_required_fields", missing, action: action2.id, editor: describeEditor(editor) });
     if (editor.kind === "knowledge-url")
-      return executeTool(deps.toolRegistry, "agent_knowledge_ingest", { sourceKind: "url", url: fieldReader(editor, fields)("url"), tags: splitList5(fieldReader(editor, fields)("tags")), folderPath: fieldReader(editor, fields)("folder"), confirm: args2.confirm, explicitUserRequest: readString54(args2.explicitUserRequest) });
+      return executeTool(deps.toolRegistry, "agent_knowledge_ingest", { sourceKind: "url", url: fieldReader(editor, fields)("url"), tags: splitList5(fieldReader(editor, fields)("tags")), folderPath: fieldReader(editor, fields)("folder"), confirm: args2.confirm, explicitUserRequest: readString55(args2.explicitUserRequest) });
     return executeTool(deps.toolRegistry, "agent_local_registry", localRegistryArgsFromEditor(editor, fields, recordId));
   }
   if (!target)
@@ -880686,19 +880806,19 @@ async function runLocalWorkspaceAction(deps, action2, args2) {
 }
 
 // src/tools/agent-harness-model-tool-catalog.ts
-function readString55(value) {
+function readString56(value) {
   return typeof value === "string" ? value.trim() : "";
 }
-function readLimit8(value, fallback) {
+function readLimit9(value, fallback) {
   const parsed = typeof value === "string" && value.trim() ? Number(value) : value;
   if (typeof parsed !== "number" || !Number.isFinite(parsed))
     return fallback;
   return Math.max(1, Math.min(500, Math.trunc(parsed)));
 }
 function listHarnessModelTools(toolRegistry, args2) {
-  const query2 = readString55(args2.query).toLowerCase();
+  const query2 = readString56(args2.query).toLowerCase();
   const includeParameters = args2.includeParameters === true;
-  const limit3 = readLimit8(args2.limit, 200);
+  const limit3 = readLimit9(args2.limit, 200);
   return toolRegistry.getToolDefinitions().filter((tool2) => !query2 || [tool2.name, tool2.description, ...tool2.sideEffects ?? []].join(`
 `).toLowerCase().includes(query2)).sort((a4, b3) => a4.name.localeCompare(b3.name)).slice(0, limit3).map((tool2) => ({
     name: tool2.name,
@@ -880710,6 +880830,24 @@ function listHarnessModelTools(toolRegistry, args2) {
     ...includeParameters ? { parameters: tool2.parameters } : {}
   }));
 }
+function describeHarnessModelTool(toolRegistry, args2) {
+  const query2 = readString56(args2.toolName || args2.target || args2.query).toLowerCase();
+  if (!query2)
+    return null;
+  const tool2 = toolRegistry.getToolDefinitions().find((candidate) => candidate.name.toLowerCase() === query2 || candidate.name.toLowerCase().includes(query2));
+  if (!tool2)
+    return null;
+  return {
+    name: tool2.name,
+    description: tool2.description,
+    sideEffects: tool2.sideEffects ?? [],
+    concurrency: tool2.concurrency ?? "parallel",
+    supportsProgress: tool2.supportsProgress ?? false,
+    supportsStreamingOutput: tool2.supportsStreamingOutput ?? false,
+    parameters: tool2.parameters,
+    policy: "This is a first-class model tool definition. Use the returned JSON schema directly; mutating or external side-effect tools still require the explicit confirmation arguments defined by that tool."
+  };
+}
 
 // src/tools/agent-harness-tool-schema.ts
 var AGENT_HARNESS_MODES = [
@@ -880740,6 +880878,7 @@ var AGENT_HARNESS_MODES = [
   "workspace_action",
   "run_workspace_action",
   "tools",
+  "tool",
   "connected_host",
   "connected_host_status",
   "connected_host_capability"
@@ -880758,11 +880897,11 @@ var AGENT_HARNESS_PARAMETER_PROPERTIES = {
   },
   query: {
     type: "string",
-    description: "Search text for command, setting, tool, or UI surface catalogs."
+    description: "Search text for command, setting, tool, or UI surface catalogs, or a slash-command lookup for mode command."
   },
   command: {
     type: "string",
-    description: 'Full slash command string for mode run_command, for example "/settings get provider.model". In cli_command mode this may also hold a top-level CLI string such as "goodvibes-agent status --json".'
+    description: 'Full slash command string for mode command 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",
@@ -880825,12 +880964,16 @@ var AGENT_HARNESS_PARAMETER_PROPERTIES = {
   },
   target: {
     type: "string",
-    description: "Optional UI target, such as a model-picker target or settings target key."
+    description: "Optional lookup target, such as a model-picker target, slash command root or invocation, settings key, model tool name, or connected-host capability id."
   },
   capabilityId: {
     type: "string",
     description: "Connected-host allowed or blocked capability id for mode connected_host_capability, such as agent-knowledge-read or connected-host-lifecycle."
   },
+  toolName: {
+    type: "string",
+    description: "First-class model tool name for mode tool, such as agent_harness or agent_local_registry."
+  },
   category: {
     type: "string",
     description: "Setting category filter such as provider, behavior, tools, ui, tts, permissions, automation, or surfaces."
@@ -880962,10 +881105,10 @@ async function openTtsVoicePicker(ctx, providerArg) {
 }
 
 // src/tools/agent-harness-ui-surface-metadata.ts
-function readString56(value) {
+function readString57(value) {
   return typeof value === "string" ? value.trim() : "";
 }
-function readLimit9(value, fallback) {
+function readLimit10(value, fallback) {
   const parsed = typeof value === "string" && value.trim() ? Number(value) : value;
   if (typeof parsed !== "number" || !Number.isFinite(parsed))
     return fallback;
@@ -880988,35 +881131,35 @@ function opened(surface, extra = {}) {
   };
 }
 function optionalModelTarget(args2) {
-  const target = readString56(args2.target);
+  const target = readString57(args2.target);
   return target === "main" || target === "helper" || target === "tool" || target === "tts" ? target : undefined;
 }
 function optionalOnboardingMode(args2) {
-  const target = readString56(args2.target);
+  const target = readString57(args2.target);
   return target === "new" || target === "edit" || target === "reopen" ? target : undefined;
 }
 function workspaceCategory(args2) {
-  return readString56(args2.categoryId || args2.category || args2.target) || undefined;
+  return readString57(args2.categoryId || args2.category || args2.target) || undefined;
 }
 function settingsTarget(args2) {
-  return readString56(args2.target || args2.key || args2.prefix) || undefined;
+  return readString57(args2.target || args2.key || args2.prefix) || undefined;
 }
 function providerTarget(args2) {
-  return readString56(args2.target || args2.key || args2.prefix) || undefined;
+  return readString57(args2.target || args2.key || args2.prefix) || undefined;
 }
 function optionalPane(args2) {
-  const pane = readString56(args2.pane);
+  const pane = readString57(args2.pane);
   return pane === "top" || pane === "bottom" ? pane : undefined;
 }
 function surfaceInputText(args2) {
-  return readString56(args2.prefix || args2.key || (args2.surfaceId ? args2.query : undefined) || args2.target) || undefined;
+  return readString57(args2.prefix || args2.key || (args2.surfaceId ? args2.query : undefined) || args2.target) || undefined;
 }
 function filePickerOptions(args2) {
-  const target = readString56(args2.target).toLowerCase();
+  const target = readString57(args2.target).toLowerCase();
   const injectMode = target === "inject" || target === "inject-mode" || target === "!@";
   return {
     injectMode,
-    query: readString56(args2.prefix || args2.key || (args2.surfaceId ? args2.query : undefined)) || undefined
+    query: readString57(args2.prefix || args2.key || (args2.surfaceId ? args2.query : undefined)) || undefined
   };
 }
 function openAgentWorkspaceCategory(context, surface, categoryId, extra = {}) {
@@ -881592,19 +881735,19 @@ function totalHarnessUiSurfaces() {
   return UI_SURFACES.length;
 }
 function listHarnessUiSurfaces(context, args2) {
-  const query2 = readString56(args2.query);
-  const limit3 = readLimit9(args2.limit, 200);
+  const query2 = readString57(args2.query);
+  const limit3 = readLimit10(args2.limit, 200);
   return UI_SURFACES.map((surface) => describeSurface(context, surface)).filter((surface) => surfaceMatches(surface, query2)).slice(0, limit3);
 }
 function describeHarnessUiSurface(context, args2) {
-  const surfaceId = readString56(args2.surfaceId || args2.query);
+  const surfaceId = readString57(args2.surfaceId || args2.query);
   if (!surfaceId)
     return null;
   const surface = UI_SURFACES.find((entry) => entry.id === surfaceId || entry.label.toLowerCase() === surfaceId.toLowerCase());
   return surface ? describeSurface(context, surface) : null;
 }
 async function openHarnessUiSurface(context, args2) {
-  const surfaceId = readString56(args2.surfaceId || args2.query);
+  const surfaceId = readString57(args2.surfaceId || args2.query);
   const surface = UI_SURFACES.find((entry) => entry.id === surfaceId || entry.label.toLowerCase() === surfaceId.toLowerCase());
   if (!surface) {
     return {
@@ -881624,16 +881767,16 @@ async function openHarnessUiSurface(context, args2) {
 function isMode(value) {
   return typeof value === "string" && AGENT_HARNESS_MODES.includes(value);
 }
-function readString57(value) {
+function readString58(value) {
   return typeof value === "string" ? value.trim() : "";
 }
-function readLimit10(value, fallback) {
+function readLimit11(value, fallback) {
   const parsed = typeof value === "string" && value.trim() ? Number(value) : value;
   if (typeof parsed !== "number" || !Number.isFinite(parsed))
     return fallback;
   return Math.max(1, Math.min(500, Math.trunc(parsed)));
 }
-function readStringArray12(value) {
+function readStringArray13(value) {
   if (!Array.isArray(value))
     return [];
   return value.map((entry) => typeof entry === "string" ? entry : String(entry));
@@ -881652,30 +881795,6 @@ function output7(value) {
 function error52(message) {
   return { success: false, error: message };
 }
-function commandMatches(command8, query2) {
-  if (!query2)
-    return true;
-  const haystack = [
-    command8.name,
-    ...command8.aliases ?? [],
-    command8.description,
-    command8.usage ?? "",
-    command8.argsHint ?? ""
-  ].join(`
-`).toLowerCase();
-  return haystack.includes(query2.toLowerCase());
-}
-function describeCommand(command8) {
-  return {
-    name: command8.name,
-    slash: `/${command8.name}`,
-    aliases: command8.aliases ?? [],
-    description: command8.description,
-    usage: command8.usage ?? "",
-    argsHint: command8.argsHint ?? command8.usage ?? "",
-    policy: describeCommandPolicy(command8.name)
-  };
-}
 function allWorkspaceActions() {
   return AGENT_WORKSPACE_CATEGORIES.flatMap((category) => category.actions.map((action2) => ({ category, action: action2 })));
 }
@@ -881708,7 +881827,7 @@ function describeWorkspaceEditor(editor) {
 }
 function selectedRoutineFromArgs(snapshot, args2) {
   const fields = readFieldMap3(args2.fields);
-  const routineId = readString57(args2.recordId) || readString57(fields.routineId) || readString57(fields.id);
+  const routineId = readString58(args2.recordId) || readString58(fields.routineId) || readString58(fields.id);
   if (!routineId)
     return null;
   return snapshot.localRoutines.find((routine) => routine.id === routineId || routine.name.toLowerCase() === routineId.toLowerCase()) ?? null;
@@ -881776,17 +881895,17 @@ function localEditorModelExecution(editorKind) {
   return "Use the command field, editor schema, or a first-class Agent model tool when available.";
 }
 function listWorkspaceActions(deps, args2) {
-  const query2 = readString57(args2.query);
-  const categoryId = readString57(args2.categoryId || args2.category);
-  const limit3 = readLimit10(args2.limit, 200);
+  const query2 = readString58(args2.query);
+  const categoryId = readString58(args2.categoryId || args2.category);
+  const limit3 = readLimit11(args2.limit, 200);
   const includeEditor = args2.includeParameters === true;
   const editorContext = includeEditor ? buildWorkspaceEditorContext(deps.commandContext, args2) : null;
   const source = query2 ? searchAgentWorkspaceActions(AGENT_WORKSPACE_CATEGORIES, query2).map((result2) => ({ category: result2.category, action: result2.action })) : allWorkspaceActions();
   return source.filter((entry) => !categoryId || entry.category.id === categoryId).slice(0, limit3).map((entry) => describeWorkspaceAction(entry.category, entry.action, { includeEditor, editorContext }));
 }
 function findWorkspaceAction(args2) {
-  const actionId = readString57(args2.actionId || args2.query);
-  const categoryId = readString57(args2.categoryId || args2.category);
+  const actionId = readString58(args2.actionId || args2.query);
+  const categoryId = readString58(args2.categoryId || args2.category);
   if (!actionId)
     return null;
   return allWorkspaceActions().find((entry) => {
@@ -881795,13 +881914,8 @@ function findWorkspaceAction(args2) {
     return entry.action.id === actionId || entry.action.label.toLowerCase() === actionId.toLowerCase();
   }) ?? null;
 }
-function listCommands(commandRegistry, args2) {
-  const query2 = readString57(args2.query);
-  const limit3 = readLimit10(args2.limit, 200);
-  return commandRegistry.list().filter((command8) => commandMatches(command8, query2)).sort((a4, b3) => a4.name.localeCompare(b3.name)).slice(0, limit3).map(describeCommand);
-}
 function requireConfirmedAction(args2, action2) {
-  const explicitUserRequest = readString57(args2.explicitUserRequest);
+  const explicitUserRequest = readString58(args2.explicitUserRequest);
   if (!explicitUserRequest)
     return `${action2} requires explicitUserRequest with the user's exact request or a short faithful summary.`;
   if (args2.confirm !== true)
@@ -881809,7 +881923,7 @@ function requireConfirmedAction(args2, action2) {
   return null;
 }
 function commandFromArgs(args2) {
-  const rawCommand = readString57(args2.command);
+  const rawCommand = readString58(args2.command);
   if (rawCommand) {
     const parsed = parseSlashCommand(rawCommand);
     if (!parsed.name)
@@ -881819,10 +881933,10 @@ function commandFromArgs(args2) {
       args: parsed.args
     };
   }
-  const commandName = readString57(args2.commandName).replace(/^\//, "");
+  const commandName = readString58(args2.commandName).replace(/^\//, "");
   if (!commandName)
     return null;
-  const commandArgs = readStringArray12(args2.args);
+  const commandArgs = readStringArray13(args2.args);
   return {
     name: commandName,
     args: commandArgs
@@ -882010,7 +882124,7 @@ function createAgentHarnessTool(deps) {
       name: "agent_harness",
       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, 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.",
+        "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.",
         "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(" "),
@@ -882046,10 +882160,10 @@ function createAgentHarnessTool(deps) {
               panels: 'Use mode:"panels" and mode:"panel" to inspect built-in panel catalog/open state; use mode:"open_panel" with confirm:true plus explicitUserRequest to route a visible panel/workspace change.',
               uiSurfaces: 'Use mode:"ui_surfaces" and mode:"ui_surface" to inspect modal/overlay/picker/workspace surfaces; use mode:"open_ui_surface" with confirm:true plus explicitUserRequest to route visible UI navigation.',
               shortcuts: 'Use mode:"shortcuts" to inspect fixed shortcuts plus configurable keybindings. Use mode:"set_keybinding" and mode:"reset_keybinding" with confirm:true plus explicitUserRequest to edit the same config file the user edits.',
-              slashCommands: 'Use mode:"commands" and mode:"command" to inspect; use mode:"run_command" with confirm:true plus explicitUserRequest to execute.',
+              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" for editor schemas; set includeParameters:true on workspace_actions to inline editor schemas.',
               settings: 'Use mode:"settings", mode:"get_setting", mode:"set_setting", and mode:"reset_setting".',
-              tools: 'Use mode:"tools" with includeParameters:true to inspect first-class model tool schemas.',
+              tools: 'Use mode:"tools" to list first-class model tools, or mode:"tool" with toolName, target, or query to inspect one schema.',
               connectedHost: 'Use mode:"connected_host" for the connected-host capability map and blocked boundaries. Use mode:"connected_host_capability" with capabilityId, target, or query for one allowed or blocked capability.',
               connectedHostStatus: 'Use mode:"connected_host_status" for live read-only host reachability, SDK compatibility, token posture, and Agent Knowledge route readiness.'
             },
@@ -882081,7 +882195,7 @@ function createAgentHarnessTool(deps) {
         }
         if (args2.mode === "panel") {
           const panel = describeHarnessPanel(deps.commandContext, args2);
-          return panel ? output7(panel) : error52(`Unknown panel ${readString57(args2.panelId || args2.query) || "<missing>"}.`);
+          return panel ? output7(panel) : error52(`Unknown panel ${readString58(args2.panelId || args2.query) || "<missing>"}.`);
         }
         if (args2.mode === "open_panel") {
           const confirmationError2 = requireConfirmedAction(args2, "Panel routing");
@@ -882095,7 +882209,7 @@ function createAgentHarnessTool(deps) {
         }
         if (args2.mode === "ui_surface") {
           const surface = describeHarnessUiSurface(deps.commandContext, args2);
-          return surface ? output7(surface) : error52(`Unknown UI surface ${readString57(args2.surfaceId || args2.query) || "<missing>"}.`);
+          return surface ? output7(surface) : error52(`Unknown UI surface ${readString58(args2.surfaceId || args2.query) || "<missing>"}.`);
         }
         if (args2.mode === "open_ui_surface") {
           const confirmationError2 = requireConfirmedAction(args2, "UI surface routing");
@@ -882109,7 +882223,7 @@ function createAgentHarnessTool(deps) {
           return output7(listHarnessKeybindings(deps.commandContext, args2));
         if (args2.mode === "keybinding") {
           const binding = describeHarnessKeybinding(deps.commandContext, args2);
-          return binding ? output7(binding) : error52(`Unknown keybinding action ${readString57(args2.actionId || args2.key || args2.query) || "<missing>"}.`);
+          return binding ? output7(binding) : error52(`Unknown keybinding action ${readString58(args2.actionId || args2.key || args2.query) || "<missing>"}.`);
         }
         if (args2.mode === "set_keybinding") {
           const confirmationError2 = requireConfirmedAction(args2, "Keybinding mutation");
@@ -882124,28 +882238,28 @@ function createAgentHarnessTool(deps) {
           return output7(resetHarnessKeybinding(deps.commandContext, args2));
         }
         if (args2.mode === "commands") {
-          const commands3 = listCommands(deps.commandRegistry, args2);
+          const commands3 = listHarnessCommands(deps.commandRegistry, args2);
           return output7({ commands: commands3, returned: commands3.length, total: deps.commandRegistry.list().length });
         }
         if (args2.mode === "command") {
-          const name51 = readString57(args2.commandName).replace(/^\//, "");
-          const command8 = name51 ? deps.commandRegistry.get(name51) : null;
-          return command8 ? output7(describeCommand(command8)) : error52(`Unknown slash command /${name51 || "<missing>"}.`);
+          const detail = describeHarnessCommand(deps.commandRegistry, args2);
+          const query2 = readString58(args2.command || args2.commandName || args2.target || args2.query);
+          return detail ? output7(detail) : error52(`Unknown slash command ${query2 || "<missing>"}. Use mode:"commands" to inspect available commands.`);
         }
         if (args2.mode === "run_command")
           return runCommand2(deps, args2);
         if (args2.mode === "settings") {
           const settings = listHarnessSettings(deps.commandContext.platform.configManager, {
-            category: readString57(args2.category) || undefined,
-            prefix: readString57(args2.prefix) || undefined,
-            query: readString57(args2.query) || undefined,
+            category: readString58(args2.category) || undefined,
+            prefix: readString58(args2.prefix) || undefined,
+            query: readString58(args2.query) || undefined,
             includeHidden: args2.includeHidden === true,
-            limit: readLimit10(args2.limit, 100)
+            limit: readLimit11(args2.limit, 100)
           });
           return output7({ settings, returned: settings.length, policy: settingsPolicySummary() });
         }
         if (args2.mode === "get_setting") {
-          const key = readString57(args2.key);
+          const key = readString58(args2.key);
           const setting = getHarnessSetting(deps.commandContext.platform.configManager, key);
           return setting ? output7(setting) : error52(`Unknown setting ${key || "<missing>"}.`);
         }
@@ -882155,7 +882269,7 @@ function createAgentHarnessTool(deps) {
             return error52(confirmationError2);
           if (args2.value === undefined)
             return error52("set_setting requires value.");
-          const key = readString57(args2.key);
+          const key = readString58(args2.key);
           const result2 = await setHarnessSetting(deps.commandContext.platform.configManager, deps.commandContext.platform.secretsManager, key, args2.value);
           return output7(result2);
         }
@@ -882163,7 +882277,7 @@ function createAgentHarnessTool(deps) {
           const confirmationError2 = requireConfirmedAction(args2, "Setting reset");
           if (confirmationError2)
             return error52(confirmationError2);
-          const key = readString57(args2.key);
+          const key = readString58(args2.key);
           const result2 = await resetHarnessSetting(deps.commandContext.platform.configManager, deps.commandContext.platform.secretsManager, key);
           return output7(result2);
         }
@@ -882180,7 +882294,7 @@ function createAgentHarnessTool(deps) {
         if (args2.mode === "workspace_action") {
           const found = findWorkspaceAction(args2);
           const editorContext = buildWorkspaceEditorContext(deps.commandContext, args2);
-          return found ? output7(describeWorkspaceAction(found.category, found.action, { includeEditor: true, editorContext })) : error52(`Unknown Agent workspace action ${readString57(args2.actionId || args2.query) || "<missing>"}.`);
+          return found ? output7(describeWorkspaceAction(found.category, found.action, { includeEditor: true, editorContext })) : error52(`Unknown Agent workspace action ${readString58(args2.actionId || args2.query) || "<missing>"}.`);
         }
         if (args2.mode === "run_workspace_action")
           return runWorkspaceAction(deps, args2);
@@ -882188,10 +882302,15 @@ function createAgentHarnessTool(deps) {
           const tools3 = listHarnessModelTools(deps.toolRegistry, args2);
           return output7({ tools: tools3, returned: tools3.length, total: deps.toolRegistry.getToolDefinitions().length });
         }
+        if (args2.mode === "tool") {
+          const query2 = readString58(args2.toolName || args2.target || args2.query);
+          const tool2 = describeHarnessModelTool(deps.toolRegistry, args2);
+          return tool2 ? output7(tool2) : error52(`Unknown model tool ${query2 || "<missing>"}. Use mode:"tools" to inspect available model tools.`);
+        }
         if (args2.mode === "connected_host")
           return output7(connectedHostSummary(deps.commandContext, deps.toolRegistry));
         if (args2.mode === "connected_host_capability") {
-          const query2 = readString57(args2.capabilityId || args2.target || args2.query);
+          const query2 = readString58(args2.capabilityId || args2.target || args2.query);
           const capability = describeConnectedHostCapability(deps.toolRegistry, query2);
           return capability ? output7(capability) : error52(`Unknown connected-host capability ${query2 || "<missing>"}. Use mode:"connected_host" to inspect allowed and blocked capability ids.`);
         }

package/docs/README.md

@@ -22,7 +22,7 @@ Important baseline constraints:
 - Agent depends on `@pellux/goodvibes-sdk@0.33.35`.
 - Agent connects to a GoodVibes host owned outside this product.
 - Agent does not start, stop, restart, install, uninstall, or own the connected GoodVibes host.
-- User-facing Agent workspace actions, built-in panels, modal/overlay/picker UI surfaces, named operator surfaces, top-level CLI mirrors, fixed shortcuts, configurable keybindings, slash commands, command policy metadata, model tools, settings, local registries, connected-host capability boundaries, single connected-host capability inspection, and live connected-host readiness are model-visible through Agent-owned tools. Visible UI routing includes the command browser, reasoning-effort picker, live process output, runtime activity, settings, workspaces, and pickers the user can open. Local memory, note, persona, skill, and routine create editors can also run through confirmed workspace actions. Mutations and visible UI routing remain explicit and confirmation-gated.
+- User-facing Agent workspace actions, built-in panels, modal/overlay/picker UI surfaces, named operator surfaces, top-level CLI mirrors, fixed shortcuts, configurable keybindings, slash commands, single-command lookup with policy metadata, model tools and individual model tool schemas, settings, local registries, connected-host capability boundaries, single connected-host capability inspection, and live connected-host readiness are model-visible through Agent-owned tools. Visible UI routing includes the command browser, reasoning-effort picker, live process output, runtime activity, settings, workspaces, and pickers the user can open. Local memory, note, persona, skill, and routine create editors can also run through confirmed workspace actions. Mutations and visible UI routing remain explicit and confirmation-gated.
 - Agent Knowledge uses only `/api/goodvibes-agent/knowledge/*`; there is no default knowledge or non-Agent product fallback.
 - Agent supports isolated Agent homes with `GOODVIBES_AGENT_HOME=<path>` and named profile homes with `goodvibes-agent profiles create <name> --template <starter> --yes` plus `--agent-profile <name>`.
 - Agent supports connected-host URL overrides with `--runtime-url http://host:port` or `GOODVIBES_AGENT_RUNTIME_URL=http://host:port`; these only change the Agent connection target.

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, single connected-host capability inspection, 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, command browser, conversation search, prompt-history search, slash-command mode, file picker, block actions, context, runtime activity, live process output, bookmarks, model/provider/reasoning-effort 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. Direct local create editors for memory, notes, personas, skills, and routines can execute from submitted fields through `run_workspace_action` and `agent_local_registry` with confirmation. 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, single slash-command inspection by typed command or lookup text, command policy metadata, command execution with confirmation, model tool discovery and single-tool schema inspection, settings inspection/mutation, connected-host capability inventory, single connected-host capability inspection, 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, command browser, conversation search, prompt-history search, slash-command mode, file picker, block actions, context, runtime activity, live process output, bookmarks, model/provider/reasoning-effort 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. Direct local create editors for memory, notes, personas, skills, and routines can execute from submitted fields through `run_workspace_action` and `agent_local_registry` with confirmation. 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

@@ -43,14 +43,14 @@ Host-management and coding-first commands that would imply connected-host lifecy
 
 The main Agent model has an Agent-owned harness bridge rather than generic SDK settings/context control. Use these model tools as the supported parity layer:
 
-- `agent_harness`: inspect workspace categories/actions, inspect built-in panels, inspect modal/overlay/picker UI surfaces and named operator surfaces, inspect top-level CLI mirrors, inspect fixed shortcuts and configurable keybindings, inspect slash commands and command policy metadata, run concrete workspace or slash-command mirrors with confirmation, inspect model tools, inspect or change Agent settings/keybindings, inspect connected-host capability boundaries or one connected-host capability, and inspect live connected-host readiness.
+- `agent_harness`: inspect workspace categories/actions, inspect built-in panels, inspect modal/overlay/picker UI surfaces and named operator surfaces, inspect top-level CLI mirrors, inspect fixed shortcuts and configurable keybindings, inspect slash commands and one slash command by typed command or lookup text with policy metadata, run concrete workspace or slash-command mirrors with confirmation, inspect model tools or one model tool schema, inspect or change Agent settings/keybindings, inspect connected-host capability boundaries or one connected-host capability, and inspect live connected-host readiness.
 - `agent_local_registry`: inspect and maintain Agent-local memory, notes, personas, skills, skill bundles, and routines. Deleting local records requires `confirm:true` and `explicitUserRequest`.
 - `agent_knowledge` and `agent_knowledge_ingest`: ask/search and ingest into the isolated Agent Knowledge segment.
 - `agent_operator_briefing` and `agent_operator_action`: inspect connected work/approval/automation posture, or run exact confirmed approval/automation actions.
 - `agent_work_plan`: keep the visible Agent-local work plan current from the conversation.
 - `agent_channel_send`, `agent_notify`, `agent_reminder_schedule`, and `agent_media_generate`: perform confirmed external delivery, notification, reminder, or media actions when the user explicitly asks.
 
-`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; `connected_host_capability` returns one allowed or blocked connected-host capability by `capabilityId`, `target`, or `query` with related route families and boundary text; 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.
+`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` lists slash-command descriptions; `command` returns one slash-command detail by `command`, `commandName`, `target`, or `query`, including parsed arguments 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` lists model tool definitions and can inline JSON schemas with `includeParameters:true`; `tool` returns one model tool schema by `toolName`, `target`, or `query`; `settings` returns setting descriptors plus setting policy; `connected_host` returns the connected-host route families, allowed capabilities, blocked capabilities, and first-class tool availability; `connected_host_capability` returns one allowed or blocked connected-host capability by `capabilityId`, `target`, or `query` with related route families and boundary text; 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/reasoning-effort 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, command browser, file picker, block actions, bookmarks, context inspector, runtime activity monitor, live process output, 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.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pellux/goodvibes-agent",
-  "version": "1.0.13",
+  "version": "1.0.15",
   "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/tools/agent-harness-command-catalog.ts

@@ -0,0 +1,149 @@
+import type { CommandRegistry, SlashCommand } from '../input/command-registry.ts';
+import { parseSlashCommand } from '../input/slash-command-parser.ts';
+import { describeCommandPolicy } from './agent-harness-metadata.ts';
+
+export interface AgentHarnessCommandCatalogArgs {
+  readonly query?: unknown;
+  readonly command?: unknown;
+  readonly commandName?: unknown;
+  readonly args?: unknown;
+  readonly target?: unknown;
+  readonly limit?: unknown;
+}
+
+interface CommandDetailLookup {
+  readonly source: 'command' | 'commandName' | 'target' | 'query';
+  readonly input: string;
+  readonly parsedName: string;
+  readonly parsedArgs: readonly string[];
+  readonly resolvedBy: 'name' | 'alias' | 'case-insensitive-name' | 'case-insensitive-alias' | 'description' | 'prefix';
+}
+
+function readString(value: unknown): string {
+  return typeof value === 'string' ? value.trim() : '';
+}
+
+function readLimit(value: unknown, fallback: number): number {
+  const parsed = typeof value === 'string' && value.trim() ? Number(value) : value;
+  if (typeof parsed !== 'number' || !Number.isFinite(parsed)) return fallback;
+  return Math.max(1, Math.min(500, Math.trunc(parsed)));
+}
+
+function readStringArray(value: unknown): readonly string[] {
+  if (!Array.isArray(value)) return [];
+  return value.map((entry) => typeof entry === 'string' ? entry : String(entry));
+}
+
+function commandMatches(command: SlashCommand, query: string): boolean {
+  if (!query) return true;
+  const haystack = [
+    command.name,
+    ...(command.aliases ?? []),
+    command.description,
+    command.usage ?? '',
+    command.argsHint ?? '',
+  ].join('\n').toLowerCase();
+  return haystack.includes(query.toLowerCase());
+}
+
+function describeCommand(command: SlashCommand, lookup?: CommandDetailLookup): Record<string, unknown> {
+  return {
+    name: command.name,
+    slash: `/${command.name}`,
+    aliases: command.aliases ?? [],
+    description: command.description,
+    usage: command.usage ?? '',
+    argsHint: command.argsHint ?? command.usage ?? '',
+    ...(lookup ? {
+      lookup: {
+        source: lookup.source,
+        input: lookup.input,
+        parsedName: lookup.parsedName,
+        parsedArgs: lookup.parsedArgs,
+        resolvedBy: lookup.resolvedBy,
+      },
+    } : {}),
+    policy: describeCommandPolicy(command.name),
+  };
+}
+
+function commandDetailLookupFromArgs(args: AgentHarnessCommandCatalogArgs): Omit<CommandDetailLookup, 'resolvedBy'> | null {
+  const rawCommand = readString(args.command);
+  if (rawCommand) {
+    const parsed = parseSlashCommand(rawCommand);
+    return { source: 'command', input: rawCommand, parsedName: parsed.name, parsedArgs: parsed.args };
+  }
+  const rawCommandName = readString(args.commandName);
+  if (rawCommandName) {
+    const parsed = parseSlashCommand(rawCommandName);
+    const explicitArgs = readStringArray(args.args);
+    return {
+      source: 'commandName',
+      input: rawCommandName,
+      parsedName: parsed.name,
+      parsedArgs: explicitArgs.length > 0 ? explicitArgs : parsed.args,
+    };
+  }
+  const rawTarget = readString(args.target);
+  if (rawTarget) {
+    const parsed = parseSlashCommand(rawTarget);
+    return { source: 'target', input: rawTarget, parsedName: parsed.name, parsedArgs: parsed.args };
+  }
+  const rawQuery = readString(args.query);
+  if (rawQuery) {
+    const parsed = parseSlashCommand(rawQuery);
+    return { source: 'query', input: rawQuery, parsedName: parsed.name, parsedArgs: parsed.args };
+  }
+  return null;
+}
+
+function resolveCommandDetail(commandRegistry: CommandRegistry, args: AgentHarnessCommandCatalogArgs): { readonly command: SlashCommand; readonly lookup: CommandDetailLookup } | null {
+  const lookup = commandDetailLookupFromArgs(args);
+  if (!lookup?.parsedName) return null;
+  const direct = commandRegistry.get(lookup.parsedName);
+  if (direct) {
+    return {
+      command: direct,
+      lookup: {
+        ...lookup,
+        resolvedBy: direct.name === lookup.parsedName ? 'name' : 'alias',
+      },
+    };
+  }
+
+  const normalized = lookup.parsedName.toLowerCase();
+  for (const command of commandRegistry.list()) {
+    if (command.name.toLowerCase() === normalized) {
+      return { command, lookup: { ...lookup, resolvedBy: 'case-insensitive-name' } };
+    }
+    if ((command.aliases ?? []).some((alias) => alias.toLowerCase() === normalized)) {
+      return { command, lookup: { ...lookup, resolvedBy: 'case-insensitive-alias' } };
+    }
+  }
+
+  const descriptionMatches = commandRegistry.list().filter((command) => commandMatches(command, lookup.input));
+  if (descriptionMatches.length === 1) {
+    return { command: descriptionMatches[0]!, lookup: { ...lookup, resolvedBy: 'description' } };
+  }
+
+  const prefixMatches = commandRegistry.fuzzyMatch(lookup.parsedName).filter((entry) => entry.score >= 80);
+  if (prefixMatches.length === 1) {
+    return { command: prefixMatches[0]!.command, lookup: { ...lookup, resolvedBy: 'prefix' } };
+  }
+  return null;
+}
+
+export function listHarnessCommands(commandRegistry: CommandRegistry, args: AgentHarnessCommandCatalogArgs): readonly Record<string, unknown>[] {
+  const query = readString(args.query);
+  const limit = readLimit(args.limit, 200);
+  return commandRegistry.list()
+    .filter((command) => commandMatches(command, query))
+    .sort((a, b) => a.name.localeCompare(b.name))
+    .slice(0, limit)
+    .map((command) => describeCommand(command));
+}
+
+export function describeHarnessCommand(commandRegistry: CommandRegistry, args: AgentHarnessCommandCatalogArgs): Record<string, unknown> | null {
+  const detail = resolveCommandDetail(commandRegistry, args);
+  return detail ? describeCommand(detail.command, detail.lookup) : null;
+}

package/src/tools/agent-harness-model-tool-catalog.ts

@@ -2,6 +2,8 @@ import type { ToolRegistry } from '@pellux/goodvibes-sdk/platform/tools';
 
 export interface AgentHarnessModelToolCatalogArgs {
   readonly query?: unknown;
+  readonly toolName?: unknown;
+  readonly target?: unknown;
   readonly includeParameters?: unknown;
   readonly limit?: unknown;
 }
@@ -34,3 +36,21 @@ export function listHarnessModelTools(toolRegistry: ToolRegistry, args: AgentHar
       ...(includeParameters ? { parameters: tool.parameters } : {}),
     }));
 }
+
+export function describeHarnessModelTool(toolRegistry: ToolRegistry, args: AgentHarnessModelToolCatalogArgs): Record<string, unknown> | null {
+  const query = readString(args.toolName || args.target || args.query).toLowerCase();
+  if (!query) return null;
+  const tool = toolRegistry.getToolDefinitions()
+    .find((candidate) => candidate.name.toLowerCase() === query || candidate.name.toLowerCase().includes(query));
+  if (!tool) return null;
+  return {
+    name: tool.name,
+    description: tool.description,
+    sideEffects: tool.sideEffects ?? [],
+    concurrency: tool.concurrency ?? 'parallel',
+    supportsProgress: tool.supportsProgress ?? false,
+    supportsStreamingOutput: tool.supportsStreamingOutput ?? false,
+    parameters: tool.parameters,
+    policy: 'This is a first-class model tool definition. Use the returned JSON schema directly; mutating or external side-effect tools still require the explicit confirmation arguments defined by that tool.',
+  };
+}

package/src/tools/agent-harness-tool-schema.ts

@@ -4,7 +4,7 @@ export const AGENT_HARNESS_MODES = [
   'shortcuts', 'keybindings', 'keybinding', 'set_keybinding', 'reset_keybinding',
   'commands', 'command', 'run_command', 'settings', 'get_setting', 'set_setting',
   'reset_setting', 'workspace', 'workspace_categories', 'workspace_actions',
-  'workspace_action', 'run_workspace_action', 'tools', 'connected_host', 'connected_host_status',
+  'workspace_action', 'run_workspace_action', 'tools', 'tool', 'connected_host', 'connected_host_status',
   'connected_host_capability',
 ] as const;
 
@@ -23,11 +23,11 @@ export const AGENT_HARNESS_PARAMETER_PROPERTIES = {
   },
   query: {
     type: 'string',
-    description: 'Search text for command, setting, tool, or UI surface catalogs.',
+    description: 'Search text for command, setting, tool, or UI surface catalogs, or a slash-command lookup for mode command.',
   },
   command: {
     type: 'string',
-    description: 'Full slash command string for mode run_command, for example "/settings get provider.model". In cli_command mode this may also hold a top-level CLI string such as "goodvibes-agent status --json".',
+    description: 'Full slash command string for mode command 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',
@@ -90,12 +90,16 @@ export const AGENT_HARNESS_PARAMETER_PROPERTIES = {
   },
   target: {
     type: 'string',
-    description: 'Optional UI target, such as a model-picker target or settings target key.',
+    description: 'Optional lookup target, such as a model-picker target, slash command root or invocation, settings key, model tool name, or connected-host capability id.',
   },
   capabilityId: {
     type: 'string',
     description: 'Connected-host allowed or blocked capability id for mode connected_host_capability, such as agent-knowledge-read or connected-host-lifecycle.',
   },
+  toolName: {
+    type: 'string',
+    description: 'First-class model tool name for mode tool, such as agent_harness or agent_local_registry.',
+  },
   category: {
     type: 'string',
     description: 'Setting category filter such as provider, behavior, tools, ui, tts, permissions, automation, or surfaces.',

package/src/tools/agent-harness-tool.ts

@@ -1,6 +1,6 @@
 import type { Tool } from '@pellux/goodvibes-sdk/platform/types';
 import type { ToolRegistry } from '@pellux/goodvibes-sdk/platform/tools';
-import type { CommandContext, CommandRegistry, SlashCommand } from '../input/command-registry.ts';
+import type { CommandContext, CommandRegistry } from '../input/command-registry.ts';
 import { buildAgentWorkspaceCommandEditorSubmission, isAgentWorkspaceCommandEditorKind } from '../input/agent-workspace-command-editor.ts';
 import { createAgentWorkspaceEditor } from '../input/agent-workspace-activation.ts';
 import { AGENT_WORKSPACE_CATEGORIES } from '../input/agent-workspace-categories.ts';
@@ -18,17 +18,17 @@ import type {
 } from '../input/agent-workspace-types.ts';
 import { parseSlashCommand } from '../input/slash-command-parser.ts';
 import { blockedHarnessCliCommandTokens, describeHarnessCliCommand, listHarnessCliCommands, totalHarnessCliCommands } from './agent-harness-cli-metadata.ts';
+import { describeHarnessCommand, listHarnessCommands } from './agent-harness-command-catalog.ts';
 import { describeHarnessKeybinding, listHarnessKeybindings, listHarnessShortcuts, resetHarnessKeybinding, setHarnessKeybinding, totalHarnessKeybindings, totalHarnessShortcuts } from './agent-harness-keybinding-metadata.ts';
 import { describeHarnessPanel, listHarnessPanels, openHarnessPanel, totalHarnessPanels } from './agent-harness-panel-metadata.ts';
 import { connectedHostStatusSummary } from './agent-harness-connected-host-status.ts';
 import { describeLocalWorkspaceModelExecution, runLocalWorkspaceAction, runLocalWorkspaceEditorAction } from './agent-harness-local-operations.ts';
-import { listHarnessModelTools } from './agent-harness-model-tool-catalog.ts';
+import { describeHarnessModelTool, listHarnessModelTools } from './agent-harness-model-tool-catalog.ts';
 import { AGENT_HARNESS_MODES, AGENT_HARNESS_PARAMETER_PROPERTIES } from './agent-harness-tool-schema.ts';
 import { describeHarnessUiSurface, listHarnessUiSurfaces, openHarnessUiSurface, totalHarnessUiSurfaces } from './agent-harness-ui-surface-metadata.ts';
 import {
   connectedHostSummary,
   describeConnectedHostCapability,
-  describeCommandPolicy,
   settingsPolicySummary,
 } from './agent-harness-metadata.ts';
 import {
@@ -60,6 +60,7 @@ interface AgentHarnessToolArgs {
   readonly value?: unknown;
   readonly target?: unknown;
   readonly capabilityId?: unknown;
+  readonly toolName?: unknown;
   readonly category?: unknown;
   readonly prefix?: unknown;
   readonly includeHidden?: unknown;
@@ -114,30 +115,6 @@ function output(value: unknown): { readonly success: true; readonly output: stri
 
 function error(message: string): { readonly success: false; readonly error: string } { return { success: false, error: message }; }
 
-function commandMatches(command: SlashCommand, query: string): boolean {
-  if (!query) return true;
-  const haystack = [
-    command.name,
-    ...(command.aliases ?? []),
-    command.description,
-    command.usage ?? '',
-    command.argsHint ?? '',
-  ].join('\n').toLowerCase();
-  return haystack.includes(query.toLowerCase());
-}
-
-function describeCommand(command: SlashCommand): Record<string, unknown> {
-  return {
-    name: command.name,
-    slash: `/${command.name}`,
-    aliases: command.aliases ?? [],
-    description: command.description,
-    usage: command.usage ?? '',
-    argsHint: command.argsHint ?? command.usage ?? '',
-    policy: describeCommandPolicy(command.name),
-  };
-}
-
 function allWorkspaceActions(): ReadonlyArray<{
   readonly category: AgentWorkspaceCategory;
   readonly action: AgentWorkspaceAction;
@@ -275,16 +252,6 @@ function findWorkspaceAction(args: AgentHarnessToolArgs): { readonly category: A
   }) ?? null;
 }
 
-function listCommands(commandRegistry: CommandRegistry, args: AgentHarnessToolArgs): readonly Record<string, unknown>[] {
-  const query = readString(args.query);
-  const limit = readLimit(args.limit, 200);
-  return commandRegistry.list()
-    .filter((command) => commandMatches(command, query))
-    .sort((a, b) => a.name.localeCompare(b.name))
-    .slice(0, limit)
-    .map(describeCommand);
-}
-
 function requireConfirmedAction(args: AgentHarnessToolArgs, action: string): string | null {
   const explicitUserRequest = readString(args.explicitUserRequest);
   if (!explicitUserRequest) return `${action} requires explicitUserRequest with the user's exact request or a short faithful summary.`;
@@ -515,7 +482,7 @@ export function createAgentHarnessTool(deps: AgentHarnessToolDeps): Tool {
       name: 'agent_harness',
       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, 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.',
+        '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.',
         '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(' '),
@@ -550,10 +517,10 @@ export function createAgentHarnessTool(deps: AgentHarnessToolDeps): Tool {
               panels: 'Use mode:"panels" and mode:"panel" to inspect built-in panel catalog/open state; use mode:"open_panel" with confirm:true plus explicitUserRequest to route a visible panel/workspace change.',
               uiSurfaces: 'Use mode:"ui_surfaces" and mode:"ui_surface" to inspect modal/overlay/picker/workspace surfaces; use mode:"open_ui_surface" with confirm:true plus explicitUserRequest to route visible UI navigation.',
               shortcuts: 'Use mode:"shortcuts" to inspect fixed shortcuts plus configurable keybindings. Use mode:"set_keybinding" and mode:"reset_keybinding" with confirm:true plus explicitUserRequest to edit the same config file the user edits.',
-              slashCommands: 'Use mode:"commands" and mode:"command" to inspect; use mode:"run_command" with confirm:true plus explicitUserRequest to execute.',
+              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" for editor schemas; set includeParameters:true on workspace_actions to inline editor schemas.',
               settings: 'Use mode:"settings", mode:"get_setting", mode:"set_setting", and mode:"reset_setting".',
-              tools: 'Use mode:"tools" with includeParameters:true to inspect first-class model tool schemas.',
+              tools: 'Use mode:"tools" to list first-class model tools, or mode:"tool" with toolName, target, or query to inspect one schema.',
               connectedHost: 'Use mode:"connected_host" for the connected-host capability map and blocked boundaries. Use mode:"connected_host_capability" with capabilityId, target, or query for one allowed or blocked capability.',
               connectedHostStatus: 'Use mode:"connected_host_status" for live read-only host reachability, SDK compatibility, token posture, and Agent Knowledge route readiness.',
             },
@@ -622,13 +589,15 @@ export function createAgentHarnessTool(deps: AgentHarnessToolDeps): Tool {
           return output(resetHarnessKeybinding(deps.commandContext, args));
         }
         if (args.mode === 'commands') {
-          const commands = listCommands(deps.commandRegistry, args);
+          const commands = listHarnessCommands(deps.commandRegistry, args);
           return output({ commands, returned: commands.length, total: deps.commandRegistry.list().length });
         }
         if (args.mode === 'command') {
-          const name = readString(args.commandName).replace(/^\//, '');
-          const command = name ? deps.commandRegistry.get(name) : null;
-          return command ? output(describeCommand(command)) : error(`Unknown slash command /${name || '<missing>'}.`);
+          const detail = describeHarnessCommand(deps.commandRegistry, args);
+          const query = readString(args.command || args.commandName || args.target || args.query);
+          return detail
+            ? output(detail)
+            : error(`Unknown slash command ${query || '<missing>'}. Use mode:"commands" to inspect available commands.`);
         }
         if (args.mode === 'run_command') return runCommand(deps, args);
         if (args.mode === 'settings') {
@@ -692,6 +661,13 @@ export function createAgentHarnessTool(deps: AgentHarnessToolDeps): Tool {
           const tools = listHarnessModelTools(deps.toolRegistry, args);
           return output({ tools, returned: tools.length, total: deps.toolRegistry.getToolDefinitions().length });
         }
+        if (args.mode === 'tool') {
+          const query = readString(args.toolName || args.target || args.query);
+          const tool = describeHarnessModelTool(deps.toolRegistry, args);
+          return tool
+            ? output(tool)
+            : error(`Unknown model tool ${query || '<missing>'}. Use mode:"tools" to inspect available model tools.`);
+        }
         if (args.mode === 'connected_host') return output(connectedHostSummary(deps.commandContext, deps.toolRegistry));
         if (args.mode === 'connected_host_capability') {
           const query = readString(args.capabilityId || args.target || args.query);

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.13';
+let _version = '1.0.15';
 let _sdkVersion = '0.33.35';
 try {
   const pkg = JSON.parse(readFileSync(join(import.meta.dir, '..', 'package.json'), 'utf-8')) as {