tinyhumansai/openhuman · error

Querit returned error_code {}

Error message

Querit returned error_code {}

What it means

The HTTP call succeeded (2xx) but the Querit response envelope carries a non-zero error_code — an application-level failure reported inside a successful transport response.

Source

Thrown at src/openhuman/search/tools/querit.rs:503

                status = %status,
                body_len = body_text.len(),
                "[querit] non-2xx response from Querit"
            );
            anyhow::bail!("Querit returned non-2xx status {status}");
        }

        let search_resp = Self::decode_response(resp.json().await.map_err(|e| {
            tracing::warn!("[querit] failed to read response JSON: {e}");
            anyhow::anyhow!("Failed to read Querit response JSON: {e}")
        })?)?;

        if search_resp.error_code != 0 && search_resp.error_code != 200 {
            tracing::warn!(
                error_code = search_resp.error_code,
                error_msg_len = search_resp.error_msg.chars().count(),
                "[querit] application-level error from Querit"
            );
            anyhow::bail!("Querit returned error_code {}", search_resp.error_code);
        }

        tracing::debug!(
            result_count = search_resp.results.result.len(),
            search_id = search_resp.search_id,
            "[querit] search complete"
        );

        let mut result =
            ToolResult::success(self.render_results_plain(&search_resp.results.result, query));
        if options.prefer_markdown {
            result.markdown_formatted =
                Some(self.render_results_markdown(&search_resp.results.result, query));
        }
        Ok(result)
    }
}

View on GitHub (pinned to 7491200858)

Solutions

1. Map the error_code against Querit's documentation for the specific cause
2. Retry for transient capacity/timeout error codes
3. Check the query parameters for request-rejection codes

When it happens

Trigger: Thrown at src/openhuman/search/tools/querit.rs:503 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of tinyhumansai/openhuman@7491200858 (2026-08-17). Data as JSON: /api/errors/ff12d3666e025794. Report an issue: GitHub.