List Children Circuits

List derived transpiled and compressed child circuits for a parent ID.

Use this tool when the caller already has a parent circuit_id and needs the lineage of derived transpiled or compressed circuits. The returned IDs can be passed into execution, compression, or circuit-job MCP tools.

When to Use:

• Call this after transpilation or compression has already run and the caller needs the derived circuit IDs.
• Call this before analytics, execution, or job-history inspection when the most recent work may have produced child circuits.

Constraints:

• The endpoint only reports children already referenced by transpiled_circuit_ids and compressed_circuit_ids.
• An empty list is a valid result when no child circuits exist.

Notes:

• Each returned child descriptor includes a brief MCP-oriented description rather than a full circuit model.
• Returned IDs can be passed into execution, compression, or circuit-job MCP tools unchanged.

Args: circuit_id: Parent circuit identifier from a prior MCP response. user: Authenticated user resolved from the API key. db: Active database session.

Returns: A list of child descriptors containing id, name, and a brief MCP-oriented description.

Raises: HTTPException: Raised with 404 when the parent circuit or its experiment is not available to the caller.