@sealab/mcp-server 1.0.0

package/src/tools/saved-settings.ts

@@ -0,0 +1,241 @@
+import { z } from 'zod';
+import { client, handleAxiosError } from '../client/api-client';
+
+// ============================================================================
+// Schemas
+// ============================================================================
+
+const SavedSettingSchema = z.object({
+  savedSettingsId: z.number().optional(),
+  name: z.string().describe('Name of the saved setting (e.g., "Modern Euro", "Traditional")'),
+  frontMaterial: z.string().describe('Front material specification'),
+  caseMaterial: z.string().describe('Case material specification'),
+  backPanelMaterial: z.string().describe('Back panel material'),
+  backPanel: z.string().describe('Back panel type'),
+  drawerType: z.string().describe('Drawer type'),
+  jointMethod: z.string().describe('Joint method'),
+  caseEdge: z.string().describe('Case edge treatment'),
+  frontEdge: z.string().describe('Front edge treatment'),
+  numOfShelves: z.string().describe('Number of shelves'),
+  bottomPanelConnector: z.string().describe('Bottom panel connector (e.g., "Leg Levelers")'),
+  topDrwrHeightValue: z.string().describe('Top drawer height value'),
+  hingePlate: z.string().describe('Hinge plate type'),
+  includeLegLevelers: z.string().describe('Include leg levelers flag'),
+  isPreset: z.number().optional().describe('1 = public preset, 0 = user-specific'),
+});
+
+const GetSavedSettingsPresetsSchema = z.object({});
+
+const GetMySavedSettingsSchema = z.object({});
+
+const GetSavedSettingByIdSchema = z.object({
+  id: z.number().describe('Saved setting ID'),
+});
+
+const CreateSavedSettingSchema = SavedSettingSchema.omit({ savedSettingsId: true, isPreset: true }).extend({
+  isPreset: z.boolean().optional().default(false).describe('Set to true to create a public preset (requires admin privileges)'),
+});
+
+const UpdateSavedSettingSchema = SavedSettingSchema.pick({
+  savedSettingsId: true,
+  name: true,
+  frontMaterial: true,
+  caseMaterial: true,
+  backPanelMaterial: true,
+  backPanel: true,
+  drawerType: true,
+  jointMethod: true,
+  caseEdge: true,
+  frontEdge: true,
+  numOfShelves: true,
+  bottomPanelConnector: true,
+  topDrwrHeightValue: true,
+  hingePlate: true,
+  includeLegLevelers: true,
+});
+
+const DeleteSavedSettingSchema = z.object({
+  id: z.number().describe('Saved setting ID to delete'),
+});
+
+// ============================================================================
+// Handlers
+// ============================================================================
+
+export async function getSavedSettingsPresets(): Promise<string> {
+  try {
+    const { data } = await client.get('/saved-settings/presets');
+    if (!data || data.length === 0) return 'No preset saved settings found.';
+    return JSON.stringify(data, null, 2);
+  } catch (error) {
+    try { handleAxiosError(error); } catch (e: any) { return e.message; }
+    return 'Unexpected error fetching preset saved settings.';
+  }
+}
+
+export async function getMySavedSettings(): Promise<string> {
+  try {
+    const { data } = await client.get('/saved-settings/user');
+    if (!data || data.length === 0) return 'No saved settings found for your account.';
+    return JSON.stringify(data, null, 2);
+  } catch (error) {
+    try { handleAxiosError(error); } catch (e: any) { return e.message; }
+    return 'Unexpected error fetching your saved settings.';
+  }
+}
+
+export async function getSavedSettingById(input: z.infer<typeof GetSavedSettingByIdSchema>): Promise<string> {
+  try {
+    const { data } = await client.get(`/saved-settings/${input.id}`);
+    return JSON.stringify(data, null, 2);
+  } catch (error) {
+    try { handleAxiosError(error); } catch (e: any) { return e.message; }
+    return 'Unexpected error fetching saved setting.';
+  }
+}
+
+export async function createSavedSetting(input: z.infer<typeof CreateSavedSettingSchema>): Promise<string> {
+  try {
+    const { data } = await client.post('/saved-settings/user', input);
+    return `Saved setting created successfully. ID: ${data.savedSettingsId}`;
+  } catch (error) {
+    try { handleAxiosError(error); } catch (e: any) { return e.message; }
+    return 'Unexpected error creating saved setting.';
+  }
+}
+
+export async function updateSavedSetting(input: z.infer<typeof UpdateSavedSettingSchema>): Promise<string> {
+  try {
+    const { data } = await client.put(`/saved-settings/${input.savedSettingsId}`, input);
+    return `Saved setting updated successfully. ID: ${data.savedSettingsId}`;
+  } catch (error) {
+    try { handleAxiosError(error); } catch (e: any) { return e.message; }
+    return 'Unexpected error updating saved setting.';
+  }
+}
+
+export async function deleteSavedSetting(input: z.infer<typeof DeleteSavedSettingSchema>): Promise<string> {
+  try {
+    await client.delete(`/saved-settings/${input.id}`);
+    return `Saved setting ${input.id} deleted successfully.`;
+  } catch (error) {
+    try { handleAxiosError(error); } catch (e: any) { return e.message; }
+    return 'Unexpected error deleting saved setting.';
+  }
+}
+
+// ============================================================================
+// Tool definitions
+// ============================================================================
+
+export const savedSettingsTools = [
+  {
+    name: 'get_saved_settings_presets',
+    description: `Get all public preset saved settings. These are shared templates available to all users.
+
+Use this tool when:
+- User wants to see available preset templates
+- User is looking for standard configurations (e.g., "Modern Euro", "Traditional")
+- User wants to apply a preset to their current configuration
+
+IMPORTANT: When you use values from a saved setting to configure an article (via create_saved_cart, create_order, or add_articles_to_cart),
+you MUST also set the "settingsName" field INSIDE each article object to the exact name of the saved setting (e.g., "Modern Euro", "Zach's Kitchen").
+CRITICAL: settingsName is an ARTICLE-LEVEL field only. NEVER pass it at the order level — it will cause a validation error.
+
+Returns: Array of preset saved settings with all configuration fields.`,
+    inputSchema: GetSavedSettingsPresetsSchema,
+    handler: getSavedSettingsPresets,
+  },
+  {
+    name: 'get_my_saved_settings',
+    description: `Get all saved settings for the currently authenticated user.
+
+This includes:
+- User's personal saved settings (created by the user)
+- Public presets (available to all users)
+
+Use this tool when:
+- User wants to see their saved configurations
+- User wants to load a previously saved setting
+- User is managing their saved settings
+
+IMPORTANT: When you use values from a saved setting to configure an article (via create_saved_cart, create_order, or add_articles_to_cart),
+you MUST also set the "settingsName" field INSIDE each article object to the exact name of the saved setting (e.g., "Modern Euro", "Zach's Kitchen").
+CRITICAL: settingsName is an ARTICLE-LEVEL field only. NEVER pass it at the order level — it will cause a validation error.
+
+Returns: Array of saved settings (both personal and presets).`,
+    inputSchema: GetMySavedSettingsSchema,
+    handler: getMySavedSettings,
+  },
+  {
+    name: 'get_saved_setting_by_id',
+    description: `Get a specific saved setting by its ID.
+
+Authorization:
+- Presets (isPreset=1): Available to all authenticated users
+- User settings: Only available to the owner
+
+Use this tool when:
+- User wants to view details of a specific saved setting
+- You have a saved setting ID from a previous operation
+
+Returns: Single saved setting object.`,
+    inputSchema: GetSavedSettingByIdSchema,
+    handler: getSavedSettingById,
+  },
+  {
+    name: 'create_saved_setting',
+    description: `Create a new saved setting for the current user.
+
+Use this tool when:
+- User wants to save their current configuration for later use
+- User has configured materials, edges, and options and wants to reuse them
+- User says "save these settings" or "save this as a preset"
+
+Required fields:
+- name: A descriptive name for the setting (e.g., "My Modern Kitchen")
+- frontMaterial: Front material specification
+- caseMaterial: Case material specification
+- Other fields as needed
+
+Note: User-created settings are private by default (isPreset=0).`,
+    inputSchema: CreateSavedSettingSchema,
+    handler: createSavedSetting,
+  },
+  {
+    name: 'update_saved_setting',
+    description: `Update an existing saved setting.
+
+Authorization:
+- Can only update user's own settings (not presets)
+- savedSettingsId is required to identify which setting to update
+
+Use this tool when:
+- User wants to modify a previously saved setting
+- User wants to update material choices or configuration
+- User says "update my saved setting" or "change the settings I saved"
+
+Required fields:
+- savedSettingsId: ID of the setting to update
+- At least one field to update`,
+    inputSchema: UpdateSavedSettingSchema,
+    handler: updateSavedSetting,
+  },
+  {
+    name: 'delete_saved_setting',
+    description: `Delete a saved setting.
+
+Authorization:
+- Can only delete user's own settings (not presets)
+- User must be the owner of the setting
+
+Use this tool when:
+- User wants to remove a saved setting
+- User says "delete my saved setting" or "remove this configuration"
+
+Required fields:
+- id: ID of the setting to delete`,
+    inputSchema: DeleteSavedSettingSchema,
+    handler: deleteSavedSetting,
+  },
+];

package/tsconfig.json

@@ -0,0 +1,15 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "commonjs",
+    "lib": ["ES2022"],
+    "outDir": "dist",
+    "rootDir": "src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "resolveJsonModule": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist", "**/*.test.ts"]
+}