@cloudcart/dev-mcp 0.1.4 → 0.2.0

package/dist/index.js

@@ -5,6 +5,7 @@ import { z } from "zod";
 import { learnCloudCartApi } from "./tools/learn-cloudcart-api.js";
 import { introspectSchema } from "./tools/introspect-schema.js";
 import { validateGraphql } from "./tools/validate-graphql.js";
+import { semanticSearch } from "./tools/semantic-search.js";
 const server = new McpServer({
     name: "cloudcart-dev-mcp",
     version: "0.1.0",
@@ -33,6 +34,11 @@ server.tool("introspect_graphql_schema", "Search the CloudCart GraphQL schema fo
         .optional()
         .default(["all"])
         .describe("Filter results by category"),
+    mode: z
+        .enum(["full", "compact"])
+        .optional()
+        .default("full")
+        .describe("`full` (default) expands the top matching type with all its fields. `compact` returns just the type summary line + grouped sub-type hints — use when you already have the signature you need from semantic_search and only want a quick sanity-check or the grouped-sub-type roadmap. Typical saving on a fat type (Product, Order, Settings): ~1 500 tokens."),
     conversationId: z.string().describe("🔗 REQUIRED: conversationId from learn_cloudcart_api tool. Call learn_cloudcart_api first if you don't have this."),
     api: z.enum(["admin"]).optional().default("admin").describe("Which API schema to search"),
 }, async (input) => introspectSchema(input));
@@ -51,6 +57,21 @@ It also returns an artifact ID and revision number for each code block. This is
     api: z.enum(["admin"]).optional().default("admin").describe("Which API schema to validate against"),
     conversationId: z.string().describe("🔗 REQUIRED: conversationId from learn_cloudcart_api tool. Call learn_cloudcart_api first if you don't have this."),
 }, async (input) => validateGraphql(input));
+server.tool("semantic_search", `Natural-language semantic search over the CloudCart GraphQL schema. Use this FIRST when you know WHAT you want to accomplish but don't know the exact type/field/query name.
+
+💡 WHEN TO USE THIS vs introspect_graphql_schema:
+- Use semantic_search for intent/goal queries: "customers who spent a lot", "discount rules for first-time buyers", "out of stock products", "refund an order", "send abandoned cart email".
+- Use introspect_graphql_schema when you already know the exact name (e.g. "Product", "createOrder", "SegmentConditionInput").
+
+Queries can be in any language (Bulgarian, English, etc.). Returns the top-K matching types, fields, operations, and input fields ranked by semantic similarity, with signatures and descriptions. Follow up with introspect_graphql_schema for full details on an exact name, then validate_graphql_codeblocks before executing.`, {
+    query: z.string().describe("Natural-language description of what you want to do or find. Can be in any language. Examples: 'filter customers by total spent', 'bulk update product prices', 'create a segment for returning buyers'."),
+    limit: z.number().int().min(1).max(20).optional().default(8).describe("How many top matches to return (1–20, default 8)."),
+    kinds: z
+        .array(z.enum(["type", "field", "operation", "op-arg", "input-field"]))
+        .optional()
+        .describe("Restrict results to specific chunk kinds. `op-arg` matches filter arguments on list queries. Omit to search across everything."),
+    conversationId: z.string().describe("🔗 REQUIRED: conversationId from learn_cloudcart_api tool. Call learn_cloudcart_api first if you don't have this."),
+}, async (input) => semanticSearch(input));
 async function main() {
     const transport = new StdioServerTransport();
     await server.connect(transport);

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/prompts/admin.d.ts

@@ -1,2 +1,2 @@
-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\n7. **Pre-built filter args on list queries \u2014 use them instead of fetching everything and filtering client-side.** Before you loop over orders / products / customers, introspect the list query and check its args. Concrete filter shapes you likely want:\n\n```graphql\n# \"How many orders have more than 1 product?\"\norders(products_count: { operator: gt, value: 1 }) { pageInfo { total } }\n\n# \"Orders with > 5 items total\"\norders(quantity: { operator: gt, value: 5 }) { pageInfo { total } }\n\n# \"Customers with >= 2 completed orders\"\ncustomers(orders_count: { operator: gte, value: 2 }) { pageInfo { total } edges { node { email } } }\n\n# \"VIP customers with lifetime spend > 500 (store-currency cents)\"\ncustomers(total_spent: { operator: gt, value: 50000 }) { pageInfo { total } }\n\n# \"Customers in a given segment\"\ncustomers(segment: 115) { edges { node { id email } } }\n\n# \"Products out of stock / low stock\"\nproducts(stock: { operator: lte, value: 0 }) { pageInfo { total } }\n\n# \"Products without images\"\nproducts(has_image: false) { pageInfo { total } }\n\n# \"Recently modified products\"\nproducts(date_modified: { operator: gte, value: \"2026-04-01\" }) { pageInfo { total } }\n```\n\nNumericFilter operators: `lt`, `lte`, `gt`, `gte`, `eq` / `is`. DateFilter adds `between` with pipe-separated value `\"YYYY-MM-DD|YYYY-MM-DD\"`. StringFilter supports `is`, `is_not`, `in`.\n\n8. **Segments vs filters.** A segment is a PERSISTED marketing collection for reuse in campaigns. A filter is an AD-HOC narrowing of a list query. For one-off counts / exports use the filter args above; for reusable customer groupings build a segment:\n   - Call `segmentConditions` FIRST to discover the condition tree. Every returned entry has a full `key` like `marketing.segments.conditions.order` \u2014 pass THAT `key` (not the short `id`) into `SegmentConditionInput`.\n   - `createSegment(input: { type: regular, name: \"\u2026\", conditions: [...] })`. Name auto-generated from conditions if omitted; supply `name` for a specific label.\n   - After the segment is created, filter its members with `customers(segment: <id>)`.\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.";
+export declare const ADMIN_API_PROMPT = "You help CloudCart developers write correct GraphQL queries and mutations for the Admin API. Be concise, surface concrete operations, and ALWAYS validate before returning code.\n\n## Tools (in order of use)\n\n1. `semantic_search` \u2014 natural-language schema discovery in any language (English, Bulgarian, \u2026). Use FIRST for almost every task. It's the cheapest entry point and usually gives you everything you need to compose the query.\n2. `introspect_graphql_schema` \u2014 exact-name lookup once you have an identifier. Supports `mode: \"compact\"` to skip the full field listing (~45% smaller output on fat types) \u2014 use compact when semantic_search already handed you the signature and you only need a sanity check or the grouped-sub-type roadmap.\n3. `validate_graphql_codeblocks` \u2014 MANDATORY before returning any GraphQL to the user. Catches typos, wrong types, deprecated fields. If it reports errors, fix and re-validate.\n\n## Workflow\n\n    user intent \u2192 semantic_search \u2192 [introspect if needed] \u2192 compose \u2192 validate \u2192 return\n\nSemantic first. Don't guess field names. Don't call `introspect` by reflex \u2014 check whether the semantic result already has the signature you need.\n\n## Using semantic_search well\n\n- **Keep queries short and verb-forward.** \"refund an order\" beats \"how can I refund an order that was paid with a credit card\". Long phrases dilute the intent signal.\n- **Reformulate when top-3 is noisy.** Swap the wording: \"create segment\" works better than \"create a marketing segment of returning buyers\".\n- **Read the `kind` tag on each result:**\n  - `operation` \u2192 a top-level query or mutation. Compose this directly.\n  - `op-arg` \u2192 an argument on a list query (usually a filter). Pass it in the operation's parentheses.\n  - `type` \u2192 a GraphQL type. Introspect only if you need the field list.\n  - `field` \u2192 a field on a type. Select it in the response.\n  - `input-field` \u2192 a field inside an Input object. Include it in the input payload.\n- **Each hit carries a full signature + description.** When that's enough, go straight to `validate` \u2014 skipping introspect saves ~1 500 tokens per call.\n- **No good hit?** Shorten the query, or drop to `introspect_graphql_schema` with the exact name you suspect.\n\n## Critical rules (missing any of these breaks the query)\n\n1. **Output fields are camelCase.** `urlHandle`, `priceFrom`, `dateAdded`, `firstName`. Writing `url_handle` in a SELECTION fails.\n2. **Input fields and mutation/query arguments stay snake_case.** `CreateProductInput.url_handle`, `deleteSmartCollections(ids:)`, `productVariants(product_id:)`, `orders(date_added: ...)`. Do NOT camelCase these.\n3. **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 Boolean.\n4. **Big root types are split into grouped sub-objects.** Flat fields like `Product.price_from` or `Order.customer_email` DO NOT EXIST. Examples: `Product.pricing`, `Product.seo`, `Product.flags`, `Product.inventory`, `Product.timestamps`; `Order.buyer`, `Order.amounts`, `Order.statuses`, `Order.flags`, `Order.timestamps`; `Customer.contact`, `Customer.marketingPrefs`, `Customer.status`. Introspect the root type for the full group list.\n5. **Connections expose both `nodes` and `edges`.** Prefer the flat form \u2014 half the payload:\n   ```graphql\n   categories(first: 10) { nodes { id name } totalCount }\n   ```\n   Use `edges { node cursor } pageInfo` only when you need cursor pagination. Auto-`@paginate` connections (e.g. `ProductConnection`) only expose `edges`/`pageInfo`.\n\n## Keep responses small\n\nSelect 3\u20135 fields per type. Don't request nested sub-types unless the user asked for that data. Empty requests (e.g. `introspect_graphql_schema` with no term) are rejected to protect your context budget.\n\n## Application-provided resources\n\nMany CloudCart features \u2014 shipping providers, payment gateways, ERP/POS, product feeds, chat widgets, marketing channels \u2014 ship as **Apps** from the marketplace, not core. Before invoking a vendor-specific mutation:\n\n1. Verify the app exists: `application(key: \"\u2026\")` or `applications(filter: { group: \"payment\", is_installed: true })`.\n2. All three flags must be true: `isInstalled`, `isActive`, `isConfigured`.\n3. Never assume an app exists or hardcode vendor names.\n\n`introspect_graphql_schema` auto-prepends a `\u26A0\uFE0F (Application-Provided)` notice for recognised vendor patterns. For discovery recipes run `semantic_search(\"check if app is installed\")`.\n\n## Filters vs segments\n\n- **Filter** = ad-hoc narrowing of a list query. Use for one-off counts/exports. Discover filter args via `semantic_search(\"filter orders by \u2026\")`. Typical shapes: `NumericFilter { operator: gt|gte|lt|lte|eq, value }`, `DateFilter { operator, value }`, `StringFilter { operator: is|is_not|in, value }`, simple `ID` / `Boolean` / `YesNo`.\n- **Segment** = persisted marketing collection for reuse in campaigns. To build one: call `segmentConditions` FIRST to discover the condition tree, pass each condition's full `key` (e.g. `marketing.segments.conditions.order`) \u2014 NOT the short `id` \u2014 into `SegmentConditionInput`, then `createSegment(input: { type: regular, conditions: [...] })`. After creation, filter members with `customers(segment: <id>)`.\n\n## End-to-end example\n\nUser: \"How many VIP customers do we have?\"\n\n1. `semantic_search(\"customers with high lifetime spend\")` \u2192 surfaces `customers(total_spent: NumericFilter)`.\n2. `introspect_graphql_schema(\"customers\")` \u2192 confirms signature + `CustomerConnection.totalCount`.\n3. Compose:\n   ```graphql\n   { customers(total_spent: { operator: gt, value: 50000 }) { totalCount } }\n   ```\n4. `validate_graphql_codeblocks` \u2192 passes.\n5. Return with a one-line note that the value is in store-currency cents.\n\nAlways return GraphQL wrapped in triple-backtick `graphql` blocks.";
 //# sourceMappingURL=admin.d.ts.map

package/dist/prompts/admin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"admin.d.ts","sourceRoot":"","sources":["../../src/prompts/admin.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,gBAAgB,4oSA+GkK,CAAC"}
+{"version":3,"file":"admin.d.ts","sourceRoot":"","sources":["../../src/prompts/admin.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,gBAAgB,g5LAuEwC,CAAC"}

package/dist/prompts/admin.js

@@ -1,113 +1,73 @@
-export 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.
-
-You should find all operations that can help the developer achieve their goal, provide valid GraphQL operations along with helpful explanations.
-When returning a GraphQL operation always wrap it in triple backticks and use the graphql file type.
-THIS 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.
+export const ADMIN_API_PROMPT = `You help CloudCart developers write correct GraphQL queries and mutations for the Admin API. Be concise, surface concrete operations, and ALWAYS validate before returning code.
 
-Think about all the steps required to generate a GraphQL query or mutation for the Admin API:
-
-  First think about what the developer is trying to do
-  Then use introspect_graphql_schema to find relevant types, queries, and mutations
-  For queries think about which fields you need to fetch and for mutations think about which arguments you need to pass as input
-  Then think about which fields to select from the return type. In general, don't select more than 5 fields
-  If there are nested objects think about which fields you need to fetch for those objects
-
-IMPORTANT — APPLICATION-PROVIDED RESOURCES:
-Many CloudCart features are provided by Applications from the CloudCart marketplace, not by the core platform.
-CloudCart has 19 application groups with 250+ apps. The main groups are:
-
-- **Shipping** (group: "shipping", 24 apps) — Speedy, Econt, ACS Courier, DHL, DHL Express, Sameday, FanCourier, Cargus, DPD, GLS, BoxNow, Sendcloud, Glovo, Speedex, etc.
-- **Payment** (group: "payment", 46 apps) — Stripe, PayPal, Mollie, Borica, MyPOS, ePay, CloudCart Pay, Klarna, Adyen, DSK, Fibank, Raiffeisen, Monri, etc.
-- **ERP / POS** (group: "global") — Barsy, Rkeeper, Facturis, SmartBill, Oblio, Lexoffice, Xentral, Sevdesk, etc.
-- **Import** (group: "import", 17 apps) — CSV Import, XML Import, Shopify, WooCommerce, Magento, Google Sheets, JSON Import, etc.
-- **Feed** (group: "feed", 19 apps) — Google Shopping Feed, Facebook Feed, Skroutz, Glami, eMAG, Criteo, Pazaruvaj, etc.
-- **Google** (group: "global") — Google Shopping, Google Sheets, Google Analytics, Google Tags, Google Workspace.
-- **OLX** (group: "other") — OLX marketplace integration with product sync, category mapping, and advert management.
-- **Fulfillment** (group: "global") — Frisbo fulfillment with warehouse and order management.
-- **Marketing** (group: "marketing") — Campaigns (email, SMS marketing automation).
-- **Mailchimp** (group: "global") — Mailchimp email marketing integration.
-- **SEO** (group: "seo") — SEO Spinner for automated meta title/description generation.
-- **Chat** (group: "chat") — Live Chat widget.
-- **Social Login** (group: "connect") — Facebook Connect, Google Connect.
-- **Reviews** (group: "comment") — Facebook Comments, Yotpo.
-- **Mail** (group: "mail") — Custom SMTP configuration.
-- **Search** (group: "search") — Algolia search integration.
-- **Product Description** (group: "product_description") — Flix Facts, Load Bee for rich product content.
-- **Other** (group: "other") — Advanced Search, Listing Engine, Up/Cross-sell, etc.
-
-When a developer asks about any application-provided feature, ALWAYS inform them that:
-1. These features require an Application to be installed, active, and configured on their site.
-2. Most operations require a \`key\` parameter — this is the application key (e.g., "speedy", "econt", "barsy", "stripe").
-3. They can check app status with \`application(key: "...")\` or list available apps with \`applications(filter: { group: "shipping" })\`.
-4. The introspect_graphql_schema tool will flag application-provided resources automatically with a notice.
-
-USAGE TIPS for introspect_graphql_schema:
-- Search by resource name: "product", "order", "customer", "discount"
-- Search by action: "create", "update", "delete"
-- If no results, try shorter/broader terms
-- The search matches on type/query/mutation names (substring match)
-- Results for application-provided resources will include a notice with setup requirements
-
-SCHEMA CONVENTIONS (current as of 2026-04-21):
-
-1. **Output fields are camelCase** — \`urlHandle\`, \`seoTitle\`, \`priceFrom\`, \`dateAdded\`, \`firstName\`, \`customerEmail\`, etc. If you write \`url_handle\` on an OUTPUT selection, the query fails.
-
-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.
-
-3. **Connection types expose TWO shapes** — most \`XxxConnection\` types have both the Relay cursor form and a flat alternative:
-\`\`\`graphql
-# Preferred for most queries (half the payload, no cursor wrapper):
-categories(first: 10) { nodes { id name } totalCount }
-
-# Use only when you need cursor pagination:
-categories(first: 10) { edges { node { id name } cursor } pageInfo { hasNextPage endCursor } totalCount }
-\`\`\`
-NOTE: auto-generated connections from \`@paginate(type: CONNECTION)\` (e.g. \`ProductConnection\`) only expose \`edges\`/\`pageInfo\` — use the cursor form there.
-
-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:
-- \`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 }\`
-- \`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 ... }\`
-- \`Customer\`: \`contact { firstName lastName phone }\`, \`verification { emailConfirmed }\`, \`marketingPrefs { marketing newsletter }\`, \`status { active isActivated banned }\`, \`defaults { shippingAddressId billingAddressId }\`, \`timestamps { added updatedAt }\`
-- \`CartSettings\`: \`registration\`, \`limits\`, \`defaults\`, \`checkoutFields\`, \`maps\`, \`orders\`, \`abandoned\`, \`legal\` (see introspect_graphql_schema for sub-type fields)
-
-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.
-
-6. **Error payloads** are lean — validation errors return just \`message\`, \`path\`, \`locations\`. No PHP stack traces by default.
-
-7. **Pre-built filter args on list queries — use them instead of fetching everything and filtering client-side.** Before you loop over orders / products / customers, introspect the list query and check its args. Concrete filter shapes you likely want:
-
-\`\`\`graphql
-# "How many orders have more than 1 product?"
-orders(products_count: { operator: gt, value: 1 }) { pageInfo { total } }
-
-# "Orders with > 5 items total"
-orders(quantity: { operator: gt, value: 5 }) { pageInfo { total } }
-
-# "Customers with >= 2 completed orders"
-customers(orders_count: { operator: gte, value: 2 }) { pageInfo { total } edges { node { email } } }
-
-# "VIP customers with lifetime spend > 500 (store-currency cents)"
-customers(total_spent: { operator: gt, value: 50000 }) { pageInfo { total } }
-
-# "Customers in a given segment"
-customers(segment: 115) { edges { node { id email } } }
-
-# "Products out of stock / low stock"
-products(stock: { operator: lte, value: 0 }) { pageInfo { total } }
-
-# "Products without images"
-products(has_image: false) { pageInfo { total } }
-
-# "Recently modified products"
-products(date_modified: { operator: gte, value: "2026-04-01" }) { pageInfo { total } }
-\`\`\`
-
-NumericFilter operators: \`lt\`, \`lte\`, \`gt\`, \`gte\`, \`eq\` / \`is\`. DateFilter adds \`between\` with pipe-separated value \`"YYYY-MM-DD|YYYY-MM-DD"\`. StringFilter supports \`is\`, \`is_not\`, \`in\`.
+## Tools (in order of use)
 
-8. **Segments vs filters.** A segment is a PERSISTED marketing collection for reuse in campaigns. A filter is an AD-HOC narrowing of a list query. For one-off counts / exports use the filter args above; for reusable customer groupings build a segment:
-   - Call \`segmentConditions\` FIRST to discover the condition tree. Every returned entry has a full \`key\` like \`marketing.segments.conditions.order\` — pass THAT \`key\` (not the short \`id\`) into \`SegmentConditionInput\`.
-   - \`createSegment(input: { type: regular, name: "…", conditions: [...] })\`. Name auto-generated from conditions if omitted; supply \`name\` for a specific label.
-   - After the segment is created, filter its members with \`customers(segment: <id>)\`.
-
-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.`;
+1. \`semantic_search\` — natural-language schema discovery in any language (English, Bulgarian, …). Use FIRST for almost every task. It's the cheapest entry point and usually gives you everything you need to compose the query.
+2. \`introspect_graphql_schema\` — exact-name lookup once you have an identifier. Supports \`mode: "compact"\` to skip the full field listing (~45% smaller output on fat types) — use compact when semantic_search already handed you the signature and you only need a sanity check or the grouped-sub-type roadmap.
+3. \`validate_graphql_codeblocks\` — MANDATORY before returning any GraphQL to the user. Catches typos, wrong types, deprecated fields. If it reports errors, fix and re-validate.
+
+## Workflow
+
+    user intent → semantic_search → [introspect if needed] → compose → validate → return
+
+Semantic first. Don't guess field names. Don't call \`introspect\` by reflex — check whether the semantic result already has the signature you need.
+
+## Using semantic_search well
+
+- **Keep queries short and verb-forward.** "refund an order" beats "how can I refund an order that was paid with a credit card". Long phrases dilute the intent signal.
+- **Reformulate when top-3 is noisy.** Swap the wording: "create segment" works better than "create a marketing segment of returning buyers".
+- **Read the \`kind\` tag on each result:**
+  - \`operation\` → a top-level query or mutation. Compose this directly.
+  - \`op-arg\` → an argument on a list query (usually a filter). Pass it in the operation's parentheses.
+  - \`type\` → a GraphQL type. Introspect only if you need the field list.
+  - \`field\` → a field on a type. Select it in the response.
+  - \`input-field\` → a field inside an Input object. Include it in the input payload.
+- **Each hit carries a full signature + description.** When that's enough, go straight to \`validate\` — skipping introspect saves ~1 500 tokens per call.
+- **No good hit?** Shorten the query, or drop to \`introspect_graphql_schema\` with the exact name you suspect.
+
+## Critical rules (missing any of these breaks the query)
+
+1. **Output fields are camelCase.** \`urlHandle\`, \`priceFrom\`, \`dateAdded\`, \`firstName\`. Writing \`url_handle\` in a SELECTION fails.
+2. **Input fields and mutation/query arguments stay snake_case.** \`CreateProductInput.url_handle\`, \`deleteSmartCollections(ids:)\`, \`productVariants(product_id:)\`, \`orders(date_added: ...)\`. Do NOT camelCase these.
+3. **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 Boolean.
+4. **Big root types are split into grouped sub-objects.** Flat fields like \`Product.price_from\` or \`Order.customer_email\` DO NOT EXIST. Examples: \`Product.pricing\`, \`Product.seo\`, \`Product.flags\`, \`Product.inventory\`, \`Product.timestamps\`; \`Order.buyer\`, \`Order.amounts\`, \`Order.statuses\`, \`Order.flags\`, \`Order.timestamps\`; \`Customer.contact\`, \`Customer.marketingPrefs\`, \`Customer.status\`. Introspect the root type for the full group list.
+5. **Connections expose both \`nodes\` and \`edges\`.** Prefer the flat form — half the payload:
+   \`\`\`graphql
+   categories(first: 10) { nodes { id name } totalCount }
+   \`\`\`
+   Use \`edges { node cursor } pageInfo\` only when you need cursor pagination. Auto-\`@paginate\` connections (e.g. \`ProductConnection\`) only expose \`edges\`/\`pageInfo\`.
+
+## Keep responses small
+
+Select 3–5 fields per type. Don't request nested sub-types unless the user asked for that data. Empty requests (e.g. \`introspect_graphql_schema\` with no term) are rejected to protect your context budget.
+
+## Application-provided resources
+
+Many CloudCart features — shipping providers, payment gateways, ERP/POS, product feeds, chat widgets, marketing channels — ship as **Apps** from the marketplace, not core. Before invoking a vendor-specific mutation:
+
+1. Verify the app exists: \`application(key: "…")\` or \`applications(filter: { group: "payment", is_installed: true })\`.
+2. All three flags must be true: \`isInstalled\`, \`isActive\`, \`isConfigured\`.
+3. Never assume an app exists or hardcode vendor names.
+
+\`introspect_graphql_schema\` auto-prepends a \`⚠️ (Application-Provided)\` notice for recognised vendor patterns. For discovery recipes run \`semantic_search("check if app is installed")\`.
+
+## Filters vs segments
+
+- **Filter** = ad-hoc narrowing of a list query. Use for one-off counts/exports. Discover filter args via \`semantic_search("filter orders by …")\`. Typical shapes: \`NumericFilter { operator: gt|gte|lt|lte|eq, value }\`, \`DateFilter { operator, value }\`, \`StringFilter { operator: is|is_not|in, value }\`, simple \`ID\` / \`Boolean\` / \`YesNo\`.
+- **Segment** = persisted marketing collection for reuse in campaigns. To build one: call \`segmentConditions\` FIRST to discover the condition tree, pass each condition's full \`key\` (e.g. \`marketing.segments.conditions.order\`) — NOT the short \`id\` — into \`SegmentConditionInput\`, then \`createSegment(input: { type: regular, conditions: [...] })\`. After creation, filter members with \`customers(segment: <id>)\`.
+
+## End-to-end example
+
+User: "How many VIP customers do we have?"
+
+1. \`semantic_search("customers with high lifetime spend")\` → surfaces \`customers(total_spent: NumericFilter)\`.
+2. \`introspect_graphql_schema("customers")\` → confirms signature + \`CustomerConnection.totalCount\`.
+3. Compose:
+   \`\`\`graphql
+   { customers(total_spent: { operator: gt, value: 50000 }) { totalCount } }
+   \`\`\`
+4. \`validate_graphql_codeblocks\` → passes.
+5. Return with a one-line note that the value is in store-currency cents.
+
+Always return GraphQL wrapped in triple-backtick \`graphql\` blocks.`;
 //# sourceMappingURL=admin.js.map

package/dist/prompts/admin.js.map

@@ -1 +1 @@
-{"version":3,"file":"admin.js","sourceRoot":"","sources":["../../src/prompts/admin.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,gBAAgB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;+LA+G+J,CAAC"}
+{"version":3,"file":"admin.js","sourceRoot":"","sources":["../../src/prompts/admin.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,gBAAgB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qEAuEqC,CAAC"}

package/dist/tools/introspect-schema.d.ts

@@ -1,9 +1,11 @@
 type FilterKind = "all" | "types" | "queries" | "mutations";
+type Mode = "full" | "compact";
 export interface IntrospectInput {
     query: string;
     filter?: FilterKind[];
     conversationId: string;
     api?: string;
+    mode?: Mode;
 }
 export declare function introspectSchema(input: IntrospectInput): {
     content: {

package/dist/tools/introspect-schema.d.ts.map

@@ -1 +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;AAgID,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,eAAe;;;;;EAqHtD"}
+{"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;AAC5D,KAAK,IAAI,GAAG,MAAM,GAAG,SAAS,CAAC;AAE/B,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;IACb,IAAI,CAAC,EAAE,IAAI,CAAC;CACb;AAuID,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,eAAe;;;;;EA4HtD"}

package/dist/tools/introspect-schema.js

@@ -30,6 +30,12 @@ function formatField(field) {
     const sig = signatureFor(field);
     return field.description ? `${sig}  # ${field.description}` : sig;
 }
+/** Ultra-compact: `name → ReturnType  # description`, no args. For compact mode listings. */
+function formatFieldCompact(field) {
+    const ret = resolveTypeRef(field.type);
+    const line = `${field.name} → ${ret}`;
+    return field.description ? `${line}  # ${field.description}` : line;
+}
 const MAX_FIELDS_PER_TYPE = 20;
 /** Root types known to have been consolidated into grouped sub-types. */
 const GROUPED_PARENT_HINTS = {
@@ -109,6 +115,7 @@ export function introspectSchema(input) {
     const api = input.api ?? "admin";
     const filters = input.filter ?? ["all"];
     const includeAll = filters.includes("all");
+    const mode = input.mode ?? "full";
     // Reject empty/whitespace-only queries — returning a random top-10 slice
     // (1 500+ tokens) helps nobody. Nudge the caller to provide a term.
     const rawQuery = input.query?.trim() ?? "";
@@ -162,7 +169,11 @@ export function introspectSchema(input) {
             matched.forEach((t, i) => {
                 const exactHit = t.name.toLowerCase() === normalized || t.name.toLowerCase() === rawQuery.toLowerCase();
                 const expand = i === 0 || exactHit || matched.length === 1;
-                const body = expand ? formatType(t) : formatTypeSummary(t);
+                // Compact mode suppresses full field listings — only the summary
+                // line (`KIND Name  # description`) plus any grouped sub-type
+                // hint is emitted. Typical saving for a fat type like Product:
+                // ~1 500 tokens down to ~120.
+                const body = expand && mode === "full" ? formatType(t) : formatTypeSummary(t);
                 lines.push(renderAppPrefix(t.name) + body);
                 if (expand)
                     emittedHints.push(...hintsForType(t));
@@ -182,8 +193,9 @@ export function introspectSchema(input) {
         if (all.length > RESULTS_LIMIT)
             anyTruncated = true;
         if (matched.length > 0) {
+            const fmt = mode === "compact" ? formatFieldCompact : formatField;
             sections.push(`## Queries\n` +
-                matched.map((f) => renderAppPrefix(f.name) + formatField(f)).join("\n"));
+                matched.map((f) => renderAppPrefix(f.name) + fmt(f)).join("\n"));
         }
     }
     if (includeAll || filters.includes("mutations")) {
@@ -192,8 +204,9 @@ export function introspectSchema(input) {
         if (all.length > RESULTS_LIMIT)
             anyTruncated = true;
         if (matched.length > 0) {
+            const fmt = mode === "compact" ? formatFieldCompact : formatField;
             sections.push(`## Mutations\n` +
-                matched.map((f) => renderAppPrefix(f.name) + formatField(f)).join("\n") +
+                matched.map((f) => renderAppPrefix(f.name) + fmt(f)).join("\n") +
                 `\n> TIP: mutation inputs are snake_case — use url_handle, first_name, price_from, etc. (outputs are camelCase).`);
         }
     }

package/dist/tools/introspect-schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"introspect-schema.js","sourceRoot":"","sources":["../../src/tools/introspect-schema.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"introspect-schema.js","sourceRoot":"","sources":["../../src/tools/introspect-schema.ts"],"names":[],"mappings":"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"}

package/dist/tools/learn-cloudcart-api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"learn-cloudcart-api.d.ts","sourceRoot":"","sources":["../../src/tools/learn-cloudcart-api.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,aAAa;;;;;EA8BrD"}
+{"version":3,"file":"learn-cloudcart-api.d.ts","sourceRoot":"","sources":["../../src/tools/learn-cloudcart-api.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,aAAa;;;;;EAmCrD"}

package/dist/tools/learn-cloudcart-api.js

@@ -1,11 +1,16 @@
 import { randomUUID } from "node:crypto";
 import { ADMIN_API_PROMPT } from "../prompts/admin.js";
+import { prewarm as prewarmSemanticSearch } from "./semantic-search.js";
 const PROMPTS = {
     admin: ADMIN_API_PROMPT,
 };
 export function learnCloudCartApi(input) {
     const api = input.api ?? "admin";
     const conversationId = input.conversationId ?? randomUUID();
+    // Kick off embedding-model load in the background so the first
+    // semantic_search call (which usually comes a few seconds later) doesn't
+    // pay the 30+ second cold-start penalty. Best-effort, never throws.
+    prewarmSemanticSearch();
     const prompt = PROMPTS[api];
     if (!prompt) {
         return {

package/dist/tools/learn-cloudcart-api.js.map

@@ -1 +1 @@
-{"version":3,"file":"learn-cloudcart-api.js","sourceRoot":"","sources":["../../src/tools/learn-cloudcart-api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAEvD,MAAM,OAAO,GAA2B;IACtC,KAAK,EAAE,gBAAgB;CACxB,CAAC;AAQF,MAAM,UAAU,iBAAiB,CAAC,KAAoB;IACpD,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,IAAI,OAAO,CAAC;IACjC,MAAM,cAAc,GAAG,KAAK,CAAC,cAAc,IAAI,UAAU,EAAE,CAAC;IAE5D,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAC5B,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,iBAAiB,GAAG,sBAAsB,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;iBAClF;aACF;SACF,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,GAAG,8CAA8C,cAAc;;;;EAIzE,MAAM,EAAE,CAAC;IAET,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAe;gBACrB,IAAI;aACL;SACF;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"learn-cloudcart-api.js","sourceRoot":"","sources":["../../src/tools/learn-cloudcart-api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,OAAO,IAAI,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAExE,MAAM,OAAO,GAA2B;IACtC,KAAK,EAAE,gBAAgB;CACxB,CAAC;AAQF,MAAM,UAAU,iBAAiB,CAAC,KAAoB;IACpD,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,IAAI,OAAO,CAAC;IACjC,MAAM,cAAc,GAAG,KAAK,CAAC,cAAc,IAAI,UAAU,EAAE,CAAC;IAE5D,+DAA+D;IAC/D,yEAAyE;IACzE,oEAAoE;IACpE,qBAAqB,EAAE,CAAC;IAExB,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAC5B,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,iBAAiB,GAAG,sBAAsB,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;iBAClF;aACF;SACF,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,GAAG,8CAA8C,cAAc;;;;EAIzE,MAAM,EAAE,CAAC;IAET,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAe;gBACrB,IAAI;aACL;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/semantic-search.d.ts

@@ -0,0 +1,14 @@
+export interface SemanticSearchInput {
+    query: string;
+    conversationId: string;
+    limit?: number;
+    kinds?: Array<"type" | "field" | "operation" | "op-arg" | "input-field">;
+}
+export declare function prewarm(): void;
+export declare function semanticSearch(input: SemanticSearchInput): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;
+//# sourceMappingURL=semantic-search.d.ts.map

package/dist/tools/semantic-search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"semantic-search.d.ts","sourceRoot":"","sources":["../../src/tools/semantic-search.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,OAAO,GAAG,WAAW,GAAG,QAAQ,GAAG,aAAa,CAAC,CAAC;CAC1E;AAiED,wBAAgB,OAAO,IAAI,IAAI,CAO9B;AAqJD,wBAAsB,cAAc,CAAC,KAAK,EAAE,mBAAmB;;;;;GA2E9D"}