latitude-sdk 0.1.0b7__tar.gz → 0.1.0b9__tar.gz

{latitude_sdk-0.1.0b7 → latitude_sdk-0.1.0b9}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: latitude-sdk
-Version: 0.1.0b7
+Version: 0.1.0b9
 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
@@ -11,7 +11,7 @@ License-Expression: LGPL-3.0
 Requires-Python: <3.13,>=3.9
 Requires-Dist: httpx-sse>=0.4.0
 Requires-Dist: httpx>=0.28.1
-Requires-Dist: latitude-telemetry>=0.1.0b5
+Requires-Dist: latitude-telemetry>=0.1.0b6
 Requires-Dist: pydantic>=2.10.3
 Requires-Dist: typing-extensions>=4.12.2
 Description-Content-Type: text/markdown

{latitude_sdk-0.1.0b7 → latitude_sdk-0.1.0b9}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "latitude-sdk"
-version = "0.1.0-beta.7"
+version = "0.1.0-beta.9"
 description = "Latitude SDK for Python"
 authors = [{ name = "Latitude Data SL", email = "hello@latitude.so" }]
 maintainers = [{ name = "Latitude Data SL", email = "hello@latitude.so" }]
@@ -15,7 +15,7 @@ dependencies = [
     "httpx-sse>=0.4.0",
     "pydantic>=2.10.3",
     "typing-extensions>=4.12.2",
-    "latitude-telemetry>=0.1.0b5",
+    "latitude-telemetry>=0.1.0b6",
 ]
 
 [dependency-groups]

{latitude_sdk-0.1.0b7 → latitude_sdk-0.1.0b9}/src/latitude_sdk/sdk/evaluations.py

@@ -41,6 +41,8 @@ class Evaluations:
         self._client = client
 
     async def trigger(self, uuid: str, options: TriggerEvaluationOptions) -> TriggerEvaluationResult:
+        options = TriggerEvaluationOptions(**{**dict(self._options), **dict(options)})
+
         async with self._client.request(
             handler=RequestHandler.TriggerEvaluation,
             params=TriggerEvaluationRequestParams(
@@ -55,6 +57,8 @@ class Evaluations:
     async def create_result(
         self, uuid: str, evaluation_uuid: str, options: CreateEvaluationResultOptions
     ) -> CreateEvaluationResultResult:
+        options = CreateEvaluationResultOptions(**{**dict(self._options), **dict(options)})
+
         async with self._client.request(
             handler=RequestHandler.CreateEvaluationResult,
             params=CreateEvaluationResultRequestParams(

{latitude_sdk-0.1.0b7 → latitude_sdk-0.1.0b9}/src/latitude_sdk/sdk/latitude.py

@@ -1,6 +1,5 @@
 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
@@ -40,7 +39,7 @@ DEFAULT_INTERNAL_OPTIONS = InternalOptions(
 
 
 DEFAULT_LATITUDE_OPTIONS = LatitudeOptions(
-    telemetry=None,  # Note: Telemetry is opt-in
+    telemetry=None,  # NOTE: Telemetry is opt-in
     internal=DEFAULT_INTERNAL_OPTIONS,
 )
 
@@ -79,9 +78,6 @@ class Latitude:
         )
 
         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)

{latitude_sdk-0.1.0b7 → latitude_sdk-0.1.0b9}/src/latitude_sdk/sdk/logs.py

@@ -1,4 +1,4 @@
-from typing import Iterable, Optional
+from typing import Any, Dict, Optional, Sequence, Union
 
 from latitude_sdk.client import Client, CreateLogRequestBody, CreateLogRequestParams, RequestHandler
 from latitude_sdk.sdk.errors import ApiError, ApiErrorCodes
@@ -6,6 +6,7 @@ from latitude_sdk.sdk.types import (
     Log,
     Message,
     SdkOptions,
+    _Message,
 )
 from latitude_sdk.util import Model
 
@@ -31,9 +32,8 @@ class Logs:
         self._options = options
         self._client = client
 
-    def _ensure_options(self, options: LogOptions) -> LogOptions:
-        project_id = options.project_id or self._options.project_id
-        if not project_id:
+    def _ensure_log_options(self, options: LogOptions):
+        if not options.project_id:
             raise ApiError(
                 status=404,
                 code=ApiErrorCodes.NotFoundError,
@@ -41,16 +41,15 @@ class Logs:
                 response="Project ID is required",
             )
 
-        version_uuid = options.version_uuid or self._options.version_uuid
-
-        return LogOptions(project_id=project_id, version_uuid=version_uuid)
-
-    async def create(self, path: str, messages: Iterable[Message], options: CreateLogOptions) -> CreateLogResult:
-        log_options = self._ensure_options(options)
-        options = CreateLogOptions(**{**dict(options), **dict(log_options)})
-
+    async def create(
+        self, path: str, messages: Sequence[Union[Message, Dict[str, Any]]], options: CreateLogOptions
+    ) -> CreateLogResult:
+        options = CreateLogOptions(**{**dict(self._options), **dict(options)})
+        self._ensure_log_options(options)
         assert options.project_id is not None
 
+        messages = [_Message.validate_python(message) for message in messages]
+
         async with self._client.request(
             handler=RequestHandler.CreateLog,
             params=CreateLogRequestParams(
@@ -59,7 +58,7 @@ class Logs:
             ),
             body=CreateLogRequestBody(
                 path=path,
-                messages=list(messages),
+                messages=messages,
                 response=options.response,
             ),
         ) as response:

{latitude_sdk-0.1.0b7 → latitude_sdk-0.1.0b9}/src/latitude_sdk/sdk/prompts.py

@@ -1,4 +1,5 @@
-from typing import Any, AsyncGenerator, Dict, Iterable, List, Optional
+import asyncio
+from typing import Any, AsyncGenerator, Dict, List, Optional, Sequence, Union
 
 from latitude_sdk.client import (
     ChatPromptRequestBody,
@@ -21,14 +22,25 @@ from latitude_sdk.sdk.types import (
     ChainEventStepCompleted,
     FinishedEvent,
     Message,
+    OnToolCall,
+    OnToolCallDetails,
     Prompt,
     SdkOptions,
     StreamCallbacks,
     StreamEvents,
+    StreamTypes,
+    ToolMessage,
+    ToolResult,
+    ToolResultContent,
+    _Message,
 )
 from latitude_sdk.util import Model
 
 
+class OnToolCallPaused(Exception):
+    pass
+
+
 class PromptOptions(Model):
     project_id: Optional[int] = None
     version_uuid: Optional[str] = None
@@ -53,6 +65,7 @@ class GetOrCreatePromptResult(Prompt, Model):
 class RunPromptOptions(StreamCallbacks, PromptOptions, Model):
     custom_identifier: Optional[str] = None
     parameters: Optional[Dict[str, Any]] = None
+    tools: Optional[Dict[str, OnToolCall]] = None
     stream: Optional[bool] = None
 
 
@@ -61,6 +74,7 @@ class RunPromptResult(FinishedEvent, Model):
 
 
 class ChatPromptOptions(StreamCallbacks, Model):
+    tools: Optional[Dict[str, OnToolCall]] = None
     stream: Optional[bool] = None
 
 
@@ -76,9 +90,8 @@ class Prompts:
         self._options = options
         self._client = client
 
-    def _ensure_options(self, options: PromptOptions) -> PromptOptions:
-        project_id = options.project_id or self._options.project_id
-        if not project_id:
+    def _ensure_prompt_options(self, options: PromptOptions):
+        if not options.project_id:
             raise ApiError(
                 status=404,
                 code=ApiErrorCodes.NotFoundError,
@@ -86,12 +99,8 @@ class Prompts:
                 response="Project ID is required",
             )
 
-        version_uuid = options.version_uuid or self._options.version_uuid
-
-        return PromptOptions(project_id=project_id, version_uuid=version_uuid)
-
     async def _handle_stream(
-        self, stream: AsyncGenerator[ClientEvent, Any], callbacks: StreamCallbacks
+        self, stream: AsyncGenerator[ClientEvent, Any], on_event: Optional[StreamCallbacks.OnEvent]
     ) -> FinishedEvent:
         uuid = None
         conversation: List[Message] = []
@@ -145,8 +154,8 @@ class Prompts:
                     response=stream_event.data,
                 )
 
-            if callbacks.on_event:
-                callbacks.on_event(event)
+            if on_event:
+                on_event(event)
 
         if not uuid or not response:
             raise ApiError(
@@ -159,10 +168,65 @@ class Prompts:
         # NOTE: FinishedEvent not in on_event
         return FinishedEvent(uuid=uuid, conversation=conversation, response=response)
 
-    async def get(self, path: str, options: GetPromptOptions) -> GetPromptResult:
-        prompt_options = self._ensure_options(options)
-        options = GetPromptOptions(**{**dict(options), **dict(prompt_options)})
+    def _pause_tool_execution(self) -> ToolResult:
+        raise OnToolCallPaused()
+
+    async def _handle_tool_calls(
+        self, result: FinishedEvent, options: Union[RunPromptOptions, ChatPromptOptions]
+    ) -> Optional[FinishedEvent]:
+        # Seems Python cannot infer the type
+        assert result.response.type == StreamTypes.Text and result.response.tool_calls is not None
 
+        if not options.tools:
+            raise ApiError(
+                status=400,
+                code=ApiErrorCodes.AIRunError,
+                message="Tools not supplied",
+                response="Tools not supplied",
+            )
+
+        for tool_call in result.response.tool_calls:
+            if tool_call.name not in options.tools:
+                raise ApiError(
+                    status=400,
+                    code=ApiErrorCodes.AIRunError,
+                    message=f"Tool {tool_call.name} not supplied",
+                    response=f"Tool {tool_call.name} not supplied",
+                )
+
+        details = OnToolCallDetails(
+            conversation_uuid=result.uuid,
+            messages=result.conversation,
+            pause_execution=self._pause_tool_execution,
+            requested_tool_calls=result.response.tool_calls,
+        )
+
+        tool_results = await asyncio.gather(
+            *[options.tools[tool_call.name](tool_call, details) for tool_call in result.response.tool_calls],
+            return_exceptions=False,
+        )
+
+        tool_messages = [
+            ToolMessage(
+                content=[
+                    ToolResultContent(
+                        id=tool_result.id,
+                        name=tool_result.name,
+                        result=tool_result.result,
+                        is_error=tool_result.is_error,
+                    )
+                ]
+            )
+            for tool_result in tool_results
+        ]
+
+        next_result = await self.chat(result.uuid, tool_messages, ChatPromptOptions(**dict(options)))
+
+        return FinishedEvent(**dict(next_result)) if next_result else None
+
+    async def get(self, path: str, options: GetPromptOptions) -> GetPromptResult:
+        options = GetPromptOptions(**{**dict(self._options), **dict(options)})
+        self._ensure_prompt_options(options)
         assert options.project_id is not None
 
         async with self._client.request(
@@ -176,9 +240,8 @@ class Prompts:
             return GetPromptResult.model_validate_json(response.content)
 
     async def get_or_create(self, path: str, options: GetOrCreatePromptOptions) -> GetOrCreatePromptResult:
-        prompt_options = self._ensure_options(options)
-        options = GetOrCreatePromptOptions(**{**dict(options), **dict(prompt_options)})
-
+        options = GetOrCreatePromptOptions(**{**dict(self._options), **dict(options)})
+        self._ensure_prompt_options(options)
         assert options.project_id is not None
 
         async with self._client.request(
@@ -196,9 +259,8 @@ class Prompts:
 
     async def run(self, path: str, options: RunPromptOptions) -> Optional[RunPromptResult]:
         try:
-            prompt_options = self._ensure_options(options)
-            options = RunPromptOptions(**{**dict(options), **dict(prompt_options)})
-
+            options = RunPromptOptions(**{**dict(self._options), **dict(options)})
+            self._ensure_prompt_options(options)
             assert options.project_id is not None
 
             async with self._client.request(
@@ -215,21 +277,22 @@ class Prompts:
                 ),
             ) as response:
                 if options.stream:
-                    result = await self._handle_stream(
-                        response.sse(),
-                        callbacks=StreamCallbacks(
-                            on_event=options.on_event,
-                            on_finished=options.on_finished,
-                            on_error=options.on_error,
-                        ),
-                    )
+                    result = await self._handle_stream(response.sse(), options.on_event)
                 else:
                     result = RunPromptResult.model_validate_json(response.content)
 
-                if options.on_finished:
-                    options.on_finished(FinishedEvent(**dict(result)))
+            if options.tools and result.response.type == StreamTypes.Text and result.response.tool_calls:
+                try:
+                    # NOTE: The last sdk.chat called will already call on_finished
+                    final_result = await self._handle_tool_calls(result, options)
+                    return RunPromptResult(**dict(final_result)) if final_result else None
+                except OnToolCallPaused:
+                    pass
+
+            if options.on_finished:
+                options.on_finished(FinishedEvent(**dict(result)))
 
-                return RunPromptResult(**dict(result))
+            return RunPromptResult(**dict(result))
 
         except Exception as exception:
             if not isinstance(exception, ApiError):
@@ -248,35 +311,40 @@ class Prompts:
             return None
 
     async def chat(
-        self, uuid: str, messages: Iterable[Message], options: ChatPromptOptions
+        self, uuid: str, messages: Sequence[Union[Message, Dict[str, Any]]], options: ChatPromptOptions
     ) -> Optional[ChatPromptResult]:
         try:
+            options = ChatPromptOptions(**{**dict(self._options), **dict(options)})
+
+            messages = [_Message.validate_python(message) for message in messages]
+
             async with self._client.request(
                 handler=RequestHandler.ChatPrompt,
                 params=ChatPromptRequestParams(
                     conversation_uuid=uuid,
                 ),
                 body=ChatPromptRequestBody(
-                    messages=list(messages),
+                    messages=messages,
                     stream=options.stream,
                 ),
             ) as response:
                 if options.stream:
-                    result = await self._handle_stream(
-                        response.sse(),
-                        callbacks=StreamCallbacks(
-                            on_event=options.on_event,
-                            on_finished=options.on_finished,
-                            on_error=options.on_error,
-                        ),
-                    )
+                    result = await self._handle_stream(response.sse(), options.on_event)
                 else:
                     result = ChatPromptResult.model_validate_json(response.content)
 
-                if options.on_finished:
-                    options.on_finished(FinishedEvent(**dict(result)))
+            if options.tools and result.response.type == StreamTypes.Text and result.response.tool_calls:
+                try:
+                    # NOTE: The last sdk.chat called will already call on_finished
+                    final_result = await self._handle_tool_calls(result, options)
+                    return ChatPromptResult(**dict(final_result)) if final_result else None
+                except OnToolCallPaused:
+                    pass
+
+            if options.on_finished:
+                options.on_finished(FinishedEvent(**dict(result)))
 
-                return ChatPromptResult(**dict(result))
+            return ChatPromptResult(**dict(result))
 
         except Exception as exception:
             if not isinstance(exception, ApiError):

{latitude_sdk-0.1.0b7 → latitude_sdk-0.1.0b9}/src/latitude_sdk/sdk/types.py

@@ -1,8 +1,8 @@
 from datetime import datetime
-from typing import Any, Dict, List, Literal, Optional, Protocol, Union, runtime_checkable
+from typing import Any, Callable, Dict, List, Literal, Optional, Protocol, Union, runtime_checkable
 
 from latitude_sdk.sdk.errors import ApiError
-from latitude_sdk.util import Field, Model, StrEnum
+from latitude_sdk.util import Adapter, Field, Model, StrEnum
 
 
 class DbErrorRef(Model):
@@ -63,7 +63,7 @@ class ToolResultContent(Model):
     type: Literal[ContentType.ToolResult] = ContentType.ToolResult
     id: str = Field(alias=str("toolCallId"))
     name: str = Field(alias=str("toolName"))
-    result: str
+    result: Any
     is_error: Optional[bool] = Field(default=None, alias=str("isError"))
 
 
@@ -106,6 +106,7 @@ class ToolMessage(Model):
 
 
 Message = Union[SystemMessage, UserMessage, AssistantMessage, ToolMessage]
+_Message = Adapter(Message)
 
 
 class ModelUsage(Model):
@@ -114,12 +115,29 @@ class ModelUsage(Model):
     total_tokens: int = Field(alias=str("totalTokens"))
 
 
+class FinishReason(StrEnum):
+    Stop = "stop"
+    Length = "length"
+    ContentFilter = "content-filter"
+    ToolCalls = "tool-calls"
+    Error = "error"
+    Other = "other"
+    Unknown = "unknown"
+
+
 class ToolCall(Model):
     id: str
     name: str
     arguments: Dict[str, Any]
 
 
+class ToolResult(Model):
+    id: str
+    name: str
+    result: Any
+    is_error: Optional[bool] = None
+
+
 class StreamTypes(StrEnum):
     Text = "text"
     Object = "object"
@@ -183,6 +201,7 @@ class ChainEventCompleted(Model):
     event: Literal[StreamEvents.Latitude] = StreamEvents.Latitude
     type: Literal[ChainEvents.Completed] = ChainEvents.Completed
     uuid: Optional[str] = None
+    finish_reason: FinishReason = Field(alias=str("finishReason"))
     config: Dict[str, Any]
     messages: Optional[List[Message]] = None
     object: Optional[Any] = None
@@ -275,9 +294,22 @@ class StreamCallbacks(Model):
     on_error: Optional[OnError] = None
 
 
+class OnToolCallDetails(Model):
+    conversation_uuid: str
+    messages: List[Message]
+    pause_execution: Callable[[], ToolResult]
+    requested_tool_calls: List[ToolCall]
+
+
+@runtime_checkable
+class OnToolCall(Protocol):
+    async def __call__(self, call: ToolCall, details: OnToolCallDetails) -> ToolResult: ...
+
+
 class SdkOptions(Model):
     project_id: Optional[int] = None
     version_uuid: Optional[str] = None
+    tools: Optional[Dict[str, OnToolCall]] = None
 
 
 class GatewayOptions(Model):

{latitude_sdk-0.1.0b7 → latitude_sdk-0.1.0b9}/src/latitude_sdk/util/utils.py

@@ -63,6 +63,7 @@ class StrEnum(str, Enum):
 
 Field = pydantic.Field
 Config = pydantic.ConfigDict
+Adapter = pydantic.TypeAdapter
 
 
 class Model(pydantic.BaseModel):