Add persistent task workspace alpha

Start the first workspace milestone toward the task-oriented product without changing the existing one-shot vm_run/pyro run contract.

Add a disk-backed task registry in the manager, auto-started task workspaces rooted at /workspace, repeated non-cleaning exec, and persisted command journals exposed through task create/exec/status/logs/delete across the CLI, Python SDK, and MCP server.

Update the public contract, docs, examples, and version/catalog metadata for 2.1.0, and cover the new surface with manager, CLI, SDK, and MCP tests. Validation: UV_CACHE_DIR=.uv-cache make check and UV_CACHE_DIR=.uv-cache make dist-check.

src/pyro_mcp/api.py

@@ -77,6 +77,43 @@ class Pyro:
     def exec_vm(self, vm_id: str, *, command: str, timeout_seconds: int = 30) -> dict[str, Any]:
         return self._manager.exec_vm(vm_id, command=command, timeout_seconds=timeout_seconds)
 
+    def create_task(
+        self,
+        *,
+        environment: str,
+        vcpu_count: int = DEFAULT_VCPU_COUNT,
+        mem_mib: int = DEFAULT_MEM_MIB,
+        ttl_seconds: int = DEFAULT_TTL_SECONDS,
+        network: bool = False,
+        allow_host_compat: bool = DEFAULT_ALLOW_HOST_COMPAT,
+    ) -> dict[str, Any]:
+        return self._manager.create_task(
+            environment=environment,
+            vcpu_count=vcpu_count,
+            mem_mib=mem_mib,
+            ttl_seconds=ttl_seconds,
+            network=network,
+            allow_host_compat=allow_host_compat,
+        )
+
+    def exec_task(
+        self,
+        task_id: str,
+        *,
+        command: str,
+        timeout_seconds: int = DEFAULT_TIMEOUT_SECONDS,
+    ) -> dict[str, Any]:
+        return self._manager.exec_task(task_id, command=command, timeout_seconds=timeout_seconds)
+
+    def status_task(self, task_id: str) -> dict[str, Any]:
+        return self._manager.status_task(task_id)
+
+    def logs_task(self, task_id: str) -> dict[str, Any]:
+        return self._manager.logs_task(task_id)
+
+    def delete_task(self, task_id: str) -> dict[str, Any]:
+        return self._manager.delete_task(task_id)
+
     def stop_vm(self, vm_id: str) -> dict[str, Any]:
         return self._manager.stop_vm(vm_id)
 
@@ -200,4 +237,47 @@ class Pyro:
             """Delete VMs whose TTL has expired."""
             return self.reap_expired()
 
+        @server.tool()
+        async def task_create(
+            environment: str,
+            vcpu_count: int = DEFAULT_VCPU_COUNT,
+            mem_mib: int = DEFAULT_MEM_MIB,
+            ttl_seconds: int = DEFAULT_TTL_SECONDS,
+            network: bool = False,
+            allow_host_compat: bool = DEFAULT_ALLOW_HOST_COMPAT,
+        ) -> dict[str, Any]:
+            """Create and start a persistent task workspace."""
+            return self.create_task(
+                environment=environment,
+                vcpu_count=vcpu_count,
+                mem_mib=mem_mib,
+                ttl_seconds=ttl_seconds,
+                network=network,
+                allow_host_compat=allow_host_compat,
+            )
+
+        @server.tool()
+        async def task_exec(
+            task_id: str,
+            command: str,
+            timeout_seconds: int = DEFAULT_TIMEOUT_SECONDS,
+        ) -> dict[str, Any]:
+            """Run one command inside an existing task workspace."""
+            return self.exec_task(task_id, command=command, timeout_seconds=timeout_seconds)
+
+        @server.tool()
+        async def task_status(task_id: str) -> dict[str, Any]:
+            """Inspect task state and latest command metadata."""
+            return self.status_task(task_id)
+
+        @server.tool()
+        async def task_logs(task_id: str) -> dict[str, Any]:
+            """Return persisted command history for one task."""
+            return self.logs_task(task_id)
+
+        @server.tool()
+        async def task_delete(task_id: str) -> dict[str, Any]:
+            """Delete a task workspace and its backing sandbox."""
+            return self.delete_task(task_id)
+
         return server