Method list

packages/agent-core/src/services/fs/fsService.ts:60–161

(sessionId: string, req: FsListRequest)

  }

  async list(sessionId: string, req: FsListRequest): Promise<FsListResponse> {
    const session = await this.sessions.get(sessionId);
    const cwd = session.metadata.cwd;
    const safe = await resolveSafePath(cwd, req.path);

    let topStat: import('node:fs').Stats;
    try {
      topStat = await fs.stat(safe.absolute);
    } catch (err) {
      throw mapStatError(err, req.path);
    }
    if (!topStat.isDirectory()) {

      throw new FsPathNotFoundError(req.path);
    }

    const realCwd = await fs.realpath(cwd);
    const matcher = req.follow_gitignore ? await this.matcher(realCwd) : undefined;

    const items: FsEntry[] = [];
    const childrenByPath: Record<string, FsEntry[]> = {};
    let truncated = false;

    interface QueueEntry {
      absPath: string;

      relPath: string;
      depthRemaining: number;
    }
    const queue: QueueEntry[] = [
      {
        absPath: safe.absolute,
        relPath: safe.relative === '.' ? '' : safe.relative,
        depthRemaining: req.depth,
      },
    ];

    while (queue.length > 0) {
      const entry = queue.shift()!;
      let dirents: import('node:fs').Dirent[];
      try {
        dirents = await fs.readdir(entry.absPath, { withFileTypes: true });
      } catch (err) {

        if (entry.absPath === safe.absolute) {
          throw mapStatError(err, req.path);
        }
        continue;
      }

      const visible: import('node:fs').Dirent[] = [];
      for (const d of dirents) {
        if (!req.show_hidden && isHidden(d.name)) continue;
        const childRel = entry.relPath === '' ? d.name : `${entry.relPath}/${d.name}`;
        if (matcher) {

          const probe = d.isDirectory() ? `${childRel}/` : childRel;
          if (matcher.ignores(probe)) continue;