ReferenceAPIsRust Library Referencenemo-relay-ffiapi

Function nemo_relay_tool_call_end

View as Markdown

Generated from cargo doc --no-deps -p nemo-relay -p nemo-relay-adaptive -p nemo-relay-ffi.

#[unsafe(no_mangle)]pub unsafe extern "C" fn nemo_relay_tool_call_end(
    handle: *const FfiToolHandle,
    result_json: *const c_char,
    data_json: *const c_char,
    metadata_json: *const c_char,
    timestamp_unix_micros: *const i64,
) -> NemoRelayStatus

End a manual tool call lifecycle span.

This emits a tool End event after applying sanitize-response guardrails to the observability payload. Response intercepts only run through nemo_relay_tool_call_execute.

Parameters

  • handle: The tool handle from nemo_relay_tool_call.
  • result_json: Tool result as a null-terminated JSON C string. This result becomes the end-event data after sanitize-response guardrails unless it sanitizes to JSON null.
  • data_json: Optional null-terminated JSON data used when the sanitized result is JSON null, or null.
  • metadata_json: Optional null-terminated JSON metadata recorded on the end event, or null.
  • timestamp_unix_micros: Optional Unix microseconds timestamp for the end event, or null to use the runtime default end timestamp.

Errors

Returns InvalidJson for invalid JSON inputs and InvalidArg when timestamp_unix_micros is outside the supported timestamp range.

Safety

handle and result_json must be valid, non-null pointers. Optional pointer arguments may be null; when non-null, they must be valid for reads for the duration of the call.