@assetlab/mcp-server 1.26.0 → 1.27.0

package/dist/tools-write.js

@@ -20,6 +20,17 @@ function buildBody(params) {
     return body;
 }
 const PM_RESOURCE_TYPES = ['TOOL', 'PART', 'MATERIAL', 'EQUIPMENT'];
+const FORM_TEMPLATE_CATEGORIES = ['task_checklist', 'inspection', 'compliance', 'survey'];
+const FORM_TEMPLATE_STATUSES = ['draft', 'published', 'archived'];
+const FORM_ITEM_TYPES = [
+    'section',
+    'checkbox',
+    'single_select',
+    'multi_select',
+    'number',
+    'text',
+    'photo',
+];
 function randomTaskId() {
     const g = globalThis;
     return g.crypto?.randomUUID?.() ?? `task_${Math.random().toString(36).slice(2, 12)}`;
@@ -1137,6 +1148,144 @@ export function registerWriteTools(server, client) {
         }
     });
     // ============================================================
+    // 8c. Forms & Inspections (scope: form_templates, form_template_items)
+    // ============================================================
+    server.tool('create_form_template', 'Create a form template — a reusable inspection, checklist, compliance, or survey definition. Step 1 of building a form: create it as a draft, then add questions with create_form_template_item (or bulk_create on form-template-items), then publish with update_form_template status=published (publishing is rejected if any question is malformed). Requires form_templates:write scope.', {
+        name: z.string().min(1).max(500).describe('Form template name (required)'),
+        description: z.string().max(5000).optional().describe('Description'),
+        category: z
+            .enum(FORM_TEMPLATE_CATEGORIES)
+            .optional()
+            .describe('Form category: inspection (default), task_checklist, compliance, or survey. Manufacturer-recommended equipment checks → inspection.'),
+        status: z
+            .enum(FORM_TEMPLATE_STATUSES)
+            .optional()
+            .describe('Publication status — leave as draft (default) until all questions are added.'),
+    }, async (params) => {
+        try {
+            const result = await client.create('form-templates', buildBody(params));
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    server.tool('update_form_template', 'Update an existing form template by ID. Requires form_templates:write scope.', {
+        id: z.string().uuid().describe('Form template ID'),
+        name: z.string().min(1).max(500).optional().describe('Form template name'),
+        description: z.string().max(5000).optional().describe('Description'),
+        category: z
+            .enum(FORM_TEMPLATE_CATEGORIES)
+            .optional()
+            .describe('Form category (task_checklist, inspection, compliance, or survey)'),
+        status: z
+            .enum(FORM_TEMPLATE_STATUSES)
+            .optional()
+            .describe('Publication status (draft, published, or archived)'),
+    }, async ({ id, ...rest }) => {
+        try {
+            const result = await client.update('form-templates', id, buildBody(rest));
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    server.tool('delete_form_template', 'Delete a form template by ID. Requires form_templates:write scope.', { id: z.string().uuid().describe('Form template ID') }, async ({ id }) => {
+        try {
+            const result = await client.remove('form-templates', id);
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    server.tool('create_form_template_item', 'Add one question (item) to a form template. Build a form by calling this once per question in order, or use bulk_create on form-template-items. Requires form_template_items:write scope.', {
+        template_id: z.string().uuid().describe('Form template ID — resolve via list_form_templates'),
+        item_key: z
+            .string()
+            .min(1)
+            .max(200)
+            .optional()
+            .describe('Optional stable key, unique within the template. OMIT IT and the server derives one from the label (recommended). Only set it when a later item’s visible_when must reference this one — then use a short slug like "compressor_status".'),
+        sort_order: z
+            .number()
+            .int()
+            .min(0)
+            .describe('Display order within the template (0-based; questions render in this order)'),
+        item_type: z
+            .enum(FORM_ITEM_TYPES)
+            .describe('Pick by the answer you want: single_select = exactly one choice (Pass/Fail, Yes/No, Yes/No/N-A, or custom — supply options); multi_select = pick several (supply options); number = a numeric reading/count (use config.min/max/unit/integer); checkbox = a single done/not-done tick; text = free comment (config.multiline for long text); photo = photo evidence (config.maxPhotos); section = a non-answerable heading that groups the questions under it.'),
+        label: z.string().min(1).max(2000).describe('Question text / prompt shown to the user'),
+        help_text: z.string().max(5000).optional().describe('Optional hint shown under the label'),
+        required: z
+            .boolean()
+            .optional()
+            .describe('Whether an answer is required to complete the form (default false)'),
+        options: z
+            .array(z.object({ value: z.string(), label: z.string() }))
+            .optional()
+            .describe('REQUIRED for single_select/multi_select: at least 2 choices as { value, label } with unique values. value is a machine slug (e.g. "fail"), label is shown to the user (e.g. "Fail"). Omit for other types.'),
+        config: z
+            .record(z.unknown())
+            .optional()
+            .describe('Per-type settings. number: { min, max, unit, integer, decimals }. text: { multiline, maxLength, placeholder }. multi_select: { minSelections, maxSelections }. photo: { minPhotos, maxPhotos }.'),
+        visible_when: z
+            .object({ itemKey: z.string(), op: z.string(), value: z.unknown().optional() })
+            .nullable()
+            .optional()
+            .describe('Optional conditional visibility { itemKey, op, value }. itemKey must reference an EARLIER item’s key (set that item’s item_key explicitly). Operators by referenced type — single_select/checkbox: equals, not_equals, in, not_in, is_answered, is_blank; number: gt, lt, gte, lte, equals, not_equals, is_answered, is_blank; text: is_answered, is_blank, equals, not_equals; multi_select: in, not_in, is_answered, is_blank. e.g. show a "Details" text item only when item "compressor_status" equals "fail".'),
+    }, async (params) => {
+        try {
+            const result = await client.create('form-template-items', buildBody(params));
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    server.tool('update_form_template_item', 'Update an existing form template item by ID. template_id and item_key are immutable and cannot be changed. Requires form_template_items:write scope.', {
+        id: z.string().uuid().describe('Form template item ID'),
+        sort_order: z.number().int().min(0).optional().describe('Display order within the template'),
+        item_type: z
+            .enum(FORM_ITEM_TYPES)
+            .optional()
+            .describe('Item type (section, checkbox, single_select, multi_select, number, text, photo)'),
+        label: z.string().min(1).max(2000).optional().describe('Question label / prompt'),
+        help_text: z.string().max(5000).optional().describe('Help text shown under the label'),
+        required: z.boolean().optional().describe('Whether an answer is required'),
+        options: z
+            .array(z.object({ value: z.string(), label: z.string() }))
+            .optional()
+            .describe('Choices for single_select / multi_select items'),
+        config: z
+            .record(z.unknown())
+            .optional()
+            .describe('Per-type configuration (e.g. { min, max, unit, multiline })'),
+        visible_when: z
+            .object({ itemKey: z.string(), op: z.string(), value: z.unknown().optional() })
+            .nullable()
+            .optional()
+            .describe('Conditional-visibility rule referencing another item'),
+    }, async ({ id, ...rest }) => {
+        try {
+            const result = await client.update('form-template-items', id, buildBody(rest));
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    server.tool('delete_form_template_item', 'Delete a form template item by ID. Requires form_template_items:write scope.', { id: z.string().uuid().describe('Form template item ID') }, async ({ id }) => {
+        try {
+            const result = await client.remove('form-template-items', id);
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    // ============================================================
     // 9. Projects (scope: projects)
     // ============================================================
     server.tool('create_project', 'Create a new project. Requires projects:write scope.', {
@@ -4129,6 +4278,8 @@ export function registerWriteTools(server, client) {
         'system-classes',
         'pm-schedules',
         'pm-templates',
+        'form-templates',
+        'form-template-items',
         'projects',
         'contracts',
         'invoices',