Module: Kward::PromptCommands

Defined in:

lib/kward/prompts/commands.rb

Overview

Prompt-template and slash-command parsing helpers.

Constant Summary

BUILTIN_COMMANDS =

[
  { name: "exit", description: "Exit the interactive session.", argument_hint: "" },
  { name: "quit", description: "Exit the interactive session.", argument_hint: "" },
  { name: "new", description: "Start a new session.", argument_hint: "" },
  { name: "sessions", description: "Open the saved sessions picker.", argument_hint: "[path]" },
  { name: "resume", description: "Alias for /sessions.", argument_hint: "[path]" },
  { name: "name", description: "Name or clear the current session.", argument_hint: "[name]" },
  { name: "rename", description: "Rename the current session.", argument_hint: "<name>" },
  { name: "clone", description: "Clone the current session.", argument_hint: "" },
  { name: "fork", description: "Fork from an earlier prompt into a new session.", argument_hint: "" },
  { name: "rewind", description: "Revisit an earlier prompt and try a different direction.", argument_hint: "" },
  { name: "tree", description: "Inspect and navigate the full technical session tree.", argument_hint: "" },
  { name: "copy", description: "Copy clean session text to the clipboard.", argument_hint: "[last|transcript]" },
  { name: "export", description: "Export the current session as Markdown.", argument_hint: "[path]" },
  { name: "compact", description: "Compact the current conversation context.", argument_hint: "[instructions]" },
  { name: "redraw", description: "Refresh the visible terminal.", argument_hint: "" },
  { name: "settings", description: "Configure prompt overlays.", argument_hint: "" },
  { name: "login", description: "Log in with an OAuth provider.", argument_hint: "" },
  { name: "model", description: "Select the default model.", argument_hint: "" },
  { name: "reasoning", description: "Select reasoning effort.", argument_hint: "" },
  { name: "reload", description: "Reload installed plugins.", argument_hint: "" },
  { name: "workers", description: "Open the worker pipeline.", argument_hint: "[new|do <task>]" },
  { name: "queue", description: "Manage the tab-backed worker queue.", argument_hint: "[add|list|open|run|suspend|resume]" },
  { name: "git", description: "Review uncommitted changes and commit them.", argument_hint: "" },
  { name: "diff", description: "Open the file changes recorded in this session.", argument_hint: "" },
  { name: "files", description: "Browse project files.", argument_hint: "" },
  { name: "shell", description: "Open the embedded Kward shell.", argument_hint: "" },
  { name: "scratchpad", description: "Open an unsaved editor buffer.", argument_hint: "[text|markdown|ruby]" },
  { name: "pty", description: "Run a command in an interactive PTY passthrough session.", argument_hint: "<command>" },
  { name: "tab", description: "Manage tabs.", argument_hint: "[1-n|move|close|new|name]" },
  { name: "status", description: "Show the current status message.", argument_hint: "" },
  { name: "stats", description: "Show telemetry logging stats.", argument_hint: "[range]" },
  { name: "memory", description: "Inspect and manage Kward memory.", argument_hint: "[enable|disable|auto-summary|core|add|list|forget|promote|relax|inspect|why|summarize]" }
].freeze

BUILTIN_RESERVED_COMMAND_NAMES =

BUILTIN_COMMANDS.map { |command| command[:name] }.freeze

SLASH_COMMAND_PATTERN =

%r{\A/(\S+)(?:\s+(.*))?\z}m

Class Method Summary

• .expand(input, templates: nil, reserved_commands: BUILTIN_RESERVED_COMMAND_NAMES) ⇒ Object
• .parse(input) ⇒ Object

Class Method Details

.expand(input, templates: nil, reserved_commands: BUILTIN_RESERVED_COMMAND_NAMES) ⇒ Object

# File 'lib/kward/prompts/commands.rb', line 53

def expand(input, templates: nil, reserved_commands: BUILTIN_RESERVED_COMMAND_NAMES)
  parsed = parse(input)
  return nil unless parsed

  command, arguments = parsed
  templates ||= ConfigFiles.prompt_templates(reserved_commands: reserved_commands)
  template = templates.find { |candidate| candidate.command == command }
  return nil unless template

  template.expand(arguments)
end

.parse(input) ⇒ Object

# File 'lib/kward/prompts/commands.rb', line 46

def parse(input)
  match = input.to_s.match(SLASH_COMMAND_PATTERN)
  return nil unless match

  [match[1], match[2].to_s]
end