Skip to content

prompt_loader

prompt_loader

Load system prompt and few-shot overrides from $OPENJARVIS_HOME.

Distillation (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.

Functions

load_system_prompt_override 

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.

Source code in src/openjarvis/agents/prompt_loader.py 
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
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

load_few_shot_exemplars 

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"}, ...].

Source code in src/openjarvis/agents/prompt_loader.py 
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
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 []