1 files changed, 70 insertions, 0 deletions
diff --git a/autogpts/autogpt/autogpt/core/workspace/base.py b/autogpts/autogpt/autogpt/core/workspace/base.py
new file mode 100644
index 000000000..b011056c3
--- /dev/null
+++ b/autogpts/autogpt/autogpt/core/workspace/base.py
@@ -0,0 +1,70 @@
+from __future__ import annotations
+
+import abc
+import logging
+import typing
+from pathlib import Path
+
+if typing.TYPE_CHECKING:
+    from autogpt.core.configuration import AgentConfiguration
+
+
+class Workspace(abc.ABC):
+    """The workspace is the root directory for all generated files.
+
+    The workspace is responsible for creating the root directory and
+    providing a method for getting the full path to an item in the
+    workspace.
+
+    """
+
+    @property
+    @abc.abstractmethod
+    def root(self) -> Path:
+        """The root directory of the workspace."""
+        ...
+
+    @property
+    @abc.abstractmethod
+    def restrict_to_workspace(self) -> bool:
+        """Whether to restrict generated paths to the workspace."""
+        ...
+
+    @staticmethod
+    @abc.abstractmethod
+    def setup_workspace(
+        configuration: AgentConfiguration, logger: logging.Logger
+    ) -> Path:
+        """Create the workspace root directory and set up all initial content.
+
+        Parameters
+        ----------
+        configuration
+            The Agent's configuration.
+        logger
+            The Agent's logger.
+
+        Returns
+        -------
+        Path
+            The path to the workspace root directory.
+
+        """
+        ...
+
+    @abc.abstractmethod
+    def get_path(self, relative_path: str | Path) -> Path:
+        """Get the full path for an item in the workspace.
+
+        Parameters
+        ----------
+        relative_path
+            The path to the item relative to the workspace root.
+
+        Returns
+        -------
+        Path
+            The full path to the item.
+
+        """
+        ...