Current behavior:
AIProxySwift 0.141.0 supports .outputTextAnnotationAdded for .fileCitation only. Web search citations aren't available as annotations.
What's missing:
The Responses API includes url_citation annotations with start_index/end_index indicating where URLs are cited in the text. These should be exposed via .outputTextAnnotationAdded, similar to .fileCitation.
Why it's needed:
Annotation indices allow precise detection of citation positions without regex parsing. This is more reliable and matches how file citations are handled.
Reference:
OpenAI docs:
-
response.output_text.annotation.added with url_citation type containing url, title, start_index, end_index.
-
https://platform.openai.com/docs/guides/tools-web-search
Current behavior:
AIProxySwift 0.141.0 supports
.outputTextAnnotationAddedfor.fileCitationonly. Web search citations aren't available as annotations.What's missing:
The Responses API includes
url_citationannotations withstart_index/end_indexindicating where URLs are cited in the text. These should be exposed via.outputTextAnnotationAdded, similar to.fileCitation.Why it's needed:
Annotation indices allow precise detection of citation positions without regex parsing. This is more reliable and matches how file citations are handled.
Reference:
OpenAI docs:
response.output_text.annotation.added with url_citation type containing url, title, start_index, end_index.
https://platform.openai.com/docs/guides/tools-web-search