Personal AI, On Personal Devices
Python
"""Load system prompt and few-shot overrides from $OPENJARVIS_HOME.
LLM-guided spec search (M1) proposes edits that get written to disk by appliers.
This module lets agents pick those overrides up at runtime:
- System prompts: ``$OPENJARVIS_HOME/agents/{name}/system_prompt.md``
- Few-shot exemplars: ``$OPENJARVIS_HOME/agents/{name}/few_shot.json``
Override files are templates — they may contain ``{tool_descriptions}`` and
other format placeholders that the agent fills in via ``.format()``, exactly
like the hardcoded constants.
"""
from __future__ import annotations
import json
import logging
from pathlib import Path
from typing import Any
from openjarvis.core.paths import get_config_dir
logger = logging.getLogger(__name__)
def _openjarvis_home() -> Path:
"""Resolve the OpenJarvis root, honoring OPENJARVIS_HOME / XDG_DATA_HOME."""
return get_config_dir()
def load_system_prompt_override(agent_name: str) -> str | None:
"""Return the override prompt for *agent_name*, or ``None``.
Looks for ``$OPENJARVIS_HOME/agents/<agent_name>/system_prompt.md``.
``OPENJARVIS_HOME`` defaults to ``~/.openjarvis`` when unset.
"""
home = _openjarvis_home()
prompt_path = home / "agents" / agent_name / "system_prompt.md"
if not prompt_path.exists():
return None
try:
content = prompt_path.read_text(encoding="utf-8")
logger.info(
"Loaded system prompt override for %s from %s", agent_name, prompt_path
)
return content
except Exception:
logger.warning(
"Failed to read system prompt override at %s", prompt_path, exc_info=True
)
return None
def load_few_shot_exemplars(
agent_name: str,
) -> list[dict[str, Any]]:
"""Return few-shot exemplars for *agent_name*, or empty list.
Looks for ``$OPENJARVIS_HOME/agents/<agent_name>/few_shot.json``.
Expected format: ``[{"input": "Q", "output": "A"}, ...]``.
"""
home = _openjarvis_home()
fs_path = home / "agents" / agent_name / "few_shot.json"
if not fs_path.exists():
return []
try:
data = json.loads(fs_path.read_text(encoding="utf-8"))
if not isinstance(data, list):
logger.warning("few_shot.json for %s is not a list", agent_name)
return []
logger.info(
"Loaded %d few-shot exemplars for %s from %s",
len(data),
agent_name,
fs_path,
)
return data
except Exception:
logger.warning(
"Failed to read few-shot exemplars at %s",
fs_path,
exc_info=True,
)
return []