Open Agent Spec Tracing

* Pyagentspec tracing

* Update json schema spec of 26.1.0

* Update exception handling, name changes

* simplify langgraph tracing

* Rename humanintheloop. Change models subpackage name to messages. Remove mentions of telemetry from docs.

* Changed some documentation. Added tests on different types of calls for crewai and langgraph tracing.

---------

Co-authored-by: Son Le <tran.minh.son.le@oracle.com>

Author: cesarebernardis

docs/pyagentspec/source/agentspec/index.rst

@@ -28,3 +28,4 @@ with all the latest updates at :ref:`this link<agentspecspec_nightly>`.
    Introduction, motivation & vision <intro_and_motivation>
    Language specification (v25.4.1) <language_spec_25_4_1>
    Positioning in the agentic ecosystem <positioning>
+   Tracing <tracing>

docs/pyagentspec/source/agentspec/json_spec/agentspec_json_spec_26_1_0.json

@@ -3669,6 +3669,18 @@
           "$ref": "#/$defs/OpenAIAPIType",
           "default": "chat_completions"
         },
+        "api_key": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "title": "Api Key"
+        },
         "$referenced_components": {
           "$ref": "#/$defs/ReferencedComponents"
         },

docs/pyagentspec/source/agentspec/language_spec_nightly.rst

@@ -649,13 +649,15 @@ OpenAI
 This class of LLMs refers to the models offered by `OpenAI <https://openai.com>`_.
 Similar to :ref:`OpenAI Compatible LLMs <openaicompatiblellms>`, you can also configure the ``api_type`` parameter,
 which takes one of 2 string values, namely ``chat_completions`` or ``responses``.
-By default, the API type is set to chat completions.
+By default, the API type is set to chat completions. Additionally, an optional
+``api_key`` can be set for the remote LLM model.
 
 .. code-block:: python
 
    class OpenAiConfig(LlmConfig):
      model_id: str
      api_type: Literal["chat_completions", "responses"] = "chat_completions"
+     api_key: SensitiveField[Optional[str]] = None
 
 OCI GenAI
 ^^^^^^^^^
@@ -2365,6 +2367,8 @@ See all the fields below that are considered sensitive fields:
 +==================================+====================+
 | OpenAiCompatibleConfig           | api_key            |
 +----------------------------------+--------------------+
+| OpenAiConfig                     | api_key            |
++----------------------------------+--------------------+
 | OciClientConfigWithSecurityToken | auth_file_location |
 +----------------------------------+--------------------+
 | OciClientConfigWithApiKey        | auth_file_location |