flare-kernel-client-py 0.1.0__tar.gz

flare_kernel_client_py-0.1.0/PKG-INFO

@@ -0,0 +1,26 @@
+Metadata-Version: 2.4
+Name: flare-kernel-client-py
+Version: 0.1.0
+Summary: FLARE kernel client package
+License: Proprietary
+Classifier: Development Status :: 3 - Alpha
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+Requires-Dist: httpx<1.0,>=0.27
+
+# flare-kernel-client-py
+
+FLARE Kernel 流式客户端与 SSE 解析包。
+
+职责：
+
+1. 连接 Kernel SSE 端点。
+2. 解析 `event:` / `data:` 行。
+3. 不承载业务字段、不承载 UI。
+
+导出：
+
+1. `KernelStreamAdapter`
+2. `SSELineParser`

flare_kernel_client_py-0.1.0/README.md

@@ -0,0 +1,14 @@
+# flare-kernel-client-py
+
+FLARE Kernel 流式客户端与 SSE 解析包。
+
+职责：
+
+1. 连接 Kernel SSE 端点。
+2. 解析 `event:` / `data:` 行。
+3. 不承载业务字段、不承载 UI。
+
+导出：
+
+1. `KernelStreamAdapter`
+2. `SSELineParser`

flare_kernel_client_py-0.1.0/pyproject.toml

@@ -0,0 +1,25 @@
+[build-system]
+requires = ["setuptools>=68.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "flare-kernel-client-py"
+version = "0.1.0"
+description = "FLARE kernel client package"
+readme = "README.md"
+requires-python = ">=3.11"
+dependencies = [
+    "httpx>=0.27,<1.0",
+]
+license = { text = "Proprietary" }
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+]
+
+[tool.setuptools]
+package-dir = {"" = "src"}
+
+[tool.setuptools.packages.find]
+where = ["src"]

flare_kernel_client_py-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

flare_kernel_client_py-0.1.0/src/flare_kernel_client/__init__.py

@@ -0,0 +1,4 @@
+from .kernel_stream_adapter import KernelStreamAdapter
+from .sse_parser import SSELineParser
+
+__all__ = ["KernelStreamAdapter", "SSELineParser"]

flare_kernel_client_py-0.1.0/src/flare_kernel_client/kernel_stream_adapter.py

@@ -0,0 +1,77 @@
+from __future__ import annotations
+
+import os
+from typing import Any, AsyncGenerator
+
+from .sse_parser import SSELineParser
+
+
+def _read_env(name: str) -> str | None:
+    value = os.getenv(name)
+    if value is None:
+        return None
+    normalized = value.strip()
+    return normalized or None
+
+
+def _resolve_required_value(explicit: str | None, env_name: str) -> str:
+    candidate = (explicit or _read_env(env_name) or "").strip()
+    if not candidate:
+        raise ValueError(f"{env_name} is required for KernelStreamAdapter")
+    return candidate
+
+
+class KernelStreamAdapter:
+    """Generic adapter for streaming events from a Kernel SSE endpoint."""
+
+    def __init__(
+        self,
+        base_url: str | None = None,
+        path: str | None = None,
+        timeout: float = 60.0,
+    ) -> None:
+        self.base_url = _resolve_required_value(base_url, "KERNEL_BASE_URL").rstrip("/")
+        self.path = _resolve_required_value(path, "KERNEL_STREAM_PATH")
+        self.timeout = timeout
+
+    def build_stream_url(self) -> str:
+        return f"{self.base_url}/{self.path.lstrip('/')}"
+
+    async def stream_chat(
+        self,
+        session_id: str,
+        message: str,
+        enabled_tools: list[str] | None = None,
+    ) -> AsyncGenerator[dict[str, Any], None]:
+        import httpx
+
+        payload = {
+            "message": message,
+            "content": message,
+            "session_id": session_id,
+            "enabled_tools": enabled_tools or [],
+            "enabled_capabilities": enabled_tools or [],
+        }
+        parser = SSELineParser()
+
+        async with httpx.AsyncClient(timeout=self.timeout) as client:
+            async with client.stream(
+                "POST",
+                self.build_stream_url(),
+                json=payload,
+                headers={"Accept": "text/event-stream"},
+            ) as response:
+                if response.status_code != 200:
+                    error_text = await response.aread()
+                    raise Exception(
+                        f"Kernel returned error {response.status_code}: "
+                        f"{error_text.decode()}"
+                    )
+
+                async for line in response.aiter_lines():
+                    event = parser.feed_line(line)
+                    if event is not None:
+                        yield event
+
+
+__all__ = ["KernelStreamAdapter"]

flare_kernel_client_py-0.1.0/src/flare_kernel_client/sse_parser.py

@@ -0,0 +1,47 @@
+from __future__ import annotations
+
+import json
+from typing import Any
+
+
+class SSELineParser:
+    """Minimal SSE text line parser.
+
+    It keeps only the current `event:` value and turns a matching `data:` line
+    into a plain dict: {"type": ..., "data": ...}.
+    """
+
+    def __init__(self) -> None:
+        self._current_event: str | None = None
+
+    def reset(self) -> None:
+        self._current_event = None
+
+    def feed_line(self, line: str) -> dict[str, Any] | None:
+        if line is None:
+            return None
+
+        normalized = line.rstrip("\r")
+        if not normalized:
+            return None
+
+        if normalized.startswith("event:"):
+            self._current_event = normalized[6:].strip() or None
+            return None
+
+        if not normalized.startswith("data:") or not self._current_event:
+            return None
+
+        raw_data = normalized[5:].strip()
+        if not raw_data:
+            return None
+
+        try:
+            data = json.loads(raw_data)
+        except json.JSONDecodeError:
+            return None
+
+        return {"type": self._current_event, "data": data}
+
+
+__all__ = ["SSELineParser"]

flare_kernel_client_py-0.1.0/src/flare_kernel_client_py.egg-info/PKG-INFO

@@ -0,0 +1,26 @@
+Metadata-Version: 2.4
+Name: flare-kernel-client-py
+Version: 0.1.0
+Summary: FLARE kernel client package
+License: Proprietary
+Classifier: Development Status :: 3 - Alpha
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+Requires-Dist: httpx<1.0,>=0.27
+
+# flare-kernel-client-py
+
+FLARE Kernel 流式客户端与 SSE 解析包。
+
+职责：
+
+1. 连接 Kernel SSE 端点。
+2. 解析 `event:` / `data:` 行。
+3. 不承载业务字段、不承载 UI。
+
+导出：
+
+1. `KernelStreamAdapter`
+2. `SSELineParser`

flare_kernel_client_py-0.1.0/src/flare_kernel_client_py.egg-info/SOURCES.txt

@@ -0,0 +1,11 @@
+README.md
+pyproject.toml
+src/flare_kernel_client/__init__.py
+src/flare_kernel_client/kernel_stream_adapter.py
+src/flare_kernel_client/sse_parser.py
+src/flare_kernel_client_py.egg-info/PKG-INFO
+src/flare_kernel_client_py.egg-info/SOURCES.txt
+src/flare_kernel_client_py.egg-info/dependency_links.txt
+src/flare_kernel_client_py.egg-info/requires.txt
+src/flare_kernel_client_py.egg-info/top_level.txt
+tests/test_basics.py

flare_kernel_client_py-0.1.0/src/flare_kernel_client_py.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

flare_kernel_client_py-0.1.0/src/flare_kernel_client_py.egg-info/requires.txt

@@ -0,0 +1 @@
+httpx<1.0,>=0.27

flare_kernel_client_py-0.1.0/src/flare_kernel_client_py.egg-info/top_level.txt

@@ -0,0 +1 @@
+flare_kernel_client

flare_kernel_client_py-0.1.0/tests/test_basics.py

@@ -0,0 +1,34 @@
+from __future__ import annotations
+
+import flare_kernel_client
+
+from flare_kernel_client import KernelStreamAdapter, SSELineParser
+
+
+def test_package_smoke_imports_public_api() -> None:
+    assert hasattr(flare_kernel_client, "KernelStreamAdapter")
+    assert hasattr(flare_kernel_client, "SSELineParser")
+
+
+def test_sse_line_parser_parses_event_data_and_resets() -> None:
+    parser = SSELineParser()
+
+    assert parser.feed_line('data: {"ignored": true}') is None
+    assert parser.feed_line("event: message") is None
+
+    event = parser.feed_line('data: {"ok": true, "count": 2}')
+    assert event == {"type": "message", "data": {"ok": True, "count": 2}}
+
+    parser.reset()
+    assert parser.feed_line('data: {"ok": true}') is None
+
+
+def test_kernel_stream_adapter_build_stream_url_normalizes_slashes() -> None:
+    adapter = KernelStreamAdapter(
+        base_url="https://example.test/",
+        path="/kernel/stream",
+        timeout=12.5,
+    )
+
+    assert adapter.build_stream_url() == "https://example.test/kernel/stream"
+    assert adapter.timeout == 12.5