@zudello/modelcontextprotocol 1.0.0 → 1.1.1

package/dist/tools/admin/fields/get-field.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-field.d.ts","sourceRoot":"","sources":["../../../../src/tools/admin/fields/get-field.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D,eAAO,MAAM,eAAe;;;;;;;;;;;;;qBAgBjB;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,eACV,WAAW;;;;;;;;;CAuB3B,CAAC"}
+{"version":3,"file":"get-field.d.ts","sourceRoot":"","sources":["../../../../src/tools/admin/fields/get-field.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D,eAAO,MAAM,eAAe;;;;;;;;;;;;;qBAuBjB;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,eACV,WAAW;;;;;;;;;CAuB3B,CAAC"}

package/dist/tools/admin/fields/get-field.js

@@ -2,9 +2,16 @@ import { logger } from "../../../utils/logger.js";
 import { getZudelloField } from "../../../services/zudello/admin.js";
 export const zudelloGetField = {
     name: "zudelloGetField",
-    description: `Get details for a specific field configuration.
+    description: `Get full details of a specific field settings by UUID.
 
-Returns complete field definition including type, validation rules, options, and display settings.`,
+Returns the complete field configuration including:
+- payload.path: Field path
+- payload.label: Display label
+- payload.model_name: Target model
+- payload.form_data: Editor, validations, and rules
+- context: Module/submodule scope
+
+Use zudelloListFields first to find the UUID.`,
     inputSchema: {
         type: "object",
         properties: {

package/dist/tools/admin/fields/get-field.js.map

@@ -1 +1 @@
-{"version":3,"file":"get-field.js","sourceRoot":"","sources":["../../../../src/tools/admin/fields/get-field.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAGrE,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,IAAI,EAAE,iBAAiB;IACvB,WAAW,EAAE;;mGAEoF;IACjG,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,+BAA+B;aAC7C;SACF;QACD,QAAQ,EAAE,CAAC,MAAM,CAAC;KACnB;IACD,OAAO,EAAE,KAAK,EACZ,KAAuB,EACvB,WAAwB,EACxB,EAAE;QACF,IAAI,CAAC;YACH,MAAM,CAAC,KAAK,CAAC,0BAA0B,EAAE,KAAK,CAAC,CAAC;YAEhD,MAAM,QAAQ,GAAG,MAAM,eAAe,CAAC,WAAW,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YAEhE,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;gBACtB,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,qBAAqB,CAAC,CAAC;YAC3D,CAAC;YAED,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,KAAK,EAAE,QAAQ,CAAC,IAAI;aACrB,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,uBAAuB,EAAE,KAAK,EAAE,KAAc,CAAC,CAAC;YAC7D,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAG,KAAe,CAAC,OAAO;aAChC,CAAC;QACJ,CAAC;IACH,CAAC;CACF,CAAC"}
+{"version":3,"file":"get-field.js","sourceRoot":"","sources":["../../../../src/tools/admin/fields/get-field.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAGrE,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,IAAI,EAAE,iBAAiB;IACvB,WAAW,EAAE;;;;;;;;;8CAS+B;IAC5C,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,+BAA+B;aAC7C;SACF;QACD,QAAQ,EAAE,CAAC,MAAM,CAAC;KACnB;IACD,OAAO,EAAE,KAAK,EACZ,KAAuB,EACvB,WAAwB,EACxB,EAAE;QACF,IAAI,CAAC;YACH,MAAM,CAAC,KAAK,CAAC,0BAA0B,EAAE,KAAK,CAAC,CAAC;YAEhD,MAAM,QAAQ,GAAG,MAAM,eAAe,CAAC,WAAW,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YAEhE,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;gBACtB,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,qBAAqB,CAAC,CAAC;YAC3D,CAAC;YAED,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,KAAK,EAAE,QAAQ,CAAC,IAAI;aACrB,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,uBAAuB,EAAE,KAAK,EAAE,KAAc,CAAC,CAAC;YAC7D,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAG,KAAe,CAAC,OAAO;aAChC,CAAC;QACJ,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/tools/admin/fields/list-fields.d.ts

@@ -17,12 +17,10 @@ export declare const zudelloListFields: {
         success: boolean;
         fields: {
             uuid: string;
-            name: string;
+            path: string;
             label: string;
-            type: string;
-            model: string;
-            required: boolean;
-            options: Record<string, unknown> | undefined;
+            model_name: string;
+            context: Record<string, string[]>;
         }[];
         count: number;
         error?: undefined;

package/dist/tools/admin/fields/list-fields.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"list-fields.d.ts","sourceRoot":"","sources":["../../../../src/tools/admin/fields/list-fields.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D,eAAO,MAAM,iBAAiB;;;;;;;;;;;;qBAgBnB;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,eACZ,WAAW;;;;;;;;;;;;;;;;;;;CAmC3B,CAAC"}
+{"version":3,"file":"list-fields.d.ts","sourceRoot":"","sources":["../../../../src/tools/admin/fields/list-fields.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAG5D,eAAO,MAAM,iBAAiB;;;;;;;;;;;;qBAsBnB;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,eACZ,WAAW;;;;;;;;;;;;;;;;;CAwC3B,CAAC"}

package/dist/tools/admin/fields/list-fields.js

@@ -1,11 +1,17 @@
 import { logger } from "../../../utils/logger.js";
-import { listZudelloFields } from "../../../services/zudello/admin.js";
+import { listZudelloFieldSettings } from "../../../services/zudello/admin.js";
 export const zudelloListFields = {
     name: "zudelloListFields",
-    description: `List all custom field configurations.
+    description: `List all custom field settings in Zudello.
 
-Returns field definitions including name, type, validation rules, and display settings.
-Fields can be filtered by model type.`,
+Returns field settings that customize or override field behavior. Each result includes:
+- uuid: Unique identifier
+- path: Field path (e.g., 'document_number', 'custom__myfield', 'lines__custom__linefield')
+- label: Display label
+- model_name: Model the field applies to (e.g., 'Transaction', 'Supplier')
+- context: Module/submodule scope
+
+Set fullObject=true to get complete field configuration including editor, validations, and rules.`,
     inputSchema: {
         type: "object",
         properties: {
@@ -17,28 +23,30 @@ Fields can be filtered by model type.`,
     },
     execute: async (input, authContext) => {
         try {
-            logger.debug("zudelloListFields executed", input);
-            const response = await listZudelloFields(authContext, { model: input.model });
+            logger.debug("zudelloListFields executed", { model: input.model });
+            const response = await listZudelloFieldSettings(authContext, { fullObject: false });
             if (!response.success) {
                 throw new Error(response.error || "Failed to list fields");
             }
-            const fields = response.data || [];
+            let fields = (response.data || []);
+            // Client-side filtering if model is specified
+            if (input.model) {
+                fields = fields.filter((f) => f.model_name?.toLowerCase().includes(input.model.toLowerCase()));
+            }
             return {
                 success: true,
                 fields: fields.map((f) => ({
                     uuid: f.uuid,
-                    name: f.name,
+                    path: f.path,
                     label: f.label,
-                    type: f.type,
-                    model: f.model,
-                    required: f.required,
-                    options: f.options,
+                    model_name: f.model_name,
+                    context: f.context,
                 })),
                 count: fields.length,
             };
         }
         catch (error) {
-            logger.error("zudelloListFields error", input, error);
+            logger.error("zudelloListFields error", { model: input.model }, error);
             return {
                 success: false,
                 error: error.message,

package/dist/tools/admin/fields/list-fields.js.map

@@ -1 +1 @@
-{"version":3,"file":"list-fields.js","sourceRoot":"","sources":["../../../../src/tools/admin/fields/list-fields.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AAGvE,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,IAAI,EAAE,mBAAmB;IACzB,WAAW,EAAE;;;sCAGuB;IACpC,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,uCAAuC;aACrD;SACF;KACF;IACD,OAAO,EAAE,KAAK,EACZ,KAAyB,EACzB,WAAwB,EACxB,EAAE;QACF,IAAI,CAAC;YACH,MAAM,CAAC,KAAK,CAAC,4BAA4B,EAAE,KAAK,CAAC,CAAC;YAElD,MAAM,QAAQ,GAAG,MAAM,iBAAiB,CAAC,WAAW,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;YAE9E,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;gBACtB,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,uBAAuB,CAAC,CAAC;YAC7D,CAAC;YAED,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,IAAI,EAAE,CAAC;YAEnC,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;oBACzB,IAAI,EAAE,CAAC,CAAC,IAAI;oBACZ,IAAI,EAAE,CAAC,CAAC,IAAI;oBACZ,KAAK,EAAE,CAAC,CAAC,KAAK;oBACd,IAAI,EAAE,CAAC,CAAC,IAAI;oBACZ,KAAK,EAAE,CAAC,CAAC,KAAK;oBACd,QAAQ,EAAE,CAAC,CAAC,QAAQ;oBACpB,OAAO,EAAE,CAAC,CAAC,OAAO;iBACnB,CAAC,CAAC;gBACH,KAAK,EAAE,MAAM,CAAC,MAAM;aACrB,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,yBAAyB,EAAE,KAAK,EAAE,KAAc,CAAC,CAAC;YAC/D,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAG,KAAe,CAAC,OAAO;gBAC/B,MAAM,EAAE,EAAE;aACX,CAAC;QACJ,CAAC;IACH,CAAC;CACF,CAAC"}
+{"version":3,"file":"list-fields.js","sourceRoot":"","sources":["../../../../src/tools/admin/fields/list-fields.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAClD,OAAO,EAAE,wBAAwB,EAAE,MAAM,oCAAoC,CAAC;AAI9E,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,IAAI,EAAE,mBAAmB;IACzB,WAAW,EAAE;;;;;;;;;kGASmF;IAChG,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,uCAAuC;aACrD;SACF;KACF;IACD,OAAO,EAAE,KAAK,EACZ,KAAyB,EACzB,WAAwB,EACxB,EAAE;QACF,IAAI,CAAC;YACH,MAAM,CAAC,KAAK,CAAC,4BAA4B,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;YAEnE,MAAM,QAAQ,GAAG,MAAM,wBAAwB,CAAC,WAAW,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC;YAEpF,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;gBACtB,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,uBAAuB,CAAC,CAAC;YAC7D,CAAC;YAED,IAAI,MAAM,GAAG,CAAC,QAAQ,CAAC,IAAI,IAAI,EAAE,CAA2B,CAAC;YAE7D,8CAA8C;YAC9C,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;gBAChB,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAC3B,CAAC,CAAC,UAAU,EAAE,WAAW,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAM,CAAC,WAAW,EAAE,CAAC,CACjE,CAAC;YACJ,CAAC;YAED,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;oBACzB,IAAI,EAAE,CAAC,CAAC,IAAI;oBACZ,IAAI,EAAE,CAAC,CAAC,IAAI;oBACZ,KAAK,EAAE,CAAC,CAAC,KAAK;oBACd,UAAU,EAAE,CAAC,CAAC,UAAU;oBACxB,OAAO,EAAE,CAAC,CAAC,OAAO;iBACnB,CAAC,CAAC;gBACH,KAAK,EAAE,MAAM,CAAC,MAAM;aACrB,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,yBAAyB,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,EAAE,KAAc,CAAC,CAAC;YAChF,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAG,KAAe,CAAC,OAAO;gBAC/B,MAAM,EAAE,EAAE;aACX,CAAC;QACJ,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/tools/admin/fields/update-field.d.ts

@@ -9,15 +9,19 @@ export declare const zudelloUpdateField: {
                 type: string;
                 description: string;
             };
+            path: {
+                type: string;
+                description: string;
+            };
             label: {
                 type: string;
                 description: string;
             };
-            required: {
+            model_name: {
                 type: string;
                 description: string;
             };
-            options: {
+            context: {
                 type: string;
                 description: string;
             };
@@ -26,12 +30,13 @@ export declare const zudelloUpdateField: {
     };
     execute: (input: {
         uuid: string;
-        label?: string;
-        required?: boolean;
-        options?: Record<string, unknown>;
+        path: string;
+        label: string;
+        model_name: string;
+        context?: Record<string, string[]>;
     }, authContext: AuthContext) => Promise<{
         success: boolean;
-        field: import("../../../services/zudello/admin.js").Field | undefined;
+        field: import("../../../services/zudello/admin.js").ZudelloFieldSettings | undefined;
         message: string;
         error?: undefined;
     } | {

package/dist/tools/admin/fields/update-field.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"update-field.d.ts","sourceRoot":"","sources":["../../../../src/tools/admin/fields/update-field.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;qBA6BpB;QACL,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACnC,eACY,WAAW;;;;;;;;;;;CA4B3B,CAAC"}
+{"version":3,"file":"update-field.d.ts","sourceRoot":"","sources":["../../../../src/tools/admin/fields/update-field.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBAmCpB;QACL,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,UAAU,EAAE,MAAM,CAAC;QACnB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;KACpC,eACY,WAAW;;;;;;;;;;;CAiC3B,CAAC"}

package/dist/tools/admin/fields/update-field.js

@@ -1,11 +1,13 @@
 import { logger } from "../../../utils/logger.js";
-import { updateZudelloField } from "../../../services/zudello/admin.js";
+import { updateZudelloFieldSettings } from "../../../services/zudello/admin.js";
 export const zudelloUpdateField = {
     name: "zudelloUpdateField",
-    description: `Update an existing field configuration.
+    description: `Update an existing field settings in Zudello.
 
-Modify field label, validation rules, or options.
-Changes affect how the field is displayed and validated.`,
+IMPORTANT: Always use zudelloGetField first to retrieve the current configuration.
+This ensures you have the correct UUID and can preserve settings you don't want to change.
+
+See zudelloCreateField description for field configuration details.`,
     inputSchema: {
         type: "object",
         properties: {
@@ -13,29 +15,33 @@ Changes affect how the field is displayed and validated.`,
                 type: "string",
                 description: "UUID of the field to update"
             },
+            path: {
+                type: "string",
+                description: "Field path (internal identifier)"
+            },
             label: {
                 type: "string",
-                description: "Optional: New display label"
+                description: "Display label"
             },
-            required: {
-                type: "boolean",
-                description: "Optional: Update required status"
+            model_name: {
+                type: "string",
+                description: "Model name this field belongs to"
             },
-            options: {
+            context: {
                 type: "object",
-                description: "Optional: Updated field options and validation rules"
+                description: "Optional: Module/submodule context mapping"
             }
         },
-        required: ["uuid"]
+        required: ["uuid", "path", "label", "model_name"]
     },
     execute: async (input, authContext) => {
         try {
-            logger.info("zudelloUpdateField executed", input);
-            const response = await updateZudelloField(authContext, input.uuid, {
+            logger.info("zudelloUpdateField executed", { uuid: input.uuid, path: input.path });
+            const response = await updateZudelloFieldSettings(authContext, input.uuid, {
+                path: input.path,
                 label: input.label,
-                required: input.required,
-                options: input.options
-            });
+                model_name: input.model_name,
+            }, input.context || {});
             if (!response.success) {
                 throw new Error(response.error || "Failed to update field");
             }
@@ -46,7 +52,7 @@ Changes affect how the field is displayed and validated.`,
             };
         }
         catch (error) {
-            logger.error("zudelloUpdateField error", input, error);
+            logger.error("zudelloUpdateField error", { uuid: input.uuid }, error);
             return {
                 success: false,
                 error: error.message

package/dist/tools/admin/fields/update-field.js.map

@@ -1 +1 @@
-{"version":3,"file":"update-field.js","sourceRoot":"","sources":["../../../../src/tools/admin/fields/update-field.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AAGxE,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,IAAI,EAAE,oBAAoB;IAC1B,WAAW,EAAE;;;yDAG0C;IACvD,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,6BAA6B;aAC3C;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,6BAA6B;aAC3C;YACD,QAAQ,EAAE;gBACR,IAAI,EAAE,SAAS;gBACf,WAAW,EAAE,kCAAkC;aAChD;YACD,OAAO,EAAE;gBACP,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,sDAAsD;aACpE;SACF;QACD,QAAQ,EAAE,CAAC,MAAM,CAAC;KACnB;IACD,OAAO,EAAE,KAAK,EACZ,KAKC,EACD,WAAwB,EACxB,EAAE;QACF,IAAI,CAAC;YACH,MAAM,CAAC,IAAI,CAAC,6BAA6B,EAAE,KAAK,CAAC,CAAC;YAElD,MAAM,QAAQ,GAAG,MAAM,kBAAkB,CAAC,WAAW,EAAE,KAAK,CAAC,IAAI,EAAE;gBACjE,KAAK,EAAE,KAAK,CAAC,KAAK;gBAClB,QAAQ,EAAE,KAAK,CAAC,QAAQ;gBACxB,OAAO,EAAE,KAAK,CAAC,OAAO;aACvB,CAAC,CAAC;YAEH,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;gBACtB,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,wBAAwB,CAAC,CAAC;YAC9D,CAAC;YAED,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,KAAK,EAAE,QAAQ,CAAC,IAAI;gBACpB,OAAO,EAAE,4BAA4B;aACtC,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,0BAA0B,EAAE,KAAK,EAAE,KAAc,CAAC,CAAC;YAChE,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAG,KAAe,CAAC,OAAO;aAChC,CAAC;QACJ,CAAC;IACH,CAAC;CACF,CAAC"}
+{"version":3,"file":"update-field.js","sourceRoot":"","sources":["../../../../src/tools/admin/fields/update-field.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAClD,OAAO,EAAE,0BAA0B,EAAE,MAAM,oCAAoC,CAAC;AAGhF,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,IAAI,EAAE,oBAAoB;IAC1B,WAAW,EAAE;;;;;oEAKqD;IAClE,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,6BAA6B;aAC3C;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,kCAAkC;aAChD;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,eAAe;aAC7B;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,kCAAkC;aAChD;YACD,OAAO,EAAE;gBACP,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,4CAA4C;aAC1D;SACF;QACD,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,CAAC;KAClD;IACD,OAAO,EAAE,KAAK,EACZ,KAMC,EACD,WAAwB,EACxB,EAAE;QACF,IAAI,CAAC;YACH,MAAM,CAAC,IAAI,CAAC,6BAA6B,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;YAEnF,MAAM,QAAQ,GAAG,MAAM,0BAA0B,CAC/C,WAAW,EACX,KAAK,CAAC,IAAI,EACV;gBACE,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,KAAK,EAAE,KAAK,CAAC,KAAK;gBAClB,UAAU,EAAE,KAAK,CAAC,UAAU;aAC7B,EACD,KAAK,CAAC,OAAO,IAAI,EAAE,CACpB,CAAC;YAEF,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;gBACtB,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,wBAAwB,CAAC,CAAC;YAC9D,CAAC;YAED,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,KAAK,EAAE,QAAQ,CAAC,IAAI;gBACpB,OAAO,EAAE,4BAA4B;aACtC,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,0BAA0B,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,EAAE,KAAc,CAAC,CAAC;YAC/E,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAG,KAAe,CAAC,OAAO;aAChC,CAAC;QACJ,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/tools/admin/quick-actions/create-quick-action.d.ts

@@ -5,23 +5,23 @@ export declare const zudelloCreateQuickAction: {
     inputSchema: {
         type: "object";
         properties: {
-            name: {
+            key: {
                 type: string;
                 description: string;
             };
-            action: {
+            name: {
                 type: string;
                 description: string;
             };
-            model: {
+            description: {
                 type: string;
                 description: string;
             };
-            description: {
+            icon: {
                 type: string;
                 description: string;
             };
-            parameters: {
+            color: {
                 type: string;
                 description: string;
             };
@@ -29,14 +29,14 @@ export declare const zudelloCreateQuickAction: {
         required: string[];
     };
     execute: (input: {
+        key: string;
         name: string;
-        action: string;
-        model: string;
         description?: string;
-        parameters?: Record<string, unknown>;
+        icon?: string;
+        color?: string;
     }, authContext: AuthContext) => Promise<{
         success: boolean;
-        quickAction: import("../../../services/zudello/admin.js").QuickAction | undefined;
+        quickAction: import("../../../services/zudello/admin.js").ZudelloQuickAction | undefined;
         message: string;
         error?: undefined;
     } | {

package/dist/tools/admin/quick-actions/create-quick-action.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-quick-action.d.ts","sourceRoot":"","sources":["../../../../src/tools/admin/quick-actions/create-quick-action.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBAiC1B;QACL,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,EAAE,MAAM,CAAC;QACd,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACtC,eACY,WAAW;;;;;;;;;;;CA8B3B,CAAC"}
+{"version":3,"file":"create-quick-action.d.ts","sourceRoot":"","sources":["../../../../src/tools/admin/quick-actions/create-quick-action.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBA8C1B;QACL,GAAG,EAAE,MAAM,CAAC;QACZ,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,eACY,WAAW;;;;;;;;;;;CA8B3B,CAAC"}

package/dist/tools/admin/quick-actions/create-quick-action.js

@@ -2,45 +2,58 @@ import { logger } from "../../../utils/logger.js";
 import { createZudelloQuickAction } from "../../../services/zudello/admin.js";
 export const zudelloCreateQuickAction = {
     name: "zudelloCreateQuickAction",
-    description: `Create a new quick action.
+    description: `Create a new quick action button.
 
-Define a new one-click operation that can be performed on documents.
-Specify name, action type, model, and parameters.`,
+Quick actions are buttons displayed on documents that fire events for sentence automation.
+
+**Payload fields:**
+- key (required): Unique identifier, becomes the button event name (e.g., "SEND_TO_APPROVAL")
+- name (required): Display label shown on the button
+- hotkey (optional): Keyboard shortcut for the action
+- status (optional): Status to set on document when clicked (e.g., "REVIEW", "PROCESSING")
+- context (optional): Scope to specific modules/submodules. Format: {"MODULE": ["SUBMODULE1", "SUBMODULE2"]}
+  - Empty or omitted = system-wide (appears on all documents)
+  - Example: {"PURCHASING": ["INVOICE", "ORDER"]} = only on purchasing invoices and orders
+- isInternal (optional): If true, button is hidden from regular UI but can still be triggered programmatically
+
+**Event integration:**
+The button event name is "button + key", e.g., creating key "SEND_TO_APPROVAL" fires event "button SEND_TO_APPROVAL".
+Sentences can listen to this event type to trigger automation workflows.`,
     inputSchema: {
         type: "object",
         properties: {
-            name: {
-                type: "string",
-                description: "Quick action name"
-            },
-            action: {
+            key: {
                 type: "string",
-                description: "Action type to perform"
+                description: "Unique key for the quick action (used for triggering)"
             },
-            model: {
+            name: {
                 type: "string",
-                description: "Model type this action applies to"
+                description: "Display name for the quick action"
             },
             description: {
                 type: "string",
                 description: "Optional: Description of what the action does"
             },
-            parameters: {
-                type: "object",
-                description: "Optional: Action-specific parameters"
+            icon: {
+                type: "string",
+                description: "Optional: Icon identifier for the action"
+            },
+            color: {
+                type: "string",
+                description: "Optional: Color for the action button"
             }
         },
-        required: ["name", "action", "model"]
+        required: ["key", "name"]
     },
     execute: async (input, authContext) => {
         try {
-            logger.info("zudelloCreateQuickAction executed", input);
+            logger.info("zudelloCreateQuickAction executed", { key: input.key, name: input.name });
             const response = await createZudelloQuickAction(authContext, {
+                key: input.key,
                 name: input.name,
-                action: input.action,
-                model: input.model,
                 description: input.description,
-                parameters: input.parameters
+                icon: input.icon,
+                color: input.color,
             });
             if (!response.success) {
                 throw new Error(response.error || "Failed to create quick action");
@@ -52,7 +65,7 @@ Specify name, action type, model, and parameters.`,
             };
         }
         catch (error) {
-            logger.error("zudelloCreateQuickAction error", input, error);
+            logger.error("zudelloCreateQuickAction error", { key: input.key }, error);
             return {
                 success: false,
                 error: error.message

package/dist/tools/admin/quick-actions/create-quick-action.js.map

@@ -1 +1 @@
-{"version":3,"file":"create-quick-action.js","sourceRoot":"","sources":["../../../../src/tools/admin/quick-actions/create-quick-action.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAClD,OAAO,EAAE,wBAAwB,EAAE,MAAM,oCAAoC,CAAC;AAG9E,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,IAAI,EAAE,0BAA0B;IAChC,WAAW,EAAE;;;kDAGmC;IAChD,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,mBAAmB;aACjC;YACD,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,wBAAwB;aACtC;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,mCAAmC;aACjD;YACD,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,+CAA+C;aAC7D;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,sCAAsC;aACpD;SACF;QACD,QAAQ,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,CAAC;KACtC;IACD,OAAO,EAAE,KAAK,EACZ,KAMC,EACD,WAAwB,EACxB,EAAE;QACF,IAAI,CAAC;YACH,MAAM,CAAC,IAAI,CAAC,mCAAmC,EAAE,KAAK,CAAC,CAAC;YAExD,MAAM,QAAQ,GAAG,MAAM,wBAAwB,CAAC,WAAW,EAAE;gBAC3D,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,MAAM,EAAE,KAAK,CAAC,MAAM;gBACpB,KAAK,EAAE,KAAK,CAAC,KAAK;gBAClB,WAAW,EAAE,KAAK,CAAC,WAAW;gBAC9B,UAAU,EAAE,KAAK,CAAC,UAAU;aAC7B,CAAC,CAAC;YAEH,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;gBACtB,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,+BAA+B,CAAC,CAAC;YACrE,CAAC;YAED,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,WAAW,EAAE,QAAQ,CAAC,IAAI;gBAC1B,OAAO,EAAE,iBAAiB,KAAK,CAAC,IAAI,wBAAwB;aAC7D,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,gCAAgC,EAAE,KAAK,EAAE,KAAc,CAAC,CAAC;YACtE,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAG,KAAe,CAAC,OAAO;aAChC,CAAC;QACJ,CAAC;IACH,CAAC;CACF,CAAC"}
+{"version":3,"file":"create-quick-action.js","sourceRoot":"","sources":["../../../../src/tools/admin/quick-actions/create-quick-action.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAClD,OAAO,EAAE,wBAAwB,EAAE,MAAM,oCAAoC,CAAC;AAG9E,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,IAAI,EAAE,0BAA0B;IAChC,WAAW,EAAE;;;;;;;;;;;;;;;;yEAgB0D;IACvE,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,GAAG,EAAE;gBACH,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,uDAAuD;aACrE;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,mCAAmC;aACjD;YACD,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,+CAA+C;aAC7D;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,0CAA0C;aACxD;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,uCAAuC;aACrD;SACF;QACD,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC;KAC1B;IACD,OAAO,EAAE,KAAK,EACZ,KAMC,EACD,WAAwB,EACxB,EAAE;QACF,IAAI,CAAC;YACH,MAAM,CAAC,IAAI,CAAC,mCAAmC,EAAE,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;YAEvF,MAAM,QAAQ,GAAG,MAAM,wBAAwB,CAAC,WAAW,EAAE;gBAC3D,GAAG,EAAE,KAAK,CAAC,GAAG;gBACd,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,WAAW,EAAE,KAAK,CAAC,WAAW;gBAC9B,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,KAAK,EAAE,KAAK,CAAC,KAAK;aACnB,CAAC,CAAC;YAEH,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;gBACtB,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,+BAA+B,CAAC,CAAC;YACrE,CAAC;YAED,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,WAAW,EAAE,QAAQ,CAAC,IAAI;gBAC1B,OAAO,EAAE,iBAAiB,KAAK,CAAC,IAAI,wBAAwB;aAC7D,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,gCAAgC,EAAE,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,EAAE,KAAc,CAAC,CAAC;YACnF,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAG,KAAe,CAAC,OAAO;aAChC,CAAC;QACJ,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/tools/admin/quick-actions/get-quick-action.d.ts

@@ -16,7 +16,7 @@ export declare const zudelloGetQuickAction: {
         uuid: string;
     }, authContext: AuthContext) => Promise<{
         success: boolean;
-        quickAction: import("../../../services/zudello/admin.js").QuickAction | undefined;
+        quickAction: import("../../../services/zudello/admin.js").ZudelloQuickAction | undefined;
         error?: undefined;
     } | {
         success: boolean;

package/dist/tools/admin/quick-actions/get-quick-action.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-quick-action.d.ts","sourceRoot":"","sources":["../../../../src/tools/admin/quick-actions/get-quick-action.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;qBAgBvB;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,eACV,WAAW;;;;;;;;;CAuB3B,CAAC"}
+{"version":3,"file":"get-quick-action.d.ts","sourceRoot":"","sources":["../../../../src/tools/admin/quick-actions/get-quick-action.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;qBAiBvB;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,eACV,WAAW;;;;;;;;;CAuB3B,CAAC"}

package/dist/tools/admin/quick-actions/get-quick-action.js

@@ -2,9 +2,10 @@ import { logger } from "../../../utils/logger.js";
 import { getZudelloQuickAction } from "../../../services/zudello/admin.js";
 export const zudelloGetQuickAction = {
     name: "zudelloGetQuickAction",
-    description: `Get details for a specific quick action.
+    description: `Get details of a specific quick action by its UUID.
 
-Returns complete quick action configuration including name, action type, parameters, and model.`,
+Returns the full quick action configuration including payload details.
+Use this to inspect a specific quick action's settings before updating or triggering it.`,
     inputSchema: {
         type: "object",
         properties: {

package/dist/tools/admin/quick-actions/get-quick-action.js.map

@@ -1 +1 @@
-{"version":3,"file":"get-quick-action.js","sourceRoot":"","sources":["../../../../src/tools/admin/quick-actions/get-quick-action.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAClD,OAAO,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAG3E,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,IAAI,EAAE,uBAAuB;IAC7B,WAAW,EAAE;;gGAEiF;IAC9F,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,sCAAsC;aACpD;SACF;QACD,QAAQ,EAAE,CAAC,MAAM,CAAC;KACnB;IACD,OAAO,EAAE,KAAK,EACZ,KAAuB,EACvB,WAAwB,EACxB,EAAE;QACF,IAAI,CAAC;YACH,MAAM,CAAC,KAAK,CAAC,gCAAgC,EAAE,KAAK,CAAC,CAAC;YAEtD,MAAM,QAAQ,GAAG,MAAM,qBAAqB,CAAC,WAAW,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YAEtE,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;gBACtB,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,4BAA4B,CAAC,CAAC;YAClE,CAAC;YAED,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,WAAW,EAAE,QAAQ,CAAC,IAAI;aAC3B,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,6BAA6B,EAAE,KAAK,EAAE,KAAc,CAAC,CAAC;YACnE,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAG,KAAe,CAAC,OAAO;aAChC,CAAC;QACJ,CAAC;IACH,CAAC;CACF,CAAC"}
+{"version":3,"file":"get-quick-action.js","sourceRoot":"","sources":["../../../../src/tools/admin/quick-actions/get-quick-action.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAClD,OAAO,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAG3E,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,IAAI,EAAE,uBAAuB;IAC7B,WAAW,EAAE;;;yFAG0E;IACvF,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,sCAAsC;aACpD;SACF;QACD,QAAQ,EAAE,CAAC,MAAM,CAAC;KACnB;IACD,OAAO,EAAE,KAAK,EACZ,KAAuB,EACvB,WAAwB,EACxB,EAAE;QACF,IAAI,CAAC;YACH,MAAM,CAAC,KAAK,CAAC,gCAAgC,EAAE,KAAK,CAAC,CAAC;YAEtD,MAAM,QAAQ,GAAG,MAAM,qBAAqB,CAAC,WAAW,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YAEtE,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;gBACtB,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,4BAA4B,CAAC,CAAC;YAClE,CAAC;YAED,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,WAAW,EAAE,QAAQ,CAAC,IAAI;aAC3B,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,6BAA6B,EAAE,KAAK,EAAE,KAAc,CAAC,CAAC;YACnE,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAG,KAAe,CAAC,OAAO;aAChC,CAAC;QACJ,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/tools/admin/quick-actions/list-quick-actions.d.ts

@@ -17,11 +17,12 @@ export declare const zudelloListQuickActions: {
         success: boolean;
         quickActions: {
             uuid: string;
+            key: string;
             name: string;
             description: string | undefined;
-            model: string;
-            action: string;
-            parameters: Record<string, unknown> | undefined;
+            icon: string | undefined;
+            color: string | undefined;
+            context: Record<string, string[]> | undefined;
         }[];
         count: number;
         error?: undefined;

package/dist/tools/admin/quick-actions/list-quick-actions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"list-quick-actions.d.ts","sourceRoot":"","sources":["../../../../src/tools/admin/quick-actions/list-quick-actions.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D,eAAO,MAAM,uBAAuB;;;;;;;;;;;;qBAgBzB;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,eACZ,WAAW;;;;;;;;;;;;;;;;;;CAkC3B,CAAC"}
+{"version":3,"file":"list-quick-actions.d.ts","sourceRoot":"","sources":["../../../../src/tools/admin/quick-actions/list-quick-actions.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D,eAAO,MAAM,uBAAuB;;;;;;;;;;;;qBAyBzB;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,eACZ,WAAW;;;;;;;;;;;;;;;;;;;CAmC3B,CAAC"}

package/dist/tools/admin/quick-actions/list-quick-actions.js

@@ -2,23 +2,32 @@ import { logger } from "../../../utils/logger.js";
 import { listZudelloQuickActions } from "../../../services/zudello/admin.js";
 export const zudelloListQuickActions = {
     name: "zudelloListQuickActions",
-    description: `List all quick action configurations.
+    description: `List all quick actions in the system.
 
-Quick actions are one-click operations that can be performed on documents.
-Returns action definitions including name, model, action type, and parameters.`,
+Quick actions are buttons that can be displayed on documents, either system-wide or scoped to specific module/submodule contexts. When clicked, they fire a button event that sentences (automation rules) can listen to.
+
+Returns all quick actions with their configuration including:
+- key: Unique identifier used as the button event name
+- name: Display label for the button
+- hotkey: Optional keyboard shortcut
+- status: Optional status to set on the document when clicked
+- context: Optional scoping to specific modules/submodules (empty = system-wide)
+- isInternal: If true, hidden from regular UI
+
+Use this to discover available quick actions before triggering them on documents.`,
     inputSchema: {
         type: "object",
         properties: {
             model: {
                 type: "string",
-                description: "Optional: Filter quick actions by model type",
+                description: "Optional: Filter quick actions by model type (client-side)",
             },
         },
     },
     execute: async (input, authContext) => {
         try {
-            logger.debug("zudelloListQuickActions executed", input);
-            const response = await listZudelloQuickActions(authContext, { model: input.model });
+            logger.debug("zudelloListQuickActions executed", { model: input.model });
+            const response = await listZudelloQuickActions(authContext);
             if (!response.success) {
                 throw new Error(response.error || "Failed to list quick actions");
             }
@@ -27,17 +36,18 @@ Returns action definitions including name, model, action type, and parameters.`,
                 success: true,
                 quickActions: actions.map((a) => ({
                     uuid: a.uuid,
-                    name: a.name,
-                    description: a.description,
-                    model: a.model,
-                    action: a.action,
-                    parameters: a.parameters,
+                    key: a.payload?.key,
+                    name: a.payload?.name,
+                    description: a.payload?.description,
+                    icon: a.payload?.icon,
+                    color: a.payload?.color,
+                    context: a.context,
                 })),
                 count: actions.length,
             };
         }
         catch (error) {
-            logger.error("zudelloListQuickActions error", input, error);
+            logger.error("zudelloListQuickActions error", { model: input.model }, error);
             return {
                 success: false,
                 error: error.message,

package/dist/tools/admin/quick-actions/list-quick-actions.js.map

@@ -1 +1 @@
-{"version":3,"file":"list-quick-actions.js","sourceRoot":"","sources":["../../../../src/tools/admin/quick-actions/list-quick-actions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAClD,OAAO,EAAE,uBAAuB,EAAE,MAAM,oCAAoC,CAAC;AAG7E,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,IAAI,EAAE,yBAAyB;IAC/B,WAAW,EAAE;;;+EAGgE;IAC7E,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,8CAA8C;aAC5D;SACF;KACF;IACD,OAAO,EAAE,KAAK,EACZ,KAAyB,EACzB,WAAwB,EACxB,EAAE;QACF,IAAI,CAAC;YACH,MAAM,CAAC,KAAK,CAAC,kCAAkC,EAAE,KAAK,CAAC,CAAC;YAExD,MAAM,QAAQ,GAAG,MAAM,uBAAuB,CAAC,WAAW,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;YAEpF,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;gBACtB,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,8BAA8B,CAAC,CAAC;YACpE,CAAC;YAED,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,IAAI,EAAE,CAAC;YAEpC,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,YAAY,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;oBAChC,IAAI,EAAE,CAAC,CAAC,IAAI;oBACZ,IAAI,EAAE,CAAC,CAAC,IAAI;oBACZ,WAAW,EAAE,CAAC,CAAC,WAAW;oBAC1B,KAAK,EAAE,CAAC,CAAC,KAAK;oBACd,MAAM,EAAE,CAAC,CAAC,MAAM;oBAChB,UAAU,EAAE,CAAC,CAAC,UAAU;iBACzB,CAAC,CAAC;gBACH,KAAK,EAAE,OAAO,CAAC,MAAM;aACtB,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,+BAA+B,EAAE,KAAK,EAAE,KAAc,CAAC,CAAC;YACrE,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAG,KAAe,CAAC,OAAO;gBAC/B,YAAY,EAAE,EAAE;aACjB,CAAC;QACJ,CAAC;IACH,CAAC;CACF,CAAC"}
+{"version":3,"file":"list-quick-actions.js","sourceRoot":"","sources":["../../../../src/tools/admin/quick-actions/list-quick-actions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAClD,OAAO,EAAE,uBAAuB,EAAE,MAAM,oCAAoC,CAAC;AAG7E,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,IAAI,EAAE,yBAAyB;IAC/B,WAAW,EAAE;;;;;;;;;;;;kFAYmE;IAChF,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,4DAA4D;aAC1E;SACF;KACF;IACD,OAAO,EAAE,KAAK,EACZ,KAAyB,EACzB,WAAwB,EACxB,EAAE;QACF,IAAI,CAAC;YACH,MAAM,CAAC,KAAK,CAAC,kCAAkC,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;YAEzE,MAAM,QAAQ,GAAG,MAAM,uBAAuB,CAAC,WAAW,CAAC,CAAC;YAE5D,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;gBACtB,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,8BAA8B,CAAC,CAAC;YACpE,CAAC;YAED,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,IAAI,EAAE,CAAC;YAEpC,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,YAAY,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;oBAChC,IAAI,EAAE,CAAC,CAAC,IAAI;oBACZ,GAAG,EAAE,CAAC,CAAC,OAAO,EAAE,GAAG;oBACnB,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,IAAI;oBACrB,WAAW,EAAE,CAAC,CAAC,OAAO,EAAE,WAAW;oBACnC,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,IAAI;oBACrB,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE,KAAK;oBACvB,OAAO,EAAE,CAAC,CAAC,OAAO;iBACnB,CAAC,CAAC;gBACH,KAAK,EAAE,OAAO,CAAC,MAAM;aACtB,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,+BAA+B,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,EAAE,KAAc,CAAC,CAAC;YACtF,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAG,KAAe,CAAC,OAAO;gBAC/B,YAAY,EAAE,EAAE;aACjB,CAAC;QACJ,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/tools/admin/quick-actions/trigger-quick-action.d.ts

@@ -24,17 +24,15 @@ export declare const zudelloTriggerQuickAction: {
         resourceUuids: string[];
     }, authContext: AuthContext) => Promise<{
         success: boolean;
-        results: {
-            resourceUuid: string;
-            success: boolean;
-            message?: string;
-        }[];
+        succeeded: string[];
+        failed: string[];
         summary: string;
         error?: undefined;
     } | {
         success: boolean;
         error: string;
-        results: never[];
+        succeeded: never[];
+        failed: never[];
         summary?: undefined;
     }>;
 };

package/dist/tools/admin/quick-actions/trigger-quick-action.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"trigger-quick-action.d.ts","sourceRoot":"","sources":["../../../../src/tools/admin/quick-actions/trigger-quick-action.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;qBA0B3B;QACL,IAAI,EAAE,MAAM,CAAC;QACb,aAAa,EAAE,MAAM,EAAE,CAAC;KACzB,eACY,WAAW;;;;;;;;;;;;;;;CAgC3B,CAAC"}
+{"version":3,"file":"trigger-quick-action.d.ts","sourceRoot":"","sources":["../../../../src/tools/admin/quick-actions/trigger-quick-action.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;qBAuC3B;QACL,IAAI,EAAE,MAAM,CAAC;QACb,aAAa,EAAE,MAAM,EAAE,CAAC;KACzB,eACY,WAAW;;;;;;;;;;;;;CAqC3B,CAAC"}