profound 0.6.0__tar.gz → 0.8.0__tar.gz

profound-0.8.0/.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+  ".": "0.8.0"
+}

{profound-0.6.0 → profound-0.8.0}/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## 0.8.0 (2025-10-28)
+
+Full Changelog: [v0.7.0...v0.8.0](https://github.com/cooper-square-technologies/profound-python-sdk/compare/v0.7.0...v0.8.0)
+
+### Features
+
+* **api:** api update ([7958299](https://github.com/cooper-square-technologies/profound-python-sdk/commit/7958299a1156ad45de08e406fd0d520c32dac51c))
+
+## 0.7.0 (2025-10-27)
+
+Full Changelog: [v0.6.0...v0.7.0](https://github.com/cooper-square-technologies/profound-python-sdk/compare/v0.6.0...v0.7.0)
+
+### Features
+
+* **api:** api update ([375f64d](https://github.com/cooper-square-technologies/profound-python-sdk/commit/375f64db88b85ce558e5132e00067af6bdc4ff1f))
+
 ## 0.6.0 (2025-10-21)
 
 Full Changelog: [v0.5.0...v0.6.0](https://github.com/cooper-square-technologies/profound-python-sdk/compare/v0.5.0...v0.6.0)

{profound-0.6.0 → profound-0.8.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: profound
-Version: 0.6.0
+Version: 0.8.0
 Summary: The official Python library for the profound API
 Project-URL: Homepage, https://github.com/cooper-square-technologies/profound-python-sdk
 Project-URL: Repository, https://github.com/cooper-square-technologies/profound-python-sdk

{profound-0.6.0 → profound-0.8.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "profound"
-version = "0.6.0"
+version = "0.8.0"
 description = "The official Python library for the profound API"
 dynamic = ["readme"]
 license = "Apache-2.0"

{profound-0.6.0 → profound-0.8.0}/src/profound/_version.py

@@ -1,4 +1,4 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 __title__ = "profound"
-__version__ = "0.6.0"  # x-release-please-version
+__version__ = "0.8.0"  # x-release-please-version

{profound-0.6.0 → profound-0.8.0}/src/profound/resources/logs/raw.py

@@ -96,8 +96,7 @@ class RawResource(SyncAPIResource):
           end_date: End date for logs. Accepts same formats as start_date. Defaults to now if
               omitted.
 
-          filters: List of filters to apply to the report. Each filter has an operator, field, and
-              value.
+          filters: List of filters to apply to the bots logs query.
 
           order_by: Custom ordering of the report results.
 
@@ -195,8 +194,7 @@ class RawResource(SyncAPIResource):
           end_date: End date for logs. Accepts same formats as start_date. Defaults to now if
               omitted.
 
-          filters: List of filters to apply to the report. Each filter has an operator, field, and
-              value.
+          filters: Filters to apply to the logs query.
 
           order_by: Custom ordering of the report results.
 
@@ -314,8 +312,7 @@ class AsyncRawResource(AsyncAPIResource):
           end_date: End date for logs. Accepts same formats as start_date. Defaults to now if
               omitted.
 
-          filters: List of filters to apply to the report. Each filter has an operator, field, and
-              value.
+          filters: List of filters to apply to the bots logs query.
 
           order_by: Custom ordering of the report results.
 
@@ -413,8 +410,7 @@ class AsyncRawResource(AsyncAPIResource):
           end_date: End date for logs. Accepts same formats as start_date. Defaults to now if
               omitted.
 
-          filters: List of filters to apply to the report. Each filter has an operator, field, and
-              value.
+          filters: Filters to apply to the logs query.
 
           order_by: Custom ordering of the report results.
 

{profound-0.6.0 → profound-0.8.0}/src/profound/resources/prompts.py

@@ -65,6 +65,8 @@ class PromptsResource(SyncAPIResource):
         Get the answers for the prompts.
 
         Args:
+          filters: List of filters to apply to the answers report.
+
           pagination: Pagination parameters for the results. Default is 10,000 rows with no offset.
 
           extra_headers: Send extra headers
@@ -135,6 +137,8 @@ class AsyncPromptsResource(AsyncAPIResource):
         Get the answers for the prompts.
 
         Args:
+          filters: List of filters to apply to the answers report.
+
           pagination: Pagination parameters for the results. Default is 10,000 rows with no offset.
 
           extra_headers: Send extra headers

{profound-0.6.0 → profound-0.8.0}/src/profound/resources/reports.py

@@ -84,8 +84,7 @@ class ReportsResource(SyncAPIResource):
 
           dimensions: Dimensions to group the report by.
 
-          filters: List of filters to apply to the report. Each filter has an operator, field, and
-              value.
+          filters: List of filters to apply to the citations report.
 
           order_by: Custom ordering of the report results.
 
@@ -135,10 +134,12 @@ class ReportsResource(SyncAPIResource):
         *,
         category_id: str,
         end_date: Union[str, datetime],
-        metrics: List[Literal["positive", "negative"]],
+        metrics: List[Literal["positive", "negative", "ocurrences"]],
         start_date: Union[str, datetime],
         date_interval: Literal["day", "week", "month", "year"] | Omit = omit,
-        dimensions: List[Literal["theme", "date", "region", "topic", "model", "asset_name", "tag", "prompt"]]
+        dimensions: List[
+            Literal["theme", "date", "region", "topic", "model", "asset_name", "tag", "prompt", "sentiment_type"]
+        ]
         | Omit = omit,
         filters: Iterable[report_sentiment_params.Filter] | Omit = omit,
         order_by: Dict[str, Literal["asc", "desc"]] | Omit = omit,
@@ -165,8 +166,7 @@ class ReportsResource(SyncAPIResource):
 
           dimensions: Dimensions to group the report by.
 
-          filters: List of filters to apply to the report. Each filter has an operator, field, and
-              value.
+          filters: List of filters to apply to the sentiment report.
 
           order_by: Custom ordering of the report results.
 
@@ -245,8 +245,7 @@ class ReportsResource(SyncAPIResource):
 
           dimensions: Dimensions to group the report by.
 
-          filters: List of filters to apply to the report. Each filter has an operator, field, and
-              value.
+          filters: List of filters to apply to the visibility report.
 
           order_by: Custom ordering of the report results.
 
@@ -349,8 +348,7 @@ class AsyncReportsResource(AsyncAPIResource):
 
           dimensions: Dimensions to group the report by.
 
-          filters: List of filters to apply to the report. Each filter has an operator, field, and
-              value.
+          filters: List of filters to apply to the citations report.
 
           order_by: Custom ordering of the report results.
 
@@ -400,10 +398,12 @@ class AsyncReportsResource(AsyncAPIResource):
         *,
         category_id: str,
         end_date: Union[str, datetime],
-        metrics: List[Literal["positive", "negative"]],
+        metrics: List[Literal["positive", "negative", "ocurrences"]],
         start_date: Union[str, datetime],
         date_interval: Literal["day", "week", "month", "year"] | Omit = omit,
-        dimensions: List[Literal["theme", "date", "region", "topic", "model", "asset_name", "tag", "prompt"]]
+        dimensions: List[
+            Literal["theme", "date", "region", "topic", "model", "asset_name", "tag", "prompt", "sentiment_type"]
+        ]
         | Omit = omit,
         filters: Iterable[report_sentiment_params.Filter] | Omit = omit,
         order_by: Dict[str, Literal["asc", "desc"]] | Omit = omit,
@@ -430,8 +430,7 @@ class AsyncReportsResource(AsyncAPIResource):
 
           dimensions: Dimensions to group the report by.
 
-          filters: List of filters to apply to the report. Each filter has an operator, field, and
-              value.
+          filters: List of filters to apply to the sentiment report.
 
           order_by: Custom ordering of the report results.
 
@@ -510,8 +509,7 @@ class AsyncReportsResource(AsyncAPIResource):
 
           dimensions: Dimensions to group the report by.
 
-          filters: List of filters to apply to the report. Each filter has an operator, field, and
-              value.
+          filters: List of filters to apply to the visibility report.
 
           order_by: Custom ordering of the report results.
 

profound-0.8.0/src/profound/types/logs/raw_bots_params.py

@@ -0,0 +1,288 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import Dict, List, Union, Iterable
+from datetime import datetime
+from typing_extensions import Literal, Required, Annotated, TypeAlias, TypedDict
+
+from ..._types import SequenceNotStr
+from ..._utils import PropertyInfo
+from ..shared_params.pagination import Pagination
+
+__all__ = [
+    "RawBotsParams",
+    "Filter",
+    "FilterBotNameFilter",
+    "FilterBotProviderFilter",
+    "FilterBotTypesFilter",
+    "FilterMethodFilter",
+    "FilterAppModelsAgentAnalyticsFiltersPathFilter",
+    "FilterStatusCodeFilter",
+    "FilterIPFilter",
+    "FilterUserAgentFilter",
+    "FilterRefererFilter",
+    "FilterQueryParamsFilter",
+]
+
+
+class RawBotsParams(TypedDict, total=False):
+    domain: Required[str]
+    """Domain to query logs for."""
+
+    metrics: Required[List[Literal["count"]]]
+
+    start_date: Required[Annotated[Union[str, datetime], PropertyInfo(format="iso8601")]]
+    """Start date for logs.
+
+    Accepts: YYYY-MM-DD, YYYY-MM-DD HH:MM, YYYY-MM-DD HH:MM:SS, or full ISO
+    timestamp.
+    """
+
+    date_interval: Literal["day", "week", "month", "year"]
+    """Date interval for the report. (only used with date dimension)"""
+
+    dimensions: List[
+        Literal[
+            "method",
+            "path",
+            "status_code",
+            "ip",
+            "user_agent",
+            "referer",
+            "query_params",
+            "bot_name",
+            "bot_provider",
+            "bot_types",
+        ]
+    ]
+    """Dimensions to group the report by."""
+
+    end_date: Annotated[Union[str, datetime], PropertyInfo(format="iso8601")]
+    """End date for logs.
+
+    Accepts same formats as start_date. Defaults to now if omitted.
+    """
+
+    filters: Iterable[Filter]
+    """List of filters to apply to the bots logs query."""
+
+    order_by: Dict[str, Literal["asc", "desc"]]
+    """Custom ordering of the report results.
+
+    The order is a record of key-value pairs where:
+
+    - key is the field to order by, which can be a metric or dimension
+    - value is the direction of the order, either 'asc' for ascending or 'desc' for
+      descending.
+
+    When not specified, the default order is the first metric in the query
+    descending.
+    """
+
+    pagination: Pagination
+    """Pagination settings for the report results."""
+
+
+class FilterBotNameFilter(TypedDict, total=False):
+    field: Required[Literal["bot_name"]]
+
+    operator: Required[
+        Literal[
+            "is",
+            "not_is",
+            "in",
+            "not_in",
+            "contains",
+            "not_contains",
+            "matches",
+            "contains_case_insensitive",
+            "not_contains_case_insensitive",
+        ]
+    ]
+
+    value: Required[Union[str, SequenceNotStr[str]]]
+
+
+class FilterBotProviderFilter(TypedDict, total=False):
+    field: Required[Literal["bot_provider"]]
+
+    operator: Required[
+        Literal[
+            "is",
+            "not_is",
+            "in",
+            "not_in",
+            "contains",
+            "not_contains",
+            "matches",
+            "contains_case_insensitive",
+            "not_contains_case_insensitive",
+        ]
+    ]
+
+    value: Required[Union[str, SequenceNotStr[str]]]
+
+
+class FilterBotTypesFilter(TypedDict, total=False):
+    field: Required[Literal["bot_types"]]
+
+    operator: Required[
+        Literal[
+            "is",
+            "not_is",
+            "in",
+            "not_in",
+            "contains",
+            "not_contains",
+            "matches",
+            "contains_case_insensitive",
+            "not_contains_case_insensitive",
+        ]
+    ]
+
+    value: Required[
+        Union[Literal["ai_assistant", "ai_training", "index"], List[Literal["ai_assistant", "ai_training", "index"]]]
+    ]
+
+
+class FilterMethodFilter(TypedDict, total=False):
+    field: Required[Literal["method"]]
+
+    operator: Required[
+        Literal[
+            "is",
+            "not_is",
+            "in",
+            "not_in",
+            "contains",
+            "not_contains",
+            "matches",
+            "contains_case_insensitive",
+            "not_contains_case_insensitive",
+        ]
+    ]
+
+    value: Required[Union[str, SequenceNotStr[str]]]
+
+
+class FilterAppModelsAgentAnalyticsFiltersPathFilter(TypedDict, total=False):
+    field: Required[Literal["path"]]
+
+    operator: Required[
+        Literal[
+            "is",
+            "not_is",
+            "in",
+            "not_in",
+            "contains",
+            "not_contains",
+            "matches",
+            "contains_case_insensitive",
+            "not_contains_case_insensitive",
+        ]
+    ]
+
+    value: Required[Union[str, SequenceNotStr[str]]]
+
+
+class FilterStatusCodeFilter(TypedDict, total=False):
+    field: Required[Literal["status_code"]]
+
+    operator: Required[Literal["is", "not_is", "in", "not_in"]]
+
+    value: Required[Union[int, Iterable[int]]]
+
+
+class FilterIPFilter(TypedDict, total=False):
+    field: Required[Literal["ip"]]
+
+    operator: Required[
+        Literal[
+            "is",
+            "not_is",
+            "in",
+            "not_in",
+            "contains",
+            "not_contains",
+            "matches",
+            "contains_case_insensitive",
+            "not_contains_case_insensitive",
+        ]
+    ]
+
+    value: Required[Union[str, SequenceNotStr[str]]]
+
+
+class FilterUserAgentFilter(TypedDict, total=False):
+    field: Required[Literal["user_agent"]]
+
+    operator: Required[
+        Literal[
+            "is",
+            "not_is",
+            "in",
+            "not_in",
+            "contains",
+            "not_contains",
+            "matches",
+            "contains_case_insensitive",
+            "not_contains_case_insensitive",
+        ]
+    ]
+
+    value: Required[Union[str, SequenceNotStr[str]]]
+
+
+class FilterRefererFilter(TypedDict, total=False):
+    field: Required[Literal["referer"]]
+
+    operator: Required[
+        Literal[
+            "is",
+            "not_is",
+            "in",
+            "not_in",
+            "contains",
+            "not_contains",
+            "matches",
+            "contains_case_insensitive",
+            "not_contains_case_insensitive",
+        ]
+    ]
+
+    value: Required[Union[str, SequenceNotStr[str]]]
+
+
+class FilterQueryParamsFilter(TypedDict, total=False):
+    field: Required[Literal["query_params"]]
+
+    operator: Required[
+        Literal[
+            "is",
+            "not_is",
+            "in",
+            "not_in",
+            "contains",
+            "not_contains",
+            "matches",
+            "contains_case_insensitive",
+            "not_contains_case_insensitive",
+        ]
+    ]
+
+    value: Required[Union[str, SequenceNotStr[str]]]
+
+
+Filter: TypeAlias = Union[
+    FilterBotNameFilter,
+    FilterBotProviderFilter,
+    FilterBotTypesFilter,
+    FilterMethodFilter,
+    FilterAppModelsAgentAnalyticsFiltersPathFilter,
+    FilterStatusCodeFilter,
+    FilterIPFilter,
+    FilterUserAgentFilter,
+    FilterRefererFilter,
+    FilterQueryParamsFilter,
+]