@enfyra/mcp-server 0.1.43 → 0.1.44

package/dist/lib/mcp-instructions.js

@@ -22,7 +22,7 @@ export function buildMcpServerInstructions(apiBaseUrl, options = {}) {
         '- For target sanity checks, call `get_enfyra_api_context`; do not load broad metadata only to confirm the API base.',
         '- When the goal is clear but the tool path is not, call `discover_enfyra_workflows` with intent/risk/surface. Use `detail: "plan"` before writes, follow `primaryPath`, and treat `avoidTools` as hard negative-routing boundaries.',
         '- Discover before deciding, then inspect narrowly. Use `inspect_table`, `inspect_route`, `inspect_feature`, `search_admin_extensions`, or `search_runtime_zone` for the exact table/route/feature/runtime artifact. Run broad discovery tools sequentially, not in parallel.',
-        '- Load examples only when needed with `get_enfyra_examples`. For OAuth use `get_enfyra_examples({ category: "oauth-setup" })`. For extension UI, call `get_extension_theme_contract` before writing or reviewing UI, use `build_extension_drawer`/`build_extension_modal` for drawer/modal snippets, and call `get_theme_class_reference` only when exact classes are needed.',
+        '- Load examples only when needed with `get_enfyra_examples`. For OAuth use `get_enfyra_examples({ category: "oauth-setup" })`. For extension UI, call `get_extension_theme_contract` before writing or reviewing UI, use `build_extension_*` tools for high-contract components such as drawers, modals, page shell headers/actions, permission gates, empty states, and resource lists, and call `get_theme_class_reference` only when exact classes are needed.',
         '- Prefer the most specific business operation tool over raw metadata CRUD.',
         '- Before any write, call `get_enfyra_required_knowledge({ scope })` with the right scope and pass returned ack keys into write tools. Choose scope by task domain:',
         '  • `schema` — table, column, relation, record CRUD, route permission, guard, field permission, column rule, cache reload, GraphQL enablement, log debug.',

package/dist/lib/mcp-instructions.js.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-instructions.js","sourceRoot":"","sources":["../../src/lib/mcp-instructions.ts"],"names":[],"mappings":"AAAA,mEAAmE;AACnE,MAAM,UAAU,gBAAgB,CAAC,UAAU;IACzC,MAAM,IAAI,GAAG,MAAM,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACzD,OAAO;QACL,cAAc,EAAE,GAAG,IAAI,UAAU;QACjC,gBAAgB,EAAE,GAAG,IAAI,iBAAiB;KAC3C,CAAC;AACJ,CAAC;AAMD,MAAM,UAAU,0BAA0B,CAAC,UAAU,EAAE,UAAiC,EAAE;IACxF,MAAM,IAAI,GAAG,MAAM,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACzD,MAAM,EAAE,cAAc,EAAE,gBAAgB,EAAE,GAAG,gBAAgB,CAAC,UAAU,CAAC,CAAC;IAC1E,MAAM,cAAc,GAAG,OAAO,EAAE,cAAc,IAAI,IAAI,CAAC;IAEvD,OAAO;QACL,eAAe;QACf,EAAE;QACF,gCAAgC,IAAI,KAAK;QACzC,wBAAwB,cAAc,YAAY,gBAAgB,KAAK;QACvE,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,cAAc,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/C,EAAE;QACF,qBAAqB;QACrB,qJAAqJ;QACrJ,qHAAqH;QACrH,qOAAqO;QACrO,8QAA8Q;QAC9Q,+WAA+W;QAC/W,4EAA4E;QAC5E,oKAAoK;QACpK,2JAA2J;QAC3J,uJAAuJ;QACvJ,8IAA8I;QAC9I,yDAAyD;QACzD,4EAA4E;QAC5E,sMAAsM;QACtM,mLAAmL;QACnL,8LAA8L;QAC9L,EAAE;QACF,0BAA0B;QAC1B,uHAAuH;QACvH,sLAAsL;QACtL,gLAAgL;QAChL,iLAAiL;QACjL,yLAAyL;QACzL,kKAAkK;QAClK,0HAA0H;QAC1H,4LAA4L;QAC5L,EAAE;QACF,+BAA+B;QAC/B,4HAA4H;QAC5H,4GAA4G;QAC5G,mIAAmI;QACnI,kJAAkJ;QAClJ,oNAAoN;QACpN,iKAAiK;QACjK,gIAAgI;QAChI,EAAE;QACF,+BAA+B;QAC/B,iIAAiI;QACjI,uJAAuJ;QACvJ,yOAAyO;QACzO,+JAA+J;QAC/J,iMAAiM;QACjM,wSAAwS;QACxS,qLAAqL;QACrL,kPAAkP;QAClP,+PAA+P;QAC/P,EAAE;QACF,4BAA4B;QAC5B,0MAA0M;QAC1M,oHAAoH;QACpH,kIAAkI;QAClI,8MAA8M;QAC9M,kNAAkN;QAClN,wLAAwL;QACxL,EAAE;QACF,uIAAuI;KACxI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC"}
+{"version":3,"file":"mcp-instructions.js","sourceRoot":"","sources":["../../src/lib/mcp-instructions.ts"],"names":[],"mappings":"AAAA,mEAAmE;AACnE,MAAM,UAAU,gBAAgB,CAAC,UAAU;IACzC,MAAM,IAAI,GAAG,MAAM,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACzD,OAAO;QACL,cAAc,EAAE,GAAG,IAAI,UAAU;QACjC,gBAAgB,EAAE,GAAG,IAAI,iBAAiB;KAC3C,CAAC;AACJ,CAAC;AAMD,MAAM,UAAU,0BAA0B,CAAC,UAAU,EAAE,UAAiC,EAAE;IACxF,MAAM,IAAI,GAAG,MAAM,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACzD,MAAM,EAAE,cAAc,EAAE,gBAAgB,EAAE,GAAG,gBAAgB,CAAC,UAAU,CAAC,CAAC;IAC1E,MAAM,cAAc,GAAG,OAAO,EAAE,cAAc,IAAI,IAAI,CAAC;IAEvD,OAAO;QACL,eAAe;QACf,EAAE;QACF,gCAAgC,IAAI,KAAK;QACzC,wBAAwB,cAAc,YAAY,gBAAgB,KAAK;QACvE,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,cAAc,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/C,EAAE;QACF,qBAAqB;QACrB,qJAAqJ;QACrJ,qHAAqH;QACrH,qOAAqO;QACrO,8QAA8Q;QAC9Q,mcAAmc;QACnc,4EAA4E;QAC5E,oKAAoK;QACpK,2JAA2J;QAC3J,uJAAuJ;QACvJ,8IAA8I;QAC9I,yDAAyD;QACzD,4EAA4E;QAC5E,sMAAsM;QACtM,mLAAmL;QACnL,8LAA8L;QAC9L,EAAE;QACF,0BAA0B;QAC1B,uHAAuH;QACvH,sLAAsL;QACtL,gLAAgL;QAChL,iLAAiL;QACjL,yLAAyL;QACzL,kKAAkK;QAClK,0HAA0H;QAC1H,4LAA4L;QAC5L,EAAE;QACF,+BAA+B;QAC/B,4HAA4H;QAC5H,4GAA4G;QAC5G,mIAAmI;QACnI,kJAAkJ;QAClJ,oNAAoN;QACpN,iKAAiK;QACjK,gIAAgI;QAChI,EAAE;QACF,+BAA+B;QAC/B,iIAAiI;QACjI,uJAAuJ;QACvJ,yOAAyO;QACzO,+JAA+J;QAC/J,iMAAiM;QACjM,wSAAwS;QACxS,qLAAqL;QACrL,kPAAkP;QAClP,+PAA+P;QAC/P,EAAE;QACF,4BAA4B;QAC5B,0MAA0M;QAC1M,oHAAoH;QACpH,kIAAkI;QAClI,8MAA8M;QAC9M,kNAAkN;QAClN,wLAAwL;QACxL,EAAE;QACF,uIAAuI;KACxI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC"}

package/dist/lib/platform-operation-tools.d.ts

@@ -14,6 +14,31 @@ export declare function buildExtensionModalSnippet(input: any): {
     warnings: string[];
     contract: string[];
 };
+export declare function buildExtensionPageShellSnippet(input: any): {
+    action: string;
+    snippet: string;
+    contract: string[];
+};
+export declare function buildExtensionPermissionGateSnippet(input: any): {
+    action: string;
+    component: string;
+    snippet: string;
+    normalizedBodyChanges: string[];
+    warnings: string[];
+    contract: string[];
+};
+export declare function buildExtensionEmptyStateSnippet(input: any): {
+    action: string;
+    component: string;
+    snippet: string;
+    contract: string[];
+};
+export declare function buildExtensionResourceListSnippet(input: any): {
+    action: string;
+    components: string[];
+    snippet: string;
+    contract: string[];
+};
 export declare function reviewExtensionUiContract(code: any): {
     action: string;
     valid: boolean;
@@ -28,11 +53,13 @@ export declare function reviewExtensionUiContract(code: any): {
 };
 export declare function validateExtensionCodeLocally(code: any): {
     componentCasing: string;
+    fieldWidth: string;
 };
 export declare function validateExtensionCode(apiUrl: any, code: any, name: any): Promise<{
     valid: boolean;
     localChecks: {
         componentCasing: string;
+        fieldWidth: string;
     };
     extensionId: any;
     compiledLength: any;

package/dist/lib/platform-operation-tools.js

@@ -19,6 +19,11 @@ const AUTO_INJECTED_EXTENSION_COMPONENT_TAGS = [
     'UFormField',
     'UIcon',
     'UInput',
+    'UInputMenu',
+    'UInputNumber',
+    'UInputTags',
+    'UInputTime',
+    'UInputDate',
     'UModal',
     'USelect',
     'USelectMenu',
@@ -30,6 +35,18 @@ const AUTO_INJECTED_EXTENSION_COMPONENT_TAGS = [
     'Widget',
 ];
 const AUTO_INJECTED_EXTENSION_COMPONENT_BY_LOWERCASE = new Map(AUTO_INJECTED_EXTENSION_COMPONENT_TAGS.map((tag) => [tag.toLowerCase(), tag]));
+const FULL_WIDTH_EXTENSION_FIELD_TAGS = [
+    'UInput',
+    'UTextarea',
+    'USelect',
+    'USelectMenu',
+    'UInputMenu',
+    'UInputNumber',
+    'UInputTags',
+    'UInputTime',
+    'UInputDate',
+];
+const FULL_WIDTH_EXTENSION_FIELD_PATTERN = new RegExp(`<(${FULL_WIDTH_EXTENSION_FIELD_TAGS.join('|')})(\\s[^<>]*?)(\\/?)>`, 'g');
 function unwrapData(result) {
     return Array.isArray(result?.data) ? result.data : [];
 }
@@ -308,7 +325,9 @@ function quoteJsString(value) {
 function normalizeVueBodySnippet(body) {
     let code = String(body || '').trim();
     const changes = [];
-    code = code.replace(/<(UInput|UTextarea|USelectMenu|USelect)(\s[^<>]*?)(\/?)>/g, (full, tag, attrs, slash) => {
+    code = code.replace(FULL_WIDTH_EXTENSION_FIELD_PATTERN, (full, tag, attrs, slash) => {
+        if (/\bdata-compact\b/.test(attrs) || /\bdata-inline\b/.test(attrs))
+            return full;
         if (/\bclass=/.test(attrs)) {
             const nextAttrs = attrs.replace(/class="([^"]*)"/, (classMatch, classes) => {
                 if (String(classes).split(/\s+/).includes('w-full'))
@@ -331,6 +350,23 @@ function normalizeVueBodySnippet(body) {
     });
     return { code, changes: Array.from(new Set(changes)) };
 }
+function findMissingFullWidthFieldControls(code) {
+    const violations = [];
+    for (const template of readTemplateBlocks(code)) {
+        let match;
+        FULL_WIDTH_EXTENSION_FIELD_PATTERN.lastIndex = 0;
+        while ((match = FULL_WIDTH_EXTENSION_FIELD_PATTERN.exec(template))) {
+            const [snippet, tag, attrs] = match;
+            if (/\bdata-compact\b/.test(attrs) || /\bdata-inline\b/.test(attrs))
+                continue;
+            const classMatch = attrs.match(/\bclass="([^"]*)"/);
+            if (!classMatch || !classMatch[1].split(/\s+/).includes('w-full')) {
+                violations.push({ tag, snippet: snippet.length > 160 ? `${snippet.slice(0, 157)}...` : snippet });
+            }
+        }
+    }
+    return violations;
+}
 function indentLines(code, spaces = 2) {
     const pad = ' '.repeat(spaces);
     return String(code || '')
@@ -473,6 +509,140 @@ export function buildExtensionModalSnippet(input) {
         ],
     };
 }
+function jsObjectLiteral(entries) {
+    return `{ ${entries.filter(Boolean).join(', ')} }`;
+}
+function buildHeaderActionLiteral(action) {
+    const entries = [
+        action.id ? `id: ${quoteJsString(action.id)}` : null,
+        action.label ? `label: ${quoteJsString(action.label)}` : null,
+        action.icon ? `icon: ${quoteJsString(action.icon)}` : null,
+        `color: ${quoteJsString(action.color || 'neutral')}`,
+        `variant: ${quoteJsString(action.variant || 'outline')}`,
+        action.loading ? `loading: ${action.loading}` : null,
+        action.disabled ? `disabled: ${action.disabled}` : null,
+        action.to ? `to: ${quoteJsString(action.to)}` : null,
+        action.onClick ? `onClick: ${action.onClick}` : null,
+        typeof action.order === 'number' ? `order: ${action.order}` : null,
+        action.side ? `side: ${quoteJsString(action.side)}` : null,
+    ];
+    return jsObjectLiteral(entries);
+}
+export function buildExtensionPageShellSnippet(input) {
+    const title = input.titleExpression || quoteJsString(input.title || 'Untitled');
+    const headerEntries = [
+        `title: ${title}`,
+        input.description ? `description: ${quoteJsString(input.description)}` : null,
+        input.leadingIcon ? `leadingIcon: ${quoteJsString(input.leadingIcon)}` : null,
+        `gradient: ${quoteJsString(input.gradient || 'none')}`,
+        `variant: ${quoteJsString(input.variant || 'minimal')}`,
+    ];
+    const actions = Array.isArray(input.headerActions) ? input.headerActions : [];
+    const lines = [
+        'const { registerPageHeader } = usePageHeaderRegistry();',
+        `registerPageHeader(${jsObjectLiteral(headerEntries)});`,
+    ];
+    if (actions.length) {
+        lines.push('const { register: registerHeaderActions } = useHeaderActionRegistry();');
+        lines.push(`registerHeaderActions([\n${actions.map((action) => `  ${buildHeaderActionLiteral(action)}`).join(',\n')}\n]);`);
+    }
+    return {
+        action: 'extension_page_shell_built',
+        snippet: lines.join('\n'),
+        contract: [
+            'Use usePageHeaderRegistry so the app shell renders the page header.',
+            'Use useHeaderActionRegistry for toolbar actions instead of rendering duplicate page headers or local top bars.',
+            'Use primary solid only for the main scope action; secondary actions default to neutral outline.',
+        ],
+    };
+}
+export function buildExtensionPermissionGateSnippet(input) {
+    const normalized = normalizeVueBodySnippet(input.body || '<slot />');
+    let condition;
+    if (input.condition) {
+        condition = input.condition;
+    }
+    else if (input.route) {
+        const methods = Array.isArray(input.methods) && input.methods.length ? input.methods : ['GET'];
+        condition = `{ or: [{ route: ${quoteJsString(input.route)}, methods: [${methods.map(quoteJsString).join(', ')}] }] }`;
+    }
+    else {
+        condition = 'null';
+    }
+    const snippet = [
+        `<PermissionGate :condition="${condition}">`,
+        indentLines(normalized.code, 2),
+        '</PermissionGate>',
+    ].join('\n');
+    return {
+        action: 'extension_permission_gate_built',
+        component: 'PermissionGate',
+        snippet,
+        normalizedBodyChanges: normalized.changes,
+        warnings: condition === 'null' ? ['No condition/route was provided. PermissionGate with null condition permits the slot.'] : [],
+        contract: [
+            'PermissionGate is only operator UX; backend route permissions and owner checks remain authoritative.',
+            'PermissionGate renders its slot directly and should not be used as a layout wrapper.',
+        ],
+    };
+}
+export function buildExtensionEmptyStateSnippet(input) {
+    const action = input.action
+        ? `\n  :action="${buildFooterActionObject(input.action)}"`
+        : '';
+    return {
+        action: 'extension_empty_state_built',
+        component: 'CommonEmptyState',
+        snippet: `<CommonEmptyState\n  title="${String(input.title || 'No items found').replace(/"/g, '&quot;')}"\n  description="${String(input.description || '').replace(/"/g, '&quot;')}"\n  icon="${input.icon || 'lucide:inbox'}"\n  size="${input.size || 'sm'}"\n  variant="${input.variant || 'naked'}"${action}\n/>`,
+        contract: [
+            'Use CommonEmptyState for app-matched empty states.',
+            'Use variant="naked" inside framed panels/lists and outline/subtle for standalone framed empty surfaces.',
+        ],
+    };
+}
+export function buildExtensionResourceListSnippet(input) {
+    const itemsExpression = input.itemsExpression || 'items';
+    const itemName = input.itemName || 'item';
+    const keyExpression = input.keyExpression || `${itemName}.id`;
+    const titleExpression = input.titleExpression || `${itemName}.title || ${quoteJsString('Untitled')}`;
+    const descriptionExpression = input.descriptionExpression || `${itemName}.description`;
+    const iconExpression = input.iconExpression || quoteJsString(input.icon || 'lucide:file-text');
+    const onClick = input.onClick ? `\n      :on-click="() => ${input.onClick}"` : '';
+    const stats = input.statsExpression ? `\n      :stats="${input.statsExpression}"` : '';
+    const actions = input.actionsExpression ? `\n      :actions="${input.actionsExpression}"` : '';
+    const topBadge = input.topBadgeExpression ? `\n      :top-badge="${input.topBadgeExpression}"` : '';
+    const snippet = [
+        '<CommonResourceListFrame',
+        `  :loading="${input.loadingExpression || 'pending'}"`,
+        `  :has-items="${itemsExpression}.length > 0"`,
+        `  :total="${input.totalExpression || `${itemsExpression}.length`}"`,
+        `  :items-per-page="${input.itemsPerPageExpression || '0'}"`,
+        `  empty-title="${String(input.emptyTitle || 'No items found').replace(/"/g, '&quot;')}"`,
+        `  empty-description="${String(input.emptyDescription || '').replace(/"/g, '&quot;')}"`,
+        `  empty-icon="${input.emptyIcon || 'lucide:inbox'}"`,
+        '>',
+        `  <CommonResourceListItem`,
+        `    v-for="${itemName} in ${itemsExpression}"`,
+        `    :key="${keyExpression}"`,
+        `    :title="${titleExpression}"`,
+        `    :description="${descriptionExpression}"`,
+        `    :icon="${iconExpression}"`,
+        '    icon-color="primary"',
+        `${stats}${actions}${topBadge}${onClick}`,
+        '  />',
+        '</CommonResourceListFrame>',
+    ].join('\n');
+    return {
+        action: 'extension_resource_list_built',
+        components: ['CommonResourceListFrame', 'CommonResourceListItem'],
+        snippet,
+        contract: [
+            'Use CommonResourceListFrame and CommonResourceListItem for operational lists instead of ad hoc cards.',
+            'Keep first-load skeleton, empty state, and pagination owned by the frame.',
+            'Use explicit bounded list data and natural pagination/search outside this snippet when the domain list can grow.',
+        ],
+    };
+}
 export function reviewExtensionUiContract(code) {
     const source = String(code || '');
     const issues = [];
@@ -583,6 +753,7 @@ function getExtensionThemeContract() {
             'Buttons should have stable geometry: hover may change color, border, or shadow but must not move the button or resize its content. Disabled buttons keep disabled cursor/visual state.',
             'Inputs and textareas should not add hover movement or decorative hover states; focus, invalid, disabled, and loading states must be explicit.',
             'Inside CommonDrawer/CommonModal body forms, UInput, UTextarea, USelect, USelectMenu, and similar field controls must use class="w-full" unless the control is intentionally inline or compact.',
+            'Extension validation rejects UInput, UTextarea, USelect, USelectMenu, UInputMenu, UInputNumber, UInputTags, UInputTime, and UInputDate without class="w-full" unless marked data-compact or data-inline.',
             'Dynamic extensions resolve UModal to the app CommonModal. Do not pass ui.content: "eapp-surface-card" or "surface-card" to UModal/CommonModal; modal content uses the app modal surface and caller ui.content should only append z-index, width, or max-width classes.',
             'CommonModal and CommonDrawer own action-only footers through cancelAction, primaryAction, dangerAction, leadingActions, and footerHint. Pass footer button intent through those props instead of custom footer slots. cancelAction defaults to neutral outline; use dangerAction for irreversible destructive work and tone: "primary" for Keep editing in discard dialogs.',
             'Use custom #footer content only when the footer contains real custom layout or non-button content. Every modal/drawer button should use type="button" unless it intentionally submits a form.',
@@ -863,7 +1034,12 @@ export function validateExtensionCodeLocally(code) {
         const first = violations[0];
         throw new Error(`Invalid extension component casing: use <${first.expected}> instead of <${first.tag}>. Enfyra/Nuxt UI auto-injected components must keep PascalCase in extension templates; lowercase tags render as unresolved DOM elements.`);
     }
-    return { componentCasing: 'passed' };
+    const missingFullWidthFields = findMissingFullWidthFieldControls(code);
+    if (missingFullWidthFields.length) {
+        const first = missingFullWidthFields[0];
+        throw new Error(`Invalid extension field width: <${first.tag}> must include class="w-full" in Enfyra extensions unless it is intentionally compact with data-compact or data-inline. First offending snippet: ${first.snippet}`);
+    }
+    return { componentCasing: 'passed', fieldWidth: 'passed' };
 }
 export async function validateExtensionCode(apiUrl, code, name) {
     const localChecks = validateExtensionCodeLocally(code);
@@ -2075,6 +2251,19 @@ export function registerPlatformOperationTools(server, ENFYRA_API_URL) {
         tone: z.string().optional().describe('Optional action tone when supported by the shell component.'),
         onClick: z.string().describe('Raw Vue expression or function reference for the click handler, e.g. saveNote or () => (open = false).'),
     });
+    const extensionHeaderActionSchema = z.object({
+        id: z.string().describe('Stable action id.'),
+        label: z.string().optional().describe('Action label.'),
+        icon: z.string().optional().describe('Icon name such as lucide:plus or lucide:refresh-cw.'),
+        color: z.string().optional().default('neutral').describe('Nuxt UI color. Use primary only for the single main scope action; otherwise neutral.'),
+        variant: z.string().optional().default('outline').describe('Nuxt UI variant. Use solid for the main scope action; otherwise outline/ghost.'),
+        loading: z.string().optional().describe('Raw Vue expression/ref name for loading state.'),
+        disabled: z.string().optional().describe('Raw Vue expression/ref name for disabled state.'),
+        to: z.string().optional().describe('Route path for visible navigation actions.'),
+        onClick: z.string().optional().describe('Raw Vue expression or function reference for click behavior.'),
+        order: z.number().optional().describe('Sort order in the shell header action area.'),
+        side: z.enum(['left', 'right']).optional().describe('Optional shell side.'),
+    });
     server.tool('validate_dynamic_script', [
         'Validate Enfyra dynamic script code before saving it to any script-backed metadata record.',
         'Use this before create/update of handlers, hooks, flow steps, websocket scripts, GraphQL scripts, or bootstrap scripts when the user is iterating on code.',
@@ -2187,6 +2376,60 @@ export function registerPlatformOperationTools(server, ENFYRA_API_URL) {
     ].join(' '), {
         code: z.string().describe('Vue SFC or template snippet to review.'),
     }, async ({ code }) => jsonText(reviewExtensionUiContract(code)));
+    server.tool('build_extension_page_shell', [
+        'Generate page-header and shell-header-action script setup code for Enfyra page extensions.',
+        'Use this so generated page extensions register shell chrome through usePageHeaderRegistry/useHeaderActionRegistry instead of rendering duplicate local headers.',
+    ].join(' '), {
+        title: z.string().optional().describe('Static page title.'),
+        titleExpression: z.string().optional().describe('Raw Vue expression for a dynamic title.'),
+        description: z.string().optional().describe('Optional page description.'),
+        leadingIcon: z.string().optional().describe('Optional page header icon.'),
+        gradient: z.enum(['none', 'purple', 'blue', 'cyan']).optional().default('none').describe('Generated operational extensions should usually use none.'),
+        variant: z.enum(['default', 'minimal', 'stats-focus']).optional().default('minimal').describe('Page header variant.'),
+        headerActions: z.array(extensionHeaderActionSchema).optional().describe('Optional shell header actions registered through useHeaderActionRegistry.'),
+    }, async (input) => jsonText(buildExtensionPageShellSnippet(input)));
+    server.tool('build_extension_permission_gate', [
+        'Generate a PermissionGate wrapper snippet for Enfyra admin extension UI.',
+        'Use this when a visible button/block/list needs operator UX gating; backend route permissions and owner checks still remain authoritative.',
+    ].join(' '), {
+        route: z.string().optional().describe('API route path to gate against, e.g. /notes.'),
+        methods: z.array(z.string()).optional().describe('HTTP methods for the route condition. Defaults to GET when route is provided.'),
+        condition: z.string().optional().describe('Raw Vue permission condition expression. Overrides route/methods when provided.'),
+        body: z.string().describe('Vue template content to render inside PermissionGate. Field controls are normalized to w-full.'),
+    }, async (input) => jsonText(buildExtensionPermissionGateSnippet(input)));
+    server.tool('build_extension_empty_state', [
+        'Generate a CommonEmptyState snippet for Enfyra admin extensions.',
+        'Use this for app-matched empty/error/no-results states instead of hand-rolled blank panels.',
+    ].join(' '), {
+        title: z.string().optional().describe('Empty state title.'),
+        description: z.string().optional().describe('Empty state description.'),
+        icon: z.string().optional().describe('Icon name. Defaults to lucide:inbox.'),
+        size: z.enum(['sm', 'md', 'lg']).optional().default('sm').describe('Empty state size.'),
+        variant: z.enum(['outline', 'naked', 'soft', 'subtle', 'solid']).optional().default('naked').describe('Use naked inside existing panels/lists.'),
+        action: extensionFooterActionSchema.optional().describe('Optional primary empty-state action.'),
+    }, async (input) => jsonText(buildExtensionEmptyStateSnippet(input)));
+    server.tool('build_extension_resource_list', [
+        'Generate a CommonResourceListFrame/CommonResourceListItem snippet for Enfyra admin extensions.',
+        'Use this for operational list pages so loading, empty state, pagination placement, row chrome, icons, stats, and row actions follow the app contract.',
+    ].join(' '), {
+        itemsExpression: z.string().optional().default('items').describe('Vue expression for the row array, e.g. notes.'),
+        itemName: z.string().optional().default('item').describe('Loop variable name.'),
+        keyExpression: z.string().optional().describe('Vue expression for :key. Defaults to item.id.'),
+        titleExpression: z.string().optional().describe('Vue expression for item title. Defaults to item.title || "Untitled".'),
+        descriptionExpression: z.string().optional().describe('Vue expression for item description. Defaults to item.description.'),
+        icon: z.string().optional().describe('Static row icon when iconExpression is omitted.'),
+        iconExpression: z.string().optional().describe('Vue expression for row icon.'),
+        loadingExpression: z.string().optional().default('pending').describe('Vue expression for frame loading.'),
+        totalExpression: z.string().optional().describe('Vue expression for total rows.'),
+        itemsPerPageExpression: z.string().optional().describe('Vue expression for items per page; use 0 to hide pagination.'),
+        statsExpression: z.string().optional().describe('Vue expression returning ResourceListStat[] for each row.'),
+        actionsExpression: z.string().optional().describe('Vue expression returning ResourceListAction[] for each row.'),
+        topBadgeExpression: z.string().optional().describe('Vue expression returning a ResourceListTopBadge for each row.'),
+        onClick: z.string().optional().describe('Raw Vue expression called for row click, e.g. openEdit(item).'),
+        emptyTitle: z.string().optional().describe('Empty title.'),
+        emptyDescription: z.string().optional().describe('Empty description.'),
+        emptyIcon: z.string().optional().describe('Empty icon.'),
+    }, async (input) => jsonText(buildExtensionResourceListSnippet(input)));
     server.tool('extension_workflow', [
         'Step-by-step workflow for creating or updating Enfyra admin page, global, or widget extensions.',
         'Use this when an LLM is building extension UI, menu shell notifications, account panel entries, or page/menu wiring and should follow live nextSteps instead of guessing raw enfyra_extension mutations.',