Module: Kward::PromptCommands

Defined in:
lib/kward/prompts/commands.rb

Constant Summary collapse

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: "resume", description: "Resume a saved session.", argument_hint: "[path]" },
  { name: "name", description: "Name or clear the current session.", argument_hint: "[name]" },
  { name: "clone", description: "Clone the current session.", 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: "openrouter/catalog", description: "List the full OpenRouter model catalog.", argument_hint: "" },
  { name: "reasoning", description: "Select reasoning effort.", argument_hint: "" },
  { name: "status", description: "Show the current status message.", argument_hint: "" },
  { name: "stats", description: "Show telemetry logging stats.", argument_hint: "[range]" },
  { name: "crew", description: "Reserved for future crew commands.", argument_hint: "" },
  { name: "memory", description: "Inspect and manage Kward memory.", argument_hint: "[enable|disable|auto-summary|core|add|list|forget|promote|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 collapse

Class Method Details

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



38
39
40
41
42
43
44
45
46
47
48
 
# File 'lib/kward/prompts/commands.rb', line 38

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 



31
32
33
34
35
36
 
# File 'lib/kward/prompts/commands.rb', line 31

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

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