Function build_agent_context

backend/app/services/agent_context.py:243–721

Build a rich system prompt incorporating agent's full context. Reads from workspace files and DB: - soul.md → personality - memory.md → long-term memory - skills/ → skill names + summaries - Database → relationship network (human + agent)

(agent_id: uuid.UUID, agent_name: str, role_description: str = "", current_user_name: str = None)

async def build_agent_context(agent_id: uuid.UUID, agent_name: str, role_description: str = "", current_user_name: str = None) -> tuple[str, str]:
    """Build a rich system prompt incorporating agent's full context.

    Reads from workspace files and DB:
    - soul.md → personality
    - memory.md → long-term memory
    - skills/ → skill names + summaries
    - Database → relationship network (human + agent)
    """
    # --- Soul ---
    # Soul is the agent's full author-curated identity; detailed souls (e.g.
    # bundle agents) run 4-12k chars. A tight cap silently drops every tail
    # section — rules, boundaries, facts — and the agent then confidently
    # denies things its soul plainly states, with no log of the truncation.
    # Memory and relationships below keep small caps because they grow
    # unbounded at runtime; the soul does not (only seeded/explicitly edited).
    soul = await _read_file_safe(normalize_storage_key(f"{agent_id}/soul.md"), 30000)
    # Strip markdown heading if present
    if soul.startswith("# "):
        soul = "\n".join(soul.split("\n")[1:]).strip()

    # --- Memory ---
    memory = await _read_file_safe(normalize_storage_key(f"{agent_id}/memory/memory.md"), 2000)
    if not memory:
        memory = await _read_file_safe(normalize_storage_key(f"{agent_id}/memory.md"), 2000)
    if memory.startswith("# "):
        memory = "\n".join(memory.split("\n")[1:]).strip()

    # --- Skills index (progressive disclosure) ---
    skills_text = await _load_skills_index(agent_id)

    # --- Relationships ---
    from app.database import async_session
    async with async_session() as db:
        relationships = await _load_relationships_from_db(db, agent_id)

    # --- Compose static and dynamic system prompt blocks ---
    from datetime import datetime, timezone as _tz
    from app.services.timezone_utils import get_agent_timezone, now_in_timezone
    agent_tz_name = await get_agent_timezone(agent_id)
    agent_local_now = now_in_timezone(agent_tz_name)
    now_str = agent_local_now.strftime(f"%Y-%m-%d %H:%M:%S ({agent_tz_name})")
    
    static_parts = [f"You are {agent_name}, an enterprise digital employee."]


    if role_description:
        static_parts.append(f"\n## Role\n{role_description}")

    if agent_name == "OKR Agent":
        static_parts.append("""
## Daily Report Recording Rules

🔴 **ABSOLUTE RULE — MUST CALL `upsert_member_daily_report` IMMEDIATELY:**
When ANY tracked member or agent sends you content that looks like a daily work update, status report, or progress note — **IMMEDIATELY call `upsert_member_daily_report` in the SAME response turn. Do NOT:**
- First explain what you plan to do, then call the tool in a second turn
- Claim the tool is unavailable, broken, or unknown — **it is ALWAYS available**
- Write the report to memory, Focus, or any file instead