@enfyra/mcp-server 0.0.5 → 0.0.7

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@enfyra/mcp-server",
-  "version": "0.0.5",
+  "version": "0.0.7",
   "description": "MCP server for Enfyra - manage your Enfyra instance via Claude Code",
   "type": "module",
   "license": "MIT",

package/src/lib/mcp-instructions.js

@@ -96,14 +96,72 @@ export function buildMcpServerInstructions(apiBaseUrl) {
     '### Extension (Vue SFC only — NOT React)',
     '- **CRITICAL:** MUST call `create_record` or `update_record` on `extension_definition` — outputting Vue code in chat does NOT save it. User will NOT see it.',
     '- **Code format:** Vue SFC only. Structure: `<template>...</template>` + `<script setup>...</script>`. Server auto-compiles; if compile fails, fix and retry.',
-    '- **NO import statements.** All Vue API and composables are injected globally: `ref`, `reactive`, `computed`, `watch`, `onMounted`; `useToast`, `useApi`, `useEnfyraAuth`, `useRouter`, `useRoute`, `navigateTo`; components `UButton`, `UCard`, `UInput`, `UTable`, `UBadge`, `DataTable`, `FormEditor`, `EmptyState`, `Widget`, etc.',
-    '- **useApi:** Does NOT auto-run. Must call `execute()` — e.g. `const { data, execute } = useApi(\'/user_definition\', { query: { limit: 10 } }); onMounted(() => execute());`',
-    '- **useHeaderActionRegistry:** Pass array directly: `useHeaderActionRegistry([{ id: \'refresh\', label: \'Refresh\', onClick: fn, color: \'primary\' }]);`',
-    '- **type "page":** Requires `menu: { id }` — create menu first (`create_menu` or `create_record` on `menu_definition`), find by path/label, then create extension with `menu: { id: menuId }`. `menu_definition` uses **label** not name — filter by `label` or `path`.',
-    '- **type "widget":** No menu. Embed via `<Widget :id="extensionId" />`.',
-    '- **NPM packages:** Before using (e.g. dayjs, chart.js) — check `package_definition` (filter `type: App`, `name`, `isEnabled`). If not found, tell user to install via Settings → Packages. Use `getPackages([\'dayjs\'])` in code; call in `onMounted` or async handler.',
+    '- **NO import statements.** All APIs are injected globally (see full list below).',
+    '',
+    '#### Injected Vue API functions:',
+    '- Reactivity: `ref`, `reactive`, `computed`, `readonly`, `shallowRef`, `shallowReactive`',
+    '- Lifecycle: `onMounted`, `onUnmounted`, `onBeforeMount`, `onBeforeUnmount`, `onUpdated`, `onBeforeUpdate`',
+    '- Watch: `watch`, `watchEffect`',
+    '- Component: `defineProps`, `defineEmits`, `defineExpose`, `resolveComponent`, `h`, `defineComponent`',
+    '- Utils: `nextTick`, `toRef`, `toRefs`, `unref`, `isRef`, `isProxy`, `isReactive`, `isReadonly`, `toRaw`, `markRaw`, `effectScope`, `getCurrentScope`, `onScopeDispose`',
+    '',
+    '#### Injected Nuxt composables:',
+    '- Router: `useRoute`, `useRouter`, `navigateTo`',
+    '- State: `useState`, `useCookie`, `useNuxtApp`, `useRuntimeConfig`',
+    '- Data: `useFetch`, `useAsyncData`, `useLazyFetch`',
+    '- SEO: `useHead`, `useSeoMeta`',
+    '- UI: `useToast`',
+    '',
+    '#### Injected Enfyra composables:',
+    '- **useApi:** API client with auto error handling & toast. Returns `{ data, error, pending, status, execute, refresh }`. Does NOT auto-run — must call `execute()`. Example: `const { data, execute } = useApi(\'/user_definition\', { query: { limit: 10 } }); onMounted(() => execute());`',
+    '- **useAuth:** Authentication. Returns `{ me, login, logout, fetchUser, isLoggedIn, isLoading, oauthLogin }`. `me` is reactive user object with `isRootAdmin`, `role`, `allowedRoutePermissions`.',
+    '- **usePermissions:** Permission checks. Returns `{ hasPermission(route, method), hasAnyPermission(routes, actions), hasAllPermissions(routes, actions), checkPermissionCondition(condition) }`. Actions: `read`, `create`, `update`, `delete`.',
+    '- **useSchema:** Schema management. Returns `{ schemas, schema, fetchSchema, schemaLoading, definition, fieldMap, getField(key), editableFields, generateEmptyForm(), validate(record), getIncludeFields(), useFormChanges() }`.',
+    '- **useGlobalState:** Global app state. Returns `{ settings, storageConfigs, aiConfigs, appPackages, sidebarVisible, sidebarCollapsed, routeLoading, toggleSidebar(), setRouteLoading(), fetchAppPackages(), packageCacheState }`.',
+    '- **useScreen:** Responsive helpers. Returns `{ width, height, isMobile, isTablet, isDesktop, isLargeDesktop, screenType }`.',
+    '- **useConfirm:** Confirmation dialogs. Returns `{ confirm({ title, content, confirmText, cancelText }), isVisible, options, onConfirm, onCancel }`.',
+    '- **useHeaderActionRegistry:** Register header actions. Pass array: `useHeaderActionRegistry([{ id, label, onClick, color, icon, order, side, global }])`. Action has `{ id, label, onClick, color, icon, order, side: \'left\'|\'right\', global, component }`.',
+    '- **useSubHeaderActionRegistry:** Same as header but for sub-header.',
+    '- **useMenuRegistry:** Menu management. Returns `{ menuItems, menuGroups, registerMenuItem, unregisterMenuItem, getMenuItemsBySidebar, findParentMenuIdByPath }`.',
+    '- **useMenuApi:** Low-level menu API.',
+    '- **useFilterQuery:** Filter builder. Returns `{ buildQuery(filter), buildFilterObject(filter), createEmptyFilter(), hasActiveFilters(filter), getFilterSummary(filter, fields), encodeFilterToUrl(filter), parseFilterFromUrl(searchParams) }`.',
+    '- **useDatabase:** Database helpers (returns `{ getId, getIdFieldName }`).',
+    '- **useRoutes:** Route management.',
+    '- **useHighlight:** Code highlighting.',
+    '- **useMounted:** Mount state helper.',
+    '',
+    '#### Injected UI Components (auto-resolved):',
+    '- **Common:** `EmptyState`, `LoadingState`, `ErrorState`, `PageHeader`, `FormCard`, `Modal`, `Drawer`, `BreadCrumbs`, `ListItem`, `LazyImage`, `GlobalConfirm`, `UploadModal`, `UploadModalLazy`, `AvatarInitials`, `BrandingHeader`, `SettingsCard`, `RouteLoading`',
+    '- **Data Table:** `DataTable`, `DataTableLazy`, `ColumnSelector`',
+    '- **Form:** `FormEditor`, `FilterEditor`, `FilterHistory`, `FieldSelector`',
+    '- **File Manager:** `FileManager`, `FileView`, `FileGridCard`, `CreateFolderModal`',
+    '- **Menu:** `MenuRenderer`, `MenuItemEditor`',
+    '- **UI:** `UButton`, `UCard`, `UInput`, `UTable`, `UBadge` (if available)',
+    '- **Extension:** `Widget` — embed widget extension via `<Widget :id="extensionId" />`',
+    '- **WebSocket:** `WebSocketManager`',
+    '- **Permission:** `PermissionGate`, `PermissionManager`',
+    '',
+    '#### Global objects:',
+    '- `fetch`, `console`, `window`, `document`',
+    '- `$ctx` — runtime context',
+    '',
+    '#### Extension types:',
+    '- **type "page":** Full-page extension. Requires `menu: { id }` — create menu first (`create_menu` or `create_record` on `menu_definition`), find by path/label, then create extension with `menu: { id: menuId }`. `menu_definition` uses **label** not name — filter by `label` or `path`.',
+    '- **type "widget":** Widget extension. No menu required. Embed via `<Widget :id="extensionId" />` in other extensions or pages.',
+    '',
+    '#### NPM packages:',
+    '- Before using (e.g. dayjs, chart.js) — check `package_definition` (filter `type: App`, `name`, `isEnabled`). If not found, tell user to install via Settings → Packages.',
+    '- Use `getPackages([\'dayjs\'])` in code; call in `onMounted` or async handler.',
+    '',
+    '#### Important patterns:',
+    '- **useApi:** Must call `execute()` — does NOT auto-run. Supports batch operations with `ids` or `files` options.',
+    '- **Header actions:** `useHeaderActionRegistry([{ id: \'refresh\', label: \'Refresh\', onClick: fn, color: \'primary\', icon: \'lucide:refresh\', order: 0 }])`',
+    '- **Schema:** Call `fetchSchema()` first, then use `definition.value`, `editableFields.value`, `getField(\'fieldName\')`.',
+    '- **Permissions:** Use `checkPermissionCondition({ or: [{ route: \'/posts\', actions: [\'read\'] }] })` for complex rules.',
     '- **After create/update:** Tell user to refresh (F5). Changes may not appear until reload.',
-    '- **Minimal example:** `<template><div class="p-6"><h1 class="text-2xl font-bold">{{ title }}</h1><UButton @click="handleClick">Click</UButton></div></template><script setup>const title = ref(\'My Extension\'); const toast = useToast(); const handleClick = () => toast.add({ title: \'Clicked\', color: \'green\' });</script>`',
+    '',
+    '#### Minimal example:',
+    '`<template><div class="p-6"><h1 class="text-2xl font-bold">{{ title }}</h1><UButton @click="handleClick">Click</UButton></div></template><script setup>const title = ref(\'My Extension\'); const toast = useToast(); const handleClick = () => toast.add({ title: \'Clicked\', color: \'green\' });</script>`',
     '',
     '### MCP tool → HTTP',
     `- \`get_all_metadata\` → GET \`${base}/metadata\``,

package/src/lib/table-tools.js

@@ -2,7 +2,7 @@
  * Table & Column tools for Enfyra MCP Server
  */
 import { z } from 'zod';
-import { fetchAPI, validateTableName } from './fetch.js';
+import { fetchAPI } from './fetch.js';
 
 /**
  * Register table tools with MCP server
@@ -24,7 +24,8 @@ export function registerTableTools(server, ENFYRA_API_URL) {
   server.tool(
     'create_table',
     [
-      'Create a new table definition. After creating a table, use create_column to add columns.',
+      'Create a new table definition with an auto-included `id` primary key column.',
+      'Use create_column to add more columns after creation.',
       'Schema operations (create/update/delete table, add column) must run one at a time — migration locks DB; parallel calls will fail.',
       'Enfyra auto-creates a REST route at path `/<table_name>` (same segment as `name`, not alias).',
       'REST surface for that route (matches server route engine): 4 HTTP operations — GET `/<table>` (list/filter), POST `/<table>` (create), PATCH `/<table>/:id` (update), DELETE `/<table>/:id` (delete).',
@@ -39,9 +40,10 @@ export function registerTableTools(server, ENFYRA_API_URL) {
       isEnabled: z.boolean().optional().default(true).describe('Enable table. Set to false to disable.'),
     },
     async ({ name, alias, description, isEnabled }) => {
+      const idColumn = { name: 'id', type: 'int', isPrimary: true, isGenerated: true, isNullable: false };
       const result = await fetchAPI(ENFYRA_API_URL, '/table_definition', {
         method: 'POST',
-        body: JSON.stringify({ name, alias, description, isEnabled }),
+        body: JSON.stringify({ name, alias, description, isEnabled, columns: [idColumn] }),
       });
       const base = ENFYRA_API_URL.replace(/\/$/, '');
       const routePath = `/${name}`;
@@ -55,6 +57,34 @@ export function registerTableTools(server, ENFYRA_API_URL) {
     }
   );
 
+  server.tool(
+    'create_relation',
+    [
+      'Create a relation between two tables (many-to-one, one-to-many, one-to-one, many-to-many).',
+      'For many-to-one: a FK column is created on the source table. For one-to-many: the FK is on the target (inverse relation).',
+      'Run sequentially — DB migration locks per operation.',
+    ].join(' '),
+    {
+      sourceTableId: z.string().describe('Source table ID (the table that owns the FK for many-to-one).'),
+      targetTableId: z.string().describe('Target table ID.'),
+      type: z.enum(['many-to-one', 'one-to-many', 'one-to-one', 'many-to-many']).describe('Relation type.'),
+      propertyName: z.string().describe('Property name on source table (e.g., "customer", "items").'),
+      inversePropertyName: z.string().optional().describe('Property name on target table for bidirectional relation (e.g., "orders").'),
+      isNullable: z.boolean().optional().default(true).describe('Whether the relation is nullable.'),
+      onDelete: z.enum(['CASCADE', 'SET NULL', 'RESTRICT', 'NO ACTION']).optional().default('SET NULL').describe('On delete behavior.'),
+    },
+    async ({ sourceTableId, targetTableId, type, propertyName, inversePropertyName, isNullable, onDelete }) => {
+      const relation = { type, propertyName, inversePropertyName: inversePropertyName || null, isNullable, onDelete };
+      const result = await fetchAPI(ENFYRA_API_URL, `/table_definition/${sourceTableId}`, {
+        method: 'PATCH',
+        body: JSON.stringify({ relations: [{ targetTableId, ...relation }] }),
+      });
+      return {
+        content: [{ type: 'text', text: `Relation created: ${propertyName} (${type}) from table ${sourceTableId} → ${targetTableId}.\n\nFull result:\n${JSON.stringify(result, null, 2)}` }],
+      };
+    }
+  );
+
   server.tool(
     'create_column',
     'Create a column for an existing table. Columns cascade through table_definition. Run schema changes sequentially — migration locks DB per operation.',