json.h File Reference

Registry-backed JSON schemas and conversion through CLI option handlers. More...

Go to the source code of this file.

Functions
yyjson_mut_val *	options_json_schema_for_option (yyjson_mut_doc *doc, const char *name)
asciichat_error_t	options_json_parse_value (const char *name, yyjson_val *value, char *output, size_t output_size, bool *omitted)

Detailed Description

Registry-backed JSON schemas and conversion through CLI option handlers.

Definition in file include/ascii-chat/options/json.h.

Function Documentation

options_json_parse_value()

asciichat_error_t options_json_parse_value	(	const char *	name,
		yyjson_val *	value,
		char *	output,
		size_t	output_size,
		bool *	omitted )

Convert and parse a JSON value with the CLI handler, without publishing global options. omitted is set for an explicitly disabled optional flag such as test-pattern=false. Full cross-option validation remains in the normal CLI worker initialization.

Definition at line 78 of file options/json.c.

                                                          {
  if (!name || !v || !output || !output_size || !omitted)
    return SET_ERRNO(ERROR_INVALID_PARAM, "Missing JSON option argument");
  *omitted = false;
  const registry_entry_t *e = registry_find_entry_by_name(name);
  if (!e || e->type < 0 || e->type >= NUM_OPTION_TYPES || e->type == OPTION_TYPE_ACTION || e->owns_memory)
    return SET_ERRNO(ERROR_INVALID_PARAM, "Unsupported value option: %s", name);
  asciichat_error_t err = validate_value(e, v);
  if (err != ASCIICHAT_OK)
    return err;
  if (yyjson_is_str(v)) {
    size_t len = yyjson_get_len(v);
    if (len >= output_size || (e->type == OPTION_TYPE_STRING && e->default_value_size && len >= e->default_value_size))
      return SET_ERRNO(ERROR_INVALID_PARAM, "Option value too long: %s", name);
    SAFE_STRNCPY(output, yyjson_get_str(v), output_size);
  } else if (yyjson_is_bool(v)) {
    SAFE_SNPRINTF(output, output_size, "%s", yyjson_get_bool(v) ? "true" : "false");
  } else {
    SAFE_SNPRINTF(output, output_size, "%.17g", yyjson_get_num(v));
  }
  if (!strcmp(name, "test-pattern") && yyjson_is_bool(v)) {
    if (!yyjson_get_bool(v)) {
      *omitted = true;
      return ASCIICHAT_OK;
    }
    SAFE_SNPRINTF(output, output_size, "0");
  }
  // Use the same registry descriptor and handlers as options_config_parse().
  option_descriptor_t descriptor = registry_entry_to_descriptor(e);
  options_t *scratch = SAFE_CALLOC(1, sizeof(*scratch), options_t *);
  err = g_builder_handlers[descriptor.type].apply_cli((char *)scratch + descriptor.offset, output, &descriptor);
  SAFE_FREE(scratch);
  return err;
}

References ASCIICHAT_OK, registry_entry_t::default_value_size, ERROR_INVALID_PARAM, option_descriptor_t::offset, OPTION_TYPE_ACTION, OPTION_TYPE_STRING, registry_entry_t::owns_memory, registry_entry_to_descriptor(), registry_find_entry_by_name(), SAFE_CALLOC, SAFE_FREE, SAFE_SNPRINTF, SAFE_STRNCPY, SET_ERRNO, option_descriptor_t::type, and registry_entry_t::type.

Referenced by mcp_request_parse().

options_json_schema_for_option()

yyjson_mut_val * options_json_schema_for_option	(	yyjson_mut_doc *	doc,
		const char *	name )

Generate a JSON property from a registered option's metadata; document owns the result.

Definition at line 37 of file options/json.c.

                                                                                    {
  if (!d || !name) {
    SET_ERRNO(ERROR_INVALID_PARAM, "Missing option schema argument");
    return NULL;
  }
  const registry_entry_t *e = registry_find_entry_by_name(name);
  if (!e || e->type == OPTION_TYPE_ACTION) {
    SET_ERRNO(ERROR_INVALID_PARAM, "Unknown value option: %s", name);
    return NULL;
  }
  yyjson_mut_val *v = yyjson_mut_obj(d);
  yyjson_mut_obj_add_str(d, v, "type", json_type(e));
  yyjson_mut_obj_add_str(d, v, "description", e->help_text);
  if (e->metadata.enum_values) {
    yyjson_mut_val *values = yyjson_mut_arr(d);
    for (size_t i = 0; e->metadata.enum_values[i]; i++)
      yyjson_mut_arr_add_str(d, values, e->metadata.enum_values[i]);
    yyjson_mut_obj_add_val(d, v, "enum", values);
  }
  if (!strcmp(name, "test-pattern")) {
    yyjson_mut_obj_remove_str(v, "type");
    yyjson_mut_obj_remove_str(v, "enum");
    yyjson_mut_val *values = yyjson_mut_arr(d);
    yyjson_mut_arr_add_bool(d, values, true);
    yyjson_mut_arr_add_bool(d, values, false);
    yyjson_mut_arr_add_int(d, values, 0);
    yyjson_mut_arr_add_int(d, values, 1);
    yyjson_mut_arr_add_str(d, values, "0");
    yyjson_mut_arr_add_str(d, values, "1");
    yyjson_mut_obj_add_val(d, v, "enum", values);
  }
  if (!strcmp(name, "seek")) {
    yyjson_mut_obj_remove_str(v, "type");
    yyjson_mut_val *types = yyjson_mut_arr(d);
    yyjson_mut_arr_add_str(d, types, "string");
    yyjson_mut_arr_add_str(d, types, "number");
    yyjson_mut_obj_add_val(d, v, "type", types);
  }
  return v;
}

References option_metadata_t::enum_values, ERROR_INVALID_PARAM, registry_entry_t::help_text, registry_entry_t::metadata, OPTION_TYPE_ACTION, registry_find_entry_by_name(), SET_ERRNO, and registry_entry_t::type.

Referenced by mcp_tools_schema().