@cloudcart/dev-mcp 0.2.18 → 0.2.19

package/data/admin.json

@@ -13033,6 +13033,58 @@
               "isDeprecated": false,
               "deprecationReason": null
             },
+            {
+              "name": "executiveInsights",
+              "description": "Executive insights for the store dashboard — health score + summary,\nmonth-over-month trends (revenue / orders / AOV / new customers), predictive\nalerts, top products and stuck orders. Returns { \"enabled\": false } when the\n`smart_daily_actions` plan feature is off. Cached ~20 minutes.\n\nReturned as JSON; shape:\n{ enabled, health: { score, summary }, trends: { revenue|orders|aov|new_customers: { this, last, change } },\n  alerts: [{ type, icon, color, title, detail, route }], top_products: [{ id, name, units, revenue }],\n  stuck_orders: { count, orders: [{ id, date_added, total }] } }",
+              "args": [],
+              "type": {
+                "kind": "SCALAR",
+                "name": "JSON",
+                "ofType": null
+              },
+              "isDeprecated": false,
+              "deprecationReason": null
+            },
+            {
+              "name": "executiveInsightsTeaser",
+              "description": "Lightweight insights teaser (store health score + open-alert count) for\ndashboard widgets. Values are null until the background warm-up has run.",
+              "args": [],
+              "type": {
+                "kind": "NON_NULL",
+                "name": null,
+                "ofType": {
+                  "kind": "OBJECT",
+                  "name": "ExecutiveInsightsTeaser",
+                  "ofType": null
+                }
+              },
+              "isDeprecated": false,
+              "deprecationReason": null
+            },
+            {
+              "name": "smartActionRecommendations",
+              "description": "Daily smart-action recommendations for the dashboard. Returns\n{ subscribed, actions: [...] } where each action has type, title, why,\nexpected_effect and an execute_route. One action when unsubscribed, up to\nthree when the `smart_daily_actions` feature is enabled. Dismissed actions\nare hidden for the rest of the day.\n\nReturned as JSON; each action: { type, entity_id, title, why, expected_effect, execute_route: { name, query } }.",
+              "args": [],
+              "type": {
+                "kind": "SCALAR",
+                "name": "JSON",
+                "ofType": null
+              },
+              "isDeprecated": false,
+              "deprecationReason": null
+            },
+            {
+              "name": "smartActionHistory",
+              "description": "History of the last 20 smart actions the merchant executed or dismissed.\nReturns { history: [{ id, action_type, entity_id, entity_title, status,\nexpected_effect, execute_route, created_at }] }. Empty when the\n`smart_daily_actions` feature is off.",
+              "args": [],
+              "type": {
+                "kind": "SCALAR",
+                "name": "JSON",
+                "ofType": null
+              },
+              "isDeprecated": false,
+              "deprecationReason": null
+            },
             {
               "name": "adScoutSettings",
               "description": "Get AdScout settings and credential validation status.",
@@ -41285,6 +41337,39 @@
               "isDeprecated": false,
               "deprecationReason": null
             },
+            {
+              "name": "recordSmartAction",
+              "description": "Record a smart-action decision (executed or dismissed) — mirrors the\ndashboard's smart-actions/act endpoint. Recording DISMISSED hides that\nrecommendation for the rest of the day; EXECUTED logs it to history.\n\nThis does NOT perform the underlying change itself — the client follows the\nrecommendation's executeRoute to do that, then records the outcome here.",
+              "args": [
+                {
+                  "name": "input",
+                  "description": "The decision to record, built from a smartActionRecommendations item.",
+                  "type": {
+                    "kind": "NON_NULL",
+                    "name": null,
+                    "ofType": {
+                      "kind": "INPUT_OBJECT",
+                      "name": "RecordSmartActionInput",
+                      "ofType": null
+                    }
+                  },
+                  "defaultValue": null,
+                  "isDeprecated": false,
+                  "deprecationReason": null
+                }
+              ],
+              "type": {
+                "kind": "NON_NULL",
+                "name": null,
+                "ofType": {
+                  "kind": "OBJECT",
+                  "name": "RecordSmartActionResult",
+                  "ofType": null
+                }
+              },
+              "isDeprecated": false,
+              "deprecationReason": null
+            },
             {
               "name": "saveAdScoutSettings",
               "description": "Save AdScout settings.",
@@ -119663,6 +119748,280 @@
           "enumValues": null,
           "possibleTypes": null
         },
+        {
+          "kind": "OBJECT",
+          "name": "ExecutiveInsightsTeaser",
+          "description": "Lightweight dashboard insights teaser — store health score and open-alert count.",
+          "isOneOf": null,
+          "fields": [
+            {
+              "name": "score",
+              "description": "Store health score 0–100, or null if not yet computed (warming in background).",
+              "args": [],
+              "type": {
+                "kind": "SCALAR",
+                "name": "Int",
+                "ofType": null
+              },
+              "isDeprecated": false,
+              "deprecationReason": null
+            },
+            {
+              "name": "alertsCount",
+              "description": "Number of open predictive alerts, or null if not yet computed.",
+              "args": [],
+              "type": {
+                "kind": "SCALAR",
+                "name": "Int",
+                "ofType": null
+              },
+              "isDeprecated": false,
+              "deprecationReason": null
+            }
+          ],
+          "inputFields": null,
+          "interfaces": [],
+          "enumValues": null,
+          "possibleTypes": null
+        },
+        {
+          "kind": "OBJECT",
+          "name": "RecordSmartActionResult",
+          "description": "Result of recording a smart-action decision.",
+          "isOneOf": null,
+          "fields": [
+            {
+              "name": "success",
+              "description": "True when the decision was recorded.",
+              "args": [],
+              "type": {
+                "kind": "NON_NULL",
+                "name": null,
+                "ofType": {
+                  "kind": "SCALAR",
+                  "name": "Boolean",
+                  "ofType": null
+                }
+              },
+              "isDeprecated": false,
+              "deprecationReason": null
+            },
+            {
+              "name": "error",
+              "description": "Error message when success is false (e.g. validation).",
+              "args": [],
+              "type": {
+                "kind": "SCALAR",
+                "name": "String",
+                "ofType": null
+              },
+              "isDeprecated": false,
+              "deprecationReason": null
+            }
+          ],
+          "inputFields": null,
+          "interfaces": [],
+          "enumValues": null,
+          "possibleTypes": null
+        },
+        {
+          "kind": "ENUM",
+          "name": "SmartActionType",
+          "description": "Type of smart action — use the `type` field of a smartActionRecommendations item.",
+          "isOneOf": null,
+          "fields": null,
+          "inputFields": null,
+          "interfaces": null,
+          "enumValues": [
+            {
+              "name": "RESTOCK",
+              "description": null,
+              "isDeprecated": false,
+              "deprecationReason": null
+            },
+            {
+              "name": "PAUSE_CAMPAIGN",
+              "description": null,
+              "isDeprecated": false,
+              "deprecationReason": null
+            },
+            {
+              "name": "CREATE_BUNDLE",
+              "description": null,
+              "isDeprecated": false,
+              "deprecationReason": null
+            },
+            {
+              "name": "FOLLOW_UP_ABANDONED",
+              "description": null,
+              "isDeprecated": false,
+              "deprecationReason": null
+            },
+            {
+              "name": "ACTIVATE_DISCOUNT",
+              "description": null,
+              "isDeprecated": false,
+              "deprecationReason": null
+            },
+            {
+              "name": "SEND_WINBACK",
+              "description": null,
+              "isDeprecated": false,
+              "deprecationReason": null
+            },
+            {
+              "name": "LOW_RATING_PRODUCT",
+              "description": null,
+              "isDeprecated": false,
+              "deprecationReason": null
+            },
+            {
+              "name": "UPSELL_OPPORTUNITY",
+              "description": null,
+              "isDeprecated": false,
+              "deprecationReason": null
+            },
+            {
+              "name": "ENABLE_CROSS_SELL",
+              "description": null,
+              "isDeprecated": false,
+              "deprecationReason": null
+            },
+            {
+              "name": "REACTIVATE_SEGMENT",
+              "description": null,
+              "isDeprecated": false,
+              "deprecationReason": null
+            },
+            {
+              "name": "PRICE_DROP_ALERT",
+              "description": null,
+              "isDeprecated": false,
+              "deprecationReason": null
+            }
+          ],
+          "possibleTypes": null
+        },
+        {
+          "kind": "ENUM",
+          "name": "SmartActionStatus",
+          "description": "Outcome recorded for a smart action.",
+          "isOneOf": null,
+          "fields": null,
+          "inputFields": null,
+          "interfaces": null,
+          "enumValues": [
+            {
+              "name": "EXECUTED",
+              "description": null,
+              "isDeprecated": false,
+              "deprecationReason": null
+            },
+            {
+              "name": "DISMISSED",
+              "description": null,
+              "isDeprecated": false,
+              "deprecationReason": null
+            }
+          ],
+          "possibleTypes": null
+        },
+        {
+          "kind": "INPUT_OBJECT",
+          "name": "RecordSmartActionInput",
+          "description": "Input for recordSmartAction — typically built from a smartActionRecommendations\nitem: copy its `type` → actionType, `entity_id` → entityId, plus the merchant's\nEXECUTED/DISMISSED decision.",
+          "isOneOf": false,
+          "fields": null,
+          "inputFields": [
+            {
+              "name": "actionType",
+              "description": "Action type (the recommendation's `type`).",
+              "type": {
+                "kind": "NON_NULL",
+                "name": null,
+                "ofType": {
+                  "kind": "ENUM",
+                  "name": "SmartActionType",
+                  "ofType": null
+                }
+              },
+              "defaultValue": null,
+              "isDeprecated": false,
+              "deprecationReason": null
+            },
+            {
+              "name": "entityId",
+              "description": "ID of the entity the action targets (product, campaign, segment, ...).",
+              "type": {
+                "kind": "NON_NULL",
+                "name": null,
+                "ofType": {
+                  "kind": "SCALAR",
+                  "name": "Int",
+                  "ofType": null
+                }
+              },
+              "defaultValue": null,
+              "isDeprecated": false,
+              "deprecationReason": null
+            },
+            {
+              "name": "status",
+              "description": "Whether the merchant executed or dismissed the action.",
+              "type": {
+                "kind": "NON_NULL",
+                "name": null,
+                "ofType": {
+                  "kind": "ENUM",
+                  "name": "SmartActionStatus",
+                  "ofType": null
+                }
+              },
+              "defaultValue": null,
+              "isDeprecated": false,
+              "deprecationReason": null
+            },
+            {
+              "name": "entityTitle",
+              "description": "Optional human label of the entity.",
+              "type": {
+                "kind": "SCALAR",
+                "name": "String",
+                "ofType": null
+              },
+              "defaultValue": null,
+              "isDeprecated": false,
+              "deprecationReason": null
+            },
+            {
+              "name": "expectedEffect",
+              "description": "Optional expected-effect text carried from the recommendation.",
+              "type": {
+                "kind": "SCALAR",
+                "name": "String",
+                "ofType": null
+              },
+              "defaultValue": null,
+              "isDeprecated": false,
+              "deprecationReason": null
+            },
+            {
+              "name": "executeRoute",
+              "description": "Optional admin route descriptor carried from the recommendation (e.g. {name, query}).",
+              "type": {
+                "kind": "SCALAR",
+                "name": "JSON",
+                "ofType": null
+              },
+              "defaultValue": null,
+              "isDeprecated": false,
+              "deprecationReason": null
+            }
+          ],
+          "interfaces": null,
+          "enumValues": null,
+          "possibleTypes": null
+        },
         {
           "kind": "ENUM",
           "name": "XmlFeedGeneratorFilter",