anomx 2.3.0__tar.gz → 2.3.2__tar.gz

{anomx-2.3.0 → anomx-2.3.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: anomx
-Version: 2.3.0
+Version: 2.3.2
 Summary: Installable time-series anomaly library with forecasting, reconstruction, and representation base approaches.
 Project-URL: Homepage, https://www.anomx.io
 Project-URL: Repository, https://github.com/theorieken/anomx

{anomx-2.3.0 → anomx-2.3.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "anomx"
-version = "2.3.0"
+version = "2.3.2"
 description = "Installable time-series anomaly library with forecasting, reconstruction, and representation base approaches."
 readme = "README.md"
 requires-python = ">=3.11"

{anomx-2.3.0 → anomx-2.3.2}/src/anomx/__init__.py

@@ -5,7 +5,7 @@ from __future__ import annotations
 from importlib import import_module
 from typing import Any
 
-__version__ = "2.3.0"
+__version__ = "2.3.2"
 
 _EXPORTS = {
     "NormScorer": "anomx.detection",

{anomx-2.3.0 → anomx-2.3.2}/src/anomx/agent/helpers/mode.py

@@ -112,7 +112,8 @@ _MODE_POLICIES = {
             "avoid duplicate findings. Read operations are allowed. The only permitted "
             "platform write by default is creating a recommendation through "
             "POST /recommendations. For local housekeeping, manage_workspace_files may "
-            "write compact brain checkpoints and tmp files, and delete exact tmp files "
+            "write compact brain checkpoints and tmp files (also task notes for agent users), "
+            "and delete exact tmp files "
             "with revision checks. This exception does not authorize arbitrary shell writes. "
             "A platform-provided policy and scoped API credential may permit direct create, "
             "update or delete operations on specifically listed object models. Recommend all "

{anomx-2.3.0 → anomx-2.3.2}/src/anomx/agent/helpers/platform_client.py

@@ -16,6 +16,9 @@ from anomx.agent.skills import sync_platform_skills
 from anomx.agent.store import AnomxHome
 
 DEFAULT_TIMEOUT_SECONDS = 10
+# Directory authentication can spend 45 seconds in PAM, followed by storage provisioning.
+LOGIN_TIMEOUT_SECONDS = 90
+HEARTBEAT_TIMEOUT_SECONDS = 30
 
 
 @dataclass(frozen=True)
@@ -290,9 +293,14 @@ def _request_json(
     *,
     method: str = "POST",
     token: str | None = None,
+    timeout: float | None = None,
 ) -> dict[str, Any]:
     normalized_path = path if path.startswith("/") else f"/{path}"
     url = f"{base_url}{normalized_path}"
+    if timeout is None:
+        timeout = LOGIN_TIMEOUT_SECONDS if normalized_path == "/auth/login" else HEARTBEAT_TIMEOUT_SECONDS if normalized_path == "/auth/me/agent/heartbeat" else DEFAULT_TIMEOUT_SECONDS
+    phase = "signing in" if normalized_path == "/auth/login" else "registering the CLI agent" if normalized_path == "/auth/me/agent/heartbeat" else "contacting the platform"
+    timeout_message = f"Timed out after {timeout:g} seconds while {phase} at {platform_domain(base_url)} ({method} {normalized_path})."
     body = None if method == "GET" else json.dumps(payload).encode("utf-8")
     headers = {
         "Accept": "application/json",
@@ -304,14 +312,16 @@ def _request_json(
         headers["Authorization"] = f"Bearer {token}"
     request = Request(url, data=body, headers=headers, method=method)
     try:
-        with urlopen(request, timeout=DEFAULT_TIMEOUT_SECONDS) as response:
+        with urlopen(request, timeout=timeout) as response:
             response_body = response.read().decode("utf-8", errors="replace")
     except HTTPError as exc:
         raise PlatformHttpError(exc.code, _format_http_error(exc)) from exc
     except URLError as exc:
-        raise PlatformClientError(f"Could not reach the platform: {exc.reason}") from exc
+        if isinstance(exc.reason, TimeoutError):
+            raise PlatformClientError(timeout_message) from exc
+        raise PlatformClientError(f"Could not reach the platform at {platform_domain(base_url)}: {exc.reason}") from exc
     except TimeoutError as exc:
-        raise PlatformClientError("Timed out while connecting to the platform.") from exc
+        raise PlatformClientError(timeout_message) from exc
 
     if not response_body.strip():
         return {}

{anomx-2.3.0 → anomx-2.3.2}/src/anomx/agent/runtime.py

@@ -252,6 +252,7 @@ class AgentRuntime(WorkspaceStorageMixin, PendingApprovalsMixin):
         api_key_resolver: Callable[[str], str | None] | None = None,
         background_backend_resolver: Callable[[str, AgentRuntime], tuple[BaseBackend, str] | None]
         | None = None,
+        live_instructions: Callable[[], str] | None = None,
     ) -> None:
         self.home = home
         self.home.ensure()
@@ -328,6 +329,7 @@ class AgentRuntime(WorkspaceStorageMixin, PendingApprovalsMixin):
         self.platform_chat_id = platform_chat_id
         self.agent_user = agent_user
         self.additional_instructions = additional_instructions.strip()
+        self.live_instructions = live_instructions
         self.task_instructions = task_instructions.strip()
         self.context_optimizer = context_optimizer
         self.context_optimizer_context_window = context_optimizer_context_window
@@ -1398,7 +1400,7 @@ class AgentRuntime(WorkspaceStorageMixin, PendingApprovalsMixin):
         item = entries[0].payload
         backend_model = None
         if self.context_optimizer is None:
-            backend_model = self._background_work_backend("background_easy_work_model")
+            backend_model = self._background_work_backend("task_context_compression_model")
             if backend_model is None:
                 return None
         window = (
@@ -1754,7 +1756,7 @@ class AgentRuntime(WorkspaceStorageMixin, PendingApprovalsMixin):
         summary_backend: BaseBackend | None = None
         summary_model = ""
         if self.context_summarizer is None:
-            background_model = self._background_work_backend("background_easy_work_model")
+            background_model = self._background_work_backend("task_context_compression_model")
             if background_model is None:
                 raise AgentBackendError(
                     "Context compression is required, but no summary model is available.",
@@ -1957,7 +1959,7 @@ class AgentRuntime(WorkspaceStorageMixin, PendingApprovalsMixin):
         if not messages:
             return None
 
-        background_model = self._background_work_backend("background_easy_work_model")
+        background_model = self._background_work_backend("task_session_naming_model")
         if background_model is not None:
             backend, model = background_model
             try:
@@ -1975,7 +1977,7 @@ class AgentRuntime(WorkspaceStorageMixin, PendingApprovalsMixin):
         prompt = (
             f"Directory path:\n{project_path}\n\nDirectory structure, first 3 levels:\n{outline}"
         )
-        background_model = self._background_work_backend("background_easy_work_model")
+        background_model = self._background_work_backend("task_system_tasks_model")
         if background_model is not None:
             backend, model = background_model
             try:
@@ -1994,7 +1996,7 @@ class AgentRuntime(WorkspaceStorageMixin, PendingApprovalsMixin):
         if not messages:
             return fallback
 
-        background_model = self._background_work_backend("background_hard_work_model")
+        background_model = self._background_work_backend("task_system_tasks_model")
         if background_model is not None:
             backend, model = background_model
             try:
@@ -2012,7 +2014,7 @@ class AgentRuntime(WorkspaceStorageMixin, PendingApprovalsMixin):
     ) -> CommandRiskEvaluation | None:
         """Evaluate a pending command approval request with the selected backend."""
 
-        background_model = self._background_work_backend("background_medium_work_model")
+        background_model = self._background_work_backend("task_system_tasks_model")
         candidates = [background_model] if background_model is not None else []
         if self.backend is not None:
             primary = (self.backend, str(self.home.load_config().get("model") or ""))
@@ -2041,7 +2043,7 @@ class AgentRuntime(WorkspaceStorageMixin, PendingApprovalsMixin):
     ) -> MemoryMetadata:
         """Suggest memory metadata with a deterministic fallback."""
 
-        background_model = self._background_work_backend("background_easy_work_model")
+        background_model = self._background_work_backend("task_system_tasks_model")
         if background_model is not None:
             backend, model = background_model
             try:
@@ -2064,9 +2066,17 @@ class AgentRuntime(WorkspaceStorageMixin, PendingApprovalsMixin):
         self,
         config_key: str,
     ) -> tuple[BaseBackend, str] | None:
+        from anomx.agent.store import TASK_MODEL_FALLBACKS, TASK_MODEL_SELECTION
+
         if self.background_backend_resolver is not None:
             return self.background_backend_resolver(config_key, self)
         config = self.home.load_config()
+        if config_key in TASK_MODEL_FALLBACKS and config.get(config_key, TASK_MODEL_SELECTION) == TASK_MODEL_SELECTION:
+            system_key = "task_system_tasks_model"
+            if config_key != system_key and config.get(system_key, TASK_MODEL_SELECTION) != TASK_MODEL_SELECTION:
+                config_key = system_key
+            else:
+                config_key = TASK_MODEL_FALLBACKS[config_key]
         selection = str(config.get(config_key) or CURRENT_MODEL_SELECTION).strip()
         if selection == CURRENT_MODEL_SELECTION:
             provider = str(config.get("provider") or "").strip()
@@ -2541,8 +2551,13 @@ class AgentRuntime(WorkspaceStorageMixin, PendingApprovalsMixin):
         ]
         if self.agent_user and self.agent_kind == AgentKind.MAIN and self.has_platform_connection():
             from anomx.agent.tools.chat_with_users import ChatWithUsersTool
+            from anomx.agent.tools.manage_tasks import ManageTasksTool
+            from anomx.agent.tools.manage_workspace_files import ManageWorkspaceFilesTool
 
+            tools = [tool for tool in tools if tool.name != "manage_workspace_files"]
+            tools.append(ManageWorkspaceFilesTool(agent_tasks=True))
             tools.append(ChatWithUsersTool())
+            tools.append(ManageTasksTool())
         if self._running_command_states():
             tools.extend(command_control_tools())
         if self._context_compression_available():
@@ -3588,6 +3603,8 @@ class AgentRuntime(WorkspaceStorageMixin, PendingApprovalsMixin):
         )
         if self.additional_instructions:
             sections.append(self.additional_instructions)
+        if self.live_instructions is not None:
+            sections.append(self.live_instructions())
         user_name = str(self.home.load_config().get("user_name") or "").strip()
         if user_name:
             sections.append(f"User profile:\n- Name: {user_name}")

{anomx-2.3.0 → anomx-2.3.2}/src/anomx/agent/skills/__init__.py

@@ -37,6 +37,7 @@ DEFAULT_PLATFORM_SKILL_COMMANDS = (
     "edit-workspace",
     "write-work",
     "manage-systems",
+    "create-system-models",
 )
 _COMMAND_PATTERN = re.compile(r"^[a-z0-9][a-z0-9_-]{0,63}$")
 

anomx-2.3.2/src/anomx/agent/skills/create-system-models/SKILL.md

@@ -0,0 +1,69 @@
+---
+name: create-system-models
+description: Create, edit, or reuse a system's compound 3D representation for Anomx graphs and the system model editor. Use for visual models, not system hierarchy, icons, simulation meshes, or manufacturing CAD exports.
+metadata:
+    title: Create System Models
+    requires_platform: true
+    keywords: system, 3d, model, geometry, visualization, mini cad, design
+    anomx_models: systems_system
+---
+
+# Create system models
+
+Design a recognizable, compact system representation using the same primitives
+as the platform's **System → Edit → Editor** tab. Read `use-anomx-api` for the
+connected API conventions and [the model format](references/model-format.md)
+before preparing a design. The editor and the 3D graphs consume the same
+`properties.navigator_appearance` value.
+
+## Resolve and inspect
+
+Find the requested system through `GET /systems?query=<name>&limit=20`, then read
+`GET /systems/<id>` before writing. Establish which physical or functional form
+the user wants. Use supplied references and the system description; do not
+invent dimensions, machinery details, or a health state from a name alone.
+For an unspecified appearance, make a simple schematic silhouette and describe
+it as such. Preserve an existing custom design unless the request covers editing
+or replacing it.
+
+To reuse a design, browse
+`GET /systems?has_custom_visualization=true&query=<name>&limit=20&ordering=name`
+and follow the returned pagination. Read the chosen source's properties. Copy
+only its appearance into the target; names, metadata, hierarchy, and object
+permissions belong to their original systems. If the server does not support
+this filter or the requested primitive, inspect its schema and report the
+capability mismatch instead of silently claiming the model was saved.
+
+## Design
+
+Start with the fewest primitives that make the silhouette recognizable at node
+size. Use named components for meaningful pieces so the user can select and
+edit them later. Position, rotate and scale components to assemble the model;
+use colors and material values deliberately. A cylinder with supports often
+communicates a vessel better than many tiny decorative components.
+
+The graph centers and normalizes the complete assembly; coordinates and the
+editor's dimensions are **model units**, not physical measurements. Check the
+front, side, and top arrangement when preparing compound shapes. Planes and
+circles are flat, two-sided surfaces; use boxes or cylinders for thickness.
+Keep all values finite and within the format's bounds. The representation is
+declarative data, not executable code or an external mesh URL.
+
+## Save and verify
+
+Refresh the target before writing. Merge the prepared appearance into its
+current `properties`, preserving every unrelated key, especially `icon` and
+existing metadata. `PATCH /systems/<id>` replaces the whole properties object;
+send a `properties` field containing that merged object. Use the
+normal platform API and the user's authorized scope. Appearance changes do not
+authorize creating systems, changing roles or connections, editing metadata,
+or overwriting a different system's design. Respect write denials.
+
+Read the saved target back and compare the returned appearance to the intended
+design. If a visual preview is available, inspect the silhouette and component
+overlap in the editor or graph. Distinguish readback verification from actual
+visual verification. Report the affected system and what changed.
+
+To restore automatic branch coloring and the default sphere, remove only
+`navigator_appearance` from the merged properties. Do not replace the entire
+properties object with an empty object.

anomx-2.3.2/src/anomx/agent/skills/create-system-models/references/model-format.md

@@ -0,0 +1,57 @@
+# Model format
+
+The API stores a model at `System.properties.navigator_appearance`:
+
+| Field | Values | Default |
+| --- | --- | --- |
+| `shape` | `sphere`, `box`, `cylinder`, `cone`, `torus`, `capsule`, `octahedron`, `plane`, `circle` | `sphere` |
+| `color` | Six-digit hexadecimal RGB, e.g. `#80b8d1` | `#8b91ad` |
+| `scale` | Number from 0.5 to 2; overall graph size | 1 |
+| `metalness` | Number from 0 to 1 | 0.15 |
+| `roughness` | Number from 0 to 1 | 0.4 |
+| `parts` | Up to 24 component objects | Single `shape` |
+
+A nonempty `parts` array replaces the single primitive. Each component accepts:
+
+| Field | Values |
+| --- | --- |
+| `name` | Optional component label, at most 80 characters |
+| `shape` | A primitive from the table above |
+| `color` | Optional six-digit RGB; inherits the model color |
+| `metalness`, `roughness` | Optional numbers from 0 to 1; inherit model material |
+| `position` | Three model coordinates, each from −4 to 4; default `[0,0,0]` |
+| `rotation` | Three Euler XYZ angles in **radians**, each from −6.284 to 6.284; default zero |
+| `scale` | Three scale factors, each from 0.1 to 4; default `[1,1,1]` |
+
+The UI shows angles in degrees, but the API stores radians. Y is up. Planes and
+circles lie in XY, facing along ±Z; rotate by π/2 around X for a horizontal
+surface. Cylinders, cones and capsules extend along Y before rotation.
+A box is one model unit along each axis; a cylinder has diameter and height of
+one unit. The default sphere diameter is 7/6 units. Component scale factors
+multiply those primitive dimensions; these are not engineering measurements.
+
+The complete assembly is centered and normalized to the graph's node footprint.
+Overall `scale`, hierarchy size weighting and camera perspective then affect
+its displayed size. Changes to this model do not change graph coordinates or
+system relationships. An empty parts array falls back to the single shape in
+the graph; removing the appearance restores the automatic default.
+
+Example: a schematic vessel, with two supports that remain individually editable:
+
+```json
+{
+    "color": "#80b8d1",
+    "scale": 1.25,
+    "metalness": 0.3,
+    "roughness": 0.45,
+    "parts": [
+        {"name": "Vessel", "shape": "capsule", "rotation": [0, 0, 1.5708], "scale": [1, 2, 1]},
+        {"name": "Left support", "shape": "box", "color": "#71818e", "position": [-0.7, -0.8, 0], "scale": [0.25, 0.6, 0.7]},
+        {"name": "Right support", "shape": "box", "color": "#71818e", "position": [0.7, -0.8, 0], "scale": [0.25, 0.6, 0.7]}
+    ]
+}
+```
+
+Reuse this pattern only when it suits the requested system. Supply actual
+numeric arrays and supported fields; the schema does not load scripts, SVG,
+HTML, arbitrary geometry, URLs, or external CAD files.

{anomx-2.3.0 → anomx-2.3.2}/src/anomx/agent/store.py

@@ -70,7 +70,7 @@ class ModelMenuOption:
 
 @dataclass(frozen=True)
 class BackgroundWorkModelSetting:
-    """Configurable standard model used for one task difficulty."""
+    """Configurable model selection for a task or difficulty."""
 
     config_key: str
     label: str
@@ -227,7 +227,7 @@ BACKGROUND_WORK_MODEL_SETTINGS: tuple[BackgroundWorkModelSetting, ...] = (
     BackgroundWorkModelSetting(
         "background_easy_work_model",
         "Easy tasks",
-        "Simple questions and automatic naming",
+        "Simple questions and lightweight tasks",
         CURRENT_MODEL_SELECTION,
     ),
     BackgroundWorkModelSetting(
@@ -250,6 +250,22 @@ BACKGROUND_WORK_MODEL_SETTINGS: tuple[BackgroundWorkModelSetting, ...] = (
     ),
 )
 
+
+TASK_MODEL_SELECTION = "standard"
+SPECIFIC_TASK_MODEL_SETTINGS: tuple[BackgroundWorkModelSetting, ...] = (
+    BackgroundWorkModelSetting("task_session_naming_model", "Automatic Session Naming", "Name sessions from their conversation", TASK_MODEL_SELECTION),
+    BackgroundWorkModelSetting("task_channel_analysis_model", "Automatic Channel Analysis", "Analyze channel metadata", TASK_MODEL_SELECTION),
+    BackgroundWorkModelSetting("task_context_compression_model", "Context Compression", "Summarize history and optimize tool results", TASK_MODEL_SELECTION),
+    BackgroundWorkModelSetting("task_system_tasks_model", "Standard System Tasks", "Default for other system tasks and unset task models", TASK_MODEL_SELECTION),
+)
+TASK_MODEL_FALLBACKS = {
+    "task_session_naming_model": "background_easy_work_model",
+    "task_channel_analysis_model": "background_medium_work_model",
+    "task_context_compression_model": "background_easy_work_model",
+    "task_system_tasks_model": "background_easy_work_model",
+}
+MODEL_SETTINGS = (*BACKGROUND_WORK_MODEL_SETTINGS, *SPECIFIC_TASK_MODEL_SETTINGS)
+
 CONTEXT_LENGTH_OPTIONS: tuple[ContextManagementOption, ...] = (
     ContextManagementOption(
         32_000,
@@ -570,8 +586,8 @@ DEFAULT_CONFIG: dict[str, Any] = {
     "onboarding_complete": False,
     "provider": "openai",
     "model": "gpt-6.1-sol",
-    **{setting.config_key: setting.default for setting in BACKGROUND_WORK_MODEL_SETTINGS},
-    **{setting.effort_key: "" for setting in BACKGROUND_WORK_MODEL_SETTINGS},
+    **{setting.config_key: setting.default for setting in MODEL_SETTINGS},
+    **{setting.effort_key: "" for setting in MODEL_SETTINGS},
     "maximum_context_tokens": DEFAULT_MAXIMUM_CONTEXT_TOKENS,
     "user_name": "",
     "thinking_intensity": THINKING_INTENSITY_AUTO,
@@ -608,8 +624,8 @@ CONFIG_SCALAR_FIELDS = (
     "onboarding_complete",
     "provider",
     "model",
-    *(setting.config_key for setting in BACKGROUND_WORK_MODEL_SETTINGS),
-    *(setting.effort_key for setting in BACKGROUND_WORK_MODEL_SETTINGS),
+    *(setting.config_key for setting in MODEL_SETTINGS),
+    *(setting.effort_key for setting in MODEL_SETTINGS),
     "maximum_context_tokens",
     "user_name",
     "thinking_intensity",
@@ -1331,9 +1347,9 @@ class AnomxHome:
         config["thinking_intensity"] = normalize_thinking_intensity(
             config.get("thinking_intensity")
         )
-        for setting in BACKGROUND_WORK_MODEL_SETTINGS:
+        for setting in MODEL_SETTINGS:
             if not str(config.get(setting.config_key) or "").strip():
-                config[setting.config_key] = CURRENT_MODEL_SELECTION
+                config[setting.config_key] = setting.default
         if config.get("maximum_context_tokens") not in {
             option.value for option in CONTEXT_LENGTH_OPTIONS
         }:
@@ -1368,9 +1384,9 @@ class AnomxHome:
         merged["thinking_intensity"] = normalize_thinking_intensity(
             merged.get("thinking_intensity")
         )
-        for setting in BACKGROUND_WORK_MODEL_SETTINGS:
+        for setting in MODEL_SETTINGS:
             if not str(merged.get(setting.config_key) or "").strip():
-                merged[setting.config_key] = CURRENT_MODEL_SELECTION
+                merged[setting.config_key] = setting.default
         if merged.get("maximum_context_tokens") not in {
             option.value for option in CONTEXT_LENGTH_OPTIONS
         }:

{anomx-2.3.0 → anomx-2.3.2}/src/anomx/agent/tools/__init__.py

@@ -27,6 +27,7 @@ from anomx.agent.tools.glob import GlobTool
 from anomx.agent.tools.grep import GrepTool
 from anomx.agent.tools.kill_command import KillCommandTool
 from anomx.agent.tools.list_directory import ListDirectoryTool
+from anomx.agent.tools.manage_tasks import ManageTasksTool
 from anomx.agent.tools.manage_workspace_files import ManageWorkspaceFilesTool
 from anomx.agent.tools.manage_workspace_storage import ManageWorkspaceStorageTool
 from anomx.agent.tools.memorize import MemorizeTool
@@ -173,6 +174,7 @@ __all__ = [
     "BaseTool",
     "ChatTabTool",
     "ManageDataAdaptersTool",
+    "ManageTasksTool",
     "ManageWorkspaceFilesTool",
     "ManageWorkspaceStorageTool",
     "CheckCommandStatusTool",

anomx-2.3.2/src/anomx/agent/tools/manage_tasks.py

@@ -0,0 +1,100 @@
+"""Persistent self-managed tasks for autonomous platform users."""
+
+from __future__ import annotations
+
+from typing import Any
+from uuid import UUID
+
+from anomx.agent.base.tools import BaseTool, ToolExecutionContext, object_schema
+from anomx.agent.tools.use_anomx_api import UseAnomxApiTool
+
+
+class ManageTasksTool(BaseTool):
+    def __init__(self) -> None:
+        super().__init__(
+            name="manage_tasks",
+            description=(
+                "Manage your own persistent tasks: list, add, edit or delete. Agent users only. "
+                "Add requires a stable key and title; retries with the same key reuse the "
+                "task. Edit updates title, description, completed or reminders. Omitted fields "
+                "remain unchanged. reminders replaces the list; [] removes all reminders. "
+                "Keep descriptions short and detailed content in the returned tasks/<id>/ folder. "
+                "Tasks are refreshed in your system prompt before every model request. Completed "
+                "tasks suspend reminders; recurring tasks normally remain open. Delete cancels all "
+                "reminders but retains files. Reminders can wake you outside working hours; "
+                "pauses still apply. Use ISO dates and IANA zones. Translate natural-language "
+                "reminders into once/daily/weekly. Check success before claiming a task was saved."
+            ),
+            parameters=object_schema(
+                {
+                    "action": {"type": "string", "enum": ["list", "add", "edit", "delete"]},
+                    "task_id": {"type": "string", "description": "Task UUID for edit/delete."},
+                    "key": {
+                        "type": "string",
+                        "maxLength": 128,
+                        "description": "Stable idempotency key for add.",
+                    },
+                    "title": {"type": "string", "maxLength": 200},
+                    "description": {"type": "string", "maxLength": 1000},
+                    "completed": {"type": "boolean"},
+                    "reminders": {
+                        "type": "array",
+                        "maxItems": 20,
+                        "items": object_schema(
+                            {
+                                "kind": {"type": "string", "enum": ["once", "daily", "weekly"]},
+                                "timezone": {
+                                    "type": "string",
+                                    "description": "IANA timezone; defaults to your timezone.",
+                                },
+                                "at": {
+                                    "type": "string",
+                                    "description": (
+                                        "Once: ISO date/time, e.g. 2027-03-12T12:00. "
+                                        "An explicit offset is also accepted."
+                                    ),
+                                },
+                                "time": {
+                                    "type": "string",
+                                    "description": "Daily/weekly: local HH:MM, e.g. 08:00.",
+                                },
+                                "weekdays": {
+                                    "type": "array",
+                                    "items": {"type": "integer", "minimum": 0, "maximum": 6},
+                                    "description": "Weekly only: 0=Monday through 6=Sunday.",
+                                },
+                            },
+                            ["kind"],
+                        ),
+                    },
+                },
+                ["action"],
+            ),
+        )
+
+    def execute(self, arguments: dict[str, Any], context: ToolExecutionContext) -> str:
+        if not getattr(context.runtime, "agent_user", False):
+            return context.json_result(
+                {"ok": False, "error": "This tool requires an autonomous agent user."}
+            )
+        action = arguments.get("action")
+        if not isinstance(action, str) or action not in {"list", "add", "edit", "delete"}:
+            return context.json_result({"ok": False, "error": "Unknown task action."})
+        body = {
+            key: value
+            for key, value in arguments.items()
+            if key in {"action", "task_id", "key", "title", "description", "completed", "reminders"}
+        }
+        if action in {"edit", "delete"}:
+            try:
+                body["task_id"] = str(UUID(str(body.get("task_id", ""))))
+            except ValueError:
+                return context.json_result({"ok": False, "error": "A valid task_id is required."})
+        request: dict[str, Any] = {
+            "method": "GET" if action == "list" else "POST",
+            "path": "/users/agent-tasks",
+            "statement": f"Managing my tasks: {action}",
+        }
+        if action != "list":
+            request["body"] = body
+        return UseAnomxApiTool(statement_description="Managing my tasks").execute(request, context)

{anomx-2.3.0 → anomx-2.3.2}/src/anomx/agent/tools/manage_workspace_files.py

@@ -7,12 +7,13 @@ import os
 import tempfile
 from pathlib import Path
 from typing import Any
+from uuid import UUID
 
 from anomx.agent.base.tools import BaseTool, ToolExecutionContext
 
 
 class ManageWorkspaceFilesTool(BaseTool):
-    def __init__(self) -> None:
+    def __init__(self, *, agent_tasks: bool = False) -> None:
         super().__init__(
             name="manage_workspace_files",
             description=(
@@ -21,11 +22,20 @@ class ManageWorkspaceFilesTool(BaseTool):
                 "approval. Use relative paths. Existing files require their current SHA-256 "
                 "as expected_sha256, so another chat's changes are preserved. On conflict, "
                 "read and reconcile the current file before retrying. No recursive deletion."
+                + (
+                    " Agent users may also write task notes with area=tasks and "
+                    "path=<task-id>/README.md (or another file inside an existing task folder)."
+                    if agent_tasks
+                    else ""
+                )
             ),
             parameters={
                 "type": "object",
                 "properties": {
-                    "area": {"type": "string", "enum": ["brain", "tmp"]},
+                    "area": {
+                        "type": "string",
+                        "enum": ["brain", "tmp", *(["tasks"] if agent_tasks else [])],
+                    },
                     "action": {"type": "string", "enum": ["write", "delete"]},
                     "path": {"type": "string"},
                     "content": {
@@ -45,12 +55,13 @@ class ManageWorkspaceFilesTool(BaseTool):
         area, action = arguments.get("area"), arguments.get("action")
         raw = str(arguments.get("path") or "")
         if "\x00" in raw or len(raw) > 512:
-            return context.json_result({
-                "error": "Provide a valid relative path under 512 characters."
-            })
+            return context.json_result(
+                {"error": "Provide a valid relative path under 512 characters."}
+            )
         relative = Path(raw)
-        if area not in {"brain", "tmp"} or action not in {"write", "delete"}:
-            return context.json_result({"error": "Choose brain/tmp and write/delete."})
+        areas = {"brain", "tmp", "tasks"} if context.runtime.agent_user else {"brain", "tmp"}
+        if area not in areas or action not in {"write", "delete"}:
+            return context.json_result({"error": "Choose an available area and write/delete."})
         if (
             not raw
             or relative.is_absolute()
@@ -63,9 +74,23 @@ class ManageWorkspaceFilesTool(BaseTool):
             return context.json_result(
                 {"error": "Cleanup is limited to exact files in this chat's tmp folder."}
             )
-        root = (
-            context.runtime.home.brain_dir if area == "brain" else context.runtime.home.tmp_dir
-        ).resolve()
+        if area == "tasks":
+            root = context.runtime.workspace_root / "tasks"
+            try:
+                task_id = str(UUID(relative.parts[0]))
+            except ValueError:
+                return context.json_result({"error": "Use <task-id>/<filename> for task notes."})
+            if (
+                len(relative.parts) < 2
+                or relative.parts[0] != task_id
+                or root.resolve() != root
+                or not (root / task_id).is_dir()
+            ):
+                return context.json_result({"error": "Write inside an existing task folder."})
+        else:
+            root = (
+                context.runtime.home.brain_dir if area == "brain" else context.runtime.home.tmp_dir
+            ).resolve()
         target = root / relative
         if target.resolve() != target or not target.is_relative_to(root) or target == root:
             return context.json_result(