@sealab/mcp-server 1.0.0

package/dist/tools/configuration-info.js

@@ -0,0 +1,299 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.configurationInfoTools = void 0;
+exports.getArticleContext = getArticleContext;
+exports.getArticleOptions = getArticleOptions;
+exports.getConfigurationInfo = getConfigurationInfo;
+const zod_1 = require("zod");
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const api_client_1 = require("../client/api-client");
+// All fields with a corresponding .txt file in resources/tooltips/
+const VALID_FIELDS = [
+    'backPanel',
+    'backPanelMaterial',
+    'caseEdge',
+    'caseMaterial',
+    'depth',
+    'drawerType',
+    'edgeBandingType',
+    'excludeFronts',
+    'frontEdge',
+    'frontMaterial',
+    'gapBottom',
+    'gapCenter',
+    'gapLeft',
+    'gapRight',
+    'gapTop',
+    'height',
+    'hingePlate',
+    'includeLegLevelers',
+    'jointMethod',
+    'leftCornerWidth',
+    'numOfShelves',
+    'positionName',
+    'rightCornerDepth',
+    'topDrwrHeight',
+    'width',
+];
+const SerialNumberSchema = zod_1.z.object({
+    serialNumber: zod_1.z.string().describe('Article serial number'),
+});
+const GetArticleContextSchema = SerialNumberSchema;
+const GetArticleOptionsSchema = SerialNumberSchema;
+const GetConfigInfoSchema = zod_1.z.object({
+    field: zod_1.z.enum(VALID_FIELDS).describe('The configuration field name to get full detail for'),
+});
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/** Strip HTML tags and collapse whitespace for clean plain-text output */
+function stripHtml(html) {
+    return html
+        .replace(/<[^>]*>/g, ' ')
+        .replace(/&nbsp;/g, ' ')
+        .replace(/&amp;/g, '&')
+        .replace(/&lt;/g, '<')
+        .replace(/&gt;/g, '>')
+        .replace(/&quot;/g, '"')
+        .replace(/\s+/g, ' ')
+        .trim();
+}
+/** Read a tooltip file, returns null if missing */
+function readTooltip(field) {
+    const filePath = path.join(__dirname, '..', '..', 'resources', 'tooltips', `${field}.txt`);
+    try {
+        return stripHtml(fs.readFileSync(filePath, 'utf-8'));
+    }
+    catch {
+        return null;
+    }
+}
+/** Derive the list of applicable config fields from the configuration response */
+function getApplicableFields(config) {
+    const fields = ['positionName', 'height', 'width', 'depth'];
+    if (config.hasCase === true)
+        fields.push('caseMaterial');
+    if (config.hasMatCaseThin === true)
+        fields.push('caseMaterial'); // inner — same file
+    if (config.hasFront === true)
+        fields.push('frontMaterial');
+    if (config.hasCase === true && config.hasFront === true)
+        fields.push('excludeFronts');
+    if (config.matBack === true)
+        fields.push('backPanelMaterial', 'backPanel');
+    if (config.caseEdge === true)
+        fields.push('caseEdge');
+    if (config.frontEdge === true)
+        fields.push('frontEdge');
+    if (config.doors === true)
+        fields.push('hingePlate');
+    if (config.drawers === true)
+        fields.push('drawerType');
+    if (config.topDrwrHeight === true)
+        fields.push('topDrwrHeight');
+    if (config.adjShelves === true)
+        fields.push('numOfShelves');
+    if (config.gapControl === true)
+        fields.push('gapTop', 'gapBottom', 'gapLeft', 'gapRight', 'gapCenter');
+    if (config.jointControl === true)
+        fields.push('jointMethod');
+    if (config.cornerVariables === true)
+        fields.push('leftCornerWidth', 'rightCornerDepth');
+    // LP_SP / LP_GP series use edgeBandingType instead of standard edge fields
+    const sn = config.serialNumber ?? '';
+    if (sn.startsWith('LP_SP') || sn.startsWith('LP_GP'))
+        fields.push('edgeBandingType');
+    // Leg levelers: filterTags-based (dimension check happens at order time)
+    const tags = config.filterTags ?? '';
+    if (tags.includes('Leg_Levelers'))
+        fields.push('includeLegLevelers');
+    // Deduplicate while preserving order
+    return [...new Set(fields)];
+}
+// ---------------------------------------------------------------------------
+// Tool: get_article_context
+// ---------------------------------------------------------------------------
+async function getArticleContext(input) {
+    try {
+        const { data: config } = await api_client_1.client.get(`/catalog/${input.serialNumber}/configuration`);
+        const applicable = getApplicableFields(config);
+        const lines = [];
+        lines.push(`=== CONFIGURATION CONTEXT: ${input.serialNumber} ===`);
+        lines.push('');
+        lines.push('DIMENSION RANGES:');
+        lines.push(`  height: ${config.heightRange ?? 'fixed'}`);
+        lines.push(`  width:  ${config.widthRange ?? 'fixed'}`);
+        lines.push(`  depth:  ${config.depthRange ?? 'fixed'}`);
+        lines.push('');
+        lines.push(`APPLICABLE CONFIG OPTIONS (${applicable.length - 3} fields beyond dimensions):`);
+        lines.push('');
+        for (const field of applicable) {
+            const content = readTooltip(field);
+            if (content) {
+                lines.push(`[${field}]`);
+                lines.push(content);
+                lines.push('');
+            }
+        }
+        lines.push('---');
+        lines.push('INSTRUCTIONS:');
+        lines.push('1. Present a brief summary of each applicable option to the user.');
+        lines.push('2. For every option that applies to this article, ASK the user what they want — do NOT auto-select, guess, or assume any value.');
+        lines.push('3. Only move to create_order once the user has explicitly confirmed a value for every applicable field.');
+        lines.push('4. If the user provides a drawing or spec that does not specify a value (e.g. no material called out), treat it as missing and ask.');
+        lines.push('5. Only call get_configuration_info if the user asks for more detail on a specific field.');
+        return lines.join('\n');
+    }
+    catch (error) {
+        try {
+            (0, api_client_1.handleAxiosError)(error);
+        }
+        catch (e) {
+            return e.message;
+        }
+        return 'Unexpected error loading article context.';
+    }
+}
+// ---------------------------------------------------------------------------
+// Tool: get_article_options
+// ---------------------------------------------------------------------------
+async function getArticleOptions(input) {
+    try {
+        const { data } = await api_client_1.client.get(`/catalog/${input.serialNumber}/options`);
+        if (!data || Object.keys(data).length === 0) {
+            return 'No selectable options found for this article.';
+        }
+        const lines = [];
+        lines.push(`=== SELECTABLE OPTIONS: ${input.serialNumber} ===`);
+        lines.push('');
+        lines.push('Use these exact strings when setting field values in create_order.');
+        lines.push('');
+        if (data.materials) {
+            lines.push('MATERIALS (caseMaterial / frontMaterial / backPanelMaterial / innerCaseMaterial):');
+            data.materials.forEach((m) => lines.push(`  - ${m}`));
+            lines.push('');
+        }
+        if (data.edgebanding) {
+            lines.push('EDGEBANDING (caseEdge / frontEdge):');
+            data.edgebanding.forEach((e) => lines.push(`  - ${e}`));
+            lines.push('');
+        }
+        if (data.jointMethod) {
+            lines.push('JOINT METHOD (jointMethod):');
+            data.jointMethod.forEach((v) => lines.push(`  - ${v}`));
+            lines.push('');
+        }
+        if (data.drawerType) {
+            lines.push('DRAWER TYPE (drawerType):');
+            data.drawerType.forEach((v) => lines.push(`  - ${v}`));
+            lines.push('');
+        }
+        if (data.hingePlate) {
+            lines.push('HINGE PLATE (hingePlate):');
+            data.hingePlate.forEach((v) => lines.push(`  - ${v}`));
+            lines.push('');
+        }
+        if (data.backPanel) {
+            lines.push('BACK PANEL METHOD (backPanel):');
+            data.backPanel.forEach((v) => lines.push(`  - ${v}`));
+            lines.push('');
+        }
+        if (data.numOfShelves) {
+            lines.push('NUMBER OF ADJUSTABLE SHELVES (numOfShelves):');
+            lines.push(`  - ${data.numOfShelves.join(', ')}`);
+            lines.push('');
+        }
+        return lines.join('\n');
+    }
+    catch (error) {
+        try {
+            (0, api_client_1.handleAxiosError)(error);
+        }
+        catch (e) {
+            return e.message;
+        }
+        return 'Unexpected error loading article options.';
+    }
+}
+// ---------------------------------------------------------------------------
+// Tool: get_configuration_info (single-field deep dive)
+// ---------------------------------------------------------------------------
+async function getConfigurationInfo(input) {
+    const content = readTooltip(input.field);
+    return content ?? `No information available for field: ${input.field}`;
+}
+// ---------------------------------------------------------------------------
+// Exports
+// ---------------------------------------------------------------------------
+exports.configurationInfoTools = [
+    {
+        name: 'get_article_options',
+        description: `Fetch the valid selectable values for all applicable configuration fields for a cabinet article. Returns the exact strings to use when setting caseMaterial, frontMaterial, backPanelMaterial, innerCaseMaterial, caseEdge, frontEdge, jointMethod, drawerType, hingePlate, backPanel, and numOfShelves in create_order.
+
+Call this immediately after get_article_context when a user selects an article. Only fields applicable to the article are returned (e.g. if the article has no doors, hingePlate options are not included).
+
+The values returned are the exact strings the order system expects — do not use variations or paraphrased values.
+
+CRITICAL RULE: Present these options to the user and ask them to choose. Do NOT pick a value on the user's behalf. If the user's source document (drawing, spec sheet, etc.) does not explicitly call out a value for a field, it is missing — ask the user before proceeding.`,
+        inputSchema: GetArticleOptionsSchema,
+        handler: getArticleOptions,
+    },
+    {
+        name: 'get_article_context',
+        description: `Load all configuration context for a cabinet article in a single call. Call this immediately when a user selects or expresses interest in an article — before asking them any configuration questions.
+
+It returns:
+- Dimension ranges (valid height/width/depth for this article)
+- All applicable configuration options with full guidance (only fields that apply to this specific article based on its feature flags)
+
+After calling this, immediately call get_article_options to load the valid selectable values for all applicable fields. Then present the user with a brief summary of all applicable options and their choices.
+
+CRITICAL RULE: After presenting the options, you MUST ask the user to specify each value explicitly. Do NOT auto-select, guess, or default any configuration field — not material, not edgebanding, not joint method, not drawer type, nothing. If the user provides a drawing or document that does not call out a value, that value is missing and must be asked for. Only proceed to create_order once the user has confirmed every applicable field.
+
+Do NOT call get_configuration_info in a loop — this tool already loads the guidance text at once.`,
+        inputSchema: GetArticleContextSchema,
+        handler: getArticleContext,
+    },
+    {
+        name: 'get_configuration_info',
+        description: `Get full detail for a single configuration field. Use this only when the user explicitly asks for more information about a specific option — not as part of the initial article selection flow (use get_article_context for that instead).
+
+Available fields: ${VALID_FIELDS.join(', ')}`,
+        inputSchema: GetConfigInfoSchema,
+        handler: getConfigurationInfo,
+    },
+];

package/dist/tools/configuration.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.configurationTools = void 0;
+exports.getArticleConfiguration = getArticleConfiguration;
+const zod_1 = require("zod");
+const api_client_1 = require("../client/api-client");
+const GetConfigSchema = zod_1.z.object({
+    serialNumber: zod_1.z.string().describe('Article serial number'),
+});
+async function getArticleConfiguration(input) {
+    try {
+        const { data } = await api_client_1.client.get(`/catalog/${input.serialNumber}/configuration`);
+        return JSON.stringify(data, null, 2);
+    }
+    catch (error) {
+        try {
+            (0, api_client_1.handleAxiosError)(error);
+        }
+        catch (e) {
+            return e.message;
+        }
+        return 'Unexpected error fetching configuration.';
+    }
+}
+exports.configurationTools = [
+    {
+        name: 'get_article_configuration',
+        description: 'Get the raw feature flags and dimension ranges for a cabinet article. For guided user-facing configuration, use get_article_context instead — it loads all applicable options and guidance in one call. Use this tool only when you need the raw boolean flags without the guidance text.',
+        inputSchema: GetConfigSchema,
+        handler: getArticleConfiguration,
+    },
+];