@pellux/goodvibes-agent 1.0.8 → 1.0.9

package/CHANGELOG.md

@@ -2,6 +2,10 @@
 
 Product-facing release notes for GoodVibes Agent.
 
+## 1.0.9 - 2026-06-03
+
+- Expose TTS provider and voice pickers through the model-visible harness, make /help and /commands use the live slash-command registry, and refresh package-facing docs and focused coverage for the current 1.0.x surface map.
+
 ## 1.0.8 - 2026-06-03
 
 - Added model-visible UI surface entries for the panel-picker compatibility route and the security, knowledge, and subscription operator surfaces.

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, bookmarks, model/provider 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, context, 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

@@ -389257,23 +389257,6 @@ function createSchema2(db) {
   `);
   db.run(`CREATE INDEX IF NOT EXISTS idx_knowledge_schedules_job_id ON knowledge_schedules(job_id)`);
 }
-function getKnowledgeSchemaStatements() {
-  const statements = [];
-  createSchema2({
-    run(sql) {
-      const normalized = sql.trim();
-      if (normalized.length > 0)
-        statements.push(normalized);
-    }
-  });
-  return statements;
-}
-function renderKnowledgeSchemaSql() {
-  return `${getKnowledgeSchemaStatements().map((statement) => statement.endsWith(";") ? statement : `${statement};`).join(`
-
-`)}
-`;
-}
 function rowObject(columns, values2) {
   return Object.fromEntries(columns.map((column, index) => [column, values2[index]]));
 }
@@ -702611,9 +702594,6 @@ var init_ingest = __esm(() => {
 // node_modules/@pellux/goodvibes-sdk/dist/platform/knowledge/browser-history/index.js
 var init_browser_history = __esm(() => {
   init_ingest();
-  init_discover();
-  init_readers();
-  init_paths2();
 });
 
 // node_modules/graphql/jsutils/devAssert.mjs
@@ -720253,7 +720233,6 @@ var init_semantic = __esm(() => {
   init_llm();
   init_gap_repair();
   init_service4();
-  init_self_improvement();
 });
 
 // node_modules/@pellux/goodvibes-sdk/dist/platform/knowledge/home-graph/helpers.js
@@ -724222,40 +724201,8 @@ var init_map_view = __esm(() => {
 });
 
 // node_modules/@pellux/goodvibes-sdk/dist/platform/knowledge/home-graph/types.js
-var HOME_GRAPH_NODE_KINDS, HOME_GRAPH_RELATIONS, HOME_GRAPH_CAPABILITIES;
+var HOME_GRAPH_CAPABILITIES;
 var init_types6 = __esm(() => {
-  HOME_GRAPH_NODE_KINDS = [
-    "ha_home",
-    "ha_entity",
-    "ha_device",
-    "ha_area",
-    "ha_automation",
-    "ha_script",
-    "ha_scene",
-    "ha_label",
-    "ha_integration",
-    "ha_room",
-    "ha_device_passport",
-    "ha_maintenance_item",
-    "ha_troubleshooting_case",
-    "ha_purchase",
-    "ha_network_node"
-  ];
-  HOME_GRAPH_RELATIONS = [
-    "controls",
-    "located_in",
-    "belongs_to_device",
-    "has_manual",
-    "has_receipt",
-    "has_warranty",
-    "has_issue",
-    "fixed_by",
-    "uses_battery",
-    "connected_via",
-    "part_of_network",
-    "mentioned_by",
-    "source_for"
-  ];
   HOME_GRAPH_CAPABILITIES = [
     "knowledge-space-isolation",
     "snapshot-sync",
@@ -725662,7 +725609,6 @@ var init_service5 = __esm(() => {
 var init_home_graph = __esm(() => {
   init_service5();
   init_extension();
-  init_types6();
 });
 
 // node_modules/@pellux/goodvibes-sdk/dist/platform/knowledge/store-refinement.js
@@ -727990,14 +727936,10 @@ var init_service6 = __esm(() => {
 var init_project_planning = __esm(() => {
   init_service6();
   init_helpers3();
-  init_readiness();
 });
 
 // node_modules/@pellux/goodvibes-sdk/dist/platform/knowledge/persistence.js
-var init_persistence = __esm(() => {
-  init_store_schema();
-  init_store_load();
-});
+var init_persistence = () => {};
 
 // node_modules/@pellux/goodvibes-sdk/dist/platform/knowledge/projections.js
 class KnowledgeProjectionService {
@@ -731505,21 +731447,21 @@ var init_service7 = __esm(() => {
 var exports_knowledge = {};
 __export(exports_knowledge, {
   withKnowledgeSpace: () => withKnowledgeSpace,
-  uniqKnowledgeValues: () => uniq2,
-  stabilizeKnowledgeText: () => stableText,
-  runKnowledgeSemanticSelfImprovement: () => runKnowledgeSemanticSelfImprovement,
+  uniqKnowledgeValues: () => uniq3,
+  stabilizeKnowledgeText: () => stableText2,
+  runKnowledgeSemanticSelfImprovement: () => runKnowledgeSemanticSelfImprovement2,
   resolveProjectPlanningSpace: () => resolveProjectPlanningSpace,
-  resolveKnowledgeDbPathFromControlPlaneDir: () => resolveKnowledgeDbPathFromControlPlaneDir,
+  resolveKnowledgeDbPathFromControlPlaneDir: () => resolveKnowledgeDbPathFromControlPlaneDir2,
   renderPacket: () => renderPacket,
   renderKnowledgeSchemaSql: () => renderKnowledgeSchemaSql,
   renderKnowledgeMap: () => renderKnowledgeMap,
   readKnowledgeSearchText: () => readKnowledgeSearchText,
-  readBrowserKnowledgeProfile: () => readBrowserKnowledgeProfile,
+  readBrowserKnowledgeProfile: () => readBrowserKnowledgeProfile2,
   projectPlanningSourceId: () => projectPlanningSourceId,
   projectPlanningProjectIdFromPath: () => projectPlanningProjectIdFromPath,
   projectPlanningCanonicalUri: () => projectPlanningCanonicalUri,
   projectKnowledgeSpaceId: () => projectKnowledgeSpaceId,
-  parseKnowledgeJsonValue: () => parseJsonValue,
+  parseKnowledgeJsonValue: () => parseJsonValue2,
   normalizeProjectId: () => normalizeProjectId,
   normalizeKnowledgeSpaceId: () => normalizeKnowledgeSpaceId,
   normalizeHomeAssistantInstallationId: () => normalizeHomeAssistantInstallationId,
@@ -731527,12 +731469,12 @@ __export(exports_knowledge, {
   materializeGeneratedKnowledgeProjection: () => materializeGeneratedKnowledgeProjection,
   looksLikeRawPdfPayload: () => looksLikeRawPdfPayload,
   looksBinaryLikeText: () => looksBinaryLikeText,
-  loadKnowledgeStoreSnapshot: () => loadKnowledgeStoreSnapshot,
+  loadKnowledgeStoreSnapshot: () => loadKnowledgeStoreSnapshot2,
   listGeneratedKnowledgePages: () => listGeneratedKnowledgePages,
-  listBrowserKinds: () => listBrowserKinds,
+  listBrowserKinds: () => listBrowserKinds2,
   knowledgeSpaceMetadata: () => knowledgeSpaceMetadata,
   knowledgePageSourceWeight: () => knowledgePageSourceWeight,
-  knowledgeNowMs: () => nowMs,
+  knowledgeNowMs: () => nowMs2,
   knowledgeExtractionNeedsRefresh: () => knowledgeExtractionNeedsRefresh,
   isUsefulKnowledgePageSourceCandidate: () => isUsefulKnowledgePageSourceCandidate,
   isUsefulKnowledgePageSource: () => isUsefulKnowledgePageSource,
@@ -731552,12 +731494,12 @@ __export(exports_knowledge, {
   generatedKnowledgeSourceId: () => generatedKnowledgeSourceId,
   generatedKnowledgeCanonicalUri: () => generatedKnowledgeCanonicalUri,
   extractKnowledgeArtifact: () => extractKnowledgeArtifact,
-  evaluateProjectPlanningReadiness: () => evaluateProjectPlanningReadiness,
-  discoverBrowserKnowledgeProfiles: () => discoverBrowserKnowledgeProfiles,
+  evaluateProjectPlanningReadiness: () => evaluateProjectPlanningReadiness2,
+  discoverBrowserKnowledgeProfiles: () => discoverBrowserKnowledgeProfiles2,
   createWebKnowledgeGapRepairer: () => createWebKnowledgeGapRepairer,
   createProviderBackedKnowledgeSemanticLlm: () => createProviderBackedKnowledgeSemanticLlm,
   createMemoryApi: () => createMemoryApi,
-  createKnowledgeSchema: () => createSchema2,
+  createKnowledgeSchema: () => createSchema3,
   createKnowledgeApi: () => createKnowledgeApi,
   createDefaultKnowledgeConnectorRegistry: () => createDefaultKnowledgeConnectorRegistry,
   compareKnowledgePageSources: () => compareKnowledgePageSources,
@@ -733995,7 +733937,7 @@ var init_delivery_manager = __esm(() => {
 });
 
 // node_modules/@pellux/goodvibes-sdk/dist/platform/automation/scheduler-capacity.js
-function computeSchedulerCapacity(slotsTotal, runs, nowMs2 = Date.now()) {
+function computeSchedulerCapacity(slotsTotal, runs, nowMs3 = Date.now()) {
   let slotsInUse = 0;
   const queuedRuns = [];
   for (const run7 of runs) {
@@ -734005,7 +733947,7 @@ function computeSchedulerCapacity(slotsTotal, runs, nowMs2 = Date.now()) {
       queuedRuns.push(run7);
   }
   const queueDepth = queuedRuns.length;
-  const oldestQueuedAgeMs = queueDepth > 0 ? nowMs2 - Math.min(...queuedRuns.map((r5) => r5.queuedAt)) : null;
+  const oldestQueuedAgeMs = queueDepth > 0 ? nowMs3 - Math.min(...queuedRuns.map((r5) => r5.queuedAt)) : null;
   return { slotsTotal, slotsInUse, queueDepth, oldestQueuedAgeMs };
 }
 
@@ -816566,7 +816508,7 @@ var createStyledCell = (char, overrides = {}) => ({
 // src/version.ts
 import { readFileSync } from "fs";
 import { join } from "path";
-var _version = "1.0.8";
+var _version = "1.0.9";
 var _sdkVersion = "0.33.35";
 try {
   const pkg = JSON.parse(readFileSync(join(import.meta.dir, "..", "package.json"), "utf-8"));
@@ -839428,7 +839370,7 @@ var WORK_PLAN_STATUSES = [
   "failed",
   "cancelled"
 ];
-function nowMs2() {
+function nowMs3() {
   return Date.now();
 }
 function isObject5(value) {
@@ -839534,7 +839476,7 @@ class WorkPlanStore {
     if (!normalizedTitle)
       throw new Error("Work plan item title is required.");
     const plan = this.readPlan();
-    const time4 = nowMs2();
+    const time4 = nowMs3();
     const item = {
       id: createItemId(),
       title: normalizedTitle,
@@ -839558,7 +839500,7 @@ class WorkPlanStore {
   updateItem(idOrPrefix, patch2) {
     const plan = this.readPlan();
     const item = this.resolveItem(plan, idOrPrefix);
-    const time4 = nowMs2();
+    const time4 = nowMs3();
     const nextStatus = patch2.status ?? item.status;
     const next = this.pruneItem({
       ...item,
@@ -839591,7 +839533,7 @@ class WorkPlanStore {
   removeItem(idOrPrefix) {
     const plan = this.readPlan();
     const item = this.resolveItem(plan, idOrPrefix);
-    const time4 = nowMs2();
+    const time4 = nowMs3();
     const remaining = plan.items.filter((candidate) => candidate.id !== item.id);
     this.writePlan({
       ...plan,
@@ -839611,7 +839553,7 @@ class WorkPlanStore {
       ...plan,
       items: remaining,
       activeItemId: remaining[0]?.id,
-      updatedAt: nowMs2()
+      updatedAt: nowMs3()
     });
     return removed;
   }
@@ -839650,7 +839592,7 @@ class WorkPlanStore {
     const parsed = JSON.parse(raw);
     if (!isObject5(parsed))
       return this.createEmptyPlan();
-    const time4 = nowMs2();
+    const time4 = nowMs3();
     const createdAt = typeof parsed.createdAt === "number" ? parsed.createdAt : time4;
     const updatedAt = typeof parsed.updatedAt === "number" ? parsed.updatedAt : createdAt;
     const items = Array.isArray(parsed.items) ? parsed.items.map((item) => normalizeItem(item, createdAt)).filter((item) => item !== null) : [];
@@ -839669,7 +839611,7 @@ class WorkPlanStore {
     };
   }
   createEmptyPlan() {
-    const time4 = nowMs2();
+    const time4 = nowMs3();
     return {
       id: createPlanId(this.options.projectId, this.options.projectRoot),
       projectId: this.options.projectId,
@@ -849256,6 +849198,136 @@ var knowledgeCommand = {
 };
 
 // src/input/commands/shell-core.ts
+function commandCategory(commandName) {
+  if ([
+    "agent",
+    "agent-profile",
+    "brief",
+    "health",
+    "welcome",
+    "setup",
+    "tasks",
+    "approval",
+    "automation",
+    "delegate",
+    "schedule",
+    "workplan",
+    "plan"
+  ].includes(commandName))
+    return "Agent Operator";
+  if ([
+    "knowledge",
+    "memory",
+    "notes",
+    "personas",
+    "skills",
+    "routines"
+  ].includes(commandName))
+    return "Knowledge & Local Context";
+  if ([
+    "channels",
+    "notify",
+    "qrcode",
+    "pair"
+  ].includes(commandName))
+    return "Channels";
+  if ([
+    "model",
+    "provider",
+    "providers",
+    "effort",
+    "pin",
+    "unpin",
+    "refresh-models",
+    "mode",
+    "tts",
+    "voice",
+    "media",
+    "image"
+  ].includes(commandName))
+    return "Model, Voice & Media";
+  if ([
+    "settings",
+    "config",
+    "keybindings",
+    "shortcuts",
+    "mcp",
+    "secrets",
+    "auth",
+    "accounts",
+    "subscription",
+    "compat",
+    "security",
+    "trust",
+    "bundle"
+  ].includes(commandName))
+    return "Setup & Security";
+  if ([
+    "save",
+    "load",
+    "sessions",
+    "session",
+    "conversation",
+    "export",
+    "title",
+    "clear",
+    "reset",
+    "compact",
+    "undo",
+    "redo",
+    "retry",
+    "expand",
+    "collapse",
+    "context",
+    "bookmarks",
+    "paste",
+    "next-error",
+    "prev-error"
+  ].includes(commandName))
+    return "Conversation";
+  return "Tools & System";
+}
+function commandDetail(command8) {
+  const parts2 = [command8.description];
+  if (command8.usage)
+    parts2.push(`usage: /${command8.name} ${command8.usage}`);
+  if (command8.aliases?.length)
+    parts2.push(`aliases: ${command8.aliases.map((alias) => `/${alias}`).join(", ")}`);
+  return parts2.join(" | ");
+}
+function listRegisteredCommandItems(registry5) {
+  return registry5.list().slice().sort((a4, b3) => a4.name.localeCompare(b3.name)).map((command8) => ({
+    id: `/${command8.name}`,
+    label: `/${command8.name}`,
+    detail: commandDetail(command8),
+    category: commandCategory(command8.name),
+    primaryAction: "select",
+    actions: "[Enter] run command"
+  }));
+}
+function registeredCommandListText(registry5) {
+  const commands3 = listRegisteredCommandItems(registry5);
+  return [
+    "Open the Agent workspace first, then press / inside it to search every product action.",
+    "",
+    "Registered slash commands:",
+    ...commands3.map((item) => `  ${item.label} - ${item.detail}`)
+  ].join(`
+`);
+}
+function openRegisteredCommandSelection(registry5, ctx) {
+  ctx.openSelection?.("Help  -  Commands", listRegisteredCommandItems(registry5), { allowSearch: true }, (result2) => {
+    if (!result2)
+      return;
+    const command8 = result2.item.id;
+    if (command8.startsWith("/")) {
+      const parts2 = command8.slice(1).trim().split(/\s+/);
+      const name51 = parts2[0];
+      const cmdArgs = parts2.slice(1);
+      ctx.executeCommand?.(name51, cmdArgs) ?? registry5.execute(name51, cmdArgs, ctx);
+    }
+  });
+}
 function registerShellCoreCommands(registry5) {
   registry5.register({
     name: "model",
@@ -849305,6 +849377,10 @@ function registerShellCoreCommands(registry5) {
     aliases: ["cmds"],
     description: "Browse all commands in a scrollable list",
     handler(_args, ctx) {
+      if (ctx.openSelection) {
+        openRegisteredCommandSelection(registry5, ctx);
+        return;
+      }
       if (ctx.openHelpOverlay) {
         ctx.openHelpOverlay();
         return;
@@ -849369,75 +849445,10 @@ function registerShellCoreCommands(registry5) {
     argsHint: "[command]",
     handler(_args, ctx) {
       if (ctx.openSelection) {
-        const items = [
-          { id: "/agent", label: "/agent", detail: "Open the Agent operator workspace; press / inside it to search every action", category: "Agent Operator" },
-          { id: "/agent setup", label: "/agent setup", detail: "Open the Agent setup workspace; workspace search can find every setup action", category: "Agent Operator" },
-          { id: "/agent channels", label: "/agent channels", detail: "Open channel readiness and delivery safety", category: "Agent Operator" },
-          { id: "/agent knowledge", label: "/agent knowledge", detail: "Open isolated Agent Knowledge workflows", category: "Agent Operator" },
-          { id: "/agent voice-media", label: "/agent voice-media", detail: "Open voice, TTS, image, browser, and media setup", category: "Agent Operator" },
-          { id: "/home", label: "/home", detail: "Alias for the Agent operator workspace", category: "Agent Operator" },
-          { id: "/brief", label: "/brief", detail: "Show a concise Agent operator briefing and next actions", category: "Agent Operator" },
-          { id: "/knowledge", label: "/knowledge", detail: "Inspect isolated Agent Knowledge status, ask/search, and ingest flows", category: "Agent Operator" },
-          { id: "/memory", label: "/memory", detail: "Review Agent-local memory records", category: "Agent Operator" },
-          { id: "/notes", label: "/notes", detail: "Open Agent-local scratchpad notes for source triage and temporary context", category: "Agent Operator" },
-          { id: "/personas", label: "/personas", detail: "Create, review, and activate Agent-local personas", category: "Agent Operator" },
-          { id: "/skills", label: "/skills", detail: "Create, review, and enable reusable Agent skills", category: "Agent Operator" },
-          { id: "/routines", label: "/routines", detail: "Create, review, start, and promote Agent routines explicitly", category: "Agent Operator" },
-          { id: "/automation", label: "/automation", detail: "Run confirmed connected-host automation actions", category: "Agent Operator" },
-          { id: "/delegate", label: "/delegate [task]", detail: "Explicit build/fix/review handoff to GoodVibes TUI", category: "Agent Operator" },
-          { id: "/channels", label: "/channels", detail: "Inspect messaging-channel readiness without sending messages", category: "Agent Operator" },
-          { id: "/pair", label: "/pair", detail: "Pair companion clients through connected GoodVibes host", category: "Agent Operator" },
-          { id: "/model", label: "/model [id]", detail: "Select LLM model", category: "Model & Provider" },
-          { id: "/provider", label: "/provider [name]", detail: "Switch provider", category: "Model & Provider" },
-          { id: "/effort", label: "/effort [level]", detail: "Reasoning effort (instant/low/medium/high)", category: "Model & Provider" },
-          { id: "/config", label: "/config [category|key]", detail: "Open fullscreen configuration workspace", category: "Config & Display" },
-          { id: "/expand", label: "/expand [type]", detail: "Expand blocks (all|thinking|tool|code)", category: "Config & Display" },
-          { id: "/collapse", label: "/collapse [type]", detail: "Collapse blocks", category: "Config & Display" },
-          { id: "/bookmarks", label: "/bookmarks", detail: "List bookmarked blocks", category: "Config & Display" },
-          { id: "/clear", label: "/clear", detail: "Clear display (keep context)", category: "Conversation" },
-          { id: "/reset", label: "/reset", detail: "Clear display + context", category: "Conversation" },
-          { id: "/compact", label: "/compact", detail: "Summarize to free context", category: "Conversation" },
-          { id: "/export", label: "/export [file] --yes", detail: "Export as markdown", category: "Conversation" },
-          { id: "/title", label: "/title [text]", detail: "Show or set title", category: "Conversation" },
-          { id: "/save", label: "/save [name]", detail: "Save session", category: "Conversation" },
-          { id: "/load", label: "/load <name>", detail: "Load session", category: "Conversation" },
-          { id: "/sessions", label: "/sessions", detail: "List saved sessions", category: "Conversation" },
-          { id: "/session", label: "/session", detail: "Current session info", category: "Conversation" },
-          { id: "/session list", label: "/session list", detail: "List all sessions", category: "Conversation" },
-          { id: "/session rename", label: "/session rename <name>", detail: "Rename current session", category: "Conversation" },
-          { id: "/session resume", label: "/session resume <id>", detail: "Load and resume a session", category: "Conversation" },
-          { id: "/session fork", label: "/session fork [name]", detail: "Fork current session to new ID", category: "Conversation" },
-          { id: "/session save", label: "/session save [name]", detail: "Force-save current session", category: "Conversation" },
-          { id: "/session info", label: "/session info [id]", detail: "Show session details", category: "Conversation" },
-          { id: "/session export", label: "/session export <id> [format]", detail: "Export session as markdown/text", category: "Conversation" },
-          { id: "/session search", label: "/session search <query>", detail: "Search across all sessions", category: "Conversation" },
-          { id: "/session delete", label: "/session delete <id> --yes", detail: "Delete a session", category: "Conversation" },
-          { id: "/undo", label: "/undo", detail: "Remove last turn", category: "Conversation" },
-          { id: "/redo", label: "/redo", detail: "Restore undone turn", category: "Conversation" },
-          { id: "/retry", label: "/retry [text]", detail: "Re-send last message", category: "Conversation" },
-          { id: "/paste", label: "/paste", detail: "Insert clipboard text or image into the prompt", category: "Tools & System" },
-          { id: "/shortcuts", label: "/shortcuts", detail: "View keyboard shortcuts reference", category: "Tools & System" },
-          { id: "/commands", label: "/commands", detail: "Browse all commands in a scrollable list", category: "Tools & System" },
-          { id: "/compat", label: "/compat", detail: "Inspect connected-host and Agent Knowledge compatibility", category: "Tools & System" },
-          { id: "/secrets", label: "/secrets set|link|get|test|list|delete", detail: "Manage encrypted and provider-backed secrets", category: "Tools & System" },
-          { id: "/bundle", label: "/bundle export|inspect|import", detail: "Manage redacted Agent support bundles", category: "Tools & System" },
-          { id: "/help", label: "/help", detail: "This help", category: "Tools & System" },
-          { id: "/quit", label: "/quit", detail: "Exit", category: "Tools & System" }
-        ];
-        ctx.openSelection("Help  \u2014  Commands", items, { allowSearch: true }, (result2) => {
-          if (!result2)
-            return;
-          const command8 = result2.item.id;
-          if (command8.startsWith("/")) {
-            const parts2 = command8.slice(1).trim().split(/\s+/);
-            const name51 = parts2[0];
-            const cmdArgs = parts2.slice(1);
-            ctx.executeCommand?.(name51, cmdArgs) ?? registry5.execute(name51, cmdArgs, ctx);
-          }
-        });
+        openRegisteredCommandSelection(registry5, ctx);
         return;
       }
-      ctx.print("Open the Agent workspace first, then press / inside it to search every product action. Slash commands remain available: /agent, /brief, /knowledge, /memory, /notes, /personas, /skills, /routines, /channels, /approval, /automation, /schedule, /delegate, /model, /provider, /config, /compat, /bundle, /paste, /sessions, /bookmarks, /save, /load, /undo, /redo, /retry, /clear, /reset, /compact, /export, /title, /effort, /expand, /collapse, /quit");
+      ctx.print(registeredCommandListText(registry5));
     }
   });
   registry5.register({
@@ -880725,6 +880736,101 @@ var AGENT_HARNESS_PARAMETER_PROPERTIES = {
   }
 };
 
+// src/input/tts-settings-actions.ts
+function getStreamingTtsProviders(ctx) {
+  const registry5 = ctx.platform.voiceProviderRegistry;
+  if (!registry5)
+    return [];
+  return registry5.list().filter((provider5) => provider5.capabilities.includes("tts-stream"));
+}
+function setTtsConfigValue(ctx, key, value) {
+  ctx.platform.configManager.setDynamic(key, value);
+}
+function openTtsProviderPicker(ctx) {
+  if (!ctx.openSelection)
+    return false;
+  const registry5 = ctx.platform.voiceProviderRegistry;
+  if (!registry5) {
+    ctx.print("Voice provider registry is not available in this runtime.");
+    return true;
+  }
+  const providers2 = getStreamingTtsProviders(ctx);
+  if (providers2.length === 0) {
+    ctx.print("No streaming TTS providers are registered.");
+    return true;
+  }
+  const current = String(ctx.platform.configManager.get("tts.provider") ?? "").trim();
+  const items = providers2.map((provider5) => ({
+    id: provider5.id,
+    label: provider5.label,
+    detail: provider5.id === current ? `${provider5.id}  (current)` : provider5.id,
+    category: "streaming TTS providers",
+    primaryAction: "select",
+    actions: "[Enter] set provider"
+  }));
+  ctx.openSelection("Choose TTS Provider", items, { preSelectId: current, allowSearch: true }, (result2) => {
+    if (!result2)
+      return;
+    const previous = String(ctx.platform.configManager.get("tts.provider") ?? "").trim();
+    setTtsConfigValue(ctx, "tts.provider", result2.item.id);
+    if (previous && previous !== result2.item.id) {
+      setTtsConfigValue(ctx, "tts.voice", "");
+      ctx.print(`TTS provider set to ${result2.item.id}. TTS voice was cleared because voices are provider-specific.`);
+    } else {
+      ctx.print(`TTS provider set to ${result2.item.id}.`);
+    }
+    ctx.renderRequest();
+  });
+  return true;
+}
+async function openTtsVoicePicker(ctx, providerArg) {
+  if (!ctx.openSelection)
+    return false;
+  const service = ctx.platform.voiceService;
+  if (!service) {
+    ctx.print("Voice service is not available in this runtime.");
+    return true;
+  }
+  const providerId = (providerArg ?? String(ctx.platform.configManager.get("tts.provider") ?? "")).trim() || undefined;
+  try {
+    const voices = await service.listVoices(providerId);
+    if (voices.length === 0) {
+      ctx.print(providerId ? `No voices returned for ${providerId}.` : "No TTS voices returned.");
+      return true;
+    }
+    const current = String(ctx.platform.configManager.get("tts.voice") ?? "").trim();
+    const items = [
+      {
+        id: "__default__",
+        label: "Use provider default voice",
+        detail: current ? "clears tts.voice" : "(current)",
+        category: "voice",
+        primaryAction: "select"
+      },
+      ...voices.map((voice) => ({
+        id: voice.id,
+        label: voice.label || voice.id,
+        detail: voice.id === current ? `${voice.id}  (current)` : voice.id,
+        category: providerId ?? "voices",
+        primaryAction: "select",
+        actions: "[Enter] set voice"
+      }))
+    ];
+    ctx.openSelection(`Choose TTS Voice${providerId ? ` (${providerId})` : ""}`, items, { preSelectId: current || "__default__", allowSearch: true }, (result2) => {
+      if (!result2)
+        return;
+      const nextVoice = result2.item.id === "__default__" ? "" : result2.item.id;
+      setTtsConfigValue(ctx, "tts.voice", nextVoice);
+      ctx.print(nextVoice ? `TTS voice set to ${nextVoice}.` : "TTS voice cleared. The provider default voice will be used.");
+      ctx.renderRequest();
+    });
+    return true;
+  } catch (error52) {
+    ctx.print(`Unable to list TTS voices: ${error52 instanceof Error ? error52.message : String(error52)}`);
+    return true;
+  }
+}
+
 // src/tools/agent-harness-ui-surface-metadata.ts
 function readString56(value) {
   return typeof value === "string" ? value.trim() : "";
@@ -880765,6 +880871,9 @@ function workspaceCategory(args2) {
 function settingsTarget(args2) {
   return readString56(args2.target || args2.key || args2.prefix) || undefined;
 }
+function providerTarget(args2) {
+  return readString56(args2.target || args2.key || args2.prefix) || undefined;
+}
 function optionalPane(args2) {
   const pane = readString56(args2.pane);
   return pane === "top" || pane === "bottom" ? pane : undefined;
@@ -880964,6 +881073,40 @@ var UI_SURFACES = [
       return opened(surface, { target: "main" });
     }
   },
+  {
+    id: "tts-provider-picker",
+    label: "TTS Provider Picker",
+    kind: "picker",
+    summary: "Interactive streaming TTS provider picker opened from the Agent settings flow.",
+    command: "/config tts.provider",
+    preferredModelRoute: "Use settings/get_setting/set_setting for tts.provider when a concrete provider id is known; use open_ui_surface only to visibly navigate.",
+    available: (context) => typeof context.openSelection === "function" && Boolean(context.platform.voiceProviderRegistry),
+    open: (context) => {
+      const surface = findSurfaceById("tts-provider-picker");
+      if (!context.openSelection || !context.platform.voiceProviderRegistry)
+        return routeUnavailable(surface);
+      const handled = openTtsProviderPicker(context);
+      return handled ? opened(surface, { target: "tts.provider" }) : routeUnavailable(surface);
+    }
+  },
+  {
+    id: "tts-voice-picker",
+    label: "TTS Voice Picker",
+    kind: "picker",
+    summary: "Interactive TTS voice picker opened from the Agent settings flow for the selected or supplied provider.",
+    command: "/config tts.voice",
+    preferredModelRoute: "Use settings/get_setting/set_setting/reset_setting for tts.voice when a concrete voice id is known; use open_ui_surface only to visibly navigate.",
+    parameters: ["target"],
+    available: (context) => typeof context.openSelection === "function" && Boolean(context.platform.voiceService),
+    open: async (context, args2) => {
+      const surface = findSurfaceById("tts-voice-picker");
+      if (!context.openSelection || !context.platform.voiceService)
+        return routeUnavailable(surface);
+      const providerId = providerTarget(args2);
+      const handled = await openTtsVoicePicker(context, providerId);
+      return handled ? opened(surface, { target: "tts.voice", providerId: providerId ?? "configured-default" }) : routeUnavailable(surface);
+    }
+  },
   {
     id: "session-picker",
     label: "Session Picker",
@@ -881127,7 +881270,7 @@ function describeHarnessUiSurface(context, args2) {
   const surface = UI_SURFACES.find((entry) => entry.id === surfaceId || entry.label.toLowerCase() === surfaceId.toLowerCase());
   return surface ? describeSurface(context, surface) : null;
 }
-function openHarnessUiSurface(context, args2) {
+async function openHarnessUiSurface(context, args2) {
   const surfaceId = readString56(args2.surfaceId || args2.query);
   const surface = UI_SURFACES.find((entry) => entry.id === surfaceId || entry.label.toLowerCase() === surfaceId.toLowerCase());
   if (!surface) {
@@ -881137,8 +881280,9 @@ function openHarnessUiSurface(context, args2) {
       availableSurfaces: UI_SURFACES.map((entry) => entry.id)
     };
   }
+  const routed = await surface.open(context, args2);
   return {
-    ...surface.open(context, args2),
+    ...routed,
     descriptor: describeSurface(context, surface)
   };
 }
@@ -881621,7 +881765,7 @@ function createAgentHarnessTool(deps) {
           const confirmationError2 = requireConfirmedAction(args2, "UI surface routing");
           if (confirmationError2)
             return error52(confirmationError2);
-          return output7(openHarnessUiSurface(deps.commandContext, args2));
+          return output7(await openHarnessUiSurface(deps.commandContext, args2));
         }
         if (args2.mode === "shortcuts")
           return output7(listHarnessShortcuts(deps.commandContext, args2));
@@ -883322,7 +883466,7 @@ var invokeContractRoute2 = exports_transport.invokeContractRoute;
 var openContractRouteStream2 = exports_transport.openContractRouteStream;
 var requireContractRoute2 = exports_transport.requireContractRoute;
 var isAbortError6 = exports_transport.isAbortError;
-var openServerSentEventStream3 = exports_transport.openServerSentEventStream;
+var openServerSentEventStream2 = exports_transport.openServerSentEventStream;
 var createOperatorRemoteClient2 = exports_transport.createOperatorRemoteClient;
 var createPeerRemoteClient2 = exports_transport.createPeerRemoteClient;
 var buildEventSourceUrl2 = exports_transport.buildEventSourceUrl;
@@ -893496,101 +893640,6 @@ function handleOnboardingWizardToken(state4, token) {
   return true;
 }
 
-// src/input/tts-settings-actions.ts
-function getStreamingTtsProviders(ctx) {
-  const registry5 = ctx.platform.voiceProviderRegistry;
-  if (!registry5)
-    return [];
-  return registry5.list().filter((provider5) => provider5.capabilities.includes("tts-stream"));
-}
-function setTtsConfigValue(ctx, key, value) {
-  ctx.platform.configManager.setDynamic(key, value);
-}
-function openTtsProviderPicker(ctx) {
-  if (!ctx.openSelection)
-    return false;
-  const registry5 = ctx.platform.voiceProviderRegistry;
-  if (!registry5) {
-    ctx.print("Voice provider registry is not available in this runtime.");
-    return true;
-  }
-  const providers2 = getStreamingTtsProviders(ctx);
-  if (providers2.length === 0) {
-    ctx.print("No streaming TTS providers are registered.");
-    return true;
-  }
-  const current = String(ctx.platform.configManager.get("tts.provider") ?? "").trim();
-  const items = providers2.map((provider5) => ({
-    id: provider5.id,
-    label: provider5.label,
-    detail: provider5.id === current ? `${provider5.id}  (current)` : provider5.id,
-    category: "streaming TTS providers",
-    primaryAction: "select",
-    actions: "[Enter] set provider"
-  }));
-  ctx.openSelection("Choose TTS Provider", items, { preSelectId: current, allowSearch: true }, (result2) => {
-    if (!result2)
-      return;
-    const previous = String(ctx.platform.configManager.get("tts.provider") ?? "").trim();
-    setTtsConfigValue(ctx, "tts.provider", result2.item.id);
-    if (previous && previous !== result2.item.id) {
-      setTtsConfigValue(ctx, "tts.voice", "");
-      ctx.print(`TTS provider set to ${result2.item.id}. TTS voice was cleared because voices are provider-specific.`);
-    } else {
-      ctx.print(`TTS provider set to ${result2.item.id}.`);
-    }
-    ctx.renderRequest();
-  });
-  return true;
-}
-async function openTtsVoicePicker(ctx, providerArg) {
-  if (!ctx.openSelection)
-    return false;
-  const service = ctx.platform.voiceService;
-  if (!service) {
-    ctx.print("Voice service is not available in this runtime.");
-    return true;
-  }
-  const providerId = (providerArg ?? String(ctx.platform.configManager.get("tts.provider") ?? "")).trim() || undefined;
-  try {
-    const voices = await service.listVoices(providerId);
-    if (voices.length === 0) {
-      ctx.print(providerId ? `No voices returned for ${providerId}.` : "No TTS voices returned.");
-      return true;
-    }
-    const current = String(ctx.platform.configManager.get("tts.voice") ?? "").trim();
-    const items = [
-      {
-        id: "__default__",
-        label: "Use provider default voice",
-        detail: current ? "clears tts.voice" : "(current)",
-        category: "voice",
-        primaryAction: "select"
-      },
-      ...voices.map((voice) => ({
-        id: voice.id,
-        label: voice.label || voice.id,
-        detail: voice.id === current ? `${voice.id}  (current)` : voice.id,
-        category: providerId ?? "voices",
-        primaryAction: "select",
-        actions: "[Enter] set voice"
-      }))
-    ];
-    ctx.openSelection(`Choose TTS Voice${providerId ? ` (${providerId})` : ""}`, items, { preSelectId: current || "__default__", allowSearch: true }, (result2) => {
-      if (!result2)
-        return;
-      const nextVoice = result2.item.id === "__default__" ? "" : result2.item.id;
-      setTtsConfigValue(ctx, "tts.voice", nextVoice);
-      ctx.print(nextVoice ? `TTS voice set to ${nextVoice}.` : "TTS voice cleared. The provider default voice will be used.");
-      ctx.renderRequest();
-    });
-    return true;
-  } catch (error53) {
-    ctx.print(`Unable to list TTS voices: ${error53 instanceof Error ? error53.message : String(error53)}`);
-    return true;
-  }
-}
-
 // src/input/handler-modal-routes.ts
 function handleSelectionModalToken(state4, token) {
   if (!state4.selectionModal.active)

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, bookmarks, model/provider 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, context, 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, session/profile pickers, the panel-picker compatibility route, security/knowledge/subscription operator surfaces, bookmarks, context inspector, 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, bookmarks, context inspector, 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/docs/voice-and-live-tts.md

@@ -20,7 +20,7 @@ GoodVibes Agent supports spoken turns as an Agent TUI feature. Text output remai
 
 `/config tts` opens the fullscreen configuration workspace for streaming provider, voice, and spoken-turn model routing.
 
-The model can inspect the same settings through `agent_harness` settings modes and can change Agent-owned TTS settings with explicit confirmation. Connected-host listener or lifecycle settings remain outside Agent ownership.
+The model can inspect the same settings through `agent_harness` settings modes, open the visible TTS provider or voice picker through `open_ui_surface`, and change Agent-owned TTS settings with explicit confirmation. Connected-host listener or lifecycle settings remain outside Agent ownership.
 
 ## Playback Requirements
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pellux/goodvibes-agent",
-  "version": "1.0.8",
+  "version": "1.0.9",
   "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/commands/shell-core.ts

@@ -1,4 +1,4 @@
-import type { CommandRegistry } from '../command-registry.ts';
+import type { CommandContext, CommandRegistry, SlashCommand } from '../command-registry.ts';
 import type { SelectionItem } from '../selection-modal.ts';
 import { EFFORT_DESCRIPTIONS } from '@pellux/goodvibes-sdk/platform/providers';
 import { REASONING_BUDGET_MAP } from '@pellux/goodvibes-sdk/platform/providers';
@@ -6,6 +6,134 @@ import { compactConversation, requireKeybindingsManager, requireProviderApi } fr
 import { summarizeError } from '@pellux/goodvibes-sdk/platform/utils';
 import { logger } from '@pellux/goodvibes-sdk/platform/utils';
 
+function commandCategory(commandName: string): string {
+  if ([
+    'agent',
+    'agent-profile',
+    'brief',
+    'health',
+    'welcome',
+    'setup',
+    'tasks',
+    'approval',
+    'automation',
+    'delegate',
+    'schedule',
+    'workplan',
+    'plan',
+  ].includes(commandName)) return 'Agent Operator';
+  if ([
+    'knowledge',
+    'memory',
+    'notes',
+    'personas',
+    'skills',
+    'routines',
+  ].includes(commandName)) return 'Knowledge & Local Context';
+  if ([
+    'channels',
+    'notify',
+    'qrcode',
+    'pair',
+  ].includes(commandName)) return 'Channels';
+  if ([
+    'model',
+    'provider',
+    'providers',
+    'effort',
+    'pin',
+    'unpin',
+    'refresh-models',
+    'mode',
+    'tts',
+    'voice',
+    'media',
+    'image',
+  ].includes(commandName)) return 'Model, Voice & Media';
+  if ([
+    'settings',
+    'config',
+    'keybindings',
+    'shortcuts',
+    'mcp',
+    'secrets',
+    'auth',
+    'accounts',
+    'subscription',
+    'compat',
+    'security',
+    'trust',
+    'bundle',
+  ].includes(commandName)) return 'Setup & Security';
+  if ([
+    'save',
+    'load',
+    'sessions',
+    'session',
+    'conversation',
+    'export',
+    'title',
+    'clear',
+    'reset',
+    'compact',
+    'undo',
+    'redo',
+    'retry',
+    'expand',
+    'collapse',
+    'context',
+    'bookmarks',
+    'paste',
+    'next-error',
+    'prev-error',
+  ].includes(commandName)) return 'Conversation';
+  return 'Tools & System';
+}
+
+function commandDetail(command: SlashCommand): string {
+  const parts = [command.description];
+  if (command.usage) parts.push(`usage: /${command.name} ${command.usage}`);
+  if (command.aliases?.length) parts.push(`aliases: ${command.aliases.map((alias) => `/${alias}`).join(', ')}`);
+  return parts.join(' | ');
+}
+
+function listRegisteredCommandItems(registry: CommandRegistry): SelectionItem[] {
+  return registry.list()
+    .slice()
+    .sort((a, b) => a.name.localeCompare(b.name))
+    .map((command) => ({
+      id: `/${command.name}`,
+      label: `/${command.name}`,
+      detail: commandDetail(command),
+      category: commandCategory(command.name),
+      primaryAction: 'select',
+      actions: '[Enter] run command',
+    }));
+}
+
+function registeredCommandListText(registry: CommandRegistry): string {
+  const commands = listRegisteredCommandItems(registry);
+  return [
+    'Open the Agent workspace first, then press / inside it to search every product action.',
+    '',
+    'Registered slash commands:',
+    ...commands.map((item) => `  ${item.label} - ${item.detail}`),
+  ].join('\n');
+}
+
+function openRegisteredCommandSelection(registry: CommandRegistry, ctx: CommandContext): void {
+  ctx.openSelection?.('Help  -  Commands', listRegisteredCommandItems(registry), { allowSearch: true }, (result) => {
+    if (!result) return;
+    const command = result.item.id;
+    if (command.startsWith('/')) {
+      const parts = command.slice(1).trim().split(/\s+/);
+      const name = parts[0];
+      const cmdArgs = parts.slice(1);
+      void (ctx.executeCommand?.(name, cmdArgs) ?? registry.execute(name, cmdArgs, ctx));
+    }
+  });
+}
+
 export function registerShellCoreCommands(registry: CommandRegistry): void {
   registry.register({
     name: 'model',
@@ -53,6 +181,10 @@ export function registerShellCoreCommands(registry: CommandRegistry): void {
     aliases: ['cmds'],
     description: 'Browse all commands in a scrollable list',
     handler(_args, ctx) {
+      if (ctx.openSelection) {
+        openRegisteredCommandSelection(registry, ctx);
+        return;
+      }
       if (ctx.openHelpOverlay) {
         ctx.openHelpOverlay();
         return;
@@ -120,74 +252,10 @@ export function registerShellCoreCommands(registry: CommandRegistry): void {
     argsHint: '[command]',
     handler(_args, ctx) {
       if (ctx.openSelection) {
-        const items: SelectionItem[] = [
-          { id: '/agent', label: '/agent', detail: 'Open the Agent operator workspace; press / inside it to search every action', category: 'Agent Operator' },
-          { id: '/agent setup', label: '/agent setup', detail: 'Open the Agent setup workspace; workspace search can find every setup action', category: 'Agent Operator' },
-          { id: '/agent channels', label: '/agent channels', detail: 'Open channel readiness and delivery safety', category: 'Agent Operator' },
-          { id: '/agent knowledge', label: '/agent knowledge', detail: 'Open isolated Agent Knowledge workflows', category: 'Agent Operator' },
-          { id: '/agent voice-media', label: '/agent voice-media', detail: 'Open voice, TTS, image, browser, and media setup', category: 'Agent Operator' },
-          { id: '/home', label: '/home', detail: 'Alias for the Agent operator workspace', category: 'Agent Operator' },
-          { id: '/brief', label: '/brief', detail: 'Show a concise Agent operator briefing and next actions', category: 'Agent Operator' },
-          { id: '/knowledge', label: '/knowledge', detail: 'Inspect isolated Agent Knowledge status, ask/search, and ingest flows', category: 'Agent Operator' },
-          { id: '/memory', label: '/memory', detail: 'Review Agent-local memory records', category: 'Agent Operator' },
-          { id: '/notes', label: '/notes', detail: 'Open Agent-local scratchpad notes for source triage and temporary context', category: 'Agent Operator' },
-          { id: '/personas', label: '/personas', detail: 'Create, review, and activate Agent-local personas', category: 'Agent Operator' },
-          { id: '/skills', label: '/skills', detail: 'Create, review, and enable reusable Agent skills', category: 'Agent Operator' },
-          { id: '/routines', label: '/routines', detail: 'Create, review, start, and promote Agent routines explicitly', category: 'Agent Operator' },
-          { id: '/automation', label: '/automation', detail: 'Run confirmed connected-host automation actions', category: 'Agent Operator' },
-          { id: '/delegate', label: '/delegate [task]', detail: 'Explicit build/fix/review handoff to GoodVibes TUI', category: 'Agent Operator' },
-          { id: '/channels', label: '/channels', detail: 'Inspect messaging-channel readiness without sending messages', category: 'Agent Operator' },
-          { id: '/pair', label: '/pair', detail: 'Pair companion clients through connected GoodVibes host', category: 'Agent Operator' },
-          { id: '/model', label: '/model [id]', detail: 'Select LLM model', category: 'Model & Provider' },
-          { id: '/provider', label: '/provider [name]', detail: 'Switch provider', category: 'Model & Provider' },
-          { id: '/effort', label: '/effort [level]', detail: 'Reasoning effort (instant/low/medium/high)', category: 'Model & Provider' },
-          { id: '/config', label: '/config [category|key]', detail: 'Open fullscreen configuration workspace', category: 'Config & Display' },
-          { id: '/expand', label: '/expand [type]', detail: 'Expand blocks (all|thinking|tool|code)', category: 'Config & Display' },
-          { id: '/collapse', label: '/collapse [type]', detail: 'Collapse blocks', category: 'Config & Display' },
-          { id: '/bookmarks', label: '/bookmarks', detail: 'List bookmarked blocks', category: 'Config & Display' },
-          { id: '/clear', label: '/clear', detail: 'Clear display (keep context)', category: 'Conversation' },
-          { id: '/reset', label: '/reset', detail: 'Clear display + context', category: 'Conversation' },
-          { id: '/compact', label: '/compact', detail: 'Summarize to free context', category: 'Conversation' },
-          { id: '/export', label: '/export [file] --yes', detail: 'Export as markdown', category: 'Conversation' },
-          { id: '/title', label: '/title [text]', detail: 'Show or set title', category: 'Conversation' },
-          { id: '/save', label: '/save [name]', detail: 'Save session', category: 'Conversation' },
-          { id: '/load', label: '/load <name>', detail: 'Load session', category: 'Conversation' },
-          { id: '/sessions', label: '/sessions', detail: 'List saved sessions', category: 'Conversation' },
-          { id: '/session', label: '/session', detail: 'Current session info', category: 'Conversation' },
-          { id: '/session list', label: '/session list', detail: 'List all sessions', category: 'Conversation' },
-          { id: '/session rename', label: '/session rename <name>', detail: 'Rename current session', category: 'Conversation' },
-          { id: '/session resume', label: '/session resume <id>', detail: 'Load and resume a session', category: 'Conversation' },
-          { id: '/session fork', label: '/session fork [name]', detail: 'Fork current session to new ID', category: 'Conversation' },
-          { id: '/session save', label: '/session save [name]', detail: 'Force-save current session', category: 'Conversation' },
-          { id: '/session info', label: '/session info [id]', detail: 'Show session details', category: 'Conversation' },
-          { id: '/session export', label: '/session export <id> [format]', detail: 'Export session as markdown/text', category: 'Conversation' },
-          { id: '/session search', label: '/session search <query>', detail: 'Search across all sessions', category: 'Conversation' },
-          { id: '/session delete', label: '/session delete <id> --yes', detail: 'Delete a session', category: 'Conversation' },
-          { id: '/undo', label: '/undo', detail: 'Remove last turn', category: 'Conversation' },
-          { id: '/redo', label: '/redo', detail: 'Restore undone turn', category: 'Conversation' },
-          { id: '/retry', label: '/retry [text]', detail: 'Re-send last message', category: 'Conversation' },
-          { id: '/paste', label: '/paste', detail: 'Insert clipboard text or image into the prompt', category: 'Tools & System' },
-          { id: '/shortcuts', label: '/shortcuts', detail: 'View keyboard shortcuts reference', category: 'Tools & System' },
-          { id: '/commands', label: '/commands', detail: 'Browse all commands in a scrollable list', category: 'Tools & System' },
-          { id: '/compat', label: '/compat', detail: 'Inspect connected-host and Agent Knowledge compatibility', category: 'Tools & System' },
-          { id: '/secrets', label: '/secrets set|link|get|test|list|delete', detail: 'Manage encrypted and provider-backed secrets', category: 'Tools & System' },
-          { id: '/bundle', label: '/bundle export|inspect|import', detail: 'Manage redacted Agent support bundles', category: 'Tools & System' },
-          { id: '/help', label: '/help', detail: 'This help', category: 'Tools & System' },
-          { id: '/quit', label: '/quit', detail: 'Exit', category: 'Tools & System' },
-        ];
-        ctx.openSelection('Help  —  Commands', items, { allowSearch: true }, (result) => {
-          if (!result) return;
-          const command = result.item.id;
-          if (command.startsWith('/')) {
-            const parts = command.slice(1).trim().split(/\s+/);
-            const name = parts[0];
-            const cmdArgs = parts.slice(1);
-            void (ctx.executeCommand?.(name, cmdArgs) ?? registry.execute(name, cmdArgs, ctx));
-          }
-        });
+        openRegisteredCommandSelection(registry, ctx);
         return;
       }
-      ctx.print('Open the Agent workspace first, then press / inside it to search every product action. Slash commands remain available: /agent, /brief, /knowledge, /memory, /notes, /personas, /skills, /routines, /channels, /approval, /automation, /schedule, /delegate, /model, /provider, /config, /compat, /bundle, /paste, /sessions, /bookmarks, /save, /load, /undo, /redo, /retry, /clear, /reset, /compact, /export, /title, /effort, /expand, /collapse, /quit');
+      ctx.print(registeredCommandListText(registry));
     },
   });
 

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

@@ -592,7 +592,7 @@ export function createAgentHarnessTool(deps: AgentHarnessToolDeps): Tool {
         if (args.mode === 'open_ui_surface') {
           const confirmationError = requireConfirmedAction(args, 'UI surface routing');
           if (confirmationError) return error(confirmationError);
-          return output(openHarnessUiSurface(deps.commandContext, args));
+          return output(await openHarnessUiSurface(deps.commandContext, args));
         }
         if (args.mode === 'shortcuts') return output(listHarnessShortcuts(deps.commandContext, args));
         if (args.mode === 'keybindings') return output(listHarnessKeybindings(deps.commandContext, args));

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

@@ -1,4 +1,5 @@
 import type { CommandContext } from '../input/command-registry.ts';
+import { openTtsProviderPicker, openTtsVoicePicker } from '../input/tts-settings-actions.ts';
 
 type UiSurfaceKind = 'overlay' | 'modal' | 'workspace' | 'picker';
 
@@ -23,7 +24,7 @@ interface UiSurfaceDefinition {
   readonly preferredModelRoute: string;
   readonly parameters?: readonly string[];
   readonly available: (context: CommandContext) => boolean;
-  readonly open: (context: CommandContext, args: AgentHarnessUiSurfaceArgs) => Record<string, unknown>;
+  readonly open: (context: CommandContext, args: AgentHarnessUiSurfaceArgs) => Record<string, unknown> | Promise<Record<string, unknown>>;
 }
 
 function readString(value: unknown): string {
@@ -72,6 +73,10 @@ function settingsTarget(args: AgentHarnessUiSurfaceArgs): string | undefined {
   return readString(args.target || args.key || args.prefix) || undefined;
 }
 
+function providerTarget(args: AgentHarnessUiSurfaceArgs): string | undefined {
+  return readString(args.target || args.key || args.prefix) || undefined;
+}
+
 function optionalPane(args: AgentHarnessUiSurfaceArgs): 'top' | 'bottom' | undefined {
   const pane = readString(args.pane);
   return pane === 'top' || pane === 'bottom' ? pane : undefined;
@@ -294,6 +299,40 @@ const UI_SURFACES: readonly UiSurfaceDefinition[] = [
       return opened(surface, { target: 'main' });
     },
   },
+  {
+    id: 'tts-provider-picker',
+    label: 'TTS Provider Picker',
+    kind: 'picker',
+    summary: 'Interactive streaming TTS provider picker opened from the Agent settings flow.',
+    command: '/config tts.provider',
+    preferredModelRoute: 'Use settings/get_setting/set_setting for tts.provider when a concrete provider id is known; use open_ui_surface only to visibly navigate.',
+    available: (context) => typeof context.openSelection === 'function' && Boolean(context.platform.voiceProviderRegistry),
+    open: (context) => {
+      const surface = findSurfaceById('tts-provider-picker')!;
+      if (!context.openSelection || !context.platform.voiceProviderRegistry) return routeUnavailable(surface);
+      const handled = openTtsProviderPicker(context);
+      return handled ? opened(surface, { target: 'tts.provider' }) : routeUnavailable(surface);
+    },
+  },
+  {
+    id: 'tts-voice-picker',
+    label: 'TTS Voice Picker',
+    kind: 'picker',
+    summary: 'Interactive TTS voice picker opened from the Agent settings flow for the selected or supplied provider.',
+    command: '/config tts.voice',
+    preferredModelRoute: 'Use settings/get_setting/set_setting/reset_setting for tts.voice when a concrete voice id is known; use open_ui_surface only to visibly navigate.',
+    parameters: ['target'],
+    available: (context) => typeof context.openSelection === 'function' && Boolean(context.platform.voiceService),
+    open: async (context, args) => {
+      const surface = findSurfaceById('tts-voice-picker')!;
+      if (!context.openSelection || !context.platform.voiceService) return routeUnavailable(surface);
+      const providerId = providerTarget(args);
+      const handled = await openTtsVoicePicker(context, providerId);
+      return handled
+        ? opened(surface, { target: 'tts.voice', providerId: providerId ?? 'configured-default' })
+        : routeUnavailable(surface);
+    },
+  },
   {
     id: 'session-picker',
     label: 'Session Picker',
@@ -457,7 +496,7 @@ export function describeHarnessUiSurface(context: CommandContext, args: AgentHar
   return surface ? describeSurface(context, surface) : null;
 }
 
-export function openHarnessUiSurface(context: CommandContext, args: AgentHarnessUiSurfaceArgs): Record<string, unknown> {
+export async function openHarnessUiSurface(context: CommandContext, args: AgentHarnessUiSurfaceArgs): Promise<Record<string, unknown>> {
   const surfaceId = readString(args.surfaceId || args.query);
   const surface = UI_SURFACES.find((entry) => entry.id === surfaceId || entry.label.toLowerCase() === surfaceId.toLowerCase());
   if (!surface) {
@@ -467,8 +506,9 @@ export function openHarnessUiSurface(context: CommandContext, args: AgentHarness
       availableSurfaces: UI_SURFACES.map((entry) => entry.id),
     };
   }
+  const routed = await surface.open(context, args);
   return {
-    ...surface.open(context, args),
+    ...routed,
     descriptor: describeSurface(context, surface),
   };
 }

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