reorder_children
Reorganize child elements in HNPX documents by specifying a new order for child IDs under a parent node to restructure narrative hierarchies.
Instructions
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
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| file_path | Yes | ||
| parent_id | Yes | ||
| child_ids | Yes |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |
Implementation Reference
- src/hnpx_sdk/tools.py:447-484 (handler)The core handler function for the 'reorder_children' tool. It parses the HNPX XML document, locates the specified parent node, validates that the provided child_ids match all current non-summary children, reorders them by removing and re-appending in the new sequence, saves the updated document, and returns a confirmation message.
def reorder_children(file_path: str, parent_id: str, child_ids: list) -> str: """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 """ tree = hnpx.parse_document(file_path) parent = hnpx.find_node(tree, parent_id) if parent is None: raise NodeNotFoundError(parent_id) # Get current children (excluding summary) current_children = [child for child in parent if child.tag != "summary"] current_ids = [child.get("id") for child in current_children] # Validate input if set(child_ids) != set(current_ids): raise InvalidOperationError( "reorder_children", "child_ids must contain all existing child IDs" ) # Create mapping and reorder child_map = {child.get("id"): child for child in current_children} # Remove all children (except summary) for child in current_children: parent.remove(child) # Add back in new order for child_id in child_ids: parent.append(child_map[child_id]) hnpx.save_document(tree, file_path) return f"Reordered children of node {parent_id}" - src/hnpx_sdk/server.py:30-30 (registration)Registers the reorder_children function as an MCP tool using the FastMCP app.tool() decorator.
app.tool()(tools.reorder_children)