@commercelayer/agent-cli 0.1.4 → 0.1.7

package/README.md

@@ -16,7 +16,7 @@ npx -y @commercelayer/agent-cli@latest init --name "The Blue Brand"   # runs c11
 | `init [--name <business name>]` | Create a sandbox store, with no login. The name (the folder name when absent) names the organization; the org slug and store hostname derive from it, numbered when taken. Writes `store.yml` (a commented template) and `credentials`. Reuses the store if they exist. |
 | `plan` | Validate `store.yml` and the product files, and list what `apply` would create, update or delete: markets, products, and the store's name and policies. |
 | `apply [--allow-delete]` | Make the store match the files. Refuses deletes without the flag. |
-| `storefront init [--force]` | Write `storefront/index.html`: a static page on [drop-in.js](https://commercelayer.github.io/drop-in.js/) listing the products in `store.yml`, with the hosted cart and checkout, wired to the sandbox's sales channel. Refuses to overwrite without the flag. |
+| `storefront init [--force]` | Write `storefront/index.html`: a static page on [drop-in.js](https://commercelayer.github.io/drop-in.js/) listing the products in `store.yml`, with a minicart that slides in on add to cart, and the hosted cart and checkout, wired to the sandbox's sales channel. Refuses to overwrite without the flag. |
 | `storefront publish` | Upload the folder at `storefront.path` (default `storefront`) to the store host. |
 | `orders test [--sku <id>] [--quantity <n>] [--country <CC>] [--code <discount>] [--via-cart] [--decline]` | Buy from the store over UCP as a shopping agent would: discover, search, (cart,) checkout, address, pay with the sandbox handler, read the order back. Prints the order and every step. |
 | `orders list` | The orders placed in the store, newest first, as UCP order entities. |

package/dist/api/client.js

@@ -18,14 +18,14 @@ export function createApi(auth) {
             data = res.body ? JSON.parse(res.body) : null;
         }
         catch {
-            fail('api_error', `${base} answered ${res.status} with something that is not JSON.`, 'Try again. If it keeps happening, report it at https://commercelayer.ai/support with the output of `c11r status`.');
+            fail('api_error', `${base} answered ${res.status} with something that is not JSON.`, 'Try again. If it keeps happening, tell the human, with the output of `c11r status`.');
         }
         if (res.status < 400)
             return data;
         const err = data?.error;
         if (err)
             fail(err.code, err.message, err.hint);
-        fail('api_error', `The API answered ${res.status}.`, 'Try again. If it keeps happening, report it at https://commercelayer.ai/support with the output of `c11r status`.');
+        fail('api_error', `The API answered ${res.status}.`, 'Try again. If it keeps happening, tell the human, with the output of `c11r status`.');
     };
     return {
         createSandbox: (name) => request('POST', '/sandboxes', { name }),

package/dist/bin.js

@@ -77,7 +77,7 @@ run()
     }
     else {
         const message = e instanceof Error ? e.message : String(e);
-        print({ error: { code: 'internal', message, hint: 'This is a bug in the CLI. Report it at https://commercelayer.ai/support with this output.' } });
+        print({ error: { code: 'internal', message, hint: 'This is a bug in the CLI. Tell the human, with this output, and try again with npx -y @commercelayer/agent-cli@latest in case it is already fixed.' } });
     }
     process.exit(1);
 });

package/dist/commands.js

@@ -18,7 +18,7 @@ export const HELP = {
     init: 'Create a sandbox store for this repo, with no login: c11r init --name "<business name>" (the folder name when --name is absent). The name becomes the organization\'s name, and the org slug and store hostname derive from it. Writes .commercelayer/store.yml and .commercelayer/credentials. Reuses the store if store.yml already exists.',
     plan: 'Show what apply would create, update or delete: markets, products and the store\'s name and policies, from .commercelayer/store.yml and the product files under .commercelayer/products/ (*.yml lists, *.csv rows, merged by sku).',
     apply: 'Make the store match .commercelayer/store.yml and .commercelayer/products/. Refuses deletes unless --allow-delete is given.',
-    'storefront init': 'Write storefront/index.html: a static page on drop-in.js listing the products in store.yml, with the hosted cart and checkout. Refuses to overwrite unless --force is given.',
+    'storefront init': 'Write storefront/index.html: a static page on drop-in.js listing the products in store.yml, with a minicart that opens on add to cart, and the hosted cart and checkout. Refuses to overwrite unless --force is given.',
     'storefront publish': 'Upload the storefront folder (store.yml storefront.path, default storefront) to the sandbox preview URL.',
     'orders test': 'Buy from the store over UCP as a shopping agent would, paying with the sandbox handler: discover, search, checkout, address, pay, read the order. Options: --sku <id> --quantity <n> --country <CC> --code <discount> --via-cart --decline.',
     'orders list': 'List the orders placed in the store, newest first, as UCP order entities.',

package/dist/storefront.js

@@ -1,5 +1,5 @@
 // The storefront scaffold: one static page on drop-in.js listing the products in
-// store.yml, with the hosted cart and checkout. The agent then makes it the human's.
+// store.yml, with the minicart, the hosted cart and checkout. The agent then makes it the human's.
 const esc = (t) => String(t ?? '').replace(/[&<>"]/g, (c) => ({ '&': '&amp;', '<': '&lt;', '>': '&gt;', '"': '&quot;' })[c]);
 export function storefrontHtml(store, clientId) {
     const name = esc(store.name);
@@ -18,8 +18,9 @@ ${p.description ? `        <p>${esc(p.description)}</p>\n` : ''}        <cl-pric
   <meta charset="utf-8">
   <meta name="viewport" content="width=device-width, initial-scale=1">
   <title>${name}</title>
-  <!-- Commerce Layer drop-in.js: prices, availability, add to cart, and links to the hosted cart and checkout. -->
+  <!-- Commerce Layer drop-in.js: prices, availability, add to cart, the minicart (a slide-in panel, styled by minicart.css) and links to the hosted cart and checkout. -->
   <link href="https://cdn.jsdelivr.net/npm/@commercelayer/drop-in.js@2/dist/drop-in/drop-in.css" rel="stylesheet">
+  <link href="https://cdn.jsdelivr.net/npm/@commercelayer/drop-in.js@2/dist/drop-in/minicart.css" rel="stylesheet">
   <script>
     // The market comes from ?market=<code>; the first market in store.yml is the default. Keep clientId as it is.
     var market = new URLSearchParams(location.search).get('market') || '${esc(store.markets[0].code)}';
@@ -45,6 +46,8 @@ ${p.description ? `        <p>${esc(p.description)}</p>\n` : ''}        <cl-pric
     cl-price-amount[type="compare-at"] { color: var(--muted); font-weight: 400; text-decoration: line-through; }
     cl-availability { font-size: 13px; color: var(--muted); }
     cl-add-to-cart { margin-top: auto; }
+    /* drop-in.css styles the count as a badge beside a cart icon (absolute, pushed right). The link is text here, so render it inline: "Cart (3)". */
+    cl-cart-link cl-cart-count { position: static; transform: none; display: inline; min-width: 0; height: auto; padding: 0; border-radius: 0; background: none; color: inherit; font-size: inherit; }
     cl-add-to-cart::part(button), cl-checkout-link::part(a) { display: inline-block; padding: 10px 16px; border-radius: 6px; background: var(--accent); color: #fff; font: inherit; border: 0; cursor: pointer; text-decoration: none; }
     footer { padding: 24px; border-top: 1px solid var(--line); color: var(--muted); font-size: 13px; }
   </style>
@@ -58,7 +61,7 @@ ${p.description ? `        <p>${esc(p.description)}</p>\n` : ''}        <cl-pric
 ${options}
         </select>
       </label>
-      <cl-cart-link>Cart (<cl-cart-count></cl-cart-count>)</cl-cart-link>
+      <cl-cart-link aria-label="Cart">Cart (<cl-cart-count></cl-cart-count>)<cl-cart type="mini" open-on-add></cl-cart></cl-cart-link>
       <cl-checkout-link>Checkout</cl-checkout-link>
     </nav>
   </header>

package/dist/ucp/client.js

@@ -65,7 +65,7 @@ export async function discover(origin) {
         profile = JSON.parse(res.body);
     }
     catch {
-        fail('ucp_profile_malformed', `${origin}/.well-known/ucp is not JSON.`, 'Report it at https://commercelayer.ai/support with the output of `c11r status`.');
+        fail('ucp_profile_malformed', `${origin}/.well-known/ucp is not JSON.`, 'The store host answered badly. Try again; if it keeps happening, tell the human, with the output of `c11r status`.');
     }
     const ucp = profile.ucp ?? {};
     if (ucp.version !== UCP_VERSION) {
@@ -74,7 +74,7 @@ export async function discover(origin) {
     const rest = (name) => (ucp.services?.[name] ?? []).find((s) => s.transport === 'rest')?.endpoint ?? null;
     const endpoint = rest('dev.ucp.shopping');
     if (!endpoint)
-        fail('ucp_no_rest_service', 'The store profile has no REST dev.ucp.shopping service.', 'Report it at https://commercelayer.ai/support.');
+        fail('ucp_no_rest_service', 'The store profile has no REST dev.ucp.shopping service.', 'The store host serves a profile this CLI cannot use. Tell the human, with the output of `c11r ucp profile`.');
     const capabilities = new Set();
     for (const [name, entries] of Object.entries(ucp.capabilities ?? {})) {
         if (entries.some((e) => e.version === UCP_VERSION))

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@commercelayer/agent-cli",
-  "version": "0.1.4",
+  "version": "0.1.7",
   "description": "c11r: the Commerce Layer CLI for coding agents. Builds a sandbox store that people and shopping agents can buy from.",
   "homepage": "https://commercelayer.ai",
   "keywords": [