Provides a quick look at the beginning of a file or a string, showing the first few thousands
characters and total line count.
Exactly one of context_path or context_text must be provided. Do NOT provide both.

Args:
    context_path (str): The path to the file to glance at.
    context_text (str): The text content to glance at.

Returns:
    A string containing a snippet of the file/text and metadata.

Searches a document for a regex pattern and returns matching snippets.
Exactly one of context_path or context_text must be provided. Do NOT provide both.

Args:
    context_path (str, optional): The path to the context file.
    context_text (str, optional): The text content to search.
    regex_pattern (str, optional): The regex pattern to search for.
    case_sensitive (bool, default=True): Whether to match case-sensitively.

Returns:
    str: A string containing the matching snippets.

Retrieves relevant passages from a document or string based on a query using RAG.
Exactly one of context_path or context_text must be provided. Do NOT provide both.

Args:
    context_path (str): The path to the context file.
    context_text (str): The text content to search.
    query (str): The query to search for.

Returns:
    str: A string containing the relevant passages.

Summarizes a document or string using a map-reduce approach.
Exactly one of context_path or context_text must be provided. Do NOT provide both.
Note: This operation is resource-intensive and can be time-consuming.

Args:
    context_path (str): The path to the context file.
    context_text (str): The text content to summarize.
    question (str): The question for each chunk to answer.

Returns:
    str: A string containing the overall summary.

Reads a document or string sequentially to synthesize query-aware notes.
Exactly one of context_path or context_text must be provided. Do NOT provide both.
Note: This operation is resource-intensive and can be time-consuming.

Args:
    context_path (str): The path to the context file.
    context_text (str): The text content to synthesize notes from.
    question (str): The goal of the note-taking.

Returns:
    str: A string containing the synthesized notes, focusing on the question.