ioa-observe-sdk 1.0.1__tar.gz → 1.0.3__tar.gz

{ioa_observe_sdk-1.0.1/ioa_observe_sdk.egg-info → ioa_observe_sdk-1.0.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ioa-observe-sdk
-Version: 1.0.1
+Version: 1.0.3
 Summary: IOA Observability SDK
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
@@ -41,16 +41,16 @@ Requires-Dist: opentelemetry-exporter-otlp-proto-grpc==1.33.1
 Requires-Dist: opentelemetry-exporter-otlp-proto-http==1.33.1
 Requires-Dist: opentelemetry-instrumentation
 Requires-Dist: opentelemetry-instrumentation-logging==0.54b1
-Requires-Dist: opentelemetry-instrumentation-openai==0.40.2
-Requires-Dist: opentelemetry-instrumentation-llamaindex==0.40.2
-Requires-Dist: opentelemetry-instrumentation-ollama==0.40.2
-Requires-Dist: opentelemetry-instrumentation-langchain==0.40.2
+Requires-Dist: opentelemetry-instrumentation-openai==0.40.8
+Requires-Dist: opentelemetry-instrumentation-llamaindex==0.40.8
+Requires-Dist: opentelemetry-instrumentation-ollama==0.40.8
+Requires-Dist: opentelemetry-instrumentation-langchain==0.40.8
 Requires-Dist: opentelemetry-instrumentation-threading==00.54b1
 Requires-Dist: opentelemetry-instrumentation-urllib3==0.54b1
 Requires-Dist: opentelemetry-proto==1.33.1
 Requires-Dist: opentelemetry-sdk==1.33.1
 Requires-Dist: opentelemetry-semantic-conventions==0.54b1
-Requires-Dist: opentelemetry-semantic-conventions-ai==0.4.5
+Requires-Dist: opentelemetry-semantic-conventions-ai==0.4.9
 Requires-Dist: opentelemetry-util-http==0.54b1
 Requires-Dist: packaging==24.2
 Requires-Dist: propcache==0.3.0
@@ -73,6 +73,8 @@ Requires-Dist: zipp==3.21.0
 Requires-Dist: langgraph>=0.3.2
 Requires-Dist: langchain>=0.3.19
 Requires-Dist: langchain-openai>=0.3.8
+Requires-Dist: langchain-community>=0.3.25
+Requires-Dist: llama-index>=0.12.34
 Requires-Dist: opentelemetry-instrumentation-requests
 Requires-Dist: opentelemetry-instrumentation-transformers>=0.40.2
 Requires-Dist: opentelemetry-instrumentation-crewai>=0.40.2
@@ -88,8 +90,9 @@ IOA observability SDK for your multi-agentic application.
 ## Table of Contents
 
 - [Installation](#installation)
-- [Usage](#usage)
-- [Features](#features)
+- [Dev](#dev)
+- [Testing](#testing)
+- [Getting Started](#getting-started)
 - [Contributing](#contributing)
 
 ## Installation
@@ -151,77 +154,8 @@ OPENAI_API_KEY=<KEY> make test
 
 ## Getting Started
 
-For getting started with the SDK, please refer to the [GETTING-STARTED.md](GETTING-STARTED.md) file. It contains detailed instructions on how to set up and use the SDK effectively.
-
-## SLIM-Based Multi-Agentic Systems
-
-For distributed agent systems using SLIM protocol, additional instrumentation is available:
-
-
-### Initializing the SLIM Connector with your agent
-
-```python
-from ioa_observe.sdk.connectors.slim import SLIMConnector, process_slim_msg
-from ioa_observe.sdk.instrumentations.slim import SLIMInstrumentor
-
-# Initialize SLIM connector
-slim_connector = SLIMConnector(
-    remote_org="cisco",
-    remote_namespace="default",
-    shared_space="chat",
-)
-
-# Register agents with the connector
-slim_connector.register("remote_client_agent")
-
-# Instrument SLIM communications
-SLIMInstrumentor().instrument()
-```
-
-### Receiving Messages with a Callback
-
-Add the decorator `process_slim_msg` to the callback function to process incoming messages. This function will be called whenever a message is received in the shared space.
-
-```python
-
-# Define a callback to process incoming messages
-from ioa_observe.sdk.connectors.slim import SLIMConnector, process_slim_msg
-import json
-from typing import Dict, Any
-
-@process_slim_msg("remote_client_agent")
-async def send_and_recv(msg) -> Dict[str, Any]:
-    """Send message to remote endpoint and wait for reply."""
-    gateway = GatewayHolder.gateway
-    session_info = GatewayHolder.session_info
-
-    if gateway is not None:
-        await gateway.publish(session_info, msg.encode(), "cisco", "default", "server")
-        async with gateway:
-            _, recv = await gateway.receive(session=session_info.id)
-    else:
-        raise RuntimeError("Gateway is not initialized yet!")
-
-    response_data = json.loads(recv.decode("utf8"))
-    return {"messages": response_data.get("messages", [])}
-```
-
-### Starting the Message Receiver
-
-```python
-# Start receiving messages from the SLIM shared space
-await slim.receive(callback=on_message_received)
-```
-
-### Publishing Messages
-
-```python
-# Publish a message to the SLIM shared space
-message = {"type": "ChatMessage", "author": "moderator", "message": "Hello, world!"}
-await slim.publish(msg=json.dumps(message).encode("utf-8"))
-```
-
-We will observe various events and metrics being sent to the Otel collector as we interact with other agents in the shared space via SLIM.
+For getting started with the SDK, please refer to the [Getting Started](https://github.com/agntcy/observe/blob/main/GETTING-STARTED.md)
+ file. It contains detailed instructions on how to set up and use the SDK effectively.
 
 ## Contributing
 

ioa_observe_sdk-1.0.3/README.md

@@ -0,0 +1,83 @@
+# Observe-SDK
+
+IOA observability SDK for your multi-agentic application.
+
+## Table of Contents
+
+- [Installation](#installation)
+- [Dev](#dev)
+- [Testing](#testing)
+- [Getting Started](#getting-started)
+- [Contributing](#contributing)
+
+## Installation
+
+To install the package via PyPI, simply run:
+
+```bash
+pip install ioa_observe_sdk
+```
+
+Alternatively, to download the SDK from git, you could also use the following command. Ensure you have `uv` installed in your environment.
+
+```bash
+uv add "git+https://github.com/agntcy/observe"
+```
+
+## Dev
+
+To get started with development, start a Clickhouse DB and an OTel collector container locally using docker-compose like so:
+
+```
+cd deploy/
+docker compose up -d
+```
+
+Ensure the contents of `otel-collector.yaml` is correct.
+
+Check the logs of the collector to ensure it is running correctly:
+
+```
+docker logs -f otel-collector
+```
+
+Create a `.env` file with the following content:
+
+```bash
+OTLP_HTTP_ENDPOINT=http://localhost:4318
+```
+
+Install the dependencies and activate the virtual environment:
+
+```bash
+set -a
+source .env
+set +a
+
+python3 -m venv .venv
+source .venv/bin/activate
+uv sync
+```
+
+## Testing
+
+To run the unit tests, ensure you have the `OPENAI_API_KEY` set in your environment. You can run the tests using the following command:
+
+```bash
+OPENAI_API_KEY=<KEY> make test
+```
+
+## Getting Started
+
+For getting started with the SDK, please refer to the [Getting Started](https://github.com/agntcy/observe/blob/main/GETTING-STARTED.md)
+ file. It contains detailed instructions on how to set up and use the SDK effectively.
+
+## Contributing
+
+Contributions are welcome! Please follow these steps to contribute:
+
+1. Fork the repository.
+2. Create a new branch (`git checkout -b feature-branch`).
+3. Commit your changes (`git commit -am 'Add new feature'`).
+4. Push to the branch (`git push origin feature-branch`).
+5. Create a new Pull Request.

{ioa_observe_sdk-1.0.1 → ioa_observe_sdk-1.0.3}/ioa_observe/sdk/tracing/tracing.py

@@ -751,7 +751,7 @@ def init_google_generativeai_instrumentor():
 
 def init_langchain_instrumentor():
     try:
-        if is_package_installed("langchain"):
+        if is_package_installed("langchain") or is_package_installed("langgraph"):
             Telemetry().capture("instrumentation:langchain:init")
             from opentelemetry.instrumentation.langchain import LangchainInstrumentor
 

{ioa_observe_sdk-1.0.1 → ioa_observe_sdk-1.0.3/ioa_observe_sdk.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ioa-observe-sdk
-Version: 1.0.1
+Version: 1.0.3
 Summary: IOA Observability SDK
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
@@ -41,16 +41,16 @@ Requires-Dist: opentelemetry-exporter-otlp-proto-grpc==1.33.1
 Requires-Dist: opentelemetry-exporter-otlp-proto-http==1.33.1
 Requires-Dist: opentelemetry-instrumentation
 Requires-Dist: opentelemetry-instrumentation-logging==0.54b1
-Requires-Dist: opentelemetry-instrumentation-openai==0.40.2
-Requires-Dist: opentelemetry-instrumentation-llamaindex==0.40.2
-Requires-Dist: opentelemetry-instrumentation-ollama==0.40.2
-Requires-Dist: opentelemetry-instrumentation-langchain==0.40.2
+Requires-Dist: opentelemetry-instrumentation-openai==0.40.8
+Requires-Dist: opentelemetry-instrumentation-llamaindex==0.40.8
+Requires-Dist: opentelemetry-instrumentation-ollama==0.40.8
+Requires-Dist: opentelemetry-instrumentation-langchain==0.40.8
 Requires-Dist: opentelemetry-instrumentation-threading==00.54b1
 Requires-Dist: opentelemetry-instrumentation-urllib3==0.54b1
 Requires-Dist: opentelemetry-proto==1.33.1
 Requires-Dist: opentelemetry-sdk==1.33.1
 Requires-Dist: opentelemetry-semantic-conventions==0.54b1
-Requires-Dist: opentelemetry-semantic-conventions-ai==0.4.5
+Requires-Dist: opentelemetry-semantic-conventions-ai==0.4.9
 Requires-Dist: opentelemetry-util-http==0.54b1
 Requires-Dist: packaging==24.2
 Requires-Dist: propcache==0.3.0
@@ -73,6 +73,8 @@ Requires-Dist: zipp==3.21.0
 Requires-Dist: langgraph>=0.3.2
 Requires-Dist: langchain>=0.3.19
 Requires-Dist: langchain-openai>=0.3.8
+Requires-Dist: langchain-community>=0.3.25
+Requires-Dist: llama-index>=0.12.34
 Requires-Dist: opentelemetry-instrumentation-requests
 Requires-Dist: opentelemetry-instrumentation-transformers>=0.40.2
 Requires-Dist: opentelemetry-instrumentation-crewai>=0.40.2
@@ -88,8 +90,9 @@ IOA observability SDK for your multi-agentic application.
 ## Table of Contents
 
 - [Installation](#installation)
-- [Usage](#usage)
-- [Features](#features)
+- [Dev](#dev)
+- [Testing](#testing)
+- [Getting Started](#getting-started)
 - [Contributing](#contributing)
 
 ## Installation
@@ -151,77 +154,8 @@ OPENAI_API_KEY=<KEY> make test
 
 ## Getting Started
 
-For getting started with the SDK, please refer to the [GETTING-STARTED.md](GETTING-STARTED.md) file. It contains detailed instructions on how to set up and use the SDK effectively.
-
-## SLIM-Based Multi-Agentic Systems
-
-For distributed agent systems using SLIM protocol, additional instrumentation is available:
-
-
-### Initializing the SLIM Connector with your agent
-
-```python
-from ioa_observe.sdk.connectors.slim import SLIMConnector, process_slim_msg
-from ioa_observe.sdk.instrumentations.slim import SLIMInstrumentor
-
-# Initialize SLIM connector
-slim_connector = SLIMConnector(
-    remote_org="cisco",
-    remote_namespace="default",
-    shared_space="chat",
-)
-
-# Register agents with the connector
-slim_connector.register("remote_client_agent")
-
-# Instrument SLIM communications
-SLIMInstrumentor().instrument()
-```
-
-### Receiving Messages with a Callback
-
-Add the decorator `process_slim_msg` to the callback function to process incoming messages. This function will be called whenever a message is received in the shared space.
-
-```python
-
-# Define a callback to process incoming messages
-from ioa_observe.sdk.connectors.slim import SLIMConnector, process_slim_msg
-import json
-from typing import Dict, Any
-
-@process_slim_msg("remote_client_agent")
-async def send_and_recv(msg) -> Dict[str, Any]:
-    """Send message to remote endpoint and wait for reply."""
-    gateway = GatewayHolder.gateway
-    session_info = GatewayHolder.session_info
-
-    if gateway is not None:
-        await gateway.publish(session_info, msg.encode(), "cisco", "default", "server")
-        async with gateway:
-            _, recv = await gateway.receive(session=session_info.id)
-    else:
-        raise RuntimeError("Gateway is not initialized yet!")
-
-    response_data = json.loads(recv.decode("utf8"))
-    return {"messages": response_data.get("messages", [])}
-```
-
-### Starting the Message Receiver
-
-```python
-# Start receiving messages from the SLIM shared space
-await slim.receive(callback=on_message_received)
-```
-
-### Publishing Messages
-
-```python
-# Publish a message to the SLIM shared space
-message = {"type": "ChatMessage", "author": "moderator", "message": "Hello, world!"}
-await slim.publish(msg=json.dumps(message).encode("utf-8"))
-```
-
-We will observe various events and metrics being sent to the Otel collector as we interact with other agents in the shared space via SLIM.
+For getting started with the SDK, please refer to the [Getting Started](https://github.com/agntcy/observe/blob/main/GETTING-STARTED.md)
+ file. It contains detailed instructions on how to set up and use the SDK effectively.
 
 ## Contributing
 

{ioa_observe_sdk-1.0.1 → ioa_observe_sdk-1.0.3}/ioa_observe_sdk.egg-info/requires.txt

@@ -34,16 +34,16 @@ opentelemetry-exporter-otlp-proto-grpc==1.33.1
 opentelemetry-exporter-otlp-proto-http==1.33.1
 opentelemetry-instrumentation
 opentelemetry-instrumentation-logging==0.54b1
-opentelemetry-instrumentation-openai==0.40.2
-opentelemetry-instrumentation-llamaindex==0.40.2
-opentelemetry-instrumentation-ollama==0.40.2
-opentelemetry-instrumentation-langchain==0.40.2
+opentelemetry-instrumentation-openai==0.40.8
+opentelemetry-instrumentation-llamaindex==0.40.8
+opentelemetry-instrumentation-ollama==0.40.8
+opentelemetry-instrumentation-langchain==0.40.8
 opentelemetry-instrumentation-threading==00.54b1
 opentelemetry-instrumentation-urllib3==0.54b1
 opentelemetry-proto==1.33.1
 opentelemetry-sdk==1.33.1
 opentelemetry-semantic-conventions==0.54b1
-opentelemetry-semantic-conventions-ai==0.4.5
+opentelemetry-semantic-conventions-ai==0.4.9
 opentelemetry-util-http==0.54b1
 packaging==24.2
 propcache==0.3.0
@@ -66,6 +66,8 @@ zipp==3.21.0
 langgraph>=0.3.2
 langchain>=0.3.19
 langchain-openai>=0.3.8
+langchain-community>=0.3.25
+llama-index>=0.12.34
 opentelemetry-instrumentation-requests
 opentelemetry-instrumentation-transformers>=0.40.2
 opentelemetry-instrumentation-crewai>=0.40.2

{ioa_observe_sdk-1.0.1 → ioa_observe_sdk-1.0.3}/pyproject.toml

@@ -5,7 +5,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "ioa-observe-sdk"
-version = "1.0.1"
+version = "1.0.3"
 description = "IOA Observability SDK"
 readme = "README.md"
 requires-python = ">=3.10"
@@ -46,16 +46,16 @@ dependencies = [
         "opentelemetry-exporter-otlp-proto-http==1.33.1",
         "opentelemetry-instrumentation",
         "opentelemetry-instrumentation-logging==0.54b1",
-        "opentelemetry-instrumentation-openai==0.40.2",
-        "opentelemetry-instrumentation-llamaindex==0.40.2",
-        "opentelemetry-instrumentation-ollama==0.40.2",
-        "opentelemetry-instrumentation-langchain==0.40.2",
+        "opentelemetry-instrumentation-openai==0.40.8",
+        "opentelemetry-instrumentation-llamaindex==0.40.8",
+        "opentelemetry-instrumentation-ollama==0.40.8",
+        "opentelemetry-instrumentation-langchain==0.40.8",
         "opentelemetry-instrumentation-threading==00.54b1",
         "opentelemetry-instrumentation-urllib3==0.54b1",
         "opentelemetry-proto==1.33.1",
         "opentelemetry-sdk==1.33.1",
         "opentelemetry-semantic-conventions==0.54b1",
-        "opentelemetry-semantic-conventions-ai==0.4.5",
+        "opentelemetry-semantic-conventions-ai==0.4.9",
         "opentelemetry-util-http==0.54b1",
         "packaging==24.2",
         "propcache==0.3.0",
@@ -78,6 +78,8 @@ dependencies = [
         "langgraph>=0.3.2",
         "langchain>=0.3.19",
         "langchain-openai>=0.3.8",
+        "langchain-community>=0.3.25",
+        "llama-index>=0.12.34",
         "opentelemetry-instrumentation-requests",
         "opentelemetry-instrumentation-transformers>=0.40.2",
         "opentelemetry-instrumentation-crewai>=0.40.2",

ioa_observe_sdk-1.0.1/README.md

@@ -1,151 +0,0 @@
-# Observe-SDK
-
-IOA observability SDK for your multi-agentic application.
-
-## Table of Contents
-
-- [Installation](#installation)
-- [Usage](#usage)
-- [Features](#features)
-- [Contributing](#contributing)
-
-## Installation
-
-To install the package via PyPI, simply run:
-
-```bash
-pip install ioa_observe_sdk
-```
-
-Alternatively, to download the SDK from git, you could also use the following command. Ensure you have `uv` installed in your environment.
-
-```bash
-uv add "git+https://github.com/agntcy/observe"
-```
-
-## Dev
-
-To get started with development, start a Clickhouse DB and an OTel collector container locally using docker-compose like so:
-
-```
-cd deploy/
-docker compose up -d
-```
-
-Ensure the contents of `otel-collector.yaml` is correct.
-
-Check the logs of the collector to ensure it is running correctly:
-
-```
-docker logs -f otel-collector
-```
-
-Create a `.env` file with the following content:
-
-```bash
-OTLP_HTTP_ENDPOINT=http://localhost:4318
-```
-
-Install the dependencies and activate the virtual environment:
-
-```bash
-set -a
-source .env
-set +a
-
-python3 -m venv .venv
-source .venv/bin/activate
-uv sync
-```
-
-## Testing
-
-To run the unit tests, ensure you have the `OPENAI_API_KEY` set in your environment. You can run the tests using the following command:
-
-```bash
-OPENAI_API_KEY=<KEY> make test
-```
-
-## Getting Started
-
-For getting started with the SDK, please refer to the [GETTING-STARTED.md](GETTING-STARTED.md) file. It contains detailed instructions on how to set up and use the SDK effectively.
-
-## SLIM-Based Multi-Agentic Systems
-
-For distributed agent systems using SLIM protocol, additional instrumentation is available:
-
-
-### Initializing the SLIM Connector with your agent
-
-```python
-from ioa_observe.sdk.connectors.slim import SLIMConnector, process_slim_msg
-from ioa_observe.sdk.instrumentations.slim import SLIMInstrumentor
-
-# Initialize SLIM connector
-slim_connector = SLIMConnector(
-    remote_org="cisco",
-    remote_namespace="default",
-    shared_space="chat",
-)
-
-# Register agents with the connector
-slim_connector.register("remote_client_agent")
-
-# Instrument SLIM communications
-SLIMInstrumentor().instrument()
-```
-
-### Receiving Messages with a Callback
-
-Add the decorator `process_slim_msg` to the callback function to process incoming messages. This function will be called whenever a message is received in the shared space.
-
-```python
-
-# Define a callback to process incoming messages
-from ioa_observe.sdk.connectors.slim import SLIMConnector, process_slim_msg
-import json
-from typing import Dict, Any
-
-@process_slim_msg("remote_client_agent")
-async def send_and_recv(msg) -> Dict[str, Any]:
-    """Send message to remote endpoint and wait for reply."""
-    gateway = GatewayHolder.gateway
-    session_info = GatewayHolder.session_info
-
-    if gateway is not None:
-        await gateway.publish(session_info, msg.encode(), "cisco", "default", "server")
-        async with gateway:
-            _, recv = await gateway.receive(session=session_info.id)
-    else:
-        raise RuntimeError("Gateway is not initialized yet!")
-
-    response_data = json.loads(recv.decode("utf8"))
-    return {"messages": response_data.get("messages", [])}
-```
-
-### Starting the Message Receiver
-
-```python
-# Start receiving messages from the SLIM shared space
-await slim.receive(callback=on_message_received)
-```
-
-### Publishing Messages
-
-```python
-# Publish a message to the SLIM shared space
-message = {"type": "ChatMessage", "author": "moderator", "message": "Hello, world!"}
-await slim.publish(msg=json.dumps(message).encode("utf-8"))
-```
-
-We will observe various events and metrics being sent to the Otel collector as we interact with other agents in the shared space via SLIM.
-
-## Contributing
-
-Contributions are welcome! Please follow these steps to contribute:
-
-1. Fork the repository.
-2. Create a new branch (`git checkout -b feature-branch`).
-3. Commit your changes (`git commit -am 'Add new feature'`).
-4. Push to the branch (`git push origin feature-branch`).
-5. Create a new Pull Request.