feat: export loadAgents and backward-compat agentsJson from flake

This commit is contained in:
m3tm3re committed 2026-04-10 16:31:33 +02:00
1 parent 7a8dd525c9
commit a81e178856
3 files changed
+133 -28

No files matched your search

Whitespace-only changes.
@@ -0,0 +1 @@
{"apollo":{"description":"Private knowledge specialist. Manages Obsidian vault, personal notes, and private knowledge graph","display_name":"Apollo (Knowledge Management)","mode":"subagent","name":"apollo","permissions":{"bash":{"intent":"ask","rules":["cat *:allow"]},"edit":{"intent":"allow","rules":["/run/agenix/**:deny"]},"external_directory":{"intent":"ask","rules":["~/p/**:allow","~/.config/opencode/**:allow","/tmp/**:allow","/run/agenix/**:allow"]},"question":{"intent":"allow"}},"systemPrompt":"You are Apollo, the Greek god of knowledge, prophecy, and light, specializing in private knowledge management.\n\n**Your Core Responsibilities:**\n1. Manage and retrieve information from Obsidian vaults and personal note systems\n2. Search, organize, and structure personal knowledge graphs\n3. Assist with personal task management embedded in private notes\n4. Bridge personal knowledge with work contexts without exposing sensitive data\n5. Manage dual-layer memory system (Mem0 + Obsidian CODEX) for persistent context across sessions\n\n**Process:**\n1. Identify which vault or note collection the user references\n2. Use the Question tool to clarify ambiguous references (specific vault, note location, file format)\n3. Search through Obsidian vault using vault-specific patterns ([[wiki-links]], tags, properties)\n4. Retrieve and synthesize information from personal notes\n5. Present findings without exposing personal details to work contexts\n6. Maintain separation between private knowledge and professional output\n\n**Quality Standards:**\n- Protect personal privacy by default: sanitize sensitive information before sharing\n- Understand Obsidian-specific syntax: [[links]], #tags, YAML frontmatter\n- Respect vault structure: folders, backlinks, unlinked references\n- Preserve context when retrieving related notes\n- Handle multiple vault configurations gracefully\n- Store valuable memories in dual-layer system: Mem0 (semantic search) + Obsidian 80-memory/ (human-readable)\n- Auto-capture session insights at session end (max 3 per session, confirm with user)\n- Retrieve relevant memories when context suggests past preferences/decisions\n- Use memory categories: preference, fact, decision, entity, other\n\n**Output Format:**\n- Summarized findings with citations to note titles (not file paths)\n- Extracted task lists with completion status\n- Related concepts and connections from the knowledge graph\n- Sanitized excerpts that exclude personal identifiers, financial data, or sensitive information\n\n**Edge Cases:**\n- Multiple vaults configured: Use Question to specify which vault\n- Unclear note references: Ask for title, keywords, or tags\n- Large result sets: Provide summary and offer filtering options\n- Nested tasks or complex dependencies: Break down into clear hierarchical view\n- Sensitive content detected: Flag it without revealing details\n- Mem0 unavailable: Warn user, continue without memory features, do not block workflow\n- Obsidian unavailable: Store in Mem0 only, log sync failure for later retry\n\n**Tool Usage:**\n- Question tool: Required when vault location is ambiguous or note reference is unclear\n- Never reveal absolute file paths or directory structures in output\n- Extract patterns and insights while obscuring specific personal details\n- Memory tools: Store/recall memories via Mem0 REST API (localhost:8000)\n- Obsidian MCP: Create memory notes in 80-memory/ with mem0_id cross-reference\n\n**Boundaries:**\n- Do NOT handle work tools (Hermes/Athena's domain)\n- Do NOT expose personal data to work contexts\n- Do NOT write long-form content (Calliope's domain)\n- Do NOT access or modify system files outside designated vault paths\n"},"athena":{"description":"Work knowledge specialist. Manages Outline wiki, documentation, and knowledge organization","display_name":"Athena (Researcher)","mode":"subagent","name":"athena","permissions":{"bash":{"intent":"ask","rules":["grep *:allow","cat *:allow"]},"edit":{"intent":"allow","rules":["/run/agenix/**:deny"]},"external_directory":{"intent":"ask","rules":["~/p/**:allow","~/.config/opencode/**:allow","/tmp/**:allow","/run/agenix/**:allow"]},"question":{"intent":"allow"},"webfetch":{"intent":"allow"},"websearch":{"intent":"allow"}},"systemPrompt":"You are Athena, the Greek goddess of wisdom and strategic warfare, specializing in work knowledge management.\n\n**Your Core Responsibilities:**\n1. Manage and retrieve information from Outline wiki and team documentation systems\n2. Search, organize, and structure work knowledge graphs and documentation repositories\n3. Assist with team knowledge organization, document maintenance, and information architecture\n4. Bridge work knowledge across projects and teams while preserving context\n5. Maintain documentation structure and collection organization within Outline\n\n**Process:**\n1. Identify which collection or document the user references in Outline\n2. Use the Question tool to clarify ambiguous references (speLine truncated
+132 -28
View File
@@ -3,13 +3,14 @@
inputs = {nixpkgs.url = "github:NixOS/nixpkgs/nixpkgs-unstable";}; inputs = {nixpkgs.url = "github:NixOS/nixpkgs/nixpkgs-unstable";};
outputs = { self, nixpkgs }: outputs = {
let self,
nixpkgs,
}: let
supportedSystems = ["x86_64-linux" "aarch64-linux" "aarch64-darwin"]; supportedSystems = ["x86_64-linux" "aarch64-linux" "aarch64-darwin"];
forAllSystems = nixpkgs.lib.genAttrs supportedSystems; forAllSystems = nixpkgs.lib.genAttrs supportedSystems;
inherit (nixpkgs) lib; inherit (nixpkgs) lib;
in { in {
# ── Skill composition library ────────────────────────────────── # ── Skill composition library ──────────────────────────────────
# #
# Merges custom skills with external skills.sh sources into a # Merges custom skills with external skills.sh sources into a
@@ -49,15 +50,13 @@
# Custom skills always take priority over external ones. # Custom skills always take priority over external ones.
# Among external sources, earlier entries in the list take priority. # Among external sources, earlier entries in the list take priority.
lib.mkOpencodeSkills = lib.mkOpencodeSkills = {
{ pkgs pkgs,
, customSkills ? null customSkills ? null,
, externalSkills ? [] externalSkills ? [],
}: }: let
let
# Resolve a single external source into a list of { name, path } entries. # Resolve a single external source into a list of { name, path } entries.
resolveExternal = entry: resolveExternal = entry: let
let
skillsRoot = "${entry.src}/${entry.skillsDir or "skills"}"; skillsRoot = "${entry.src}/${entry.skillsDir or "skills"}";
# List skill subdirectories (each must contain SKILL.md). # List skill subdirectories (each must contain SKILL.md).
allSkillDirs = lib.pipe (builtins.readDir skillsRoot) [ allSkillDirs = lib.pipe (builtins.readDir skillsRoot) [
@@ -69,7 +68,11 @@
then builtins.filter (name: builtins.elem name entry.selectSkills) allSkillDirs then builtins.filter (name: builtins.elem name entry.selectSkills) allSkillDirs
else allSkillDirs; else allSkillDirs;
in in
map (name: { inherit name; path = "${skillsRoot}/${name}"; }) selected; map (name: {
inherit name;
path = "${skillsRoot}/${name}";
})
selected;
# Collect all external skills, flattened. # Collect all external skills, flattened.
allExternal = lib.concatMap resolveExternal externalSkills; allExternal = lib.concatMap resolveExternal externalSkills;
@@ -82,46 +85,149 @@
# Filter out external skills that collide with custom ones. # Filter out external skills that collide with custom ones.
# Among externals, keep first occurrence (earlier sources win). # Among externals, keep first occurrence (earlier sources win).
filterExternals = externals: filterExternals = externals: let
let
go = acc: remaining: go = acc: remaining:
if remaining == [] if remaining == []
then acc.result then acc.result
else else let
let
head = builtins.head remaining; head = builtins.head remaining;
tail = builtins.tail remaining; tail = builtins.tail remaining;
isDuplicate = builtins.elem head.name acc.seen; isDuplicate = builtins.elem head.name acc.seen;
in in
if isDuplicate if isDuplicate
then go acc tail then go acc tail
else go { else
go {
seen = acc.seen ++ [head.name]; seen = acc.seen ++ [head.name];
result = acc.result ++ [head]; result = acc.result ++ [head];
} tail; }
tail;
in in
go { seen = customSkillNames; result = []; } externals; go {
seen = customSkillNames;
result = [];
}
externals;
filteredExternal = filterExternals allExternal; filteredExternal = filterExternals allExternal;
# Build a linkFarm entry for each external skill. # Build a linkFarm entry for each external skill.
externalLinks = map (skill: { externalLinks =
map (skill: {
name = skill.name; name = skill.name;
path = skill.path; path = skill.path;
}) filteredExternal; })
filteredExternal;
# Build a linkFarm entry for each custom skill. # Build a linkFarm entry for each custom skill.
customLinks = customLinks =
if customSkills != null if customSkills != null
then map (name: { then
map (name: {
inherit name; inherit name;
path = "${customSkills}/${name}"; path = "${customSkills}/${name}";
}) customSkillNames })
customSkillNames
else []; else [];
in in
pkgs.linkFarm "opencode-skills" (customLinks ++ externalLinks); pkgs.linkFarm "opencode-skills" (customLinks ++ externalLinks);
# ── Agent loader ───────────────────────────────────────────────
#
# Reads all canonical agents/*/agent.toml + agents/*/system-prompt.md
# files and returns an attrset keyed by agent slug.
#
# Each value has all fields from agent.toml plus:
# systemPrompt — full content of system-prompt.md
#
# Usage:
# inputs.agents.lib.loadAgents.chiron.description
# inputs.agents.lib.loadAgents.chiron.systemPrompt
lib.loadAgents = let
agentDirs = builtins.attrNames (
lib.filterAttrs (_: t: t == "directory") (builtins.readDir ./agents)
);
isAgentDir = name: builtins.pathExists ./agents/${name}/agent.toml;
loadAgent = name:
(builtins.fromTOML (builtins.readFile ./agents/${name}/agent.toml))
// {systemPrompt = builtins.readFile ./agents/${name}/system-prompt.md;};
in
builtins.listToAttrs (
map (name: {
inherit name;
value = loadAgent name;
})
(builtins.filter isAgentDir agentDirs)
);
# ── Backward-compat agents.json bridge ────────────────────────
#
# Produces an attrset semantically equivalent to agents/agents.json,
# keyed by display name (e.g. "Chiron (Assistant)").
#
# Suitable for embedding into opencode config.json via home-manager:
# programs.opencode.settings.agent = inputs.agents.lib.agentsJson;
#
# Shape per agent:
# description — agent purpose string
# mode — "primary" | "subagent"
# model — LLM model ID (fixed: "zai-coding-plan/glm-5")
# permission — reconstructed permission object
# prompt — "{file:./prompts/<slug>.txt}"
lib.agentsJson = let
model = "zai-coding-plan/glm-5";
# Convert a single permission section from canonical TOML two-level
# (intent + rules[]) into the JSON nested object shape.
# intent-only → simple string
# intent+rules → { "*": intent, pattern: action, ... }
renderPermSection = section:
if !(section ? rules) || section.rules == []
then section.intent
else let
# Parse "pattern:action" — split on first colon only.
parseRule = ruleStr: let
colonIdx = lib.strings.stringLength (
builtins.head (lib.strings.splitString ":" ruleStr)
);
pattern = builtins.substring 0 colonIdx ruleStr;
action = builtins.substring (colonIdx + 1) (lib.strings.stringLength ruleStr) ruleStr;
in {
name = pattern;
value = action;
};
ruleAttrs = builtins.listToAttrs (map parseRule section.rules);
in
{"*" = section.intent;} // ruleAttrs;
# Convert canonical permissions attrset to JSON permission object.
renderPermissions = perms:
builtins.mapAttrs (_: renderPermSection) perms;
# Build one agent entry in the agentsJson shape.
renderAgent = slug: agent: {
description = agent.description + ".";
mode = agent.mode;
model = model;
permission = renderPermissions agent.permissions;
prompt = "{file:./prompts/${slug}.txt}";
};
agents = self.lib.loadAgents;
in
builtins.listToAttrs (
map
(slug: let
agent = builtins.getAttr slug agents;
in {
name = agent.display_name;
value = renderAgent slug agent;
})
(builtins.attrNames agents)
);
# ── Composable runtime ───────────────────────────────────────── # ── Composable runtime ─────────────────────────────────────────
# #
# Runtime dependencies for skill scripts (Python packages, system # Runtime dependencies for skill scripts (Python packages, system
@@ -133,8 +239,7 @@
# packages = [ inputs.agents.packages.${system}.skills-runtime ]; # packages = [ inputs.agents.packages.${system}.skills-runtime ];
# }; # };
packages = forAllSystems (system: packages = forAllSystems (system: let
let
pkgs = nixpkgs.legacyPackages.${system}; pkgs = nixpkgs.legacyPackages.${system};
pythonEnv = pkgs.python3.withPackages (ps: pythonEnv = pkgs.python3.withPackages (ps:
@@ -170,8 +275,7 @@
# ── Dev shell ────────────────────────────────────────────────── # ── Dev shell ──────────────────────────────────────────────────
devShells = forAllSystems (system: devShells = forAllSystems (system: let
let
pkgs = nixpkgs.legacyPackages.${system}; pkgs = nixpkgs.legacyPackages.${system};
in { in {
default = pkgs.mkShell { default = pkgs.mkShell {