@soku-ai/cli 0.1.0-alpha.0

package/dist/generated/capabilities.json

@@ -0,0 +1,770 @@
+{
+  "actions": [
+    {
+      "id": "action:ads/gaql_search",
+      "namespace": "ads",
+      "action": "gaql_search",
+      "description": "Realtime Google Ads GAQL fallback for native fields or segments not covered by cached query_* actions; no business-layer CPA/ROAS semantics.",
+      "long_description": "FALLBACK PATH for Google-native ads exploration.\n\nPrimary use:\nRealtime GAQL search for fields, segments, or dimension combinations that are not exposed by cached query_single_dimension or query_multi_dimension.\n\nUse when:\n- list_dimensions does not expose the field or segment the user needs.\n- query_multi_dimension returns unsupported_dimension_combination and a GAQL fallback is acceptable.\n- You need Google-native resource fields, raw.segments.*, or raw.metrics.*.\n\nDo not use when:\n- Cached business-layer analytics can answer the question. Use query_single_dimension or query_multi_dimension.\n- The user needs CPA, CPP, ROAS, Reg Rate, Pur Rate, or cg.{slug}.* fan-out. Use query_single_dimension.\n- The platform is Meta. This action is Google-only.\n\nWorkflow:\n1. Call list_dimensions first to confirm cached analytics cannot satisfy the query.\n2. Call get_resource_metadata if you do not know selectable/filterable/sortable Google fields for the target resource.\n3. Call this action with account_id, dimensions[], metrics[], optional filters, date_range, order_by, limit, and mode.\n\nOutput semantics:\n- Returns translated Google Ads query text in query.\n- columns contains normalized field arrays; rows may also be present for convenience.\n- account.data_freshness is realtime call time, not Parquet sync time.\n- No mapping-aware derived metrics or conversion-group fan-out are computed.",
+      "capability_mode": "read",
+      "priority": "advanced",
+      "requires_review": false,
+      "freshness_kind": "realtime",
+      "input_params": [
+        {
+          "name": "platform",
+          "type": "string",
+          "required": false,
+          "description": "Optional platform. Omit or use google; Meta is not supported."
+        },
+        {
+          "name": "account_id",
+          "type": "string",
+          "required": true,
+          "description": "Google account id from list_ad_accounts.rows[].account_id. Use digits only with no dashes."
+        },
+        {
+          "name": "dimensions",
+          "type": "list",
+          "required": true,
+          "description": "Dimension fields. Use L1.5 slugs such as date or campaign, or raw.segments.X fields discovered via get_resource_metadata."
+        },
+        {
+          "name": "metrics",
+          "type": "list",
+          "required": true,
+          "description": "Metric fields. Use L1.5 slugs such as clicks or cost, or raw.metrics.X fields discovered via get_resource_metadata."
+        },
+        {
+          "name": "date_range",
+          "type": "object",
+          "required": false,
+          "description": "{date_start, date_end} in YYYY-MM-DD format. Required for metric or segment queries; optional for pure metadata-style entity reads."
+        },
+        {
+          "name": "filters",
+          "type": "object",
+          "required": false,
+          "description": "Filter expressions over fields marked filterable by get_resource_metadata."
+        },
+        {
+          "name": "order_by",
+          "type": "list",
+          "required": false,
+          "description": "[{field, direction}] where direction is ASC or DESC; field must be sortable."
+        },
+        {
+          "name": "limit",
+          "type": "integer",
+          "required": false,
+          "description": "Row cap. Omit to use the service default; hard budget still applies."
+        },
+        {
+          "name": "mode",
+          "type": "string",
+          "required": false,
+          "description": "rows or summary."
+        }
+      ],
+      "output_shape": "{\"account\": {\"platform\": \"google\", \"account_id\": \"123\", \"data_freshness\": \"ISO\"}, \"columns\": {<field>: [...]}, \"rows\": [...], \"row_count\": N, \"query\": \"<translated GAQL string>\"}",
+      "see_also": [
+        "action:ads/query_single_dimension",
+        "action:ads/query_multi_dimension",
+        "action:ads/get_resource_metadata"
+      ]
+    },
+    {
+      "id": "action:ads/get_resource_metadata",
+      "namespace": "ads",
+      "action": "get_resource_metadata",
+      "description": "Discover selectable, filterable, and sortable Google Ads fields for a GAQL resource before building gaql_search raw.* inputs.",
+      "long_description": "FALLBACK PATH companion to gaql_search.\n\nPrimary use:\nGoogle Ads field discovery for a single GAQL resource such as campaign, ad_group, ad_group_criterion, or customer.\n\nUse when:\n- You plan to call gaql_search and need to know which native Google Ads fields exist.\n- You need to validate whether a field is selectable, filterable, or sortable.\n- A previous gaql_search failed because a raw field was unknown or not allowed.\n\nDo not use when:\n- You need cached business-layer analytics dimensions. Use list_dimensions.\n- You need conversion group business semantics. Use list_conversion_groups.\n- The platform is Meta. This action is Google-only.\n\nWorkflow:\n1. Choose the Google Ads GAQL resource name.\n2. Call this action to inspect fields.\n3. Use returned field names in gaql_search via raw.segments.X or raw.metrics.X, or use L1.5 slugs when available.\n\nOutput semantics:\n- selectable fields can be requested in gaql_search dimensions or metrics.\n- filterable fields can be used in gaql_search filters.\n- sortable fields can be used in gaql_search order_by.\n- data_type is the Google Ads API field data type.",
+      "capability_mode": "read",
+      "priority": "advanced",
+      "requires_review": false,
+      "freshness_kind": "realtime",
+      "input_params": [
+        {
+          "name": "platform",
+          "type": "string",
+          "required": false,
+          "description": "Optional platform. Omit or use google; Meta is not supported."
+        },
+        {
+          "name": "account_id",
+          "type": "string",
+          "required": true,
+          "description": "Google account id from list_ad_accounts.rows[].account_id. Use digits only with no dashes."
+        },
+        {
+          "name": "resource_name",
+          "type": "string",
+          "required": true,
+          "description": "Google Ads resource lowercase name, such as campaign or ad_group. Must match ^[a-z_]+$.",
+          "example": "ad_group"
+        }
+      ],
+      "output_shape": "{\"account\": {\"platform\": \"google\", \"account_id\": \"123\", \"data_freshness\": \"ISO\"}, \"resource\": \"ad_group\", \"fields\": [{\"name\": \"...\", \"category\": \"ATTRIBUTE\", \"selectable\": true, \"filterable\": true, \"sortable\": true, \"data_type\": \"STRING\"}]}",
+      "see_also": [
+        "action:ads/gaql_search"
+      ]
+    },
+    {
+      "id": "action:ads/list_ad_accounts",
+      "namespace": "ads",
+      "action": "list_ad_accounts",
+      "description": "Discover brand-granted Google/Meta ad accounts; returns account_id values required by later ads queries and ads-ops actions.",
+      "long_description": "Primary use:\nAccount discovery for the current brand. Use the returned account_id values as the only valid account_id inputs for later ads analytics or ads-ops calls.\n\nUse when:\n- The user did not provide an account_id.\n- The user asks which ad accounts are available.\n- You need to choose a Google or Meta account before querying metrics or running ads-ops actions.\n\nDo not use when:\n- You already have an account_id from this response in the same workflow.\n- You need campaign/ad/keyword metrics. Use list_dimensions plus query_* instead.\n\nWorkflow:\n1. Call this action, optionally filtering by platform.\n2. Pick one row's account_id and platform.\n3. Reuse that account_id in query_single_dimension, query_multi_dimension, gaql_search, get_resource_metadata, list_operation_records, or ads-ops actions.\n\nOutput semantics:\n- rows[].account_id is the external platform account id expected by later calls.\n- rows[].data_freshness is the latest completed ads sync run finish time for that account.\n\nConstraints:\n- Rows are filtered by ResourceBrandGrant for the sandbox brand.\n- An account absent from this response cannot be used in ads or ads-ops calls; the dispatcher returns 403.",
+      "capability_mode": "read",
+      "priority": "supporting",
+      "requires_review": false,
+      "freshness_kind": "synced",
+      "input_params": [
+        {
+          "name": "platform",
+          "type": "string",
+          "required": false,
+          "description": "Optional platform filter. Use google or meta; omit to list all granted accounts.",
+          "example": "google"
+        }
+      ],
+      "output_shape": "{\"rows\": [{\"account_id\": \"1234567890\", \"platform\": \"google\", \"name\": \"...\", \"currency\": \"USD\", \"timezone\": \"America/Los_Angeles\", \"data_freshness\": \"ISO\"}]}",
+      "see_also": [
+        "action:ads/list_dimensions",
+        "action:ads/query_single_dimension",
+        "action:ads/query_multi_dimension"
+      ]
+    },
+    {
+      "id": "action:ads/list_conversion_actions",
+      "namespace": "ads",
+      "action": "list_conversion_actions",
+      "description": "List synced platform conversion actions that can be mapped into conversion groups for the caller's brand-granted ad accounts.",
+      "long_description": "Primary use:\nConversion action candidate discovery for maintaining conversion_group rules. Use this action when you need the platform conversion_action_id values that can be bound to a conversion group.\n\nUse when:\n- You are preparing to create or update conversion_group rules.\n- You need to know whether a platform conversion action is already mapped.\n- You need account-scoped conversion action metadata such as platform, customer_id, category, type, or status.\n\nDo not use when:\n- You need business conversion group slugs or derived metric labels. Use list_conversion_groups.\n- You need live platform inventory from ads-ops. This action returns synced Nex data limited to the current brand's granted ad accounts.\n\nOutput semantics:\n- conversion_actions[].account_id is the internal ad account id used by conversion mapping rules.\n- conversion_actions[].conversion_action_id is the platform action id used by rules.\n- conversion_actions[].data_freshness is the latest completed ads sync run finish time for the action's account.\n- mapped_to lists conversion_group slugs that already include the action.",
+      "capability_mode": "read",
+      "priority": "supporting",
+      "requires_review": false,
+      "freshness_kind": "synced",
+      "input_params": [
+        {
+          "name": "platform",
+          "type": "string",
+          "required": false,
+          "description": "Optional platform filter. Use google or meta; omit to list all synced actions.",
+          "example": "google"
+        }
+      ],
+      "output_shape": "{\"conversion_actions\": [{\"id\": 11, \"account_id\": 5, \"customer_id\": \"1234567890\", \"platform\": \"google\", \"conversion_action_id\": \"act_purchase\", \"conversion_action_name\": \"Purchase\", \"category\": \"PURCHASE\", \"action_type\": \"WEBPAGE\", \"status\": \"ENABLED\", \"customer_name\": \"Account\", \"is_mapped\": true, \"data_freshness\": \"ISO\", \"mapped_to\": [\"payment-success\"]}]}",
+      "see_also": [
+        "action:ads/list_conversion_groups"
+      ]
+    },
+    {
+      "id": "action:ads/list_conversion_groups",
+      "namespace": "ads",
+      "action": "list_conversion_groups",
+      "description": "Discover conversion group slugs and derived CPA/ROAS labels needed for cg.{slug}.* columns in query_single_dimension. Scoped to the caller's brand.",
+      "long_description": "Primary use:\nConversion Mapping Group discovery for business metrics such as CPA, CPP, ROAS, Reg Rate, and Pur Rate. Use the returned group slugs to build legal cg.{slug}.* column references for query_single_dimension.\n\nUse when:\n- The user asks for CPA, CPP, ROAS, registration rate, purchase rate, or other mapped conversion metrics.\n- You plan to request or interpret cg.{slug}.* fan-out columns.\n- You need to know the default attribution_window, time_field, value_field, or display labels for conversion-derived metrics.\n\nDo not use when:\n- You only need platform raw metrics such as clicks, impressions, spend_micros, ctr, or conversions.\n- You are using query_multi_dimension. Multi-dimensional queries do not support conversion-group fan-out or mapping-aware derived metrics.\n\nWorkflow:\n1. Call list_dimensions to confirm the dimension supports cg fan-out.\n2. Call this action to get legal group slugs, labels, metadata, and version tokens.\n3. Call query_single_dimension with cg.{slug}.* columns implied by the selected metrics.\n\nOutput semantics:\n- groups[].slug is the only legal slug in cg.{slug}.* column references.\n- groups[].brand_id echoes the caller's brand; same slug can mean a different configuration in another brand of the same org.\n- groups[].version is an opaque precondition token for conversion_group write actions.\n- derived_metrics explains the display label and denominator/value semantics.\n- metadata is a customer-defined list of key/value/description fields for agent interpretation.\n- attribution_window is the group default unless query_single_dimension overrides it.\n- Admin-Web fields such as color, sort_order, owner_admin_user_id, and summary_pin_slot are intentionally not exposed.",
+      "capability_mode": "read",
+      "priority": "supporting",
+      "requires_review": false,
+      "freshness_kind": "synced",
+      "input_params": [],
+      "output_shape": "{\"groups\": [{\"id\": 1, \"slug\": \"qualified-new-user\", \"name\": \"Qualified New User\", \"brand_id\": \"...\", \"version\": \"opaque\", \"time_field\": \"click_time\", \"value_field\": \"conversions_value\", \"attribution_window\": \"7d_click\", \"derived_metrics\": {\"cost_per_label\": \"CPA\", \"rate_label\": \"Reg Rate\", \"rate_denominator\": \"clicks\", \"value_label\": null, \"roas_label\": null}, \"metadata\": [{\"key\": \"business_stage\", \"value\": \"activation\", \"description\": \"How the agent should interpret this field.\"}]}]}",
+      "see_also": [
+        "action:ads/list_dimensions",
+        "action:ads/query_single_dimension",
+        "action:ads/list_conversion_actions"
+      ]
+    },
+    {
+      "id": "action:ads/list_conversions",
+      "namespace": "ads",
+      "action": "list_conversions",
+      "description": "Deprecated alias for list_conversion_groups. Returns conversion group business fields under rows for short-term compatibility.",
+      "long_description": "Deprecated compatibility alias.\n\nUse list_conversion_groups for new workflows. This action exists only so older agents that learned the legacy list_conversions name can still discover conversion group slugs and derived metric labels.\n\nOutput semantics:\n- rows[] contains conversion_group specs with the same field set as list_conversion_groups.groups[].\n- This action does not list platform conversion actions. Use list_conversion_actions for that.",
+      "capability_mode": "read",
+      "priority": "supporting",
+      "requires_review": false,
+      "freshness_kind": "synced",
+      "input_params": [],
+      "output_shape": "{\"rows\": [{\"id\": 1, \"slug\": \"qualified-new-user\", \"name\": \"Qualified New User\", \"brand_id\": \"...\", \"version\": \"opaque\", \"derived_metrics\": {\"cost_per_label\": \"CPA\", \"rate_label\": \"Reg Rate\", \"rate_denominator\": \"clicks\", \"value_label\": null, \"roas_label\": null}, \"metadata\": []}]}",
+      "see_also": [
+        "action:ads/list_conversion_groups",
+        "action:ads/list_conversion_actions",
+        "action:ads/query_single_dimension"
+      ]
+    },
+    {
+      "id": "action:ads/list_dimensions",
+      "namespace": "ads",
+      "action": "list_dimensions",
+      "description": "Discover cached ads dimensions, metrics, filters, and scope caveats before building query_single_dimension or query_multi_dimension calls.",
+      "long_description": "Primary use:\nSchema discovery for cached ads analytics. This is the primary way to learn which business-layer dimensions, metrics, filters, scopes, and Parquet-backed views can be queried.\n\nUse when:\n- Before the first query_single_dimension or query_multi_dimension call in a workflow.\n- You need valid dimension slugs such as account, date, campaign, adgroup, ad, keyword, search_term, device, country, language, landing_page, age_range, or gender.\n- You need filterable_fields, parent_dimensions, scope_caveat, or cg fan-out support.\n- You need to know which raw and derived metrics are available.\n\nDo not use when:\n- You need Google Ads native fields not listed here. Use get_resource_metadata then gaql_search.\n- You need conversion group slugs for cg.{slug}.* columns. Use list_conversion_groups.\n\nWorkflow:\n1. Call list_ad_accounts if account_id is unknown.\n2. Call this action to select dimensions, filters, and metrics.\n3. Use query_single_dimension for one dimension or mapping-aware metrics.\n4. Use query_multi_dimension for valid multi-dimensional raw breakdowns.\n\nOutput semantics:\n- dimensions[].name is the dimension slug to pass as dimension or dimensions[].\n- dimensions[].filterable_fields are the only supported filter keys for that dimension.\n- dimensions[].supports_cg_fanout tells whether cg.{slug}.* columns can be requested.\n- metrics[].slug is the metric name to read from query output columns.",
+      "capability_mode": "read",
+      "priority": "supporting",
+      "requires_review": false,
+      "freshness_kind": "synced",
+      "input_params": [
+        {
+          "name": "platform",
+          "type": "string",
+          "required": false,
+          "description": "Optional platform filter. Use google or meta; omit to list all cached ads schemas.",
+          "example": "google"
+        }
+      ],
+      "output_shape": "{\"dimensions\": [{\"slug\": \"campaign\", \"scope\": \"campaign\", \"source_view\": \"campaign_daily\", \"parquet_table\": \"campaign_daily\", \"filterable_fields\": [...], \"supports_cg_fanout\": true, \"caveat\": \"...\"}], \"metrics\": [{\"slug\": \"ctr\", \"unit\": \"ratio\", \"formula\": \"...\", \"depends_on\": [...], \"platform_support\": [...]}]}",
+      "see_also": [
+        "action:ads/query_single_dimension",
+        "action:ads/query_multi_dimension",
+        "action:ads/list_conversion_groups",
+        "action:ads/gaql_search"
+      ]
+    },
+    {
+      "id": "action:ads/list_operation_records",
+      "namespace": "ads",
+      "action": "list_operation_records",
+      "description": "List Nex-side ads-ops action records for an account and date range; not Google Ads external change history.",
+      "long_description": "Primary use:\nAudit Nex-side ads-ops actions that were recorded for a specific ad account and date range. This helps explain what Nex or an agent attempted to change.\n\nUse when:\n- The user asks what actions Nex or an agent performed on an ad account.\n- You need before/after payloads for Nex-recorded ads-ops writes.\n- You need operator_user_id, operator_display_name, action_type, target entity, and timestamp for internal troubleshooting.\n\nDo not use when:\n- The user asks for Google's external account change history. Use ads-ops.get_change_history.\n- The user asks for analytics metrics. Use query_single_dimension or query_multi_dimension.\n\nWorkflow:\n1. Call list_ad_accounts if account_id is unknown.\n2. Call this action with platform, account_id, date_start, and date_end.\n3. Use page and page_size for pagination when the result is large.\n\nOutput semantics:\n- rows[] contains Nex internal action records, not platform-native history.\n- before and after are the recorded operation payload snapshots when available.\n- Operator email is never returned to avoid PII leakage; use operator_user_id and operator_display_name only.",
+      "capability_mode": "read",
+      "priority": "supporting",
+      "requires_review": false,
+      "freshness_kind": "synced",
+      "input_params": [
+        {
+          "name": "platform",
+          "type": "string",
+          "required": true,
+          "description": "Ad platform for the selected account. Use google or meta."
+        },
+        {
+          "name": "account_id",
+          "type": "string",
+          "required": true,
+          "description": "Account id from list_ad_accounts.rows[].account_id. For Google, use digits only with no dashes."
+        },
+        {
+          "name": "date_start",
+          "type": "string",
+          "required": true,
+          "description": "Inclusive start date in YYYY-MM-DD format."
+        },
+        {
+          "name": "date_end",
+          "type": "string",
+          "required": true,
+          "description": "Inclusive end date in YYYY-MM-DD format."
+        },
+        {
+          "name": "page",
+          "type": "integer",
+          "required": false,
+          "description": "1-indexed page number. Defaults to 1."
+        },
+        {
+          "name": "page_size",
+          "type": "integer",
+          "required": false,
+          "description": "Rows per page. Omit to use the service default."
+        }
+      ],
+      "output_shape": "{\"account\": {\"platform\": \"google\", \"account_id\": \"123\", \"data_freshness\": \"ISO\"}, \"rows\": [{\"operator_user_id\": \"...\", \"operator_display_name\": \"...\", \"action_type\": \"create_campaign\", \"target_entity_type\": \"campaign\", \"target_entity_id\": \"...\", \"before\": null, \"after\": {...}, \"timestamp\": \"ISO\"}]}",
+      "see_also": [
+        "action:ads/list_ad_accounts",
+        "action:ads-ops/get_change_history"
+      ]
+    },
+    {
+      "id": "action:ads/query_multi_dimension",
+      "namespace": "ads",
+      "action": "query_multi_dimension",
+      "description": "Cached ads breakdown across multiple dimensions; returns column-oriented raw platform metrics without CPA/ROAS or cg.{slug}.* fan-out.",
+      "long_description": "PRIMARY PATH for cached multi-dimensional breakdowns.\n\nPrimary use:\nMulti-dimensional reporting over synced Nex ads data, such as campaign x country or campaign x device. Use it when the user needs more than one group-by dimension.\n\nUse when:\n- The user asks for a breakdown by two or more supported dimensions.\n- The requested combination is valid according to the service viable-combo table.\n- Raw platform metrics are sufficient.\n\nDo not use when:\n- The user needs CPA, CPP, ROAS, Reg Rate, Pur Rate, or cg.{slug}.* columns. Use query_single_dimension.\n- A single dimension is enough. Use query_single_dimension for richer semantics.\n- The dimension combination is unsupported and must use Google-native fields. Use get_resource_metadata then gaql_search.\n\nWorkflow:\n1. Call list_ad_accounts if account_id is unknown.\n2. Call list_dimensions to choose legal dimension slugs and filters.\n3. Prefer the most specific child dimension; the handler may drop redundant parent dimensions and report that in notice.\n4. Call this action with platform, account_id, date range, and dimensions[].\n\nOutput semantics:\n- Returns column-oriented data. Read data.columns.<column>[i], not data.rows.\n- Only platform-raw conversion metrics are available.\n- requested_dimensions preserves the original request when normalization occurs.\n- notice describes dropped parent dimensions; unsupported combinations return 400 unsupported_dimension_combination with nearest viable combos and a GAQL fallback hint.\n- For id-keyed dimensions (campaign / account / adgroup / ad), the response includes both the raw id column (e.g., adset_id) and the resolved name column (e.g., adset_name) for agent display. Use the id column for filters / drills; use the name column for user-facing output.",
+      "capability_mode": "read",
+      "priority": "primary",
+      "requires_review": false,
+      "freshness_kind": "synced",
+      "input_params": [
+        {
+          "name": "platform",
+          "type": "string",
+          "required": true,
+          "description": "Ad platform for the selected account. Use google or meta."
+        },
+        {
+          "name": "account_id",
+          "type": "string",
+          "required": true,
+          "description": "Account id from list_ad_accounts.rows[].account_id. For Google, use digits only with no dashes."
+        },
+        {
+          "name": "date_start",
+          "type": "string",
+          "required": true,
+          "description": "Inclusive start date in YYYY-MM-DD format."
+        },
+        {
+          "name": "date_end",
+          "type": "string",
+          "required": true,
+          "description": "Inclusive end date in YYYY-MM-DD format."
+        },
+        {
+          "name": "dimensions",
+          "type": "list",
+          "required": true,
+          "description": "Dimension slug list from list_dimensions.dimensions[].name. The service enforces valid combinations.",
+          "example": [
+            "campaign",
+            "country"
+          ]
+        },
+        {
+          "name": "filters",
+          "type": "object",
+          "required": false,
+          "description": "Map of field -> allowed values; field must appear in list_dimensions.filterable_fields for the selected dimensions."
+        },
+        {
+          "name": "sort",
+          "type": "list",
+          "required": false,
+          "description": "[{field, order}] with order in {asc, desc}; field must exist in output columns."
+        },
+        {
+          "name": "mode",
+          "type": "string",
+          "required": false,
+          "description": "rows (default) or summary."
+        },
+        {
+          "name": "limit",
+          "type": "integer",
+          "required": false,
+          "description": "Row cap. Omit to use the service default; hard budget still applies."
+        }
+      ],
+      "output_shape": "{\"account\": {\"platform\": \"google\", \"account_id\": \"123\", \"data_freshness\": \"ISO\"}, \"dimensions\": [\"campaign\", \"country\"], \"data_basis\": {...}, \"scope_caveat\": \"...\", \"row_count\": N, \"columns\": {<col>: [...]}, \"summary\": null}",
+      "see_also": [
+        "action:ads/query_single_dimension",
+        "action:ads/gaql_search",
+        "action:ads/list_dimensions"
+      ]
+    },
+    {
+      "id": "action:ads/query_single_dimension",
+      "namespace": "ads",
+      "action": "query_single_dimension",
+      "description": "Primary cached ads analytics query for one dimension; returns column-oriented business metrics, derived metrics, and cg.{slug}.* conversion fan-out.",
+      "long_description": "PRIMARY PATH for cached ads analytics.\n\nPrimary use:\nSingle-dimension reporting over synced Nex business-layer ads data. Use this for daily report KPIs, campaign/ad/adgroup/keyword/search-term/device/country breakdowns, cross-platform-consistent metrics, and mapping-aware derived metrics.\n\nUse when:\n- The analysis has exactly one group-by dimension.\n- The user asks for CPA, CPP, ROAS, Reg Rate, Pur Rate, or cg.{slug}.* metrics.\n- The result should use Nex cached Parquet data and business semantics.\n\nDo not use when:\n- The user needs multiple group-by dimensions. Use query_multi_dimension.\n- The field or segment is not exposed by list_dimensions. Use get_resource_metadata then gaql_search for Google-native exploration.\n- The user needs write or mutation history. Use ads-ops or list_operation_records.\n\nWorkflow:\n1. Call list_ad_accounts if account_id is unknown.\n2. Call list_dimensions to choose a valid dimension, filters, and metrics.\n3. Call list_conversion_groups only if conversion-group fan-out or CPA/ROAS-like metrics are needed.\n4. Call this action with platform, account_id, date_start, date_end, and dimension.\n\nOutput semantics:\n- Returns column-oriented data. Read data.columns.<column>[i], not data.rows.\n- spend_micros and cpc_micros are micros; ctr is a 0-1 ratio.\n- scope_caveat explains aggregation limits for the selected scope.\n- mode=summary returns summary data such as top rows, totals, and p95 where supported.\n- truncated or warning means the agent must mention partial result limits.\n- For id-keyed dimensions (campaign / account / adgroup / ad), dimension_label is the resolved entity name (e.g., adset name for adgroup dimension); falls back to the platform id when the entity record is missing or has no name.",
+      "capability_mode": "read",
+      "priority": "primary",
+      "requires_review": false,
+      "freshness_kind": "synced",
+      "input_params": [
+        {
+          "name": "platform",
+          "type": "string",
+          "required": true,
+          "description": "Ad platform for the selected account. Use google or meta.",
+          "example": "google"
+        },
+        {
+          "name": "account_id",
+          "type": "string",
+          "required": true,
+          "description": "Account id from list_ad_accounts.rows[].account_id. For Google, use digits only with no dashes.",
+          "example": "1234567890"
+        },
+        {
+          "name": "date_start",
+          "type": "string",
+          "required": true,
+          "description": "Inclusive start date in YYYY-MM-DD format.",
+          "example": "2026-05-01"
+        },
+        {
+          "name": "date_end",
+          "type": "string",
+          "required": true,
+          "description": "Inclusive end date in YYYY-MM-DD format.",
+          "example": "2026-05-18"
+        },
+        {
+          "name": "dimension",
+          "type": "string",
+          "required": true,
+          "description": "Single dimension slug from list_dimensions.dimensions[].name.",
+          "example": "campaign"
+        },
+        {
+          "name": "filters",
+          "type": "object",
+          "required": false,
+          "description": "Map of field -> allowed values; field must appear in the selected dimension's list_dimensions.filterable_fields."
+        },
+        {
+          "name": "sort",
+          "type": "list",
+          "required": false,
+          "description": "[{field, order}] with order in {asc, desc}; default desc by total_spend_micros. Sort field must exist in output columns."
+        },
+        {
+          "name": "mode",
+          "type": "string",
+          "required": false,
+          "description": "rows (default) or summary; summary returns top rows, totals, and p95."
+        },
+        {
+          "name": "limit",
+          "type": "integer",
+          "required": false,
+          "description": "Row cap. Omit to use the service default; hard budget still applies."
+        },
+        {
+          "name": "attribution_window",
+          "type": "string",
+          "required": false,
+          "description": "Override conversion-mapping default; one of 1d_click, 7d_click, 1d_view, 7d_view, 28d_view, 1d_click_1d_view, 7d_click_1d_view, 28d_click_1d_view, default"
+        }
+      ],
+      "output_shape": "{\"account\": {\"platform\": \"google\", \"account_id\": \"123\", \"data_freshness\": \"ISO\"}, \"dimension\": \"campaign\", \"data_basis\": {\"view\": \"...\", \"parquet_table\": \"...\", \"selected_scope\": \"campaign\", \"cg_fan_out_available\": true}, \"scope_caveat\": \"...\", \"row_count\": 128, \"truncated\": false, \"warning\": null, \"columns\": {\"campaign_id\": [...], \"spend_micros\": [...], \"ctr\": [...], \"cg.qualified-new-user.all_conv\": [...]}, \"summary\": null}",
+      "see_also": [
+        "action:ads/query_multi_dimension",
+        "action:ads/gaql_search",
+        "action:ads/list_conversion_groups"
+      ]
+    },
+    {
+      "id": "action:ga4/get_conversion_overview",
+      "namespace": "ga4",
+      "action": "get_conversion_overview",
+      "description": "Cached GA4 key-event summary for a property over a date range; returns total key events, revenue, and top converting traffic sources.",
+      "long_description": "Primary use:\nConversion summary using GA4 v5+ key_events, together with the top sources that drove those events.\n\nUse when:\n- The user asks for total conversions or key events for a period.\n- The user asks which sources drove the most conversions.\n- You need a quick conversion + revenue snapshot without picking specific events.\n\nDo not use when:\n- The user needs event-level counts beyond conversions. Use list_events.\n- The user needs a daily key-event time series. Use get_daily_trend and read rows[].key_events.\n- The user needs per-page conversion breakdown. Use list_top_pages and read rows[].key_events.\n\nWorkflow:\n1. Call list_properties if property_id is unknown.\n2. Call this action with property_id, date_start, date_end.\n\nOutput semantics:\n- overview.total_key_events sums property-level key_events for the range.\n- overview.total_revenue_micros is in micros.\n- overview.top_converting_sources has the same row shape as list_traffic_sources, sorted by key_events DESC and capped at 10.\n- Returns zeros and an empty top_converting_sources when the property has no synced data for the range.",
+      "capability_mode": "read",
+      "priority": "primary",
+      "requires_review": false,
+      "freshness_kind": "synced",
+      "input_params": [
+        {
+          "name": "property_id",
+          "type": "string",
+          "required": true,
+          "description": "Property id from list_properties.rows[].property_id. account_id is accepted as an alias.",
+          "example": "123456789"
+        },
+        {
+          "name": "date_start",
+          "type": "string",
+          "required": true,
+          "description": "Inclusive start date in YYYY-MM-DD format.",
+          "example": "2026-05-01"
+        },
+        {
+          "name": "date_end",
+          "type": "string",
+          "required": true,
+          "description": "Inclusive end date in YYYY-MM-DD format.",
+          "example": "2026-05-18"
+        }
+      ],
+      "output_shape": "{\"property\": {\"property_id\": \"123456789\", \"data_freshness\": \"ISO\"}, \"overview\": {\"total_key_events\": N, \"total_revenue_micros\": micros, \"top_converting_sources\": [{\"session_source\": \"...\", \"session_medium\": \"...\", \"session_campaign_name\": \"...\", \"key_events\": N, \"total_revenue_micros\": micros, \"sessions\": N, \"total_users\": N, ...}]}}",
+      "see_also": [
+        "action:ga4/list_properties",
+        "action:ga4/get_daily_trend",
+        "action:ga4/list_traffic_sources",
+        "action:ga4/list_events"
+      ]
+    },
+    {
+      "id": "action:ga4/get_daily_trend",
+      "namespace": "ga4",
+      "action": "get_daily_trend",
+      "description": "Cached GA4 daily KPI time series for a property over a date range; returns one row per day for charting and anomaly detection.",
+      "long_description": "Primary use:\nPer-day GA4 KPI time series for a property.\n\nUse when:\n- The user asks for a daily chart, week-over-week or day-over-day comparison, or anomaly check.\n- You need report_date x property-level metrics ordered by day.\n\nDo not use when:\n- The user needs a single aggregated snapshot. Use get_property_overview.\n- The user needs per-page, per-source, or per-event daily breakdown. This action does not split by dimension.\n- The user wants daily ad spend. Use ads.query_single_dimension with dimension=date.\n\nWorkflow:\n1. Call list_properties if property_id is unknown.\n2. Call this action with property_id, date_start, date_end.\n\nOutput semantics:\n- rows[].report_date is ISO YYYY-MM-DD.\n- rows[].total_revenue_micros is in micros; rows[].bounce_rate is a 0-1 ratio; rows[].avg_session_duration_seconds is in seconds.\n- rows[].key_events replaces legacy 'conversions' (GA4 v5+).\n- Returns [] when the property has no synced data for the range.",
+      "capability_mode": "read",
+      "priority": "primary",
+      "requires_review": false,
+      "freshness_kind": "synced",
+      "input_params": [
+        {
+          "name": "property_id",
+          "type": "string",
+          "required": true,
+          "description": "Property id from list_properties.rows[].property_id. account_id is accepted as an alias.",
+          "example": "123456789"
+        },
+        {
+          "name": "date_start",
+          "type": "string",
+          "required": true,
+          "description": "Inclusive start date in YYYY-MM-DD format.",
+          "example": "2026-05-01"
+        },
+        {
+          "name": "date_end",
+          "type": "string",
+          "required": true,
+          "description": "Inclusive end date in YYYY-MM-DD format.",
+          "example": "2026-05-18"
+        }
+      ],
+      "output_shape": "{\"property\": {\"property_id\": \"123456789\", \"data_freshness\": \"ISO\"}, \"rows\": [{\"report_date\": \"2026-05-01\", \"total_users\": N, \"new_users\": N, \"active_users\": N, \"sessions\": N, \"screen_page_views\": N, \"avg_session_duration_seconds\": seconds, \"bounce_rate\": 0..1, \"events_count\": N, \"key_events\": N, \"total_revenue_micros\": micros, \"currency\": \"USD\"}]}",
+      "see_also": [
+        "action:ga4/list_properties",
+        "action:ga4/get_property_overview",
+        "action:ga4/list_traffic_sources"
+      ]
+    },
+    {
+      "id": "action:ga4/get_property_overview",
+      "namespace": "ga4",
+      "action": "get_property_overview",
+      "description": "Aggregate GA4 KPI snapshot for a property over a date range; returns one overview block with users, sessions, page views, key events, and revenue.",
+      "long_description": "Primary use:\nHeadline KPIs for a GA4 property over a date range, without dimensional breakdown. Use it for a one-shot snapshot answer.\n\nUse when:\n- The user asks for a property-level summary across a window.\n- You need total/new/active users, sessions, page views, key events, or revenue across the period.\n\nDo not use when:\n- The user needs per-page, per-channel, or per-event breakdown. Use list_top_pages, list_traffic_sources, or list_events.\n- The user needs a daily time series. Use get_daily_trend.\n- The user needs CPA / ROAS or ad spend. Use ads.query_single_dimension.\n\nWorkflow:\n1. Call list_properties if property_id is unknown.\n2. Call this action with property_id, date_start, date_end.\n\nOutput semantics:\n- overview.total_revenue_micros is in micros (1 USD = 1_000_000); pair with overview.currency for display.\n- overview.bounce_rate is a 0-1 ratio.\n- overview.avg_session_duration_seconds is in seconds.\n- overview.key_events is the GA4 v5+ replacement for the legacy 'conversions' concept.\n- Returns null overview when the property has no synced data for the range.",
+      "capability_mode": "read",
+      "priority": "primary",
+      "requires_review": false,
+      "freshness_kind": "synced",
+      "input_params": [
+        {
+          "name": "property_id",
+          "type": "string",
+          "required": true,
+          "description": "Property id from list_properties.rows[].property_id. account_id is accepted as an alias.",
+          "example": "123456789"
+        },
+        {
+          "name": "date_start",
+          "type": "string",
+          "required": true,
+          "description": "Inclusive start date in YYYY-MM-DD format.",
+          "example": "2026-05-01"
+        },
+        {
+          "name": "date_end",
+          "type": "string",
+          "required": true,
+          "description": "Inclusive end date in YYYY-MM-DD format.",
+          "example": "2026-05-18"
+        }
+      ],
+      "output_shape": "{\"property\": {\"property_id\": \"123456789\", \"data_freshness\": \"ISO\"}, \"overview\": {\"total_users\": N, \"new_users\": N, \"active_users\": N, \"sessions\": N, \"screen_page_views\": N, \"avg_session_duration_seconds\": seconds, \"bounce_rate\": 0..1, \"events_count\": N, \"key_events\": N, \"total_revenue_micros\": micros, \"currency\": \"USD\"}}",
+      "see_also": [
+        "action:ga4/list_properties",
+        "action:ga4/get_daily_trend",
+        "action:ga4/list_traffic_sources",
+        "action:ga4/list_top_pages"
+      ]
+    },
+    {
+      "id": "action:ga4/list_events",
+      "namespace": "ga4",
+      "action": "list_events",
+      "description": "Cached GA4 event breakdown for a property over a date range; returns rows of event_name with event_count and event_value_micros.",
+      "long_description": "Primary use:\nEvent-level GA4 analytics — not limited to conversion events.\n\nUse when:\n- The user asks about any GA4 event volume (scroll, session_start, add_to_cart, purchase, etc.).\n- You need per-event counts and event value sums for a date range.\n\nDo not use when:\n- The user wants only conversion / key-event totals. Use get_conversion_overview.\n- The user wants per-page or per-source breakdown. Use list_top_pages or list_traffic_sources.\n\nWorkflow:\n1. Call list_properties if property_id is unknown.\n2. Call this action with property_id, date range, and optional event_names filter / limit.\n\nOutput semantics:\n- Default sort is event_count DESC.\n- rows[].event_value_micros sums GA4 event_value in micros; events without value report 0.\n- When event_names is omitted, returns top events ranked by event_count up to limit.\n- Returns [] when the property has no synced event data for the range.",
+      "capability_mode": "read",
+      "priority": "supporting",
+      "requires_review": false,
+      "freshness_kind": "synced",
+      "input_params": [
+        {
+          "name": "property_id",
+          "type": "string",
+          "required": true,
+          "description": "Property id from list_properties.rows[].property_id. account_id is accepted as an alias.",
+          "example": "123456789"
+        },
+        {
+          "name": "date_start",
+          "type": "string",
+          "required": true,
+          "description": "Inclusive start date in YYYY-MM-DD format.",
+          "example": "2026-05-01"
+        },
+        {
+          "name": "date_end",
+          "type": "string",
+          "required": true,
+          "description": "Inclusive end date in YYYY-MM-DD format.",
+          "example": "2026-05-18"
+        },
+        {
+          "name": "event_names",
+          "type": "list",
+          "required": false,
+          "description": "GA4 event_name slugs to filter (string list). Omit to list all events ranked by count. Empty/falsy entries are ignored.",
+          "example": [
+            "purchase",
+            "add_to_cart"
+          ]
+        },
+        {
+          "name": "limit",
+          "type": "integer",
+          "required": false,
+          "description": "Row cap. Default 100, hard cap 500. page_size accepted as an alias."
+        }
+      ],
+      "output_shape": "{\"property\": {\"property_id\": \"123456789\", \"data_freshness\": \"ISO\"}, \"rows\": [{\"event_name\": \"page_view\", \"event_count\": N, \"event_value_micros\": micros}]}",
+      "see_also": [
+        "action:ga4/list_properties",
+        "action:ga4/get_conversion_overview",
+        "action:ga4/list_metrics"
+      ]
+    },
+    {
+      "id": "action:ga4/list_metrics",
+      "namespace": "ga4",
+      "action": "list_metrics",
+      "description": "Discover GA4 metric slugs, units, and formulas from the Metric Registry before reading them as field names in other ga4.* outputs.",
+      "long_description": "Primary use:\nMetric Registry discovery filtered to source=ga4. Same registry as the metrics block in ads.list_dimensions, but scoped to GA4 metrics only.\n\nUse when:\n- You are unsure which metric slug, unit, or formula a GA4 field uses.\n- You need to map a metric slug to its dependency chain or platform support.\n\nDo not use when:\n- You need a queryable dimension list. ga4 has no list_dimensions equivalent; other ga4.* actions return fixed column sets.\n- You need ads-side metric semantics. Use ads.list_dimensions.\n\nWorkflow:\n1. Call this action.\n2. Match returned slugs to columns in get_property_overview, get_daily_trend, list_top_pages, list_traffic_sources, or list_events output.\n\nOutput semantics:\n- rows[].slug is the canonical metric name (e.g. engagement_rate, total_users).\n- rows[].unit is the metric unit class (ratio, micros, seconds, count).\n- rows[].available_on lists the platforms exposing this metric; for source=ga4 it always includes 'ga4'.\n- This is metadata; no property_id or date range needed and no data is queried.",
+      "capability_mode": "read",
+      "priority": "supporting",
+      "requires_review": false,
+      "freshness_kind": "synced",
+      "input_params": [],
+      "output_shape": "{\"rows\": [{\"slug\": \"engagement_rate\", \"formula\": \"engaged_sessions / sessions\", \"unit\": \"ratio\", \"depends_on\": [...], \"platform_support\": [\"ga4\"], \"available_on\": [\"ga4\"], \"source\": \"ga4\", \"description\": \"...\"}]}",
+      "see_also": [
+        "action:ga4/get_property_overview",
+        "action:ga4/get_daily_trend",
+        "action:ga4/list_events"
+      ]
+    },
+    {
+      "id": "action:ga4/list_properties",
+      "namespace": "ga4",
+      "action": "list_properties",
+      "description": "Discover org-bound GA4 properties; returns property_id values required by every other ga4.* action.",
+      "long_description": "Primary use:\nProperty discovery for the current organization. Use the returned property_id values as the only valid property_id inputs for later ga4.* analytics calls.\n\nUse when:\n- The user did not provide a property_id.\n- The user asks which GA4 properties are available.\n- You need to choose a GA4 property before querying overviews, trends, pages, sources, or events.\n\nDo not use when:\n- You already have a property_id from this response in the same workflow.\n- You need ad accounts. Use ads.list_ad_accounts instead.\n\nWorkflow:\n1. Call this action.\n2. Pick one row's property_id.\n3. Reuse that property_id (alias account_id is accepted) in any later ga4.* call.\n\nOutput semantics:\n- rows[].property_id is the external GA4 property id expected by later calls.\n- rows[].data_freshness is the latest completed GA4 sync run finish time; null when never synced.\n\nConstraints:\n- Rows are scoped to the caller's organization via the org-level GA4 binding; ResourceBrandGrant is not applied here.\n- A property absent from this response is not queryable by other ga4 actions.",
+      "capability_mode": "read",
+      "priority": "advanced",
+      "requires_review": false,
+      "freshness_kind": "synced",
+      "input_params": [
+        {
+          "name": "limit",
+          "type": "integer",
+          "required": false,
+          "description": "Max rows. Default 100, hard cap 500. page_size accepted as an alias."
+        }
+      ],
+      "output_shape": "{\"rows\": [{\"property_id\": \"123456789\", \"property_name\": \"Main Web Property\", \"status\": \"active\", \"currency_code\": \"USD\", \"timezone\": \"America/Los_Angeles\", \"data_freshness\": \"ISO\"}]}",
+      "see_also": [
+        "action:ga4/get_property_overview",
+        "action:ga4/get_daily_trend",
+        "action:ga4/list_metrics"
+      ]
+    },
+    {
+      "id": "action:ga4/list_top_pages",
+      "namespace": "ga4",
+      "action": "list_top_pages",
+      "description": "Cached GA4 top-page ranking for a date range; returns rows of page_path/page_title with views, users, engagement, and key events.",
+      "long_description": "Primary use:\nPage-level ranking over a property's synced GA4 data.\n\nUse when:\n- The user asks for most-viewed pages, top landing pages, or best-performing content.\n- You need page_path x per-page metrics for a date range.\n\nDo not use when:\n- The user needs a per-page time series. This action does not split by day.\n- The user needs traffic source breakdown. Use list_traffic_sources.\n- The user needs event-level breakdown. Use list_events.\n\nWorkflow:\n1. Call list_properties if property_id is unknown.\n2. Call this action with property_id, date range, and optional sort_by / limit.\n\nOutput semantics:\n- Default sort is screen_page_views DESC.\n- rows[].bounce_rate is a 0-1 ratio; rows[].avg_session_duration_seconds is in seconds.\n- rows[].key_events is page-level conversion count (GA4 v5+ naming).\n- Returns [] when the property has no synced page data for the range.",
+      "capability_mode": "read",
+      "priority": "primary",
+      "requires_review": false,
+      "freshness_kind": "synced",
+      "input_params": [
+        {
+          "name": "property_id",
+          "type": "string",
+          "required": true,
+          "description": "Property id from list_properties.rows[].property_id. account_id is accepted as an alias.",
+          "example": "123456789"
+        },
+        {
+          "name": "date_start",
+          "type": "string",
+          "required": true,
+          "description": "Inclusive start date in YYYY-MM-DD format.",
+          "example": "2026-05-01"
+        },
+        {
+          "name": "date_end",
+          "type": "string",
+          "required": true,
+          "description": "Inclusive end date in YYYY-MM-DD format.",
+          "example": "2026-05-18"
+        },
+        {
+          "name": "limit",
+          "type": "integer",
+          "required": false,
+          "description": "Row cap. Default 20, hard cap 500. page_size accepted as an alias."
+        },
+        {
+          "name": "sort_by",
+          "type": "string",
+          "required": false,
+          "description": "Sort metric. One of screen_page_views (default), total_users, avg_session_duration_seconds, bounce_rate, key_events. Unknown values fall back to screen_page_views.",
+          "example": "total_users"
+        }
+      ],
+      "output_shape": "{\"property\": {\"property_id\": \"123456789\", \"data_freshness\": \"ISO\"}, \"rows\": [{\"page_path\": \"/products/x\", \"page_title\": \"...\", \"screen_page_views\": N, \"total_users\": N, \"avg_session_duration_seconds\": seconds, \"bounce_rate\": 0..1, \"key_events\": N}]}",
+      "see_also": [
+        "action:ga4/list_properties",
+        "action:ga4/get_property_overview",
+        "action:ga4/list_traffic_sources",
+        "action:ga4/list_events"
+      ]
+    },
+    {
+      "id": "action:ga4/list_traffic_sources",
+      "namespace": "ga4",
+      "action": "list_traffic_sources",
+      "description": "Cached GA4 traffic source ranking for a date range; returns rows of session_source/medium/campaign with users, sessions, page views, and revenue.",
+      "long_description": "Primary use:\nAcquisition breakdown across session_source x session_medium x session_campaign_name.\n\nUse when:\n- The user asks where traffic comes from, top channels, organic vs paid, or campaign-level acquisition.\n- You need session-level acquisition metrics for a date range.\n\nDo not use when:\n- The user needs page-level data. Use list_top_pages and join client-side.\n- The user needs event-level data. Use list_events.\n- The user needs ad spend, CPA, or ROAS. Use ads.query_single_dimension.\n\nWorkflow:\n1. Call list_properties if property_id is unknown.\n2. Call this action with property_id, date range, and optional sort_by / limit.\n\nOutput semantics:\n- Default sort is sessions DESC.\n- rows[].total_revenue_micros is in micros; rows[].bounce_rate is a 0-1 ratio; rows[].avg_session_duration_seconds is in seconds.\n- rows[].key_events replaces legacy 'conversions' (GA4 v5+).\n- Returns [] when the property has no synced source data for the range.",
+      "capability_mode": "read",
+      "priority": "primary",
+      "requires_review": false,
+      "freshness_kind": "synced",
+      "input_params": [
+        {
+          "name": "property_id",
+          "type": "string",
+          "required": true,
+          "description": "Property id from list_properties.rows[].property_id. account_id is accepted as an alias.",
+          "example": "123456789"
+        },
+        {
+          "name": "date_start",
+          "type": "string",
+          "required": true,
+          "description": "Inclusive start date in YYYY-MM-DD format.",
+          "example": "2026-05-01"
+        },
+        {
+          "name": "date_end",
+          "type": "string",
+          "required": true,
+          "description": "Inclusive end date in YYYY-MM-DD format.",
+          "example": "2026-05-18"
+        },
+        {
+          "name": "limit",
+          "type": "integer",
+          "required": false,
+          "description": "Row cap. Default 20, hard cap 500. page_size accepted as an alias."
+        },
+        {
+          "name": "sort_by",
+          "type": "string",
+          "required": false,
+          "description": "Sort metric. One of sessions (default), total_users, new_users, screen_page_views, bounce_rate, avg_session_duration_seconds, key_events, total_revenue_micros. Unknown values fall back to sessions.",
+          "example": "key_events"
+        }
+      ],
+      "output_shape": "{\"property\": {\"property_id\": \"123456789\", \"data_freshness\": \"ISO\"}, \"rows\": [{\"session_source\": \"google\", \"session_medium\": \"organic\", \"session_campaign_name\": \"...\", \"total_users\": N, \"new_users\": N, \"sessions\": N, \"screen_page_views\": N, \"bounce_rate\": 0..1, \"avg_session_duration_seconds\": seconds, \"key_events\": N, \"total_revenue_micros\": micros}]}",
+      "see_also": [
+        "action:ga4/list_properties",
+        "action:ga4/list_top_pages",
+        "action:ga4/get_daily_trend",
+        "action:ga4/get_conversion_overview"
+      ]
+    }
+  ]
+}