sbuilder-mcp 0.59.2 → 0.60.0

package/CHANGELOG.md

@@ -6,6 +6,19 @@ All notable changes to this project are documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.60.0] - 2026-09-16
+
+### Added
+- `sb_page_list` now returns a `page_types` table naming every one of the platform's twelve page types and the address or role each is served at, generated from the platform's own page-type metadata, since `sb_page_create` previously only described six of them (page, checkout, product, category, post, course) in its argument text, leaving search, account, blog, complete, error, and maintain pages undiscoverable to an agent that only read the tool.
+
+### Changed
+- `sb_page_create`'s `type` argument now points to `sb_page_list` for the full set of page types instead of naming a partial list inline.
+
+## [0.59.3] - 2026-09-15
+
+### Changed
+- The call sheet for `POST /api/sites/{siteId}/ai/messages` now documents its `context` body field — the page outline plus the selected element's trait list, value types and current values — so a call through `sb_api_call` can pass the editor's own capability list instead of guessing at the shape.
+
 ## [0.59.2] - 2026-09-15
 
 ### Fixed

package/CHANGELOG.vi.md

@@ -6,6 +6,19 @@ Mọi thay đổi đáng chú ý của dự án được ghi lại trong file n
 Định dạng dựa trên [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 và dự án tuân theo [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.60.0] - 2026-09-16
+
+### Added
+- `sb_page_list` giờ trả về bảng `page_types` nêu tên cả mười hai loại trang của nền tảng cùng địa chỉ hoặc vai trò mà mỗi loại được phục vụ, sinh ra từ chính metadata loại trang của nền tảng, vì trước đó `sb_page_create` chỉ mô tả sáu trong số đó (page, checkout, product, category, post, course) trong phần mô tả tham số, khiến các trang search, account, blog, complete, error và maintain không thể được khám phá bởi một agent chỉ đọc mô tả của tool.
+
+### Changed
+- Tham số `type` của `sb_page_create` giờ trỏ tới `sb_page_list` để xem đầy đủ các loại trang thay vì liệt kê một danh sách không đầy đủ ngay trong mô tả.
+
+## [0.59.3] - 2026-09-15
+
+### Changed
+- Call sheet cho `POST /api/sites/{siteId}/ai/messages` giờ mô tả trường `context` trong body — gồm outline của trang cùng danh sách trait, kiểu giá trị và giá trị hiện tại của phần tử đang chọn — nhờ đó một lệnh gọi qua `sb_api_call` có thể gửi đúng danh sách năng lực của editor thay vì phải đoán hình dạng của nó.
+
 ## [0.59.2] - 2026-09-15
 
 ### Fixed

package/README.md

@@ -112,7 +112,7 @@ in this client: one would put the very key the platform exists to hold back into
 | `sb_store` | Run a store flow that must happen in a fixed order — the four writes that make a working checkout, or any of the platform's 17 form templates (login, register, forgot, contact, subscribe …) with its own field document |
 | `sb_undo` | Put back what a PUT replaced. The SECOND answer for a page, not the only one: the platform has versions, history and restore (`sb_api_find` "page versions"), which outlive this process — reach for those first and use this for every other shaped PUT |
 
-Twenty-eight tools, **525 API operations** (176 of the 235 writes carrying a body shape read
+Twenty-eight tools, **527 API operations** (177 of the 236 writes carrying a body shape read
 off the handler), 113 elements, 79 binding sources. `sb_api_find`
 is an index rather than a tool per endpoint, so the tool list stays short while everything
 the platform can do stays reachable — and operations added to the platform arrive with the

package/README.vi.md

@@ -109,7 +109,7 @@ nhét ngược lại vào mọi bản cài.
 | `sb_store` | Chạy một luồng cửa hàng bắt buộc đúng thứ tự — bốn lệnh ghi tạo nên trang thanh toán, hoặc gieo bất kỳ template nào trong 17 form của nền tảng (login, register, forgot, contact, subscribe …) kèm field document của nó |
 | `sb_undo` | Trả lại thứ mà một lệnh PUT đã ghi đè. Với TRANG thì đây là đường về thứ hai chứ không phải duy nhất: nền tảng có version, history và restore (`sb_api_find` "page versions"), và chúng sống lâu hơn tiến trình này — hãy dùng chúng trước, còn tool này cho mọi PUT có hình dạng khác |
 
-Hai mươi tám tool, **525 operation API** (176 trong 235 lệnh ghi có hình dạng body đọc thẳng
+Hai mươi tám tool, **527 operation API** (177 trong 236 lệnh ghi có hình dạng body đọc thẳng
 từ handler), 113 element, 79 nguồn binding. `sb_api_find` là
 một chỉ mục chứ không phải mỗi endpoint một tool, nên danh sách tool vẫn ngắn trong khi mọi
 thứ nền tảng làm được vẫn với tới — và operation mới thêm bên nền tảng sẽ tự có sau lần

package/dist/catalog/api.generated.js

@@ -1,8 +1,8 @@
 export const SWAGGER_SOURCE = {
-    "operations": 525,
+    "operations": 527,
     "definitions": 107,
-    "bodyCarrying": 193,
-    "bodyUndescribed": 74,
+    "bodyCarrying": 195,
+    "bodyUndescribed": 76,
     "generatedFrom": "server/docs/swagger.json"
 };
 export const API_OPERATIONS = [
@@ -3349,7 +3349,63 @@ export const API_OPERATIONS = [
                 "in": "body",
                 "required": true,
                 "type": "object",
-                "description": "question (required) and history (prior turns: role user|assistant, text)"
+                "description": "question (required), history (prior turns: role user|assistant, text) and context (the selected element the agent may propose edits to)"
+            }
+        ],
+        "bodyDescribed": false,
+        "bodyRef": null,
+        "credential": "siteScoped"
+    },
+    {
+        "id": "get:/api/sites/{siteId}/ai/settings",
+        "method": "GET",
+        "path": "/api/sites/{siteId}/ai/settings",
+        "tags": [
+            "sites"
+        ],
+        "summary": "Read or replace this site's own AI credentials",
+        "params": [
+            {
+                "name": "siteId",
+                "in": "path",
+                "required": true,
+                "type": "string",
+                "description": "Site ID"
+            },
+            {
+                "name": "settings",
+                "in": "body",
+                "required": false,
+                "type": "object",
+                "description": "provider, model, baseUrl and apiKey (PUT only; omit apiKey to keep the stored one, send \\"
+            }
+        ],
+        "bodyDescribed": false,
+        "bodyRef": null,
+        "credential": "siteScoped"
+    },
+    {
+        "id": "put:/api/sites/{siteId}/ai/settings",
+        "method": "PUT",
+        "path": "/api/sites/{siteId}/ai/settings",
+        "tags": [
+            "sites"
+        ],
+        "summary": "Read or replace this site's own AI credentials",
+        "params": [
+            {
+                "name": "siteId",
+                "in": "path",
+                "required": true,
+                "type": "string",
+                "description": "Site ID"
+            },
+            {
+                "name": "settings",
+                "in": "body",
+                "required": false,
+                "type": "object",
+                "description": "provider, model, baseUrl and apiKey (PUT only; omit apiKey to keep the stored one, send \\"
             }
         ],
         "bodyDescribed": false,

package/dist/catalog/deadkeys.generated.js

@@ -1,6 +1,6 @@
 export const DEAD_KEY_SOURCE = {
-    "files": 4007,
-    "identifiers": 76941,
+    "files": 4026,
+    "identifiers": 77258,
     "seededKeys": 384,
     "dead": 0
 };

package/dist/catalog/shapes.generated.js

@@ -1,10 +1,10 @@
 export const SHAPE_SOURCE = {
-    "writeOperations": 235,
-    "shaped": 176,
-    "fromHandlers": 176,
+    "writeOperations": 236,
+    "shaped": 177,
+    "fromHandlers": 177,
     "fromSwaggerOnly": 0,
     "withReadOnly": 26,
-    "structsRead": 1678
+    "structsRead": 1701
 };
 export const REQUEST_SHAPES = {
     "post:/api/sites/{siteId}/api-keys": {
@@ -3008,11 +3008,38 @@ export const REQUEST_SHAPES = {
                 "name": "history",
                 "type": "llm.Turn[]",
                 "note": "History is sent by the CLIENT, unlike the storefront chatbot's, which removed it as a security fix."
+            },
+            {
+                "name": "context",
+                "type": "editoragent.EditContext | null",
+                "note": "Context is the PAGE as the EDITOR described it — the outline of ROOT's children, and the selected element with its trait list, value types and current values, read off the live registries at send time. IT IS THE CAPABILITY LIST, not a hint."
             }
         ],
         "source": "go",
         "goType": "(inline)"
     },
+    "put:/api/sites/{siteId}/ai/settings": {
+        "fields": [
+            {
+                "name": "provider",
+                "type": "string"
+            },
+            {
+                "name": "model",
+                "type": "string"
+            },
+            {
+                "name": "apiKey",
+                "type": "string | null"
+            },
+            {
+                "name": "baseUrl",
+                "type": "string"
+            }
+        ],
+        "source": "go",
+        "goType": "editoragent.SettingsInput"
+    },
     "post:/api/sites/{siteId}/fonts": {
         "fields": [
             {

package/dist/catalog/storepages.generated.js

@@ -1133,6 +1133,89 @@ export const PAGE_LAYOUT_SEEDS = {
         }
     }
 };
+/**
+ * EVERY page type the platform has, and what each one is FOR.
+ *
+ * A storefront is not one page: most of these are TEMPLATES, and a missing one
+ * means a whole family of addresses serves nothing. `routePattern` is where the
+ * type is served (absent = the author names the address), `ownSlug` says whether
+ * the author names it, `servedRole` marks the two that are served by ROLE rather
+ * than by address, and `app` names the builtin app a type needs installed.
+ */
+export const PAGE_TYPES = [
+    {
+        "type": "page",
+        "group": "main",
+        "ownSlug": true
+    },
+    {
+        "type": "product",
+        "group": "store",
+        "ownSlug": false,
+        "routePattern": "/products/{slug}"
+    },
+    {
+        "type": "category",
+        "group": "store",
+        "ownSlug": false,
+        "routePattern": "/collections/{slug}"
+    },
+    {
+        "type": "course",
+        "group": "store",
+        "ownSlug": false,
+        "routePattern": "/courses/{slug}",
+        "app": "courses"
+    },
+    {
+        "type": "search",
+        "group": "main",
+        "ownSlug": false,
+        "routePattern": "/search"
+    },
+    {
+        "type": "checkout",
+        "group": "store",
+        "ownSlug": false,
+        "routePattern": "/checkout"
+    },
+    {
+        "type": "complete",
+        "group": "store",
+        "ownSlug": false,
+        "routePattern": "/checkout/complete"
+    },
+    {
+        "type": "account",
+        "group": "main",
+        "ownSlug": false,
+        "routePattern": "/account"
+    },
+    {
+        "type": "blog",
+        "group": "blog",
+        "ownSlug": false,
+        "routePattern": "/blog-categories/{slug}"
+    },
+    {
+        "type": "post",
+        "group": "blog",
+        "ownSlug": false,
+        "routePattern": "/blog/{slug}"
+    },
+    {
+        "type": "error",
+        "group": "error",
+        "ownSlug": false,
+        "servedRole": "notFound"
+    },
+    {
+        "type": "maintain",
+        "group": "maintain",
+        "ownSlug": false,
+        "servedRole": "maintenance"
+    }
+];
 /**
  * The document an ordinary page opens with for a chosen LAYOUT.
  *

package/dist/domains/site/storepage.js

@@ -1,4 +1,4 @@
-import { COMPLETION_HEADLINE, COMPLETION_HEADLINE_SENTINEL, PAGE_LAYOUT_SEEDS, STORE_PAGE_SEEDS, } from '../../catalog/storepages.generated.js';
+import { COMPLETION_HEADLINE, COMPLETION_HEADLINE_SENTINEL, PAGE_LAYOUT_SEEDS, STORE_PAGE_SEEDS } from '../../catalog/storepages.generated.js';
 /**
  * WHAT A NEW STORE PAGE OPENS WITH — for an agent, as for a merchant.
  *

package/dist/tools/page.js

@@ -7,7 +7,8 @@ import { addSubtree, setMany, baseOnlyKeys, moveNode, removeNode, duplicateNode,
 import { baseOnlyNote } from '../domains/site/baseonly.js';
 import { detachNote, presetIdOf, presetLayer } from '../domains/site/theme.js';
 import { inertHintsFor } from '../domains/site/inert.js';
-import { hasSeed, layoutDocument, seedDocument, seedSummary, seededTypes } from '../domains/site/storepage.js';
+import { hasSeed, layoutDocument, seedDocument, seedSummary, seededTypes, } from '../domains/site/storepage.js';
+import { PAGE_TYPES } from '../catalog/storepages.generated.js';
 import { animationNote, deadKeyNote, unknownValueNote, unknownWriteNote, } from '../domains/site/vocabulary.js';
 import { skinLevelNote } from '../domains/site/fieldskin.js';
 import { siteTheme } from '../domains/site/theme-fetch.js';
@@ -1177,6 +1178,21 @@ export function registerPageTools(server, ctx) {
         const missing = missingUsualPages(raw.pages ?? null);
         return text({
             ...projectList(raw, 'pages', PAGE_FIELDS),
+            // EVERY TYPE THE PLATFORM HAS, and the address each one answers at.
+            //
+            // Here rather than in `sb_page_create`'s argument description, because
+            // that string rides in `tools/list` and the token budget caps it — the
+            // table put the payload over twice while being trimmed. It is also the
+            // better home: an agent reads this while ORIENTING, before it has
+            // decided what to build, and a type it has never heard of is exactly
+            // what it cannot ask for. `sb_page_create` used to name six of twelve
+            // from a hand-typed string, so search, account, blog, complete, error
+            // and maintain were unreachable to anyone who only read the tool.
+            page_types: Object.fromEntries(PAGE_TYPES.map((t) => [
+                t.type,
+                t.routePattern ??
+                    (t.servedRole ? `served as the site's ${t.servedRole}` : 'an address you choose'),
+            ])),
             ...(missing.length
                 ? {
                     usually_also: Object.fromEntries(missing.map((m) => [m.key, m.why])),
@@ -1195,7 +1211,10 @@ export function registerPageTools(server, ctx) {
         inputSchema: {
             site_id: z.string().optional(),
             name: z.string(),
-            type: z.string().optional().describe('page (default), checkout, product, category, post, course'),
+            type: z
+                .string()
+                .optional()
+                .describe('page (default); sb_page_list lists every type and where each is served'),
             slug: z.string().optional(),
             is_homepage: z.boolean().optional(),
             settings: z.record(z.unknown()).optional(),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sbuilder-mcp",
-  "version": "0.59.2",
+  "version": "0.60.0",
   "description": "MCP server that designs and operates a Store Builder site — pages, data, theme and publish — through the platform's own API and live-edit protocol.",
   "mcpName": "io.github.vuluu2k/sbuilder-mcp",
   "type": "module",