@pellux/goodvibes-agent 1.4.3 → 1.5.0

package/src/input/commands/experience-runtime.ts

@@ -1,5 +1,5 @@
-import { mkdirSync, readFileSync, writeFileSync } from 'node:fs';
-import { dirname, resolve } from 'node:path';
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { dirname } from 'node:path';
 import type { CommandRegistry } from '../command-registry.ts';
 import { requireShellPaths } from './runtime-services.ts';
 import { requireYesFlag, stripYesFlag } from './confirmation.ts';
@@ -26,6 +26,7 @@ export function registerExperienceRuntimeCommands(registry: CommandRegistry): vo
     name: 'approval',
     aliases: ['approvals'],
     description: 'Review action-specific approval classes and the specialized security UX matrix',
+    hidden: true,
     usage: '[matrix|review <kind>|approve <id> --yes|deny <id> --yes|cancel <id> --yes]',
     async handler(args, ctx) {
       const sub = (args[0] ?? 'matrix').toLowerCase();
@@ -74,6 +75,7 @@ export function registerExperienceRuntimeCommands(registry: CommandRegistry): vo
     description: 'Review voice posture and package portable voice interaction metadata',
     usage: '[review|enable --yes|disable --yes|bundle export <path> --yes|bundle inspect <path>]',
     handler(args, ctx) {
+      try {
       const parsed = stripYesFlag(args);
       const commandArgs = [...parsed.rest];
       const shellPaths = requireShellPaths(ctx);
@@ -126,12 +128,23 @@ export function registerExperienceRuntimeCommands(registry: CommandRegistry): vo
           return;
         }
         if (mode === 'inspect') {
-          const bundle = JSON.parse(readFileSync(targetPath, 'utf-8')) as VoiceBundle;
-          ctx.print(inspectVoiceBundle(bundle));
+          if (!existsSync(targetPath)) {
+            ctx.print(`File not found: ${targetPath}`);
+            return;
+          }
+          try {
+            const bundle = JSON.parse(readFileSync(targetPath, 'utf-8')) as VoiceBundle;
+            ctx.print(inspectVoiceBundle(bundle));
+          } catch {
+            ctx.print('could not read voice bundle');
+          }
           return;
         }
       }
       ctx.print('Usage: /voice [review|enable --yes|disable --yes|bundle export <path> --yes|bundle inspect <path>]');
+      } catch (error) {
+        ctx.print(`voice command failed: ${error instanceof Error ? error.message : String(error)}`);
+      }
     },
   });
 }

package/src/input/commands/guidance-runtime.ts

@@ -25,7 +25,7 @@ export function registerGuidanceRuntimeCommands(registry: CommandRegistry): void
           '  /knowledge          - inspect isolated Agent Knowledge status, ask/search, libraries, map, connectors, and ingest paths',
           '  /memory             - manage Agent-local memory',
           '  /personas           - manage Agent-local personas',
-          '  /skills       - manage reusable Agent-local skills',
+          '  /skills             - manage reusable Agent-local skills',
           '  /routines           - manage Agent-local routines',
           '  /delegate           - explicitly hand build/fix/review work to GoodVibes TUI',
         ].join('\n'));

package/src/input/commands/health-runtime.ts

@@ -3,7 +3,7 @@ import { evaluateSessionMaintenance, formatSessionMaintenanceLines } from '@/run
 import { estimateConversationTokens } from '@pellux/goodvibes-sdk/platform/core';
 import type { CommandContext, CommandRegistry } from '../command-registry.ts';
 import { buildSetupReviewSnapshot } from './local-setup-review.ts';
-import { buildProviderAccountSnapshot } from '../../panels/provider-account-snapshot.ts';
+import { buildProviderAccountSnapshot } from '../../runtime/provider-account-snapshot.ts';
 import { getSettingsControlPlaneSnapshot } from '@/runtime/index.ts';
 import { checkRecoveryFile, readLastSessionPointer } from '@/runtime/index.ts';
 import {
@@ -48,9 +48,11 @@ export function registerHealthRuntimeCommands(registry: CommandRegistry): void {
     name: 'health',
     aliases: ['doctor'],
     description: 'Health workspace for startup posture, connected host readiness, provider health, and Agent continuity',
+    hidden: true,
     usage: '[review|setup|host|provider|accounts|auth|settings|remote|mcp|continuity|maintenance|repair [domain]]',
     async handler(args, ctx) {
       const sub = (args[0] ?? 'review').toLowerCase();
+      try {
 
       if (sub === 'open' || sub === 'panel') {
         ctx.print('Open Agent Workspace -> Home -> Review health for the workspace view, or run /health review for the compact command output.');
@@ -371,6 +373,9 @@ export function registerHealthRuntimeCommands(registry: CommandRegistry): void {
         '  /health repair <domain>',
         '  /setup',
       ].join('\n'));
+      } catch (error) {
+        ctx.print(`Health command failed: ${error instanceof Error ? error.message : String(error)}`);
+      }
     },
   });
 }

package/src/input/commands/knowledge-format.ts

@@ -0,0 +1,73 @@
+import type { KnowledgeMapResult, KnowledgeService } from '@pellux/goodvibes-sdk/platform/knowledge';
+
+export type KnowledgeAskResult = Awaited<ReturnType<KnowledgeService['ask']>>;
+
+export function cleanInline(value: unknown): string {
+  return typeof value === 'string' ? value.replace(/\s+/g, ' ').trim() : '';
+}
+
+export function formatKnowledgeMap(result: KnowledgeMapResult): string {
+  return [
+    'Agent Knowledge map',
+    `  nodes: ${result.nodeCount}${result.totalNodeCount !== undefined && result.totalNodeCount !== result.nodeCount ? ` of ${result.totalNodeCount}` : ''}`,
+    `  edges: ${result.edgeCount}${result.totalEdgeCount !== undefined && result.totalEdgeCount !== result.edgeCount ? ` of ${result.totalEdgeCount}` : ''}`,
+    '  route /api/goodvibes-agent/knowledge/map',
+  ].join('\n');
+}
+
+export function nodeLabel(node: { readonly kind?: string; readonly title?: string; readonly summary?: string; readonly confidence?: number }): string {
+  const kind = cleanInline(node.kind) || 'node';
+  const title = cleanInline(node.title) || 'untitled';
+  const summary = cleanInline(node.summary);
+  const confidence = typeof node.confidence === 'number' ? `  confidence ${node.confidence}` : '';
+  return summary ? `[${kind}] ${title}${confidence} - ${summary}` : `[${kind}] ${title}${confidence}`;
+}
+
+export function sourceLabel(source: {
+  readonly id?: string;
+  readonly sourceType?: string;
+  readonly title?: string;
+  readonly canonicalUri?: string;
+  readonly sourceUri?: string;
+  readonly summary?: string;
+  readonly status?: string;
+}): string {
+  const title = cleanInline(source.title) || cleanInline(source.canonicalUri) || cleanInline(source.sourceUri) || cleanInline(source.id) || 'untitled';
+  const type = cleanInline(source.sourceType) || 'source';
+  const status = cleanInline(source.status);
+  const summary = cleanInline(source.summary);
+  const suffix = status ? `/${status}` : '';
+  return summary ? `[${type}${suffix}] ${title} - ${summary}` : `[${type}${suffix}] ${title}`;
+}
+
+export function renderKnowledgeAskResult(result: KnowledgeAskResult): string {
+  const answer = result.answer;
+  const lines = [
+    `[knowledge] ${result.query}`,
+    answer.text,
+    '',
+    `mode ${answer.mode}  confidence ${answer.confidence}  synthesized ${answer.synthesized ? 'yes' : 'no'}`,
+  ];
+
+  if (answer.sources.length > 0) {
+    lines.push('', 'Sources:');
+    for (const source of answer.sources) lines.push(`  - ${sourceLabel(source)}`);
+  }
+
+  if (answer.facts.length > 0) {
+    lines.push('', 'Facts:');
+    for (const fact of answer.facts) lines.push(`  - ${nodeLabel(fact)}`);
+  }
+
+  if (answer.linkedObjects.length > 0) {
+    lines.push('', 'Linked objects:');
+    for (const object of answer.linkedObjects) lines.push(`  - ${nodeLabel(object)}`);
+  }
+
+  if (answer.gaps.length > 0) {
+    lines.push('', 'Gaps:');
+    for (const gap of answer.gaps) lines.push(`  - ${nodeLabel(gap)}`);
+  }
+
+  return lines.join('\n');
+}

package/src/input/commands/knowledge.ts

@@ -1,13 +1,13 @@
-import type { KnowledgeMapResult, KnowledgeService } from '@pellux/goodvibes-sdk/platform/knowledge';
 import type { CommandContext, SlashCommand } from '../command-registry.ts';
 import { requireYesFlag, stripYesFlag } from './confirmation.ts';
 import { toBrowserKinds, toBrowserSourceKinds } from './knowledge-browser-flags.ts';
+import { formatKnowledgeMap, nodeLabel, renderKnowledgeAskResult, sourceLabel } from './knowledge-format.ts';
+import type { KnowledgeAskResult } from './knowledge-format.ts';
 
 const KNOWLEDGE_REVIEW_ACTIONS = ['accept', 'reject', 'resolve', 'reopen', 'edit', 'forget'] as const;
 
 type KnowledgeReviewAction = typeof KNOWLEDGE_REVIEW_ACTIONS[number];
-type KnowledgeAskInput = Parameters<KnowledgeService['ask']>[0];
-type KnowledgeAskResult = Awaited<ReturnType<KnowledgeService['ask']>>;
+type KnowledgeAskInput = Parameters<import('@pellux/goodvibes-sdk/platform/knowledge').KnowledgeService['ask']>[0];
 type KnowledgeAskMode = NonNullable<KnowledgeAskInput['mode']>;
 
 function isRecord(value: unknown): value is Record<string, unknown> {
@@ -126,82 +126,13 @@ function requireAgentKnowledgeAsk(context: CommandContext): ((input: KnowledgeAs
   return null;
 }
 
-function cleanInline(value: unknown): string {
-  return typeof value === 'string' ? value.replace(/\s+/g, ' ').trim() : '';
-}
-
-function formatKnowledgeMap(result: KnowledgeMapResult): string {
-  return [
-    'Agent Knowledge map',
-    `  nodes: ${result.nodeCount}${result.totalNodeCount !== undefined && result.totalNodeCount !== result.nodeCount ? ` of ${result.totalNodeCount}` : ''}`,
-    `  edges: ${result.edgeCount}${result.totalEdgeCount !== undefined && result.totalEdgeCount !== result.edgeCount ? ` of ${result.totalEdgeCount}` : ''}`,
-    '  route /api/goodvibes-agent/knowledge/map',
-  ].join('\n');
-}
-
-function nodeLabel(node: { readonly kind?: string; readonly title?: string; readonly summary?: string; readonly confidence?: number }): string {
-  const kind = cleanInline(node.kind) || 'node';
-  const title = cleanInline(node.title) || 'untitled';
-  const summary = cleanInline(node.summary);
-  const confidence = typeof node.confidence === 'number' ? `  confidence ${node.confidence}` : '';
-  return summary ? `[${kind}] ${title}${confidence} - ${summary}` : `[${kind}] ${title}${confidence}`;
-}
-
-function sourceLabel(source: {
-  readonly id?: string;
-  readonly sourceType?: string;
-  readonly title?: string;
-  readonly canonicalUri?: string;
-  readonly sourceUri?: string;
-  readonly summary?: string;
-  readonly status?: string;
-}): string {
-  const title = cleanInline(source.title) || cleanInline(source.canonicalUri) || cleanInline(source.sourceUri) || cleanInline(source.id) || 'untitled';
-  const type = cleanInline(source.sourceType) || 'source';
-  const status = cleanInline(source.status);
-  const summary = cleanInline(source.summary);
-  const suffix = status ? `/${status}` : '';
-  return summary ? `[${type}${suffix}] ${title} - ${summary}` : `[${type}${suffix}] ${title}`;
-}
-
-function renderKnowledgeAskResult(result: KnowledgeAskResult): string {
-  const answer = result.answer;
-  const lines = [
-    `[knowledge] ${result.query}`,
-    answer.text,
-    '',
-    `mode ${answer.mode}  confidence ${answer.confidence}  synthesized ${answer.synthesized ? 'yes' : 'no'}`,
-  ];
-
-  if (answer.sources.length > 0) {
-    lines.push('', 'Sources:');
-    for (const source of answer.sources) lines.push(`  - ${sourceLabel(source)}`);
-  }
-
-  if (answer.facts.length > 0) {
-    lines.push('', 'Facts:');
-    for (const fact of answer.facts) lines.push(`  - ${nodeLabel(fact)}`);
-  }
-
-  if (answer.linkedObjects.length > 0) {
-    lines.push('', 'Linked objects:');
-    for (const object of answer.linkedObjects) lines.push(`  - ${nodeLabel(object)}`);
-  }
-
-  if (answer.gaps.length > 0) {
-    lines.push('', 'Gaps:');
-    for (const gap of answer.gaps) lines.push(`  - ${nodeLabel(gap)}`);
-  }
-
-  return lines.join('\n');
-}
-
 export const knowledgeCommand: SlashCommand = {
   name: 'knowledge',
   aliases: ['know', 'kb'],
   description: 'Agent Knowledge: isolated Agent-owned status, ask/search, source/node/issue lists, item lookup, map, connectors, ingest, and review queue.',
+  hidden: true,
   usage: '<subcommand> [args]',
-  argsHint: 'status|ask|search|list|get|map|connectors|connector|connector-doctor|ingest-url --yes|ingest-file --yes|ingest-artifact --yes|import-urls --yes|import-bookmarks --yes|import-browser-history --yes|ingest-connector --yes|review-issue --yes|reindex --yes',
+  argsHint: 'status|ask|search|list|get|map|connectors|ingest-url --yes|ingest-file --yes|ingest-artifact --yes|import-urls --yes|import-bookmarks --yes|import-browser-history --yes|ingest-connector --yes|review-issue --yes|reindex --yes',
   handler: async (args: string[], context: CommandContext): Promise<void> => {
     if (args.length === 0 && context.openAgentWorkspace) {
       context.openAgentWorkspace('knowledge');
@@ -220,6 +151,7 @@ export const knowledgeCommand: SlashCommand = {
       return;
     }
 
+    try {
     switch (sub) {
       case 'ask': {
         const ask = requireAgentKnowledgeAsk(context);
@@ -792,5 +724,8 @@ export const knowledgeCommand: SlashCommand = {
           '  consolidate [light|deep] --yes',
         ].join('\n'));
     }
+    } catch (error) {
+      context.print(`[knowledge] ${error instanceof Error ? error.message : String(error)}`);
+    }
   },
 };

package/src/input/commands/local-provider-runtime.ts

@@ -26,6 +26,7 @@ export function registerLocalProviderRuntimeCommands(registry: CommandRegistry):
     name: 'provider',
     aliases: ['p'],
     description: 'Switch provider or manage custom providers (add/remove)',
+    hidden: true,
     usage: '[add <name> <baseURL> [apiKey] --yes | remove <name> --yes | <provider-name>]',
     argsHint: '[name|add --yes|remove --yes]',
     async handler(args, ctx) {
@@ -171,6 +172,7 @@ export function registerLocalProviderRuntimeCommands(registry: CommandRegistry):
       const providerName = commandArgs[0];
       const requestedModel = commandArgs[1];
       const providerApi = requireProviderApi(ctx);
+      try {
       const selectable = await providerApi.listModels({
         providerId: providerName,
         selectableOnly: true,
@@ -183,7 +185,6 @@ export function registerLocalProviderRuntimeCommands(registry: CommandRegistry):
         ].join('\n'));
         return;
       }
-      try {
         const registryKey = requestedModel
           ? requestedModel.includes(':') ? requestedModel : `${providerName}:${requestedModel}`
           : match.registryKey;

package/src/input/commands/local-runtime.ts

@@ -1,4 +1,4 @@
-import { dirname, resolve } from 'path';
+import { dirname } from 'path';
 import { existsSync, mkdirSync, readFileSync, statSync, writeFileSync } from 'node:fs';
 import { readFile } from 'node:fs/promises';
 import type { CommandRegistry, CommandContext } from '../command-registry.ts';
@@ -108,13 +108,14 @@ function parseMediaGenerateArgs(args: readonly string[]): MediaGenerateArgs {
 }
 
 export function registerLocalRuntimeCommands(registry: CommandRegistry): void {
-  registry.register({ name: 'expand', description: 'Expand blocks by type', usage: '[all|thinking|tool|code]', argsHint: '[all|thinking|tool|code]', handler(args, ctx) { toggleBlocks(args[0] || 'all', false, ctx); } });
-  registry.register({ name: 'collapse', description: 'Collapse blocks by type', usage: '[all|thinking|tool|code]', argsHint: '[all|thinking|tool|code]', handler(args, ctx) { toggleBlocks(args[0] || 'all', true, ctx); } });
+  registry.register({ name: 'expand', description: 'Expand blocks by type', hidden: true, usage: '[all|thinking|tool|code]', argsHint: '[all|thinking|tool|code]', handler(args, ctx) { toggleBlocks(args[0] || 'all', false, ctx); } });
+  registry.register({ name: 'collapse', description: 'Collapse blocks by type', hidden: true, usage: '[all|thinking|tool|code]', argsHint: '[all|thinking|tool|code]', handler(args, ctx) { toggleBlocks(args[0] || 'all', true, ctx); } });
 
   registry.register({
     name: 'bookmarks',
     aliases: ['bm'],
     description: 'List bookmarked blocks',
+    hidden: true,
     handler(_args, ctx) {
       if (ctx.openBookmarkModal) {
         ctx.openBookmarkModal();
@@ -145,6 +146,7 @@ export function registerLocalRuntimeCommands(registry: CommandRegistry): void {
   registry.register({
     name: 'secrets',
     description: 'Manage hierarchy-aware secrets, external secret refs, and secure/plaintext storage policy controls',
+    hidden: true,
     usage: 'set <KEY> <value> [--user|--project] [--secure|--plaintext] --yes | link <KEY> <secret-ref> [--user|--project] [--secure|--plaintext] --yes | get <KEY> | test <secret-ref> | providers | list | delete <KEY> [--user|--project] [--secure|--plaintext] --yes',
     argsHint: '<set|link|get|test|providers|list|delete> [KEY]',
     async handler(args, ctx) {
@@ -326,6 +328,7 @@ export function registerLocalRuntimeCommands(registry: CommandRegistry): void {
   registry.register({
     name: 'media',
     description: 'Inspect media providers or generate media through configured providers',
+    hidden: true,
     usage: 'providers | generate [--provider <id>] [--model <id>] [--mime <mime>] <prompt> --yes',
     argsHint: '<providers|generate>',
     async handler(args, ctx) {
@@ -373,6 +376,7 @@ export function registerLocalRuntimeCommands(registry: CommandRegistry): void {
   registry.register({
     name: 'refresh-models',
     description: 'Refresh model catalog, benchmarks, and token limits',
+    hidden: true,
     async handler(_args, ctx) {
       const providerApi = requireProviderApi(ctx);
       let catalogOk = false;
@@ -411,6 +415,7 @@ export function registerLocalRuntimeCommands(registry: CommandRegistry): void {
   registry.register({
     name: 'pin',
     description: 'Pin a model to the favorites list',
+    hidden: true,
     usage: '<model-id>',
     argsHint: '<model-id>',
     async handler(args, ctx) {
@@ -445,6 +450,7 @@ export function registerLocalRuntimeCommands(registry: CommandRegistry): void {
   registry.register({
     name: 'unpin',
     description: 'Unpin a model from the favorites list',
+    hidden: true,
     usage: '<model-id>',
     argsHint: '<model-id>',
     async handler(args, ctx) {
@@ -455,7 +461,7 @@ export function registerLocalRuntimeCommands(registry: CommandRegistry): void {
         return;
       }
       const favorites = await providerApi.getFavorites();
-      const pinned = favorites.pinned.find((entry) => entry.registryKey === modelId);
+      const pinned = favorites.pinned.find((entry) => entry.registryKey === modelId || entry.modelId === modelId);
       if (!pinned) {
         ctx.print(`Model is not pinned: ${modelId}`);
         return;

package/src/input/commands/mcp-runtime.ts

@@ -192,6 +192,7 @@ export function registerMcpRuntimeCommands(registry: CommandRegistry): void {
     name: 'mcp',
     aliases: [],
     description: 'Manage MCP servers and their tools',
+    hidden: true,
     usage: '[servers|review|tools [<server>]|config|add|remove|reload|auth-review|repair [server]]',
     argsHint: '[servers|review|tools|config|add --yes|remove --yes]',
     async handler(args, ctx) {
@@ -339,6 +340,9 @@ export function registerMcpRuntimeCommands(registry: CommandRegistry): void {
         if (serverName || requestedMode) {
           ctx.print(`Usage: ${MCP_TRUST_COMMAND_USAGE}\nUse /settings -> MCP to explicitly enable allow-all.`);
           return;
+        } else {
+          ctx.print(`Usage: ${MCP_TRUST_COMMAND_USAGE}\nUse /settings -> MCP to explicitly enable allow-all.`);
+          return;
         }
       }
 
@@ -362,6 +366,9 @@ export function registerMcpRuntimeCommands(registry: CommandRegistry): void {
         if (serverName || requestedRole) {
           ctx.print(`Usage: ${MCP_ROLE_COMMAND_USAGE}`);
           return;
+        } else {
+          ctx.print(`Usage: ${MCP_ROLE_COMMAND_USAGE}`);
+          return;
         }
       }
 

package/src/input/commands/notify-runtime.ts

@@ -18,8 +18,24 @@ export function registerNotifyRuntimeCommands(registry: CommandRegistry): void {
       const sub = commandArgs[0];
 
       if (!sub || sub === 'list') {
+        const showFull = commandArgs.includes('--show') && parsed.yes;
         if (urls.length === 0) ctx.print('No webhook URLs configured.\nUse /notify add <url>');
-        else ctx.print(`Webhook URLs (${urls.length})\n${urls.map((u, i) => `  ${i + 1}. ${u}`).join('\n')}`);
+        else {
+          const display = urls.map((u, i) => {
+            if (showFull) return `  ${i + 1}. ${u}`;
+            try {
+              const parsedUrl = new URL(u);
+              const origin = parsedUrl.origin;
+              const truncPath = parsedUrl.pathname.length > 12
+                ? `${parsedUrl.pathname.slice(0, 12)}…`
+                : parsedUrl.pathname;
+              return `  ${i + 1}. ${origin}${truncPath} (use /notify list --show --yes to reveal full URL)`;
+            } catch {
+              return `  ${i + 1}. (invalid URL)`;
+            }
+          });
+          ctx.print(`Webhook URLs (${urls.length})\n${display.join('\n')}`);
+        }
         return;
       }
 

package/src/input/commands/onboarding-runtime.ts

@@ -5,6 +5,7 @@ export function registerOnboardingRuntimeCommands(registry: CommandRegistry): vo
     name: 'setup',
     aliases: ['onboarding'],
     description: 'Open the Agent workspace',
+    hidden: true,
     usage: '',
     async handler(_args, ctx) {
       if (ctx.executeCommand && await ctx.executeCommand('agent', [])) return;

package/src/input/commands/operator-actions-runtime.ts

@@ -123,6 +123,7 @@ export function registerOperatorActionRuntimeCommands(registry: CommandRegistry)
     name: 'automation',
     aliases: ['auto'],
     description: 'Run confirmed connected-host automation actions from the Agent TUI',
+    hidden: true,
     usage: 'job <run|pause|resume> <job-id> --yes | run <cancel|retry> <run-id> --yes | schedule <run|enable|disable|delete> <schedule-id> --yes',
     argsHint: 'job run <id> --yes | run cancel <id> --yes | schedule disable <id> --yes',
     async handler(args, ctx) {

package/src/input/commands/operator-runtime.ts

@@ -154,6 +154,7 @@ export function registerOperatorRuntimeCommands(registry: CommandRegistry): void
     name: 'context',
     aliases: ['ctx'],
     description: 'Inspect context window usage (token breakdown per message)',
+    hidden: true,
     handler: (_args, ctx) => {
       if (ctx.openContextInspector) {
         ctx.openContextInspector();
@@ -187,6 +188,7 @@ export function registerOperatorRuntimeCommands(registry: CommandRegistry): void
     name: 'next-error',
     aliases: ['ne'],
     description: 'Jump to the next error message in the conversation',
+    hidden: true,
     handler(_args, ctx) {
       const nextLine = ctx.session.conversationManager.nextErrorLine(ctx.getScrollTop?.() ?? 0);
       if (nextLine < 0) ctx.print('[No error messages found in conversation]');
@@ -197,6 +199,7 @@ export function registerOperatorRuntimeCommands(registry: CommandRegistry): void
     name: 'prev-error',
     aliases: ['pe'],
     description: 'Jump to the previous error message in the conversation',
+    hidden: true,
     handler(_args, ctx) {
       const prevLine = ctx.session.conversationManager.prevErrorLine(ctx.getScrollTop?.() ?? 0);
       if (prevLine < 0) ctx.print('[No error messages found in conversation]');

package/src/input/commands/personas-runtime.ts

@@ -164,6 +164,7 @@ export function registerPersonasRuntimeCommands(registry: CommandRegistry): void
     name: 'personas',
     aliases: ['persona'],
     description: 'Manage Agent-local personas',
+    hidden: true,
     usage: '[list|discover|import-discovered <name> --yes|search <query>|show <id>|create --name <name> --description <summary> --body <instructions>|update <id> [--name ...] [--description ...] [--body ...]|use <id>|active|clear|review <id>|stale <id> <reason...>|delete <id> --yes]',
     async handler(args, ctx) {
       const sub = (args[0] ?? 'list').toLowerCase();

package/src/input/commands/platform-access-runtime.ts

@@ -31,6 +31,7 @@ export function registerPlatformAccessRuntimeCommands(registry: CommandRegistry)
   registry.register({
     name: 'auth',
     description: 'Review provider auth posture and export redacted auth review bundles',
+    hidden: true,
     usage: '[review|show <provider>|repair <provider>|bundle export <path> --yes|bundle inspect <path>]',
     async handler(args, ctx) {
       const parsed = stripYesFlag(args);
@@ -59,11 +60,17 @@ export function registerPlatformAccessRuntimeCommands(registry: CommandRegistry)
       const serviceRegistry = requireServiceRegistry(ctx);
       const secretsManager = requireSecretsManager(ctx);
       if (sub === 'review') {
-        const snapshot = await buildAuthInspectionSnapshot({
-          serviceRegistry,
-          subscriptionManager: subscriptions,
-          secretsManager,
-        });
+        let snapshot;
+        try {
+          snapshot = await buildAuthInspectionSnapshot({
+            serviceRegistry,
+            subscriptionManager: subscriptions,
+            secretsManager,
+          });
+        } catch (error) {
+          ctx.print(`Could not build auth review: ${error instanceof Error ? error.message : String(error)}`);
+          return;
+        }
         const builtinProviders = listBuiltinSubscriptionProviders().map((entry) => entry.provider);
         ctx.print([
           'Auth Review',
@@ -83,11 +90,17 @@ export function registerPlatformAccessRuntimeCommands(registry: CommandRegistry)
           ctx.print('Usage: /auth show <provider>');
           return;
         }
-        const inspection = await inspectProviderAuth(provider, {
-          serviceRegistry,
-          subscriptionManager: subscriptions,
-          secretsManager,
-        });
+        let inspection;
+        try {
+          inspection = await inspectProviderAuth(provider, {
+            serviceRegistry,
+            subscriptionManager: subscriptions,
+            secretsManager,
+          });
+        } catch (error) {
+          ctx.print(`Could not inspect auth for ${provider}: ${error instanceof Error ? error.message : String(error)}`);
+          return;
+        }
         ctx.print([
           `Auth Provider ${provider}`,
           `  configured ${inspection.configured ? 'yes' : 'no'}`,
@@ -112,11 +125,17 @@ export function registerPlatformAccessRuntimeCommands(registry: CommandRegistry)
           ctx.print('Usage: /auth repair <provider>');
           return;
         }
-        const inspection = await inspectProviderAuth(provider, {
-          serviceRegistry,
-          subscriptionManager: subscriptions,
-          secretsManager,
-        });
+        let inspection;
+        try {
+          inspection = await inspectProviderAuth(provider, {
+            serviceRegistry,
+            subscriptionManager: subscriptions,
+            secretsManager,
+          });
+        } catch (error) {
+          ctx.print(`Could not inspect auth for repair of ${provider}: ${error instanceof Error ? error.message : String(error)}`);
+          return;
+        }
         ctx.print([
           `Auth Repair ${provider}`,
           `  configured ${inspection.configured ? 'yes' : 'no'}`,
@@ -158,8 +177,12 @@ export function registerPlatformAccessRuntimeCommands(registry: CommandRegistry)
           return;
         }
         if (mode === 'inspect') {
-          const bundle = JSON.parse(readFileSync(targetPath, 'utf-8')) as AuthReviewBundle;
-          ctx.print(inspectAuthBundle(bundle));
+          try {
+            const bundle = JSON.parse(readFileSync(targetPath, 'utf-8')) as AuthReviewBundle;
+            ctx.print(inspectAuthBundle(bundle));
+          } catch (error) {
+            ctx.print(`Could not read that bundle file: ${error instanceof Error ? error.message : String(error)}`);
+          }
           return;
         }
       }

package/src/input/commands/product-runtime.ts

@@ -91,6 +91,7 @@ export function registerProductRuntimeCommands(registry: CommandRegistry): void
   registry.register({
     name: 'trust',
     description: 'Review trust posture and export portable trust bundles',
+    hidden: true,
     usage: '[review|bundle export <path> --yes|bundle inspect <path>]',
     async handler(args, ctx) {
       const parsed = stripYesFlag(args);
@@ -122,7 +123,11 @@ export function registerProductRuntimeCommands(registry: CommandRegistry): void
           return;
         }
         if (mode === 'inspect') {
-          ctx.print(inspectTrustBundle(shellPaths.resolveWorkspacePath(pathArg!)));
+          try {
+            ctx.print(inspectTrustBundle(shellPaths.resolveWorkspacePath(pathArg!)));
+          } catch (error) {
+            ctx.print(`Could not read that bundle file: ${error instanceof Error ? error.message : String(error)}`);
+          }
           return;
         }
       }

package/src/input/commands/provider-accounts-runtime.ts

@@ -4,8 +4,8 @@ import type {
   ProviderAccountSnapshot,
   ProviderAuthRoute,
   ProviderRouteRecord,
-} from '../../panels/provider-account-snapshot.ts';
-import { buildProviderAccountSnapshot } from '../../panels/provider-account-snapshot.ts';
+} from '../../runtime/provider-account-snapshot.ts';
+import { buildProviderAccountSnapshot } from '../../runtime/provider-account-snapshot.ts';
 import {
   requireProvider,
   requireServiceRegistry,
@@ -45,6 +45,7 @@ export function registerProviderAccountsRuntimeCommands(registry: CommandRegistr
     name: 'accounts',
     aliases: ['account'],
     description: 'Review provider auth routes, subscription windows, and billing-path safety',
+    hidden: true,
     usage: '[review|show <provider>|routes <provider>|repair <provider>]',
     async handler(args, ctx) {
       const sub = (args[0] ?? 'review').toLowerCase();

package/src/input/commands/qrcode-runtime.ts

@@ -65,6 +65,7 @@ export function registerQrcodeRuntimeCommands(registry: CommandRegistry): void {
     name: 'qrcode',
     aliases: ['qr', 'pair'],
     description: 'Print companion pairing details and a QR code',
+    hidden: true,
     usage: '',
     handler(args, ctx) {
       const shellPaths = requireShellPaths(ctx);

package/src/input/commands/routines-runtime.ts

@@ -413,6 +413,7 @@ export function registerRoutinesRuntimeCommands(registry: CommandRegistry): void
     name: 'routines',
     aliases: ['routine'],
     description: 'Manage Agent-local routines',
+    hidden: true,
     usage: '[list|enabled|attention|discover|import-discovered <name> --yes|search <query>|show <id>|receipts|reconcile|receipt <id>|create --name <name> --description <summary> --steps <steps> [--requires-env A,B] [--requires-command gh,jq]|update <id> [--name ...] [--description ...] [--steps ...]|enable <id>|disable <id>|start <id>|review <id>|stale <id> <reason...>|promote <id> --cron <expr> [--delivery-channel slack] --yes|delete <id> --yes]',
     handler: runRoutinesRuntimeCommand,
   });