latitude-sdk 0.1.0b4__tar.gz → 0.1.0b6__tar.gz

latitude_sdk-0.1.0b6/.python-version

@@ -0,0 +1 @@
+3.9.21

{latitude_sdk-0.1.0b4 → latitude_sdk-0.1.0b6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: latitude-sdk
-Version: 0.1.0b4
+Version: 0.1.0b6
 Summary: Latitude SDK for Python
 Project-URL: repository, https://github.com/latitude-dev/latitude-llm/tree/main/packages/sdks/python
 Project-URL: homepage, https://github.com/latitude-dev/latitude-llm/tree/main/packages/sdks/python#readme
@@ -8,9 +8,10 @@ Project-URL: documentation, https://github.com/latitude-dev/latitude-llm/tree/ma
 Author-email: Latitude Data SL <hello@latitude.so>
 Maintainer-email: Latitude Data SL <hello@latitude.so>
 License-Expression: LGPL-3.0
-Requires-Python: >=3.8
+Requires-Python: >=3.9
 Requires-Dist: httpx-sse>=0.4.0
 Requires-Dist: httpx>=0.28.1
+Requires-Dist: latitude-telemetry>=0.1.0b4
 Requires-Dist: pydantic>=2.10.3
 Requires-Dist: typing-extensions>=4.12.2
 Description-Content-Type: text/markdown
@@ -21,7 +22,7 @@ Description-Content-Type: text/markdown
 pip install latitude-sdk
 ```
 
-Requires Python `3.8` or higher.
+Requires Python `3.9` or higher.
 
 Go to the [documentation](https://docs.latitude.so/guides/sdk/python) to learn more.
 

{latitude_sdk-0.1.0b4 → latitude_sdk-0.1.0b6}/README.md

@@ -4,7 +4,7 @@
 pip install latitude-sdk
 ```
 
-Requires Python `3.8` or higher.
+Requires Python `3.9` or higher.
 
 Go to the [documentation](https://docs.latitude.so/guides/sdk/python) to learn more.
 

{latitude_sdk-0.1.0b4 → latitude_sdk-0.1.0b6}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "latitude-sdk"
-version = "0.1.0-beta.4"
+version = "0.1.0-beta.6"
 description = "Latitude SDK for Python"
 authors = [{ name = "Latitude Data SL", email = "hello@latitude.so" }]
 maintainers = [{ name = "Latitude Data SL", email = "hello@latitude.so" }]
@@ -9,12 +9,13 @@ license = "LGPL-3.0"
 urls.repository = "https://github.com/latitude-dev/latitude-llm/tree/main/packages/sdks/python"
 urls.homepage = "https://github.com/latitude-dev/latitude-llm/tree/main/packages/sdks/python#readme"
 urls.documentation = "https://github.com/latitude-dev/latitude-llm/tree/main/packages/sdks/python#readme"
-requires-python = ">=3.8"
+requires-python = ">=3.9"
 dependencies = [
     "httpx>=0.28.1",
     "httpx-sse>=0.4.0",
     "pydantic>=2.10.3",
     "typing-extensions>=4.12.2",
+    "latitude-telemetry>=0.1.0b4",
 ]
 
 [dependency-groups]
@@ -23,20 +24,20 @@ dev = [
     "pytest-xdist>=3.6.1",
     "pytest>=8.3.4",
     "respx>=0.22.0",
-    "pyright>=1.1.391",
+    "pyright>=1.1.392",
     "ruff>=0.8.3",
     "sh>=1.14.3",
 ]
 
 [tool.pyright]
-pythonVersion = "3.8"
+pythonVersion = "3.9"
 typeCheckingMode = "strict"
 reportMissingTypeStubs = false
 reportUnnecessaryIsInstance = false
 reportPrivateUsage = false
 
 [tool.ruff]
-target-version = "py38"
+target-version = "py39"
 line-length = 120
 indent-width = 4
 
@@ -48,6 +49,10 @@ ignore = [
     # Needed because unnecessary str() on field aliases are needed
     # https://docs.pydantic.dev/2.8/concepts/fields/#field-aliases
     "UP018",
+    # Needed because typing.List and typing.Dict are semi-deprecated
+    # in new Python versions but we want to maintain compatibility
+    "UP006",
+    "UP035",
 ]
 
 [tool.ruff.format]

{latitude_sdk-0.1.0b4 → latitude_sdk-0.1.0b6}/src/latitude_sdk/sdk/latitude.py

@@ -1,5 +1,8 @@
 from typing import Optional
 
+from latitude_telemetry import InternalOptions as TelemetryInternalOptions
+from latitude_telemetry import Telemetry, TelemetryOptions
+
 from latitude_sdk.client import Client, ClientOptions, RouterOptions
 from latitude_sdk.env import env
 from latitude_sdk.sdk.evaluations import Evaluations
@@ -18,6 +21,7 @@ class InternalOptions(Model):
 
 
 class LatitudeOptions(SdkOptions, Model):
+    telemetry: Optional[TelemetryOptions] = None
     internal: Optional[InternalOptions] = None
 
 
@@ -35,42 +39,51 @@ DEFAULT_INTERNAL_OPTIONS = InternalOptions(
 )
 
 
-DEFAULT_LATITUDE_OPTIONS = LatitudeOptions(internal=DEFAULT_INTERNAL_OPTIONS)
+DEFAULT_LATITUDE_OPTIONS = LatitudeOptions(
+    telemetry=None,  # Note: Telemetry is opt-in
+    internal=DEFAULT_INTERNAL_OPTIONS,
+)
 
 
 class Latitude:
     _options: LatitudeOptions
     _client: Client
 
+    telemetry: Optional[Telemetry]
+
     prompts: Prompts
     logs: Logs
     evaluations: Evaluations
 
     def __init__(self, api_key: str, options: LatitudeOptions):
-        options.internal = options.internal or DEFAULT_INTERNAL_OPTIONS
-        options.internal = InternalOptions(**{**dict(DEFAULT_INTERNAL_OPTIONS), **dict(options.internal)})
+        options.internal = InternalOptions(**{**dict(DEFAULT_INTERNAL_OPTIONS), **dict(options.internal or {})})
         options = LatitudeOptions(**{**dict(DEFAULT_LATITUDE_OPTIONS), **dict(options)})
+        self._options = options
 
-        assert options.internal is not None
-        assert options.internal.gateway is not None
-        assert options.internal.source is not None
-        assert options.internal.retries is not None
-        assert options.internal.delay is not None
-        assert options.internal.timeout is not None
+        assert self._options.internal is not None
+        assert self._options.internal.gateway is not None
+        assert self._options.internal.source is not None
+        assert self._options.internal.retries is not None
+        assert self._options.internal.delay is not None
+        assert self._options.internal.timeout is not None
 
-        self._options = options
         self._client = Client(
             ClientOptions(
                 api_key=api_key,
-                retries=options.internal.retries,
-                delay=options.internal.delay,
-                timeout=options.internal.timeout,
-                source=options.internal.source,
-                router=RouterOptions(gateway=options.internal.gateway),
+                retries=self._options.internal.retries,
+                delay=self._options.internal.delay,
+                timeout=self._options.internal.timeout,
+                source=self._options.internal.source,
+                router=RouterOptions(gateway=self._options.internal.gateway),
             )
         )
 
+        if self._options.telemetry:
+            self._options.telemetry.internal = TelemetryInternalOptions(
+                **{**dict(self._options.internal), **dict(self._options.telemetry.internal or {})}
+            )
+            self.telemetry = Telemetry(api_key, self._options.telemetry)
+
         self.prompts = Prompts(self._client, self._options)
         self.logs = Logs(self._client, self._options)
         self.evaluations = Evaluations(self._client, self._options)
-        # TODO: Telemetry - needs Telemetry SDK in Python

{latitude_sdk-0.1.0b4 → latitude_sdk-0.1.0b6}/src/latitude_sdk/sdk/types.py

@@ -54,15 +54,15 @@ class FileContent(Model):
 
 class ToolCallContent(Model):
     type: Literal[ContentType.ToolCall] = ContentType.ToolCall
-    tool_call_id: str = Field(alias=str("toolCallId"))
-    tool_name: str = Field(alias=str("toolName"))
-    tool_arguments: Dict[str, Any] = Field(alias=str("toolArguments"))
+    id: str = Field(alias=str("toolCallId"))
+    name: str = Field(alias=str("toolName"))
+    arguments: Dict[str, Any] = Field(alias=str("args"))
 
 
 class ToolResultContent(Model):
     type: Literal[ContentType.ToolResult] = ContentType.ToolResult
-    tool_call_id: str = Field(alias=str("toolCallId"))
-    tool_name: str = Field(alias=str("toolName"))
+    id: str = Field(alias=str("toolCallId"))
+    name: str = Field(alias=str("toolName"))
     result: str
     is_error: Optional[bool] = Field(default=None, alias=str("isError"))
 
@@ -95,16 +95,9 @@ class UserMessage(Model):
     name: Optional[str] = None
 
 
-class ToolCall(Model):
-    id: str
-    name: str
-    arguments: Dict[str, Any]
-
-
 class AssistantMessage(Model):
     role: Literal[MessageRole.Assistant] = MessageRole.Assistant
     content: Union[str, List[Union[TextContent, ToolCallContent]]]
-    tool_calls: Optional[List[ToolCall]] = Field(default=None, alias=str("toolCalls"))
 
 
 class ToolMessage(Model):
@@ -121,6 +114,12 @@ class ModelUsage(Model):
     total_tokens: int = Field(alias=str("totalTokens"))
 
 
+class ToolCall(Model):
+    id: str
+    name: str
+    arguments: Dict[str, Any]
+
+
 class StreamTypes(StrEnum):
     Text = "text"
     Object = "object"

{latitude_sdk-0.1.0b4 → latitude_sdk-0.1.0b6}/src/latitude_sdk/util/utils.py

@@ -3,7 +3,7 @@ from enum import Enum
 from typing import Any, Callable, List, TypeVar
 
 import pydantic
-from typing_extensions import ParamSpec
+from typing_extensions import ParamSpec, Self
 
 T = TypeVar("T", str, bool, int, List[str])
 
@@ -49,7 +49,15 @@ class StrEnum(str, Enum):
         return str(self.value)
 
     @classmethod
-    def list(cls) -> List[str]:
+    def entries(cls) -> List[Self]:
+        return list(cls)
+
+    @classmethod
+    def names(cls) -> List[str]:
+        return [v.name for v in cls]
+
+    @classmethod
+    def values(cls) -> List[str]:
         return [v.value for v in cls]
 
 

{latitude_sdk-0.1.0b4 → latitude_sdk-0.1.0b6}/tests/evaluations/create_result_test.py

@@ -26,7 +26,6 @@ class TestCreateEvaluationResult(TestCase):
             body={
                 "result": options.result,
                 "reason": options.reason,
-                "__internal": {"source": "api"},
             },
         )
         self.assertEqual(endpoint_mock.call_count, 1)
@@ -53,7 +52,6 @@ class TestCreateEvaluationResult(TestCase):
                 body={
                     "result": options.result,
                     "reason": options.reason,
-                    "__internal": {"source": "api"},
                 },
             )
             for request in requests

{latitude_sdk-0.1.0b4 → latitude_sdk-0.1.0b6}/tests/evaluations/trigger_test.py

@@ -24,7 +24,6 @@ class TestTriggerEvaluation(TestCase):
             endpoint=endpoint,
             body={
                 "evaluationUuids": options.evaluation_uuids,
-                "__internal": {"source": "api"},
             },
         )
         self.assertEqual(endpoint_mock.call_count, 1)
@@ -47,9 +46,7 @@ class TestTriggerEvaluation(TestCase):
                 request,
                 method="POST",
                 endpoint=endpoint,
-                body={
-                    "__internal": {"source": "api"},
-                },
+                body={},
             )
             for request in requests
         ]

{latitude_sdk-0.1.0b4 → latitude_sdk-0.1.0b6}/tests/logs/create_test.py

@@ -28,7 +28,6 @@ class TestCreateLog(TestCase):
                 "path": path,
                 "messages": [json.loads(message.model_dump_json()) for message in messages],
                 "response": options.response,
-                "__internal": {"source": "api"},
             },
         )
         self.assertEqual(endpoint_mock.call_count, 1)
@@ -54,7 +53,6 @@ class TestCreateLog(TestCase):
                 "path": path,
                 "messages": [json.loads(message.model_dump_json()) for message in messages],
                 "response": options.response,
-                "__internal": {"source": "api"},
             },
         )
         self.assertEqual(endpoint_mock.call_count, 1)
@@ -81,7 +79,6 @@ class TestCreateLog(TestCase):
                 "path": path,
                 "messages": [json.loads(message.model_dump_json()) for message in messages],
                 "response": options.response,
-                "__internal": {"source": "api"},
             },
         )
         self.assertEqual(endpoint_mock.call_count, 1)
@@ -109,7 +106,6 @@ class TestCreateLog(TestCase):
                     "path": path,
                     "messages": [json.loads(message.model_dump_json()) for message in messages],
                     "response": options.response,
-                    "__internal": {"source": "api"},
                 },
             )
             for request in requests

{latitude_sdk-0.1.0b4 → latitude_sdk-0.1.0b6}/tests/prompts/chat_test.py

@@ -36,7 +36,6 @@ class TestChatPromptSync(TestCase):
             body={
                 "messages": [json.loads(message.model_dump_json()) for message in messages],
                 "stream": options.stream,
-                "__internal": {"source": "api"},
             },
         )
         self.assertEqual(endpoint_mock.call_count, 1)
@@ -73,7 +72,6 @@ class TestChatPromptSync(TestCase):
                 body={
                     "messages": [json.loads(message.model_dump_json()) for message in messages],
                     "stream": options.stream,
-                    "__internal": {"source": "api"},
                 },
             )
             for request in requests
@@ -110,7 +108,6 @@ class TestChatPromptSync(TestCase):
             body={
                 "messages": [json.loads(message.model_dump_json()) for message in messages],
                 "stream": options.stream,
-                "__internal": {"source": "api"},
             },
         )
         self.assertEqual(endpoint_mock.call_count, 1)
@@ -144,7 +141,6 @@ class TestChatPromptSync(TestCase):
             body={
                 "messages": [json.loads(message.model_dump_json()) for message in messages],
                 "stream": options.stream,
-                "__internal": {"source": "api"},
             },
         )
         self.assertEqual(endpoint_mock.call_count, 1)
@@ -183,7 +179,6 @@ class TestChatPromptStream(TestCase):
             body={
                 "messages": [json.loads(message.model_dump_json()) for message in messages],
                 "stream": options.stream,
-                "__internal": {"source": "api"},
             },
         )
         self.assertEqual(endpoint_mock.call_count, 1)
@@ -221,7 +216,6 @@ class TestChatPromptStream(TestCase):
                 body={
                     "messages": [json.loads(message.model_dump_json()) for message in messages],
                     "stream": options.stream,
-                    "__internal": {"source": "api"},
                 },
             )
             for request in requests
@@ -258,7 +252,6 @@ class TestChatPromptStream(TestCase):
             body={
                 "messages": [json.loads(message.model_dump_json()) for message in messages],
                 "stream": options.stream,
-                "__internal": {"source": "api"},
             },
         )
         self.assertEqual(endpoint_mock.call_count, 1)
@@ -292,7 +285,6 @@ class TestChatPromptStream(TestCase):
             body={
                 "messages": [json.loads(message.model_dump_json()) for message in messages],
                 "stream": options.stream,
-                "__internal": {"source": "api"},
             },
         )
         self.assertEqual(endpoint_mock.call_count, 1)

{latitude_sdk-0.1.0b4 → latitude_sdk-0.1.0b6}/tests/prompts/get_or_create_test.py

@@ -25,7 +25,6 @@ class TestGetOrCreatePrompt(TestCase):
             body={
                 "path": path,
                 "prompt": options.prompt,
-                "__internal": {"source": "api"},
             },
         )
         self.assertEqual(endpoint_mock.call_count, 1)
@@ -49,7 +48,6 @@ class TestGetOrCreatePrompt(TestCase):
             body={
                 "path": path,
                 "prompt": options.prompt,
-                "__internal": {"source": "api"},
             },
         )
         self.assertEqual(endpoint_mock.call_count, 1)
@@ -74,7 +72,6 @@ class TestGetOrCreatePrompt(TestCase):
             body={
                 "path": path,
                 "prompt": options.prompt,
-                "__internal": {"source": "api"},
             },
         )
         self.assertEqual(endpoint_mock.call_count, 1)
@@ -100,7 +97,6 @@ class TestGetOrCreatePrompt(TestCase):
                 body={
                     "path": path,
                     "prompt": options.prompt,
-                    "__internal": {"source": "api"},
                 },
             )
             for request in requests

{latitude_sdk-0.1.0b4 → latitude_sdk-0.1.0b6}/tests/prompts/run_test.py

@@ -38,7 +38,6 @@ class TestRunPromptSync(TestCase):
                 "customIdentifier": options.custom_identifier,
                 "parameters": options.parameters,
                 "stream": options.stream,
-                "__internal": {"source": "api"},
             },
         )
         self.assertEqual(endpoint_mock.call_count, 1)
@@ -79,7 +78,6 @@ class TestRunPromptSync(TestCase):
                 "customIdentifier": options.custom_identifier,
                 "parameters": options.parameters,
                 "stream": options.stream,
-                "__internal": {"source": "api"},
             },
         )
         self.assertEqual(endpoint_mock.call_count, 1)
@@ -119,7 +117,6 @@ class TestRunPromptSync(TestCase):
                 "customIdentifier": options.custom_identifier,
                 "parameters": options.parameters,
                 "stream": options.stream,
-                "__internal": {"source": "api"},
             },
         )
         self.assertEqual(endpoint_mock.call_count, 1)
@@ -159,7 +156,6 @@ class TestRunPromptSync(TestCase):
                     "customIdentifier": options.custom_identifier,
                     "parameters": options.parameters,
                     "stream": options.stream,
-                    "__internal": {"source": "api"},
                 },
             )
             for request in requests
@@ -199,7 +195,6 @@ class TestRunPromptSync(TestCase):
                 "customIdentifier": options.custom_identifier,
                 "parameters": options.parameters,
                 "stream": options.stream,
-                "__internal": {"source": "api"},
             },
         )
         self.assertEqual(endpoint_mock.call_count, 1)
@@ -236,7 +231,6 @@ class TestRunPromptSync(TestCase):
                 "customIdentifier": options.custom_identifier,
                 "parameters": options.parameters,
                 "stream": options.stream,
-                "__internal": {"source": "api"},
             },
         )
         self.assertEqual(endpoint_mock.call_count, 1)
@@ -278,7 +272,6 @@ class TestRunPromptStream(TestCase):
                 "customIdentifier": options.custom_identifier,
                 "parameters": options.parameters,
                 "stream": options.stream,
-                "__internal": {"source": "api"},
             },
         )
         self.assertEqual(endpoint_mock.call_count, 1)
@@ -321,7 +314,6 @@ class TestRunPromptStream(TestCase):
                 "customIdentifier": options.custom_identifier,
                 "parameters": options.parameters,
                 "stream": options.stream,
-                "__internal": {"source": "api"},
             },
         )
         self.assertEqual(endpoint_mock.call_count, 1)
@@ -363,7 +355,6 @@ class TestRunPromptStream(TestCase):
                 "customIdentifier": options.custom_identifier,
                 "parameters": options.parameters,
                 "stream": options.stream,
-                "__internal": {"source": "api"},
             },
         )
         self.assertEqual(endpoint_mock.call_count, 1)
@@ -404,7 +395,6 @@ class TestRunPromptStream(TestCase):
                     "customIdentifier": options.custom_identifier,
                     "parameters": options.parameters,
                     "stream": options.stream,
-                    "__internal": {"source": "api"},
                 },
             )
             for request in requests
@@ -444,7 +434,6 @@ class TestRunPromptStream(TestCase):
                 "customIdentifier": options.custom_identifier,
                 "parameters": options.parameters,
                 "stream": options.stream,
-                "__internal": {"source": "api"},
             },
         )
         self.assertEqual(endpoint_mock.call_count, 1)
@@ -481,7 +470,6 @@ class TestRunPromptStream(TestCase):
                 "customIdentifier": options.custom_identifier,
                 "parameters": options.parameters,
                 "stream": options.stream,
-                "__internal": {"source": "api"},
             },
         )
         self.assertEqual(endpoint_mock.call_count, 1)