studyfetch-sdk 0.1.0a20__tar.gz → 0.1.0a21__tar.gz

{studyfetch_sdk-0.1.0a20 → studyfetch_sdk-0.1.0a21}/.gitignore

@@ -1,5 +1,4 @@
 .prism.log
-.vscode
 _dev
 
 __pycache__

studyfetch_sdk-0.1.0a21/.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+  ".": "0.1.0-alpha.21"
+}

{studyfetch_sdk-0.1.0a20 → studyfetch_sdk-0.1.0a21}/CHANGELOG.md

@@ -1,5 +1,26 @@
 # Changelog
 
+## 0.1.0-alpha.21 (2025-07-26)
+
+Full Changelog: [v0.1.0-alpha.20...v0.1.0-alpha.21](https://github.com/GoStudyFetchGo/studyfetch-sdk-python/compare/v0.1.0-alpha.20...v0.1.0-alpha.21)
+
+### Features
+
+* **api:** api update ([598ed4a](https://github.com/GoStudyFetchGo/studyfetch-sdk-python/commit/598ed4aa9870a220f567090c2c22a380b6e8a39d))
+* **api:** api update ([1ca67b9](https://github.com/GoStudyFetchGo/studyfetch-sdk-python/commit/1ca67b9565830a352b95bb6509155db8b4abf2a7))
+* **api:** api update ([edde35c](https://github.com/GoStudyFetchGo/studyfetch-sdk-python/commit/edde35c095d711d48332be135c7a6618350864df))
+* **api:** api update ([4891c2c](https://github.com/GoStudyFetchGo/studyfetch-sdk-python/commit/4891c2ca88ad4f3886468c5fef0dd54626640bbd))
+* **api:** api update ([f988365](https://github.com/GoStudyFetchGo/studyfetch-sdk-python/commit/f9883659a11e1b8c07bc7fc0ba66ee7dac060db4))
+* **api:** manual updates ([ec6c3fd](https://github.com/GoStudyFetchGo/studyfetch-sdk-python/commit/ec6c3fd8421da42c5ba040640b65f705faa256e3))
+* **api:** manual updates ([be7ba51](https://github.com/GoStudyFetchGo/studyfetch-sdk-python/commit/be7ba5130b9a741ad2344fbe28713d265a6b3300))
+* **api:** manual updates ([429fb80](https://github.com/GoStudyFetchGo/studyfetch-sdk-python/commit/429fb8066d183997b7e7b4ac6fb604d4d179f974))
+* **api:** manual updates ([c31d639](https://github.com/GoStudyFetchGo/studyfetch-sdk-python/commit/c31d6392cf5cb03569052af6c32338822b78d9ba))
+
+
+### Chores
+
+* **project:** add settings file for vscode ([5149c86](https://github.com/GoStudyFetchGo/studyfetch-sdk-python/commit/5149c862af1e8fa4ecff6078c59e69b756346a8c))
+
 ## 0.1.0-alpha.20 (2025-07-24)
 
 Full Changelog: [v0.1.0-alpha.19...v0.1.0-alpha.20](https://github.com/GoStudyFetchGo/studyfetch-sdk-python/compare/v0.1.0-alpha.19...v0.1.0-alpha.20)

{studyfetch_sdk-0.1.0a20 → studyfetch_sdk-0.1.0a21}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: studyfetch_sdk
-Version: 0.1.0a20
+Version: 0.1.0a21
 Summary: The official Python library for the studyfetch-sdk API
 Project-URL: Homepage, https://github.com/GoStudyFetchGo/studyfetch-sdk-python
 Project-URL: Repository, https://github.com/GoStudyFetchGo/studyfetch-sdk-python

{studyfetch_sdk-0.1.0a20 → studyfetch_sdk-0.1.0a21}/api.md

@@ -11,6 +11,7 @@ Types:
 ```python
 from studyfetch_sdk.types.v1 import (
     Content,
+    GeneratedMaterial,
     Material,
     MaterialListResponse,
     MaterialBatchCreateResponse,
@@ -29,6 +30,8 @@ Methods:
 - <code title="post /api/v1/materials/batch">client.v1.materials.<a href="./src/studyfetch_sdk/resources/v1/materials/materials.py">batch_create</a>(\*\*<a href="src/studyfetch_sdk/types/v1/material_batch_create_params.py">params</a>) -> <a href="./src/studyfetch_sdk/types/v1/material_batch_create_response.py">MaterialBatchCreateResponse</a></code>
 - <code title="post /api/v1/materials/upload-and-process">client.v1.materials.<a href="./src/studyfetch_sdk/resources/v1/materials/materials.py">create_and_process</a>(\*\*<a href="src/studyfetch_sdk/types/v1/material_create_and_process_params.py">params</a>) -> <a href="./src/studyfetch_sdk/types/v1/material.py">Material</a></code>
 - <code title="get /api/v1/materials/{id}/debug">client.v1.materials.<a href="./src/studyfetch_sdk/resources/v1/materials/materials.py">debug</a>(id) -> <a href="./src/studyfetch_sdk/types/v1/material_debug_response.py">MaterialDebugResponse</a></code>
+- <code title="post /api/v1/materials/generate">client.v1.materials.<a href="./src/studyfetch_sdk/resources/v1/materials/materials.py">generate</a>(\*\*<a href="src/studyfetch_sdk/types/v1/material_generate_params.py">params</a>) -> <a href="./src/studyfetch_sdk/types/v1/generated_material.py">GeneratedMaterial</a></code>
+- <code title="post /api/v1/materials/generate-and-process">client.v1.materials.<a href="./src/studyfetch_sdk/resources/v1/materials/materials.py">generate_and_process</a>(\*\*<a href="src/studyfetch_sdk/types/v1/material_generate_and_process_params.py">params</a>) -> <a href="./src/studyfetch_sdk/types/v1/generated_material.py">GeneratedMaterial</a></code>
 - <code title="get /api/v1/materials/{id}/download-url">client.v1.materials.<a href="./src/studyfetch_sdk/resources/v1/materials/materials.py">get_download_url</a>(id, \*\*<a href="src/studyfetch_sdk/types/v1/material_get_download_url_params.py">params</a>) -> <a href="./src/studyfetch_sdk/types/v1/material_get_download_url_response.py">MaterialGetDownloadURLResponse</a></code>
 - <code title="post /api/v1/materials/{id}/move">client.v1.materials.<a href="./src/studyfetch_sdk/resources/v1/materials/materials.py">move</a>(id, \*\*<a href="src/studyfetch_sdk/types/v1/material_move_params.py">params</a>) -> <a href="./src/studyfetch_sdk/types/v1/material.py">Material</a></code>
 - <code title="post /api/v1/materials/{id}/rename">client.v1.materials.<a href="./src/studyfetch_sdk/resources/v1/materials/materials.py">rename</a>(id, \*\*<a href="src/studyfetch_sdk/types/v1/material_rename_params.py">params</a>) -> <a href="./src/studyfetch_sdk/types/v1/material.py">Material</a></code>
@@ -154,27 +157,6 @@ Methods:
 - <code title="get /api/v1/embed/component/{componentId}">client.v1.embed.component.<a href="./src/studyfetch_sdk/resources/v1/embed/component.py">retrieve</a>(component_id, \*\*<a href="src/studyfetch_sdk/types/v1/embed/component_retrieve_params.py">params</a>) -> None</code>
 - <code title="post /api/v1/embed/component/{componentId}/interact">client.v1.embed.component.<a href="./src/studyfetch_sdk/resources/v1/embed/component.py">interact</a>(component_id, \*\*<a href="src/studyfetch_sdk/types/v1/embed/component_interact_params.py">params</a>) -> None</code>
 
-## Upload
-
-### Component
-
-Types:
-
-```python
-from studyfetch_sdk.types.v1.upload import (
-    FileUploadResponse,
-    ComponentCompleteUploadResponse,
-    ComponentGetPresignedURLResponse,
-)
-```
-
-Methods:
-
-- <code title="post /api/v1/upload/component/{componentId}/complete">client.v1.upload.component.<a href="./src/studyfetch_sdk/resources/v1/upload/component.py">complete_upload</a>(component_id, \*\*<a href="src/studyfetch_sdk/types/v1/upload/component_complete_upload_params.py">params</a>) -> <a href="./src/studyfetch_sdk/types/v1/upload/component_complete_upload_response.py">ComponentCompleteUploadResponse</a></code>
-- <code title="post /api/v1/upload/component/{componentId}/presigned-url">client.v1.upload.component.<a href="./src/studyfetch_sdk/resources/v1/upload/component.py">get_presigned_url</a>(component_id, \*\*<a href="src/studyfetch_sdk/types/v1/upload/component_get_presigned_url_params.py">params</a>) -> <a href="./src/studyfetch_sdk/types/v1/upload/component_get_presigned_url_response.py">ComponentGetPresignedURLResponse</a></code>
-- <code title="post /api/v1/upload/component/{componentId}/file">client.v1.upload.component.<a href="./src/studyfetch_sdk/resources/v1/upload/component.py">upload_file</a>(component_id, \*\*<a href="src/studyfetch_sdk/types/v1/upload/component_upload_file_params.py">params</a>) -> <a href="./src/studyfetch_sdk/types/v1/upload/file_upload_response.py">FileUploadResponse</a></code>
-- <code title="post /api/v1/upload/component/{componentId}/url">client.v1.upload.component.<a href="./src/studyfetch_sdk/resources/v1/upload/component.py">upload_url</a>(component_id, \*\*<a href="src/studyfetch_sdk/types/v1/upload/component_upload_url_params.py">params</a>) -> <a href="./src/studyfetch_sdk/types/v1/upload/file_upload_response.py">FileUploadResponse</a></code>
-
 ## AssignmentGrader
 
 Types:
@@ -189,3 +171,9 @@ Methods:
 - <code title="delete /api/v1/assignment-grader/delete/{id}">client.v1.assignment_grader.<a href="./src/studyfetch_sdk/resources/v1/assignment_grader.py">delete</a>(id) -> None</code>
 - <code title="get /api/v1/assignment-grader/get">client.v1.assignment_grader.<a href="./src/studyfetch_sdk/resources/v1/assignment_grader.py">get_all</a>() -> <a href="./src/studyfetch_sdk/types/v1/assignment_grader_get_all_response.py">AssignmentGraderGetAllResponse</a></code>
 - <code title="get /api/v1/assignment-grader/get/{id}">client.v1.assignment_grader.<a href="./src/studyfetch_sdk/resources/v1/assignment_grader.py">get_by_id</a>(id) -> <a href="./src/studyfetch_sdk/types/v1/assignment_grader_response.py">AssignmentGraderResponse</a></code>
+
+## Chat
+
+Methods:
+
+- <code title="post /api/v1/chat/stream">client.v1.chat.<a href="./src/studyfetch_sdk/resources/v1/chat.py">stream</a>(\*\*<a href="src/studyfetch_sdk/types/v1/chat_stream_params.py">params</a>) -> None</code>

{studyfetch_sdk-0.1.0a20 → studyfetch_sdk-0.1.0a21}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "studyfetch_sdk"
-version = "0.1.0-alpha.20"
+version = "0.1.0-alpha.21"
 description = "The official Python library for the studyfetch-sdk API"
 dynamic = ["readme"]
 license = "Apache-2.0"

{studyfetch_sdk-0.1.0a20 → studyfetch_sdk-0.1.0a21}/src/studyfetch_sdk/_version.py

@@ -1,4 +1,4 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 __title__ = "studyfetch_sdk"
-__version__ = "0.1.0-alpha.20"  # x-release-please-version
+__version__ = "0.1.0-alpha.21"  # x-release-please-version

{studyfetch_sdk-0.1.0a20 → studyfetch_sdk-0.1.0a21}/src/studyfetch_sdk/resources/v1/__init__.py

@@ -8,6 +8,14 @@ from .v1 import (
     V1ResourceWithStreamingResponse,
     AsyncV1ResourceWithStreamingResponse,
 )
+from .chat import (
+    ChatResource,
+    AsyncChatResource,
+    ChatResourceWithRawResponse,
+    AsyncChatResourceWithRawResponse,
+    ChatResourceWithStreamingResponse,
+    AsyncChatResourceWithStreamingResponse,
+)
 from .embed import (
     EmbedResource,
     AsyncEmbedResource,
@@ -24,14 +32,6 @@ from .usage import (
     UsageResourceWithStreamingResponse,
     AsyncUsageResourceWithStreamingResponse,
 )
-from .upload import (
-    UploadResource,
-    AsyncUploadResource,
-    UploadResourceWithRawResponse,
-    AsyncUploadResourceWithRawResponse,
-    UploadResourceWithStreamingResponse,
-    AsyncUploadResourceWithStreamingResponse,
-)
 from .folders import (
     FoldersResource,
     AsyncFoldersResource,
@@ -96,18 +96,18 @@ __all__ = [
     "AsyncEmbedResourceWithRawResponse",
     "EmbedResourceWithStreamingResponse",
     "AsyncEmbedResourceWithStreamingResponse",
-    "UploadResource",
-    "AsyncUploadResource",
-    "UploadResourceWithRawResponse",
-    "AsyncUploadResourceWithRawResponse",
-    "UploadResourceWithStreamingResponse",
-    "AsyncUploadResourceWithStreamingResponse",
     "AssignmentGraderResource",
     "AsyncAssignmentGraderResource",
     "AssignmentGraderResourceWithRawResponse",
     "AsyncAssignmentGraderResourceWithRawResponse",
     "AssignmentGraderResourceWithStreamingResponse",
     "AsyncAssignmentGraderResourceWithStreamingResponse",
+    "ChatResource",
+    "AsyncChatResource",
+    "ChatResourceWithRawResponse",
+    "AsyncChatResourceWithRawResponse",
+    "ChatResourceWithStreamingResponse",
+    "AsyncChatResourceWithStreamingResponse",
     "V1Resource",
     "AsyncV1Resource",
     "V1ResourceWithRawResponse",

studyfetch_sdk-0.1.0a21/src/studyfetch_sdk/resources/v1/chat.py

@@ -0,0 +1,246 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import List
+
+import httpx
+
+from ..._types import NOT_GIVEN, Body, Query, Headers, NoneType, NotGiven
+from ..._utils import maybe_transform, strip_not_given, async_maybe_transform
+from ..._compat import cached_property
+from ...types.v1 import chat_stream_params
+from ..._resource import SyncAPIResource, AsyncAPIResource
+from ..._response import (
+    to_raw_response_wrapper,
+    to_streamed_response_wrapper,
+    async_to_raw_response_wrapper,
+    async_to_streamed_response_wrapper,
+)
+from ..._base_client import make_request_options
+
+__all__ = ["ChatResource", "AsyncChatResource"]
+
+
+class ChatResource(SyncAPIResource):
+    @cached_property
+    def with_raw_response(self) -> ChatResourceWithRawResponse:
+        """
+        This property can be used as a prefix for any HTTP method call to return
+        the raw response object instead of the parsed content.
+
+        For more information, see https://www.github.com/GoStudyFetchGo/studyfetch-sdk-python#accessing-raw-response-data-eg-headers
+        """
+        return ChatResourceWithRawResponse(self)
+
+    @cached_property
+    def with_streaming_response(self) -> ChatResourceWithStreamingResponse:
+        """
+        An alternative to `.with_raw_response` that doesn't eagerly read the response body.
+
+        For more information, see https://www.github.com/GoStudyFetchGo/studyfetch-sdk-python#with_streaming_response
+        """
+        return ChatResourceWithStreamingResponse(self)
+
+    def stream(
+        self,
+        *,
+        id: str | NotGiven = NOT_GIVEN,
+        component_id: str | NotGiven = NOT_GIVEN,
+        context: object | NotGiven = NOT_GIVEN,
+        group_ids: List[str] | NotGiven = NOT_GIVEN,
+        message: chat_stream_params.Message | NotGiven = NOT_GIVEN,
+        messages: List[str] | NotGiven = NOT_GIVEN,
+        session_id: str | NotGiven = NOT_GIVEN,
+        user_id: str | NotGiven = NOT_GIVEN,
+        x_component_id: str | NotGiven = NOT_GIVEN,
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+    ) -> None:
+        """Streams a chat response in real-time using server-sent events (SSE).
+
+        Supports
+        both AI SDK format (with messages array) and custom format (with message
+        object).
+
+        Args:
+          id: Session ID (AI SDK uses "id")
+
+          component_id: Component ID
+
+          context: Additional context
+
+          group_ids: Group IDs for access control
+
+          message: Single message for custom format - contains text and optional images
+
+          messages: Messages array for AI SDK format - list of conversation messages with roles
+
+          session_id: Session ID
+
+          user_id: User ID
+
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        extra_headers = {"Accept": "*/*", **(extra_headers or {})}
+        extra_headers = {**strip_not_given({"x-component-id": x_component_id}), **(extra_headers or {})}
+        return self._post(
+            "/api/v1/chat/stream",
+            body=maybe_transform(
+                {
+                    "id": id,
+                    "component_id": component_id,
+                    "context": context,
+                    "group_ids": group_ids,
+                    "message": message,
+                    "messages": messages,
+                    "session_id": session_id,
+                    "user_id": user_id,
+                },
+                chat_stream_params.ChatStreamParams,
+            ),
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=NoneType,
+        )
+
+
+class AsyncChatResource(AsyncAPIResource):
+    @cached_property
+    def with_raw_response(self) -> AsyncChatResourceWithRawResponse:
+        """
+        This property can be used as a prefix for any HTTP method call to return
+        the raw response object instead of the parsed content.
+
+        For more information, see https://www.github.com/GoStudyFetchGo/studyfetch-sdk-python#accessing-raw-response-data-eg-headers
+        """
+        return AsyncChatResourceWithRawResponse(self)
+
+    @cached_property
+    def with_streaming_response(self) -> AsyncChatResourceWithStreamingResponse:
+        """
+        An alternative to `.with_raw_response` that doesn't eagerly read the response body.
+
+        For more information, see https://www.github.com/GoStudyFetchGo/studyfetch-sdk-python#with_streaming_response
+        """
+        return AsyncChatResourceWithStreamingResponse(self)
+
+    async def stream(
+        self,
+        *,
+        id: str | NotGiven = NOT_GIVEN,
+        component_id: str | NotGiven = NOT_GIVEN,
+        context: object | NotGiven = NOT_GIVEN,
+        group_ids: List[str] | NotGiven = NOT_GIVEN,
+        message: chat_stream_params.Message | NotGiven = NOT_GIVEN,
+        messages: List[str] | NotGiven = NOT_GIVEN,
+        session_id: str | NotGiven = NOT_GIVEN,
+        user_id: str | NotGiven = NOT_GIVEN,
+        x_component_id: str | NotGiven = NOT_GIVEN,
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+    ) -> None:
+        """Streams a chat response in real-time using server-sent events (SSE).
+
+        Supports
+        both AI SDK format (with messages array) and custom format (with message
+        object).
+
+        Args:
+          id: Session ID (AI SDK uses "id")
+
+          component_id: Component ID
+
+          context: Additional context
+
+          group_ids: Group IDs for access control
+
+          message: Single message for custom format - contains text and optional images
+
+          messages: Messages array for AI SDK format - list of conversation messages with roles
+
+          session_id: Session ID
+
+          user_id: User ID
+
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        extra_headers = {"Accept": "*/*", **(extra_headers or {})}
+        extra_headers = {**strip_not_given({"x-component-id": x_component_id}), **(extra_headers or {})}
+        return await self._post(
+            "/api/v1/chat/stream",
+            body=await async_maybe_transform(
+                {
+                    "id": id,
+                    "component_id": component_id,
+                    "context": context,
+                    "group_ids": group_ids,
+                    "message": message,
+                    "messages": messages,
+                    "session_id": session_id,
+                    "user_id": user_id,
+                },
+                chat_stream_params.ChatStreamParams,
+            ),
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=NoneType,
+        )
+
+
+class ChatResourceWithRawResponse:
+    def __init__(self, chat: ChatResource) -> None:
+        self._chat = chat
+
+        self.stream = to_raw_response_wrapper(
+            chat.stream,
+        )
+
+
+class AsyncChatResourceWithRawResponse:
+    def __init__(self, chat: AsyncChatResource) -> None:
+        self._chat = chat
+
+        self.stream = async_to_raw_response_wrapper(
+            chat.stream,
+        )
+
+
+class ChatResourceWithStreamingResponse:
+    def __init__(self, chat: ChatResource) -> None:
+        self._chat = chat
+
+        self.stream = to_streamed_response_wrapper(
+            chat.stream,
+        )
+
+
+class AsyncChatResourceWithStreamingResponse:
+    def __init__(self, chat: AsyncChatResource) -> None:
+        self._chat = chat
+
+        self.stream = async_to_streamed_response_wrapper(
+            chat.stream,
+        )