feat: Updated OpenAPI spec

src/libs/Phoenix/Generated/Phoenix.AnnotationsClient.ListSessionAnnotationsBySessionIds.g.cs

@@ -67,7 +67,7 @@ partial void ProcessListSessionAnnotationsBySessionIdsResponseContent(
         /// Optional list of annotation identifiers to filter by. Each value must be non-empty. If omitted, `session_ids` must be supplied. When combined with `session_ids`, results are the AND-intersection of both filters.
         /// </param>
         /// <param name="includeAnnotationNames">
-        /// Optional list of annotation names to include. If provided, only annotations with these names will be returned. 'note' annotations are excluded by default unless explicitly included in this list.
+        /// Optional list of annotation names to include. If provided, only annotations with these names will be returned (allowlist). When omitted, the response includes every matching row regardless of name (no annotation names are excluded by default).
         /// </param>
         /// <param name="excludeAnnotationNames">
         /// Optional list of annotation names to exclude from results.
@@ -121,7 +121,7 @@ partial void ProcessListSessionAnnotationsBySessionIdsResponseContent(
         /// Optional list of annotation identifiers to filter by. Each value must be non-empty. If omitted, `session_ids` must be supplied. When combined with `session_ids`, results are the AND-intersection of both filters.
         /// </param>
         /// <param name="includeAnnotationNames">
-        /// Optional list of annotation names to include. If provided, only annotations with these names will be returned. 'note' annotations are excluded by default unless explicitly included in this list.
+        /// Optional list of annotation names to include. If provided, only annotations with these names will be returned (allowlist). When omitted, the response includes every matching row regardless of name (no annotation names are excluded by default).
         /// </param>
         /// <param name="excludeAnnotationNames">
         /// Optional list of annotation names to exclude from results.

src/libs/Phoenix/Generated/Phoenix.AnnotationsClient.ListSpanAnnotationsBySpanIds.g.cs

@@ -67,7 +67,7 @@ partial void ProcessListSpanAnnotationsBySpanIdsResponseContent(
         /// Optional list of annotation identifiers to filter by. Each value must be non-empty. If omitted, `span_ids` must be supplied. When combined with `span_ids`, results are the AND-intersection of both filters.
         /// </param>
         /// <param name="includeAnnotationNames">
-        /// Optional list of annotation names to include. If provided, only annotations with these names will be returned. 'note' annotations are excluded by default unless explicitly included in this list.
+        /// Optional list of annotation names to include. If provided, only annotations with these names will be returned (allowlist). When omitted, the response includes every matching row regardless of name (no annotation names are excluded by default).
         /// </param>
         /// <param name="excludeAnnotationNames">
         /// Optional list of annotation names to exclude from results.
@@ -121,7 +121,7 @@ partial void ProcessListSpanAnnotationsBySpanIdsResponseContent(
         /// Optional list of annotation identifiers to filter by. Each value must be non-empty. If omitted, `span_ids` must be supplied. When combined with `span_ids`, results are the AND-intersection of both filters.
         /// </param>
         /// <param name="includeAnnotationNames">
-        /// Optional list of annotation names to include. If provided, only annotations with these names will be returned. 'note' annotations are excluded by default unless explicitly included in this list.
+        /// Optional list of annotation names to include. If provided, only annotations with these names will be returned (allowlist). When omitted, the response includes every matching row regardless of name (no annotation names are excluded by default).
         /// </param>
         /// <param name="excludeAnnotationNames">
         /// Optional list of annotation names to exclude from results.

src/libs/Phoenix/Generated/Phoenix.AnnotationsClient.ListTraceAnnotationsByTraceIds.g.cs

@@ -67,7 +67,7 @@ partial void ProcessListTraceAnnotationsByTraceIdsResponseContent(
         /// Optional list of annotation identifiers to filter by. Each value must be non-empty. If omitted, `trace_ids` must be supplied. When combined with `trace_ids`, results are the AND-intersection of both filters.
         /// </param>
         /// <param name="includeAnnotationNames">
-        /// Optional list of annotation names to include. If provided, only annotations with these names will be returned. 'note' annotations are excluded by default unless explicitly included in this list.
+        /// Optional list of annotation names to include. If provided, only annotations with these names will be returned (allowlist). When omitted, the response includes every matching row regardless of name (no annotation names are excluded by default).
         /// </param>
         /// <param name="excludeAnnotationNames">
         /// Optional list of annotation names to exclude from results.
@@ -121,7 +121,7 @@ partial void ProcessListTraceAnnotationsByTraceIdsResponseContent(
         /// Optional list of annotation identifiers to filter by. Each value must be non-empty. If omitted, `trace_ids` must be supplied. When combined with `trace_ids`, results are the AND-intersection of both filters.
         /// </param>
         /// <param name="includeAnnotationNames">
-        /// Optional list of annotation names to include. If provided, only annotations with these names will be returned. 'note' annotations are excluded by default unless explicitly included in this list.
+        /// Optional list of annotation names to include. If provided, only annotations with these names will be returned (allowlist). When omitted, the response includes every matching row regardless of name (no annotation names are excluded by default).
         /// </param>
         /// <param name="excludeAnnotationNames">
         /// Optional list of annotation names to exclude from results.

src/libs/Phoenix/Generated/Phoenix.IAnnotationsClient.ListSessionAnnotationsBySessionIds.g.cs

@@ -18,7 +18,7 @@ public partial interface IAnnotationsClient
         /// Optional list of annotation identifiers to filter by. Each value must be non-empty. If omitted, `session_ids` must be supplied. When combined with `session_ids`, results are the AND-intersection of both filters.
         /// </param>
         /// <param name="includeAnnotationNames">
-        /// Optional list of annotation names to include. If provided, only annotations with these names will be returned. 'note' annotations are excluded by default unless explicitly included in this list.
+        /// Optional list of annotation names to include. If provided, only annotations with these names will be returned (allowlist). When omitted, the response includes every matching row regardless of name (no annotation names are excluded by default).
         /// </param>
         /// <param name="excludeAnnotationNames">
         /// Optional list of annotation names to exclude from results.
@@ -57,7 +57,7 @@ public partial interface IAnnotationsClient
         /// Optional list of annotation identifiers to filter by. Each value must be non-empty. If omitted, `session_ids` must be supplied. When combined with `session_ids`, results are the AND-intersection of both filters.
         /// </param>
         /// <param name="includeAnnotationNames">
-        /// Optional list of annotation names to include. If provided, only annotations with these names will be returned. 'note' annotations are excluded by default unless explicitly included in this list.
+        /// Optional list of annotation names to include. If provided, only annotations with these names will be returned (allowlist). When omitted, the response includes every matching row regardless of name (no annotation names are excluded by default).
         /// </param>
         /// <param name="excludeAnnotationNames">
         /// Optional list of annotation names to exclude from results.

src/libs/Phoenix/Generated/Phoenix.IAnnotationsClient.ListSpanAnnotationsBySpanIds.g.cs

@@ -18,7 +18,7 @@ public partial interface IAnnotationsClient
         /// Optional list of annotation identifiers to filter by. Each value must be non-empty. If omitted, `span_ids` must be supplied. When combined with `span_ids`, results are the AND-intersection of both filters.
         /// </param>
         /// <param name="includeAnnotationNames">
-        /// Optional list of annotation names to include. If provided, only annotations with these names will be returned. 'note' annotations are excluded by default unless explicitly included in this list.
+        /// Optional list of annotation names to include. If provided, only annotations with these names will be returned (allowlist). When omitted, the response includes every matching row regardless of name (no annotation names are excluded by default).
         /// </param>
         /// <param name="excludeAnnotationNames">
         /// Optional list of annotation names to exclude from results.
@@ -57,7 +57,7 @@ public partial interface IAnnotationsClient
         /// Optional list of annotation identifiers to filter by. Each value must be non-empty. If omitted, `span_ids` must be supplied. When combined with `span_ids`, results are the AND-intersection of both filters.
         /// </param>
         /// <param name="includeAnnotationNames">
-        /// Optional list of annotation names to include. If provided, only annotations with these names will be returned. 'note' annotations are excluded by default unless explicitly included in this list.
+        /// Optional list of annotation names to include. If provided, only annotations with these names will be returned (allowlist). When omitted, the response includes every matching row regardless of name (no annotation names are excluded by default).
         /// </param>
         /// <param name="excludeAnnotationNames">
         /// Optional list of annotation names to exclude from results.

src/libs/Phoenix/Generated/Phoenix.IAnnotationsClient.ListTraceAnnotationsByTraceIds.g.cs

@@ -18,7 +18,7 @@ public partial interface IAnnotationsClient
         /// Optional list of annotation identifiers to filter by. Each value must be non-empty. If omitted, `trace_ids` must be supplied. When combined with `trace_ids`, results are the AND-intersection of both filters.
         /// </param>
         /// <param name="includeAnnotationNames">
-        /// Optional list of annotation names to include. If provided, only annotations with these names will be returned. 'note' annotations are excluded by default unless explicitly included in this list.
+        /// Optional list of annotation names to include. If provided, only annotations with these names will be returned (allowlist). When omitted, the response includes every matching row regardless of name (no annotation names are excluded by default).
         /// </param>
         /// <param name="excludeAnnotationNames">
         /// Optional list of annotation names to exclude from results.
@@ -57,7 +57,7 @@ public partial interface IAnnotationsClient
         /// Optional list of annotation identifiers to filter by. Each value must be non-empty. If omitted, `trace_ids` must be supplied. When combined with `trace_ids`, results are the AND-intersection of both filters.
         /// </param>
         /// <param name="includeAnnotationNames">
-        /// Optional list of annotation names to include. If provided, only annotations with these names will be returned. 'note' annotations are excluded by default unless explicitly included in this list.
+        /// Optional list of annotation names to include. If provided, only annotations with these names will be returned (allowlist). When omitted, the response includes every matching row regardless of name (no annotation names are excluded by default).
         /// </param>
         /// <param name="excludeAnnotationNames">
         /// Optional list of annotation names to exclude from results.

src/libs/Phoenix/Generated/Phoenix.ISessionsClient.CreateSessionNote.g.cs

@@ -6,7 +6,7 @@ public partial interface ISessionsClient
     {
         /// <summary>
         /// Create a session note<br/>
-        /// Add a note annotation to a session. Each call appends a new note with an auto-generated UUIDv4 identifier, so multiple notes accumulate on the same session. Structured annotations, by contrast, are keyed by (name, session_id, identifier) — re-writing the same key overwrites the existing annotation, so to keep multiple structured annotations with the same name on a session you must supply distinct identifiers.
+        /// Add a note annotation to a session. By default each call appends a new note with an auto-generated UUIDv4 identifier, so multiple notes accumulate on the same session. Callers may supply a non-empty `identifier` to upsert on (session_id, name='note', identifier) — repeated calls with the same identifier overwrite the existing note, matching the semantics of structured annotations.
         /// </summary>
         /// <param name="request"></param>
         /// <param name="requestOptions">Per-request overrides such as headers, query parameters, timeout, retries, and response buffering.</param>
@@ -19,7 +19,7 @@ public partial interface ISessionsClient
             global::System.Threading.CancellationToken cancellationToken = default);
         /// <summary>
         /// Create a session note<br/>
-        /// Add a note annotation to a session. Each call appends a new note with an auto-generated UUIDv4 identifier, so multiple notes accumulate on the same session. Structured annotations, by contrast, are keyed by (name, session_id, identifier) — re-writing the same key overwrites the existing annotation, so to keep multiple structured annotations with the same name on a session you must supply distinct identifiers.
+        /// Add a note annotation to a session. By default each call appends a new note with an auto-generated UUIDv4 identifier, so multiple notes accumulate on the same session. Callers may supply a non-empty `identifier` to upsert on (session_id, name='note', identifier) — repeated calls with the same identifier overwrite the existing note, matching the semantics of structured annotations.
         /// </summary>
         /// <param name="request"></param>
         /// <param name="requestOptions">Per-request overrides such as headers, query parameters, timeout, retries, and response buffering.</param>
@@ -32,7 +32,7 @@ public partial interface ISessionsClient
             global::System.Threading.CancellationToken cancellationToken = default);
         /// <summary>
         /// Create a session note<br/>
-        /// Add a note annotation to a session. Each call appends a new note with an auto-generated UUIDv4 identifier, so multiple notes accumulate on the same session. Structured annotations, by contrast, are keyed by (name, session_id, identifier) — re-writing the same key overwrites the existing annotation, so to keep multiple structured annotations with the same name on a session you must supply distinct identifiers.
+        /// Add a note annotation to a session. By default each call appends a new note with an auto-generated UUIDv4 identifier, so multiple notes accumulate on the same session. Callers may supply a non-empty `identifier` to upsert on (session_id, name='note', identifier) — repeated calls with the same identifier overwrite the existing note, matching the semantics of structured annotations.
         /// </summary>
         /// <param name="data"></param>
         /// <param name="requestOptions">Per-request overrides such as headers, query parameters, timeout, retries, and response buffering.</param>

src/libs/Phoenix/Generated/Phoenix.ISpansClient.CreateSpanNote.g.cs

@@ -6,7 +6,7 @@ public partial interface ISpansClient
     {
         /// <summary>
         /// Create a span note<br/>
-        /// Add a note annotation to a span. Each call appends a new note with an auto-generated UUIDv4 identifier, so multiple notes accumulate on the same span. Structured annotations, by contrast, are keyed by (name, span_id, identifier) — re-writing the same key overwrites the existing annotation, so to keep multiple structured annotations with the same name on a span you must supply distinct identifiers.
+        /// Add a note annotation to a span. By default each call appends a new note with an auto-generated UUIDv4 identifier, so multiple notes accumulate on the same span. Callers may supply a non-empty `identifier` to upsert on (span_id, name='note', identifier) — repeated calls with the same identifier overwrite the existing note, matching the semantics of structured annotations.
         /// </summary>
         /// <param name="request"></param>
         /// <param name="requestOptions">Per-request overrides such as headers, query parameters, timeout, retries, and response buffering.</param>
@@ -19,7 +19,7 @@ public partial interface ISpansClient
             global::System.Threading.CancellationToken cancellationToken = default);
         /// <summary>
         /// Create a span note<br/>
-        /// Add a note annotation to a span. Each call appends a new note with an auto-generated UUIDv4 identifier, so multiple notes accumulate on the same span. Structured annotations, by contrast, are keyed by (name, span_id, identifier) — re-writing the same key overwrites the existing annotation, so to keep multiple structured annotations with the same name on a span you must supply distinct identifiers.
+        /// Add a note annotation to a span. By default each call appends a new note with an auto-generated UUIDv4 identifier, so multiple notes accumulate on the same span. Callers may supply a non-empty `identifier` to upsert on (span_id, name='note', identifier) — repeated calls with the same identifier overwrite the existing note, matching the semantics of structured annotations.
         /// </summary>
         /// <param name="request"></param>
         /// <param name="requestOptions">Per-request overrides such as headers, query parameters, timeout, retries, and response buffering.</param>
@@ -32,7 +32,7 @@ public partial interface ISpansClient
             global::System.Threading.CancellationToken cancellationToken = default);
         /// <summary>
         /// Create a span note<br/>
-        /// Add a note annotation to a span. Each call appends a new note with an auto-generated UUIDv4 identifier, so multiple notes accumulate on the same span. Structured annotations, by contrast, are keyed by (name, span_id, identifier) — re-writing the same key overwrites the existing annotation, so to keep multiple structured annotations with the same name on a span you must supply distinct identifiers.
+        /// Add a note annotation to a span. By default each call appends a new note with an auto-generated UUIDv4 identifier, so multiple notes accumulate on the same span. Callers may supply a non-empty `identifier` to upsert on (span_id, name='note', identifier) — repeated calls with the same identifier overwrite the existing note, matching the semantics of structured annotations.
         /// </summary>
         /// <param name="data"></param>
         /// <param name="requestOptions">Per-request overrides such as headers, query parameters, timeout, retries, and response buffering.</param>