@carrierllc/mcp 0.13.7 → 0.13.10

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@carrierllc/mcp",
-  "version": "0.13.7",
+  "version": "0.13.10",
   "description": "Carrier MCP \u2014 natural-language control of MVNO/eSIM fleets via eSIMVault OCS. Stdio mode for direct integration with Claude Desktop, Cursor, Windsurf, and MCP-compatible clients. Ships the `carrier` CLI (plugin install + white-label eSIM storefront scaffold).",
   "license": "MIT",
   "author": "Carrier (Lifecycle Innovations Limited)",
@@ -51,6 +51,7 @@
     "eslint": "^10.9.1",
     "tsup": "^8.5.1",
     "typescript": "^5.9.3",
+    "@carrierllc/sdk": "workspace:*",
     "@carrier/ai": "workspace:*",
     "@carrier/ocs-client": "workspace:*",
     "@carrier/ocs-spec": "workspace:*",

package/plugin/carrier/skills/publish-storefront/SKILL.md

@@ -0,0 +1,114 @@
+---
+name: publish-storefront
+description: Publish a Carrier-hosted eSIM storefront with POST /v1/storefronts. Use when a brand should go live on a slug.stores.carrier.llc address without a git deploy. Do not use the operator OCS catalog for this.
+argument-hint: "[slug] [brand name]"
+---
+
+# Publish a hosted storefront
+
+This is the no-code path. Carrier hosts the shop. A slug is a subdomain, not a repository. A brand name such as Acme Mobile is stored as acme-mobile.
+
+The description above is the trigger. Load this skill when the task is a hosted shop. Do not load the operator MCP catalog first.
+
+## Install, if this skill is not already available
+
+Once per user, so every project sees it:
+
+```bash
+npx skills add https://carrier.llc -g -a cursor -a claude-code -y
+```
+
+If that host is not published yet, install this directory:
+
+```bash
+npx skills add https://github.com/Lifecycle-Innovations-Limited/carrier.llc/tree/main/apps/mcp-stdio/plugin/carrier/skills/publish-storefront -g -a cursor -a claude-code -y
+```
+
+## Publish
+
+`POST https://api.carrier.llc/v1/storefronts`
+
+Required header: `Idempotency-Key` (stable per slug, max 255 characters).
+
+Auth: `Authorization: Bearer` with an `ak_` key from the console. Do not put the key in the repo.
+
+```json
+{
+  "slug": "acme",
+  "name": "Acme Mobile",
+  "status": "published",
+  "theme": { "accent": "#112233" },
+  "copy": {
+    "hero": "Acme lands",
+    "tagline": "Acme voice",
+    "supportEmail": "hello@acme.example",
+    "legalName": "Acme Ltd"
+  }
+}
+```
+
+The first publish needs the brand's own hero, tagline, support email, and legal name. Leaving them out does not fall back to Carrier's address.
+
+A replay of the same key returns the original store. Send theme and copy again on that replay: the tool merges them onto the saved theme so a new accent does not wipe the logo. A second brand uses a different slug.
+
+## Price
+
+`POST https://api.carrier.llc/v1/storefronts/{id}/plans`
+
+```json
+{
+  "slug": "eu-1gb",
+  "name": "EU 1 GB",
+  "price_cents": 900,
+  "currency": "EUR",
+  "ocs_package_template_id": 77,
+  "data_gb": 1,
+  "validity_days": 7,
+  "regions": ["DE", "FR"],
+  "description": "Works in France.",
+  "active": true
+}
+```
+
+`price_cents` is the Stripe minor-unit amount. For EUR, 900 is 9.00. For JPY, 1000 is 1000 yen, not 100000. The OCS template id is the package that gets issued. Changing this price does not change another slug. Leave out data, validity, countries, buyer text, or whether the plan is for sale, and those stored values stay. When the shop has one plan, a price alone is enough: the CLI and the intent tool reuse that plan's slug, name, currency, and template id. A new plan can omit currency when every saved plan uses the same code.
+
+To copy a connectivity plan the org already created, send its id instead of the template fields. Optional `price_cents` overrides the retail price. The shop address is derived from the plan name.
+
+```json
+{ "product_id": "cnp_abcdef0123456789abcdef0123456789", "price_cents": 1200 }
+```
+
+A color or legal-name patch merges onto the stored shop, so the logo and hero stay. Send only the fields you want to change:
+
+`PATCH https://api.carrier.llc/v1/storefronts/{id}`
+
+```json
+{ "theme": { "accent": "#112233", "logoUrl": "https://cdn.example/logo.png" }, "copy": { "hero": "Acme lands" } }
+```
+
+CLI, after `carrier login`, or with npx:
+
+```bash
+carrier site publish --slug acme --name "Acme Mobile" \
+  --accent "#112233" --hero "Acme lands" --tagline "Acme voice" \
+  --support-email hello@acme.example --legal-name "Acme Ltd" \
+  --product cnp_abcdef0123456789abcdef0123456789 --price 12.00
+```
+
+`--price 9.00` is the same retail amount as `price_cents` 900. `--price 1000 --currency JPY` stores 1000. `--data-gb "1 GB"` stores 1. `--data-gb Unlimited` stores 0, which the shop shows as Unlimited. `--validity-days "7 days"` stores 7. `--countries "France, UK"` stores FR and GB. `--logo` is an https address or a PNG, JPEG, WebP, or GIF file under 70 KB. The intent field `logo_url` accepts that https address or the same picture as a data URL. An SVG or a `javascript:` address is refused.
+
+```bash
+npx -y -p @carrierllc/mcp carrier site publish --slug acme --name "Acme Mobile" \
+  --hero "Acme lands" --tagline "Acme voice" \
+  --support-email hello@acme.example --legal-name "Acme Ltd"
+```
+
+The CLI reads the existing store and merges color and copy before the PATCH. A successful publish prints `https://{slug}.stores.carrier.llc`.
+
+`carrier site deploy` is the self-hosted twin. It does not publish this record.
+
+`regions` accepts country names or two-letter codes. France is stored as FR and UK as GB. Leave it out to keep the countries already saved on that plan. A price change on one slug does not change another slug's countries.
+
+`description` is the sentence buyers read under the plan name. Leave it out to keep the saved sentence. The intent tool field is `plan_description`. The CLI flag is `--plan-text`.
+
+The developer MCP tool is `publish_storefront` on the intent server. It accepts `accent`, `hero`, `product_id`, `plan_slug`, `plan_name`, `price` (`9.00`, or `1000` with currency JPY) or `price_cents`, `currency`, `ocs_package_template_id`, `data_gb` (`1 GB`), `validity_days` (`7 days`), `regions` (France or DE), and `plan_description`. `product_id` copies a connectivity plan and does not need a template id. It is not an operator OCS tool.

package/templates/storefront/src/vendor/carrier/client.ts

@@ -103,7 +103,15 @@ export async function fetchTemplateCatalog(): Promise<TemplateCatalog> {
   const base = apiBase();
   if (!base) return sampleCatalog("unconfigured");
   try {
-    const res = await fetch(`${base}/api/templates`, { next: { revalidate: 3600 } });
+    const slug = process.env.NEXT_PUBLIC_STOREFRONT_SLUG?.trim();
+    const templatesPath = slug
+      ? `/api/templates?storefront=${encodeURIComponent(slug)}`
+      : "/api/templates";
+    const res = await fetch(`${base}${templatesPath}`, {
+      next: slug
+        ? { revalidate: 60, tags: [`storefront:${slug}`] }
+        : { revalidate: 3600 },
+    });
     if (!res.ok) return sampleCatalog("upstream-error");
     const templates = (await res.json()) as SkuTemplate[];
     if (!Array.isArray(templates) || templates.length === 0) {