@enfyra/mcp-server 0.1.44 → 0.1.45

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_*` 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.',
+        '- 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, resource lists, FormEditor, Widget, menu/account panel registries, tabs, and upload modals, 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,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"}
+{"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,2gBAA2gB;QAC3gB,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

@@ -39,6 +39,42 @@ export declare function buildExtensionResourceListSnippet(input: any): {
     snippet: string;
     contract: string[];
 };
+export declare function buildExtensionFormEditorSnippet(input: any): {
+    action: string;
+    component: string;
+    snippet: string;
+    contract: string[];
+};
+export declare function buildExtensionWidgetSnippet(input: any): {
+    action: string;
+    component: string;
+    snippet: string;
+    warnings: string[];
+    contract: string[];
+};
+export declare function buildExtensionMenuNotificationSnippet(input: any): {
+    action: string;
+    snippet: string;
+    contract: string[];
+};
+export declare function buildExtensionAccountPanelSnippet(input: any): {
+    action: string;
+    snippet: string;
+    contract: string[];
+};
+export declare function buildExtensionTabsSnippet(input: any): {
+    action: string;
+    component: string;
+    snippet: string;
+    contract: string[];
+};
+export declare function buildExtensionUploadModalSnippet(input: any): {
+    action: string;
+    component: string;
+    snippet: string;
+    companionSnippet: string;
+    contract: string[];
+};
 export declare function reviewExtensionUiContract(code: any): {
     action: string;
     valid: boolean;

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

@@ -512,6 +512,16 @@ export function buildExtensionModalSnippet(input) {
 function jsObjectLiteral(entries) {
     return `{ ${entries.filter(Boolean).join(', ')} }`;
 }
+function jsArrayLiteral(values) {
+    return `[${(values || []).map(quoteJsString).join(', ')}]`;
+}
+function attrStaticOrBound(name, value, expression) {
+    if (expression)
+        return `:${name}="${expression}"`;
+    if (value === undefined || value === null || value === '')
+        return null;
+    return `${name}="${String(value).replace(/"/g, '"')}"`;
+}
 function buildHeaderActionLiteral(action) {
     const entries = [
         action.id ? `id: ${quoteJsString(action.id)}` : null,
@@ -643,6 +653,189 @@ export function buildExtensionResourceListSnippet(input) {
         ],
     };
 }
+export function buildExtensionFormEditorSnippet(input) {
+    const tag = input.lazy === false ? 'FormEditor' : 'FormEditorLazy';
+    const attrs = [
+        `v-model="${input.model || 'form'}"`,
+        `v-model:errors="${input.errors || 'errors'}"`,
+        attrStaticOrBound('table-name', input.tableName, input.tableNameExpression),
+        input.mode ? `mode="${input.mode}"` : null,
+        input.loadingExpression ? `:loading="${input.loadingExpression}"` : null,
+        input.layout ? `layout="${input.layout}"` : null,
+        input.includes?.length ? `:includes="${jsArrayLiteral(input.includes)}"` : null,
+        input.excluded?.length ? `:excluded="${jsArrayLiteral(input.excluded)}"` : null,
+        input.sectionsExpression ? `:sections="${input.sectionsExpression}"` : null,
+        input.fieldMapExpression ? `:field-map="${input.fieldMapExpression}"` : null,
+        input.virtualFieldsExpression ? `:virtual-fields="${input.virtualFieldsExpression}"` : null,
+        input.currentRecordIdExpression ? `:current-record-id="${input.currentRecordIdExpression}"` : null,
+        input.hasChangedHandler ? `@has-changed="${input.hasChangedHandler}"` : null,
+        input.virtualFieldEmitHandler ? `@virtual-field-emit="${input.virtualFieldEmitHandler}"` : null,
+    ].filter(Boolean);
+    const snippet = [
+        `<${tag}`,
+        ...attrs.map((attr) => `  ${attr}`),
+        '/>',
+    ].join('\n');
+    return {
+        action: 'extension_form_editor_built',
+        component: tag,
+        snippet,
+        contract: [
+            'Prefer FormEditor/FormEditorLazy for direct table-backed forms instead of hand-built UInput/UTextarea fields.',
+            'Use v-model for record state and v-model:errors for validation errors.',
+            'Use includes/sections to keep generated forms focused; do not expose compiledCode or unrelated system fields.',
+            'Use fieldMap only for behavior/renderer overrides such as code fields or custom labels.',
+        ],
+    };
+}
+export function buildExtensionWidgetSnippet(input) {
+    const attrs = [`:id="${typeof input.id === 'number' ? input.id : quoteJsString(input.id)}"`];
+    for (const [key, value] of Object.entries(input.props || {})) {
+        attrs.push(`:${key}="${value}"`);
+    }
+    for (const [event, handler] of Object.entries(input.events || {})) {
+        attrs.push(`@${event}="${handler}"`);
+    }
+    return {
+        action: 'extension_widget_built',
+        component: 'Widget',
+        snippet: `<Widget ${attrs.join(' ')} />`,
+        warnings: typeof input.id === 'number' ? [] : ['Widget ids should be numeric enfyra_extension ids; do not pass extension name or extensionId string.'],
+        contract: [
+            'Widget :id is the numeric enfyra_extension id, not name or extensionId.',
+            'Pass safe props/events; keep page-level mutation and modal ownership in the page unless the widget intentionally owns the full workflow.',
+        ],
+    };
+}
+export function buildExtensionMenuNotificationSnippet(input) {
+    const targetEntries = [
+        input.targetId !== undefined ? `id: ${quoteJsString(input.targetId)}` : null,
+        input.path ? `path: ${quoteJsString(input.path)}` : null,
+        input.route ? `route: ${quoteJsString(input.route)}` : null,
+    ];
+    const entries = [
+        `id: ${quoteJsString(input.id || 'extension-menu-notification')}`,
+        `target: ${jsObjectLiteral(targetEntries)}`,
+        input.valueExpression ? `value: ${input.valueExpression}` : input.value !== undefined ? `value: ${quoteJsString(input.value)}` : null,
+        `color: ${quoteJsString(input.color || 'primary')}`,
+        input.title ? `title: ${quoteJsString(input.title)}` : null,
+        typeof input.order === 'number' ? `order: ${input.order}` : null,
+    ];
+    return {
+        action: 'extension_menu_notification_built',
+        snippet: [
+            'const { register: registerMenuNotification } = useMenuNotificationRegistry();',
+            `registerMenuNotification(${jsObjectLiteral(entries)});`,
+        ].join('\n'),
+        contract: [
+            'Use count/value only when the signal source already owns an exact or bounded count.',
+            'Omit value for a dot-only notification when realtime only proves new attention exists.',
+            'Do not fetch destination domain lists solely to decorate the menu.',
+        ],
+    };
+}
+export function buildExtensionAccountPanelSnippet(input) {
+    const entries = [
+        `id: ${quoteJsString(input.id || 'extension-account-panel-item')}`,
+        typeof input.order === 'number' ? `order: ${input.order}` : null,
+        input.label ? `label: ${quoteJsString(input.label)}` : null,
+        input.description ? `description: ${quoteJsString(input.description)}` : null,
+        input.icon ? `icon: ${quoteJsString(input.icon)}` : null,
+        input.countExpression ? `count: ${input.countExpression}` : input.count !== undefined ? `count: ${quoteJsString(input.count)}` : null,
+        input.badgeExpression ? `badge: ${input.badgeExpression}` : input.badge !== undefined ? `badge: ${quoteJsString(input.badge)}` : null,
+        input.badgeColor ? `badgeColor: ${quoteJsString(input.badgeColor)}` : null,
+        input.trailingIcon ? `trailingIcon: ${quoteJsString(input.trailingIcon)}` : null,
+        input.expandedExpression ? `expanded: ${input.expandedExpression}` : null,
+        input.contentComponent ? `contentComponent: ${input.contentComponent}` : null,
+        input.contentPropsExpression ? `contentProps: ${input.contentPropsExpression}` : null,
+        input.onClick ? `onClick: ${input.onClick}` : null,
+        input.onToggle ? `onToggle: ${input.onToggle}` : null,
+    ];
+    return {
+        action: 'extension_account_panel_item_built',
+        snippet: [
+            'const { register: registerAccountPanelItem } = useAccountPanelRegistry();',
+            `registerAccountPanelItem(${jsObjectLiteral(entries)});`,
+        ].join('\n'),
+        contract: [
+            'Prefer data-driven account panel rows over fully custom row components.',
+            'Use count for notification-style chips; count takes precedence over badge.',
+            'Use onClick for direct actions and onToggle/contentComponent for expandable inline UI.',
+        ],
+    };
+}
+export function buildExtensionTabsSnippet(input) {
+    const model = input.model || 'activeTab';
+    const items = input.itemsExpression || 'tabs';
+    const body = input.body || '<div>{{ item.label }}</div>';
+    const snippet = [
+        `<UTabs v-model="${model}" :items="${items}" class="w-full">`,
+        '  <template #content="{ item }">',
+        indentLines(normalizeVueBodySnippet(body).code, 4),
+        '  </template>',
+        '</UTabs>',
+    ].join('\n');
+    return {
+        action: 'extension_tabs_built',
+        component: 'UTabs',
+        snippet,
+        contract: [
+            'Use app-level UTabs chrome instead of custom tab bars.',
+            'Do not add local full-width bottom borders/dividers to tab lists.',
+            'Keep tab items data-driven and render panel content through #content.',
+        ],
+    };
+}
+export function buildExtensionUploadModalSnippet(input) {
+    const model = input.model || 'showUploadModal';
+    const attrs = [
+        `v-model="${model}"`,
+        `title="${String(input.title || 'Upload Files').replace(/"/g, '&quot;')}"`,
+        `accept="${input.accept || '*/*'}"`,
+        input.multiple !== false ? ':multiple="true"' : ':multiple="false"',
+        input.maxSizeExpression ? `:max-size="${input.maxSizeExpression}"` : ':max-size="10 * 1024 * 1024"',
+        input.loadingExpression ? `:loading="${input.loadingExpression}"` : null,
+        input.uploadProgressExpression ? `:upload-progress="${input.uploadProgressExpression}"` : null,
+        input.fileProgressExpression ? `:file-progress="${input.fileProgressExpression}"` : null,
+        input.dragText ? `drag-text="${String(input.dragText).replace(/"/g, '&quot;')}"` : null,
+        input.acceptText ? `accept-text="${String(input.acceptText).replace(/"/g, '&quot;')}"` : null,
+        input.uploadText ? `upload-text="${String(input.uploadText).replace(/"/g, '&quot;')}"` : null,
+        input.uploadingText ? `uploading-text="${String(input.uploadingText).replace(/"/g, '&quot;')}"` : null,
+        `@upload="${input.uploadHandler || 'handleUpload'}"`,
+        input.errorHandler ? `@error="${input.errorHandler}"` : null,
+    ].filter(Boolean);
+    const headerContent = input.headerContent ? [
+        '>',
+        '  <template #header-content>',
+        indentLines(normalizeVueBodySnippet(input.headerContent).code, 4),
+        '  </template>',
+        '</CommonUploadModal>',
+    ] : ['/>'];
+    return {
+        action: 'extension_upload_modal_built',
+        component: 'CommonUploadModal',
+        snippet: [
+            '<CommonUploadModal',
+            ...attrs.map((attr) => `  ${attr}`),
+            ...headerContent,
+        ].join('\n'),
+        companionSnippet: [
+            'const {',
+            '  uploadProgress,',
+            '  trackedUploadProgressById,',
+            '  beginTrackedUploadProgress,',
+            '  getUploadProgressHeaders,',
+            '  resetUploadProgress,',
+            '} = useFileUploadProgress();',
+        ].join('\n'),
+        contract: [
+            'Use useFileUploadProgress for admin-socket upload progress.',
+            'Send x-enfyra-upload-id via getUploadProgressHeaders(id) for each uploaded file.',
+            'For multi-file uploads, call the useApi batch files path once, pass per-file headers through headersByIndex, and map each upload id to fileProgress[index].',
+            'CommonUploadModal owns selected-file rows and per-row progress chrome.',
+        ],
+    };
+}
 export function reviewExtensionUiContract(code) {
     const source = String(code || '');
     const issues = [];
@@ -2430,6 +2623,98 @@ export function registerPlatformOperationTools(server, ENFYRA_API_URL) {
         emptyDescription: z.string().optional().describe('Empty description.'),
         emptyIcon: z.string().optional().describe('Empty icon.'),
     }, async (input) => jsonText(buildExtensionResourceListSnippet(input)));
+    server.tool('build_extension_form_editor', [
+        'Generate a FormEditor/FormEditorLazy snippet for Enfyra table-backed extension forms.',
+        'Use this instead of hand-writing UInput/UTextarea fields when the form maps directly to a table record.',
+    ].join(' '), {
+        tableName: z.string().optional().describe('Static table name.'),
+        tableNameExpression: z.string().optional().describe('Raw Vue expression for dynamic table name.'),
+        model: z.string().optional().default('form').describe('Record state variable for v-model.'),
+        errors: z.string().optional().default('errors').describe('Errors state variable for v-model:errors.'),
+        mode: z.enum(['create', 'update']).optional().describe('Optional fixed form mode.'),
+        loadingExpression: z.string().optional().describe('Raw Vue expression/ref for loading.'),
+        layout: z.enum(['stack', 'grid']).optional().describe('Form layout.'),
+        includes: z.array(z.string()).optional().describe('Fields to include. Prefer explicit includes for focused generated forms.'),
+        excluded: z.array(z.string()).optional().describe('Fields to exclude. compiledCode is always excluded by FormEditor.'),
+        sectionsExpression: z.string().optional().describe('Raw Vue expression for FormEditorSection[].'),
+        fieldMapExpression: z.string().optional().describe('Raw Vue expression for fieldMap overrides.'),
+        virtualFieldsExpression: z.string().optional().describe('Raw Vue expression for virtual fields.'),
+        currentRecordIdExpression: z.string().optional().describe('Raw Vue expression for current record id.'),
+        hasChangedHandler: z.string().optional().describe('Handler expression for @has-changed.'),
+        virtualFieldEmitHandler: z.string().optional().describe('Handler expression for @virtual-field-emit.'),
+        lazy: z.boolean().optional().default(true).describe('Use FormEditorLazy by default.'),
+    }, async (input) => jsonText(buildExtensionFormEditorSnippet(input)));
+    server.tool('build_extension_widget', [
+        'Generate a Widget snippet for reusing a widget extension inside an Enfyra page extension.',
+        'Use this so agents pass numeric widget ids and keep prop/event ownership explicit.',
+    ].join(' '), {
+        id: z.union([z.number(), z.string()]).describe('Numeric enfyra_extension widget id. Strings are allowed but return a warning because names/extensionId are wrong for Widget.'),
+        props: z.record(z.string()).optional().describe('Map of prop name to raw Vue expression.'),
+        events: z.record(z.string()).optional().describe('Map of event name to handler expression.'),
+    }, async (input) => jsonText(buildExtensionWidgetSnippet(input)));
+    server.tool('build_extension_menu_notification', [
+        'Generate useMenuNotificationRegistry registration code for a global extension.',
+        'Use this for sidebar menu count chips or dot notifications without mutating enfyra_menu records.',
+    ].join(' '), {
+        id: z.string().optional().describe('Stable notification id.'),
+        targetId: z.union([z.string(), z.number()]).optional().describe('Target menu id.'),
+        path: z.string().optional().describe('Target menu path.'),
+        route: z.string().optional().describe('Target route path.'),
+        value: z.union([z.string(), z.number()]).optional().describe('Static count/chip value. Omit with valueExpression for a dot.'),
+        valueExpression: z.string().optional().describe('Raw Vue expression for count/chip value. Omit value for a dot-only notification.'),
+        color: z.enum(['primary', 'success', 'warning', 'error', 'info', 'neutral']).optional().default('primary').describe('Chip/dot color intent.'),
+        title: z.string().optional().describe('Optional tooltip/title.'),
+        order: z.number().optional().describe('Sort order when multiple notifications target the same menu.'),
+    }, async (input) => jsonText(buildExtensionMenuNotificationSnippet(input)));
+    server.tool('build_extension_account_panel_item', [
+        'Generate useAccountPanelRegistry registration code for a global extension.',
+        'Use this for data-driven account panel rows instead of drawing full custom sidebar/account UI.',
+    ].join(' '), {
+        id: z.string().optional().describe('Stable account panel item id.'),
+        order: z.number().optional().describe('Display order.'),
+        label: z.string().optional().describe('Row label.'),
+        description: z.string().optional().describe('Row description.'),
+        icon: z.string().optional().describe('Leading icon.'),
+        count: z.union([z.string(), z.number()]).optional().describe('Static notification chip value.'),
+        countExpression: z.string().optional().describe('Raw Vue expression for notification chip value.'),
+        badge: z.union([z.string(), z.number()]).optional().describe('Legacy static badge value. Prefer count.'),
+        badgeExpression: z.string().optional().describe('Raw Vue expression for badge. Prefer countExpression.'),
+        badgeColor: z.enum(['primary', 'neutral', 'info', 'error', 'warning', 'success']).optional().describe('Chip color.'),
+        trailingIcon: z.string().optional().describe('Trailing icon.'),
+        expandedExpression: z.string().optional().describe('Raw Vue expression controlling expanded state.'),
+        contentComponent: z.string().optional().describe('Raw component reference for inline expanded content.'),
+        contentPropsExpression: z.string().optional().describe('Raw Vue expression for content props.'),
+        onClick: z.string().optional().describe('Direct action handler expression.'),
+        onToggle: z.string().optional().describe('Expandable row toggle handler expression.'),
+    }, async (input) => jsonText(buildExtensionAccountPanelSnippet(input)));
+    server.tool('build_extension_tabs', [
+        'Generate a UTabs snippet for Enfyra extension page sections.',
+        'Use this instead of custom tab bars so app-wide tab chrome owns active indicators, focus rings, spacing, and theme contrast.',
+    ].join(' '), {
+        model: z.string().optional().default('activeTab').describe('Active tab model variable.'),
+        itemsExpression: z.string().optional().default('tabs').describe('Raw Vue expression for tab items.'),
+        body: z.string().optional().describe('Vue template body for #content="{ item }".'),
+    }, async (input) => jsonText(buildExtensionTabsSnippet(input)));
+    server.tool('build_extension_upload_modal', [
+        'Generate a CommonUploadModal snippet and upload-progress companion snippet for Enfyra extensions.',
+        'Use this for file upload UI so progress, selected-file rows, and x-enfyra-upload-id wiring follow the app contract.',
+    ].join(' '), {
+        model: z.string().optional().default('showUploadModal').describe('Modal open state variable.'),
+        title: z.string().optional().describe('Upload modal title.'),
+        accept: z.string().optional().default('*/*').describe('Accepted mime/extensions.'),
+        multiple: z.boolean().optional().default(true).describe('Allow multiple files.'),
+        maxSizeExpression: z.string().optional().describe('Raw Vue expression for max file size.'),
+        loadingExpression: z.string().optional().describe('Raw Vue expression/ref for upload pending state.'),
+        uploadProgressExpression: z.string().optional().describe('Raw Vue expression/ref for aggregate upload progress.'),
+        fileProgressExpression: z.string().optional().describe('Raw Vue expression for per-row progress map.'),
+        dragText: z.string().optional().describe('Drag/drop text.'),
+        acceptText: z.string().optional().describe('Accept/help text.'),
+        uploadText: z.string().optional().describe('Upload action text.'),
+        uploadingText: z.string().optional().describe('Uploading action text.'),
+        uploadHandler: z.string().optional().default('handleUpload').describe('@upload handler expression.'),
+        errorHandler: z.string().optional().describe('@error handler expression.'),
+        headerContent: z.string().optional().describe('Optional #header-content template, e.g. storage selector. Fields are normalized to w-full.'),
+    }, async (input) => jsonText(buildExtensionUploadModalSnippet(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.',