@brander/mcp-tools 0.2.2 → 0.2.4

package/dist/server/brand/brand-loader.d.ts

@@ -4,6 +4,12 @@
 import { BrandSettings, ProjectConfig } from "./brand-types.js";
 interface BrandLoaderOptions {
     projectId: string;
+    /**
+     * Public design-partner key (bux_dp_xxx). This is a publishable identifier
+     * (like a Stripe publishable key) — it scopes API access to a specific project
+     * but does not grant write access or expose secrets. Safe to embed in client
+     * configs, MCP tool results, and localStorage.
+     */
     betaKey: string;
     apiBaseUrl?: string;
     brandSettingsPath?: string;

package/dist/server/brand/brand-loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"brand-loader.d.ts","sourceRoot":"","sources":["../../../src/brand/brand-loader.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,aAAa,EAA0B,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAExF,UAAU,kBAAkB;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,aAAa,CAAC,CA4B3F;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,aAAa,CAAC,CAG3F"}
+{"version":3,"file":"brand-loader.d.ts","sourceRoot":"","sources":["../../../src/brand/brand-loader.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,aAAa,EAA0B,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAExF,UAAU,kBAAkB;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB;;;;;OAKG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,aAAa,CAAC,CA4B3F;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,aAAa,CAAC,CAG3F"}

package/dist/server/brand/brand-loader.js

@@ -69,7 +69,7 @@ async function loadConfigFromApi(options) {
     const response = await fetch(url.toString(), {
         method: "GET",
         headers: {
-            "Content-Type": "application/json",
+            Accept: "application/json",
         },
     });
     if (!response.ok) {

package/dist/server/elements/click-behaviors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"click-behaviors.d.ts","sourceRoot":"","sources":["../../../src/elements/click-behaviors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAExD,MAAM,WAAW,mBAAmB;IAClC,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,eAAO,MAAM,yBAAyB,EAAE,MAAM,CAAC,WAAW,EAAE,mBAAmB,CA6D9E,CAAC;AAEF,6CAA6C;AAC7C,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,WAAW,GAAG,mBAAmB,GAAG,SAAS,CAE1F"}
+{"version":3,"file":"click-behaviors.d.ts","sourceRoot":"","sources":["../../../src/elements/click-behaviors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAExD,MAAM,WAAW,mBAAmB;IAClC,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,eAAO,MAAM,yBAAyB,EAAE,MAAM,CAAC,WAAW,EAAE,mBAAmB,CAiE9E,CAAC;AAEF,6CAA6C;AAC7C,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,WAAW,GAAG,mBAAmB,GAAG,SAAS,CAE1F"}

package/dist/server/elements/click-behaviors.js

@@ -60,6 +60,10 @@ export const ELEMENT_BEHAVIOR_REGISTRY = {
         queryTemplate: "[actionQuery]",
         description: "Alert action button triggers the configured query",
     },
+    [ElementType.VIDEO]: {
+        queryTemplate: "[action]",
+        description: "Discuss button fires the configured action query about the video",
+    },
     [ElementType.SCREEN]: {
         queryTemplate: "",
         description: "Screen composition — click behaviors are per-element",

package/dist/server/elements/element-functions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"element-functions.d.ts","sourceRoot":"","sources":["../../../src/elements/element-functions.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAExD,0EAA0E;AAC1E,MAAM,MAAM,eAAe,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC;AAEzE,qDAAqD;AACrD,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,WAAW,EAAE,eAAe,CAsDlE,CAAC;AAEF,mEAAmE;AACnE,wBAAgB,kBAAkB,CAChC,WAAW,EAAE,WAAW,EACxB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAGT;AAED;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,EAAE,MAAM,CAC5C,WAAW,EACX,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA4E/D,CAAC;AAEF;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,WAAW,EACxB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,MAAM,CAsER"}
+{"version":3,"file":"element-functions.d.ts","sourceRoot":"","sources":["../../../src/elements/element-functions.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAExD,0EAA0E;AAC1E,MAAM,MAAM,eAAe,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC;AAEzE,qDAAqD;AACrD,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,WAAW,EAAE,eAAe,CAwDlE,CAAC;AAEF,mEAAmE;AACnE,wBAAgB,kBAAkB,CAChC,WAAW,EAAE,WAAW,EACxB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAGT;AAED;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,EAAE,MAAM,CAC5C,WAAW,EACX,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAiF/D,CAAC;AAEF;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,WAAW,EACxB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,MAAM,CAwER"}

package/dist/server/elements/element-functions.js

@@ -33,6 +33,7 @@ export const VISIBILITY_CHECKS = {
     [ElementType.FORM]: (data) => Array.isArray(data?.fields) && data.fields.length > 0,
     [ElementType.BUTTON]: (data) => Boolean(data),
     [ElementType.ALERT]: (data) => Boolean(data?.message) && typeof data.message === "string" && data.message.trim().length > 0,
+    [ElementType.VIDEO]: (data) => Boolean(data?.src),
     [ElementType.SCREEN]: (data) => Array.isArray(data?.elements) && data.elements.length > 0,
 };
 /** Check if tool input data is valid for the given element type */
@@ -105,6 +106,10 @@ export const CLICK_METADATA_ENRICHMENT = {
         elementType: "alert",
         actionType: "alert_action_click",
     }),
+    [ElementType.VIDEO]: (data) => ({
+        ...data,
+        elementType: "video",
+    }),
     [ElementType.SCREEN]: (data) => ({ ...data }),
 };
 /**
@@ -157,6 +162,7 @@ export function buildContentSummary(elementType, data) {
         },
         [ElementType.BUTTON]: (d) => `Rendered button: "${d.label}"`,
         [ElementType.ALERT]: (d) => `Displayed ${d.severity || "info"} alert: "${d.message}"`,
+        [ElementType.VIDEO]: (d) => `Rendered video player: "${d.title || d.src}"`,
         [ElementType.SCREEN]: (d) => {
             const elements = d.elements;
             return `Rendered screen with ${elements?.length || 0} elements`;

package/dist/server/register.d.ts

@@ -14,7 +14,11 @@ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 export interface BranderToolsConfig {
     /** BranderUX project ID — identifies which project's brand + screens to load */
     projectId: string;
-    /** Beta design partner key (bux_dp_xxx) for authentication */
+    /**
+     * Public design-partner key (bux_dp_xxx). This is a publishable identifier — it
+     * scopes API access to a specific project but does not grant write access or expose
+     * secrets. Safe to include in client-side configs and version control.
+     */
     betaKey: string;
     /** BranderUX API base URL (defaults to https://branderux.com) */
     apiBaseUrl?: string;

package/dist/server/register.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"register.d.ts","sourceRoot":"","sources":["../../src/register.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAQpE,MAAM,WAAW,kBAAkB;IACjC,gFAAgF;IAChF,SAAS,EAAE,MAAM,CAAC;IAElB,8DAA8D;IAC9D,OAAO,EAAE,MAAM,CAAC;IAEhB,iEAAiE;IACjE,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,iFAAiF;IACjF,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;;;;;;;;GASG;AACH,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,kBAAkB,GACzB,OAAO,CAAC,IAAI,CAAC,CA2Bf"}
+{"version":3,"file":"register.d.ts","sourceRoot":"","sources":["../../src/register.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAQpE,MAAM,WAAW,kBAAkB;IACjC,gFAAgF;IAChF,SAAS,EAAE,MAAM,CAAC;IAElB;;;;OAIG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB,iEAAiE;IACjE,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,iFAAiF;IACjF,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;;;;;;;;GASG;AACH,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,kBAAkB,GACzB,OAAO,CAAC,IAAI,CAAC,CA2Bf"}

package/dist/server/resource/resource-registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resource-registry.d.ts","sourceRoot":"","sources":["../../../src/resource/resource-registry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAGxD,eAAO,MAAM,YAAY,kCAAkC,CAAC;AAkB5D;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,SAAS,EAAE,aAAa,EAAE,aAAa,GAAG,IAAI,CAwBhG"}
+{"version":3,"file":"resource-registry.d.ts","sourceRoot":"","sources":["../../../src/resource/resource-registry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAGxD,eAAO,MAAM,YAAY,kCAAkC,CAAC;AAoB5D;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,SAAS,EAAE,aAAa,EAAE,aAAa,GAAG,IAAI,CAwBhG"}

package/dist/server/resource/resource-registry.js

@@ -16,7 +16,9 @@ function injectInitialConfig(html, projectConfig) {
         screenVisibility: projectConfig.screenVisibility,
         customScreens: projectConfig.customScreens,
     };
-    const script = `<script>window.__BRANDER_INITIAL_CONFIG__=${JSON.stringify(config)};</script>`;
+    // Escape </ sequences to prevent script tag injection (e.g. "</script>" in config values)
+    const safeJson = JSON.stringify(config).replace(/</g, "\\u003c");
+    const script = `<script>window.__BRANDER_INITIAL_CONFIG__=${safeJson};</script>`;
     // Insert before closing </head> so it runs before the app bundle
     return html.replace("</head>", `${script}</head>`);
 }

package/dist/server/tools/element-definitions.d.ts

@@ -1,5 +1,5 @@
 /**
- * Element definitions — static metadata for the 14 BranderUX element types.
+ * Element definitions — static metadata for the 15 BranderUX element types.
  *
  * Inlined here so the compiled dist/server can run as standalone Node.js without
  * depending on @brander/elements TypeScript source at runtime (CJS/ESM interop issue).
@@ -9,6 +9,7 @@ interface ElementInfo {
     name: string;
     description: string;
 }
+export declare const ELEMENT_INFO: ElementInfo[];
 /** Get element info by type (for names, click behaviors, summaries) */
 export declare function getElementDefinition(elementType: string): ElementInfo | undefined;
 export {};

package/dist/server/tools/element-definitions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"element-definitions.d.ts","sourceRoot":"","sources":["../../../src/tools/element-definitions.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,UAAU,WAAW;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACrB;AA6CD,uEAAuE;AACvE,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAEjF"}
+{"version":3,"file":"element-definitions.d.ts","sourceRoot":"","sources":["../../../src/tools/element-definitions.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,UAAU,WAAW;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,eAAO,MAAM,YAAY,EAAE,WAAW,EA4CrC,CAAC;AAIF,uEAAuE;AACvE,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAEjF"}

package/dist/server/tools/element-definitions.js

@@ -1,10 +1,10 @@
 /**
- * Element definitions — static metadata for the 14 BranderUX element types.
+ * Element definitions — static metadata for the 15 BranderUX element types.
  *
  * Inlined here so the compiled dist/server can run as standalone Node.js without
  * depending on @brander/elements TypeScript source at runtime (CJS/ESM interop issue).
  */
-const ELEMENT_INFO = [
+export const ELEMENT_INFO = [
     { id: "header", name: "Header", description: "Page header with title and subtitle" },
     { id: "stats-grid", name: "Stats Grid", description: "Grid of KPI statistics with trends" },
     {
@@ -43,6 +43,11 @@ const ELEMENT_INFO = [
         name: "Alert",
         description: "Notification banner for messages, warnings, and feedback",
     },
+    {
+        id: "video",
+        name: "Video Player",
+        description: "Embedded video player for YouTube URLs or direct mp4/webm files",
+    },
 ];
 const ELEMENT_INFO_MAP = new Map(ELEMENT_INFO.map((e) => [e.id, e]));
 /** Get element info by type (for names, click behaviors, summaries) */

package/dist/server/tools/generate-screen-schema.d.ts

@@ -1,7 +1,7 @@
 /**
  * Self-contained generate_screen Zod schema + tool description for the MCP server.
  *
- * All 14 element prop schemas are defined here so the compiled dist/server can run
+ * All 15 element prop schemas are defined here so the compiled dist/server can run
  * as a standalone Node.js server without depending on @brander/elements at runtime.
  * (Avoids CJS/ESM interop issues — brander-elements is CJS but mcp-tools is ESM.)
  */
@@ -255,8 +255,39 @@ export declare const generateScreenInputSchema: z.ZodObject<{
             actionQuery: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>;
         clickQuery: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        elementType: z.ZodLiteral<"video">;
+        props: z.ZodObject<{
+            id: z.ZodString;
+            src: z.ZodString;
+            title: z.ZodOptional<z.ZodString>;
+            description: z.ZodOptional<z.ZodString>;
+            action: z.ZodOptional<z.ZodString>;
+            aspectRatio: z.ZodOptional<z.ZodEnum<{
+                "16:9": "16:9";
+                "4:3": "4:3";
+                "1:1": "1:1";
+            }>>;
+            autoplay: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>;
+        clickQuery: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>], "elementType">>;
 }, z.core.$strip>;
-/** Tool description for generate_screen */
-export declare const GENERATE_SCREEN_DESCRIPTION: string;
+interface DescriptionConfig {
+    elementVisibility?: Record<string, boolean>;
+    customScreens?: Array<{
+        name: string;
+        config?: {
+            elements?: Array<{
+                elementType?: string;
+            }>;
+        };
+        elements?: Array<{
+            elementType?: string;
+        }>;
+    }>;
+}
+/** Build the generate_screen tool description dynamically from project config */
+export declare function buildGenerateScreenDescription(config?: DescriptionConfig): string;
+export {};
 //# sourceMappingURL=generate-screen-schema.d.ts.map

package/dist/server/tools/generate-screen-schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generate-screen-schema.d.ts","sourceRoot":"","sources":["../../../src/tools/generate-screen-schema.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA+OxB,2DAA2D;AAC3D,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAIpC,CAAC;AAEH,2CAA2C;AAC3C,eAAO,MAAM,2BAA2B,QAO8H,CAAC"}
+{"version":3,"file":"generate-screen-schema.d.ts","sourceRoot":"","sources":["../../../src/tools/generate-screen-schema.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA6PxB,2DAA2D;AAC3D,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAIpC,CAAC;AAMH,UAAU,iBAAiB;IACzB,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC5C,aAAa,CAAC,EAAE,KAAK,CAAC;QACpB,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,CAAC,EAAE;YAAE,QAAQ,CAAC,EAAE,KAAK,CAAC;gBAAE,WAAW,CAAC,EAAE,MAAM,CAAA;aAAE,CAAC,CAAA;SAAE,CAAC;QACxD,QAAQ,CAAC,EAAE,KAAK,CAAC;YAAE,WAAW,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KAC5C,CAAC,CAAC;CACJ;AAED,iFAAiF;AACjF,wBAAgB,8BAA8B,CAAC,MAAM,CAAC,EAAE,iBAAiB,GAAG,MAAM,CAqCjF"}

package/dist/server/tools/generate-screen-schema.js

@@ -1,13 +1,14 @@
 /**
  * Self-contained generate_screen Zod schema + tool description for the MCP server.
  *
- * All 14 element prop schemas are defined here so the compiled dist/server can run
+ * All 15 element prop schemas are defined here so the compiled dist/server can run
  * as a standalone Node.js server without depending on @brander/elements at runtime.
  * (Avoids CJS/ESM interop issues — brander-elements is CJS but mcp-tools is ESM.)
  */
 import { z } from "zod";
+import { ELEMENT_INFO } from "./element-definitions.js";
 // ============================================================================
-// ELEMENT PROP SCHEMAS (14 element types)
+// ELEMENT PROP SCHEMAS (15 element types)
 // ============================================================================
 const headerPropsSchema = z.object({
     title: z.string().describe("Main page title"),
@@ -87,10 +88,7 @@ const itemGridPropsSchema = z.object({
         title: z.string().describe("Item name"),
         description: z.string().optional().describe("Item description"),
         price: z.string().describe("Item price"),
-        image: z
-            .string()
-            .optional()
-            .describe("REAL image URL (e.g., https://images.unsplash.com/...)"),
+        image: z.string().optional().describe("Image URL"),
         category: z.string().optional().describe("Item category"),
         rating: z.number().optional().describe("Rating score"),
         stock: z.number().optional().describe("Stock quantity"),
@@ -188,8 +186,22 @@ const alertPropsSchema = z.object({
     actionText: z.string().optional().describe("Optional action button text"),
     actionQuery: z.string().optional().describe("Query to send when action button clicked"),
 });
+const videoPropsSchema = z.object({
+    id: z.string().describe("Unique video element identifier"),
+    src: z
+        .string()
+        .describe("Video URL — YouTube (youtube.com/watch or youtu.be), or direct .mp4/.webm file URL"),
+    title: z.string().optional().describe("Video title shown below the player"),
+    description: z.string().optional().describe("Brief description shown below the title"),
+    action: z
+        .string()
+        .optional()
+        .describe("Query sent to the AI when the user clicks the Discuss button"),
+    aspectRatio: z.enum(["16:9", "4:3", "1:1"]).optional().describe("Video player aspect ratio"),
+    autoplay: z.boolean().optional().describe("Auto-play video when rendered"),
+});
 // ============================================================================
-// SCREEN SCHEMA — discriminated union of all 14 element types
+// SCREEN SCHEMA — discriminated union of all 15 element types
 // ============================================================================
 const clickQuery = z
     .string()
@@ -210,6 +222,7 @@ const screenElementSchema = z.discriminatedUnion("elementType", [
     z.object({ elementType: z.literal("form"), props: formPropsSchema, clickQuery }),
     z.object({ elementType: z.literal("button"), props: buttonPropsSchema, clickQuery }),
     z.object({ elementType: z.literal("alert"), props: alertPropsSchema, clickQuery }),
+    z.object({ elementType: z.literal("video"), props: videoPropsSchema, clickQuery }),
 ]);
 /** Full input schema for the MCP `generate_screen` tool */
 export const generateScreenInputSchema = z.object({
@@ -217,11 +230,34 @@ export const generateScreenInputSchema = z.object({
         .array(screenElementSchema)
         .describe("Ordered array of elements to render. Each element has an elementType and props."),
 });
-/** Tool description for generate_screen */
-export const GENERATE_SCREEN_DESCRIPTION = "**REQUIRED FOR ALL VISUAL RESPONSES** - Render branded, interactive UI components. " +
-    "You MUST use this tool instead of writing React code for dashboards, data tables, charts, stats, or any visual content. " +
-    "Provide an ordered array of elements: for dashboards use header + stats-grid + data-table + charts; " +
-    "for simple text use chat-bubble. For clickable elements, add a `clickQuery` with placeholders [field] for dynamic values. " +
-    "Example: clickQuery: 'Show detailed analytics for [title] including sales trends and inventory'. " +
-    "Use [title], [id], [name] placeholders that will be filled when user clicks. DO NOT write React code - use this tool. " +
-    "Available elements: header, chat-bubble, stats-grid, data-table, line-chart, pie-chart, bar-chart, item-grid, item-card, image, details-data, form, button, alert.";
+/** Build the generate_screen tool description dynamically from project config */
+export function buildGenerateScreenDescription(config) {
+    const elementVisibility = config?.elementVisibility ?? {};
+    const customScreens = config?.customScreens ?? [];
+    // Filter elements by visibility (default = enabled if not in map)
+    const enabledElements = ELEMENT_INFO.filter((e) => elementVisibility[e.id] !== false);
+    const enabledSet = new Set(enabledElements.map((e) => e.id));
+    const elementList = enabledElements.map((e) => e.id).join(", ");
+    // Build screen patterns from the project's custom screens
+    const patterns = [];
+    for (const screen of customScreens) {
+        const els = (screen.config?.elements ?? screen.elements ?? [])
+            .map((e) => e.elementType)
+            .filter((t) => !!t && enabledSet.has(t));
+        if (els.length > 0) {
+            const unique = [...new Set(els)];
+            patterns.push(`- ${screen.name}: ${unique.join(" → ")}`);
+        }
+    }
+    const patternsSection = patterns.length > 0
+        ? "Compose screens from an ordered array of elements. Available screen patterns:\n" +
+            patterns.join("\n") +
+            "\n\n"
+        : "";
+    return ("Render branded, interactive UI screens. Outputs styled visual components (charts, tables, grids, forms) " +
+        "using the project's brand colors, fonts, and layout — displayed as a rich visual panel.\n\n" +
+        patternsSection +
+        "For interactivity, add clickQuery with [placeholder] tokens filled from element data on click. " +
+        'Example: clickQuery: "Show details for [title] with full order history"\n\n' +
+        `Available elements: ${elementList}`);
+}

package/dist/server/tools/tool-registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool-registry.d.ts","sourceRoot":"","sources":["../../../src/tools/tool-registry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAKpE,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAMlD;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,SAAS,EACjB,aAAa,EAAE,aAAa,EAC5B,SAAS,CAAC,EAAE,SAAS,GACpB,IAAI,CAuBN"}
+{"version":3,"file":"tool-registry.d.ts","sourceRoot":"","sources":["../../../src/tools/tool-registry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAKpE,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAOlD;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,SAAS,EACjB,aAAa,EAAE,aAAa,EAC5B,SAAS,CAAC,EAAE,SAAS,GACpB,IAAI,CAsCN"}

package/dist/server/tools/tool-registry.js

@@ -4,9 +4,10 @@
  * Uses the high-level McpServer.registerTool() API for composability — customers
  * can register their own tools alongside BranderUX tools on the same server.
  */
-import { generateScreenInputSchema, GENERATE_SCREEN_DESCRIPTION, } from "./generate-screen-schema.js";
+import { generateScreenInputSchema, buildGenerateScreenDescription, } from "./generate-screen-schema.js";
 import { createScreenHandler } from "./tool-handler.js";
 import { RESOURCE_URI } from "../resource/resource-registry.js";
+import { ELEMENT_INFO } from "./element-definitions.js";
 const TOOL_NAME = "generate_screen";
 /**
  * Register the BranderUX generate_screen tool with the MCP server.
@@ -14,8 +15,16 @@ const TOOL_NAME = "generate_screen";
  */
 export function registerTools(server, projectConfig, apiConfig) {
     const handler = createScreenHandler(projectConfig, apiConfig);
+    // Build description dynamically from project's element/screen visibility + custom screens
+    const description = buildGenerateScreenDescription({
+        elementVisibility: projectConfig.settings.elementVisibility,
+        customScreens: projectConfig.customScreens,
+    });
+    // Count enabled elements
+    const elementVisibility = projectConfig.settings.elementVisibility ?? {};
+    const enabledCount = ELEMENT_INFO.filter((e) => elementVisibility[e.id] !== false).length;
     server.registerTool(TOOL_NAME, {
-        description: GENERATE_SCREEN_DESCRIPTION,
+        description,
         inputSchema: generateScreenInputSchema,
         _meta: {
             ui: { resourceUri: RESOURCE_URI },
@@ -26,5 +35,6 @@ export function registerTools(server, projectConfig, apiConfig) {
         // but our handler expects Record<string, unknown>
         return handler(args);
     });
-    console.error(`Registered BranderUX tool: ${TOOL_NAME} ` + `(14 element types, resource: ${RESOURCE_URI})`);
+    console.error(`Registered BranderUX tool: ${TOOL_NAME} ` +
+        `(${enabledCount} element types, resource: ${RESOURCE_URI})`);
 }

package/dist/server/types/element-types.d.ts

@@ -17,21 +17,7 @@ export declare enum ElementType {
     BUTTON = "button",
     BAR_CHART = "bar-chart",
     ALERT = "alert",
+    VIDEO = "video",
     SCREEN = "screen"
 }
-export interface ToolSchema {
-    name: string;
-    description: string;
-    input_schema: {
-        type: "object";
-        properties: Record<string, unknown>;
-        required?: string[];
-    };
-}
-export interface ElementDefinition {
-    id: ElementType;
-    name: string;
-    description: string;
-    toolSchema: ToolSchema;
-}
 //# sourceMappingURL=element-types.d.ts.map

package/dist/server/types/element-types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"element-types.d.ts","sourceRoot":"","sources":["../../../src/types/element-types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,oBAAY,WAAW;IACrB,MAAM,WAAW;IACjB,UAAU,eAAe;IACzB,UAAU,eAAe;IACzB,UAAU,eAAe;IACzB,SAAS,cAAc;IACvB,SAAS,cAAc;IACvB,SAAS,cAAc;IACvB,KAAK,UAAU;IACf,YAAY,iBAAiB;IAC7B,WAAW,gBAAgB;IAC3B,IAAI,SAAS;IACb,MAAM,WAAW;IACjB,SAAS,cAAc;IACvB,KAAK,UAAU;IACf,MAAM,WAAW;CAClB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE;QACZ,IAAI,EAAE,QAAQ,CAAC;QACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACpC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;KACrB,CAAC;CACH;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,WAAW,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,UAAU,CAAC;CACxB"}
+{"version":3,"file":"element-types.d.ts","sourceRoot":"","sources":["../../../src/types/element-types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,oBAAY,WAAW;IACrB,MAAM,WAAW;IACjB,UAAU,eAAe;IACzB,UAAU,eAAe;IACzB,UAAU,eAAe;IACzB,SAAS,cAAc;IACvB,SAAS,cAAc;IACvB,SAAS,cAAc;IACvB,KAAK,UAAU;IACf,YAAY,iBAAiB;IAC7B,WAAW,gBAAgB;IAC3B,IAAI,SAAS;IACb,MAAM,WAAW;IACjB,SAAS,cAAc;IACvB,KAAK,UAAU;IACf,KAAK,UAAU;IACf,MAAM,WAAW;CAClB"}

package/dist/server/types/element-types.js

@@ -18,5 +18,6 @@ export var ElementType;
     ElementType["BUTTON"] = "button";
     ElementType["BAR_CHART"] = "bar-chart";
     ElementType["ALERT"] = "alert";
+    ElementType["VIDEO"] = "video";
     ElementType["SCREEN"] = "screen";
 })(ElementType || (ElementType = {}));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@brander/mcp-tools",
-  "version": "0.2.2",
+  "version": "0.2.4",
   "type": "module",
   "description": "BranderUX MCP Tools — Add branded interactive UI to any MCP server",
   "main": "dist/server/lib-entry.js",