orca-sdk 0.0.95__tar.gz → 0.0.97__tar.gz

{orca_sdk-0.0.95 → orca_sdk-0.0.97}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: orca_sdk
-Version: 0.0.95
+Version: 0.0.97
 Summary: SDK for interacting with Orca Services
 License: Apache-2.0
 Author: Orca DB Inc.
@@ -71,6 +71,23 @@ model = ClassificationModel("my_model", memoryset)
 
 # Make predictions
 prediction = model.predict("my input")
+
+# Get Action Recommendation
+action, rationale = prediction.recommend_action()
+print(f"Recommended action: {action}")
+print(f"Rationale: {rationale}")
+
+# Generate and add synthetic memory suggestions
+if action == "add_memories":
+    suggestions = prediction.generate_memory_suggestions(num_memories=3)
+
+    # Review suggestions
+    for suggestion in suggestions:
+        print(f"Suggested: '{suggestion['value']}' -> {suggestion['label']}")
+
+    # Add suggestions to memoryset
+    model.memoryset.insert(suggestions)
+    print(f"Added {len(suggestions)} new memories to improve model performance!")
 ```
 
 For a more detailed walkthrough, check out our [Quick Start Guide](https://docs.orcadb.ai/quickstart-sdk/).

{orca_sdk-0.0.95 → orca_sdk-0.0.97}/README.md

@@ -46,6 +46,23 @@ model = ClassificationModel("my_model", memoryset)
 
 # Make predictions
 prediction = model.predict("my input")
+
+# Get Action Recommendation
+action, rationale = prediction.recommend_action()
+print(f"Recommended action: {action}")
+print(f"Rationale: {rationale}")
+
+# Generate and add synthetic memory suggestions
+if action == "add_memories":
+    suggestions = prediction.generate_memory_suggestions(num_memories=3)
+
+    # Review suggestions
+    for suggestion in suggestions:
+        print(f"Suggested: '{suggestion['value']}' -> {suggestion['label']}")
+
+    # Add suggestions to memoryset
+    model.memoryset.insert(suggestions)
+    print(f"Added {len(suggestions)} new memories to improve model performance!")
 ```
 
 For a more detailed walkthrough, check out our [Quick Start Guide](https://docs.orcadb.ai/quickstart-sdk/).

{orca_sdk-0.0.95 → orca_sdk-0.0.97}/orca_sdk/__init__.py

@@ -23,11 +23,7 @@ from .memoryset import (
     ScoredMemoryset,
 )
 from .regression_model import RegressionModel
-from .telemetry import (
-    ClassificationPrediction,
-    FeedbackCategory,
-    RegressionPrediction,
-)
+from .telemetry import ClassificationPrediction, FeedbackCategory, RegressionPrediction
 
 # only specify things that should show up on the root page of the reference docs because they are in private modules
 __all__ = ["UNSET", "CreateMode", "DropMode"]

{orca_sdk-0.0.95 → orca_sdk-0.0.97}/orca_sdk/_generated_api_client/api/__init__.py

@@ -2,9 +2,12 @@
 
 from .auth.check_authentication_auth_get import sync as check_authentication
 from .auth.create_api_key_auth_api_key_post import sync as create_api_key
+from .auth.create_org_plan_auth_org_plan_post import sync as create_org_plan
 from .auth.delete_api_key_auth_api_key_name_or_id_delete import sync as delete_api_key
 from .auth.delete_org_auth_org_delete import sync as delete_org
+from .auth.get_org_plan_auth_org_plan_get import sync as get_org_plan
 from .auth.list_api_keys_auth_api_key_get import sync as list_api_keys
+from .auth.update_org_plan_auth_org_plan_put import sync as update_org_plan
 from .classification_model.create_classification_model_classification_model_post import (
     sync as create_classification_model,
 )
@@ -35,7 +38,12 @@ from .classification_model.predict_label_gpu_classification_model_name_or_id_pre
 from .classification_model.update_classification_model_classification_model_name_or_id_patch import (
     sync as update_classification_model,
 )
-from .datasource.create_datasource_datasource_post import sync as create_datasource
+from .datasource.create_datasource_from_content_datasource_post import (
+    sync as create_datasource_from_content,
+)
+from .datasource.create_datasource_from_files_datasource_upload_post import (
+    sync as create_datasource_from_files,
+)
 from .datasource.create_embedding_evaluation_datasource_name_or_id_embedding_evaluation_post import (
     sync as create_embedding_evaluation,
 )
@@ -182,6 +190,12 @@ from .telemetry.drop_feedback_category_with_data_telemetry_feedback_category_nam
 from .telemetry.explain_prediction_telemetry_prediction_prediction_id_explanation_get import (
     sync as explain_prediction,
 )
+from .telemetry.generate_memory_suggestions_telemetry_prediction_prediction_id_memory_suggestions_post import (
+    sync as generate_memory_suggestions,
+)
+from .telemetry.get_action_recommendation_telemetry_prediction_prediction_id_action_get import (
+    sync as get_action_recommendation,
+)
 from .telemetry.get_feedback_category_telemetry_feedback_category_name_or_id_get import (
     sync as get_feedback_category,
 )
@@ -213,10 +227,12 @@ __all__ = [
     "count_predictions",
     "create_api_key",
     "create_classification_model",
-    "create_datasource",
+    "create_datasource_from_content",
+    "create_datasource_from_files",
     "create_embedding_evaluation",
     "create_finetuned_embedding_model",
     "create_memoryset",
+    "create_org_plan",
     "create_regression_model",
     "delete_api_key",
     "delete_classification_model",
@@ -236,6 +252,8 @@ __all__ = [
     "evaluate_classification_model",
     "evaluate_regression_model",
     "explain_prediction",
+    "generate_memory_suggestions",
+    "get_action_recommendation",
     "get_analysis",
     "get_classification_model",
     "get_classification_model_evaluation",
@@ -246,6 +264,7 @@ __all__ = [
     "get_memories",
     "get_memory",
     "get_memoryset",
+    "get_org_plan",
     "get_prediction",
     "get_pretrained_embedding_model",
     "get_regression_model",
@@ -282,6 +301,7 @@ __all__ = [
     "update_memories_gpu",
     "update_memory_gpu",
     "update_memoryset",
+    "update_org_plan",
     "update_prediction",
     "update_regression_model",
 ]

orca_sdk-0.0.97/orca_sdk/_generated_api_client/api/auth/create_org_plan_auth_org_plan_post.py

@@ -0,0 +1,168 @@
+"""
+This file is generated by the openapi-python-client tool via the generate_api_client.py script
+
+It is a customized template from the openapi-python-client tool's default template:
+https://github.com/openapi-generators/openapi-python-client/blob/861ef5622f10fc96d240dc9becb0edf94e61446c/openapi_python_client/templates/endpoint_module.py.jinja
+
+The main changes are:
+- Update the API call responses to either return the successful response type or raise an error by:
+    - Updating the _parse_response function to raise an error if the response status code is not in the 2xx range
+- Inject a client into every method via a context manager
+"""
+
+from http import HTTPStatus
+from typing import Any, Dict
+
+import httpx
+
+from ...client import _client_context
+from ...errors import get_error_for_response
+from ...models.create_org_plan_request import CreateOrgPlanRequest
+from ...models.org_plan import OrgPlan
+from ...types import Response
+
+
+def _get_kwargs(
+    *,
+    body: CreateOrgPlanRequest,
+) -> dict[str, Any]:
+    headers: Dict[str, Any] = {}
+
+    _kwargs: dict[str, Any] = {
+        "method": "post",
+        "url": "/auth/org/plan",
+    }
+
+    _body = body.to_dict()
+
+    _kwargs["json"] = _body
+    headers["Content-Type"] = "application/json"
+
+    _kwargs["headers"] = headers
+    return _kwargs
+
+
+def _parse_response(*, response: httpx.Response) -> OrgPlan:
+    if response.status_code == 200:
+        response_200 = OrgPlan.from_dict(response.json())
+
+        return response_200
+    if response.status_code == 401:
+        raise get_error_for_response(response)
+    if response.status_code == 500:
+        raise get_error_for_response(response)
+    if response.status_code == 503:
+        raise get_error_for_response(response)
+    else:
+        raise get_error_for_response(response)
+
+
+def _build_response(*, response: httpx.Response) -> Response[OrgPlan]:
+    return Response(
+        status_code=HTTPStatus(response.status_code),
+        content=response.content,
+        headers=response.headers,
+        parsed=_parse_response(response=response),
+    )
+
+
+def sync_detailed(
+    *,
+    body: CreateOrgPlanRequest,
+) -> Response[OrgPlan]:
+    """Create Org Plan
+
+    Args:
+        body (CreateOrgPlanRequest):
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        Response[OrgPlan]
+    """
+
+    kwargs = _get_kwargs(
+        body=body,
+    )
+
+    with _client_context() as client:
+        response = client.get_httpx_client().request(
+            **kwargs,
+        )
+
+        return _build_response(response=response)
+
+
+def sync(
+    *,
+    body: CreateOrgPlanRequest,
+) -> OrgPlan:
+    """Create Org Plan
+
+    Args:
+        body (CreateOrgPlanRequest):
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        OrgPlan
+    """
+
+    return sync_detailed(
+        body=body,
+    ).parsed
+
+
+async def asyncio_detailed(
+    *,
+    body: CreateOrgPlanRequest,
+) -> Response[OrgPlan]:
+    """Create Org Plan
+
+    Args:
+        body (CreateOrgPlanRequest):
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        Response[OrgPlan]
+    """
+
+    kwargs = _get_kwargs(
+        body=body,
+    )
+
+    with _client_context() as client:
+        response = await client.get_async_httpx_client().request(**kwargs)
+
+    return _build_response(response=response)
+
+
+async def asyncio(
+    *,
+    body: CreateOrgPlanRequest,
+) -> OrgPlan:
+    """Create Org Plan
+
+    Args:
+        body (CreateOrgPlanRequest):
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        OrgPlan
+    """
+
+    return (
+        await asyncio_detailed(
+            body=body,
+        )
+    ).parsed

orca_sdk-0.0.97/orca_sdk/_generated_api_client/api/auth/get_org_plan_auth_org_plan_get.py

@@ -0,0 +1,122 @@
+"""
+This file is generated by the openapi-python-client tool via the generate_api_client.py script
+
+It is a customized template from the openapi-python-client tool's default template:
+https://github.com/openapi-generators/openapi-python-client/blob/861ef5622f10fc96d240dc9becb0edf94e61446c/openapi_python_client/templates/endpoint_module.py.jinja
+
+The main changes are:
+- Update the API call responses to either return the successful response type or raise an error by:
+    - Updating the _parse_response function to raise an error if the response status code is not in the 2xx range
+- Inject a client into every method via a context manager
+"""
+
+from http import HTTPStatus
+from typing import Any
+
+import httpx
+
+from ...client import _client_context
+from ...errors import get_error_for_response
+from ...models.org_plan import OrgPlan
+from ...types import Response
+
+
+def _get_kwargs() -> dict[str, Any]:
+    _kwargs: dict[str, Any] = {
+        "method": "get",
+        "url": "/auth/org/plan",
+    }
+
+    return _kwargs
+
+
+def _parse_response(*, response: httpx.Response) -> OrgPlan:
+    if response.status_code == 200:
+        response_200 = OrgPlan.from_dict(response.json())
+
+        return response_200
+    if response.status_code == 401:
+        raise get_error_for_response(response)
+    if response.status_code == 500:
+        raise get_error_for_response(response)
+    if response.status_code == 503:
+        raise get_error_for_response(response)
+    else:
+        raise get_error_for_response(response)
+
+
+def _build_response(*, response: httpx.Response) -> Response[OrgPlan]:
+    return Response(
+        status_code=HTTPStatus(response.status_code),
+        content=response.content,
+        headers=response.headers,
+        parsed=_parse_response(response=response),
+    )
+
+
+def sync_detailed() -> Response[OrgPlan]:
+    """Get Org Plan
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        Response[OrgPlan]
+    """
+
+    kwargs = _get_kwargs()
+
+    with _client_context() as client:
+        response = client.get_httpx_client().request(
+            **kwargs,
+        )
+
+        return _build_response(response=response)
+
+
+def sync() -> OrgPlan:
+    """Get Org Plan
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        OrgPlan
+    """
+
+    return sync_detailed().parsed
+
+
+async def asyncio_detailed() -> Response[OrgPlan]:
+    """Get Org Plan
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        Response[OrgPlan]
+    """
+
+    kwargs = _get_kwargs()
+
+    with _client_context() as client:
+        response = await client.get_async_httpx_client().request(**kwargs)
+
+    return _build_response(response=response)
+
+
+async def asyncio() -> OrgPlan:
+    """Get Org Plan
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        OrgPlan
+    """
+
+    return (await asyncio_detailed()).parsed

orca_sdk-0.0.97/orca_sdk/_generated_api_client/api/auth/update_org_plan_auth_org_plan_put.py

@@ -0,0 +1,168 @@
+"""
+This file is generated by the openapi-python-client tool via the generate_api_client.py script
+
+It is a customized template from the openapi-python-client tool's default template:
+https://github.com/openapi-generators/openapi-python-client/blob/861ef5622f10fc96d240dc9becb0edf94e61446c/openapi_python_client/templates/endpoint_module.py.jinja
+
+The main changes are:
+- Update the API call responses to either return the successful response type or raise an error by:
+    - Updating the _parse_response function to raise an error if the response status code is not in the 2xx range
+- Inject a client into every method via a context manager
+"""
+
+from http import HTTPStatus
+from typing import Any, Dict
+
+import httpx
+
+from ...client import _client_context
+from ...errors import get_error_for_response
+from ...models.org_plan import OrgPlan
+from ...models.update_org_plan_request import UpdateOrgPlanRequest
+from ...types import Response
+
+
+def _get_kwargs(
+    *,
+    body: UpdateOrgPlanRequest,
+) -> dict[str, Any]:
+    headers: Dict[str, Any] = {}
+
+    _kwargs: dict[str, Any] = {
+        "method": "put",
+        "url": "/auth/org/plan",
+    }
+
+    _body = body.to_dict()
+
+    _kwargs["json"] = _body
+    headers["Content-Type"] = "application/json"
+
+    _kwargs["headers"] = headers
+    return _kwargs
+
+
+def _parse_response(*, response: httpx.Response) -> OrgPlan:
+    if response.status_code == 200:
+        response_200 = OrgPlan.from_dict(response.json())
+
+        return response_200
+    if response.status_code == 401:
+        raise get_error_for_response(response)
+    if response.status_code == 500:
+        raise get_error_for_response(response)
+    if response.status_code == 503:
+        raise get_error_for_response(response)
+    else:
+        raise get_error_for_response(response)
+
+
+def _build_response(*, response: httpx.Response) -> Response[OrgPlan]:
+    return Response(
+        status_code=HTTPStatus(response.status_code),
+        content=response.content,
+        headers=response.headers,
+        parsed=_parse_response(response=response),
+    )
+
+
+def sync_detailed(
+    *,
+    body: UpdateOrgPlanRequest,
+) -> Response[OrgPlan]:
+    """Update Org Plan
+
+    Args:
+        body (UpdateOrgPlanRequest):
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        Response[OrgPlan]
+    """
+
+    kwargs = _get_kwargs(
+        body=body,
+    )
+
+    with _client_context() as client:
+        response = client.get_httpx_client().request(
+            **kwargs,
+        )
+
+        return _build_response(response=response)
+
+
+def sync(
+    *,
+    body: UpdateOrgPlanRequest,
+) -> OrgPlan:
+    """Update Org Plan
+
+    Args:
+        body (UpdateOrgPlanRequest):
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        OrgPlan
+    """
+
+    return sync_detailed(
+        body=body,
+    ).parsed
+
+
+async def asyncio_detailed(
+    *,
+    body: UpdateOrgPlanRequest,
+) -> Response[OrgPlan]:
+    """Update Org Plan
+
+    Args:
+        body (UpdateOrgPlanRequest):
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        Response[OrgPlan]
+    """
+
+    kwargs = _get_kwargs(
+        body=body,
+    )
+
+    with _client_context() as client:
+        response = await client.get_async_httpx_client().request(**kwargs)
+
+    return _build_response(response=response)
+
+
+async def asyncio(
+    *,
+    body: UpdateOrgPlanRequest,
+) -> OrgPlan:
+    """Update Org Plan
+
+    Args:
+        body (UpdateOrgPlanRequest):
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        OrgPlan
+    """
+
+    return (
+        await asyncio_detailed(
+            body=body,
+        )
+    ).parsed