Create a new empty HNPX document

Args: file_path (str): Path where the new HNPX document will be created

Get ID of the book node (document root)

Args: file_path (str): Path to the HNPX document

Returns: str: ID of the book node

Retrieve XML representation of a specific node (without descendants)

Args: file_path (str): Path to the HNPX document node_id (str): ID of the node to retrieve

Returns: str: XML representation of the node with its attributes and summary child only

Retrieve XML representation of node including all descendants, optionally pruned

Args: file_path (str): Path to the HNPX document node_id (str): ID of the node to retrieve pruning_level (str): Depth level - one of: "book", "chapter", "sequence", "beat", "full"

Returns: str: XML representation of the node and its descendants, pruned to specified depth

Retrieve immediate child nodes of a specified parent

Args: file_path (str): Path to the HNPX document node_id (str): ID of the parent node

Returns: str: Concatenated XML representation of all direct child nodes

Find next container node without children within a specific node's subtree (BFS order)

Args: file_path (str): Path to the HNPX document node_id (str): ID of the node to search within

Returns: str: XML representation of the next empty container node or a message if none found

Return hierarchical path from document root to specified node

Args: file_path (str): Path to the HNPX document node_id (str): ID of the target node

Returns: str: Concatenated XML representation of all nodes in the path from root to target

Create a new chapter element

Args: file_path (str): Path to the HNPX document parent_id (str): ID of the parent book element title (str): Chapter title summary (str): Chapter summary text pov (Optional[str]): Point-of-view character identifier

Create a new sequence element

Args: file_path (str): Path to the HNPX document parent_id (str): ID of the parent chapter element location (str): Location description summary (str): Sequence summary text time (Optional[str]): Time indicator (e.g., "night", "next day", "flashback") pov (Optional[str]): Point-of-view character identifier

Create a new beat element

Args: file_path (str): Path to the HNPX document parent_id (str): ID of the parent sequence element summary (str): Beat summary text

Create a new paragraph element

Args: file_path (str): Path to the HNPX document parent_id (str): ID of the parent beat element text (str): Paragraph text content mode (str): Narrative mode - one of: "narration" (default), "dialogue", "internal" char (Optional[str]): Character identifier (required when mode="dialogue")

Edit summary text of a node

Args: file_path (str): Path to the HNPX document node_id (str): ID of the node containing the summary new_summary (str): New summary text content

Edit paragraph text content

Args: file_path (str): Path to the HNPX document node_id (str): ID of the paragraph node to modify new_text (str): New paragraph text content

Modify attributes of an existing node

Args: file_path (str): Path to the HNPX document node_id (str): ID of the node to modify attributes (dict): Dictionary of attribute names and values to update

Move multiple nodes between parents

Args: file_path (str): Path to the HNPX document node_ids (list): List of node IDs to move new_parent_id (str): ID of the new parent node

Reorganize the order of child elements

Args: file_path (str): Path to the HNPX document parent_id (str): ID of the parent node child_ids (list): List of child IDs in the desired order

Permanently remove multiple nodes and all their descendants

Args: file_path (str): Path to the HNPX document node_ids (list): List of node IDs to remove

Remove all children of a node

Args: file_path (str): Path to the HNPX document node_id (str): ID of the parent node

Render text representation of the node (only descendent paragraphs)

Args: file_path (str): Path to the HNPX document node_id (str): ID of the node to render show_ids (bool): Whether to show paragraph IDs in square brackets show_markers (bool): Whether to mark chapter/sequence beginnings

Returns: str: Formatted text representation the node