@spec extract(String.t() | nil) :: String.t()

Extracts the longest JSON object string from content.

Tries markdown code blocks first (json or), then falls back to finding the outermost valid JSON object via balanced brace matching. Returns "" if no JSON is found.

@spec extract_all_objects(String.t()) :: [String.t()]

Extracts ALL valid JSON object strings found in content.

Returns a list of raw JSON strings, from left to right, or an empty list if none are found.

@spec extract_array(String.t() | nil) :: String.t()

Extracts the first JSON array [...] from content.

Tries markdown code blocks first, then falls back to balanced bracket matching. Returns the raw JSON string or "" if none found.

@spec extract_last_json_object(String.t()) :: {:ok, String.t()} | {:error, atom()}

Extracts the longest (outermost) valid JSON object from content.