@cloudcart/dev-mcp 0.1.1 → 0.1.3
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 +5563 -2881
- package/dist/app-resources.d.ts +31 -0
- package/dist/app-resources.d.ts.map +1 -0
- package/dist/app-resources.js +177 -0
- package/dist/app-resources.js.map +1 -0
- package/dist/index.js +0 -0
- package/dist/prompts/admin.d.ts +1 -1
- package/dist/prompts/admin.d.ts.map +1 -1
- package/dist/prompts/admin.js +56 -0
- package/dist/prompts/admin.js.map +1 -1
- package/dist/tools/introspect-schema.d.ts.map +1 -1
- package/dist/tools/introspect-schema.js +49 -3
- package/dist/tools/introspect-schema.js.map +1 -1
- package/package.json +2 -2
|
@@ -0,0 +1,31 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Mapping of application-provided resources in CloudCart.
|
|
3
|
+
*
|
|
4
|
+
* Many CloudCart features are provided by Applications from the marketplace.
|
|
5
|
+
* This mapping lets the MCP flag these resources so the AI can inform
|
|
6
|
+
* developers that an app must be installed, active, and configured before
|
|
7
|
+
* they can use the API.
|
|
8
|
+
*
|
|
9
|
+
* Application groups sourced from: cc_apps.applications table
|
|
10
|
+
*/
|
|
11
|
+
export interface AppResourceGroup {
|
|
12
|
+
/** Application group name as returned by Application.group */
|
|
13
|
+
group: string;
|
|
14
|
+
/** Human-readable label */
|
|
15
|
+
label: string;
|
|
16
|
+
/** Brief explanation shown in introspection results */
|
|
17
|
+
notice: string;
|
|
18
|
+
/** Patterns matched against type/query/mutation names (case-insensitive, substring match) */
|
|
19
|
+
patterns: string[];
|
|
20
|
+
/** Patterns that must appear at the start of the name (case-insensitive) */
|
|
21
|
+
prefixPatterns?: string[];
|
|
22
|
+
/** Exact names that should be excluded from matching */
|
|
23
|
+
excludeExact?: string[];
|
|
24
|
+
}
|
|
25
|
+
export declare const APP_RESOURCE_GROUPS: AppResourceGroup[];
|
|
26
|
+
/**
|
|
27
|
+
* Check if a name matches any app-resource group.
|
|
28
|
+
* Returns the matching group or null.
|
|
29
|
+
*/
|
|
30
|
+
export declare function matchAppResourceGroup(name: string): AppResourceGroup | null;
|
|
31
|
+
//# sourceMappingURL=app-resources.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"app-resources.d.ts","sourceRoot":"","sources":["../src/app-resources.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,8DAA8D;IAC9D,KAAK,EAAE,MAAM,CAAC;IACd,2BAA2B;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,uDAAuD;IACvD,MAAM,EAAE,MAAM,CAAC;IACf,6FAA6F;IAC7F,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,4EAA4E;IAC5E,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,wDAAwD;IACxD,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAcD,eAAO,MAAM,mBAAmB,EAAE,gBAAgB,EAsMjD,CAAC;AAEF;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI,CA2B3E"}
|
|
@@ -0,0 +1,177 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Mapping of application-provided resources in CloudCart.
|
|
3
|
+
*
|
|
4
|
+
* Many CloudCart features are provided by Applications from the marketplace.
|
|
5
|
+
* This mapping lets the MCP flag these resources so the AI can inform
|
|
6
|
+
* developers that an app must be installed, active, and configured before
|
|
7
|
+
* they can use the API.
|
|
8
|
+
*
|
|
9
|
+
* Application groups sourced from: cc_apps.applications table
|
|
10
|
+
*/
|
|
11
|
+
function appNotice(group, label, examples, keyHint) {
|
|
12
|
+
const keyLine = keyHint
|
|
13
|
+
? ` ${keyHint}`
|
|
14
|
+
: ` Most operations require a \`key\` parameter — this is the application key.`;
|
|
15
|
+
return (`This is an APPLICATION-PROVIDED resource. ${label} in CloudCart is handled by marketplace Applications ` +
|
|
16
|
+
`(e.g., ${examples}).${keyLine} The relevant app must be installed, active, and configured on the site. ` +
|
|
17
|
+
`Use \`application(key: "...")\` to check app status, ` +
|
|
18
|
+
`or \`applications(filter: { group: "${group}" })\` to list available ${label.toLowerCase()} apps.`);
|
|
19
|
+
}
|
|
20
|
+
export const APP_RESOURCE_GROUPS = [
|
|
21
|
+
// ── Shipping (24 apps) ──────────────────────────────────────────────
|
|
22
|
+
{
|
|
23
|
+
group: "shipping",
|
|
24
|
+
label: "Shipping Provider",
|
|
25
|
+
notice: appNotice("shipping", "Shipping", "Speedy, Econt, ACS Courier, DHL, Sameday, FanCourier, Cargus"),
|
|
26
|
+
patterns: [
|
|
27
|
+
"shipping", "waybill",
|
|
28
|
+
"acscourier", "speedy", "econt", "sendcloud",
|
|
29
|
+
"dhlexpress", "boxnow", "cargus", "fancourier",
|
|
30
|
+
"sameday", "glovo", "speedex", "eushipment",
|
|
31
|
+
],
|
|
32
|
+
excludeExact: ["ShippingAddress"],
|
|
33
|
+
},
|
|
34
|
+
// ── Payment (46 apps) ──────────────────────────────────────────────
|
|
35
|
+
{
|
|
36
|
+
group: "payment",
|
|
37
|
+
label: "Payment Provider",
|
|
38
|
+
notice: appNotice("payment", "Payment processing", "Stripe, PayPal, Mollie, Borica, MyPOS, ePay, CloudCart Pay", "Payment operations reference the provider by its application key."),
|
|
39
|
+
patterns: [],
|
|
40
|
+
prefixPatterns: ["payment"],
|
|
41
|
+
excludeExact: [
|
|
42
|
+
"OrderPayment", "OrderPaymentEdge", "OrderPaymentConnection", "CustomerPaymentStatusTotal",
|
|
43
|
+
"MarkPaymentPaidInput", "ChangePaymentProviderInput",
|
|
44
|
+
],
|
|
45
|
+
},
|
|
46
|
+
// ── ERP / POS (Barsy, Rkeeper, etc. — in "global" group in DB) ────
|
|
47
|
+
{
|
|
48
|
+
group: "global",
|
|
49
|
+
label: "ERP / POS Integration",
|
|
50
|
+
notice: appNotice("global", "ERP / POS integration", "Barsy, Rkeeper, Facturis, SmartBill, Oblio, Lexoffice, Xentral", "ERP operations require a `key` parameter — the application key (e.g., 'barsy', 'rkeeper')."),
|
|
51
|
+
patterns: [
|
|
52
|
+
"barsy", "rkeeper", "facturis",
|
|
53
|
+
],
|
|
54
|
+
prefixPatterns: ["erp"],
|
|
55
|
+
},
|
|
56
|
+
// ── Import (17 apps) ───────────────────────────────────────────────
|
|
57
|
+
{
|
|
58
|
+
group: "import",
|
|
59
|
+
label: "Import Integration",
|
|
60
|
+
notice: appNotice("import", "Data import", "CSV Import, XML Import, Shopify, WooCommerce, Magento, Google Sheets", "Import operations typically require a `key` parameter for the import app."),
|
|
61
|
+
patterns: [
|
|
62
|
+
"csvimport", "xmlimport", "xmlsync", "jsonimport",
|
|
63
|
+
],
|
|
64
|
+
excludeExact: [],
|
|
65
|
+
},
|
|
66
|
+
// ── Feed / Export (19 feed apps + 1 export) ────────────────────────
|
|
67
|
+
{
|
|
68
|
+
group: "feed",
|
|
69
|
+
label: "Product Feed",
|
|
70
|
+
notice: appNotice("feed", "Product feed generation", "Google Shopping Feed, Facebook Feed, Skroutz, Glami, eMAG Feed", "Feed operations use the feed app key (e.g., 'app.xml_feed.google', 'app.xml_feed.facebook')."),
|
|
71
|
+
patterns: [
|
|
72
|
+
"xmlfeed", "xml_feed",
|
|
73
|
+
],
|
|
74
|
+
},
|
|
75
|
+
// ── Google Integrations (Shopping, Sheets, Analytics — "global" group) ──
|
|
76
|
+
{
|
|
77
|
+
group: "global",
|
|
78
|
+
label: "Google Integration",
|
|
79
|
+
notice: appNotice("global", "Google integration", "Google Shopping, Google Sheets, Google Analytics", "Google app operations require the specific app to be installed and configured."),
|
|
80
|
+
patterns: [
|
|
81
|
+
"googleshopping", "googlesheets", "googleapp",
|
|
82
|
+
],
|
|
83
|
+
},
|
|
84
|
+
// ── OLX Marketplace ("other" group) ────────────────────────────────
|
|
85
|
+
{
|
|
86
|
+
group: "other",
|
|
87
|
+
label: "OLX Marketplace Integration",
|
|
88
|
+
notice: appNotice("other", "OLX marketplace integration", "OLX", "OLX operations require the OLX app to be installed, connected, and configured."),
|
|
89
|
+
patterns: ["olx"],
|
|
90
|
+
},
|
|
91
|
+
// ── Frisbo Fulfillment ("global" group) ────────────────────────────
|
|
92
|
+
{
|
|
93
|
+
group: "global",
|
|
94
|
+
label: "Fulfillment Integration",
|
|
95
|
+
notice: appNotice("global", "Fulfillment", "Frisbo", "Fulfillment operations require the fulfillment app to be installed and configured."),
|
|
96
|
+
patterns: ["frisbo"],
|
|
97
|
+
},
|
|
98
|
+
// ── Campaigns / Marketing (1 app in "marketing" group) ────────────
|
|
99
|
+
{
|
|
100
|
+
group: "marketing",
|
|
101
|
+
label: "Marketing / Campaigns",
|
|
102
|
+
notice: appNotice("marketing", "Marketing campaigns", "Campaigns (email, SMS)", "Campaign operations require the Campaigns app to be installed and configured."),
|
|
103
|
+
patterns: ["campaign"],
|
|
104
|
+
excludeExact: [],
|
|
105
|
+
},
|
|
106
|
+
// ── Mailchimp ("global" group) ─────────────────────────────────────
|
|
107
|
+
{
|
|
108
|
+
group: "global",
|
|
109
|
+
label: "Mailchimp Integration",
|
|
110
|
+
notice: appNotice("global", "Mailchimp email marketing", "Mailchimp", "Mailchimp operations require the Mailchimp app to be installed and configured."),
|
|
111
|
+
patterns: ["mailchimp"],
|
|
112
|
+
},
|
|
113
|
+
// ── SEO (1 app in "seo" group) ─────────────────────────────────────
|
|
114
|
+
{
|
|
115
|
+
group: "seo",
|
|
116
|
+
label: "SEO Tool",
|
|
117
|
+
notice: appNotice("seo", "SEO optimization", "SEO Spinner", "SEO Spinner operations require the SEO Spinner app to be installed and configured."),
|
|
118
|
+
patterns: ["seospinner"],
|
|
119
|
+
},
|
|
120
|
+
// ── Chat (1 app) ──────────────────────────────────────────────────
|
|
121
|
+
{
|
|
122
|
+
group: "chat",
|
|
123
|
+
label: "Live Chat",
|
|
124
|
+
notice: appNotice("chat", "Live chat", "Live Chat", "Chat operations require the Live Chat app to be installed and configured."),
|
|
125
|
+
patterns: ["livechat", "live-chat"],
|
|
126
|
+
},
|
|
127
|
+
// ── Connect / Social Login (2 apps) ────────────────────────────────
|
|
128
|
+
{
|
|
129
|
+
group: "connect",
|
|
130
|
+
label: "Social Login",
|
|
131
|
+
notice: appNotice("connect", "Social login", "Facebook Connect, Google Connect", "Social login requires the respective Connect app to be installed."),
|
|
132
|
+
patterns: ["facebookconnect", "googleconnect"],
|
|
133
|
+
},
|
|
134
|
+
// ── Comment / Reviews (2 apps) ─────────────────────────────────────
|
|
135
|
+
{
|
|
136
|
+
group: "comment",
|
|
137
|
+
label: "Reviews & Comments",
|
|
138
|
+
notice: appNotice("comment", "Product reviews and comments", "Facebook Comments, Yotpo", "Review/comment operations require the respective app to be installed."),
|
|
139
|
+
patterns: ["yotpo", "facebookcomment"],
|
|
140
|
+
},
|
|
141
|
+
// ── Mail / SMTP (1 app) ────────────────────────────────────────────
|
|
142
|
+
{
|
|
143
|
+
group: "mail",
|
|
144
|
+
label: "SMTP / Email Delivery",
|
|
145
|
+
notice: appNotice("mail", "Email delivery", "SMTP", "Custom SMTP settings require the SMTP app to be installed and configured."),
|
|
146
|
+
patterns: ["smtp"],
|
|
147
|
+
},
|
|
148
|
+
];
|
|
149
|
+
/**
|
|
150
|
+
* Check if a name matches any app-resource group.
|
|
151
|
+
* Returns the matching group or null.
|
|
152
|
+
*/
|
|
153
|
+
export function matchAppResourceGroup(name) {
|
|
154
|
+
const lower = name.toLowerCase();
|
|
155
|
+
for (const group of APP_RESOURCE_GROUPS) {
|
|
156
|
+
// Check exclusions first
|
|
157
|
+
if (group.excludeExact?.includes(name)) {
|
|
158
|
+
continue;
|
|
159
|
+
}
|
|
160
|
+
// Substring match
|
|
161
|
+
for (const pattern of group.patterns) {
|
|
162
|
+
if (lower.includes(pattern)) {
|
|
163
|
+
return group;
|
|
164
|
+
}
|
|
165
|
+
}
|
|
166
|
+
// Prefix-only match (avoids false positives like "orderProduct" matching "erp")
|
|
167
|
+
if (group.prefixPatterns) {
|
|
168
|
+
for (const prefix of group.prefixPatterns) {
|
|
169
|
+
if (lower.startsWith(prefix)) {
|
|
170
|
+
return group;
|
|
171
|
+
}
|
|
172
|
+
}
|
|
173
|
+
}
|
|
174
|
+
}
|
|
175
|
+
return null;
|
|
176
|
+
}
|
|
177
|
+
//# sourceMappingURL=app-resources.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"app-resources.js","sourceRoot":"","sources":["../src/app-resources.ts"],"names":[],"mappings":"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"}
|
package/dist/index.js
CHANGED
|
File without changes
|
package/dist/prompts/admin.d.ts
CHANGED
|
@@ -1,2 +1,2 @@
|
|
|
1
|
-
export declare const ADMIN_API_PROMPT = "You are an assistant that helps CloudCart developers write GraphQL queries or mutations to interact with the latest CloudCart Admin GraphQL API.\n\nYou should find all operations that can help the developer achieve their goal, provide valid GraphQL operations along with helpful explanations.\nWhen returning a GraphQL operation always wrap it in triple backticks and use the graphql file type.\nTHIS IS IMPORTANT: GraphQL operations you generate should ALWAYS be validated with the `validate_graphql_codeblocks` MCP tool. This tool will parse the operation with the GQL schema and give you feedback of errors if any were detected. If errors are detected from this validation tool, make the necessary changes and then call this tool again.\n\nThink about all the steps required to generate a GraphQL query or mutation for the Admin API:\n\n First think about what the developer is trying to do\n Then use introspect_graphql_schema to find relevant types, queries, and mutations\n For queries think about which fields you need to fetch and for mutations think about which arguments you need to pass as input\n Then think about which fields to select from the return type. In general, don't select more than 5 fields\n If there are nested objects think about which fields you need to fetch for those objects\n\nUSAGE TIPS for introspect_graphql_schema:\n- Search by resource name: \"product\", \"order\", \"customer\", \"discount\"\n- Search by action: \"create\", \"update\", \"delete\"\n- If no results, try shorter/broader terms\n- The search matches on type/query/mutation names (substring match)\n\nBe sure to pass the code into the `validate_graphql_codeblocks` tool and make any necessary corrections that tool indicates are needed. This removes LLM hallucinations from GQL operations.";
|
|
1
|
+
export declare const ADMIN_API_PROMPT = "You are an assistant that helps CloudCart developers write GraphQL queries or mutations to interact with the latest CloudCart Admin GraphQL API.\n\nYou should find all operations that can help the developer achieve their goal, provide valid GraphQL operations along with helpful explanations.\nWhen returning a GraphQL operation always wrap it in triple backticks and use the graphql file type.\nTHIS IS IMPORTANT: GraphQL operations you generate should ALWAYS be validated with the `validate_graphql_codeblocks` MCP tool. This tool will parse the operation with the GQL schema and give you feedback of errors if any were detected. If errors are detected from this validation tool, make the necessary changes and then call this tool again.\n\nThink about all the steps required to generate a GraphQL query or mutation for the Admin API:\n\n First think about what the developer is trying to do\n Then use introspect_graphql_schema to find relevant types, queries, and mutations\n For queries think about which fields you need to fetch and for mutations think about which arguments you need to pass as input\n Then think about which fields to select from the return type. In general, don't select more than 5 fields\n If there are nested objects think about which fields you need to fetch for those objects\n\nIMPORTANT \u2014 APPLICATION-PROVIDED RESOURCES:\nMany CloudCart features are provided by Applications from the CloudCart marketplace, not by the core platform.\nCloudCart has 19 application groups with 250+ apps. The main groups are:\n\n- **Shipping** (group: \"shipping\", 24 apps) \u2014 Speedy, Econt, ACS Courier, DHL, DHL Express, Sameday, FanCourier, Cargus, DPD, GLS, BoxNow, Sendcloud, Glovo, Speedex, etc.\n- **Payment** (group: \"payment\", 46 apps) \u2014 Stripe, PayPal, Mollie, Borica, MyPOS, ePay, CloudCart Pay, Klarna, Adyen, DSK, Fibank, Raiffeisen, Monri, etc.\n- **ERP / POS** (group: \"global\") \u2014 Barsy, Rkeeper, Facturis, SmartBill, Oblio, Lexoffice, Xentral, Sevdesk, etc.\n- **Import** (group: \"import\", 17 apps) \u2014 CSV Import, XML Import, Shopify, WooCommerce, Magento, Google Sheets, JSON Import, etc.\n- **Feed** (group: \"feed\", 19 apps) \u2014 Google Shopping Feed, Facebook Feed, Skroutz, Glami, eMAG, Criteo, Pazaruvaj, etc.\n- **Google** (group: \"global\") \u2014 Google Shopping, Google Sheets, Google Analytics, Google Tags, Google Workspace.\n- **OLX** (group: \"other\") \u2014 OLX marketplace integration with product sync, category mapping, and advert management.\n- **Fulfillment** (group: \"global\") \u2014 Frisbo fulfillment with warehouse and order management.\n- **Marketing** (group: \"marketing\") \u2014 Campaigns (email, SMS marketing automation).\n- **Mailchimp** (group: \"global\") \u2014 Mailchimp email marketing integration.\n- **SEO** (group: \"seo\") \u2014 SEO Spinner for automated meta title/description generation.\n- **Chat** (group: \"chat\") \u2014 Live Chat widget.\n- **Social Login** (group: \"connect\") \u2014 Facebook Connect, Google Connect.\n- **Reviews** (group: \"comment\") \u2014 Facebook Comments, Yotpo.\n- **Mail** (group: \"mail\") \u2014 Custom SMTP configuration.\n- **Search** (group: \"search\") \u2014 Algolia search integration.\n- **Product Description** (group: \"product_description\") \u2014 Flix Facts, Load Bee for rich product content.\n- **Other** (group: \"other\") \u2014 Advanced Search, Listing Engine, Up/Cross-sell, etc.\n\nWhen a developer asks about any application-provided feature, ALWAYS inform them that:\n1. These features require an Application to be installed, active, and configured on their site.\n2. Most operations require a `key` parameter \u2014 this is the application key (e.g., \"speedy\", \"econt\", \"barsy\", \"stripe\").\n3. They can check app status with `application(key: \"...\")` or list available apps with `applications(filter: { group: \"shipping\" })`.\n4. The introspect_graphql_schema tool will flag application-provided resources automatically with a notice.\n\nUSAGE TIPS for introspect_graphql_schema:\n- Search by resource name: \"product\", \"order\", \"customer\", \"discount\"\n- Search by action: \"create\", \"update\", \"delete\"\n- If no results, try shorter/broader terms\n- The search matches on type/query/mutation names (substring match)\n- Results for application-provided resources will include a notice with setup requirements\n\nSCHEMA CONVENTIONS (current as of 2026-04-21):\n\n1. **Output fields are camelCase** \u2014 `urlHandle`, `seoTitle`, `priceFrom`, `dateAdded`, `firstName`, `customerEmail`, etc. If you write `url_handle` on an OUTPUT selection, the query fails.\n\n2. **Input fields and query/mutation arguments stay snake_case** \u2014 `CreateProductInput.url_handle`, `CreateCustomerInput.first_name`, `deleteSmartCollections(ids:)`, `productVariants(product_id:)`. Do NOT camelCase these in mutations.\n\n3. **Connection types expose TWO shapes** \u2014 most `XxxConnection` types have both the Relay cursor form and a flat alternative:\n```graphql\n# Preferred for most queries (half the payload, no cursor wrapper):\ncategories(first: 10) { nodes { id name } totalCount }\n\n# Use only when you need cursor pagination:\ncategories(first: 10) { edges { node { id name } cursor } pageInfo { hasNextPage endCursor } totalCount }\n```\nNOTE: auto-generated connections from `@paginate(type: CONNECTION)` (e.g. `ProductConnection`) only expose `edges`/`pageInfo` \u2014 use the cursor form there.\n\n4. **Grouped sub-types** \u2014 the big root types are split into purpose-scoped sub-objects. Flat fields like `Product.price_from` or `Order.customer_email` DO NOT EXIST anymore. Use:\n- `Product`: `pricing { from to type }`, `seo { title description }`, `flags { active digital hidden draft featured sale new shipping continueSelling }`, `inventory { tracking threshold variantsCount defaultVariantId }`, `parameters { p1 p1Id ... }`, `timestamps { added modified publishAt activeTo }`\n- `Order`: `buyer { email firstName lastName }`, `amounts { subtotal total vatIncluded }`, `statuses { status fulfillment }`, `documents { invoiceNumber ... }`, `notes { customer administrator }`, `flags { manual abandoned notifyCustomer emailSent allowRecalculate }`, `timestamps { added archived locking shippingDate ... }`\n- `Customer`: `contact { firstName lastName phone }`, `verification { emailConfirmed }`, `marketingPrefs { marketing newsletter }`, `status { active isActivated banned }`, `defaults { shippingAddressId billingAddressId }`, `timestamps { added updatedAt }`\n- `CartSettings`: `registration`, `limits`, `defaults`, `checkoutFields`, `maps`, `orders`, `abandoned`, `legal` (see introspect_graphql_schema for sub-type fields)\n\n5. **Scalars** \u2014 `DateTime` is `Y-m-d H:i:s` (not ISO 8601). `Date` is `Y-m-d`. `YesNo` is an enum (`yes`/`no`), not a native Boolean.\n\n6. **Error payloads** are lean \u2014 validation errors return just `message`, `path`, `locations`. No PHP stack traces by default.\n\nBe sure to pass the code into the `validate_graphql_codeblocks` tool and make any necessary corrections that tool indicates are needed. This removes LLM hallucinations from GQL operations.";
|
|
2
2
|
//# sourceMappingURL=admin.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"admin.d.ts","sourceRoot":"","sources":["../../src/prompts/admin.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,gBAAgB,
|
|
1
|
+
{"version":3,"file":"admin.d.ts","sourceRoot":"","sources":["../../src/prompts/admin.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,gBAAgB,kiOA4EkK,CAAC"}
|
package/dist/prompts/admin.js
CHANGED
|
@@ -12,11 +12,67 @@ Think about all the steps required to generate a GraphQL query or mutation for t
|
|
|
12
12
|
Then think about which fields to select from the return type. In general, don't select more than 5 fields
|
|
13
13
|
If there are nested objects think about which fields you need to fetch for those objects
|
|
14
14
|
|
|
15
|
+
IMPORTANT — APPLICATION-PROVIDED RESOURCES:
|
|
16
|
+
Many CloudCart features are provided by Applications from the CloudCart marketplace, not by the core platform.
|
|
17
|
+
CloudCart has 19 application groups with 250+ apps. The main groups are:
|
|
18
|
+
|
|
19
|
+
- **Shipping** (group: "shipping", 24 apps) — Speedy, Econt, ACS Courier, DHL, DHL Express, Sameday, FanCourier, Cargus, DPD, GLS, BoxNow, Sendcloud, Glovo, Speedex, etc.
|
|
20
|
+
- **Payment** (group: "payment", 46 apps) — Stripe, PayPal, Mollie, Borica, MyPOS, ePay, CloudCart Pay, Klarna, Adyen, DSK, Fibank, Raiffeisen, Monri, etc.
|
|
21
|
+
- **ERP / POS** (group: "global") — Barsy, Rkeeper, Facturis, SmartBill, Oblio, Lexoffice, Xentral, Sevdesk, etc.
|
|
22
|
+
- **Import** (group: "import", 17 apps) — CSV Import, XML Import, Shopify, WooCommerce, Magento, Google Sheets, JSON Import, etc.
|
|
23
|
+
- **Feed** (group: "feed", 19 apps) — Google Shopping Feed, Facebook Feed, Skroutz, Glami, eMAG, Criteo, Pazaruvaj, etc.
|
|
24
|
+
- **Google** (group: "global") — Google Shopping, Google Sheets, Google Analytics, Google Tags, Google Workspace.
|
|
25
|
+
- **OLX** (group: "other") — OLX marketplace integration with product sync, category mapping, and advert management.
|
|
26
|
+
- **Fulfillment** (group: "global") — Frisbo fulfillment with warehouse and order management.
|
|
27
|
+
- **Marketing** (group: "marketing") — Campaigns (email, SMS marketing automation).
|
|
28
|
+
- **Mailchimp** (group: "global") — Mailchimp email marketing integration.
|
|
29
|
+
- **SEO** (group: "seo") — SEO Spinner for automated meta title/description generation.
|
|
30
|
+
- **Chat** (group: "chat") — Live Chat widget.
|
|
31
|
+
- **Social Login** (group: "connect") — Facebook Connect, Google Connect.
|
|
32
|
+
- **Reviews** (group: "comment") — Facebook Comments, Yotpo.
|
|
33
|
+
- **Mail** (group: "mail") — Custom SMTP configuration.
|
|
34
|
+
- **Search** (group: "search") — Algolia search integration.
|
|
35
|
+
- **Product Description** (group: "product_description") — Flix Facts, Load Bee for rich product content.
|
|
36
|
+
- **Other** (group: "other") — Advanced Search, Listing Engine, Up/Cross-sell, etc.
|
|
37
|
+
|
|
38
|
+
When a developer asks about any application-provided feature, ALWAYS inform them that:
|
|
39
|
+
1. These features require an Application to be installed, active, and configured on their site.
|
|
40
|
+
2. Most operations require a \`key\` parameter — this is the application key (e.g., "speedy", "econt", "barsy", "stripe").
|
|
41
|
+
3. They can check app status with \`application(key: "...")\` or list available apps with \`applications(filter: { group: "shipping" })\`.
|
|
42
|
+
4. The introspect_graphql_schema tool will flag application-provided resources automatically with a notice.
|
|
43
|
+
|
|
15
44
|
USAGE TIPS for introspect_graphql_schema:
|
|
16
45
|
- Search by resource name: "product", "order", "customer", "discount"
|
|
17
46
|
- Search by action: "create", "update", "delete"
|
|
18
47
|
- If no results, try shorter/broader terms
|
|
19
48
|
- The search matches on type/query/mutation names (substring match)
|
|
49
|
+
- Results for application-provided resources will include a notice with setup requirements
|
|
50
|
+
|
|
51
|
+
SCHEMA CONVENTIONS (current as of 2026-04-21):
|
|
52
|
+
|
|
53
|
+
1. **Output fields are camelCase** — \`urlHandle\`, \`seoTitle\`, \`priceFrom\`, \`dateAdded\`, \`firstName\`, \`customerEmail\`, etc. If you write \`url_handle\` on an OUTPUT selection, the query fails.
|
|
54
|
+
|
|
55
|
+
2. **Input fields and query/mutation arguments stay snake_case** — \`CreateProductInput.url_handle\`, \`CreateCustomerInput.first_name\`, \`deleteSmartCollections(ids:)\`, \`productVariants(product_id:)\`. Do NOT camelCase these in mutations.
|
|
56
|
+
|
|
57
|
+
3. **Connection types expose TWO shapes** — most \`XxxConnection\` types have both the Relay cursor form and a flat alternative:
|
|
58
|
+
\`\`\`graphql
|
|
59
|
+
# Preferred for most queries (half the payload, no cursor wrapper):
|
|
60
|
+
categories(first: 10) { nodes { id name } totalCount }
|
|
61
|
+
|
|
62
|
+
# Use only when you need cursor pagination:
|
|
63
|
+
categories(first: 10) { edges { node { id name } cursor } pageInfo { hasNextPage endCursor } totalCount }
|
|
64
|
+
\`\`\`
|
|
65
|
+
NOTE: auto-generated connections from \`@paginate(type: CONNECTION)\` (e.g. \`ProductConnection\`) only expose \`edges\`/\`pageInfo\` — use the cursor form there.
|
|
66
|
+
|
|
67
|
+
4. **Grouped sub-types** — the big root types are split into purpose-scoped sub-objects. Flat fields like \`Product.price_from\` or \`Order.customer_email\` DO NOT EXIST anymore. Use:
|
|
68
|
+
- \`Product\`: \`pricing { from to type }\`, \`seo { title description }\`, \`flags { active digital hidden draft featured sale new shipping continueSelling }\`, \`inventory { tracking threshold variantsCount defaultVariantId }\`, \`parameters { p1 p1Id ... }\`, \`timestamps { added modified publishAt activeTo }\`
|
|
69
|
+
- \`Order\`: \`buyer { email firstName lastName }\`, \`amounts { subtotal total vatIncluded }\`, \`statuses { status fulfillment }\`, \`documents { invoiceNumber ... }\`, \`notes { customer administrator }\`, \`flags { manual abandoned notifyCustomer emailSent allowRecalculate }\`, \`timestamps { added archived locking shippingDate ... }\`
|
|
70
|
+
- \`Customer\`: \`contact { firstName lastName phone }\`, \`verification { emailConfirmed }\`, \`marketingPrefs { marketing newsletter }\`, \`status { active isActivated banned }\`, \`defaults { shippingAddressId billingAddressId }\`, \`timestamps { added updatedAt }\`
|
|
71
|
+
- \`CartSettings\`: \`registration\`, \`limits\`, \`defaults\`, \`checkoutFields\`, \`maps\`, \`orders\`, \`abandoned\`, \`legal\` (see introspect_graphql_schema for sub-type fields)
|
|
72
|
+
|
|
73
|
+
5. **Scalars** — \`DateTime\` is \`Y-m-d H:i:s\` (not ISO 8601). \`Date\` is \`Y-m-d\`. \`YesNo\` is an enum (\`yes\`/\`no\`), not a native Boolean.
|
|
74
|
+
|
|
75
|
+
6. **Error payloads** are lean — validation errors return just \`message\`, \`path\`, \`locations\`. No PHP stack traces by default.
|
|
20
76
|
|
|
21
77
|
Be sure to pass the code into the \`validate_graphql_codeblocks\` tool and make any necessary corrections that tool indicates are needed. This removes LLM hallucinations from GQL operations.`;
|
|
22
78
|
//# sourceMappingURL=admin.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"admin.js","sourceRoot":"","sources":["../../src/prompts/admin.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,gBAAgB,GAAG
|
|
1
|
+
{"version":3,"file":"admin.js","sourceRoot":"","sources":["../../src/prompts/admin.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,gBAAgB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;+LA4E+J,CAAC"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"introspect-schema.d.ts","sourceRoot":"","sources":["../../src/tools/introspect-schema.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"introspect-schema.d.ts","sourceRoot":"","sources":["../../src/tools/introspect-schema.ts"],"names":[],"mappings":"AAGA,KAAK,UAAU,GAAG,KAAK,GAAG,OAAO,GAAG,SAAS,GAAG,WAAW,CAAC;AAE5D,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,UAAU,EAAE,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AA8HD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,eAAe;;;;;EAoGtD"}
|
|
@@ -1,4 +1,5 @@
|
|
|
1
1
|
import { loadSchema } from "../schema/loader.js";
|
|
2
|
+
import { matchAppResourceGroup } from "../app-resources.js";
|
|
2
3
|
function resolveTypeRef(typeRef) {
|
|
3
4
|
if (typeRef.kind === "NON_NULL") {
|
|
4
5
|
return `${resolveTypeRef(typeRef.ofType)}!`;
|
|
@@ -80,6 +81,25 @@ function formatType(type) {
|
|
|
80
81
|
return lines.join("\n");
|
|
81
82
|
}
|
|
82
83
|
const RESULTS_LIMIT = 10;
|
|
84
|
+
function formatAppNotice(group) {
|
|
85
|
+
return `> ⚠️ **${group.label} (Application-Provided)**\n> ${group.notice}`;
|
|
86
|
+
}
|
|
87
|
+
function formatTypeWithAppNotice(type) {
|
|
88
|
+
const formatted = formatType(type);
|
|
89
|
+
const appGroup = matchAppResourceGroup(type.name);
|
|
90
|
+
if (appGroup) {
|
|
91
|
+
return `${formatAppNotice(appGroup)}\n\n${formatted}`;
|
|
92
|
+
}
|
|
93
|
+
return formatted;
|
|
94
|
+
}
|
|
95
|
+
function formatFieldWithAppNotice(field) {
|
|
96
|
+
const formatted = formatField(field);
|
|
97
|
+
const appGroup = matchAppResourceGroup(field.name);
|
|
98
|
+
if (appGroup) {
|
|
99
|
+
return `${formatAppNotice(appGroup)}\n\n${formatted}`;
|
|
100
|
+
}
|
|
101
|
+
return formatted;
|
|
102
|
+
}
|
|
83
103
|
export function introspectSchema(input) {
|
|
84
104
|
const api = input.api ?? "admin";
|
|
85
105
|
const filters = input.filter ?? ["all"];
|
|
@@ -99,14 +119,24 @@ export function introspectSchema(input) {
|
|
|
99
119
|
normalized = normalized.slice(0, -1);
|
|
100
120
|
}
|
|
101
121
|
const sections = [];
|
|
122
|
+
// Track which app-resource notices we've already shown to avoid repetition
|
|
123
|
+
const shownAppNotices = new Set();
|
|
102
124
|
if (includeAll || filters.includes("types")) {
|
|
103
125
|
const matched = schema.types
|
|
104
126
|
.filter((t) => t.name.toLowerCase().includes(normalized))
|
|
105
127
|
.sort((a, b) => a.name.length - b.name.length)
|
|
106
128
|
.slice(0, RESULTS_LIMIT);
|
|
107
129
|
if (matched.length > 0) {
|
|
130
|
+
const formattedTypes = matched.map((t) => {
|
|
131
|
+
const appGroup = matchAppResourceGroup(t.name);
|
|
132
|
+
if (appGroup && !shownAppNotices.has(appGroup.group)) {
|
|
133
|
+
shownAppNotices.add(appGroup.group);
|
|
134
|
+
return `${formatAppNotice(appGroup)}\n\n${formatType(t)}`;
|
|
135
|
+
}
|
|
136
|
+
return formatType(t);
|
|
137
|
+
});
|
|
108
138
|
sections.push(`## Matching GraphQL Types:\n(Results limited to ${RESULTS_LIMIT} items. Refine your search for more specific results.)\n\n` +
|
|
109
|
-
|
|
139
|
+
formattedTypes.join("\n\n"));
|
|
110
140
|
}
|
|
111
141
|
}
|
|
112
142
|
if (includeAll || filters.includes("queries")) {
|
|
@@ -115,8 +145,16 @@ export function introspectSchema(input) {
|
|
|
115
145
|
.sort((a, b) => a.name.length - b.name.length)
|
|
116
146
|
.slice(0, RESULTS_LIMIT);
|
|
117
147
|
if (matched.length > 0) {
|
|
148
|
+
const formattedQueries = matched.map((f) => {
|
|
149
|
+
const appGroup = matchAppResourceGroup(f.name);
|
|
150
|
+
if (appGroup && !shownAppNotices.has(appGroup.group)) {
|
|
151
|
+
shownAppNotices.add(appGroup.group);
|
|
152
|
+
return `${formatAppNotice(appGroup)}\n\n${formatField(f)}`;
|
|
153
|
+
}
|
|
154
|
+
return formatField(f);
|
|
155
|
+
});
|
|
118
156
|
sections.push(`## Matching GraphQL Queries:\n(Results limited to ${RESULTS_LIMIT} items. Refine your search for more specific results.)\n\n` +
|
|
119
|
-
|
|
157
|
+
formattedQueries.join("\n\n"));
|
|
120
158
|
}
|
|
121
159
|
}
|
|
122
160
|
if (includeAll || filters.includes("mutations")) {
|
|
@@ -125,8 +163,16 @@ export function introspectSchema(input) {
|
|
|
125
163
|
.sort((a, b) => a.name.length - b.name.length)
|
|
126
164
|
.slice(0, RESULTS_LIMIT);
|
|
127
165
|
if (matched.length > 0) {
|
|
166
|
+
const formattedMutations = matched.map((f) => {
|
|
167
|
+
const appGroup = matchAppResourceGroup(f.name);
|
|
168
|
+
if (appGroup && !shownAppNotices.has(appGroup.group)) {
|
|
169
|
+
shownAppNotices.add(appGroup.group);
|
|
170
|
+
return `${formatAppNotice(appGroup)}\n\n${formatField(f)}`;
|
|
171
|
+
}
|
|
172
|
+
return formatField(f);
|
|
173
|
+
});
|
|
128
174
|
sections.push(`## Matching GraphQL Mutations:\n(Results limited to ${RESULTS_LIMIT} items. Refine your search for more specific results.)\n\n` +
|
|
129
|
-
|
|
175
|
+
formattedMutations.join("\n\n"));
|
|
130
176
|
}
|
|
131
177
|
}
|
|
132
178
|
const text = sections.length > 0
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"introspect-schema.js","sourceRoot":"","sources":["../../src/tools/introspect-schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;
|
|
1
|
+
{"version":3,"file":"introspect-schema.js","sourceRoot":"","sources":["../../src/tools/introspect-schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,qBAAqB,EAAyB,MAAM,qBAAqB,CAAC;AAWnF,SAAS,cAAc,CAAC,OAA6D;IACnF,IAAI,OAAO,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;QAChC,OAAO,GAAG,cAAc,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC;IAC9C,CAAC;IACD,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QAC5B,OAAO,IAAI,cAAc,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC;IAC/C,CAAC;IACD,OAAO,OAAO,CAAC,IAAI,IAAI,SAAS,CAAC;AACnC,CAAC;AAED,SAAS,WAAW,CAAC,KAA6E;IAChG,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,IAAI,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC;IAC3B,IAAI,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxC,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI;aACtB,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE;YACd,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC,IAAI,KAAK,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;YAC/C,IAAI,CAAC,CAAC,YAAY,IAAI,IAAI;gBAAE,CAAC,IAAI,MAAM,CAAC,CAAC,YAAY,EAAE,CAAC;YACxD,OAAO,CAAC,CAAC;QACX,CAAC,CAAC;aACD,IAAI,CAAC,IAAI,CAAC,CAAC;QACd,SAAS,IAAI,IAAI,MAAM,GAAG,CAAC;IAC7B,CAAC;IACD,SAAS,IAAI,KAAK,cAAc,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;IAC/C,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAEtB,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC;QACtB,KAAK,CAAC,IAAI,CAAC,OAAO,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;IACzC,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,SAAS,UAAU,CAAC,IAQnB;IACC,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,4BAA4B;IAC5B,IAAI,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;IACzC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAEnB,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;QACrB,KAAK,CAAC,IAAI,CAAC,kBAAkB,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;IACnD,CAAC;IAED,+BAA+B;IAC/B,IAAI,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAClD,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAChG,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC1B,KAAK,CAAC,IAAI,CAAC,iBAAiB,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACvD,CAAC;IACH,CAAC;IAED,IAAI,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1C,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACxB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;YACzC,KAAK,CAAC,IAAI,CAAC,OAAO,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YACpC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjB,CAAC;QACD,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC;YAC5B,KAAK,CAAC,IAAI,CAAC,eAAe,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,EAAE,cAAc,CAAC,CAAC;QACnE,CAAC;IACH,CAAC;IAED,IAAI,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;QAC9B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;YAC9C,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,KAAK,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACvD,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;gBAClB,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;YACzC,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjB,CAAC;QACD,IAAI,IAAI,CAAC,WAAW,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC;YACjC,KAAK,CAAC,IAAI,CAAC,eAAe,IAAI,CAAC,WAAW,CAAC,MAAM,GAAG,EAAE,cAAc,CAAC,CAAC;QACxE,CAAC;IACH,CAAC;IAED,IAAI,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAClD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YAChC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACzE,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,aAAa,GAAG,EAAE,CAAC;AAEzB,SAAS,eAAe,CAAC,KAAuB;IAC9C,OAAO,UAAU,KAAK,CAAC,KAAK,gCAAgC,KAAK,CAAC,MAAM,EAAE,CAAC;AAC7E,CAAC;AAED,SAAS,uBAAuB,CAAC,IAAsC;IACrE,MAAM,SAAS,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;IACnC,MAAM,QAAQ,GAAG,qBAAqB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAClD,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO,GAAG,eAAe,CAAC,QAAQ,CAAC,OAAO,SAAS,EAAE,CAAC;IACxD,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,wBAAwB,CAAC,KAAwC;IACxE,MAAM,SAAS,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;IACrC,MAAM,QAAQ,GAAG,qBAAqB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACnD,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO,GAAG,eAAe,CAAC,QAAQ,CAAC,OAAO,SAAS,EAAE,CAAC;IACxD,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAsB;IACrD,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,IAAI,OAAO,CAAC;IACjC,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,CAAC;IACxC,MAAM,UAAU,GAAG,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAE3C,IAAI,MAAM,CAAC;IACX,IAAI,CAAC;QACH,MAAM,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;IAAC,OAAO,CAAM,EAAE,CAAC;QAChB,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,8BAA8B,GAAG,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC;SAC/F,CAAC;IACJ,CAAC;IAED,0EAA0E;IAC1E,IAAI,UAAU,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IACtE,IAAI,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtD,UAAU,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACvC,CAAC;IAED,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,2EAA2E;IAC3E,MAAM,eAAe,GAAG,IAAI,GAAG,EAAU,CAAC;IAE1C,IAAI,UAAU,IAAI,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QAC5C,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK;aACzB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;aACxD,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC;aAC7C,KAAK,CAAC,CAAC,EAAE,aAAa,CAAC,CAAC;QAE3B,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvB,MAAM,cAAc,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;gBACvC,MAAM,QAAQ,GAAG,qBAAqB,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;gBAC/C,IAAI,QAAQ,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;oBACrD,eAAe,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;oBACpC,OAAO,GAAG,eAAe,CAAC,QAAQ,CAAC,OAAO,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC5D,CAAC;gBACD,OAAO,UAAU,CAAC,CAAC,CAAC,CAAC;YACvB,CAAC,CAAC,CAAC;YAEH,QAAQ,CAAC,IAAI,CACX,mDAAmD,aAAa,4DAA4D;gBAC5H,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,CAC5B,CAAC;QACJ,CAAC;IACH,CAAC;IAED,IAAI,UAAU,IAAI,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QAC9C,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO;aAC3B,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;aACxD,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC;aAC7C,KAAK,CAAC,CAAC,EAAE,aAAa,CAAC,CAAC;QAE3B,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvB,MAAM,gBAAgB,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;gBACzC,MAAM,QAAQ,GAAG,qBAAqB,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;gBAC/C,IAAI,QAAQ,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;oBACrD,eAAe,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;oBACpC,OAAO,GAAG,eAAe,CAAC,QAAQ,CAAC,OAAO,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC7D,CAAC;gBACD,OAAO,WAAW,CAAC,CAAC,CAAC,CAAC;YACxB,CAAC,CAAC,CAAC;YAEH,QAAQ,CAAC,IAAI,CACX,qDAAqD,aAAa,4DAA4D;gBAC9H,gBAAgB,CAAC,IAAI,CAAC,MAAM,CAAC,CAC9B,CAAC;QACJ,CAAC;IACH,CAAC;IAED,IAAI,UAAU,IAAI,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;QAChD,MAAM,OAAO,GAAG,MAAM,CAAC,SAAS;aAC7B,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;aACxD,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC;aAC7C,KAAK,CAAC,CAAC,EAAE,aAAa,CAAC,CAAC;QAE3B,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvB,MAAM,kBAAkB,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;gBAC3C,MAAM,QAAQ,GAAG,qBAAqB,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;gBAC/C,IAAI,QAAQ,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;oBACrD,eAAe,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;oBACpC,OAAO,GAAG,eAAe,CAAC,QAAQ,CAAC,OAAO,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC7D,CAAC;gBACD,OAAO,WAAW,CAAC,CAAC,CAAC,CAAC;YACxB,CAAC,CAAC,CAAC;YAEH,QAAQ,CAAC,IAAI,CACX,uDAAuD,aAAa,4DAA4D;gBAChI,kBAAkB,CAAC,IAAI,CAAC,MAAM,CAAC,CAChC,CAAC;QACJ,CAAC;IACH,CAAC;IAED,MAAM,IAAI,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC;QAC9B,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC;QACvB,CAAC,CAAC,yBAAyB,KAAK,CAAC,KAAK,YAAY,GAAG,yCAAyC,CAAC;IAEjG,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,CAAC;KAC3C,CAAC;AACJ,CAAC"}
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@cloudcart/dev-mcp",
|
|
3
|
-
"version": "0.1.
|
|
4
|
-
"description": "MCP server for CloudCart GraphQL APIs
|
|
3
|
+
"version": "0.1.3",
|
|
4
|
+
"description": "MCP server for CloudCart GraphQL APIs \u2014 helps AI assistants write correct queries and mutations",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "dist/index.js",
|
|
7
7
|
"bin": {
|