studyfetch-sdk 0.1.0a20__py3-none-any.whl → 0.1.0a21__py3-none-any.whl

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/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/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,
+        )

studyfetch_sdk/resources/v1/materials/materials.py

@@ -3,6 +3,7 @@
 from __future__ import annotations
 
 from typing import List, Iterable, Optional
+from typing_extensions import Literal
 
 import httpx
 
@@ -39,9 +40,11 @@ from ....types.v1 import (
     material_create_params,
     material_rename_params,
     material_search_params,
+    material_generate_params,
     material_batch_create_params,
     material_get_download_url_params,
     material_create_and_process_params,
+    material_generate_and_process_params,
 )
 from ...._resource import SyncAPIResource, AsyncAPIResource
 from ...._response import (
@@ -53,6 +56,7 @@ from ...._response import (
 from ...._base_client import make_request_options
 from ....types.v1.material import Material
 from ....types.v1.content_param import ContentParam
+from ....types.v1.generated_material import GeneratedMaterial
 from ....types.v1.material_list_response import MaterialListResponse
 from ....types.v1.material_debug_response import MaterialDebugResponse
 from ....types.v1.material_search_response import MaterialSearchResponse
@@ -369,6 +373,144 @@ class MaterialsResource(SyncAPIResource):
             cast_to=MaterialDebugResponse,
         )
 
+    def generate(
+        self,
+        *,
+        name: str,
+        topic: str,
+        type: Literal["outline", "overview", "notes", "summary"],
+        context: str | NotGiven = NOT_GIVEN,
+        folder_id: str | NotGiven = NOT_GIVEN,
+        length: Literal["short", "medium", "long"] | NotGiven = NOT_GIVEN,
+        level: Literal["high_school", "college", "professional"] | 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,
+    ) -> GeneratedMaterial:
+        """Uses AI to generate study materials like outlines, notes, summaries, etc.
+
+        from a
+        given topic. Returns immediately without waiting for processing.
+
+        Args:
+          name: Name for the generated material
+
+          topic: Topic or context to generate material from
+
+          type: Type of material to generate
+
+          context: Additional context or details about the topic
+
+          folder_id: Target folder ID
+
+          length: Length of the generated content
+
+          level: Target education level
+
+          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
+        """
+        return self._post(
+            "/api/v1/materials/generate",
+            body=maybe_transform(
+                {
+                    "name": name,
+                    "topic": topic,
+                    "type": type,
+                    "context": context,
+                    "folder_id": folder_id,
+                    "length": length,
+                    "level": level,
+                },
+                material_generate_params.MaterialGenerateParams,
+            ),
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=GeneratedMaterial,
+        )
+
+    def generate_and_process(
+        self,
+        *,
+        name: str,
+        topic: str,
+        type: Literal["outline", "overview", "notes", "summary"],
+        context: str | NotGiven = NOT_GIVEN,
+        folder_id: str | NotGiven = NOT_GIVEN,
+        length: Literal["short", "medium", "long"] | NotGiven = NOT_GIVEN,
+        level: Literal["high_school", "college", "professional"] | NotGiven = NOT_GIVEN,
+        poll_interval_ms: float | NotGiven = NOT_GIVEN,
+        timeout_ms: float | 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,
+    ) -> GeneratedMaterial:
+        """Uses AI to generate study materials like outlines, notes, summaries, etc.
+
+        from a
+        given topic and waits for processing to complete
+
+        Args:
+          name: Name for the generated material
+
+          topic: Topic or context to generate material from
+
+          type: Type of material to generate
+
+          context: Additional context or details about the topic
+
+          folder_id: Target folder ID
+
+          length: Length of the generated content
+
+          level: Target education level
+
+          poll_interval_ms: Polling interval in milliseconds (default: 2 seconds)
+
+          timeout_ms: Maximum time to wait for processing in milliseconds (default: 5 minutes)
+
+          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
+        """
+        return self._post(
+            "/api/v1/materials/generate-and-process",
+            body=maybe_transform(
+                {
+                    "name": name,
+                    "topic": topic,
+                    "type": type,
+                    "context": context,
+                    "folder_id": folder_id,
+                    "length": length,
+                    "level": level,
+                    "poll_interval_ms": poll_interval_ms,
+                    "timeout_ms": timeout_ms,
+                },
+                material_generate_and_process_params.MaterialGenerateAndProcessParams,
+            ),
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=GeneratedMaterial,
+        )
+
     def get_download_url(
         self,
         id: str,
@@ -879,6 +1021,144 @@ class AsyncMaterialsResource(AsyncAPIResource):
             cast_to=MaterialDebugResponse,
         )
 
+    async def generate(
+        self,
+        *,
+        name: str,
+        topic: str,
+        type: Literal["outline", "overview", "notes", "summary"],
+        context: str | NotGiven = NOT_GIVEN,
+        folder_id: str | NotGiven = NOT_GIVEN,
+        length: Literal["short", "medium", "long"] | NotGiven = NOT_GIVEN,
+        level: Literal["high_school", "college", "professional"] | 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,
+    ) -> GeneratedMaterial:
+        """Uses AI to generate study materials like outlines, notes, summaries, etc.
+
+        from a
+        given topic. Returns immediately without waiting for processing.
+
+        Args:
+          name: Name for the generated material
+
+          topic: Topic or context to generate material from
+
+          type: Type of material to generate
+
+          context: Additional context or details about the topic
+
+          folder_id: Target folder ID
+
+          length: Length of the generated content
+
+          level: Target education level
+
+          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
+        """
+        return await self._post(
+            "/api/v1/materials/generate",
+            body=await async_maybe_transform(
+                {
+                    "name": name,
+                    "topic": topic,
+                    "type": type,
+                    "context": context,
+                    "folder_id": folder_id,
+                    "length": length,
+                    "level": level,
+                },
+                material_generate_params.MaterialGenerateParams,
+            ),
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=GeneratedMaterial,
+        )
+
+    async def generate_and_process(
+        self,
+        *,
+        name: str,
+        topic: str,
+        type: Literal["outline", "overview", "notes", "summary"],
+        context: str | NotGiven = NOT_GIVEN,
+        folder_id: str | NotGiven = NOT_GIVEN,
+        length: Literal["short", "medium", "long"] | NotGiven = NOT_GIVEN,
+        level: Literal["high_school", "college", "professional"] | NotGiven = NOT_GIVEN,
+        poll_interval_ms: float | NotGiven = NOT_GIVEN,
+        timeout_ms: float | 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,
+    ) -> GeneratedMaterial:
+        """Uses AI to generate study materials like outlines, notes, summaries, etc.
+
+        from a
+        given topic and waits for processing to complete
+
+        Args:
+          name: Name for the generated material
+
+          topic: Topic or context to generate material from
+
+          type: Type of material to generate
+
+          context: Additional context or details about the topic
+
+          folder_id: Target folder ID
+
+          length: Length of the generated content
+
+          level: Target education level
+
+          poll_interval_ms: Polling interval in milliseconds (default: 2 seconds)
+
+          timeout_ms: Maximum time to wait for processing in milliseconds (default: 5 minutes)
+
+          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
+        """
+        return await self._post(
+            "/api/v1/materials/generate-and-process",
+            body=await async_maybe_transform(
+                {
+                    "name": name,
+                    "topic": topic,
+                    "type": type,
+                    "context": context,
+                    "folder_id": folder_id,
+                    "length": length,
+                    "level": level,
+                    "poll_interval_ms": poll_interval_ms,
+                    "timeout_ms": timeout_ms,
+                },
+                material_generate_and_process_params.MaterialGenerateAndProcessParams,
+            ),
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=GeneratedMaterial,
+        )
+
     async def get_download_url(
         self,
         id: str,
@@ -1105,6 +1385,12 @@ class MaterialsResourceWithRawResponse:
         self.debug = to_raw_response_wrapper(
             materials.debug,
         )
+        self.generate = to_raw_response_wrapper(
+            materials.generate,
+        )
+        self.generate_and_process = to_raw_response_wrapper(
+            materials.generate_and_process,
+        )
         self.get_download_url = to_raw_response_wrapper(
             materials.get_download_url,
         )
@@ -1159,6 +1445,12 @@ class AsyncMaterialsResourceWithRawResponse:
         self.debug = async_to_raw_response_wrapper(
             materials.debug,
         )
+        self.generate = async_to_raw_response_wrapper(
+            materials.generate,
+        )
+        self.generate_and_process = async_to_raw_response_wrapper(
+            materials.generate_and_process,
+        )
         self.get_download_url = async_to_raw_response_wrapper(
             materials.get_download_url,
         )
@@ -1213,6 +1505,12 @@ class MaterialsResourceWithStreamingResponse:
         self.debug = to_streamed_response_wrapper(
             materials.debug,
         )
+        self.generate = to_streamed_response_wrapper(
+            materials.generate,
+        )
+        self.generate_and_process = to_streamed_response_wrapper(
+            materials.generate_and_process,
+        )
         self.get_download_url = to_streamed_response_wrapper(
             materials.get_download_url,
         )
@@ -1267,6 +1565,12 @@ class AsyncMaterialsResourceWithStreamingResponse:
         self.debug = async_to_streamed_response_wrapper(
             materials.debug,
         )
+        self.generate = async_to_streamed_response_wrapper(
+            materials.generate,
+        )
+        self.generate_and_process = async_to_streamed_response_wrapper(
+            materials.generate_and_process,
+        )
         self.get_download_url = async_to_streamed_response_wrapper(
             materials.get_download_url,
         )