@asobacloud/nehanda 0.6.1 → 0.8.0

package/lib/slashCommands.mjs

@@ -0,0 +1,128 @@
+/**
+ * Single source of truth for nehanda-ui slash commands + help (#9).
+ * Autocomplete uses top-level entries (or nested when the user has typed a parent prefix).
+ */
+
+/** @typedef {{ name: string, desc: string, autocomplete?: boolean }} SlashEntry */
+
+/** @type {SlashEntry[]} */
+export const TUI_SLASH_COMMANDS = [
+  { name: '/model', desc: 'Configure provider → key → host → discover → model' },
+  { name: '/key', desc: 'Set Nehanda API key, then continue configure' },
+  { name: '/key openrouter [VALUE]', desc: 'OpenRouter key → continue configure', autocomplete: false },
+  { name: '/key openai [VALUE]', desc: 'OpenAI-compat key → continue configure', autocomplete: false },
+  { name: '/key zhipu [VALUE]', desc: 'Zhipu (z.ai) key → continue configure', autocomplete: false },
+  { name: '/key nehanda [VALUE]', desc: 'Nehanda key → continue configure', autocomplete: false },
+  { name: '/config', desc: 'Show provider, model, endpoint, key status' },
+  { name: '/mcp', desc: 'MCP server & tool management' },
+  { name: '/mcp list', desc: 'List tools from configured MCP servers', autocomplete: false },
+  { name: '/mcp status', desc: 'Show configured servers', autocomplete: false },
+  { name: '/mcp reload [server]', desc: 'Reload mcp.json into this session', autocomplete: false },
+  { name: '/mcp add <name> <command> [args…]', desc: 'Register a server (~/.config/nehanda/mcp.json)', autocomplete: false },
+  { name: '/mcp env', desc: 'Show env vars for every server (values masked)', autocomplete: false },
+  { name: '/mcp env <server>', desc: 'Show env vars for one server', autocomplete: false },
+  { name: '/mcp env <server> <NAME> <VALUE>', desc: 'Set env var  e.g. /mcp env jupyter JUPYTER_TOKEN sk-…', autocomplete: false },
+  { name: '/mcp env unset <server> <NAME>', desc: 'Remove an env var from a server', autocomplete: false },
+  { name: '/clear', desc: 'New conversation' },
+  { name: '/retry', desc: 'Resend the last failed message' },
+  { name: '/help', desc: 'Show this help' },
+  { name: '/exit', desc: 'Quit (/quit)' },
+]
+
+/** Top-level commands only (slash menu when typing `/`). */
+export function topLevelSlashCommands() {
+  return TUI_SLASH_COMMANDS.filter(c => c.autocomplete !== false && !c.name.slice(1).includes(' '))
+}
+
+/**
+ * Filter for Ink slash autocomplete.
+ * - Bare `/foo` → top-level matches
+ * - `/mcp…` → MCP entries (including subcommands)
+ * - `/key…` → /key variants
+ */
+export function filterSlashAutocomplete(filter) {
+  const f = String(filter || '')
+  const lower = f.toLowerCase()
+  if (lower.startsWith('/mcp')) {
+    const needle = lower.trimEnd()
+    return TUI_SLASH_COMMANDS.filter(c => {
+      if (!c.name.startsWith('/mcp')) return false
+      if (needle === '/mcp') return true
+      return c.name.toLowerCase().startsWith(needle)
+    })
+  }
+  if (lower.startsWith('/key')) {
+    const needle = lower.trimEnd()
+    return TUI_SLASH_COMMANDS.filter(c => {
+      if (!c.name.startsWith('/key')) return false
+      if (needle === '/key') return true
+      return c.name.toLowerCase().startsWith(needle)
+    })
+  }
+  return topLevelSlashCommands().filter(c =>
+    c.name.startsWith(f) || c.name.includes(f.slice(1)))
+}
+
+/** Full help text for `/help` (no chalk — caller may colorize). */
+export function formatTuiHelpText() {
+  const pad = Math.max(...TUI_SLASH_COMMANDS.map(c => c.name.length), 12) + 2
+  const lines = ['', 'Commands:', '']
+  let lastGroup = ''
+  for (const c of TUI_SLASH_COMMANDS) {
+    const group = c.name.split(/\s+/)[0]
+    if (lastGroup && group !== lastGroup && (group === '/mcp' || lastGroup === '/mcp' || group === '/clear')) {
+      lines.push('')
+    }
+    lastGroup = group
+    lines.push(`  ${c.name.padEnd(pad)}${c.desc}`)
+  }
+  lines.push('')
+  return lines.join('\n')
+}
+
+/**
+ * Parse `/mcp env …` argument tokens (after `/mcp`).
+ * @param {string[]} parts - e.g. ['env'] | ['env','jupyter'] | ['env','unset','jupyter','TOKEN'] | ['env','jupyter','TOKEN','sk-…']
+ * @returns {{ action: string, server?: string, name?: string, value?: string, error?: string }}
+ */
+export function parseMcpEnvParts(parts) {
+  // parts[0] should be 'env'
+  const rest = parts.slice(1)
+  if (rest.length === 0) return { action: 'list_all' }
+
+  const head = (rest[0] || '').toLowerCase()
+  if (head === 'unset' || head === 'clear') {
+    const server = rest[1]
+    const name = rest[2]
+    if (!server || !name) {
+      return {
+        action: 'usage_error',
+        error: 'Usage: /mcp env unset <server> <NAME>\n  Example: /mcp env unset jupyter JUPYTER_TOKEN',
+      }
+    }
+    if (rest.length > 3) {
+      return {
+        action: 'usage_error',
+        error: 'Usage: /mcp env unset <server> <NAME>\n  Do not pass a value when unsetting.',
+      }
+    }
+    return { action: 'unset', server, name }
+  }
+
+  const server = rest[0]
+  if (rest.length === 1) return { action: 'list_server', server }
+
+  const name = rest[1]
+  const valueParts = rest.slice(2)
+  if (valueParts.length === 0) {
+    return {
+      action: 'usage_error',
+      error: [
+        `Missing VALUE for ${name}.`,
+        `  Set:   /mcp env ${server} ${name} <VALUE>`,
+        `  Unset: /mcp env unset ${server} ${name}`,
+      ].join('\n'),
+    }
+  }
+  return { action: 'set', server, name, value: valueParts.join(' ') }
+}

package/lib/ui.mjs

@@ -120,16 +120,18 @@ export function formatHelp(provider, dbPath) {
     cmd('/compact', 'Compact conversation'),
     cmd('/team', 'Manage teams'),
     '',
-    cmd('/model [name]', 'Change model'),
+    cmd('/model', 'Configure provider, key, host, model'),
+    cmd('/key [provider] [value]', 'Save API key then continue configure'),
     cmd('/login', 'Store credentials'),
     cmd('/logout', 'Clear credentials'),
     cmd('/status', 'Auth status'),
-    cmd('/config', 'Show / set settings'),
-    cmd('/config set <key> <value>', 'Set any config value'),
+    cmd('/config', 'Show provider / model / key status'),
     cmd('/mcp', 'MCP server management & guide'),
     cmd('/mcp list', 'List all discovered tools & descriptions'),
     cmd('/mcp status', 'Show configured MCP servers'),
-    cmd('/mcp env [server] [KEY] [val]', 'Set MCP env vars (API keys)'),
+    cmd('/mcp env', 'Show env vars (masked)'),
+    cmd('/mcp env <server> <NAME> <VALUE>', 'Set an env var'),
+    cmd('/mcp env unset <server> <NAME>', 'Remove an env var'),
     cmd('/clear', 'New conversation'),
     cmd('/exit', 'Quit (/quit)'),
     '',
@@ -141,15 +143,18 @@ export function formatHelp(provider, dbPath) {
 }
 
 export function formatMcpHelp() {
-  const cmd = (name, desc) => `  ${colors.command(name.padEnd(28))} ${colors.dim(desc)}`
+  const cmd = (name, desc) => `  ${colors.command(name.padEnd(40))} ${colors.dim(desc)}`
   const lines = [
     '',
     colors.header('MCP Server & Tool Commands'),
-    cmd('/mcp list', 'Discover and list all available MCP tools'),
-    cmd('/mcp status', 'Show configured servers and command paths'),
-    cmd('/mcp reload [server]', 'Reload mcp.json configs into session'),
-    cmd('/mcp add <name> <cmd> [args]', 'Register a new MCP server'),
-    cmd('/mcp env [server] [KEY] [val]', 'View or set server environment variables'),
+    cmd('/mcp list', 'List tools from configured MCP servers'),
+    cmd('/mcp status', 'Show configured servers'),
+    cmd('/mcp reload [server]', 'Reload mcp.json into this session'),
+    cmd('/mcp add <name> <command> [args…]', 'Register a server'),
+    cmd('/mcp env', 'Show env vars for every server (values masked)'),
+    cmd('/mcp env <server>', 'Show env vars for one server'),
+    cmd('/mcp env <server> <NAME> <VALUE>', 'Set env var  e.g. /mcp env jupyter JUPYTER_TOKEN sk-…'),
+    cmd('/mcp env unset <server> <NAME>', 'Remove an env var'),
     '',
     colors.dim('  Tip: Run /mcp list to inspect tools injected into the assistant.'),
     '',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@asobacloud/nehanda",
-  "version": "0.6.1",
+  "version": "0.8.0",
   "type": "module",
   "description": "Agentic terminal REPL and single-process engine for governed AI deep research and software development. Connects to Nehanda v3, OpenRouter, Ollama, LM Studio, ZhipuAI, or any OpenAI-compatible API. Includes Laya System-1 control plane for memory management, pre-execution safety gating, and intent-driven instruction shaping.",
   "keywords": [