trendsagi 0.1.1__tar.gz → 0.1.3__tar.gz

{trendsagi-0.1.1/src/trendsagi.egg-info → trendsagi-0.1.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: trendsagi
-Version: 0.1.1
+Version: 0.1.3
 Summary: The official Python client for the TrendsAGI API.
 Author-email: TrendsAGI <contact@trendsagi.com>
 License: MIT License
@@ -96,9 +96,11 @@ We strongly recommend storing your API key as an environment variable to avoid c
 export TRENDSAGI_API_KEY="your_api_key_here"
 ```
 
+
+
 ### Quickstart Example
 
-This example demonstrates how to initialize the client and fetch the latest trending topics.
+This example demonstrates how to initialize the client and fetch the latest trending topics, including new analytics fields.
 
 ```python
 import os
@@ -119,9 +121,16 @@ try:
     print("Fetching top 5 trending topics...")
     response = client.get_trends(limit=5, period='24h')
 
-    print(f"\nFound {response.meta.total} total trends. Displaying the top {len(response.trends)}:")
+    print(f"\nFound {response.meta.total} total trends. Displaying the top {len(response.trends)} with new analytics:")
     for trend in response.trends:
-        print(f"- ID: {trend.id}, Name: '{trend.name}', Volume: {trend.volume}")
+        # --- START OF MODIFICATIONS ---
+        print(f"\n- Trend: '{trend.name}' (ID: {trend.id})")
+        print(f"  - Current Volume: {trend.volume}")
+        print(f"  - Overall Trend: {trend.overall_trend}")
+        print(f"  - Avg. Velocity: {trend.average_velocity:.2f} posts/hr" if trend.average_velocity is not None else "  - Avg. Velocity: N/A")
+        print(f"  - Stability Score: {trend.trend_stability:.2f}" if trend.trend_stability is not None else "  - Stability Score: N/A")
+        # --- END OF MODIFICATIONS ---
+
 
 except exceptions.AuthenticationError:
     print("Authentication failed. Please check your API key.")
@@ -138,8 +147,6 @@ except exceptions.TrendsAGIError as e:
 Retrieve AI-generated insights for a specific trend, such as key themes, target audiences, and content ideas.
 
 ```python
-# Assuming 'client' is an initialized TrendsAGIClient
-# and you have a trend_id from a call to get_trends()
 TREND_ID = 12345 
 
 try:
@@ -163,7 +170,6 @@ except exceptions.APIError as e:
 ### Perform a Deep Analysis on a Topic
 
 ```python
-# Assuming 'client' is an initialized TrendsAGIClient
 try:
     print("\nPerforming deep analysis on 'artificial intelligence'...")
     analysis = client.perform_deep_analysis(
@@ -185,7 +191,6 @@ except exceptions.APIError as e:
 Add a user to your tracked market entities in the Intelligence Suite.
 
 ```python
-# Assuming 'client' is an initialized TrendsAGIClient
 try:
     print("\nAdding a new X user to track...")
     new_entity = client.create_tracked_x_user(
@@ -206,7 +211,6 @@ except exceptions.APIError as e:
 Retrieve any active crisis events detected by the system.
 
 ```python
-# Assuming 'client' is an initialized TrendsAGIClient
 try:
     print("\nChecking for active crisis events...")
     crisis_response = client.get_crisis_events(status='active', limit=5)

{trendsagi-0.1.1 → trendsagi-0.1.3}/README.md

@@ -56,9 +56,11 @@ We strongly recommend storing your API key as an environment variable to avoid c
 export TRENDSAGI_API_KEY="your_api_key_here"
 ```
 
+
+
 ### Quickstart Example
 
-This example demonstrates how to initialize the client and fetch the latest trending topics.
+This example demonstrates how to initialize the client and fetch the latest trending topics, including new analytics fields.
 
 ```python
 import os
@@ -79,9 +81,16 @@ try:
     print("Fetching top 5 trending topics...")
     response = client.get_trends(limit=5, period='24h')
 
-    print(f"\nFound {response.meta.total} total trends. Displaying the top {len(response.trends)}:")
+    print(f"\nFound {response.meta.total} total trends. Displaying the top {len(response.trends)} with new analytics:")
     for trend in response.trends:
-        print(f"- ID: {trend.id}, Name: '{trend.name}', Volume: {trend.volume}")
+        # --- START OF MODIFICATIONS ---
+        print(f"\n- Trend: '{trend.name}' (ID: {trend.id})")
+        print(f"  - Current Volume: {trend.volume}")
+        print(f"  - Overall Trend: {trend.overall_trend}")
+        print(f"  - Avg. Velocity: {trend.average_velocity:.2f} posts/hr" if trend.average_velocity is not None else "  - Avg. Velocity: N/A")
+        print(f"  - Stability Score: {trend.trend_stability:.2f}" if trend.trend_stability is not None else "  - Stability Score: N/A")
+        # --- END OF MODIFICATIONS ---
+
 
 except exceptions.AuthenticationError:
     print("Authentication failed. Please check your API key.")
@@ -98,8 +107,6 @@ except exceptions.TrendsAGIError as e:
 Retrieve AI-generated insights for a specific trend, such as key themes, target audiences, and content ideas.
 
 ```python
-# Assuming 'client' is an initialized TrendsAGIClient
-# and you have a trend_id from a call to get_trends()
 TREND_ID = 12345 
 
 try:
@@ -123,7 +130,6 @@ except exceptions.APIError as e:
 ### Perform a Deep Analysis on a Topic
 
 ```python
-# Assuming 'client' is an initialized TrendsAGIClient
 try:
     print("\nPerforming deep analysis on 'artificial intelligence'...")
     analysis = client.perform_deep_analysis(
@@ -145,7 +151,6 @@ except exceptions.APIError as e:
 Add a user to your tracked market entities in the Intelligence Suite.
 
 ```python
-# Assuming 'client' is an initialized TrendsAGIClient
 try:
     print("\nAdding a new X user to track...")
     new_entity = client.create_tracked_x_user(
@@ -166,7 +171,6 @@ except exceptions.APIError as e:
 Retrieve any active crisis events detected by the system.
 
 ```python
-# Assuming 'client' is an initialized TrendsAGIClient
 try:
     print("\nChecking for active crisis events...")
     crisis_response = client.get_crisis_events(status='active', limit=5)

{trendsagi-0.1.1 → trendsagi-0.1.3}/pyproject.toml

@@ -6,7 +6,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "trendsagi"
-version = "0.1.1"
+version = "0.1.3"
 authors = [
   { name="TrendsAGI", email="contact@trendsagi.com" },
 ]

{trendsagi-0.1.1 → trendsagi-0.1.3}/src/trendsagi/client.py

@@ -57,6 +57,9 @@ class TrendsAGIClient:
 
     # --- Trends & Insights Methods ---
 
+    # --- START OF FIX ---
+    # Added start_date and end_date to the function signature.
+    # The `locals()` trick will automatically pick them up and add them to params if they are not None.
     def get_trends(
         self,
         search: Optional[str] = None,
@@ -65,8 +68,11 @@ class TrendsAGIClient:
         limit: int = 20,
         offset: int = 0,
         period: str = '24h',
-        category: Optional[str] = None
+        category: Optional[str] = None,
+        start_date: Optional[str] = None,
+        end_date: Optional[str] = None
     ) -> models.TrendListResponse:
+    # --- END OF FIX ---
         """
         Retrieve a list of currently trending topics.
         """
@@ -140,7 +146,7 @@ class TrendsAGIClient:
         source_trend_query: Optional[str] = None, priority: Optional[str] = None, status: str = 'new'
     ) -> models.RecommendationListResponse:
         """
-        Get actionable recommendations generated for the user.
+        Get actionable recommendations generated for the.
         """
         params = {
             "limit": limit, "offset": offset, "type": recommendation_type, 

{trendsagi-0.1.1 → trendsagi-0.1.3}/src/trendsagi/models.py

@@ -18,6 +18,8 @@ class PaginationMeta(OrmBaseModel):
     order: Optional[str] = None
     search: Optional[str] = None
     category: Optional[str] = None
+    start_date: Optional[date] = None
+    end_date: Optional[date] = None
 
 # --- Trends & Insights Models ---
 class TrendItem(OrmBaseModel):
@@ -30,6 +32,9 @@ class TrendItem(OrmBaseModel):
     growth: Optional[float] = None
     previous_volume: Optional[int] = None
     absolute_change: Optional[int] = None
+    average_velocity: Optional[float] = Field(None, description="Average velocity (posts/hour) over recent snapshots.")
+    trend_stability: Optional[float] = Field(None, description="Standard deviation of volume over recent snapshots. Lower is more stable.")
+    overall_trend: Optional[str] = Field(None, description="Qualitative assessment of the trend's direction (growing, declining, stable).")
 
 class TrendListResponse(OrmBaseModel):
     trends: List[TrendItem]
@@ -54,7 +59,7 @@ class TrendDetail(TrendItem):
 class TrendDataPoint(OrmBaseModel):
     date: datetime
     volume: Optional[int] = None
-    growth_rate: Optional[float] = None
+    velocity_per_hour: Optional[float] = None # Corrected from growth_rate to match API docs
 
 class TrendAnalytics(OrmBaseModel):
     trend_id: int
@@ -107,6 +112,8 @@ class ReportMeta(OrmBaseModel):
     time_period: str
     start_date: Optional[str] = None
     end_date: Optional[str] = None
+    usage_count: Optional[int] = None
+    usage_limit: Optional[int] = None
 
 class CustomReport(OrmBaseModel):
     columns: List[str]
@@ -175,33 +182,36 @@ class CrisisEventListResponse(OrmBaseModel):
     events: List[CrisisEvent]
     meta: PaginationMeta
 
-class DeepAnalysisSentiment(OrmBaseModel):
-    overall_sentiment_category: str
-    positive_nuances: List[str]
-    negative_nuances: List[str]
-    neutral_aspects: List[str]
-
-class DeepAnalysisActionableInsights(OrmBaseModel):
-    marketing_pr: List[str]
-    product_development: List[str]
-    crm_strategy: List[str]
-    
 class DeepAnalysisRelatedTrend(OrmBaseModel):
     id: str
     name: str
 
+# --- START OF FINAL FIX ---
+# This model is updated to be a flat structure, removing the nested sub-models.
+# It now directly matches the simplified dictionary being sent by the server.
 class DeepAnalysis(OrmBaseModel):
     query_analyzed: str
     generated_at: datetime
     llm_model_used: str
-    overall_summary: str
-    key_findings: List[str]
-    sentiment_analysis: DeepAnalysisSentiment
-    causal_factors: List[str]
-    emerging_sub_topics: List[str]
-    future_outlook_and_predictions: List[str]
-    actionable_insights_for_roles: DeepAnalysisActionableInsights
-    related_trends: List[DeepAnalysisRelatedTrend]
+    
+    # These fields are now simple types, not nested models.
+    executive_summary_and_key_findings: Dict[str, Any]
+    nuanced_sentiment_analysis: Dict[str, Any]
+    market_drivers_and_causal_factors: List[str]
+    identified_risks_and_mitigation: List[Dict[str, Any]]
+    actionable_strategic_recommendations: Dict[str, Any]
+
+    # The following fields were missing from the client model but are present in the server response.
+    # Add them here to prevent validation errors.
+    overall_summary: Optional[str] = None
+    key_findings: Optional[List[str]] = None
+    sentiment_analysis: Optional[Dict[str, Any]] = None
+    causal_factors: Optional[List[str]] = None
+    emerging_sub_topics: Optional[List[str]] = None
+    future_outlook_and_predictions: Optional[List[str]] = None
+    actionable_insights_for_roles: Optional[Dict[str, Any]] = None
+    related_trends: Optional[List[DeepAnalysisRelatedTrend]] = None
+# --- END OF FINAL FIX ---
 
 # --- User & Account Management Models ---
 class TopicInterest(OrmBaseModel):
@@ -268,14 +278,13 @@ class SubscriptionPlan(OrmBaseModel):
 class ComponentStatus(OrmBaseModel):
     name: str
     status: str
-    description: str
+    # description: str # This field was in the server schema but not the client; remove or add as needed.
 
 class StatusPage(OrmBaseModel):
     overall_status: str
     last_updated: datetime
     components: List[ComponentStatus]
 
-# NEW: Model for API Status History
 class StatusHistoryResponse(OrmBaseModel):
     uptime_percentages: Dict[str, float]
     daily_statuses: Dict[str, Dict[str, str]]

{trendsagi-0.1.1 → trendsagi-0.1.3/src/trendsagi.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: trendsagi
-Version: 0.1.1
+Version: 0.1.3
 Summary: The official Python client for the TrendsAGI API.
 Author-email: TrendsAGI <contact@trendsagi.com>
 License: MIT License
@@ -96,9 +96,11 @@ We strongly recommend storing your API key as an environment variable to avoid c
 export TRENDSAGI_API_KEY="your_api_key_here"
 ```
 
+
+
 ### Quickstart Example
 
-This example demonstrates how to initialize the client and fetch the latest trending topics.
+This example demonstrates how to initialize the client and fetch the latest trending topics, including new analytics fields.
 
 ```python
 import os
@@ -119,9 +121,16 @@ try:
     print("Fetching top 5 trending topics...")
     response = client.get_trends(limit=5, period='24h')
 
-    print(f"\nFound {response.meta.total} total trends. Displaying the top {len(response.trends)}:")
+    print(f"\nFound {response.meta.total} total trends. Displaying the top {len(response.trends)} with new analytics:")
     for trend in response.trends:
-        print(f"- ID: {trend.id}, Name: '{trend.name}', Volume: {trend.volume}")
+        # --- START OF MODIFICATIONS ---
+        print(f"\n- Trend: '{trend.name}' (ID: {trend.id})")
+        print(f"  - Current Volume: {trend.volume}")
+        print(f"  - Overall Trend: {trend.overall_trend}")
+        print(f"  - Avg. Velocity: {trend.average_velocity:.2f} posts/hr" if trend.average_velocity is not None else "  - Avg. Velocity: N/A")
+        print(f"  - Stability Score: {trend.trend_stability:.2f}" if trend.trend_stability is not None else "  - Stability Score: N/A")
+        # --- END OF MODIFICATIONS ---
+
 
 except exceptions.AuthenticationError:
     print("Authentication failed. Please check your API key.")
@@ -138,8 +147,6 @@ except exceptions.TrendsAGIError as e:
 Retrieve AI-generated insights for a specific trend, such as key themes, target audiences, and content ideas.
 
 ```python
-# Assuming 'client' is an initialized TrendsAGIClient
-# and you have a trend_id from a call to get_trends()
 TREND_ID = 12345 
 
 try:
@@ -163,7 +170,6 @@ except exceptions.APIError as e:
 ### Perform a Deep Analysis on a Topic
 
 ```python
-# Assuming 'client' is an initialized TrendsAGIClient
 try:
     print("\nPerforming deep analysis on 'artificial intelligence'...")
     analysis = client.perform_deep_analysis(
@@ -185,7 +191,6 @@ except exceptions.APIError as e:
 Add a user to your tracked market entities in the Intelligence Suite.
 
 ```python
-# Assuming 'client' is an initialized TrendsAGIClient
 try:
     print("\nAdding a new X user to track...")
     new_entity = client.create_tracked_x_user(
@@ -206,7 +211,6 @@ except exceptions.APIError as e:
 Retrieve any active crisis events detected by the system.
 
 ```python
-# Assuming 'client' is an initialized TrendsAGIClient
 try:
     print("\nChecking for active crisis events...")
     crisis_response = client.get_crisis_events(status='active', limit=5)