discovery-engine-api 0.2.91__tar.gz → 0.2.93__tar.gz

{discovery_engine_api-0.2.91 → discovery_engine_api-0.2.93}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: discovery-engine-api
-Version: 0.2.91
+Version: 0.2.93
 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
@@ -213,8 +213,7 @@ print(f"Explore: {result.report_url}")
 ## Credits and Pricing
 
 - **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 * analysis_depth))`
+- **Private runs**: Credits scale with file size, depth, and run configuration. $0.10 per credit. Use `engine.estimate()` to check cost before running.
 
 ```python
 # Estimate cost before running
@@ -225,7 +224,6 @@ estimate = await engine.estimate(
     visibility="private",
 )
 # estimate["cost"]["credits"] -> 21
-# estimate["cost"]["free_alternative"] -> True
 # estimate["account"]["sufficient"] -> True/False
 ```
 

{discovery_engine_api-0.2.91 → discovery_engine_api-0.2.93}/README.md

@@ -176,8 +176,7 @@ print(f"Explore: {result.report_url}")
 ## Credits and Pricing
 
 - **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 * analysis_depth))`
+- **Private runs**: Credits scale with file size, depth, and run configuration. $0.10 per credit. Use `engine.estimate()` to check cost before running.
 
 ```python
 # Estimate cost before running
@@ -188,7 +187,6 @@ estimate = await engine.estimate(
     visibility="private",
 )
 # estimate["cost"]["credits"] -> 21
-# estimate["cost"]["free_alternative"] -> True
 # estimate["account"]["sufficient"] -> True/False
 ```
 

{discovery_engine_api-0.2.91 → discovery_engine_api-0.2.93}/discovery/__init__.py

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

{discovery_engine_api-0.2.91 → discovery_engine_api-0.2.93}/discovery/client.py

@@ -211,6 +211,57 @@ class Engine:
             )
         return engine
 
+    @classmethod
+    async def login(
+        cls,
+        email: str,
+        *,
+        quiet: bool = False,
+    ) -> "Engine":
+        """Get a new API key for an existing account.
+
+        Sends a 6-digit verification code to the email address. Prompts for
+        the code interactively, then returns a configured Engine with a fresh
+        ``disco_`` API key.
+
+        Use this when you need an API key for an account that already exists
+        (e.g. the key was lost or this is a new agent session).
+
+        Args:
+            email: Email address of the existing account.
+            quiet: If True, suppress status output.
+
+        Returns:
+            A configured Engine instance with the new API key.
+
+        Raises:
+            ValueError: If no account exists with this email (404).
+        """
+        async with cls._make_anon_client() as client:
+            response = await client.post("/api/login", json={"email": email})
+            cls._raise_for_status(response)
+            data = response.json()
+
+        if data.get("status") != "verification_required":
+            raise ValueError(f"Unexpected login response: {data}")
+
+        if not quiet:
+            print(f"A verification code has been sent to {email}.")
+        code = input("Enter verification code: ").strip()
+
+        async with cls._make_anon_client() as client:
+            verify_response = await client.post(
+                "/api/login/verify",
+                json={"email": email, "code": code},
+            )
+            cls._raise_for_status(verify_response)
+            key_data = verify_response.json()
+
+        engine = cls(api_key=key_data["key"], quiet=quiet)
+        if not quiet:
+            print(f"Logged in. Tier: {key_data.get('tier', 'free_tier')}")
+        return engine
+
     # ------------------------------------------------------------------
     # discover() — the primary method for agents
     # ------------------------------------------------------------------
@@ -225,6 +276,7 @@ class Engine:
         description: Optional[str] = None,
         column_descriptions: Optional[Dict[str, str]] = None,
         excluded_columns: Optional[List[str]] = None,
+        use_llms: bool = False,
         timeout: float = 1800,
         **kwargs,
     ) -> EngineResult:
@@ -244,6 +296,10 @@ class Engine:
             column_descriptions: Dict mapping column names to descriptions.
                 Significantly improves pattern explanations for non-obvious column names.
             excluded_columns: Columns to exclude from analysis.
+            use_llms: Slower and more expensive, but you get smarter pre-processing,
+                literature context and novelty assessment. Default False — set to
+                True if you want Disco-generated explanations. Public runs always
+                use LLMs.
             timeout: Max seconds to wait for completion (default: 1800).
             **kwargs: Additional arguments passed to run_async().
 
@@ -265,6 +321,7 @@ class Engine:
             description=description,
             column_descriptions=column_descriptions,
             excluded_columns=excluded_columns,
+            use_llms=use_llms,
             wait=True,
             wait_timeout=timeout,
             **kwargs,
@@ -280,6 +337,7 @@ class Engine:
         description: Optional[str] = None,
         column_descriptions: Optional[Dict[str, str]] = None,
         excluded_columns: Optional[List[str]] = None,
+        use_llms: bool = False,
         timeout: float = 1800,
         **kwargs,
     ) -> EngineResult:
@@ -294,6 +352,7 @@ class Engine:
                 description=description,
                 column_descriptions=column_descriptions,
                 excluded_columns=excluded_columns,
+                use_llms=use_llms,
                 timeout=timeout,
                 **kwargs,
             )
@@ -352,12 +411,12 @@ class Engine:
         return response.json()
 
     async def purchase_credits(self, packs: int = 1) -> Dict[str, Any]:
-        """Purchase credit packs. Each pack is 20 credits for $20.
+        """Purchase credit packs. Each pack is 100 credits for $10.
 
         Requires a payment method on file.
 
         Args:
-            packs: Number of 20-credit packs to purchase (default: 1).
+            packs: Number of 100-credit packs to purchase (default: 1).
 
         Returns:
             Dict with ``purchased_credits``, ``total_credits``, ``charge_amount_usd``.
@@ -384,6 +443,7 @@ class Engine:
         num_rows: Optional[int] = None,
         analysis_depth: int = 2,
         visibility: str = "public",
+        use_llms: bool = False,
     ) -> Dict[str, Any]:
         """Estimate cost and time for an analysis run.
 
@@ -396,6 +456,9 @@ class Engine:
             num_rows: Number of rows (improves time estimate accuracy).
             analysis_depth: Depth iterations (1=fast, higher=deeper).
             visibility: "public" (free, results published) or "private" (costs credits).
+            use_llms: Slower and more expensive, but you get smarter pre-processing,
+                literature context and novelty assessment. Default False. Public runs
+                always use LLMs.
 
         Returns:
             Dict with ``cost``, ``time_estimate``, ``limits``, and ``account`` info.
@@ -409,6 +472,7 @@ class Engine:
                 "num_rows": num_rows,
                 "analysis_depth": analysis_depth,
                 "visibility": visibility,
+                "use_llms": use_llms,
             },
         )
         self._raise_for_status(response)
@@ -750,6 +814,7 @@ class Engine:
         target_column_override: Optional[str] = None,
         author: Optional[str] = None,
         source_url: Optional[str] = None,
+        use_llms: bool = False,
         wait: bool = False,
         wait_timeout: Optional[float] = None,
         upload_result: Optional[Dict[str, Any]] = None,
@@ -770,6 +835,7 @@ class Engine:
             excluded_columns: Column names to exclude from analysis.
             task: Task type (auto-detected if None).
             visibility: "public" (free) or "private" (costs credits).
+            use_llms: Slower and more expensive, but you get smarter pre-processing, literature context and novelty assessment. Default False — set to True if you want Disco-generated explanations. Public runs always use LLMs.
             wait: If True, wait for completion and return full results.
             wait_timeout: Max seconds to wait (only if wait=True).
             upload_result: Pre-uploaded file data from ``upload_file()``.
@@ -827,6 +893,7 @@ class Engine:
             "targetColumn": target_column,
             "analysisDepth": analysis_depth,
             "isPublic": visibility == "public",
+            "useLlms": use_llms,
         }
 
         if title:
@@ -906,6 +973,7 @@ class Engine:
         timeseries_groups: Optional[List[Dict[str, Any]]] = None,
         target_column_override: Optional[str] = None,
         author: Optional[str] = None,
+        use_llms: bool = False,
         source_url: Optional[str] = None,
         wait: bool = False,
         wait_timeout: Optional[float] = None,
@@ -927,6 +995,7 @@ class Engine:
                 target_column_override=target_column_override,
                 author=author,
                 source_url=source_url,
+                use_llms=use_llms,
                 wait=wait,
                 wait_timeout=wait_timeout,
                 **kwargs,

{discovery_engine_api-0.2.91 → discovery_engine_api-0.2.93}/pyproject.toml

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