@cloudcart/dev-mcp 0.2.18 → 0.2.20

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/data/admin.json CHANGED
@@ -6915,6 +6915,22 @@
6915
6915
  "isDeprecated": false,
6916
6916
  "deprecationReason": null
6917
6917
  },
6918
+ {
6919
+ "name": "storageQuota",
6920
+ "description": "Disk-space quota for the store: plan storage limit, current usage and\nremaining space (mirrors the admin file-manager \"used / total\" indicator).\nBacked by Plan::storageRemaining() — plan feature `storage`, in GB.",
6921
+ "args": [],
6922
+ "type": {
6923
+ "kind": "NON_NULL",
6924
+ "name": null,
6925
+ "ofType": {
6926
+ "kind": "OBJECT",
6927
+ "name": "StorageQuota",
6928
+ "ofType": null
6929
+ }
6930
+ },
6931
+ "isDeprecated": false,
6932
+ "deprecationReason": null
6933
+ },
6918
6934
  {
6919
6935
  "name": "queueJobs",
6920
6936
  "description": "Get a paginated list of queue jobs.",
@@ -12309,6 +12325,35 @@
12309
12325
  "isDeprecated": false,
12310
12326
  "deprecationReason": null
12311
12327
  },
12328
+ {
12329
+ "name": "csvImportTask",
12330
+ "description": "Get a saved CSV import task's full detail — the same data shown on the admin\ncsv_import/task/{id} page: status, counts, settings, the field->column\n`mapping`, and `mapping_sample` (the file's first row keyed by column index —\njoin mapping[field] -> mapping_sample[column] to get each field's sample\nvalue), plus a sample of failed records and live progress.",
12331
+ "args": [
12332
+ {
12333
+ "name": "id",
12334
+ "description": "CSV import task ID.",
12335
+ "type": {
12336
+ "kind": "NON_NULL",
12337
+ "name": null,
12338
+ "ofType": {
12339
+ "kind": "SCALAR",
12340
+ "name": "ID",
12341
+ "ofType": null
12342
+ }
12343
+ },
12344
+ "defaultValue": null,
12345
+ "isDeprecated": false,
12346
+ "deprecationReason": null
12347
+ }
12348
+ ],
12349
+ "type": {
12350
+ "kind": "SCALAR",
12351
+ "name": "JSON",
12352
+ "ofType": null
12353
+ },
12354
+ "isDeprecated": false,
12355
+ "deprecationReason": null
12356
+ },
12312
12357
  {
12313
12358
  "name": "csvImportPreview",
12314
12359
  "description": "Preview the first row of an uploaded CSV file.\nReturns column indices mapped to cell values — use these indices to build the mapping for `csvImportStart`.",
@@ -13033,6 +13078,58 @@
13033
13078
  "isDeprecated": false,
13034
13079
  "deprecationReason": null
13035
13080
  },
13081
+ {
13082
+ "name": "executiveInsights",
13083
+ "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 }] } }",
13084
+ "args": [],
13085
+ "type": {
13086
+ "kind": "SCALAR",
13087
+ "name": "JSON",
13088
+ "ofType": null
13089
+ },
13090
+ "isDeprecated": false,
13091
+ "deprecationReason": null
13092
+ },
13093
+ {
13094
+ "name": "executiveInsightsTeaser",
13095
+ "description": "Lightweight insights teaser (store health score + open-alert count) for\ndashboard widgets. Values are null until the background warm-up has run.",
13096
+ "args": [],
13097
+ "type": {
13098
+ "kind": "NON_NULL",
13099
+ "name": null,
13100
+ "ofType": {
13101
+ "kind": "OBJECT",
13102
+ "name": "ExecutiveInsightsTeaser",
13103
+ "ofType": null
13104
+ }
13105
+ },
13106
+ "isDeprecated": false,
13107
+ "deprecationReason": null
13108
+ },
13109
+ {
13110
+ "name": "smartActionRecommendations",
13111
+ "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 } }.",
13112
+ "args": [],
13113
+ "type": {
13114
+ "kind": "SCALAR",
13115
+ "name": "JSON",
13116
+ "ofType": null
13117
+ },
13118
+ "isDeprecated": false,
13119
+ "deprecationReason": null
13120
+ },
13121
+ {
13122
+ "name": "smartActionHistory",
13123
+ "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.",
13124
+ "args": [],
13125
+ "type": {
13126
+ "kind": "SCALAR",
13127
+ "name": "JSON",
13128
+ "ofType": null
13129
+ },
13130
+ "isDeprecated": false,
13131
+ "deprecationReason": null
13132
+ },
13036
13133
  {
13037
13134
  "name": "adScoutSettings",
13038
13135
  "description": "Get AdScout settings and credential validation status.",
@@ -32746,6 +32843,51 @@
32746
32843
  "isDeprecated": false,
32747
32844
  "deprecationReason": null
32748
32845
  },
32846
+ {
32847
+ "name": "uploadManagedFile",
32848
+ "description": "Upload a file to the media library. Provide the raw bytes base64-encoded in\n`contentBase64` and the target `filename`. Single-shot upload (the admin's\nchunked S3 path is for very large files). Returns the created file record\n({ id, name, url, size, dir, created_at, ... }), or { error } on failure.",
32849
+ "args": [
32850
+ {
32851
+ "name": "filename",
32852
+ "description": "Target file name (with extension), e.g. \"banner.png\".",
32853
+ "type": {
32854
+ "kind": "NON_NULL",
32855
+ "name": null,
32856
+ "ofType": {
32857
+ "kind": "SCALAR",
32858
+ "name": "String",
32859
+ "ofType": null
32860
+ }
32861
+ },
32862
+ "defaultValue": null,
32863
+ "isDeprecated": false,
32864
+ "deprecationReason": null
32865
+ },
32866
+ {
32867
+ "name": "contentBase64",
32868
+ "description": "File bytes, base64-encoded.",
32869
+ "type": {
32870
+ "kind": "NON_NULL",
32871
+ "name": null,
32872
+ "ofType": {
32873
+ "kind": "SCALAR",
32874
+ "name": "String",
32875
+ "ofType": null
32876
+ }
32877
+ },
32878
+ "defaultValue": null,
32879
+ "isDeprecated": false,
32880
+ "deprecationReason": null
32881
+ }
32882
+ ],
32883
+ "type": {
32884
+ "kind": "SCALAR",
32885
+ "name": "JSON",
32886
+ "ofType": null
32887
+ },
32888
+ "isDeprecated": false,
32889
+ "deprecationReason": null
32890
+ },
32749
32891
  {
32750
32892
  "name": "createStaffMember",
32751
32893
  "description": "Create a new staff member (always created as moderator). Sends welcome email.",
@@ -41285,6 +41427,39 @@
41285
41427
  "isDeprecated": false,
41286
41428
  "deprecationReason": null
41287
41429
  },
41430
+ {
41431
+ "name": "recordSmartAction",
41432
+ "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.",
41433
+ "args": [
41434
+ {
41435
+ "name": "input",
41436
+ "description": "The decision to record, built from a smartActionRecommendations item.",
41437
+ "type": {
41438
+ "kind": "NON_NULL",
41439
+ "name": null,
41440
+ "ofType": {
41441
+ "kind": "INPUT_OBJECT",
41442
+ "name": "RecordSmartActionInput",
41443
+ "ofType": null
41444
+ }
41445
+ },
41446
+ "defaultValue": null,
41447
+ "isDeprecated": false,
41448
+ "deprecationReason": null
41449
+ }
41450
+ ],
41451
+ "type": {
41452
+ "kind": "NON_NULL",
41453
+ "name": null,
41454
+ "ofType": {
41455
+ "kind": "OBJECT",
41456
+ "name": "RecordSmartActionResult",
41457
+ "ofType": null
41458
+ }
41459
+ },
41460
+ "isDeprecated": false,
41461
+ "deprecationReason": null
41462
+ },
41288
41463
  {
41289
41464
  "name": "saveAdScoutSettings",
41290
41465
  "description": "Save AdScout settings.",
@@ -97033,6 +97208,174 @@
97033
97208
  "enumValues": null,
97034
97209
  "possibleTypes": null
97035
97210
  },
97211
+ {
97212
+ "kind": "OBJECT",
97213
+ "name": "StorageQuota",
97214
+ "description": "Disk-space quota for the store — plan storage limit, current usage and remaining space.",
97215
+ "isOneOf": null,
97216
+ "fields": [
97217
+ {
97218
+ "name": "limitGb",
97219
+ "description": "Plan storage quota in GB (the `storage` plan feature).",
97220
+ "args": [],
97221
+ "type": {
97222
+ "kind": "SCALAR",
97223
+ "name": "Float",
97224
+ "ofType": null
97225
+ },
97226
+ "isDeprecated": false,
97227
+ "deprecationReason": null
97228
+ },
97229
+ {
97230
+ "name": "used",
97231
+ "description": "Used space, in bytes.",
97232
+ "args": [],
97233
+ "type": {
97234
+ "kind": "NON_NULL",
97235
+ "name": null,
97236
+ "ofType": {
97237
+ "kind": "SCALAR",
97238
+ "name": "Float",
97239
+ "ofType": null
97240
+ }
97241
+ },
97242
+ "isDeprecated": false,
97243
+ "deprecationReason": null
97244
+ },
97245
+ {
97246
+ "name": "usedFormatted",
97247
+ "description": "Used space, human-readable (e.g. \"2.3 GB\").",
97248
+ "args": [],
97249
+ "type": {
97250
+ "kind": "NON_NULL",
97251
+ "name": null,
97252
+ "ofType": {
97253
+ "kind": "SCALAR",
97254
+ "name": "String",
97255
+ "ofType": null
97256
+ }
97257
+ },
97258
+ "isDeprecated": false,
97259
+ "deprecationReason": null
97260
+ },
97261
+ {
97262
+ "name": "usedPercent",
97263
+ "description": "Percent of the quota currently used (0–100).",
97264
+ "args": [],
97265
+ "type": {
97266
+ "kind": "NON_NULL",
97267
+ "name": null,
97268
+ "ofType": {
97269
+ "kind": "SCALAR",
97270
+ "name": "Float",
97271
+ "ofType": null
97272
+ }
97273
+ },
97274
+ "isDeprecated": false,
97275
+ "deprecationReason": null
97276
+ },
97277
+ {
97278
+ "name": "total",
97279
+ "description": "Total quota, in bytes.",
97280
+ "args": [],
97281
+ "type": {
97282
+ "kind": "NON_NULL",
97283
+ "name": null,
97284
+ "ofType": {
97285
+ "kind": "SCALAR",
97286
+ "name": "Float",
97287
+ "ofType": null
97288
+ }
97289
+ },
97290
+ "isDeprecated": false,
97291
+ "deprecationReason": null
97292
+ },
97293
+ {
97294
+ "name": "totalFormatted",
97295
+ "description": "Total quota, human-readable.",
97296
+ "args": [],
97297
+ "type": {
97298
+ "kind": "NON_NULL",
97299
+ "name": null,
97300
+ "ofType": {
97301
+ "kind": "SCALAR",
97302
+ "name": "String",
97303
+ "ofType": null
97304
+ }
97305
+ },
97306
+ "isDeprecated": false,
97307
+ "deprecationReason": null
97308
+ },
97309
+ {
97310
+ "name": "remaining",
97311
+ "description": "Remaining space, in bytes (negative if over quota).",
97312
+ "args": [],
97313
+ "type": {
97314
+ "kind": "NON_NULL",
97315
+ "name": null,
97316
+ "ofType": {
97317
+ "kind": "SCALAR",
97318
+ "name": "Float",
97319
+ "ofType": null
97320
+ }
97321
+ },
97322
+ "isDeprecated": false,
97323
+ "deprecationReason": null
97324
+ },
97325
+ {
97326
+ "name": "remainingFormatted",
97327
+ "description": "Remaining space, human-readable.",
97328
+ "args": [],
97329
+ "type": {
97330
+ "kind": "NON_NULL",
97331
+ "name": null,
97332
+ "ofType": {
97333
+ "kind": "SCALAR",
97334
+ "name": "String",
97335
+ "ofType": null
97336
+ }
97337
+ },
97338
+ "isDeprecated": false,
97339
+ "deprecationReason": null
97340
+ },
97341
+ {
97342
+ "name": "fileCount",
97343
+ "description": "Number of stored files.",
97344
+ "args": [],
97345
+ "type": {
97346
+ "kind": "NON_NULL",
97347
+ "name": null,
97348
+ "ofType": {
97349
+ "kind": "SCALAR",
97350
+ "name": "Int",
97351
+ "ofType": null
97352
+ }
97353
+ },
97354
+ "isDeprecated": false,
97355
+ "deprecationReason": null
97356
+ },
97357
+ {
97358
+ "name": "dirCount",
97359
+ "description": "Number of directories (currently always 0).",
97360
+ "args": [],
97361
+ "type": {
97362
+ "kind": "NON_NULL",
97363
+ "name": null,
97364
+ "ofType": {
97365
+ "kind": "SCALAR",
97366
+ "name": "Int",
97367
+ "ofType": null
97368
+ }
97369
+ },
97370
+ "isDeprecated": false,
97371
+ "deprecationReason": null
97372
+ }
97373
+ ],
97374
+ "inputFields": null,
97375
+ "interfaces": [],
97376
+ "enumValues": null,
97377
+ "possibleTypes": null
97378
+ },
97036
97379
  {
97037
97380
  "kind": "OBJECT",
97038
97381
  "name": "QueueJob",
@@ -119663,6 +120006,280 @@
119663
120006
  "enumValues": null,
119664
120007
  "possibleTypes": null
119665
120008
  },
120009
+ {
120010
+ "kind": "OBJECT",
120011
+ "name": "ExecutiveInsightsTeaser",
120012
+ "description": "Lightweight dashboard insights teaser — store health score and open-alert count.",
120013
+ "isOneOf": null,
120014
+ "fields": [
120015
+ {
120016
+ "name": "score",
120017
+ "description": "Store health score 0–100, or null if not yet computed (warming in background).",
120018
+ "args": [],
120019
+ "type": {
120020
+ "kind": "SCALAR",
120021
+ "name": "Int",
120022
+ "ofType": null
120023
+ },
120024
+ "isDeprecated": false,
120025
+ "deprecationReason": null
120026
+ },
120027
+ {
120028
+ "name": "alertsCount",
120029
+ "description": "Number of open predictive alerts, or null if not yet computed.",
120030
+ "args": [],
120031
+ "type": {
120032
+ "kind": "SCALAR",
120033
+ "name": "Int",
120034
+ "ofType": null
120035
+ },
120036
+ "isDeprecated": false,
120037
+ "deprecationReason": null
120038
+ }
120039
+ ],
120040
+ "inputFields": null,
120041
+ "interfaces": [],
120042
+ "enumValues": null,
120043
+ "possibleTypes": null
120044
+ },
120045
+ {
120046
+ "kind": "OBJECT",
120047
+ "name": "RecordSmartActionResult",
120048
+ "description": "Result of recording a smart-action decision.",
120049
+ "isOneOf": null,
120050
+ "fields": [
120051
+ {
120052
+ "name": "success",
120053
+ "description": "True when the decision was recorded.",
120054
+ "args": [],
120055
+ "type": {
120056
+ "kind": "NON_NULL",
120057
+ "name": null,
120058
+ "ofType": {
120059
+ "kind": "SCALAR",
120060
+ "name": "Boolean",
120061
+ "ofType": null
120062
+ }
120063
+ },
120064
+ "isDeprecated": false,
120065
+ "deprecationReason": null
120066
+ },
120067
+ {
120068
+ "name": "error",
120069
+ "description": "Error message when success is false (e.g. validation).",
120070
+ "args": [],
120071
+ "type": {
120072
+ "kind": "SCALAR",
120073
+ "name": "String",
120074
+ "ofType": null
120075
+ },
120076
+ "isDeprecated": false,
120077
+ "deprecationReason": null
120078
+ }
120079
+ ],
120080
+ "inputFields": null,
120081
+ "interfaces": [],
120082
+ "enumValues": null,
120083
+ "possibleTypes": null
120084
+ },
120085
+ {
120086
+ "kind": "ENUM",
120087
+ "name": "SmartActionType",
120088
+ "description": "Type of smart action — use the `type` field of a smartActionRecommendations item.",
120089
+ "isOneOf": null,
120090
+ "fields": null,
120091
+ "inputFields": null,
120092
+ "interfaces": null,
120093
+ "enumValues": [
120094
+ {
120095
+ "name": "RESTOCK",
120096
+ "description": null,
120097
+ "isDeprecated": false,
120098
+ "deprecationReason": null
120099
+ },
120100
+ {
120101
+ "name": "PAUSE_CAMPAIGN",
120102
+ "description": null,
120103
+ "isDeprecated": false,
120104
+ "deprecationReason": null
120105
+ },
120106
+ {
120107
+ "name": "CREATE_BUNDLE",
120108
+ "description": null,
120109
+ "isDeprecated": false,
120110
+ "deprecationReason": null
120111
+ },
120112
+ {
120113
+ "name": "FOLLOW_UP_ABANDONED",
120114
+ "description": null,
120115
+ "isDeprecated": false,
120116
+ "deprecationReason": null
120117
+ },
120118
+ {
120119
+ "name": "ACTIVATE_DISCOUNT",
120120
+ "description": null,
120121
+ "isDeprecated": false,
120122
+ "deprecationReason": null
120123
+ },
120124
+ {
120125
+ "name": "SEND_WINBACK",
120126
+ "description": null,
120127
+ "isDeprecated": false,
120128
+ "deprecationReason": null
120129
+ },
120130
+ {
120131
+ "name": "LOW_RATING_PRODUCT",
120132
+ "description": null,
120133
+ "isDeprecated": false,
120134
+ "deprecationReason": null
120135
+ },
120136
+ {
120137
+ "name": "UPSELL_OPPORTUNITY",
120138
+ "description": null,
120139
+ "isDeprecated": false,
120140
+ "deprecationReason": null
120141
+ },
120142
+ {
120143
+ "name": "ENABLE_CROSS_SELL",
120144
+ "description": null,
120145
+ "isDeprecated": false,
120146
+ "deprecationReason": null
120147
+ },
120148
+ {
120149
+ "name": "REACTIVATE_SEGMENT",
120150
+ "description": null,
120151
+ "isDeprecated": false,
120152
+ "deprecationReason": null
120153
+ },
120154
+ {
120155
+ "name": "PRICE_DROP_ALERT",
120156
+ "description": null,
120157
+ "isDeprecated": false,
120158
+ "deprecationReason": null
120159
+ }
120160
+ ],
120161
+ "possibleTypes": null
120162
+ },
120163
+ {
120164
+ "kind": "ENUM",
120165
+ "name": "SmartActionStatus",
120166
+ "description": "Outcome recorded for a smart action.",
120167
+ "isOneOf": null,
120168
+ "fields": null,
120169
+ "inputFields": null,
120170
+ "interfaces": null,
120171
+ "enumValues": [
120172
+ {
120173
+ "name": "EXECUTED",
120174
+ "description": null,
120175
+ "isDeprecated": false,
120176
+ "deprecationReason": null
120177
+ },
120178
+ {
120179
+ "name": "DISMISSED",
120180
+ "description": null,
120181
+ "isDeprecated": false,
120182
+ "deprecationReason": null
120183
+ }
120184
+ ],
120185
+ "possibleTypes": null
120186
+ },
120187
+ {
120188
+ "kind": "INPUT_OBJECT",
120189
+ "name": "RecordSmartActionInput",
120190
+ "description": "Input for recordSmartAction — typically built from a smartActionRecommendations\nitem: copy its `type` → actionType, `entity_id` → entityId, plus the merchant's\nEXECUTED/DISMISSED decision.",
120191
+ "isOneOf": false,
120192
+ "fields": null,
120193
+ "inputFields": [
120194
+ {
120195
+ "name": "actionType",
120196
+ "description": "Action type (the recommendation's `type`).",
120197
+ "type": {
120198
+ "kind": "NON_NULL",
120199
+ "name": null,
120200
+ "ofType": {
120201
+ "kind": "ENUM",
120202
+ "name": "SmartActionType",
120203
+ "ofType": null
120204
+ }
120205
+ },
120206
+ "defaultValue": null,
120207
+ "isDeprecated": false,
120208
+ "deprecationReason": null
120209
+ },
120210
+ {
120211
+ "name": "entityId",
120212
+ "description": "ID of the entity the action targets (product, campaign, segment, ...).",
120213
+ "type": {
120214
+ "kind": "NON_NULL",
120215
+ "name": null,
120216
+ "ofType": {
120217
+ "kind": "SCALAR",
120218
+ "name": "Int",
120219
+ "ofType": null
120220
+ }
120221
+ },
120222
+ "defaultValue": null,
120223
+ "isDeprecated": false,
120224
+ "deprecationReason": null
120225
+ },
120226
+ {
120227
+ "name": "status",
120228
+ "description": "Whether the merchant executed or dismissed the action.",
120229
+ "type": {
120230
+ "kind": "NON_NULL",
120231
+ "name": null,
120232
+ "ofType": {
120233
+ "kind": "ENUM",
120234
+ "name": "SmartActionStatus",
120235
+ "ofType": null
120236
+ }
120237
+ },
120238
+ "defaultValue": null,
120239
+ "isDeprecated": false,
120240
+ "deprecationReason": null
120241
+ },
120242
+ {
120243
+ "name": "entityTitle",
120244
+ "description": "Optional human label of the entity.",
120245
+ "type": {
120246
+ "kind": "SCALAR",
120247
+ "name": "String",
120248
+ "ofType": null
120249
+ },
120250
+ "defaultValue": null,
120251
+ "isDeprecated": false,
120252
+ "deprecationReason": null
120253
+ },
120254
+ {
120255
+ "name": "expectedEffect",
120256
+ "description": "Optional expected-effect text carried from the recommendation.",
120257
+ "type": {
120258
+ "kind": "SCALAR",
120259
+ "name": "String",
120260
+ "ofType": null
120261
+ },
120262
+ "defaultValue": null,
120263
+ "isDeprecated": false,
120264
+ "deprecationReason": null
120265
+ },
120266
+ {
120267
+ "name": "executeRoute",
120268
+ "description": "Optional admin route descriptor carried from the recommendation (e.g. {name, query}).",
120269
+ "type": {
120270
+ "kind": "SCALAR",
120271
+ "name": "JSON",
120272
+ "ofType": null
120273
+ },
120274
+ "defaultValue": null,
120275
+ "isDeprecated": false,
120276
+ "deprecationReason": null
120277
+ }
120278
+ ],
120279
+ "interfaces": null,
120280
+ "enumValues": null,
120281
+ "possibleTypes": null
120282
+ },
119666
120283
  {
119667
120284
  "kind": "ENUM",
119668
120285
  "name": "XmlFeedGeneratorFilter",
Binary file