Compress Circuit With State Compression

Submit state-compression jobs for existing or inline circuits.

Use this tool when the caller wants to run Haiqu state compression on either an existing stored circuit or a new inline QASM payload. At least one of circuit_ids or circuit_qasm must be supplied, and the response schema is a lightweight {"context": ...} wrapper rather than a structured job object.

When to Use:

• Call this when the workflow needs a compressed or optimized circuit derived from an existing circuit or from inline QASM.
• Call this before later execution or circuit analysis when the user wants Haiqu state compression applied first.

Constraints:

• Provide at least one of circuit_ids or circuit_qasm.
• The response is a lightweight context wrapper; use get_job_results_and_status to retrieve terminal outputs such as the generated circuit ID.
• This docstring does not promise normalized 404 handling for every invalid circuit reference because the lower-layer compression path owns part of that behavior.

Notes:

• If inline QASM is provided, the endpoint may create a circuit first and then submit compression.
• The created or reused input circuit is stored as input_circuit_id in the job record.

The batch of compression jobs could be submitted via circuit_ids. If both circuit_ids and circuit_id are provided, circuit_ids will be used and circuit_id will be ignored, it is deprecated.

Args: user: Authenticated user resolved from the API key. data: Compression payload. One of circuit_ids or circuit_qasm must be provided. db: Active database session.

Returns: A lightweight context wrapper summarizing the submission and next polling step.

Raises: HTTPException: Raised with 400 when neither circuit input mode is provided, 402 when the caller cannot submit billable jobs, or 404 when the experiment is not available to the caller.