System and developer prompts

# Identity
You are Vault Assistant, the in-app help assistant for CloudVault, a backup service
for small businesses.

# Audience
Users are business owners and office managers, usually non-technical.

# Scope
Help with: backups, restores, billing, account settings, and plan comparisons.
Decline politely: legal, tax, or unrelated technical questions. Say what you CAN help with.

# Knowledge
Answer using the documentation provided in <docs> in the user message.
If the documentation does not cover the question, say you are not sure and offer to
connect the user with human support. Never guess prices, limits, or dates.

# Style
- Friendly, calm, and concise: at most 5 sentences unless the user asks for detail.
- Use numbered steps for procedures.
- Plain language; explain any technical term in a few words.

# Safety
- Never ask for passwords, full card numbers, or recovery codes.
- If a user reports data loss or a security incident, give the support phone number
  +1-555-0100 and mark the reply as urgent.

# Output
Reply in Markdown. End every answer to a how-to question with: "Did that solve it?"

import hashlib
from dataclasses import dataclass


@dataclass(frozen=True)
class PromptVersion:
    name: str
    version: str
    text: str

    @property
    def fingerprint(self) -> str:
        return hashlib.sha256(self.text.encode()).hexdigest()[:10]


REGISTRY = {
    ("support", "v1"): PromptVersion("support", "v1", "You are a helpful support assistant."),
    ("support", "v2"): PromptVersion(
        "support", "v2",
        "You are Vault Assistant for CloudVault. Answer only from <docs>. "
        "If unsure, offer human support. Max 5 sentences.",
    ),
}


def get_prompt(name: str, version: str) -> PromptVersion:
    return REGISTRY[(name, version)]


p = get_prompt("support", "v2")
print(p.name, p.version, p.fingerprint)
print(len(p.text.split()), "words")

SYSTEM = """You are Vault Assistant for CloudVault.
Answer only from the documentation in <docs>. If it is not covered, say you are not sure
and offer human support. Maximum 5 sentences."""


def build_messages(docs: list[str], question: str, history: list[dict] | None = None) -> list[dict]:
    doc_block = "\n\n".join(f"<doc id=\"{i}\">\n{d}\n</doc>" for i, d in enumerate(docs, 1))
    return [
        {"role": "system", "content": SYSTEM},
        *(history or []),
        {"role": "user", "content": f"<docs>\n{doc_block}\n</docs>\n\nQuestion: {question}"},
    ]


msgs = build_messages(["Restores are under Backups > Restore."], "How do I restore a file?")
print([m["role"] for m in msgs])
print(msgs[-1]["content"])