modus-sdk 0.2.2__tar.gz → 0.2.3__tar.gz

{modus_sdk-0.2.2 → modus_sdk-0.2.3}/CHANGELOG.md

@@ -5,6 +5,8 @@
 
 ## [Unreleased]
 
+## [0.2.3] — 2026-07-20
+
 ## [0.2.2] — 2026-07-20
 
 ## [0.2.0] — 2026-07-20

{modus_sdk-0.2.2 → modus_sdk-0.2.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: modus-sdk
-Version: 0.2.2
+Version: 0.2.3
 Summary: Official Python client for Modus — your organization's context layer for AI
 License: MIT
 License-File: LICENSE

modus_sdk-0.2.3/modus/_agent_run_request.py

@@ -0,0 +1,22 @@
+"""Shared agent-host run request helpers (chat_stream + runs.create*)."""
+
+from __future__ import annotations
+
+from typing import Any, Mapping, Optional
+from uuid import uuid4
+
+
+def resolve_agent_run_session_id(session_id: Optional[str] = None) -> str:
+    """Mint or reuse a non-empty sessionId for agent-host runs."""
+    if isinstance(session_id, str) and session_id.strip():
+        return session_id.strip()
+    return str(uuid4())
+
+
+def with_agent_run_session_id(body: Mapping[str, Any]) -> dict[str, Any]:
+    """Copy body and ensure sessionId is set (parity with chat_stream)."""
+    out: dict[str, Any] = dict(body)
+    out["sessionId"] = resolve_agent_run_session_id(
+        out.get("sessionId") if isinstance(out.get("sessionId"), str) else None
+    )
+    return out

{modus_sdk-0.2.2 → modus_sdk-0.2.3}/modus/_chat.py

@@ -2,10 +2,10 @@
 
 from __future__ import annotations
 
-import uuid
 from typing import Any, AsyncIterator, Dict, Iterator, List, Literal, Optional, Union
 from urllib.parse import quote
 
+from ._agent_run_request import resolve_agent_run_session_id
 from ._exceptions import ModusError, RunCancelledError, StreamTimeoutError
 from ._generated.models import SkillChatRequestDto, SkillChatResponseDto
 from ._http import AsyncHttpClient, HttpClient
@@ -37,8 +37,7 @@ def _effective_thread_id(thread_id: Optional[str]) -> Optional[str]:
 
 def _resolve_session_id(thread_id: Optional[str]) -> str:
     """Agent-host runs always require sessionId — reuse thread_id or mint a UUID."""
-    tid = _effective_thread_id(thread_id)
-    return tid if tid is not None else str(uuid.uuid4())
+    return resolve_agent_run_session_id(_effective_thread_id(thread_id))
 
 
 def _chat_path(

{modus_sdk-0.2.2 → modus_sdk-0.2.3}/modus/_http.py

@@ -174,6 +174,34 @@ async def _raise_for_status_async(response: httpx.Response) -> None:
     _raise_for_status_with_body(response, body)
 
 
+def _ensure_sse_content_type(response: httpx.Response, body_preview: str = "") -> None:
+    """Reject non-SSE responses so empty streams never look like success."""
+    ct = (response.headers.get("content-type") or "").lower()
+    if "text/event-stream" in ct:
+        return
+    preview = body_preview[:200]
+    raise ModusError(
+        f"Unexpected stream response: expected Content-Type text/event-stream, "
+        f"got {response.headers.get('content-type')!r}. "
+        f"Body preview: {preview}",
+        status_code=response.status_code,
+        body=preview or None,
+    )
+
+
+def _sse_body_preview_from_lines(lines: Iterator[str], limit: int = 200) -> str:
+    """Accumulate at most ``limit`` characters from an iterator of lines."""
+    preview = ""
+    for line in lines:
+        remaining = limit - len(preview)
+        if remaining <= 0:
+            break
+        preview += line[:remaining]
+        if len(preview) >= limit:
+            break
+    return preview
+
+
 # ---------------------------------------------------------------------------
 # Sync client
 # ---------------------------------------------------------------------------
@@ -307,8 +335,19 @@ class HttpClient:
         """Make a streaming request and yield raw SSE lines."""
         effective_base_url = base_url or self._config.base_url
         try:
-            with self._client.stream(method, _request_url(path, base_url), json=json) as response:
+            # Override client default Accept: application/json — agent-service
+            # negotiates SSE vs JSON polling on Accept.
+            with self._client.stream(
+                method,
+                _request_url(path, base_url),
+                json=json,
+                headers={"Accept": "text/event-stream"},
+            ) as response:
                 _raise_for_status(response)
+                ct = (response.headers.get("content-type") or "").lower()
+                if "text/event-stream" not in ct:
+                    preview = _sse_body_preview_from_lines(response.iter_lines())
+                    _ensure_sse_content_type(response, preview)
                 for line in response.iter_lines():
                     if line.strip():
                         yield line
@@ -453,8 +492,27 @@ class AsyncHttpClient:
         """Streaming request — yields raw SSE lines."""
         effective_base_url = base_url or self._config.base_url
         try:
-            async with self._client.stream(method, _request_url(path, base_url), json=json) as response:
+            async with self._client.stream(
+                method,
+                _request_url(path, base_url),
+                json=json,
+                headers={"Accept": "text/event-stream"},
+            ) as response:
                 await _raise_for_status_async(response)
+                ct = (response.headers.get("content-type") or "").lower()
+                if "text/event-stream" not in ct:
+                    chunks: list[str] = []
+                    size = 0
+                    async for line in response.aiter_lines():
+                        remaining = 200 - size
+                        if remaining <= 0:
+                            break
+                        piece = line[:remaining]
+                        chunks.append(piece)
+                        size += len(piece)
+                        if size >= 200:
+                            break
+                    _ensure_sse_content_type(response, "".join(chunks))
                 async for line in response.aiter_lines():
                     if line.strip():
                         yield line

{modus_sdk-0.2.2 → modus_sdk-0.2.3}/modus/_version.py

@@ -18,7 +18,7 @@ version_tuple: tuple[int | str, ...]
 commit_id: str | None
 __commit_id__: str | None
 
-__version__ = version = '0.2.2'
-__version_tuple__ = version_tuple = (0, 2, 2)
+__version__ = version = '0.2.3'
+__version_tuple__ = version_tuple = (0, 2, 3)
 
 __commit_id__ = commit_id = None

{modus_sdk-0.2.2 → modus_sdk-0.2.3}/modus/resources/workflows/runs.py

@@ -15,6 +15,7 @@ from typing import (
     Union,
 )
 
+from ..._agent_run_request import with_agent_run_session_id
 from ..._config import ModusConfig
 from ..._generated.models import (
     ActiveRunsBySessionResponseDto,
@@ -115,7 +116,8 @@ def _runs_list_params(
 
 
 def _request_body(body: Mapping[str, Any]) -> Dict[str, Any]:
-    return dict(body)
+    """Copy body and mint sessionId when omitted (parity with chat_stream)."""
+    return with_agent_run_session_id(body)
 
 
 def _optional_body(body: Optional[Mapping[str, Any]]) -> Dict[str, Any]: