snowleopard 0.2.0__tar.gz → 0.3.0__tar.gz

{snowleopard-0.2.0 → snowleopard-0.3.0}/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2025 Snow Leopard AI
+Copyright (c) 2025 Snow Leopard, Inc
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

{snowleopard-0.2.0 → snowleopard-0.3.0}/PKG-INFO

@@ -1,11 +1,11 @@
 Metadata-Version: 2.4
 Name: snowleopard
-Version: 0.2.0
+Version: 0.3.0
 Summary: snowleopard.ai client library
 Author-email: Snowy <hello@snowleopard.ai>
 License: MIT License
         
-        Copyright (c) 2025 Snow Leopard AI
+        Copyright (c) 2025 Snow Leopard, Inc
         
         Permission is hereby granted, free of charge, to any person obtaining a copy
         of this software and associated documentation files (the "Software"), to deal

{snowleopard-0.2.0 → snowleopard-0.3.0}/src/snowleopard/__init__.py

@@ -5,7 +5,7 @@
 from snowleopard.async_client import AsyncSnowLeopardClient
 from snowleopard.client import SnowLeopardClient
 
-__version__ = "0.2.0"
+__version__ = "0.3.0"
 
 __all__ = [
     "SnowLeopardClient",

{snowleopard-0.2.0 → snowleopard-0.3.0}/src/snowleopard/async_client.py

@@ -7,7 +7,8 @@ from typing import AsyncGenerator, Optional, Dict, Any
 
 import httpx
 from snowleopard.client_base import SLClientBase
-from snowleopard.models import ResponseDataObjects, RetrieveResponseObjects, parse
+from snowleopard.error import APIBadRequest
+from snowleopard.models import APIError, parse, ResponseDataObjects, RetrieveResponseObjects
 
 
 class AsyncSnowLeopardClient(SLClientBase):
@@ -49,9 +50,13 @@ class AsyncSnowLeopardClient(SLClientBase):
             self._build_path(datafile_id, "response"),
             json=self._build_request_body(user_query, known_data),
         ) as resp:
-            resp.raise_for_status()
+            if resp.status_code not in (400,):
+                resp.raise_for_status()
             async for line in resp.aiter_lines():
-                yield parse(json.loads(line))
+                resultObj = parse(json.loads(line))
+                if isinstance(resultObj, APIError) and resp.status_code == 400:
+                    raise APIBadRequest(resultObj.description)
+                yield resultObj
 
     async def __aenter__(self):
         await self.client.__aenter__()

{snowleopard-0.2.0 → snowleopard-0.3.0}/src/snowleopard/cli.py

@@ -10,7 +10,7 @@ from typing import List, Optional, Dict, Any
 
 from httpx import HTTPStatusError
 from snowleopard import __version__, SnowLeopardClient
-from snowleopard.models import RetrieveResponseError
+from snowleopard.error import APIBadRequest
 
 
 def _create_parser() -> argparse.ArgumentParser:
@@ -82,6 +82,7 @@ def _get_client(parsed_args):
 
 
 def _retrieve(parsed_args):
+    hadErrors = False
     try:
         known_data = _parse_known_data(parsed_args.knownData)
         with _get_client(parsed_args) as client:
@@ -91,14 +92,18 @@ def _retrieve(parsed_args):
                 datafile_id=parsed_args.datafile,
             )
             print(json.dumps(dataclasses.asdict(resp)))
-            if isinstance(resp, RetrieveResponseError):
-                sys.exit(1)
+    except APIBadRequest as e:
+        print(f"error: {str(e)}", file=sys.stderr)
+        hadErrors = True
     except HTTPStatusError as e:
         print(str(e), file=sys.stderr)
+        hadErrors = True
+    if hadErrors:
         sys.exit(1)
 
 
 def _response(parsed_args):
+    hadErrors = False
     try:
         known_data = _parse_known_data(parsed_args.knownData)
         with _get_client(parsed_args) as client:
@@ -108,8 +113,13 @@ def _response(parsed_args):
                 datafile_id=parsed_args.datafile,
             ):
                 print(json.dumps(dataclasses.asdict(chunk)))
+    except APIBadRequest as e:
+        print(f"error: {str(e)}", file=sys.stderr)
+        hadErrors = True
     except HTTPStatusError as e:
         print(str(e), file=sys.stderr)
+        hadErrors = True
+    if hadErrors:
         sys.exit(1)
 
 

{snowleopard-0.2.0 → snowleopard-0.3.0}/src/snowleopard/client.py

@@ -7,7 +7,8 @@ from typing import Optional, Generator, Dict, Any
 
 import httpx
 from snowleopard.client_base import SLClientBase
-from snowleopard.models import parse, RetrieveResponseObjects, ResponseDataObjects
+from snowleopard.error import APIBadRequest
+from snowleopard.models import APIError, parse, RetrieveResponseObjects, ResponseDataObjects
 
 
 class SnowLeopardClient(SLClientBase):
@@ -35,8 +36,6 @@ class SnowLeopardClient(SLClientBase):
             url=self._build_path(datafile_id, "retrieve"),
             json=self._build_request_body(user_query, known_data),
         )
-        if resp.status_code not in (200, 409):
-            resp.raise_for_status()
         return self._parse_retrieve(resp)
 
     def response(
@@ -51,9 +50,13 @@ class SnowLeopardClient(SLClientBase):
             url=self._build_path(datafile_id, "response"),
             json=self._build_request_body(user_query, known_data),
         ) as resp:
-            resp.raise_for_status()
+            if resp.status_code not in (400,):
+                resp.raise_for_status()
             for line in resp.iter_lines():
-                yield parse(json.loads(line))
+                resultObj = parse(json.loads(line))
+                if isinstance(resultObj, APIError) and resp.status_code == 400:
+                    raise APIBadRequest(resultObj.description)
+                yield resultObj
 
     def __enter__(self):
         self.client.__enter__()

{snowleopard-0.2.0 → snowleopard-0.3.0}/src/snowleopard/client_base.py

@@ -9,7 +9,8 @@ from typing import Optional, Dict, Any
 
 import httpx
 
-from snowleopard.models import parse
+from snowleopard.error import APIBadRequest
+from snowleopard.models import APIError, parse
 
 
 @dataclass
@@ -94,6 +95,8 @@ class SLClientBase:
     def _build_request_body(
         user_query: str, known_data: Optional[Dict[str, Any]] = None
     ) -> Dict[str, Any]:
+        if not isinstance(user_query, str) or not user_query.strip():
+            raise APIBadRequest('userQuery field must not be empty/whitespace')
         body = {"userQuery": user_query}
         if known_data is not None:
             body["knownData"] = known_data
@@ -101,8 +104,13 @@ class SLClientBase:
 
     @staticmethod
     def _parse_retrieve(resp):
+        if resp.status_code not in (400, 409):
+            resp.raise_for_status()
         try:
-            return parse(resp.json())
+            resultObj = parse(resp.json())
         except Exception:
             resp.raise_for_status()
             raise
+        if isinstance(resultObj, APIError) and resp.status_code == 400:
+            raise APIBadRequest(resultObj.description)
+        return resultObj

snowleopard-0.3.0/src/snowleopard/error.py

@@ -0,0 +1,10 @@
+# -*- coding: utf-8 -*-
+# copyright 2026 Snow Leopard, Inc
+# released under the MIT license - see LICENSE file
+
+class SLException(Exception):
+    pass
+
+
+class APIBadRequest(SLException):
+    pass

{snowleopard-0.2.0 → snowleopard-0.3.0}/src/snowleopard/models.py

@@ -16,21 +16,21 @@ class StrEnum(str, Enum):
 
 
 @dataclass
-class RetrieveResponse:
-    objType = "retrieveResponse"
+class APIError:
+    objType = "apiError"
 
     callId: str
-    data: List[Union[SchemaData, ErrorSchemaData]]
-    responseStatus: ResponseStatus
+    responseStatus: str
+    description: str
 
 
 @dataclass
-class RetrieveResponseError:
-    objType = "apiError"
+class RetrieveResponse:
+    objType = "retrieveResponse"
 
     callId: str
-    responseStatus: str
-    description: str
+    data: List[Union[SchemaData, ErrorSchemaData]]
+    responseStatus: ResponseStatus
 
 
 @dataclass
@@ -97,19 +97,23 @@ class ResponseLLMResult:
 
 class ResponseStatus(StrEnum):
     SUCCESS = "SUCCESS"
+    BAD_REQUEST = "BAD_REQUEST"
     NOT_FOUND_IN_SCHEMA = "NOT_FOUND_IN_SCHEMA"
     UNKNOWN = "UNKNOWN"
     INTERNAL_SERVER_ERROR = "INTERNAL_SERVER_ERROR"
     AUTHORIZATION_FAILED = "AUTHORIZATION_FAILED"
     LLM_ERROR = "LLM_ERROR"
     LLM_TOKEN_LIMIT_REACHED = "LLM_TOKEN_LIMIT_REACHED"
+    DB_ERROR = "DB_ERROR"
+    DB_CONNECTION_ERROR = "DB_CONNECTION_ERROR"
+    DB_SYNTAX_ERROR = "DB_SYNTAX_ERROR"
 
 
 _PARSE_OBJS = {
     o.objType: o
     for o in (
+        APIError,
         RetrieveResponse,
-        RetrieveResponseError,
         SchemaData,
         ErrorSchemaData,
         ResponseStart,
@@ -119,10 +123,12 @@ _PARSE_OBJS = {
     )
 }
 
-RetrieveResponseObjects = Union[RetrieveResponse, RetrieveResponseError]
+
+RetrieveResponseObjects = Union[APIError, RetrieveResponse]
+
 
 ResponseDataObjects = Union[
-    ErrorSchemaData,
+    APIError,
     ResponseStart,
     ResponseData,
     EarlyTermination,

snowleopard-0.2.0/.claude/settings.local.json

@@ -1,17 +0,0 @@
-{
-  "permissions": {
-    "allow": [
-      "Bash(mkdir:*)",
-      "Bash(uv add:*)",
-      "Bash(uv run pytest:*)",
-      "WebFetch(domain:www.python-httpx.org)",
-      "Bash(python -c:*)",
-      "Bash(uv run python:*)",
-      "WebFetch(domain:github.com)",
-      "Bash(uv run snowy response --help:*)",
-      "Bash(uv run:*)"
-    ],
-    "deny": [],
-    "ask": []
-  }
-}