declare first tool (read_file)

1 files changed, 37 insertions, 0 deletions

diff --git a/gptel-tools.el b/gptel-tools.el
new file mode 100644
index 0000000..bd76a98
--- /dev/null
+++ b/gptel-tools.el
@@ -0,0 +1,37 @@
+;; read_file (hl-file-read)
+(gptel-make-tool
+ :name "read_file"
+ :function 'hl-file-read
+ :description "\
+Read an entire file and return its contents in hashline format. Each
+line is represented as LINE_NUMBER HASH|CONTENT, where LINE_NUMBER is
+the 1-based line number, HASH is a 2-character content-derived bigram,
+and CONTENT is the verbatim line text. Example output:
+
+1aa|const char *TITLE = \"Mr\";
+2ab|void greet(char *name) {
+3cd|    return name;
+
+The LINE_NUMBER and HASH together form an anchor (e.g., 1aa, 2ab) that
+uniquely identifies a line by position and content. Copy anchors
+verbatim from the output when referencing lines in edit operations. Do
+not fabricate or modify hashes. Call this tool before editing any file
+to obtain current content and valid anchors. Re-call if anchors no
+longer match after external changes."
+ :args (list '(:name "file"
+                     :type string
+                     :description "Path to the file to read, relative to the working directory."))
+ :async nil
+ :confirm nil
+ :include t)
+
+;; TODO write_file (with-temp-buffer + insert)
+;; TODO edit_file (hashline + patch apply)
+
+;; TODO bash_readonly (shell-command-to-string, whitelisted commands)
+;; TODO bash (shell-command-to-string, needs heavy filtering)
+
+;; TODO find_files (directory-files-decursively)
+;; TODO grep (just grep :D)
+;; TODO fetch_url (use gptel-agent's one as a base, but needs mime handling like PDFs and images)
+;; TODO web_search (use gptel-agent's eww/shr method as a base)