agenta 0.26.0a0__py3-none-any.whl → 0.27.0a0__py3-none-any.whl

agenta/__init__.py

@@ -1,7 +1,5 @@
 from .sdk.utils.preinit import PreInitObject
-from .sdk.context import get_contexts, save_context
 from .sdk.types import (
-    Context,
     DictInput,
     MultipleChoice,
     FloatParam,
@@ -15,16 +13,17 @@ from .sdk.types import (
     BinaryParam,
 )
 
-from .sdk.tracing.logger import llm_logger as logging
-from .sdk.tracing.llm_tracing import Tracing
+from .sdk.utils.logging import log as logging
+from .sdk.tracing import Tracing
 from .sdk.decorators.tracing import instrument
-from .sdk.decorators.llm_entrypoint import entrypoint, app, route
+from .sdk.decorators.routing import entrypoint, app, route
 from .sdk.agenta_init import Config, AgentaSingleton, init
-from .sdk.utils.helper.openai_cost import calculate_token_usage
+from .sdk.utils.costs import calculate_token_usage
 from .sdk.client import Agenta
-from .sdk.tracing import callbacks
+from .sdk.litellm import litellm as callbacks
 from .sdk.config_manager import ConfigManager
 from .sdk import assets as assets
+from .sdk import tracer
 
 config = PreInitObject("agenta.config", Config)
 DEFAULT_AGENTA_SINGLETON_INSTANCE = AgentaSingleton()

agenta/client/backend/client.py

@@ -88,13 +88,17 @@ class AgentaApi:
         self._client_wrapper = SyncClientWrapper(
             base_url=base_url,
             api_key=api_key,
-            httpx_client=httpx_client
-            if httpx_client is not None
-            else httpx.Client(
-                timeout=_defaulted_timeout, follow_redirects=follow_redirects
-            )
-            if follow_redirects is not None
-            else httpx.Client(timeout=_defaulted_timeout),
+            httpx_client=(
+                httpx_client
+                if httpx_client is not None
+                else (
+                    httpx.Client(
+                        timeout=_defaulted_timeout, follow_redirects=follow_redirects
+                    )
+                    if follow_redirects is not None
+                    else httpx.Client(timeout=_defaulted_timeout)
+                )
+            ),
             timeout=_defaulted_timeout,
         )
         self.observability = ObservabilityClient(client_wrapper=self._client_wrapper)
@@ -1603,13 +1607,17 @@ class AsyncAgentaApi:
         self._client_wrapper = AsyncClientWrapper(
             base_url=base_url,
             api_key=api_key,
-            httpx_client=httpx_client
-            if httpx_client is not None
-            else httpx.AsyncClient(
-                timeout=_defaulted_timeout, follow_redirects=follow_redirects
-            )
-            if follow_redirects is not None
-            else httpx.AsyncClient(timeout=_defaulted_timeout),
+            httpx_client=(
+                httpx_client
+                if httpx_client is not None
+                else (
+                    httpx.AsyncClient(
+                        timeout=_defaulted_timeout, follow_redirects=follow_redirects
+                    )
+                    if follow_redirects is not None
+                    else httpx.AsyncClient(timeout=_defaulted_timeout)
+                )
+            ),
             timeout=_defaulted_timeout,
         )
         self.observability = AsyncObservabilityClient(

agenta/client/backend/core/http_client.py

@@ -148,9 +148,9 @@ def get_request_body(
         json_body = maybe_filter_request_body(json, request_options, omit)
 
     # If you have an empty JSON body, you should just send None
-    return (
-        json_body if json_body != {} else None
-    ), data_body if data_body != {} else None
+    return (json_body if json_body != {} else None), (
+        data_body if data_body != {} else None
+    )
 
 
 class HttpClient:
@@ -246,9 +246,11 @@ class HttpClient:
             json=json_body,
             data=data_body,
             content=content,
-            files=convert_file_dict_to_httpx_tuples(remove_none_from_dict(files))
-            if files is not None
-            else None,
+            files=(
+                convert_file_dict_to_httpx_tuples(remove_none_from_dict(files))
+                if files is not None
+                else None
+            ),
             timeout=timeout,
         )
 
@@ -345,9 +347,11 @@ class HttpClient:
             json=json_body,
             data=data_body,
             content=content,
-            files=convert_file_dict_to_httpx_tuples(remove_none_from_dict(files))
-            if files is not None
-            else None,
+            files=(
+                convert_file_dict_to_httpx_tuples(remove_none_from_dict(files))
+                if files is not None
+                else None
+            ),
             timeout=timeout,
         ) as stream:
             yield stream
@@ -447,9 +451,11 @@ class AsyncHttpClient:
             json=json_body,
             data=data_body,
             content=content,
-            files=convert_file_dict_to_httpx_tuples(remove_none_from_dict(files))
-            if files is not None
-            else None,
+            files=(
+                convert_file_dict_to_httpx_tuples(remove_none_from_dict(files))
+                if files is not None
+                else None
+            ),
             timeout=timeout,
         )
 
@@ -545,9 +551,11 @@ class AsyncHttpClient:
             json=json_body,
             data=data_body,
             content=content,
-            files=convert_file_dict_to_httpx_tuples(remove_none_from_dict(files))
-            if files is not None
-            else None,
+            files=(
+                convert_file_dict_to_httpx_tuples(remove_none_from_dict(files))
+                if files is not None
+                else None
+            ),
             timeout=timeout,
         ) as stream:
             yield stream

agenta/sdk/__init__.py

@@ -1,7 +1,7 @@
+from typing import Optional
+
 from .utils.preinit import PreInitObject  # always the first import!
-from .context import get_contexts, save_context
 from .types import (
-    Context,
     DictInput,
     MultipleChoice,
     FloatParam,
@@ -15,13 +15,34 @@ from .types import (
     BinaryParam,
 )
 
-from .tracing.llm_tracing import Tracing
+from .tracing import Tracing, get_tracer
 from .decorators.tracing import instrument
-from .decorators.llm_entrypoint import entrypoint, app, route
-from .agenta_init import Config, AgentaSingleton, init
-from .utils.helper.openai_cost import calculate_token_usage
+from .decorators.routing import entrypoint, app, route
+from .agenta_init import Config, AgentaSingleton, init as _init
+from .utils.costs import calculate_token_usage
 from .config_manager import ConfigManager
 
 config = PreInitObject("agenta.config", Config)
 DEFAULT_AGENTA_SINGLETON_INSTANCE = AgentaSingleton()
 tracing = DEFAULT_AGENTA_SINGLETON_INSTANCE.tracing  # type: ignore
+
+tracer = get_tracer(tracing)
+
+
+def init(
+    host: Optional[str] = None,
+    app_id: Optional[str] = None,
+    api_key: Optional[str] = None,
+    config_fname: Optional[str] = None,
+):
+    global tracing
+    global tracer
+
+    _init(
+        host=host,
+        app_id=app_id,
+        api_key=api_key,
+        config_fname=config_fname,
+    )
+
+    tracer = get_tracer(tracing)

agenta/sdk/agenta_init.py

@@ -2,10 +2,12 @@ import os
 import logging
 import toml
 from typing import Optional
+from importlib.metadata import version
 
+from agenta.sdk.utils.logging import log
 from agenta.sdk.utils.globals import set_global
 from agenta.client.backend.client import AgentaApi
-from agenta.sdk.tracing.llm_tracing import Tracing
+from agenta.sdk.tracing import Tracing
 from agenta.client.exceptions import APIRequestError
 
 
@@ -17,9 +19,8 @@ class AgentaSingleton:
     """Singleton class to save all the "global variables" for the sdk."""
 
     _instance = None
-    setup = None
     config = None
-    tracing: Optional[Tracing] = None
+    tracing = None
 
     def __new__(cls):
         if not cls._instance:
@@ -28,11 +29,18 @@ class AgentaSingleton:
 
     def init(
         self,
-        app_id: Optional[str] = None,
+        *,
         host: Optional[str] = None,
+        project_id: Optional[str] = None,
         api_key: Optional[str] = None,
         config_fname: Optional[str] = None,
+        #
+        app_id: Optional[str] = None,
     ) -> None:
+        log.info(f"\n--------------------------------")
+        log.info(f"Using Agenta Python SDK version: {version('agenta')}")
+        log.info(f"--------------------------------\n")
+
         """Main function to initialize the singleton.
 
         Initializes the singleton with the given `app_id`, `host`, and `api_key`. The order of precedence for these variables is:
@@ -54,20 +62,20 @@ class AgentaSingleton:
         Raises:
             ValueError: If `app_id` is not specified either as an argument, in the config file, or in the environment variables.
         """
+
         config = {}
         if config_fname:
             config = toml.load(config_fname)
 
-        self.app_id = app_id or config.get("app_id") or os.environ.get("AGENTA_APP_ID")
         self.host = (
             host
+            or os.environ.get("AGENTA_HOST")
             or config.get("backend_host")
-            or os.environ.get("AGENTA_HOST", "https://cloud.agenta.ai")
-        )
-        self.api_key = (
-            api_key or config.get("api_key") or os.environ.get("AGENTA_API_KEY")
+            or config.get("host")
+            or "https://cloud.agenta.ai"
         )
 
+        self.app_id = app_id or config.get("app_id") or os.environ.get("AGENTA_APP_ID")
         if not self.app_id:
             raise ValueError(
                 "App ID must be specified. You can provide it in one of the following ways:\n"
@@ -75,26 +83,60 @@ class AgentaSingleton:
                 "2. In the configuration file specified by config_fname.\n"
                 "3. As an environment variable 'AGENTA_APP_ID'."
             )
+
+        self.project_id = (
+            project_id
+            or os.environ.get("AGENTA_PROJECT_ID")
+            or config.get("project_id")
+        )
+
+        self.api_key = (
+            api_key or os.environ.get("AGENTA_API_KEY") or config.get("api_key")
+        )
+
+        self.tracing = Tracing(
+            url=f"{self.host}/api/observability/v1/traces",  # type: ignore
+        )
+
+        self.tracing.configure(
+            project_id=self.project_id,
+            api_key=self.api_key,
+            # DEPRECATED
+            app_id=self.app_id,
+        )
+
         self.base_id = os.environ.get("AGENTA_BASE_ID")
-        if self.base_id is None:
-            print(
-                "Warning: Your configuration will not be saved permanently since base_id is not provided."
-            )
 
-        self.config = Config(base_id=self.base_id, host=self.host, api_key=self.api_key)  # type: ignore
+        self.config = Config(
+            host=self.host,
+            base_id=self.base_id,
+            api_key=self.api_key,
+        )
 
 
 class Config:
-    def __init__(self, base_id: str, host: str, api_key: Optional[str] = ""):
-        self.base_id = base_id
+    def __init__(
+        self,
+        host: str,
+        base_id: Optional[str] = None,
+        api_key: Optional[str] = "",
+    ):
         self.host = host
 
+        self.base_id = base_id
+
+        if self.base_id is None:
+            print(
+                "Warning: Your configuration will not be saved permanently since base_id is not provided.\n"
+            )
+
         if base_id is None or host is None:
             self.persist = False
         else:
             self.persist = True
             self.client = AgentaApi(
-                base_url=self.host + "/api", api_key=api_key if api_key else ""
+                base_url=self.host + "/api",
+                api_key=api_key if api_key else "",
             )
 
     def register_default(self, overwrite=False, **kwargs):
@@ -208,11 +250,12 @@ class Config:
 
 
 def init(
-    app_id: Optional[str] = None,
     host: Optional[str] = None,
+    project_id: Optional[str] = None,
     api_key: Optional[str] = None,
     config_fname: Optional[str] = None,
-    max_workers: Optional[int] = None,
+    # DEPRECATED
+    app_id: Optional[str] = None,
 ):
     """Main function to initialize the agenta sdk.
 
@@ -238,12 +281,16 @@ def init(
 
     singleton = AgentaSingleton()
 
-    singleton.init(app_id=app_id, host=host, api_key=api_key, config_fname=config_fname)
+    singleton.init(
+        host=host,
+        project_id=project_id,
+        api_key=api_key,
+        config_fname=config_fname,
+        # DEPRECATED
+        app_id=app_id,
+    )
 
-    tracing = Tracing(
-        host=singleton.host,  # type: ignore
-        app_id=singleton.app_id,  # type: ignore
-        api_key=singleton.api_key,
-        max_workers=max_workers,
+    set_global(
+        config=singleton.config,
+        tracing=singleton.tracing,
     )
-    set_global(setup=singleton.setup, config=singleton.config, tracing=tracing)

agenta/sdk/config_manager.py

@@ -7,7 +7,7 @@ import yaml
 from pydantic import BaseModel, ValidationError
 
 from agenta.client.backend.client import AgentaApi
-from agenta.sdk.decorators.llm_entrypoint import route_context
+from agenta.sdk.context.routing import routing_context
 
 from . import AgentaSingleton
 
@@ -47,7 +47,7 @@ class ConfigManager:
             3. 'variant'
             Only one of these should be provided.
         """
-        context = route_context.get()
+        context = routing_context.get()
         if ("config" in context and context["config"]) and (
             ("environment" in context and context["environment"])
             or ("variant" in context and context["variant"])

agenta/sdk/context/routing.py

@@ -0,0 +1,25 @@
+from contextlib import contextmanager
+from contextvars import ContextVar
+from typing import Any, Dict, Optional
+
+routing_context = ContextVar("routing_context", default={})
+
+
+@contextmanager
+def routing_context_manager(
+    config: Optional[Dict[str, Any]] = None,
+    environment: Optional[str] = None,
+    version: Optional[str] = None,
+    variant: Optional[str] = None,
+):
+    context = {
+        "config": config,
+        "environment": environment,
+        "version": version,
+        "variant": variant,
+    }
+    token = routing_context.set(context)
+    try:
+        yield
+    finally:
+        routing_context.reset(token)

agenta/sdk/context/tracing.py

@@ -0,0 +1,3 @@
+from contextvars import ContextVar
+
+tracing_context = ContextVar("tracing_context", default={})