From 9b1be8eca44cfb825ec69b5b53428f4ff9c5a248 Mon Sep 17 00:00:00 2001
From: m3ta-chiron <m3ta-chiron@agentmail.to>
Date: Mon, 31 Aug 2026 11:44:22 +0200
Subject: [PATCH] refactor(agents): consume llm-agents packages via
 pkgs.llm-agents namespace
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

numtide/llm-agents.nix's shared-nixpkgs overlay exposes everything under
pkgs.llm-agents.* — no flattening to top-level attrs anymore. Namespaced
refs fail loudly when the overlay is missing instead of silently falling
back to outdated nixpkgs attributes (opencode 0.3.x) or disappearing.

Requires the consumer's nixos-config to apply
inputs.llm-agents.overlays.shared-nixpkgs (see nixos-config
hosts/common/default.nix).
---
 profiles/sets/coding/agents/agents.nix | 15 ++++++++++-----
 1 file changed, 10 insertions(+), 5 deletions(-)

diff --git a/profiles/sets/coding/agents/agents.nix b/profiles/sets/coding/agents/agents.nix
index b89a531..4cfbf93 100644
--- a/profiles/sets/coding/agents/agents.nix
+++ b/profiles/sets/coding/agents/agents.nix
@@ -61,23 +61,28 @@
     };
   };
 
+  # NOTE: llm-agent packages are consumed via the `llm-agents` namespace
+  # (pkgs.llm-agents.*), provided by numtide/llm-agents.nix's
+  # `overlays.shared-nixpkgs`. The consumer's nixos-config MUST apply that
+  # overlay — namespaced refs fail loudly if it is missing, instead of
+  # silently falling back to (outdated) nixpkgs attributes.
   home.packages = with pkgs; [
     agenix-cli
-    agent-browser
+    llm-agents.agent-browser
     m3taHomeInputs.agent-lib.packages.${pkgs.stdenv.hostPlatform.system}.agent-lib-cli
-    beads
+    llm-agents.beads
     buzz
     crunch
     docker-sbx
-    herdr
+    llm-agents.herdr
     pi-coding-agent
-    (qmd.override {
+    (llm-agents.qmd.override {
       vulkanSupport = videoDrivers == ["amdgpu"];
       cudaSupport = videoDrivers == ["nvidia"];
     })
     opencode-desktop
     openshell
-    openspec
+    llm-agents.openspec
     openwork
     talk
   ];