tinyhumansai/openhuman · error · anyhow::Error

generated tool `{name}` has invalid schema: {err}

Error message

generated tool `{name}` has invalid schema: {err}

What it means

Wrapped error from validate_definition for generated (pack/toolpack) tools: the tool's parameters JSON schema failed validation. The generated tool {name} declares a schema that is malformed or fails the admission checks; {err} carries the validator's detail. Reached from both `new` and `validate_admission`.

Source

Thrown at src/openhuman/tools/generated.rs:332

    definition.provider_id = normalize_optional_provider_id(definition.provider_id.take());
    definition.capability_id = trim_option(definition.capability_id.take());
    definition.source_digest = trim_option(definition.source_digest.take());
    definition.policy_surface = trim_option(definition.policy_surface.take());
}

fn validate_definition(definition: &GeneratedToolDefinition) -> anyhow::Result<()> {
    let name = definition.name.trim();
    if name.is_empty() {
        anyhow::bail!("generated tool name must be non-empty");
    }
    if definition.description.trim().is_empty() {
        anyhow::bail!("generated tool `{name}` description must be non-empty");
    }
    if definition.adapter_id.trim().is_empty() {
        anyhow::bail!("generated tool `{name}` adapter_id must be non-empty");
    }
    crate::openhuman::tools::schema::SchemaCleanr::validate(&definition.parameters_schema)
        .map_err(|err| anyhow::anyhow!("generated tool `{name}` has invalid schema: {err}"))?;
    Ok(())
}

fn validate_admission(
    definition: &GeneratedToolDefinition,
    config: &GeneratedToolAdmissionConfig,
    normalized_disabled_providers: &BTreeSet<String>,
    normalized_trusted_providers: &BTreeSet<String>,
    seen: &mut BTreeSet<String>,
) -> Result<(), String> {
    validate_definition(definition).map_err(|err| err.to_string())?;
    if !is_safe_generated_tool_name(&definition.name) {
        return Err(format!(
            "generated tool `{}` name contains unsupported characters",
            definition.name
        ));
    }
    if !seen.insert(definition.name.clone()) {

View on GitHub (pinned to 7491200858)

Solutions

1. Read {err} to find the invalid schema construct
2. Fix the tool definition's parameters_schema to valid JSON Schema
3. Re-run admission; a generated tool with an invalid schema is rejected

When it happens

Trigger: Thrown at src/openhuman/tools/generated.rs:332 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/79c1e4686207983b. Report an issue: GitHub.