ghostcrawl 2.2.1__tar.gz → 2.2.3__tar.gz

{ghostcrawl-2.2.1/ghostcrawl.egg-info → ghostcrawl-2.2.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ghostcrawl
-Version: 2.2.1
+Version: 2.2.3
 Summary: Official Python SDK for the Ghostcrawl local orchestration API.
 Author: Ghostcrawl
 License: Proprietary — see LICENSE

{ghostcrawl-2.2.1 → ghostcrawl-2.2.3}/ghostcrawl/cli/main.py

@@ -58,7 +58,7 @@ def _run(value: Any) -> Any:
 # Top-level app
 # ---------------------------------------------------------------------------
 
-__version__ = "2.2.1"  # keep in sync with sdks/python/pyproject.toml (test_version_matches_pyproject guards drift)
+__version__ = "2.2.3"  # keep in sync with sdks/python/pyproject.toml (test_version_matches_pyproject guards drift)
 
 
 def _version_callback(value: bool) -> None:
@@ -485,11 +485,11 @@ def identity(
 # ---------------------------------------------------------------------------
 
 
-# Scrape presets (proxy tiers stay server-side, never emitted as request kwargs).
+# Scrape presets (the proxy_tier field stays server-side, never emitted as kwargs).
 _SCRAPE_PRESETS: dict[str, dict] = {
     "screenshot": {"render_js": True, "screenshot": True},
     "fetch": {"render_js": False, "block_resources": True},
-    "premium-render": {"render_js": True},  # proxy tier handled server-side
+    "premium-render": {"render_js": True},  # proxy_tier handled server-side
     "fast-html": {"render_js": False},
     "resilient": {"render_js": True},  # network routing handled server-side
 }
@@ -526,7 +526,7 @@ def _scrape_via_facade(client, *, url: str, scrape_kwargs: dict, max_proxy_tier:
     governor reroutes blocked egress IPs across the pool), so the CLI no longer
     drives integer-tier escalation from response headers. ``max_proxy_tier`` is
     accepted for back-compat but not forwarded — the legacy integer ``proxy_tier``
-    body field is obsolete (the server now models proxy tiers as named strings).
+    body field is obsolete (the server now models proxy_tier as named strings).
     Accepts either the async facade (a coroutine is driven by ``_run``) or a sync
     test double.
     """

{ghostcrawl-2.2.1 → ghostcrawl-2.2.3}/ghostcrawl/facade.py

@@ -425,6 +425,28 @@ def _translate_kiota_error(exc: Exception) -> Exception:
     return APIError(message, **common)
 
 
+def _normalize_scrape_content(result: typing.Any) -> None:
+    """Surface the rendered output under the documented ``content`` key.
+
+    The API returns the rendered page under a format-specific field
+    (``markdown`` / ``html`` / ``text``); the SDK contract (and every quickstart)
+    exposes it as ``result["content"]``. Mirror it in-place so the quickstart
+    works regardless of ``format``, without dropping the format-specific key.
+    """
+    if not isinstance(result, dict) or "content" in result:
+        return
+    fmt = result.get("format")
+    value = result.get(fmt) if isinstance(fmt, str) else None
+    if not isinstance(value, str):
+        for key in ("markdown", "html", "text"):
+            candidate = result.get(key)
+            if isinstance(candidate, str):
+                value = candidate
+                break
+    if isinstance(value, str):
+        result["content"] = value
+
+
 def _scan_result_error(result: dict) -> dict:
     """Raise :class:`ScrapeError` when a 200 result reports a TARGET failure.
 
@@ -627,9 +649,23 @@ class SessionsClient:
         return await _resolve_response(self._core.v1.sessions.create.post(body))
 
     async def extend(self, session_id: str, *, duration_seconds: int = 300) -> dict:
-        """Extend a session's TTL."""
+        """Extend a session's TTL.
+
+        Sends ``{"ttl_seconds": <duration_seconds>}`` — the generated
+        ``ExtendRequestBuilder.post`` rejects a null body, and the new TTL is
+        carried by the ``ttl_seconds`` field (30s..24h).
+        """
+        from _generated.models.extend_body import ExtendBody
+        from _generated.models.extend_body_ttl_seconds import (
+            ExtendBody_ttl_seconds,
+        )
+
+        body = ExtendBody()
+        ttl_wrapper = ExtendBody_ttl_seconds()
+        ttl_wrapper.integer = duration_seconds
+        body.ttl_seconds = ttl_wrapper
         return await _resolve_response(
-            self._core.v1.sessions.by_profile_id(session_id).extend.post(None)
+            self._core.v1.sessions.by_profile_id(session_id).extend.post(body)
         )
 
     async def release(self, session_id: str) -> dict:
@@ -915,7 +951,8 @@ class GhostcrawlClient:
         # provider_config is the per-instance LLM model provider configuration.
         # Validated server-side; stored here for request-body injection on the
         # agent lane. NEVER include in logs — the api_key inside must not leak.
-        # The SDK does NOT read GHOSTCRAWL_PROVIDER_CONFIG (server-side only).
+        # Passed explicitly by the caller; the SDK reads no environment variable
+        # for it (that configuration is resolved server-side).
         self._provider_config: typing.Optional[dict] = provider_config
 
         # Build the Kiota adapter: static-token bearer provider → httpx adapter
@@ -1082,7 +1119,9 @@ class GhostcrawlClient:
         }
         if extract_schema is not None:
             body.additional_data["extract_schema"] = extract_schema
-        return await _resolve_response(self._core.v1.scrape.post(body))
+        result = await _resolve_response(self._core.v1.scrape.post(body))
+        _normalize_scrape_content(result)
+        return result
 
     async def search(
         self,

{ghostcrawl-2.2.1 → ghostcrawl-2.2.3/ghostcrawl.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ghostcrawl
-Version: 2.2.1
+Version: 2.2.3
 Summary: Official Python SDK for the Ghostcrawl local orchestration API.
 Author: Ghostcrawl
 License: Proprietary — see LICENSE

{ghostcrawl-2.2.1 → ghostcrawl-2.2.3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "ghostcrawl"
-version = "2.2.1"
+version = "2.2.3"
 description = "Official Python SDK for the Ghostcrawl local orchestration API."
 readme = "README.md"
 requires-python = ">=3.10"