API Reference

The C ABI returns allocated JSON strings for most calls. Each returned string contains:

{"ok":true,"data":{}}

or:

{"ok":false,"error":{"code":"config_error","message":"..."}}

Free every returned string with ai_core_string_free.

Common Types

• AiCoreFfiHandle
• UTF-8 JSON char * inputs
• returned UTF-8 JSON char *
• package byte pointers plus lengths
• Unix timestamps for valid_at checks

Lifecycle

• ai_core_ffi_abi_version
• ai_core_version_json
• ai_core_handle_new
• ai_core_handle_free
• ai_core_string_free

Config And Catalog

• ai_core_apply_config_json
• ai_core_settings_catalog_json

License Material

Normal marketplace builds export:

• ai_core_add_core_license_document
• ai_core_add_core_license_key_material
• ai_core_clear_core_license_documents

no-marketplace builds omit these functions and install plaintext packages.

Packages

• ai_core_install_package_bytes

Pipelines

• ai_core_pipeline_start_json
• ai_core_pipeline_resume_json

Direct Calls

• ai_core_wasm_run_action_json
• ai_core_model_chat_json

Read Next

• Language Bindings for method contracts and examples.
• Runtime Contracts for config, packages, pipeline state, and events.
• AI Packages for package authoring, requirements.core, and tool/runtime variants.