emacs: add gptel-agent

1 files changed, 160 insertions, 0 deletions

diff --git a/epistemia/packages/emacs.scm b/epistemia/packages/emacs.scm
index 0488898..87d8087 100644
--- a/epistemia/packages/emacs.scm
+++ b/epistemia/packages/emacs.scm
@@ -65,3 +65,163 @@ underline style instead of regular underline. (setq kaolin-themes-underline-wave
 t) ;; When t, will display colored hl-line style (setq
 kaolin-themes-hl-line-colored t).")
     (license license:gpl3)))
+
+(define-public emacs-gptel-new
+  (package
+    (name "emacs-gptel-new")
+    (version "20260410.711")
+    (source
+     (origin
+       (method git-fetch)
+       (uri (git-reference
+             (url "https://github.com/karthink/gptel")
+             (commit "8d6411b5f89d796c817ff79324973b8910e164fe")))
+       (file-name (git-file-name name version))
+       (sha256
+        (base32 "0zl5qdp9qqh8chadsp2m3jpbpsxlywdlfkax8p97y73q1yias0q6"))))
+    (build-system emacs-build-system)
+    (propagated-inputs (list emacs-transient emacs-compat))
+    (home-page "https://github.com/karthink/gptel")
+    (synopsis "Interact with ChatGPT or other LLMs")
+    (description
+     "gptel is a simple Large Language Model chat client, with support for multiple
+models and backends.  It works in the spirit of Emacs, available at any time and
+in any buffer.  gptel supports: - The services @code{ChatGPT}, Azure, Gemini,
+Anthropic AI, Together.ai, Perplexity, AI/ML API, Anyscale, @code{OpenRouter},
+Groq, @code{PrivateGPT}, @code{DeepSeek}, Cerebras, Github Models, @code{GitHub}
+Copilot chat, AWS Bedrock, Novita AI, @code{xAI}, Sambanova, Mistral Le Chat and
+Kagi (@code{FastGPT} & Summarizer). - Local models via Ollama, Llama.cpp,
+Llamafiles or GPT4All Additionally, any LLM service (local or remote) that
+provides an @code{OpenAI-compatible} API is supported.  Features: - Interact
+with LLMs from anywhere in Emacs (any buffer, shell, minibuffer, wherever). -
+LLM responses are in Markdown or Org markup. - Supports conversations and
+multiple independent sessions. - Supports tool-use to equip LLMs with agentic
+capabilities. - Supports Model Context Protocol (MCP) integration using the
+mcp.el package. - Supports multi-modal models (send images, documents). -
+Supports \"reasoning\" content in LLM responses. - Save chats as regular
+Markdown/Org/Text files and resume them later. - You can go back and edit your
+previous prompts or LLM responses when continuing a conversation.  These will be
+fed back to the model. - Redirect prompts and responses easily - Rewrite,
+refactor or fill in regions in buffers. - Write your own commands for custom
+tasks with a simple API. Requirements for @code{ChatGPT}, Azure, Gemini or Kagi:
+- You need an appropriate API key.  Set the variable `gptel-api-key to the key
+or to a function of no arguments that returns the key. (It tries to use
+`auth-source by default) @code{ChatGPT} is configured out of the box.  For the
+other sources: - For Azure: define a gptel-backend with `gptel-make-azure'. -
+For Gemini: define a gptel-backend with `gptel-make-gemini'. - For Anthropic
+(Claude): define a gptel-backend with `gptel-make-anthropic'. - For AI/ML API,
+Together.ai, Anyscale, Groq, @code{OpenRouter}, @code{DeepSeek}, Cerebras or
+Github Models: define a gptel-backend with `gptel-make-openai'. - For
+@code{PrivateGPT}: define a backend with `gptel-make-privategpt'. - For
+Perplexity: define a backend with `gptel-make-perplexity'. - For Deepseek:
+define a backend with `gptel-make-deepseek'. - For Kagi: define a gptel-backend
+with `gptel-make-kagi'.  For local models using Ollama, Llama.cpp or GPT4All: -
+The model has to be running on an accessible address (or localhost) - Define a
+gptel-backend with `gptel-make-ollama or `gptel-make-gpt4all'. - Llama.cpp or
+Llamafiles: Define a gptel-backend with `gptel-make-openai'.  Consult the
+package README for examples and more help with configuring backends.  Usage:
+gptel can be used in any buffer or in a dedicated chat buffer.  The interaction
+model is simple: Type in a query and the response will be inserted below.  You
+can continue the conversation by typing below the response.  To use this in any
+buffer: - Call `gptel-send to send the buffer's text up to the cursor.  Select a
+region to send only the region. - You can select previous prompts and responses
+to continue the conversation. - Call `gptel-send with a prefix argument to
+access a menu where you can set your backend, model and other parameters, or to
+redirect the prompt/response.  To use this in a dedicated buffer: - M-x gptel:
+Start a chat session. - In the chat session: Press `C-c RET (`gptel-send') to
+send your prompt.  Use a prefix argument (`C-u C-c RET') to access a menu.  In
+this menu you can set chat parameters like the system directives, active backend
+or model, or choose to redirect the input or output elsewhere (such as to the
+kill ring or the echo area). - You can save this buffer to a file.  When opening
+this file, turn on `gptel-mode before editing it to restore the conversation
+state and continue chatting. - To include media files with your request, you can
+add them to the context (described next), or include them as links in Org or
+Markdown mode chat buffers.  Sending media is disabled by default, you can turn
+it on globally via `gptel-track-media', or locally in a chat buffer via the
+header line.  Include more context with requests: If you want to provide the LLM
+with more context, you can add arbitrary regions, buffers, files or directories
+to the query with `gptel-add'.  To add text or media files, call `gptel-add in
+Dired or use the dedicated `gptel-add-file'.  You can also add context from
+gptel's menu instead (`gptel-send with a prefix arg), as well as examine or
+modify context.  When context is available, gptel will include it with each LLM
+query.  LLM Tool use: gptel supports \"tool calling\" behavior, where LLMs can
+specify arguments with which to call provided \"tools\" (elisp functions).  The
+results of running the tools are fed back to the LLM, giving it capabilities and
+knowledge beyond what is available out of the box.  For example, tools can
+perform web searches or API lookups, modify files and directories, and so on.
+Tools can be specified via `gptel-make-tool', or obtained from other
+repositories, or from Model Context Protocol (MCP) servers using the mcp.el
+package.  See the README for details.  Tools can be included with LLM queries
+using gptel's menu, or from `gptel-tools'.  Rewrite interface In any buffer:
+with a region selected, you can rewrite prose, refactor code or fill in the
+region.  This is accessible via `gptel-rewrite', and also from the `gptel-send
+menu.  Presets Define a bundle of configuration (model, backend, system message,
+tools etc) as a \"preset\" that can be applied together, making it easy to switch
+between tasks in gptel.  Presets can be saved and applied from gptel's transient
+menu.  You can also include a cookie of the form \"@@preset-name\" in the prompt
+to send a request with a preset applied.  This feature works everywhere, but
+preset cookies are also fontified in chat buffers.  gptel in Org mode: gptel
+offers a few extra conveniences in Org mode: - You can limit the conversation
+context to an Org heading with `gptel-org-set-topic'. - You can have branching
+conversations in Org mode, where each hierarchical outline path through the
+document is a separate conversation branch.  See the variable
+`gptel-org-branching-context'. - You can declare the gptel model, backend,
+temperature, system message and other parameters as Org properties with the
+command `gptel-org-set-properties'.  gptel queries under the corresponding
+heading will always use these settings, allowing you to create mostly
+reproducible LLM chat notebooks.  Finally, gptel offers a general purpose API
+for writing LLM ineractions that suit your workflow.  See `gptel-request', and
+`gptel-fsm for more advanced usage.")
+    (license license:gpl3)))
+
+(define-public emacs-gptel-agent
+  (package
+    (name "emacs-gptel-agent")
+    (version "20260412.716")
+    (source
+     (origin
+       (method git-fetch)
+       (uri (git-reference
+             (url "https://github.com/karthink/gptel-agent")
+             (commit "bef06bccdbf847e0c4a94d1b57dd96d979437430")))
+       (file-name (git-file-name name version))
+       (sha256
+        (base32 "1g33w8db2g33l3qf4f9vnafkdpilaxh4s9cy76yv79rphg92ipaw"))))
+    (build-system emacs-build-system)
+    (propagated-inputs (list emacs-compat emacs-gptel-new emacs-yaml
+                             emacs-orderless))
+    (arguments
+     '(#:include '("^[^/]*.el$" "^[^/]*.el.in$"
+                   "^dir$"
+                   "^[^/]*.info$"
+                   "^[^/]*.texi$"
+                   "^[^/]*.texinfo$"
+                   "^doc/dir$"
+                   "^doc/[^/]*.info$"
+                   "^doc/[^/]*.texi$"
+                   "^doc/[^/]*.texinfo$"
+                   "^agents$")
+       #:exclude '("^.dir-locals.el$" "^test.el$" "^tests.el$"
+                   "^[^/]*-test.el$" "^[^/]*-tests.el$")))
+    (home-page "https://github.com/karthink/gptel-agent")
+    (synopsis "Agentic LLM use for gptel")
+    (description
+     "This is a collection of tools and prompts to use gptel \"agentically\" with any
+LLM, to autonomously perform tasks.  It has access to - the web (via basic web
+search, URL fetching and @code{YouTube} video metadata), - local files
+(read/write/edit), - the state of Emacs (documentation and Elisp evaluation), -
+and Bash, if you are in a POSIX-y environment.  To use gptel-agent in a
+dedicated buffer: - Set `gptel-model and `gptel-backend to use your preferred
+LLM. - Run M-x `gptel-agent'.  This will open a buffer with the agent preset
+loaded. - Use gptel as usual, calling `gptel-send etc. - If you change the
+system prompt, tools or other settings in this buffer, you can reset the agent
+state by (re)applying the \"gptel-agent\" preset from gptel's menu.  To use
+gptel-agent anywhere in Emacs: - As with gptel, you can use gptel-agent in any
+buffer.  Just apply the \"gptel-agent\" preset in the buffer, or include
+\"@@gptel-agent\" in a prompt.  gptel-agent can delegate tasks to \"sub-agents\".
+Sub-agents can be specified in Markdown or Org files in a directory.  To see how
+to specify agents, examine the \"agents\" directory in this package.  You can add
+your directory of agents to `gptel-agent-dirs', which see.  Please note:
+gptel-agent uses significantly more tokens than the average gptel LLM
+interaction.")
+    (license license:gpl3)))