Function lsToolImpl

core/tools/implementations/lsTool.ts:17–62

(args, extras)

const MAX_LS_TOOL_LINES = 200;

export const lsToolImpl: ToolImpl = async (args, extras) => {
  const dirPath = resolveLsToolDirPath(args?.dirPath);
  const resolvedPath = await resolveInputPath(extras.ide, dirPath);
  if (!resolvedPath) {
    throw new ContinueError(
      ContinueErrorReason.DirectoryNotFound,
      `Directory ${args.dirPath} not found or is not accessible. You can use absolute paths, relative paths, or paths starting with ~`,
    );
  }

  const entries = await walkDir(resolvedPath.uri, extras.ide, {
    returnRelativeUrisPaths: true,
    include: "both",
    recursive: args?.recursive ?? false,
    overrideDefaultIgnores: ignore(), // Show all directories including dist/, build/, etc.
  });

  const lines = entries.slice(0, MAX_LS_TOOL_LINES);

  let content =
    lines.length > 0
      ? lines.join("\n")
      : `No files/folders found in ${resolvedPath.displayPath}`;

  const contextItems = [
    {
      name: "File/folder list",
      description: `Files/folders in ${resolvedPath.displayPath}`,
      content,
    },
  ];

  if (entries.length > MAX_LS_TOOL_LINES) {
    let warningContent = `${entries.length - MAX_LS_TOOL_LINES} ls entries were truncated`;
    if (args?.recursive) {
      warningContent += ". Try using a non-recursive search";
    }
    contextItems.push({
      name: "Truncation warning",
      description: "",
      content: warningContent,
    });
  }

  return contextItems;
};