ioa-observe-sdk 1.0.24__tar.gz → 1.0.25__tar.gz

{ioa_observe_sdk-1.0.24 → ioa_observe_sdk-1.0.25}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ioa-observe-sdk
-Version: 1.0.24
+Version: 1.0.25
 Summary: IOA Observability SDK
 License-Expression: Apache-2.0
 Requires-Python: >=3.10
@@ -76,6 +76,37 @@ Alternatively, to download the SDK from git, you could also use the following co
 uv add "git+https://github.com/agntcy/observe"
 ```
 
+### Quick Start
+
+After installation, import and initialize the SDK:
+
+```python
+import os
+from ioa_observe.sdk import Observe
+from ioa_observe.sdk.decorators import agent
+from ioa_observe.sdk.tracing import session_start
+
+# Initialize Observe
+Observe.init(
+    app_name="your_app_name",
+    api_endpoint=os.getenv("OTLP_HTTP_ENDPOINT", "http://localhost:4318")
+)
+
+# Use decorators to instrument your agents
+@agent(name="my_agent", description="Example agent")
+def my_agent_function(state):
+    # Your agent logic here
+    return {"result": "success"}
+
+# Start a session for tracking
+with session_start() as session_id:
+    result = my_agent_function({"input": "data"})
+```
+
+**Note:** The package name for installation is `ioa_observe_sdk`, but imports use `ioa_observe` (underscore, not hyphen).
+
+For comprehensive integration examples with LangGraph, LlamaIndex, and other frameworks, see the [Getting Started Guide](GETTING-STARTED.md).
+
 ## Schema
 
 The AGNTCY observability schema is an extension of the OTel LLM Semantic Conventions for Generative AI systems.

{ioa_observe_sdk-1.0.24 → ioa_observe_sdk-1.0.25}/README.md

@@ -27,6 +27,37 @@ Alternatively, to download the SDK from git, you could also use the following co
 uv add "git+https://github.com/agntcy/observe"
 ```
 
+### Quick Start
+
+After installation, import and initialize the SDK:
+
+```python
+import os
+from ioa_observe.sdk import Observe
+from ioa_observe.sdk.decorators import agent
+from ioa_observe.sdk.tracing import session_start
+
+# Initialize Observe
+Observe.init(
+    app_name="your_app_name",
+    api_endpoint=os.getenv("OTLP_HTTP_ENDPOINT", "http://localhost:4318")
+)
+
+# Use decorators to instrument your agents
+@agent(name="my_agent", description="Example agent")
+def my_agent_function(state):
+    # Your agent logic here
+    return {"result": "success"}
+
+# Start a session for tracking
+with session_start() as session_id:
+    result = my_agent_function({"input": "data"})
+```
+
+**Note:** The package name for installation is `ioa_observe_sdk`, but imports use `ioa_observe` (underscore, not hyphen).
+
+For comprehensive integration examples with LangGraph, LlamaIndex, and other frameworks, see the [Getting Started Guide](GETTING-STARTED.md).
+
 ## Schema
 
 The AGNTCY observability schema is an extension of the OTel LLM Semantic Conventions for Generative AI systems.

{ioa_observe_sdk-1.0.24 → ioa_observe_sdk-1.0.25}/ioa_observe/sdk/instrumentations/slim.py

@@ -686,7 +686,13 @@ class SLIMInstrumentor(BaseInstrumentor):
                             baggage.set_baggage(f"execution.{traceparent}", session_id)
 
                         # Wrap the message (first argument for publish, second for publish_to)
-                        message_idx = 1 if method_name == "publish_to" else 0
+                        # If the session_class is SessionContext, the message is always in second position
+                        message_idx = (
+                            1
+                            if method_name == "publish_to"
+                            or session_class.__name__ == "SessionContext"
+                            else 0
+                        )
                         if len(args) > message_idx:
                             args_list = list(args)
                             message = args_list[message_idx]

{ioa_observe_sdk-1.0.24 → ioa_observe_sdk-1.0.25}/ioa_observe_sdk.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ioa-observe-sdk
-Version: 1.0.24
+Version: 1.0.25
 Summary: IOA Observability SDK
 License-Expression: Apache-2.0
 Requires-Python: >=3.10
@@ -76,6 +76,37 @@ Alternatively, to download the SDK from git, you could also use the following co
 uv add "git+https://github.com/agntcy/observe"
 ```
 
+### Quick Start
+
+After installation, import and initialize the SDK:
+
+```python
+import os
+from ioa_observe.sdk import Observe
+from ioa_observe.sdk.decorators import agent
+from ioa_observe.sdk.tracing import session_start
+
+# Initialize Observe
+Observe.init(
+    app_name="your_app_name",
+    api_endpoint=os.getenv("OTLP_HTTP_ENDPOINT", "http://localhost:4318")
+)
+
+# Use decorators to instrument your agents
+@agent(name="my_agent", description="Example agent")
+def my_agent_function(state):
+    # Your agent logic here
+    return {"result": "success"}
+
+# Start a session for tracking
+with session_start() as session_id:
+    result = my_agent_function({"input": "data"})
+```
+
+**Note:** The package name for installation is `ioa_observe_sdk`, but imports use `ioa_observe` (underscore, not hyphen).
+
+For comprehensive integration examples with LangGraph, LlamaIndex, and other frameworks, see the [Getting Started Guide](GETTING-STARTED.md).
+
 ## Schema
 
 The AGNTCY observability schema is an extension of the OTel LLM Semantic Conventions for Generative AI systems.

{ioa_observe_sdk-1.0.24 → ioa_observe_sdk-1.0.25}/pyproject.toml

@@ -5,7 +5,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "ioa-observe-sdk"
-version = "1.0.24"
+version = "1.0.25"
 license = "Apache-2.0"
 description = "IOA Observability SDK"
 readme = "README.md"