Function report_create_chapter

functions/function_calling/deep_research.py:301–388

Create a new chapter in the report.

(
    title: Annotated[str, ParamMeta(description="Chapter title (supports 'Parent/NewChild' to insert into existing). Use '|' to specify insertion point e.g. 'Prev|New' to insert after 'Prev', or '|New' to insert at start.")],
    level: Annotated[int, ParamMeta(description="Header level (1-6)")],
    content: Annotated[str, ParamMeta(description="Content of the chapter")],
    _context: Dict[str, Any] | None = None,
)

def report_create_chapter(
    title: Annotated[str, ParamMeta(description="Chapter title (supports 'Parent/NewChild' to insert into existing). Use '|' to specify insertion point e.g. 'Prev|New' to insert after 'Prev', or '|New' to insert at start.")],
    level: Annotated[int, ParamMeta(description="Header level (1-6)")],
    content: Annotated[str, ParamMeta(description="Content of the chapter")],
    _context: Dict[str, Any] | None = None,
) -> str:
    """
    Create a new chapter in the report.
    """
    ctx = FileToolContext(_context)
    _, report_file = _get_files(ctx)
    _, report_lock = _get_locks(ctx)

    with FileLock(report_lock):
        lines = _read_report_lines(report_file)
        
        # Check for routing path
        parent_path = None
        display_title = title
        p_start, p_end = -1, len(lines)

        if "/" in title:
            # Handle recursive "Parent/Child" structure, where Child might contain "|"
            parent_path, new_title = title.rsplit("/", 1)
            p_start, p_end = _find_chapter_range(lines, parent_path)
            
            if p_start == -1:
                return f"Parent chapter '{parent_path}' not found. Cannot create '{new_title}' inside it."
            
            display_title = new_title

        # Check for "|" syntax in the leaf title
        insert_after_target = None # None means append, "" means start, "str" means after that chapter
        if "|" in display_title:
            target, real_title = display_title.split("|", 1)
            display_title = real_title
            insert_after_target = target
        
        # Determine insertion index
        insert_idx = -1
        
        if insert_after_target is not None:
            if insert_after_target == "":
                # Insert at the beginning of the context
                if parent_path:
                    # Inside parent: Insert after parent header (and its intro text), before first subchapter
                    insert_idx = p_end # Default to appending if no subchapters found
                    
                    # Scan for first header inside parent
                    for idx in range(p_start + 1, len(lines)):
                        if idx >= p_end:
                            break
                        lvl, _ = _parse_header(lines[idx])
                        if lvl > 0:
                            insert_idx = idx
                            break
                else:
                    # Top level: Insert at start of file