farming-code 2.2.11 → 2.2.12

package/backend/workspace-directory.js

@@ -5,6 +5,7 @@ const path = require('path');
 
 const CREATE_FORBIDDEN_CODES = new Set(['EACCES', 'EPERM', 'EROFS']);
 const INVALID_PATH_CODES = new Set(['EINVAL', 'ENAMETOOLONG']);
+const DEFAULT_BROWSE_LIMIT = 500;
 
 function resolveWorkspaceDirectory(value, homeDir = process.env.HOME || os.homedir()) {
   const input = typeof value === 'string' ? value.trim() : '';
@@ -131,9 +132,87 @@ async function prepareWorkspaceDirectory(value, options = {}) {
   }
 }
 
+async function browseWorkspaceDirectory(value, options = {}) {
+  const workspace = resolveWorkspaceDirectory(value || '~', options.homeDir);
+  const fileSystem = options.fileSystem || fs.promises;
+  let entries;
+  try {
+    const stat = await fileSystem.stat(workspace);
+    if (!stat.isDirectory()) {
+      return {
+        status: 409,
+        body: {
+          status: 'rejected',
+          code: 'workspace-not-directory',
+          workspace,
+          message: `Workspace path is not a directory: ${workspace}`,
+        },
+      };
+    }
+    entries = await fileSystem.readdir(workspace, { withFileTypes: true });
+  } catch (error) {
+    const forbidden = CREATE_FORBIDDEN_CODES.has(error?.code);
+    const missing = error?.code === 'ENOENT';
+    return {
+      status: forbidden ? 403 : missing ? 404 : 500,
+      body: {
+        status: 'rejected',
+        code: forbidden
+          ? 'workspace-browse-forbidden'
+          : missing
+            ? 'workspace-not-found'
+            : 'workspace-browse-failed',
+        workspace,
+        message: forbidden
+          ? `Farming does not have permission to read this directory: ${workspace}`
+          : missing
+            ? `Workspace directory does not exist: ${workspace}`
+            : `Failed to read workspace directory: ${workspace}`,
+      },
+    };
+  }
+
+  const directories = (await Promise.all(entries.map(async (entry) => {
+    if (!entry.isDirectory() && !entry.isSymbolicLink()) return null;
+    const childPath = path.join(workspace, entry.name);
+    if (entry.isSymbolicLink()) {
+      try {
+        const stat = await fileSystem.stat(childPath);
+        if (!stat.isDirectory()) return null;
+      } catch {
+        return null;
+      }
+    }
+    return { name: entry.name, path: childPath };
+  })))
+    .filter(Boolean)
+    .sort((left, right) => left.name.localeCompare(right.name));
+  const limit = Math.max(1, Math.min(Number(options.limit) || DEFAULT_BROWSE_LIMIT, DEFAULT_BROWSE_LIMIT));
+  const parentPath = path.dirname(workspace);
+
+  return {
+    status: 200,
+    body: {
+      status: 'ready',
+      workspace,
+      parent: parentPath === workspace ? null : parentPath,
+      directories: directories.slice(0, limit),
+      truncated: directories.length > limit,
+    },
+  };
+}
+
 function createWorkspaceDirectoryRouter(options = {}) {
   const router = express.Router();
   router.use(express.json({ limit: '8kb' }));
+  router.get('/browse', async (req, res) => {
+    const result = await browseWorkspaceDirectory(req.query?.path, {
+      fileSystem: options.fileSystem,
+      homeDir: options.homeDir,
+      limit: req.query?.limit,
+    });
+    res.status(result.status).json(result.body);
+  });
   router.post('/prepare', async (req, res) => {
     const result = await prepareWorkspaceDirectory(req.body?.workspace, {
       create: req.body?.create === true,
@@ -146,6 +225,7 @@ function createWorkspaceDirectoryRouter(options = {}) {
 }
 
 module.exports = {
+  browseWorkspaceDirectory,
   createWorkspaceDirectoryRouter,
   prepareWorkspaceDirectory,
   resolveWorkspaceDirectory,