feat: add persona runtime demo with multiple personas

demos/persona_agent_demo.py

@@ -0,0 +1,32 @@
+from __future__ import annotations
+
+import sys
+from pathlib import Path
+
+PROJECT_ROOT = Path(__file__).resolve().parents[1]
+if str(PROJECT_ROOT) not in sys.path:
+    sys.path.insert(0, str(PROJECT_ROOT))
+
+from pop.persona_loader import load_all_personas
+
+
+def run_demo() -> None:
+    personas = load_all_personas(
+        names=[
+            "design_persona.json",
+            "researcher_persona.json",
+            "marketing_persona.json",
+        ]
+    )
+
+    print("Loaded personas:")
+    print("----------------")
+
+    for persona in personas:
+        print(persona.summary())
+        print(" skills:", ", ".join(persona.skills))
+        print()
+
+
+if __name__ == "__main__":
+    run_demo()

personas/marketing_persona.json

@@ -0,0 +1,14 @@
+{
+  "name": "Marketing Persona",
+  "role": "Marketing Manager",
+  "description": "Focuses on messaging, positioning, and audience engagement.",
+  "skills": [
+    "copywriting",
+    "campaign design",
+    "product positioning"
+  ],
+  "preferred_tools": [
+    "analytics",
+    "social media"
+  ]
+}

personas/researcher_persona.json

@@ -0,0 +1,14 @@
+{
+  "name": "Research Persona",
+  "role": "Researcher",
+  "description": "Specialized in gathering information and producing concise research summaries.",
+  "skills": [
+    "literature search",
+    "information synthesis",
+    "technical explanation"
+  ],
+  "preferred_tools": [
+    "web search",
+    "academic databases"
+  ]
+}

pop/persona_loader.py

@@ -0,0 +1,35 @@
+from __future__ import annotations
+
+import json
+from pathlib import Path
+from typing import Any
+
+
+class Persona:
+    def __init__(self, data: dict[str, Any]) -> None:
+        self.name = data.get("name")
+        self.role = data.get("role")
+        self.description = data.get("description")
+        self.skills = data.get("skills", [])
+        self.tools = data.get("preferred_tools", [])
+
+    def summary(self) -> str:
+        return f"{self.name} ({self.role})"
+
+
+def load_persona(path: str | Path) -> Persona:
+    persona_path = Path(path)
+    with persona_path.open(encoding="utf-8") as file:
+        data = json.load(file)
+    return Persona(data)
+
+
+def load_all_personas(
+    folder: str | Path = "personas",
+    names: list[str] | None = None,
+) -> list[Persona]:
+    folder_path = Path(folder)
+    persona_paths = sorted(folder_path.glob("*.json"))
+    if names is not None:
+        persona_paths = [folder_path / name for name in names]
+    return [load_persona(path) for path in persona_paths]