adloop 0.22.1__tar.gz → 0.22.2__tar.gz

{adloop-0.22.1 → adloop-0.22.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: adloop
-Version: 0.22.1
+Version: 0.22.2
 Summary: The AI command center for Google Ads, Reddit Ads, GA4, and tracking code.
 Keywords: mcp,google-ads,reddit-ads,google-analytics,ga4,cursor,marketing
 Author: Daniel Klose

{adloop-0.22.1 → adloop-0.22.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "adloop"
-version = "0.22.1"
+version = "0.22.2"
 description = "The AI command center for Google Ads, Reddit Ads, GA4, and tracking code."
 readme = "README.md"
 requires-python = ">=3.11"

{adloop-0.22.1 → adloop-0.22.2}/pyproject.toml.orig

@@ -1,6 +1,6 @@
 [project]
 name = "adloop"
-version = "0.22.1"
+version = "0.22.2"
 description = "The AI command center for Google Ads, Reddit Ads, GA4, and tracking code."
 readme = "README.md"
 authors = [

{adloop-0.22.1 → adloop-0.22.2}/src/adloop/gsc/reports.py

@@ -101,9 +101,13 @@ def run_gsc_report(
         site_url = config.gsc.site_url
 
     if not site_url:
+        from adloop.runtime import default_setting_hint
+
         return {
-            "error": "site_url is required. Pass it as an argument or set "
-                     "gsc.site_url in ~/.adloop/config.yaml."
+            "error": "site_url is required. Pass it as an argument (see "
+                     "list_gsc_sites) or "
+                     + default_setting_hint("gsc.site_url", "Settings → Google & accounts")
+                     + "."
         }
 
     dimensions = [_normalize_dimension(d) for d in (dimensions or ["query"])]

{adloop-0.22.1 → adloop-0.22.2}/src/adloop/merchant/read.py

@@ -126,6 +126,8 @@ def get_merchant_feed_health(
 
     account_id = str(account_id or "").strip() or config.merchant.account_id.strip()
     if not account_id:
+        from adloop.runtime import default_setting_hint
+
         return {
             "error": (
                 "account_id is required: no Merchant Center account was "
@@ -133,8 +135,9 @@ def get_merchant_feed_health(
             ),
             "hint": (
                 "Call list_merchant_accounts to find the numeric Merchant "
-                "Center ID and pass it as account_id, or set "
-                "merchant.account_id in the config to make it the default."
+                "Center ID and pass it as account_id, or "
+                + default_setting_hint("merchant.account_id", "Settings → Google & accounts")
+                + "."
             ),
         }
     if not account_id.isdigit():

{adloop-0.22.1 → adloop-0.22.2}/src/adloop/reddit/read.py

@@ -103,9 +103,13 @@ def resolve_account(config: AdLoopConfig, ad_account_id: str = "") -> str:
     """Explicit id wins, then ``reddit.ad_account_id`` from the config."""
     account = (ad_account_id or config.reddit.ad_account_id or "").strip()
     if not account:
+        from adloop.runtime import default_setting_hint
+
         raise ValueError(
-            "ad_account_id is required — pass it explicitly (see "
-            "list_reddit_accounts) or set reddit.ad_account_id in the config."
+            "ad_account_id is required: pass it explicitly (see "
+            "list_reddit_accounts) or "
+            + default_setting_hint("reddit.ad_account_id", "Settings → Reddit Ads")
+            + "."
         )
     return account
 

{adloop-0.22.1 → adloop-0.22.2}/src/adloop/runtime.py

@@ -64,6 +64,20 @@ def tool_visibility() -> ToolVisibility | None:
     return _tool_visibility
 
 
+def default_setting_hint(config_key: str, dashboard_page: str) -> str:
+    """How to set a missing default, phrased for where AdLoop runs.
+
+    Self-hosted it is a key in the config file; a hosted runtime has no
+    config file the user can edit, so it names the dashboard page instead.
+    """
+    if _deployment_mode == "server":
+        return (
+            f"choose a default under {dashboard_page} in the AdLoop Cloud "
+            "dashboard (agencies: per client under Settings → Clients)"
+        )
+    return f"set {config_key} in the config (~/.adloop/config.yaml)"
+
+
 def deployment_mode() -> DeploymentMode:
     """Return the process-wide deployment mode ("local" or "server")."""
     return _deployment_mode

{adloop-0.22.1 → adloop-0.22.2}/src/adloop/server.py

@@ -155,10 +155,13 @@ def _gtm_defaults(account_id: str, container_id: str) -> tuple[str, str]:
     account_id = account_id or cfg.account_id
     container_id = container_id or cfg.container_id
     if not account_id or not container_id:
+        from adloop.runtime import default_setting_hint
+
         raise ValueError(
-            "gtm_account_id and gtm_container_id are required — pass them "
-            "explicitly (see list_gtm_accounts / list_gtm_containers) or set "
-            "gtm.account_id / gtm.container_id in the config."
+            "gtm_account_id and gtm_container_id are required: pass them "
+            "explicitly (see list_gtm_accounts / list_gtm_containers) or "
+            + default_setting_hint("gtm.account_id / gtm.container_id", "Settings → Google & accounts")
+            + "."
         )
     return account_id, container_id
 
@@ -1790,9 +1793,12 @@ def list_gtm_containers(gtm_account_id: str = "") -> dict:
 
     gtm_account_id = gtm_account_id or current_config().gtm.account_id
     if not gtm_account_id:
+        from adloop.runtime import default_setting_hint
+
         raise ValueError(
-            "gtm_account_id is required — call list_gtm_accounts first or "
-            "set gtm.account_id in the config."
+            "gtm_account_id is required: call list_gtm_accounts first or "
+            + default_setting_hint("gtm.account_id", "Settings → Google & accounts")
+            + "."
         )
     return _impl(current_config(), account_id=gtm_account_id)