discovery-engine-api 0.2.89__tar.gz → 0.2.90__tar.gz

{discovery_engine_api-0.2.89 → discovery_engine_api-0.2.90}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: discovery-engine-api
-Version: 0.2.89
+Version: 0.2.90
 Summary: Python SDK for Disco API
 Project-URL: Homepage, https://www.leap-labs.com
 Project-URL: Documentation, https://disco.leap-labs.com/llms-full.txt
@@ -78,7 +78,7 @@ Get your API key from the [Developers page](https://disco.leap-labs.com/develope
 await engine.discover(
     file: str | Path | pd.DataFrame,  # Dataset to analyze
     target_column: str,                 # Column to predict/analyze
-    depth_iterations: int = 2,          # 1=fast, higher=deeper search
+    analysis_depth: int = 2,          # 1=fast, higher=deeper search
     visibility: str = "public",         # "public" (free) or "private" (credits)
     title: str | None = None,           # Dataset title
     description: str | None = None,     # Dataset description
@@ -214,14 +214,14 @@ print(f"Explore: {result.report_url}")
 
 - **Public runs**: Free. Results published to public gallery.
 - **Private runs**: 1 credit per MB per depth iteration. $1.00 per credit.
-- **Formula**: `credits = max(1, ceil(file_size_mb * depth_iterations))`
+- **Formula**: `credits = max(1, ceil(file_size_mb * analysis_depth))`
 
 ```python
 # Estimate cost before running
 estimate = await engine.estimate(
     file_size_mb=10.5,
     num_columns=25,
-    depth_iterations=2,
+    analysis_depth=2,
     visibility="private",
 )
 # estimate["cost"]["credits"] -> 21

{discovery_engine_api-0.2.89 → discovery_engine_api-0.2.90}/README.md

@@ -41,7 +41,7 @@ Get your API key from the [Developers page](https://disco.leap-labs.com/develope
 await engine.discover(
     file: str | Path | pd.DataFrame,  # Dataset to analyze
     target_column: str,                 # Column to predict/analyze
-    depth_iterations: int = 2,          # 1=fast, higher=deeper search
+    analysis_depth: int = 2,          # 1=fast, higher=deeper search
     visibility: str = "public",         # "public" (free) or "private" (credits)
     title: str | None = None,           # Dataset title
     description: str | None = None,     # Dataset description
@@ -177,14 +177,14 @@ print(f"Explore: {result.report_url}")
 
 - **Public runs**: Free. Results published to public gallery.
 - **Private runs**: 1 credit per MB per depth iteration. $1.00 per credit.
-- **Formula**: `credits = max(1, ceil(file_size_mb * depth_iterations))`
+- **Formula**: `credits = max(1, ceil(file_size_mb * analysis_depth))`
 
 ```python
 # Estimate cost before running
 estimate = await engine.estimate(
     file_size_mb=10.5,
     num_columns=25,
-    depth_iterations=2,
+    analysis_depth=2,
     visibility="private",
 )
 # estimate["cost"]["credits"] -> 21

{discovery_engine_api-0.2.89 → discovery_engine_api-0.2.90}/discovery/__init__.py

@@ -1,6 +1,6 @@
 """Disco Python SDK."""
 
-__version__ = "0.2.89"
+__version__ = "0.2.90"
 
 from discovery.client import Engine
 from discovery.types import (

{discovery_engine_api-0.2.89 → discovery_engine_api-0.2.90}/discovery/client.py

@@ -219,7 +219,7 @@ class Engine:
         self,
         file: Union[str, Path, "pd.DataFrame"],
         target_column: str,
-        depth_iterations: int = 2,
+        analysis_depth: int = 2,
         visibility: str = "public",
         title: Optional[str] = None,
         description: Optional[str] = None,
@@ -237,7 +237,7 @@ class Engine:
         Args:
             file: File path, Path object, or pandas DataFrame.
             target_column: Column to analyze (what drives it up or down?).
-            depth_iterations: 1=fast, higher=deeper pattern search (max: num_columns - 2).
+            analysis_depth: 1=fast, higher=deeper pattern search (max: num_columns - 2).
             visibility: "public" (free, published) or "private" (costs credits).
             title: Optional dataset title.
             description: Optional dataset description.
@@ -259,7 +259,7 @@ class Engine:
         return await self.run_async(
             file=file,
             target_column=target_column,
-            depth_iterations=depth_iterations,
+            analysis_depth=analysis_depth,
             visibility=visibility,
             title=title,
             description=description,
@@ -274,7 +274,7 @@ class Engine:
         self,
         file: Union[str, Path, "pd.DataFrame"],
         target_column: str,
-        depth_iterations: int = 2,
+        analysis_depth: int = 2,
         visibility: str = "public",
         title: Optional[str] = None,
         description: Optional[str] = None,
@@ -288,7 +288,7 @@ class Engine:
             self.discover(
                 file=file,
                 target_column=target_column,
-                depth_iterations=depth_iterations,
+                analysis_depth=analysis_depth,
                 visibility=visibility,
                 title=title,
                 description=description,
@@ -382,7 +382,7 @@ class Engine:
         file_size_mb: float,
         num_columns: int,
         num_rows: Optional[int] = None,
-        depth_iterations: int = 2,
+        analysis_depth: int = 2,
         visibility: str = "public",
     ) -> Dict[str, Any]:
         """Estimate cost and time for an analysis run.
@@ -394,7 +394,7 @@ class Engine:
             file_size_mb: Size of the data file in megabytes.
             num_columns: Number of columns in the dataset.
             num_rows: Number of rows (improves time estimate accuracy).
-            depth_iterations: Depth iterations (1=fast, higher=deeper).
+            analysis_depth: Depth iterations (1=fast, higher=deeper).
             visibility: "public" (free, results published) or "private" (costs credits).
 
         Returns:
@@ -407,7 +407,7 @@ class Engine:
                 "file_size_mb": file_size_mb,
                 "num_columns": num_columns,
                 "num_rows": num_rows,
-                "depth_iterations": depth_iterations,
+                "analysis_depth": analysis_depth,
                 "visibility": visibility,
             },
         )
@@ -739,7 +739,7 @@ class Engine:
         self,
         file: Union[str, Path, "pd.DataFrame"],
         target_column: str,
-        depth_iterations: int = 2,
+        analysis_depth: int = 2,
         title: Optional[str] = None,
         description: Optional[str] = None,
         column_descriptions: Optional[Dict[str, str]] = None,
@@ -763,7 +763,7 @@ class Engine:
         Args:
             file: File path, Path object, or pandas DataFrame.
             target_column: Name of the target column.
-            depth_iterations: Analysis depth (default 2). Higher = deeper pattern search.
+            analysis_depth: Analysis depth (default 2). Higher = deeper pattern search.
             title: Optional dataset title.
             description: Optional dataset description.
             column_descriptions: Dict mapping column names to descriptions.
@@ -779,18 +779,18 @@ class Engine:
             EngineResult with run_id and (if wait=True) complete results.
         """
         # Public runs are capped at depth=2 (server enforces this)
-        if depth_iterations > 2 and visibility == "public":
+        if analysis_depth > 2 and visibility == "public":
             self._log(
                 "Public runs are capped at depth=2. Upgrade your plan at disco.leap-labs.com/subscribe "
                 "for deeper analysis and priority processing."
             )
-            depth_iterations = 2
+            analysis_depth = 2
 
         if upload_result:
             uploaded_file = upload_result["file"]
             columns = upload_result.get("columns", [])
             self._log(
-                f"Creating run from pre-uploaded file (depth: {depth_iterations}, target: {target_column})..."
+                f"Creating run from pre-uploaded file (depth: {analysis_depth}, target: {target_column})..."
             )
         else:
             file_content, filename, mime_type, _ = self._prepare_upload(
@@ -825,7 +825,7 @@ class Engine:
             },
             "columns": columns,
             "targetColumn": target_column,
-            "depthIterations": depth_iterations,
+            "analysisDepth": analysis_depth,
             "isPublic": visibility == "public",
         }
 
@@ -896,7 +896,7 @@ class Engine:
         self,
         file: Union[str, Path, "pd.DataFrame"],
         target_column: str,
-        depth_iterations: int = 2,
+        analysis_depth: int = 2,
         title: Optional[str] = None,
         description: Optional[str] = None,
         column_descriptions: Optional[Dict[str, str]] = None,
@@ -916,7 +916,7 @@ class Engine:
             self.run_async(
                 file,
                 target_column,
-                depth_iterations,
+                analysis_depth,
                 title=title,
                 description=description,
                 column_descriptions=column_descriptions,

{discovery_engine_api-0.2.89 → discovery_engine_api-0.2.90}/discovery/integrations/crewai.py

@@ -33,7 +33,7 @@ class DiscoveryEngineTool(BaseTool):
         "validated patterns that you cannot find with pandas, SQL, or by prompting "
         "an LLM to analyze data. Use when you need to go beyond correlation. "
         "Input: JSON with 'file' (path), 'target_column' (column to analyze). "
-        "Optional: 'visibility' (public/private), 'depth_iterations' (search depth). "
+        "Optional: 'visibility' (public/private), 'analysis_depth' (search depth). "
         "Returns patterns with conditions, p-values, novelty scores, citations."
     )
     api_key: str = Field(description="Disco API key (disco_...)")
@@ -57,7 +57,7 @@ class DiscoveryEngineTool(BaseTool):
             result = engine.discover_sync(
                 file=file_path,
                 target_column=target_column,
-                depth_iterations=params.get("depth_iterations", 2),
+                analysis_depth=params.get("analysis_depth", 2),
                 visibility=params.get("visibility", "public"),
             )
         except Exception as e:

{discovery_engine_api-0.2.89 → discovery_engine_api-0.2.90}/discovery/integrations/langchain.py

@@ -36,7 +36,7 @@ class DiscoveryEngineTool(BaseTool):
         "and find things nobody thought to look for. "
         "Input should be a JSON string with keys: "
         '"file" (path to CSV/Excel/Parquet), "target_column" (column to analyze). '
-        'Optional: "visibility" (public/private), "depth_iterations" (search depth). '
+        'Optional: "visibility" (public/private), "analysis_depth" (search depth). '
         "Returns structured patterns with conditions, p-values, novelty scores, "
         "and citations."
     )
@@ -66,7 +66,7 @@ class DiscoveryEngineTool(BaseTool):
             result = await engine.discover(
                 file=file_path,
                 target_column=target_column,
-                depth_iterations=params.get("depth_iterations", 2),
+                analysis_depth=params.get("analysis_depth", 2),
                 visibility=params.get("visibility", "public"),
             )
         except Exception as e:

{discovery_engine_api-0.2.89 → discovery_engine_api-0.2.90}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "discovery-engine-api"
-version = "0.2.89"
+version = "0.2.90"
 description = "Python SDK for Disco API"
 readme = "README.md"
 requires-python = ">=3.10"