two version of R2R are hereHEADmaster

12 files changed, 546 insertions, 0 deletions

diff --git a/.venv/lib/python3.12/site-packages/opentelemetry/semconv/attributes/__init__.py b/.venv/lib/python3.12/site-packages/opentelemetry/semconv/attributes/__init__.py
new file mode 100644
index 00000000..e69de29b
--- /dev/null
+++ b/.venv/lib/python3.12/site-packages/opentelemetry/semconv/attributes/__init__.py
diff --git a/.venv/lib/python3.12/site-packages/opentelemetry/semconv/attributes/client_attributes.py b/.venv/lib/python3.12/site-packages/opentelemetry/semconv/attributes/client_attributes.py
new file mode 100644
index 00000000..d6dd88bf
--- /dev/null
+++ b/.venv/lib/python3.12/site-packages/opentelemetry/semconv/attributes/client_attributes.py
@@ -0,0 +1,27 @@
+# Copyright The OpenTelemetry Authors
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from typing import Final
+
+CLIENT_ADDRESS: Final = "client.address"
+"""
+Client address - domain name if available without reverse DNS lookup; otherwise, IP address or Unix domain socket name.
+Note: When observed from the server side, and when communicating through an intermediary, `client.address` SHOULD represent the client address behind any intermediaries,  for example proxies, if it's available.
+"""
+
+CLIENT_PORT: Final = "client.port"
+"""
+Client port number.
+Note: When observed from the server side, and when communicating through an intermediary, `client.port` SHOULD represent the client port behind any intermediaries,  for example proxies, if it's available.
+"""
diff --git a/.venv/lib/python3.12/site-packages/opentelemetry/semconv/attributes/error_attributes.py b/.venv/lib/python3.12/site-packages/opentelemetry/semconv/attributes/error_attributes.py
new file mode 100644
index 00000000..6ffd2b9b
--- /dev/null
+++ b/.venv/lib/python3.12/site-packages/opentelemetry/semconv/attributes/error_attributes.py
@@ -0,0 +1,45 @@
+# Copyright The OpenTelemetry Authors
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from enum import Enum
+from typing import Final
+
+ERROR_TYPE: Final = "error.type"
+"""
+Describes a class of error the operation ended with.
+Note: The `error.type` SHOULD be predictable, and SHOULD have low cardinality.
+
+When `error.type` is set to a type (e.g., an exception type), its
+canonical class name identifying the type within the artifact SHOULD be used.
+
+Instrumentations SHOULD document the list of errors they report.
+
+The cardinality of `error.type` within one instrumentation library SHOULD be low.
+Telemetry consumers that aggregate data from multiple instrumentation libraries and applications
+should be prepared for `error.type` to have high cardinality at query time when no
+additional filters are applied.
+
+If the operation has completed successfully, instrumentations SHOULD NOT set `error.type`.
+
+If a specific domain defines its own set of error identifiers (such as HTTP or gRPC status codes),
+it's RECOMMENDED to:
+
+- Use a domain-specific attribute
+- Set `error.type` to capture all errors, regardless of whether they are defined within the domain-specific set or not.
+"""
+
+
+class ErrorTypeValues(Enum):
+    OTHER = "_OTHER"
+    """A fallback error value to be used when the instrumentation doesn't define a custom value."""
diff --git a/.venv/lib/python3.12/site-packages/opentelemetry/semconv/attributes/exception_attributes.py b/.venv/lib/python3.12/site-packages/opentelemetry/semconv/attributes/exception_attributes.py
new file mode 100644
index 00000000..7f396abe
--- /dev/null
+++ b/.venv/lib/python3.12/site-packages/opentelemetry/semconv/attributes/exception_attributes.py
@@ -0,0 +1,35 @@
+# Copyright The OpenTelemetry Authors
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from typing import Final
+
+EXCEPTION_ESCAPED: Final = "exception.escaped"
+"""
+Deprecated: It's no longer recommended to record exceptions that are handled and do not escape the scope of a span.
+"""
+
+EXCEPTION_MESSAGE: Final = "exception.message"
+"""
+The exception message.
+"""
+
+EXCEPTION_STACKTRACE: Final = "exception.stacktrace"
+"""
+A stacktrace as a string in the natural representation for the language runtime. The representation is to be determined and documented by each language SIG.
+"""
+
+EXCEPTION_TYPE: Final = "exception.type"
+"""
+The type of the exception (its fully-qualified class name, if applicable). The dynamic type of the exception should be preferred over the static type in languages that support it.
+"""
diff --git a/.venv/lib/python3.12/site-packages/opentelemetry/semconv/attributes/http_attributes.py b/.venv/lib/python3.12/site-packages/opentelemetry/semconv/attributes/http_attributes.py
new file mode 100644
index 00000000..bec7c0c7
--- /dev/null
+++ b/.venv/lib/python3.12/site-packages/opentelemetry/semconv/attributes/http_attributes.py
@@ -0,0 +1,97 @@
+# Copyright The OpenTelemetry Authors
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from enum import Enum
+from typing import Final
+
+HTTP_REQUEST_HEADER_TEMPLATE: Final = "http.request.header"
+"""
+HTTP request headers, `<key>` being the normalized HTTP Header name (lowercase), the value being the header values.
+Note: Instrumentations SHOULD require an explicit configuration of which headers are to be captured. Including all request headers can be a security risk - explicit configuration helps avoid leaking sensitive information.
+The `User-Agent` header is already captured in the `user_agent.original` attribute. Users MAY explicitly configure instrumentations to capture them even though it is not recommended.
+The attribute value MUST consist of either multiple header values as an array of strings or a single-item array containing a possibly comma-concatenated string, depending on the way the HTTP library provides access to headers.
+"""
+
+HTTP_REQUEST_METHOD: Final = "http.request.method"
+"""
+HTTP request method.
+Note: HTTP request method value SHOULD be "known" to the instrumentation.
+By default, this convention defines "known" methods as the ones listed in [RFC9110](https://www.rfc-editor.org/rfc/rfc9110.html#name-methods)
+and the PATCH method defined in [RFC5789](https://www.rfc-editor.org/rfc/rfc5789.html).
+
+If the HTTP request method is not known to instrumentation, it MUST set the `http.request.method` attribute to `_OTHER`.
+
+If the HTTP instrumentation could end up converting valid HTTP request methods to `_OTHER`, then it MUST provide a way to override
+the list of known HTTP methods. If this override is done via environment variable, then the environment variable MUST be named
+OTEL_INSTRUMENTATION_HTTP_KNOWN_METHODS and support a comma-separated list of case-sensitive known HTTP methods
+(this list MUST be a full override of the default known method, it is not a list of known methods in addition to the defaults).
+
+HTTP method names are case-sensitive and `http.request.method` attribute value MUST match a known HTTP method name exactly.
+Instrumentations for specific web frameworks that consider HTTP methods to be case insensitive, SHOULD populate a canonical equivalent.
+Tracing instrumentations that do so, MUST also set `http.request.method_original` to the original value.
+"""
+
+HTTP_REQUEST_METHOD_ORIGINAL: Final = "http.request.method_original"
+"""
+Original HTTP method sent by the client in the request line.
+"""
+
+HTTP_REQUEST_RESEND_COUNT: Final = "http.request.resend_count"
+"""
+The ordinal number of request resending attempt (for any reason, including redirects).
+Note: The resend count SHOULD be updated each time an HTTP request gets resent by the client, regardless of what was the cause of the resending (e.g. redirection, authorization failure, 503 Server Unavailable, network issues, or any other).
+"""
+
+HTTP_RESPONSE_HEADER_TEMPLATE: Final = "http.response.header"
+"""
+HTTP response headers, `<key>` being the normalized HTTP Header name (lowercase), the value being the header values.
+Note: Instrumentations SHOULD require an explicit configuration of which headers are to be captured. Including all response headers can be a security risk - explicit configuration helps avoid leaking sensitive information.
+Users MAY explicitly configure instrumentations to capture them even though it is not recommended.
+The attribute value MUST consist of either multiple header values as an array of strings or a single-item array containing a possibly comma-concatenated string, depending on the way the HTTP library provides access to headers.
+"""
+
+HTTP_RESPONSE_STATUS_CODE: Final = "http.response.status_code"
+"""
+[HTTP response status code](https://tools.ietf.org/html/rfc7231#section-6).
+"""
+
+HTTP_ROUTE: Final = "http.route"
+"""
+The matched route, that is, the path template in the format used by the respective server framework.
+Note: MUST NOT be populated when this is not supported by the HTTP server framework as the route attribute should have low-cardinality and the URI path can NOT substitute it.
+SHOULD include the [application root](/docs/http/http-spans.md#http-server-definitions) if there is one.
+"""
+
+
+class HttpRequestMethodValues(Enum):
+    CONNECT = "CONNECT"
+    """CONNECT method."""
+    DELETE = "DELETE"
+    """DELETE method."""
+    GET = "GET"
+    """GET method."""
+    HEAD = "HEAD"
+    """HEAD method."""
+    OPTIONS = "OPTIONS"
+    """OPTIONS method."""
+    PATCH = "PATCH"
+    """PATCH method."""
+    POST = "POST"
+    """POST method."""
+    PUT = "PUT"
+    """PUT method."""
+    TRACE = "TRACE"
+    """TRACE method."""
+    OTHER = "_OTHER"
+    """Any HTTP method that the instrumentation has no prior knowledge of."""
diff --git a/.venv/lib/python3.12/site-packages/opentelemetry/semconv/attributes/network_attributes.py b/.venv/lib/python3.12/site-packages/opentelemetry/semconv/attributes/network_attributes.py
new file mode 100644
index 00000000..c09fe2e0
--- /dev/null
+++ b/.venv/lib/python3.12/site-packages/opentelemetry/semconv/attributes/network_attributes.py
@@ -0,0 +1,84 @@
+# Copyright The OpenTelemetry Authors
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from enum import Enum
+from typing import Final
+
+NETWORK_LOCAL_ADDRESS: Final = "network.local.address"
+"""
+Local address of the network connection - IP address or Unix domain socket name.
+"""
+
+NETWORK_LOCAL_PORT: Final = "network.local.port"
+"""
+Local port number of the network connection.
+"""
+
+NETWORK_PEER_ADDRESS: Final = "network.peer.address"
+"""
+Peer address of the network connection - IP address or Unix domain socket name.
+"""
+
+NETWORK_PEER_PORT: Final = "network.peer.port"
+"""
+Peer port number of the network connection.
+"""
+
+NETWORK_PROTOCOL_NAME: Final = "network.protocol.name"
+"""
+[OSI application layer](https://wikipedia.org/wiki/Application_layer) or non-OSI equivalent.
+Note: The value SHOULD be normalized to lowercase.
+"""
+
+NETWORK_PROTOCOL_VERSION: Final = "network.protocol.version"
+"""
+The actual version of the protocol used for network communication.
+Note: If protocol version is subject to negotiation (for example using [ALPN](https://www.rfc-editor.org/rfc/rfc7301.html)), this attribute SHOULD be set to the negotiated version. If the actual protocol version is not known, this attribute SHOULD NOT be set.
+"""
+
+NETWORK_TRANSPORT: Final = "network.transport"
+"""
+[OSI transport layer](https://wikipedia.org/wiki/Transport_layer) or [inter-process communication method](https://wikipedia.org/wiki/Inter-process_communication).
+Note: The value SHOULD be normalized to lowercase.
+
+Consider always setting the transport when setting a port number, since
+a port number is ambiguous without knowing the transport. For example
+different processes could be listening on TCP port 12345 and UDP port 12345.
+"""
+
+NETWORK_TYPE: Final = "network.type"
+"""
+[OSI network layer](https://wikipedia.org/wiki/Network_layer) or non-OSI equivalent.
+Note: The value SHOULD be normalized to lowercase.
+"""
+
+
+class NetworkTransportValues(Enum):
+    TCP = "tcp"
+    """TCP."""
+    UDP = "udp"
+    """UDP."""
+    PIPE = "pipe"
+    """Named or anonymous pipe."""
+    UNIX = "unix"
+    """Unix domain socket."""
+    QUIC = "quic"
+    """QUIC."""
+
+
+class NetworkTypeValues(Enum):
+    IPV4 = "ipv4"
+    """IPv4."""
+    IPV6 = "ipv6"
+    """IPv6."""
diff --git a/.venv/lib/python3.12/site-packages/opentelemetry/semconv/attributes/otel_attributes.py b/.venv/lib/python3.12/site-packages/opentelemetry/semconv/attributes/otel_attributes.py
new file mode 100644
index 00000000..134e246e
--- /dev/null
+++ b/.venv/lib/python3.12/site-packages/opentelemetry/semconv/attributes/otel_attributes.py
@@ -0,0 +1,43 @@
+# Copyright The OpenTelemetry Authors
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from enum import Enum
+from typing import Final
+
+OTEL_SCOPE_NAME: Final = "otel.scope.name"
+"""
+The name of the instrumentation scope - (`InstrumentationScope.Name` in OTLP).
+"""
+
+OTEL_SCOPE_VERSION: Final = "otel.scope.version"
+"""
+The version of the instrumentation scope - (`InstrumentationScope.Version` in OTLP).
+"""
+
+OTEL_STATUS_CODE: Final = "otel.status_code"
+"""
+Name of the code, either "OK" or "ERROR". MUST NOT be set if the status code is UNSET.
+"""
+
+OTEL_STATUS_DESCRIPTION: Final = "otel.status_description"
+"""
+Description of the Status if it has a value, otherwise not set.
+"""
+
+
+class OtelStatusCodeValues(Enum):
+    OK = "OK"
+    """The operation has been validated by an Application developer or Operator to have completed successfully."""
+    ERROR = "ERROR"
+    """The operation contains an error."""
diff --git a/.venv/lib/python3.12/site-packages/opentelemetry/semconv/attributes/server_attributes.py b/.venv/lib/python3.12/site-packages/opentelemetry/semconv/attributes/server_attributes.py
new file mode 100644
index 00000000..6b2658da
--- /dev/null
+++ b/.venv/lib/python3.12/site-packages/opentelemetry/semconv/attributes/server_attributes.py
@@ -0,0 +1,27 @@
+# Copyright The OpenTelemetry Authors
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from typing import Final
+
+SERVER_ADDRESS: Final = "server.address"
+"""
+Server domain name if available without reverse DNS lookup; otherwise, IP address or Unix domain socket name.
+Note: When observed from the client side, and when communicating through an intermediary, `server.address` SHOULD represent the server address behind any intermediaries, for example proxies, if it's available.
+"""
+
+SERVER_PORT: Final = "server.port"
+"""
+Server port number.
+Note: When observed from the client side, and when communicating through an intermediary, `server.port` SHOULD represent the server port behind any intermediaries, for example proxies, if it's available.
+"""
diff --git a/.venv/lib/python3.12/site-packages/opentelemetry/semconv/attributes/service_attributes.py b/.venv/lib/python3.12/site-packages/opentelemetry/semconv/attributes/service_attributes.py
new file mode 100644
index 00000000..7ad038e9
--- /dev/null
+++ b/.venv/lib/python3.12/site-packages/opentelemetry/semconv/attributes/service_attributes.py
@@ -0,0 +1,26 @@
+# Copyright The OpenTelemetry Authors
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from typing import Final
+
+SERVICE_NAME: Final = "service.name"
+"""
+Logical name of the service.
+Note: MUST be the same for all instances of horizontally scaled services. If the value was not specified, SDKs MUST fallback to `unknown_service:` concatenated with [`process.executable.name`](process.md), e.g. `unknown_service:bash`. If `process.executable.name` is not available, the value MUST be set to `unknown_service`.
+"""
+
+SERVICE_VERSION: Final = "service.version"
+"""
+The version string of the service API or implementation. The format is not defined by these conventions.
+"""
diff --git a/.venv/lib/python3.12/site-packages/opentelemetry/semconv/attributes/telemetry_attributes.py b/.venv/lib/python3.12/site-packages/opentelemetry/semconv/attributes/telemetry_attributes.py
new file mode 100644
index 00000000..29aadeb7
--- /dev/null
+++ b/.venv/lib/python3.12/site-packages/opentelemetry/semconv/attributes/telemetry_attributes.py
@@ -0,0 +1,64 @@
+# Copyright The OpenTelemetry Authors
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from enum import Enum
+from typing import Final
+
+TELEMETRY_SDK_LANGUAGE: Final = "telemetry.sdk.language"
+"""
+The language of the telemetry SDK.
+"""
+
+TELEMETRY_SDK_NAME: Final = "telemetry.sdk.name"
+"""
+The name of the telemetry SDK as defined above.
+Note: The OpenTelemetry SDK MUST set the `telemetry.sdk.name` attribute to `opentelemetry`.
+If another SDK, like a fork or a vendor-provided implementation, is used, this SDK MUST set the
+`telemetry.sdk.name` attribute to the fully-qualified class or module name of this SDK's main entry point
+or another suitable identifier depending on the language.
+The identifier `opentelemetry` is reserved and MUST NOT be used in this case.
+All custom identifiers SHOULD be stable across different versions of an implementation.
+"""
+
+TELEMETRY_SDK_VERSION: Final = "telemetry.sdk.version"
+"""
+The version string of the telemetry SDK.
+"""
+
+
+class TelemetrySdkLanguageValues(Enum):
+    CPP = "cpp"
+    """cpp."""
+    DOTNET = "dotnet"
+    """dotnet."""
+    ERLANG = "erlang"
+    """erlang."""
+    GO = "go"
+    """go."""
+    JAVA = "java"
+    """java."""
+    NODEJS = "nodejs"
+    """nodejs."""
+    PHP = "php"
+    """php."""
+    PYTHON = "python"
+    """python."""
+    RUBY = "ruby"
+    """ruby."""
+    RUST = "rust"
+    """rust."""
+    SWIFT = "swift"
+    """swift."""
+    WEBJS = "webjs"
+    """webjs."""
diff --git a/.venv/lib/python3.12/site-packages/opentelemetry/semconv/attributes/url_attributes.py b/.venv/lib/python3.12/site-packages/opentelemetry/semconv/attributes/url_attributes.py
new file mode 100644
index 00000000..404eef1b
--- /dev/null
+++ b/.venv/lib/python3.12/site-packages/opentelemetry/semconv/attributes/url_attributes.py
@@ -0,0 +1,78 @@
+# Copyright The OpenTelemetry Authors
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from typing import Final
+
+URL_FRAGMENT: Final = "url.fragment"
+"""
+The [URI fragment](https://www.rfc-editor.org/rfc/rfc3986#section-3.5) component.
+"""
+
+URL_FULL: Final = "url.full"
+"""
+Absolute URL describing a network resource according to [RFC3986](https://www.rfc-editor.org/rfc/rfc3986).
+Note: For network calls, URL usually has `scheme://host[:port][path][?query][#fragment]` format, where the fragment
+is not transmitted over HTTP, but if it is known, it SHOULD be included nevertheless.
+
+`url.full` MUST NOT contain credentials passed via URL in form of `https://username:password@www.example.com/`.
+In such case username and password SHOULD be redacted and attribute's value SHOULD be `https://REDACTED:REDACTED@www.example.com/`.
+
+`url.full` SHOULD capture the absolute URL when it is available (or can be reconstructed).
+
+Sensitive content provided in `url.full` SHOULD be scrubbed when instrumentations can identify it.
+
+![Development](https://img.shields.io/badge/-development-blue)
+Query string values for the following keys SHOULD be redacted by default and replaced by the
+value `REDACTED`:
+
+* [`AWSAccessKeyId`](https://docs.aws.amazon.com/AmazonS3/latest/userguide/RESTAuthentication.html#RESTAuthenticationQueryStringAuth)
+* [`Signature`](https://docs.aws.amazon.com/AmazonS3/latest/userguide/RESTAuthentication.html#RESTAuthenticationQueryStringAuth)
+* [`sig`](https://learn.microsoft.com/azure/storage/common/storage-sas-overview#sas-token)
+* [`X-Goog-Signature`](https://cloud.google.com/storage/docs/access-control/signed-urls)
+
+This list is subject to change over time.
+
+When a query string value is redacted, the query string key SHOULD still be preserved, e.g.
+`https://www.example.com/path?color=blue&sig=REDACTED`.
+"""
+
+URL_PATH: Final = "url.path"
+"""
+The [URI path](https://www.rfc-editor.org/rfc/rfc3986#section-3.3) component.
+Note: Sensitive content provided in `url.path` SHOULD be scrubbed when instrumentations can identify it.
+"""
+
+URL_QUERY: Final = "url.query"
+"""
+The [URI query](https://www.rfc-editor.org/rfc/rfc3986#section-3.4) component.
+Note: Sensitive content provided in `url.query` SHOULD be scrubbed when instrumentations can identify it.
+
+![Development](https://img.shields.io/badge/-development-blue)
+Query string values for the following keys SHOULD be redacted by default and replaced by the value `REDACTED`:
+
+* [`AWSAccessKeyId`](https://docs.aws.amazon.com/AmazonS3/latest/userguide/RESTAuthentication.html#RESTAuthenticationQueryStringAuth)
+* [`Signature`](https://docs.aws.amazon.com/AmazonS3/latest/userguide/RESTAuthentication.html#RESTAuthenticationQueryStringAuth)
+* [`sig`](https://learn.microsoft.com/azure/storage/common/storage-sas-overview#sas-token)
+* [`X-Goog-Signature`](https://cloud.google.com/storage/docs/access-control/signed-urls)
+
+This list is subject to change over time.
+
+When a query string value is redacted, the query string key SHOULD still be preserved, e.g.
+`q=OpenTelemetry&sig=REDACTED`.
+"""
+
+URL_SCHEME: Final = "url.scheme"
+"""
+The [URI scheme](https://www.rfc-editor.org/rfc/rfc3986#section-3.1) component identifying the used protocol.
+"""
diff --git a/.venv/lib/python3.12/site-packages/opentelemetry/semconv/attributes/user_agent_attributes.py b/.venv/lib/python3.12/site-packages/opentelemetry/semconv/attributes/user_agent_attributes.py
new file mode 100644
index 00000000..af5002ef
--- /dev/null
+++ b/.venv/lib/python3.12/site-packages/opentelemetry/semconv/attributes/user_agent_attributes.py
@@ -0,0 +1,20 @@
+# Copyright The OpenTelemetry Authors
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from typing import Final
+
+USER_AGENT_ORIGINAL: Final = "user_agent.original"
+"""
+Value of the [HTTP User-Agent](https://www.rfc-editor.org/rfc/rfc9110.html#field.user-agent) header sent by the client.
+"""