@assetlab/mcp-server 1.16.0 → 1.17.0

package/README.md

@@ -13,7 +13,7 @@ Works with **Claude**, **ChatGPT**, **Microsoft Copilot**, and any MCP-compatibl
 ### Claude.ai
 
 1. Create an API key in **AssetLab → Settings → API Keys**
-2. In Claude.ai, go to **Settings → Integrations → Add integration**
+2. In Claude.ai, go to **Settings → Connectors → Add connector**
 3. Paste the connector URL: `https://mcp.assetlab.ca`
 4. When prompted for auth, paste your API key (`al_live_...`)
 

package/dist/tools-write.js

@@ -25,6 +25,59 @@ function buildBody(params) {
     }
     return body;
 }
+const PM_RESOURCE_TYPES = ['TOOL', 'PART', 'MATERIAL', 'EQUIPMENT'];
+function randomTaskId() {
+    const g = globalThis;
+    return g.crypto?.randomUUID?.() ?? `task_${Math.random().toString(36).slice(2, 12)}`;
+}
+function coerceNumber(value) {
+    if (typeof value === 'number' && Number.isFinite(value))
+        return value;
+    if (typeof value === 'string' && value.trim() !== '') {
+        const n = Number(value);
+        if (Number.isFinite(n))
+            return n;
+    }
+    return undefined;
+}
+/**
+ * Shape pm_template tasks/resources to match the UI form's zod schema so
+ * records written via MCP remain editable in the app. Unknown keys are dropped,
+ * resource types are uppercased to the allowed enum, and task ids are filled in.
+ */
+function normalizePmTemplateBody(params) {
+    const out = { ...params };
+    if (Array.isArray(out.tasks)) {
+        out.tasks = out.tasks.map((raw) => {
+            const t = (raw && typeof raw === 'object') ? raw : {};
+            const id = typeof t.id === 'string' && t.id.trim() !== '' ? t.id : randomTaskId();
+            const description = typeof t.description === 'string' ? t.description : '';
+            const completed = typeof t.completed === 'boolean' ? t.completed : false;
+            return { id, description, completed };
+        });
+    }
+    if (Array.isArray(out.resources)) {
+        out.resources = out.resources.map((raw) => {
+            const r = (raw && typeof raw === 'object') ? raw : {};
+            const res = {};
+            if (typeof r.name === 'string')
+                res.name = r.name;
+            if (typeof r.type === 'string') {
+                const upper = r.type.toUpperCase();
+                if (PM_RESOURCE_TYPES.includes(upper))
+                    res.type = upper;
+            }
+            const cost = coerceNumber(r.cost);
+            if (cost !== undefined)
+                res.cost = cost;
+            const quantity = coerceNumber(r.quantity);
+            if (quantity !== undefined)
+                res.quantity = quantity;
+            return res;
+        });
+    }
+    return out;
+}
 // ---------------------------------------------------------------------------
 // Registration
 // ---------------------------------------------------------------------------
@@ -579,17 +632,22 @@ export function registerWriteTools(server, client) {
         estimated_cost: z.number().min(0).optional().describe('Estimated cost'),
         safety_requirements: z.string().optional().describe('Safety requirements'),
         tasks: z.array(z.object({
-            id: z.string().describe('Unique task ID (use a random string)'),
+            id: z.string().optional().describe('Unique task ID (auto-generated if omitted)'),
             description: z.string().describe('Task description'),
-            completed: z.boolean().describe('Whether the task is completed'),
+            completed: z.boolean().optional().describe('Whether the task is completed (defaults to false)'),
         })).optional().describe('Checklist of tasks baked into this template'),
-        resources: z.array(z.record(z.unknown())).optional().describe('Resource references (parts, tools, documents)'),
+        resources: z.array(z.object({
+            name: z.string().optional().describe('Resource name'),
+            type: z.enum(PM_RESOURCE_TYPES).optional().describe('Resource type (TOOL, PART, MATERIAL, or EQUIPMENT)'),
+            quantity: z.number().optional().describe('Quantity required'),
+            cost: z.number().optional().describe('Unit cost'),
+        })).optional().describe('Resource references (parts, tools, materials, equipment)'),
         documents: z.array(z.record(z.unknown())).optional().describe('Document references'),
         asset_ids: z.array(z.string().uuid()).optional().describe('Default asset IDs to seed on derived schedules'),
         location_ids: z.array(z.string().uuid()).optional().describe('Default location IDs to seed on derived schedules'),
     }, async (params) => {
         try {
-            const result = await client.create('pm-templates', buildBody(params));
+            const result = await client.create('pm-templates', buildBody(normalizePmTemplateBody(params)));
             return formatResult(result);
         }
         catch (err) {
@@ -608,17 +666,22 @@ export function registerWriteTools(server, client) {
         estimated_cost: z.number().min(0).optional().describe('Estimated cost'),
         safety_requirements: z.string().optional().describe('Safety requirements'),
         tasks: z.array(z.object({
-            id: z.string().describe('Unique task ID'),
+            id: z.string().optional().describe('Unique task ID (auto-generated if omitted)'),
             description: z.string().describe('Task description'),
-            completed: z.boolean().describe('Whether the task is completed'),
+            completed: z.boolean().optional().describe('Whether the task is completed (defaults to false)'),
         })).optional().describe('Checklist of tasks baked into this template'),
-        resources: z.array(z.record(z.unknown())).optional().describe('Resource references'),
+        resources: z.array(z.object({
+            name: z.string().optional().describe('Resource name'),
+            type: z.enum(PM_RESOURCE_TYPES).optional().describe('Resource type (TOOL, PART, MATERIAL, or EQUIPMENT)'),
+            quantity: z.number().optional().describe('Quantity required'),
+            cost: z.number().optional().describe('Unit cost'),
+        })).optional().describe('Resource references (parts, tools, materials, equipment)'),
         documents: z.array(z.record(z.unknown())).optional().describe('Document references'),
         asset_ids: z.array(z.string().uuid()).optional().describe('Default asset IDs'),
         location_ids: z.array(z.string().uuid()).optional().describe('Default location IDs'),
     }, async ({ id, ...rest }) => {
         try {
-            const result = await client.update('pm-templates', id, buildBody(rest));
+            const result = await client.update('pm-templates', id, buildBody(normalizePmTemplateBody(rest)));
             return formatResult(result);
         }
         catch (err) {
@@ -2189,6 +2252,20 @@ export function registerWriteTools(server, client) {
             return formatError(err);
         }
     });
+    server.tool('upload_file', 'Upload a file to AssetLab storage by sending its bytes inline (base64). The AssetLab backend performs the storage upload server-side — use this tool when the client cannot PUT directly to Supabase Storage (e.g. Claude integrations whose outbound network blocks arbitrary supabase.co hosts). Returns { path, public_url, bucket, file_size, content_type }. After uploading, pass path or public_url to the appropriate record tool (update_asset image_url, create_asset_document file_path, update_work_order image_url, create_attachment file_path, create_project_document file_path, create_contract_document file_path). Server limit is ~10 MB decoded; MCP arg ceiling effectively caps file size around 700 KB–1 MB. For larger files, use create_upload_url instead. Requires upload_urls:write scope.', {
+        bucket: z.enum(['documents', 'attachments', 'project-documents', 'contract-documents', 'asset-images']).describe('Storage bucket (required). Use "asset-images" for asset photos, "attachments" for work-order/PM attachments.'),
+        file_name: z.string().min(1).max(500).describe('File name including extension (required)'),
+        content_base64: z.string().min(1).describe('File contents base64-encoded (required). Data URI prefixes like "data:image/png;base64," are stripped automatically.'),
+        content_type: z.string().max(200).optional().describe('MIME type (e.g. image/jpeg, application/pdf). Defaults to application/octet-stream.'),
+    }, async (params) => {
+        try {
+            const result = await client.create('upload-files', buildBody(params));
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
     // ============================================================
     // Asset Documents (scope: asset_documents)
     // ============================================================