@brander/mcp-tools 0.2.0

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

@@ -0,0 +1,26 @@
+/**
+ * Brand settings loader — fetches from BranderUX API or reads local JSON file.
+ */
+import { BrandSettings, ProjectConfig } from "./brand-types.js";
+interface BrandLoaderOptions {
+    projectId: string;
+    betaKey: string;
+    apiBaseUrl?: string;
+    brandSettingsPath?: string;
+}
+/**
+ * Load full project configuration from API or local file.
+ *
+ * Priority:
+ *   1. Local JSON file (brandSettingsPath)
+ *   2. BranderUX API (betaKey + projectId)
+ *   3. Default config (fallback)
+ */
+export declare function loadProjectConfig(options: BrandLoaderOptions): Promise<ProjectConfig>;
+/**
+ * @deprecated Use loadProjectConfig instead
+ * Load brand settings from API or local file (legacy method for backward compatibility).
+ */
+export declare function loadBrandSettings(options: BrandLoaderOptions): Promise<BrandSettings>;
+export {};
+//# sourceMappingURL=brand-loader.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,89 @@
+/**
+ * Brand settings loader — fetches from BranderUX API or reads local JSON file.
+ */
+import { readFileSync } from "fs";
+import { DEFAULT_BRAND_SETTINGS } from "./brand-types.js";
+/**
+ * Load full project configuration from API or local file.
+ *
+ * Priority:
+ *   1. Local JSON file (brandSettingsPath)
+ *   2. BranderUX API (betaKey + projectId)
+ *   3. Default config (fallback)
+ */
+export async function loadProjectConfig(options) {
+    // 1. Try local file first
+    if (options.brandSettingsPath) {
+        try {
+            return loadConfigFromFile(options.brandSettingsPath);
+        }
+        catch (error) {
+            console.error(`Failed to load config from file: ${options.brandSettingsPath}`, error);
+        }
+    }
+    // 2. Try API
+    if (options.betaKey && options.projectId) {
+        try {
+            return await loadConfigFromApi(options);
+        }
+        catch (error) {
+            console.error("Failed to load config from API", error);
+        }
+    }
+    // 3. Fallback to defaults
+    console.warn("Using default config — no betaKey/projectId or local file configured");
+    return {
+        brandSettings: { ...DEFAULT_BRAND_SETTINGS },
+        settings: {},
+        screenVisibility: {},
+        customScreens: [],
+        projectName: "Default Project",
+    };
+}
+/**
+ * @deprecated Use loadProjectConfig instead
+ * Load brand settings from API or local file (legacy method for backward compatibility).
+ */
+export async function loadBrandSettings(options) {
+    const config = await loadProjectConfig(options);
+    return config.brandSettings;
+}
+/** Load project config from a local JSON file */
+function loadConfigFromFile(filePath) {
+    const raw = readFileSync(filePath, "utf-8");
+    const parsed = JSON.parse(raw);
+    return {
+        brandSettings: { ...DEFAULT_BRAND_SETTINGS, ...(parsed.brandSettings || {}) },
+        settings: parsed.settings || {},
+        screenVisibility: parsed.screenVisibility || {},
+        customScreens: parsed.customScreens || [],
+        projectName: parsed.projectName || "Local Project",
+    };
+}
+/** Fetch full project config from the BranderUX API */
+async function loadConfigFromApi(options) {
+    const baseUrl = options.apiBaseUrl || "https://app.branderux.com";
+    const url = new URL("/api/project/brand-settings", baseUrl);
+    url.searchParams.set("projectId", options.projectId);
+    url.searchParams.set("betaKey", options.betaKey);
+    const response = await fetch(url.toString(), {
+        method: "GET",
+        headers: {
+            "Content-Type": "application/json",
+        },
+    });
+    if (!response.ok) {
+        throw new Error(`BranderUX API returned ${response.status}: ${await response.text()}`);
+    }
+    const data = (await response.json());
+    if (!data.brandSettings) {
+        throw new Error("API response missing brandSettings field");
+    }
+    return {
+        brandSettings: { ...DEFAULT_BRAND_SETTINGS, ...data.brandSettings },
+        settings: data.settings || {},
+        screenVisibility: data.screenVisibility || {},
+        customScreens: data.customScreens || [],
+        projectName: data.projectName || "Unknown Project",
+    };
+}

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

@@ -0,0 +1,93 @@
+/**
+ * Standalone BrandSettings types — no imports from main app.
+ * Mirrors lib/contexts/BrandStudioContext.tsx interfaces.
+ */
+export interface GrayPalette {
+    gray50: string;
+    gray100: string;
+    gray200: string;
+    gray300: string;
+    gray400: string;
+    gray500: string;
+    gray600: string;
+    gray700: string;
+    gray800: string;
+    gray900: string;
+}
+export interface ComputedFontStyle {
+    fontFamily: string;
+    weight: number;
+    displayName: string;
+    isCustom?: boolean;
+    customDescription?: string;
+}
+export interface ComputedLayoutStyle {
+    spacing: number;
+    elevation: number;
+    displayName: string;
+    isCustom?: boolean;
+    customDescription?: string;
+}
+export interface BrandSettings {
+    primaryColor: string;
+    secondaryColor: string;
+    brandName: string;
+    iconUrl: string;
+    fontStyle: ComputedFontStyle;
+    layoutStyle: ComputedLayoutStyle;
+    borderRadius: number;
+    shadowIntensity: number;
+    darkMode: boolean;
+    accentColor: string;
+    grayPalette: GrayPalette;
+    primaryTextColor: string;
+    secondaryTextColor: string;
+    tertiaryTextColor: string;
+    reasoning?: {
+        colors: string;
+        typography: string;
+        layout: string;
+    };
+}
+/** Project settings that control UI behavior and element visibility */
+export interface ProjectSettings {
+    maxCustomScreens?: number;
+    enableCollaboration?: boolean;
+    uiGenerationMode?: "deterministic" | "flexible";
+    elementVisibility?: Record<string, boolean>;
+    customPages?: Array<{
+        id: string;
+        name: string;
+        query: string;
+    }>;
+    enableQueryEnhancement?: boolean;
+    useToolsAPI?: boolean;
+    flexibleModeRules?: string;
+    elementStyleVariant?: "classic" | "modern";
+}
+/** Screen visibility map (which screens are enabled) */
+export interface ScreenVisibilityMap {
+    [screenId: string]: boolean;
+}
+/** Custom screen definition */
+export interface CustomScreen {
+    id: string;
+    name: string;
+    description?: string;
+    config: Record<string, unknown>;
+    elements?: Array<Record<string, unknown>>;
+    created: string | Date;
+    modified: string | Date;
+    version?: number;
+}
+/** Complete project configuration loaded from API */
+export interface ProjectConfig {
+    brandSettings: BrandSettings;
+    settings: ProjectSettings;
+    screenVisibility: ScreenVisibilityMap;
+    customScreens: CustomScreen[];
+    projectName: string;
+}
+export declare const DEFAULT_GRAY_PALETTE: GrayPalette;
+export declare const DEFAULT_BRAND_SETTINGS: BrandSettings;
+//# sourceMappingURL=brand-types.d.ts.map

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

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

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

@@ -0,0 +1,32 @@
+/**
+ * Standalone BrandSettings types — no imports from main app.
+ * Mirrors lib/contexts/BrandStudioContext.tsx interfaces.
+ */
+export const DEFAULT_GRAY_PALETTE = {
+    gray50: "#fafafa",
+    gray100: "#f5f5f5",
+    gray200: "#e5e5e5",
+    gray300: "#d4d4d4",
+    gray400: "#a3a3a3",
+    gray500: "#737373",
+    gray600: "#525252",
+    gray700: "#404040",
+    gray800: "#262626",
+    gray900: "#171717",
+};
+export const DEFAULT_BRAND_SETTINGS = {
+    primaryColor: "#6366F1",
+    secondaryColor: "#06B6D4",
+    brandName: "Your Brand",
+    iconUrl: "",
+    fontStyle: { fontFamily: "'Inter', sans-serif", weight: 500, displayName: "modern" },
+    layoutStyle: { spacing: 3, elevation: 1, displayName: "clean" },
+    borderRadius: 12,
+    shadowIntensity: 2,
+    darkMode: true,
+    accentColor: "#F59E0B",
+    grayPalette: DEFAULT_GRAY_PALETTE,
+    primaryTextColor: "#171717",
+    secondaryTextColor: "#525252",
+    tertiaryTextColor: "#737373",
+};

package/dist/server/config/server-config.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Server configuration loading — env vars, JSON file, or direct config.
+ */
+import { BranderMCPServerConfig } from "./types.js";
+/**
+ * Load server config from environment variables or a JSON config file.
+ *
+ * Priority:
+ *   1. Direct config object (if passed)
+ *   2. Environment variables
+ *   3. JSON config file (BRANDER_CONFIG_PATH or ./brander-mcp.config.json)
+ */
+export declare function loadServerConfig(overrides?: Partial<BranderMCPServerConfig>): BranderMCPServerConfig;
+/** Validate that required config fields are present */
+export declare function validateConfig(config: BranderMCPServerConfig): string[];
+//# sourceMappingURL=server-config.d.ts.map

package/dist/server/config/server-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-config.d.ts","sourceRoot":"","sources":["../../../src/config/server-config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,sBAAsB,EAAiB,MAAM,YAAY,CAAC;AAMnE;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,SAAS,CAAC,EAAE,OAAO,CAAC,sBAAsB,CAAC,GAC1C,sBAAsB,CAsCxB;AAmBD,uDAAuD;AACvD,wBAAgB,cAAc,CAAC,MAAM,EAAE,sBAAsB,GAAG,MAAM,EAAE,CAoBvE"}

package/dist/server/config/server-config.js

@@ -0,0 +1,71 @@
+/**
+ * Server configuration loading — env vars, JSON file, or direct config.
+ */
+import { readFileSync, existsSync } from "fs";
+const DEFAULT_API_BASE_URL = "https://app.branderux.com";
+const DEFAULT_SERVER_NAME = "brander-mcp";
+const DEFAULT_SERVER_VERSION = "0.1.0";
+/**
+ * Load server config from environment variables or a JSON config file.
+ *
+ * Priority:
+ *   1. Direct config object (if passed)
+ *   2. Environment variables
+ *   3. JSON config file (BRANDER_CONFIG_PATH or ./brander-mcp.config.json)
+ */
+export function loadServerConfig(overrides) {
+    // Try JSON config file
+    const fileConfig = loadConfigFile();
+    // Merge: overrides > env vars > file config > defaults
+    const config = {
+        projectId: overrides?.projectId ?? process.env.BRANDER_PROJECT_ID ?? fileConfig?.projectId ?? "",
+        betaKey: overrides?.betaKey ?? process.env.BRANDER_BETA_KEY ?? fileConfig?.betaKey ?? "",
+        apiBaseUrl: overrides?.apiBaseUrl ??
+            process.env.BRANDER_API_BASE_URL ??
+            fileConfig?.apiBaseUrl ??
+            DEFAULT_API_BASE_URL,
+        brandSettingsPath: overrides?.brandSettingsPath ??
+            process.env.BRANDER_BRAND_SETTINGS_PATH ??
+            fileConfig?.brandSettingsPath,
+        serverName: overrides?.serverName ??
+            process.env.BRANDER_SERVER_NAME ??
+            fileConfig?.serverName ??
+            DEFAULT_SERVER_NAME,
+        serverVersion: overrides?.serverVersion ?? fileConfig?.serverVersion ?? DEFAULT_SERVER_VERSION,
+        transport: overrides?.transport ??
+            process.env.BRANDER_TRANSPORT ??
+            fileConfig?.transport ??
+            "stdio",
+    };
+    return config;
+}
+/** Try to load a JSON config file */
+function loadConfigFile() {
+    const configPath = process.env.BRANDER_CONFIG_PATH ?? "./brander-mcp.config.json";
+    if (!existsSync(configPath)) {
+        return null;
+    }
+    try {
+        const raw = readFileSync(configPath, "utf-8");
+        return JSON.parse(raw);
+    }
+    catch {
+        console.error(`Failed to parse config file: ${configPath}`);
+        return null;
+    }
+}
+/** Validate that required config fields are present */
+export function validateConfig(config) {
+    const errors = [];
+    // projectId is always required
+    if (!config.projectId) {
+        errors.push("BRANDER_PROJECT_ID is required. Set it as an environment variable or in brander-mcp.config.json.");
+    }
+    // betaKey is required unless using local brand settings file
+    if (!config.betaKey && !config.brandSettingsPath) {
+        errors.push("BRANDER_BETA_KEY is required for API authentication. " +
+            "Provide your beta design partner key (bux_dp_xxx), " +
+            "or use BRANDER_BRAND_SETTINGS_PATH for local development.");
+    }
+    return errors;
+}

package/dist/server/config/types.d.ts

@@ -0,0 +1,21 @@
+/**
+ * MCP Server configuration types.
+ */
+export type TransportMode = "stdio" | "sse";
+export interface BranderMCPServerConfig {
+    /** BranderUX project ID — identifies which project's data to load */
+    projectId: string;
+    /** Beta design partner key (bux_dp_xxx) for authentication */
+    betaKey: string;
+    /** BranderUX API base URL (defaults to https://app.branderux.com) */
+    apiBaseUrl?: string;
+    /** Path to local brandSettings.json file (alternative to API for development) */
+    brandSettingsPath?: string;
+    /** Server name (defaults to "brander-mcp") */
+    serverName?: string;
+    /** Server version (defaults to package version) */
+    serverVersion?: string;
+    /** MCP transport type (defaults to "stdio") */
+    transport?: TransportMode;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/server/config/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/config/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,KAAK,CAAC;AAE5C,MAAM,WAAW,sBAAsB;IACrC,qEAAqE;IACrE,SAAS,EAAE,MAAM,CAAC;IAElB,8DAA8D;IAC9D,OAAO,EAAE,MAAM,CAAC;IAEhB,qEAAqE;IACrE,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,iFAAiF;IACjF,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B,8CAA8C;IAC9C,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,mDAAmD;IACnD,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,+CAA+C;IAC/C,SAAS,CAAC,EAAE,aAAa,CAAC;CAC3B"}

package/dist/server/config/types.js

@@ -0,0 +1,4 @@
+/**
+ * MCP Server configuration types.
+ */
+export {};

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

@@ -0,0 +1,13 @@
+/**
+ * Standalone click behavior registry — no imports from main app.
+ * Mirrors types/element-behavior-types.ts ELEMENT_BEHAVIOR_REGISTRY.
+ */
+import { ElementType } from "../types/element-types.js";
+export interface ClickedItemBehavior {
+    queryTemplate: string;
+    description: string;
+}
+export declare const ELEMENT_BEHAVIOR_REGISTRY: Record<ElementType, ClickedItemBehavior>;
+/** Get click behavior for an element type */
+export declare function getClickBehavior(elementType: ElementType): ClickedItemBehavior | undefined;
+//# sourceMappingURL=click-behaviors.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,71 @@
+/**
+ * Standalone click behavior registry — no imports from main app.
+ * Mirrors types/element-behavior-types.ts ELEMENT_BEHAVIOR_REGISTRY.
+ */
+import { ElementType } from "../types/element-types.js";
+export const ELEMENT_BEHAVIOR_REGISTRY = {
+    [ElementType.HEADER]: {
+        queryTemplate: "Show main [title]",
+        description: "Headers typically don't have clickable items",
+    },
+    [ElementType.DATA_TABLE]: {
+        queryTemplate: "Show details for [title] (ID: [id])",
+        description: "Table rows lead to detail view of the item",
+    },
+    [ElementType.ITEM_GRID]: {
+        queryTemplate: "Show details for [title] (ID: [id])",
+        description: "Grid items lead to detail view of the item",
+    },
+    [ElementType.ITEM_CARD]: {
+        queryTemplate: "Show details for [title] (ID: [id])",
+        description: "Item cards lead to detail view",
+    },
+    [ElementType.STATS_GRID]: {
+        queryTemplate: "Show analytics for [title]",
+        description: "KPI/stat cards lead to analytics view",
+    },
+    [ElementType.LINE_CHART]: {
+        queryTemplate: "Show [label] data from [chartTitle]",
+        description: "Chart points lead to detailed data table",
+    },
+    [ElementType.PIE_CHART]: {
+        queryTemplate: "Show [label] data from [chartTitle]",
+        description: "Chart segments lead to detailed data table",
+    },
+    [ElementType.IMAGE]: {
+        queryTemplate: "Show details for [title] (ID: [id])",
+        description: "Images lead to detail view",
+    },
+    [ElementType.DETAILS_DATA]: {
+        queryTemplate: "Show details for [title] (ID: [id])",
+        description: "Detail cards typically stay in details view",
+    },
+    [ElementType.CHAT_BUBBLE]: {
+        queryTemplate: "Continue conversation",
+        description: "Text responses that don't need interaction",
+    },
+    [ElementType.FORM]: {
+        queryTemplate: "Submit form data for [formSummary]",
+        description: "Form submissions trigger data processing",
+    },
+    [ElementType.BUTTON]: {
+        queryTemplate: "[action]",
+        description: "Button action triggers the configured query",
+    },
+    [ElementType.BAR_CHART]: {
+        queryTemplate: "Show [seriesName] data for [category]",
+        description: "Bar chart clicks lead to detailed data table for that category",
+    },
+    [ElementType.ALERT]: {
+        queryTemplate: "[actionQuery]",
+        description: "Alert action button triggers the configured query",
+    },
+    [ElementType.SCREEN]: {
+        queryTemplate: "",
+        description: "Screen composition — click behaviors are per-element",
+    },
+};
+/** Get click behavior for an element type */
+export function getClickBehavior(elementType) {
+    return ELEMENT_BEHAVIOR_REGISTRY[elementType];
+}

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

@@ -0,0 +1,24 @@
+/**
+ * Standalone element functions for the MCP server.
+ * Adapted from lib/elements/functions/ — simplified for MCP context
+ * where data comes directly from tool input (not TypedScreenData).
+ */
+import { ElementType } from "../types/element-types.js";
+/** Validates that raw tool input has enough data to render the element */
+export type VisibilityCheck = (data: Record<string, unknown>) => boolean;
+/** Registry of visibility checks per element type */
+export declare const VISIBILITY_CHECKS: Record<ElementType, VisibilityCheck>;
+/** Check if tool input data is valid for the given element type */
+export declare function isValidElementData(elementType: ElementType, data: Record<string, unknown>): boolean;
+/**
+ * Click metadata enrichment per element type.
+ * Maps element types to the metadata fields added to click handler payloads.
+ * Used by the app-side click handler to build proper query interpolation context.
+ */
+export declare const CLICK_METADATA_ENRICHMENT: Record<ElementType, (itemData: Record<string, unknown>) => Record<string, unknown>>;
+/**
+ * Build a text summary of tool result for the LLM content channel.
+ * Returns a human-readable description of what was rendered.
+ */
+export declare function buildContentSummary(elementType: ElementType, data: Record<string, unknown>): string;
+//# sourceMappingURL=element-functions.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,167 @@
+/**
+ * Standalone element functions for the MCP server.
+ * Adapted from lib/elements/functions/ — simplified for MCP context
+ * where data comes directly from tool input (not TypedScreenData).
+ */
+import { ElementType } from "../types/element-types.js";
+/** Registry of visibility checks per element type */
+export const VISIBILITY_CHECKS = {
+    [ElementType.HEADER]: (data) => Boolean(data?.title),
+    [ElementType.CHAT_BUBBLE]: (data) => Boolean(data?.text),
+    [ElementType.STATS_GRID]: (data) => Array.isArray(data?.stats) && data.stats.length > 0,
+    [ElementType.DATA_TABLE]: (data) => Array.isArray(data?.columns) &&
+        Array.isArray(data?.rows) &&
+        data.rows.length > 0,
+    [ElementType.LINE_CHART]: (data) => {
+        const labels = data?.labels;
+        const chartData = data?.data;
+        return (Array.isArray(labels) &&
+            Array.isArray(chartData) &&
+            labels.length > 0 &&
+            chartData.length > 0 &&
+            chartData.length === labels.length);
+    },
+    [ElementType.PIE_CHART]: (data) => Array.isArray(data?.data) && data.data.length > 0,
+    [ElementType.BAR_CHART]: (data) => Array.isArray(data?.categories) &&
+        data.categories.length > 0 &&
+        Array.isArray(data?.series) &&
+        data.series.length > 0,
+    [ElementType.ITEM_GRID]: (data) => Array.isArray(data?.items) && data.items.length > 0,
+    [ElementType.ITEM_CARD]: (data) => Boolean(data),
+    [ElementType.IMAGE]: (data) => Boolean(data?.src),
+    [ElementType.DETAILS_DATA]: (data) => Array.isArray(data?.items) && data.items.length > 0,
+    [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.SCREEN]: (data) => Array.isArray(data?.elements) && data.elements.length > 0,
+};
+/** Check if tool input data is valid for the given element type */
+export function isValidElementData(elementType, data) {
+    const check = VISIBILITY_CHECKS[elementType];
+    return check ? check(data) : false;
+}
+/**
+ * Click metadata enrichment per element type.
+ * Maps element types to the metadata fields added to click handler payloads.
+ * Used by the app-side click handler to build proper query interpolation context.
+ */
+export const CLICK_METADATA_ENRICHMENT = {
+    [ElementType.HEADER]: (data) => ({ ...data }),
+    [ElementType.CHAT_BUBBLE]: (data) => ({ ...data }),
+    [ElementType.STATS_GRID]: (data) => ({
+        ...data,
+        id: data.id ||
+            `${String(data.title || "")
+                .toLowerCase()
+                .replace(/\s+/g, "-")}-stat`,
+        isStatMetric: true,
+    }),
+    [ElementType.DATA_TABLE]: (data) => ({
+        ...data,
+        id: data.id,
+        title: data.name || data.title || data.id,
+        isTableRow: true,
+    }),
+    [ElementType.LINE_CHART]: (data) => ({
+        ...data,
+        chartType: "line",
+        actionType: "chart_point_click",
+        isChartPoint: true,
+    }),
+    [ElementType.PIE_CHART]: (data) => ({
+        ...data,
+        chartType: "pie",
+        actionType: "chart_point_click",
+        isChartPoint: true,
+    }),
+    [ElementType.BAR_CHART]: (data) => ({
+        ...data,
+        elementType: "bar-chart",
+        actionType: "bar_click",
+    }),
+    [ElementType.ITEM_GRID]: (data) => ({
+        ...data,
+        id: data.id,
+        title: data.name || data.title || data.id,
+        isProduct: true,
+    }),
+    [ElementType.ITEM_CARD]: (data) => ({
+        ...data,
+        isProduct: true,
+    }),
+    [ElementType.IMAGE]: (data) => ({ ...data }),
+    [ElementType.DETAILS_DATA]: (data) => ({ ...data }),
+    [ElementType.FORM]: (data) => ({
+        ...data,
+        isFormSubmission: true,
+    }),
+    [ElementType.BUTTON]: (data) => ({
+        ...data,
+        elementType: "button",
+        buttonType: data.type || "action",
+    }),
+    [ElementType.ALERT]: (data) => ({
+        ...data,
+        elementType: "alert",
+        actionType: "alert_action_click",
+    }),
+    [ElementType.SCREEN]: (data) => ({ ...data }),
+};
+/**
+ * Build a text summary of tool result for the LLM content channel.
+ * Returns a human-readable description of what was rendered.
+ */
+export function buildContentSummary(elementType, data) {
+    const summaryBuilders = {
+        [ElementType.HEADER]: (d) => `Rendered header: "${d.title}"${d.subtitle ? ` — ${d.subtitle}` : ""}`,
+        [ElementType.CHAT_BUBBLE]: (d) => {
+            const text = String(d.text || "");
+            const preview = text.length > 100 ? text.slice(0, 100) + "..." : text;
+            return `Displayed message: "${preview}"`;
+        },
+        [ElementType.STATS_GRID]: (d) => {
+            const stats = d.stats;
+            return `Rendered stats grid with ${stats?.length || 0} metrics`;
+        },
+        [ElementType.DATA_TABLE]: (d) => {
+            const rows = d.rows;
+            const cols = d.columns;
+            return `Rendered data table "${d.title || "Table"}" with ${cols?.length || 0} columns and ${rows?.length || 0} rows`;
+        },
+        [ElementType.LINE_CHART]: (d) => {
+            const labels = d.labels;
+            return `Rendered line chart "${d.title || "Chart"}" with ${labels?.length || 0} data points`;
+        },
+        [ElementType.PIE_CHART]: (d) => {
+            const segments = d.data;
+            return `Rendered pie chart "${d.title || "Chart"}" with ${segments?.length || 0} segments`;
+        },
+        [ElementType.BAR_CHART]: (d) => {
+            const categories = d.categories;
+            const series = d.series;
+            return `Rendered bar chart "${d.title || "Chart"}" with ${categories?.length || 0} categories and ${series?.length || 0} series`;
+        },
+        [ElementType.ITEM_GRID]: (d) => {
+            const items = d.items;
+            return `Rendered item grid "${d.title || "Items"}" with ${items?.length || 0} items`;
+        },
+        [ElementType.ITEM_CARD]: (d) => `Rendered item card: "${d.title}"${d.price ? ` — ${d.price}` : ""}`,
+        [ElementType.IMAGE]: (d) => `Displayed image: "${d.alt || "Image"}"`,
+        [ElementType.DETAILS_DATA]: (d) => {
+            const items = d.items;
+            return `Rendered details display with ${items?.length || 0} data items`;
+        },
+        [ElementType.FORM]: (d) => {
+            const fields = d.fields;
+            return `Rendered form "${d.title || "Form"}" with ${fields?.length || 0} fields`;
+        },
+        [ElementType.BUTTON]: (d) => `Rendered button: "${d.label}"`,
+        [ElementType.ALERT]: (d) => `Displayed ${d.severity || "info"} alert: "${d.message}"`,
+        [ElementType.SCREEN]: (d) => {
+            const elements = d.elements;
+            return `Rendered screen with ${elements?.length || 0} elements`;
+        },
+    };
+    const builder = summaryBuilders[elementType];
+    return builder ? builder(data) : `Rendered ${elementType} element`;
+}