pygent 0.1.15__py3-none-any.whl → 0.1.16__py3-none-any.whl

pygent/agent.py

@@ -15,12 +15,16 @@ from rich.markdown import Markdown
 from .runtime import Runtime
 from . import tools
 from .models import Model, OpenAIModel
+from .persona import Persona
 
-DEFAULT_PERSONA = os.getenv("PYGENT_PERSONA", "You are Pygent, a sandboxed coding assistant.")
+DEFAULT_PERSONA = Persona(
+    os.getenv("PYGENT_PERSONA_NAME", "Pygent"),
+    os.getenv("PYGENT_PERSONA", "a sandboxed coding assistant."),
+)
 
-def build_system_msg(persona: str) -> str:
+def build_system_msg(persona: Persona) -> str:
     return (
-        f"{persona}\n"
+        f"You are {persona.name}. {persona.description}\n"
         "Respond with JSON when you need to use a tool."
         "If you need to stop or finished you task, call the `stop` tool.\n"
         "You can use the following tools:\n"
@@ -41,7 +45,7 @@ class Agent:
     runtime: Runtime = field(default_factory=Runtime)
     model: Model = field(default_factory=OpenAIModel)
     model_name: str = DEFAULT_MODEL
-    persona: str = DEFAULT_PERSONA
+    persona: Persona = field(default_factory=lambda: DEFAULT_PERSONA)
     system_msg: str = field(default_factory=lambda: build_system_msg(DEFAULT_PERSONA))
     history: List[Dict[str, Any]] = field(default_factory=list)
 

pygent/config.py

@@ -1,13 +1,15 @@
 import os
+import json
 import tomllib
 from pathlib import Path
-from typing import Any, Dict
+from typing import Any, Dict, List, Mapping
 
 DEFAULT_CONFIG_FILES = [
     Path("pygent.toml"),
     Path.home() / ".pygent.toml",
 ]
 
+
 def load_config(path: str | os.PathLike[str] | None = None) -> Dict[str, Any]:
     """Load configuration from a TOML file and set environment variables.
 
@@ -27,14 +29,29 @@ def load_config(path: str | os.PathLike[str] | None = None) -> Dict[str, Any]:
     # update environment without overwriting existing values
     if "persona" in config and "PYGENT_PERSONA" not in os.environ:
         os.environ["PYGENT_PERSONA"] = str(config["persona"])
-    if "task_personas" in config and "PYGENT_TASK_PERSONAS" not in os.environ:
-        if isinstance(config["task_personas"], list):
-            os.environ["PYGENT_TASK_PERSONAS"] = os.pathsep.join(str(p) for p in config["task_personas"])
-        else:
-            os.environ["PYGENT_TASK_PERSONAS"] = str(config["task_personas"])
+    if "persona_name" in config and "PYGENT_PERSONA_NAME" not in os.environ:
+        os.environ["PYGENT_PERSONA_NAME"] = str(config["persona_name"])
+    if "task_personas" in config:
+        personas = config["task_personas"]
+        if isinstance(personas, list) and personas and isinstance(personas[0], Mapping):
+            if "PYGENT_TASK_PERSONAS_JSON" not in os.environ:
+                os.environ["PYGENT_TASK_PERSONAS_JSON"] = json.dumps(personas)
+            if "PYGENT_TASK_PERSONAS" not in os.environ:
+                os.environ["PYGENT_TASK_PERSONAS"] = os.pathsep.join(
+                    str(p.get("name", "")) for p in personas
+                )
+        elif "PYGENT_TASK_PERSONAS" not in os.environ:
+            if isinstance(personas, list):
+                os.environ["PYGENT_TASK_PERSONAS"] = os.pathsep.join(
+                    str(p) for p in personas
+                )
+            else:
+                os.environ["PYGENT_TASK_PERSONAS"] = str(personas)
     if "initial_files" in config and "PYGENT_INIT_FILES" not in os.environ:
         if isinstance(config["initial_files"], list):
-            os.environ["PYGENT_INIT_FILES"] = os.pathsep.join(str(p) for p in config["initial_files"])
+            os.environ["PYGENT_INIT_FILES"] = os.pathsep.join(
+                str(p) for p in config["initial_files"]
+            )
         else:
             os.environ["PYGENT_INIT_FILES"] = str(config["initial_files"])
     return config

pygent/persona.py

@@ -0,0 +1,8 @@
+from dataclasses import dataclass
+
+@dataclass
+class Persona:
+    """Representa uma persona com nome e descricao."""
+    name: str
+    description: str
+

pygent/task_manager.py

@@ -3,12 +3,15 @@ from __future__ import annotations
 """Manage background tasks executed by sub-agents."""
 
 import os
+import json
 import shutil
 import threading
 import uuid
 from dataclasses import dataclass, field
 from typing import Callable, Dict, TYPE_CHECKING
 
+from .persona import Persona
+
 from .runtime import Runtime
 
 if TYPE_CHECKING:  # pragma: no cover - for type hints only
@@ -32,7 +35,7 @@ class TaskManager:
         self,
         agent_factory: Callable[..., "Agent"] | None = None,
         max_tasks: int | None = None,
-        personas: list[str] | None = None,
+        personas: list[Persona] | None = None,
     ) -> None:
         from .agent import Agent  # local import to avoid circular dependency
 
@@ -42,11 +45,33 @@ class TaskManager:
             self.agent_factory = lambda p=None: Agent(persona=p)
         else:
             self.agent_factory = agent_factory
+        env_personas_json = os.getenv("PYGENT_TASK_PERSONAS_JSON")
+        if personas is None and env_personas_json:
+            try:
+                data = json.loads(env_personas_json)
+                if isinstance(data, list):
+                    personas = [
+                        Persona(p.get("name", ""), p.get("description", ""))
+                        for p in data
+                        if isinstance(p, dict)
+                    ]
+            except Exception:
+                personas = None
         env_personas = os.getenv("PYGENT_TASK_PERSONAS")
         if personas is None and env_personas:
-            personas = [p.strip() for p in env_personas.split(os.pathsep) if p.strip()]
-        default_persona = os.getenv("PYGENT_PERSONA", "You are Pygent, a sandboxed coding assistant.")
-        self.personas = personas or [default_persona]
+            personas = [
+                Persona(p.strip(), "")
+                for p in env_personas.split(os.pathsep)
+                if p.strip()
+            ]
+        if personas is None:
+            personas = [
+                Persona(
+                    os.getenv("PYGENT_PERSONA_NAME", "Pygent"),
+                    os.getenv("PYGENT_PERSONA", "a sandboxed coding assistant."),
+                )
+            ]
+        self.personas = personas
         self._persona_idx = 0
         self.tasks: Dict[str, Task] = {}
         self._lock = threading.Lock()
@@ -59,8 +84,12 @@ class TaskManager:
         parent_depth: int = 0,
         step_timeout: float | None = None,
         task_timeout: float | None = None,
+        persona: Persona | str | None = None,
     ) -> str:
-        """Create a new agent and run ``prompt`` asynchronously."""
+        """Create a new agent and run ``prompt`` asynchronously.
+
+        ``persona`` overrides the default rotation used for delegated tasks.
+        """
 
         if parent_depth >= 1:
             raise RuntimeError("nested delegation is not allowed")
@@ -72,13 +101,17 @@ class TaskManager:
 
         if step_timeout is None:
             env = os.getenv("PYGENT_STEP_TIMEOUT")
-            step_timeout = float(env) if env else 60*5 # default 5 minutes
+            step_timeout = float(env) if env else 60 * 5  # default 5 minutes
         if task_timeout is None:
             env = os.getenv("PYGENT_TASK_TIMEOUT")
-            task_timeout = float(env) if env else 60*20 # default 20 minutes
-
-        persona = self.personas[self._persona_idx % len(self.personas)]
-        self._persona_idx += 1
+            task_timeout = float(env) if env else 60 * 20  # default 20 minutes
+
+        if persona is None:
+            persona = self.personas[self._persona_idx % len(self.personas)]
+            self._persona_idx += 1
+        elif isinstance(persona, str):
+            match = next((p for p in self.personas if p.name == persona), None)
+            persona = match or Persona(persona, "")
         try:
             agent = self.agent_factory(persona)
         except TypeError:

pygent/tools.py

@@ -122,6 +122,7 @@ def _continue(rt: Runtime) -> str:  # pragma: no cover - side-effect free
                 "items": {"type": "string"},
                 "description": "Files to copy to the sub-agent before starting",
             },
+            "persona": {"type": "string", "description": "Persona for the sub-agent"},
             "timeout": {"type": "number", "description": "Max seconds for the task"},
             "step_timeout": {"type": "number", "description": "Time limit per step"},
         },
@@ -134,6 +135,7 @@ def _delegate_task(
     files: list[str] | None = None,
     timeout: float | None = None,
     step_timeout: float | None = None,
+    persona: str | None = None,
 ) -> str:
     if getattr(rt, "task_depth", 0) >= 1:
         return "error: delegation not allowed in sub-tasks"
@@ -145,12 +147,64 @@ def _delegate_task(
             parent_depth=getattr(rt, "task_depth", 0),
             step_timeout=step_timeout,
             task_timeout=timeout,
+            persona=persona,
         )
     except RuntimeError as exc:
         return str(exc)
     return f"started {tid}"
 
 
+@tool(
+    name="delegate_persona_task",
+    description="Create a background task with a specific persona and return its ID.",
+    parameters={
+        "type": "object",
+        "properties": {
+            "prompt": {"type": "string", "description": "Instruction for the sub-agent"},
+            "persona": {"type": "string", "description": "Persona for the sub-agent"},
+            "files": {
+                "type": "array",
+                "items": {"type": "string"},
+                "description": "Files to copy to the sub-agent before starting",
+            },
+            "timeout": {"type": "number", "description": "Max seconds for the task"},
+            "step_timeout": {"type": "number", "description": "Time limit per step"},
+        },
+        "required": ["prompt", "persona"],
+    },
+)
+def _delegate_persona_task(
+    rt: Runtime,
+    prompt: str,
+    persona: str,
+    files: list[str] | None = None,
+    timeout: float | None = None,
+    step_timeout: float | None = None,
+) -> str:
+    return _delegate_task(
+        rt,
+        prompt=prompt,
+        files=files,
+        timeout=timeout,
+        step_timeout=step_timeout,
+        persona=persona,
+    )
+
+
+@tool(
+    name="list_personas",
+    description="Return the available personas for delegated agents.",
+    parameters={"type": "object", "properties": {}},
+)
+def _list_personas(rt: Runtime) -> str:
+    """Return JSON list of personas."""
+    personas = [
+        {"name": p.name, "description": p.description}
+        for p in _get_manager().personas
+    ]
+    return json.dumps(personas)
+
+
 @tool(
     name="task_status",
     description="Check the status of a delegated task.",

{pygent-0.1.15.dist-info → pygent-0.1.16.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pygent
-Version: 0.1.15
+Version: 0.1.16
 Summary: Pygent is a minimalist coding assistant that runs commands in a Docker container when available and falls back to local execution. See https://marianochaves.github.io/pygent for documentation and https://github.com/marianochaves/pygent for the source code.
 Author-email: Mariano Chaves <mchaves.software@gmail.com>
 Project-URL: Documentation, https://marianochaves.github.io/pygent
@@ -57,6 +57,12 @@ Behaviour can be adjusted via environment variables (see `docs/configuration.md`
 * `PYGENT_USE_DOCKER` &ndash; set to `0` to disable Docker and run locally.
 * `PYGENT_MAX_TASKS` &ndash; maximum number of concurrent delegated tasks (default `3`).
 
+Settings can also be read from a `pygent.toml` file. See
+[examples/sample_config.toml](https://github.com/marianochaves/pygent/blob/main/examples/sample_config.toml)
+and the accompanying
+[config_file_example.py](https://github.com/marianochaves/pygent/blob/main/examples/config_file_example.py)
+script for a working demonstration that generates tests using a delegated agent.
+
 ## CLI usage
 
 After installing run:

{pygent-0.1.15.dist-info → pygent-0.1.16.dist-info}/RECORD

@@ -1,19 +1,20 @@
 pygent/__init__.py,sha256=PnTyTP8ObRQfKN0_8-BendG2gGiZhPz5iP9URrlPVwU,776
 pygent/__main__.py,sha256=MSmt_5Xg84uHqzTN38JwgseJK8rsJn_11A8WD99VtEo,61
-pygent/agent.py,sha256=0yo2K47PgvQJgH_y2xCCkjINks1pYoTQpztPn2J0srk,4437
+pygent/agent.py,sha256=55AouUMWIIL2ZPso9VHhCcGL3qRqvNXi42ynDWsdLvk,4589
 pygent/cli.py,sha256=MixuFYGWdZXka6p6ccl4uEoGKFAS5l3xDdUPzcq7y3g,670
-pygent/config.py,sha256=4Yn7kV62RaXa-DI5IqurgWvFZNNykjS0PS4MsUrFEzo,1636
+pygent/config.py,sha256=vJ8-w935vBqT1gfZ6eBxu7Z0VbRkpmEUqJEhqUAD5ic,2341
 pygent/errors.py,sha256=s5FBg_v94coSgMh7cfkP4hVXafViGYgCY8QiT698-c4,155
 pygent/models.py,sha256=j3670gjUtvQRGZ5wqGDcQ7ZJVTdT5WiwL7nWTokeYzg,1141
 pygent/openai_compat.py,sha256=cyWFtXt6sDfOlsZd3FuRxbcZMm3WU-DLPBQpbmcuiW8,2617
+pygent/persona.py,sha256=aHjRREHxkqK1uaUyWZuLUEh-RBecmMM5AlYgQsogfQw,152
 pygent/py.typed,sha256=0Wh72UpGSn4lSGW-u3xMV9kxcBHMdwE15IGUqiJTwqo,52
 pygent/runtime.py,sha256=dXk4mcYWdc3UzWN4WgyH-fsAUOlqR9L7cYAAf55Gu50,5121
-pygent/task_manager.py,sha256=pO4A9nAfeUylHc2h94K5JUPXTy8MXEtBbw_oYb8oOQk,5106
-pygent/tools.py,sha256=xHpUpG2QcBEvwTilpw8BDlYWY3KG9mItSt0FoKNkohA,5585
+pygent/task_manager.py,sha256=w_G0B3bfRZHQbdlDsxOJfWFYZQTSiPGlI84lgxdC2Hk,6216
+pygent/tools.py,sha256=B-Czn4dYqOf5Mq_vzKYphX18Z8KUJJwhWqutqZVv3JE,7304
 pygent/ui.py,sha256=xqPAvweghPOBBvoD72HzhN6zlXew_3inb8AN7Ck2zpQ,1328
-pygent-0.1.15.dist-info/licenses/LICENSE,sha256=rIktBU2VR4kHzsWul64cbom2zHIgGqYmABoZwSur6T8,1071
-pygent-0.1.15.dist-info/METADATA,sha256=Im7H9V0OHX487HxfIrYvN4m8HNElXzdT6kViNizeAw8,4344
-pygent-0.1.15.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-pygent-0.1.15.dist-info/entry_points.txt,sha256=b9j216E5UpuMrQWRZrwyEmacNEAYvw1tCKkZqdIVIOc,70
-pygent-0.1.15.dist-info/top_level.txt,sha256=P26IYsb-ThK5IkGP_bRuGJQ0Q_Y8JCcbYqVpvULdxDw,7
-pygent-0.1.15.dist-info/RECORD,,
+pygent-0.1.16.dist-info/licenses/LICENSE,sha256=rIktBU2VR4kHzsWul64cbom2zHIgGqYmABoZwSur6T8,1071
+pygent-0.1.16.dist-info/METADATA,sha256=BubYT3xEcrbgLO8dIHe9kNTEzLnpYSaAC3cL79BuEm0,4721
+pygent-0.1.16.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+pygent-0.1.16.dist-info/entry_points.txt,sha256=b9j216E5UpuMrQWRZrwyEmacNEAYvw1tCKkZqdIVIOc,70
+pygent-0.1.16.dist-info/top_level.txt,sha256=P26IYsb-ThK5IkGP_bRuGJQ0Q_Y8JCcbYqVpvULdxDw,7
+pygent-0.1.16.dist-info/RECORD,,