feat: add ability to stat files in workspaces

Signed-off-by: Donnie Adams <[email protected]>

gptscript/fileinfo.py

@@ -0,0 +1,10 @@
+from datetime import datetime
+
+from pydantic import BaseModel
+
+
+class FileInfo(BaseModel):
+    workspaceID: str
+    name: str
+    size: int
+    modTime: datetime

gptscript/gptscript.py

@@ -9,6 +9,7 @@
 from gptscript.confirm import AuthResponse
 from gptscript.credentials import Credential, to_credential
 from gptscript.datasets import DatasetMeta, Dataset, DatasetElementMeta, DatasetElement
+from gptscript.fileinfo import FileInfo
 from gptscript.frame import RunFrame, CallFrame, PromptFrame, Program
 from gptscript.opts import GlobalOptions
 from gptscript.prompt import PromptResponse
@@ -402,6 +403,20 @@ async def read_file_in_workspace(self, file_path: str, workspace_id: str = "") -
             }
         ))
 
+    async def stat_file_in_workspace(self, file_path: str, workspace_id: str = "") -> FileInfo:
+        if workspace_id == "":
+            workspace_id = os.environ["GPTSCRIPT_WORKSPACE_ID"]
+
+        return FileInfo.model_validate_json(await self._run_basic_command(
+            "workspaces/stat-file",
+            {
+                "id": workspace_id,
+                "filePath": file_path,
+                "workspaceTool": self.opts.WorkspaceTool,
+                "env": self.opts.Env,
+            }
+        ))
+
 
 def _get_command():
     if os.getenv("GPTSCRIPT_BIN") is not None:

tests/test_gptscript.py

@@ -810,6 +810,17 @@ async def test_create_read_and_delete_file_in_workspace(gptscript):
     await gptscript.write_file_in_workspace("test.txt", b"test", workspace_id)
     contents = await gptscript.read_file_in_workspace("test.txt", workspace_id)
     assert contents == b"test"
+
+    file_info = await gptscript.stat_file_in_workspace("test.txt", workspace_id)
+    assert file_info.name == "test.txt"
+    assert file_info.size == 4
+    assert file_info.modTime.hour == datetime.now(
+        tz=file_info.modTime.tzinfo,
+    ).hour and file_info.modTime < datetime.now(
+        tz=file_info.modTime.tzinfo,
+    )
+
+    assert file_info.workspaceID == workspace_id
     await gptscript.delete_file_in_workspace("test.txt", workspace_id)
     await gptscript.delete_workspace(workspace_id)
 
@@ -857,6 +868,16 @@ async def test_create_read_and_delete_file_in_workspaces3(gptscript):
     await gptscript.write_file_in_workspace("test.txt", b"test", workspace_id)
     contents = await gptscript.read_file_in_workspace("test.txt", workspace_id)
     assert contents == b"test"
+
+    file_info = await gptscript.stat_file_in_workspace("test.txt", workspace_id)
+    assert file_info.name == "test.txt"
+    assert file_info.size == 4
+    assert file_info.modTime.hour == datetime.now(
+        tz=file_info.modTime.tzinfo,
+    ).hour and file_info.modTime < datetime.now(
+        tz=file_info.modTime.tzinfo,
+    )
+
     await gptscript.delete_file_in_workspace("test.txt", workspace_id)
     await gptscript.delete_workspace(workspace_id)