Skip to content
Kward Search API index

Class: Kward::Tools::OpenEditor

Inherits:
Base
  • Object
show all
Defined in:
lib/kward/tools/open_editor.rb

Overview

Tool wrapper for opening a workspace file in the integrated editor.

Instance Attribute Summary

Attributes inherited from Base

#name

Instance Method Summary collapse

Methods inherited from Base

#schema

Constructor Details

#initialize(workspace:, prompt:) ⇒ OpenEditor

Builds the tool schema and stores the execution dependencies.



10
11
12
13
14
15
16
17
18
19
20
21
 
# File 'lib/kward/tools/open_editor.rb', line 10

def initialize(workspace:, prompt:)
  @workspace = workspace
  @prompt = prompt
  super(
    "open_editor",
    "Open a workspace file in Kward's integrated editor for the user. Use this when the user explicitly asks to open or edit a file in the built-in editor. This does not itself modify or save the file; the user controls those actions in the editor.",
    properties: {
      path: { type: "string", description: "Workspace-relative path of the file to open." }
    },
    required: ["path"]
  )
end

Instance Method Details

#call(args, _conversation, cancellation: nil) ⇒ Object

Opens the requested file and returns after the editor closes.



24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
 
# File 'lib/kward/tools/open_editor.rb', line 24

def call(args, _conversation, cancellation: nil)
  cancellation&.raise_if_cancelled!
  return "Error: open_editor requires interactive editor support." unless @prompt.respond_to?(:edit_file)

  path = argument(args, :path, "").to_s
  return "Error: open_editor requires a file path." if path.empty?

  resolved_path = @workspace.resolved_path(path)
  return "Error: not a file: #{path}" unless File.file?(resolved_path)

  opened = @prompt.edit_file(resolved_path, base_dir: @workspace.root, allow_new: false)
  opened ? "Opened #{path} in the integrated editor." : "Error: could not open #{path} in the integrated editor."
rescue SecurityError, StandardError => e
  "Error: could not open #{path}: #{e.message}"
end