@zudello/modelcontextprotocol 1.0.0 → 1.1.1

package/dist/tools/resources/update-or-create-resources.js

@@ -5,12 +5,43 @@ import { updateOrCreateZudelloResources } from "../../services/zudello/resources
  */
 export const zudelloUpdateOrCreateResources = {
     name: "zudelloUpdateOrCreateResources",
-    description: `Create or update multiple Zudello resources in a batch operation (upsert).
+    description: `Update existing resources or create new ones if not found (upsert operation).
 
-IMPORTANT: This is a write operation that modifies data. Use with caution.
-- Creates new resources if UUID not provided or doesn't exist
-- Updates existing resources if UUID matches
-- Supports all resource types: Transaction, Item, Customer, Supplier, etc.`,
+## Upsert Behavior
+Resources are identified by 'uuid' or 'external_id':
+- UUID provided + exists → updates the resource
+- UUID provided + doesn't exist → ignored (no-op, no error)
+- external_id provided + exists → updates the resource
+- external_id provided + doesn't exist → creates new resource
+- No unique key provided → creates new resource
+
+## Request Flags (per resource)
+- 'create': Allow creating if not found (default: true when set at top level)
+- 'update': Allow updating if found (default: true when set at top level)
+- 'fetch': Only fetch existing, don't create/update (mutually exclusive with update)
+- 'replace': For detail records (lines, tags) - replace all vs append
+
+## Relationship Management
+For M2M relations (tags, assignees, accounts):
+\`\`\`json
+{ "tags": { "replace": false, "items": [{ "data": { "uuid": "tag-uuid" }, "fetch": true }] } }
+\`\`\`
+For detail records (lines):
+\`\`\`json
+{ "lines": { "items": [{ "create": true, "data": { "description": "New line" } }] } }
+\`\`\`
+To delete a parent link, pass empty object: \`{ "supplier": {} }\`
+
+## Supported Models
+- Transaction: Include 'module' and 'submodule' in data (e.g., PURCHASING/INVOICE)
+- Item: INVENTORY/CATALOGUE context
+- Customer/Supplier/Employee: RELATIONSHIPS module
+- Dimensional models (Account, Department, etc.): DIMENSIONS module
+
+## Tips
+- Use 'simplified: true' for flat array format (no nested 'items' structure)
+- Use zudelloSearch first to find UUIDs before updating
+- Use zudelloGetModelSchema to understand required fields`,
     inputSchema: {
         type: "object",
         properties: {

package/dist/tools/resources/update-or-create-resources.js.map

@@ -1 +1 @@
-{"version":3,"file":"update-or-create-resources.js","sourceRoot":"","sources":["../../../src/tools/resources/update-or-create-resources.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,8BAA8B,EAAE,MAAM,qCAAqC,CAAC;AAGrF;;GAEG;AACH,MAAM,CAAC,MAAM,8BAA8B,GAAG;IAC5C,IAAI,EAAE,gCAAgC;IACtC,WAAW,EAAE;;;;;2EAK4D;IACzE,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,SAAS,EAAE;gBACT,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,WAAW,EAAE,+CAA+C;aAC7D;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,8BAA8B;aAC5C;SACF;QACD,QAAQ,EAAE,CAAC,WAAW,EAAE,OAAO,CAAC;KACjC;IACD,OAAO,EAAE,KAAK,EACZ,KAAmE,EACnE,WAAwB,EACxB,EAAE;QACF,IAAI,CAAC;YACH,MAAM,CAAC,IAAI,CAAC,yCAAyC,EAAE;gBACrD,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC,MAAM;gBAC7B,KAAK,EAAE,KAAK,CAAC,KAAK;aACnB,CAAC,CAAC;YAEH,kDAAkD;YAClD,MAAM,QAAQ,GAAG,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;gBAClD,KAAK,EAAE,KAAK,CAAC,KAAK;gBAClB,IAAI,EAAE,QAAQ;aACf,CAAC,CAAC,CAAC;YAEJ,MAAM,QAAQ,GAAG,MAAM,8BAA8B,CACnD,QAAQ,EACR,WAAW,EACX,EAAE,KAAK,EAAE,IAAI,EAAE,CAChB,CAAC;YAEF,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;gBACtB,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,sCAAsC,CAAC,CAAC;YAC5E,CAAC;YAED,MAAM,SAAS,GAAG,QAAQ,CAAC,IAAI,EAAE,SAAS,IAAI,EAAE,CAAC;YAEjD,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,SAAS;gBACT,KAAK,EAAE,SAAS,CAAC,MAAM;gBACvB,OAAO,EAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,IAAI,kCAAkC;aACtE,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,sCAAsC,EAAE;gBACnD,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC,MAAM;aAC9B,EAAE,KAAc,CAAC,CAAC;YACnB,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe;gBAC/D,SAAS,EAAE,IAAI;aAChB,CAAC;QACJ,CAAC;IACH,CAAC;CACF,CAAC"}
+{"version":3,"file":"update-or-create-resources.js","sourceRoot":"","sources":["../../../src/tools/resources/update-or-create-resources.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,8BAA8B,EAAE,MAAM,qCAAqC,CAAC;AAGrF;;GAEG;AACH,MAAM,CAAC,MAAM,8BAA8B,GAAG;IAC5C,IAAI,EAAE,gCAAgC;IACtC,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;0DAoC2C;IACxD,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,SAAS,EAAE;gBACT,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,WAAW,EAAE,+CAA+C;aAC7D;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,8BAA8B;aAC5C;SACF;QACD,QAAQ,EAAE,CAAC,WAAW,EAAE,OAAO,CAAC;KACjC;IACD,OAAO,EAAE,KAAK,EACZ,KAAmE,EACnE,WAAwB,EACxB,EAAE;QACF,IAAI,CAAC;YACH,MAAM,CAAC,IAAI,CAAC,yCAAyC,EAAE;gBACrD,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC,MAAM;gBAC7B,KAAK,EAAE,KAAK,CAAC,KAAK;aACnB,CAAC,CAAC;YAEH,kDAAkD;YAClD,MAAM,QAAQ,GAAG,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;gBAClD,KAAK,EAAE,KAAK,CAAC,KAAK;gBAClB,IAAI,EAAE,QAAQ;aACf,CAAC,CAAC,CAAC;YAEJ,MAAM,QAAQ,GAAG,MAAM,8BAA8B,CACnD,QAAQ,EACR,WAAW,EACX,EAAE,KAAK,EAAE,IAAI,EAAE,CAChB,CAAC;YAEF,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;gBACtB,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,sCAAsC,CAAC,CAAC;YAC5E,CAAC;YAED,MAAM,SAAS,GAAG,QAAQ,CAAC,IAAI,EAAE,SAAS,IAAI,EAAE,CAAC;YAEjD,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,SAAS;gBACT,KAAK,EAAE,SAAS,CAAC,MAAM;gBACvB,OAAO,EAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,IAAI,kCAAkC;aACtE,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,sCAAsC,EAAE;gBACnD,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC,MAAM;aAC9B,EAAE,KAAc,CAAC,CAAC;YACnB,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe;gBAC/D,SAAS,EAAE,IAAI;aAChB,CAAC;QACJ,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/tools/sentences/create-sentence.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-sentence.d.ts","sourceRoot":"","sources":["../../../src/tools/sentences/create-sentence.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEzD,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;qBAaT,GAAG,eAAe,WAAW;;;;;;;;;;;CAoBrD,CAAC"}
+{"version":3,"file":"create-sentence.d.ts","sourceRoot":"","sources":["../../../src/tools/sentences/create-sentence.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEzD,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;qBAkCT,GAAG,eAAe,WAAW;;;;;;;;;;;CAoBrD,CAAC"}

package/dist/tools/sentences/create-sentence.js

@@ -2,7 +2,28 @@ import { logger } from "../../utils/logger.js";
 import { createZudelloSentence } from "../../services/zudello/sentences.js";
 export const zudelloCreateSentence = {
     name: "zudelloCreateSentence",
-    description: "Create a new automation rule (sentence) - WRITE operation requiring approval",
+    description: `Create a new sentence automation rule in Zudello.
+
+A sentence contains a recipe with: trigger (when to fire), conditions (optional filters), and actions (what to do).
+
+BEFORE CREATING:
+1. Use listSentenceResources with resourceType 'ACTION_TEMPLATE' to get valid action payloads
+2. Use listSentenceResources with resourceType 'CONDITION_TEMPLATE' to get valid condition payloads
+3. Use listSentences or getSentence on existing sentences to understand recipe structure
+
+TRIGGER EVENT TYPES: submit, extract, approval, reject, complete, export, delete, restore, duplicate, merge, unmerge, assign, unassign, comment, attachment, status_change, field_change, line_change, tag_change, approval_change, budget_change, contract_change
+
+RECIPE STRUCTURE:
+{
+  "changeable": true,
+  "trigger": { "trigger": "TEAM_DATA", "event_type": "submit|extract|approval|...", "event_model": "Transaction", "module": "...", "submodule": "...", "enabled": true, "changeable": true },
+  "conditions": [...],  // Optional - from CONDITION_TEMPLATE
+  "actions": [...]      // Required - from ACTION_TEMPLATE
+}
+
+IMPORTANT: Sentence order matters! After creating, use updateSentencesOrder to position correctly. Include ALL module sentences when reordering.
+
+Valid modules: BUDGETS, CONTRACTS, EXPENSES, INVENTORY, PURCHASING, RELATIONSHIPS, SALES`,
     inputSchema: {
         type: "object",
         properties: {

package/dist/tools/sentences/create-sentence.js.map

@@ -1 +1 @@
-{"version":3,"file":"create-sentence.js","sourceRoot":"","sources":["../../../src/tools/sentences/create-sentence.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AAG5E,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,IAAI,EAAE,uBAAuB;IAC7B,WAAW,EAAE,8EAA8E;IAC3F,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,yBAAyB,EAAE;YAClE,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,wBAAwB,EAAE;YAClE,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE;YAClD,SAAS,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,6BAA6B,EAAE;SAC3E;QACD,QAAQ,EAAE,CAAC,QAAQ,EAAE,SAAS,EAAE,MAAM,CAAC;KACxC;IACD,OAAO,EAAE,KAAK,EAAE,KAAU,EAAE,WAAwB,EAAE,EAAE;QACtD,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,qBAAqB,CAC1C,WAAW,EACX,KAAK,CAAC,MAAM,EACZ,KAAK,CAAC,OAAO,EACb,KAAK,CAAC,IAAI,EACV,KAAK,CAAC,SAAS,IAAI,IAAI,CACxB,CAAC;YACF,IAAI,CAAC,QAAQ,CAAC,OAAO;gBAAE,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,2BAA2B,CAAC,CAAC;YACtF,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,QAAQ,EAAE,QAAQ,CAAC,IAAI;gBACvB,OAAO,EAAE,+BAA+B;aACzC,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,6BAA6B,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,EAAE,KAAc,CAAC,CAAC;YACtF,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAG,KAAe,CAAC,OAAO,EAAE,CAAC;QAC7D,CAAC;IACH,CAAC;CACF,CAAC"}
+{"version":3,"file":"create-sentence.js","sourceRoot":"","sources":["../../../src/tools/sentences/create-sentence.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AAG5E,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,IAAI,EAAE,uBAAuB;IAC7B,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;yFAqB0E;IACvF,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,yBAAyB,EAAE;YAClE,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,wBAAwB,EAAE;YAClE,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE;YAClD,SAAS,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,6BAA6B,EAAE;SAC3E;QACD,QAAQ,EAAE,CAAC,QAAQ,EAAE,SAAS,EAAE,MAAM,CAAC;KACxC;IACD,OAAO,EAAE,KAAK,EAAE,KAAU,EAAE,WAAwB,EAAE,EAAE;QACtD,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,qBAAqB,CAC1C,WAAW,EACX,KAAK,CAAC,MAAM,EACZ,KAAK,CAAC,OAAO,EACb,KAAK,CAAC,IAAI,EACV,KAAK,CAAC,SAAS,IAAI,IAAI,CACxB,CAAC;YACF,IAAI,CAAC,QAAQ,CAAC,OAAO;gBAAE,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,2BAA2B,CAAC,CAAC;YACtF,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,QAAQ,EAAE,QAAQ,CAAC,IAAI;gBACvB,OAAO,EAAE,+BAA+B;aACzC,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,6BAA6B,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,EAAE,KAAc,CAAC,CAAC;YACtF,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAG,KAAe,CAAC,OAAO,EAAE,CAAC;QAC7D,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/tools/sentences/get-sentence-template.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-sentence-template.d.ts","sourceRoot":"","sources":["../../../src/tools/sentences/get-sentence-template.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEzD,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;qBAWd;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,aAAa,CAAC,EAAE,OAAO,CAAA;KAAE,eAAe,WAAW;;;;;;;;;CAU3F,CAAC"}
+{"version":3,"file":"get-sentence-template.d.ts","sourceRoot":"","sources":["../../../src/tools/sentences/get-sentence-template.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEzD,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;qBAad;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,aAAa,CAAC,EAAE,OAAO,CAAA;KAAE,eAAe,WAAW;;;;;;;;;CAU3F,CAAC"}

package/dist/tools/sentences/get-sentence-template.js

@@ -2,7 +2,9 @@ import { logger } from "../../utils/logger.js";
 import { getZudelloSentenceTemplate } from "../../services/zudello/sentences.js";
 export const zudelloGetSentenceTemplate = {
     name: "zudelloGetSentenceTemplate",
-    description: "Get a sentence template by UUID (global templates for creating team sentences)",
+    description: `Get detailed payload for a specific sentence template from the global library.
+
+Sentence templates are pre-built automation rules that can be used as starting points for team sentences.`,
     inputSchema: {
         type: "object",
         properties: {

package/dist/tools/sentences/get-sentence-template.js.map

@@ -1 +1 @@
-{"version":3,"file":"get-sentence-template.js","sourceRoot":"","sources":["../../../src/tools/sentences/get-sentence-template.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,0BAA0B,EAAE,MAAM,qCAAqC,CAAC;AAGjF,MAAM,CAAC,MAAM,0BAA0B,GAAG;IACxC,IAAI,EAAE,4BAA4B;IAClC,WAAW,EAAE,gFAAgF;IAC7F,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,eAAe,EAAE;YACtD,aAAa,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,2BAA2B,EAAE;SAC7E;QACD,QAAQ,EAAE,CAAC,MAAM,CAAC;KACnB;IACD,OAAO,EAAE,KAAK,EAAE,KAAgD,EAAE,WAAwB,EAAE,EAAE;QAC5F,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,0BAA0B,CAAC,WAAW,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,aAAa,IAAI,KAAK,CAAC,CAAC;YACzG,IAAI,CAAC,QAAQ,CAAC,OAAO;gBAAE,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,wBAAwB,CAAC,CAAC;YACnF,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC;QACpD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,kCAAkC,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,EAAE,KAAc,CAAC,CAAC;YACvF,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAG,KAAe,CAAC,OAAO,EAAE,CAAC;QAC7D,CAAC;IACH,CAAC;CACF,CAAC"}
+{"version":3,"file":"get-sentence-template.js","sourceRoot":"","sources":["../../../src/tools/sentences/get-sentence-template.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,0BAA0B,EAAE,MAAM,qCAAqC,CAAC;AAGjF,MAAM,CAAC,MAAM,0BAA0B,GAAG;IACxC,IAAI,EAAE,4BAA4B;IAClC,WAAW,EAAE;;0GAE2F;IACxG,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,eAAe,EAAE;YACtD,aAAa,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,2BAA2B,EAAE;SAC7E;QACD,QAAQ,EAAE,CAAC,MAAM,CAAC;KACnB;IACD,OAAO,EAAE,KAAK,EAAE,KAAgD,EAAE,WAAwB,EAAE,EAAE;QAC5F,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,0BAA0B,CAAC,WAAW,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,aAAa,IAAI,KAAK,CAAC,CAAC;YACzG,IAAI,CAAC,QAAQ,CAAC,OAAO;gBAAE,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,wBAAwB,CAAC,CAAC;YACnF,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC;QACpD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,kCAAkC,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,EAAE,KAAc,CAAC,CAAC;YACvF,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAG,KAAe,CAAC,OAAO,EAAE,CAAC;QAC7D,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/tools/sentences/get-sentence.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-sentence.d.ts","sourceRoot":"","sources":["../../../src/tools/sentences/get-sentence.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEzD,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;qBAWN;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,aAAa,CAAC,EAAE,OAAO,CAAA;KAAE,eAAe,WAAW;;;;;;;;;CAU3F,CAAC"}
+{"version":3,"file":"get-sentence.d.ts","sourceRoot":"","sources":["../../../src/tools/sentences/get-sentence.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEzD,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;qBAaN;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,aAAa,CAAC,EAAE,OAAO,CAAA;KAAE,eAAe,WAAW;;;;;;;;;CAU3F,CAAC"}

package/dist/tools/sentences/get-sentence.js

@@ -2,7 +2,9 @@ import { logger } from "../../utils/logger.js";
 import { getZudelloSentence } from "../../services/zudello/sentences.js";
 export const zudelloGetSentence = {
     name: "zudelloGetSentence",
-    description: "Get a specific automation rule (sentence) by UUID",
+    description: `Get detailed payload for a specific sentence automation rule in Zudello.
+
+Sentences are automation rules that trigger actions based on conditions. They contain a recipe with triggers, conditions, and actions.`,
     inputSchema: {
         type: "object",
         properties: {

package/dist/tools/sentences/get-sentence.js.map

@@ -1 +1 @@
-{"version":3,"file":"get-sentence.js","sourceRoot":"","sources":["../../../src/tools/sentences/get-sentence.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AAGzE,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,IAAI,EAAE,oBAAoB;IAC1B,WAAW,EAAE,mDAAmD;IAChE,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,eAAe,EAAE;YACtD,aAAa,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,2BAA2B,EAAE;SAC7E;QACD,QAAQ,EAAE,CAAC,MAAM,CAAC;KACnB;IACD,OAAO,EAAE,KAAK,EAAE,KAAgD,EAAE,WAAwB,EAAE,EAAE;QAC5F,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,kBAAkB,CAAC,WAAW,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,aAAa,IAAI,KAAK,CAAC,CAAC;YACjG,IAAI,CAAC,QAAQ,CAAC,OAAO;gBAAE,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,wBAAwB,CAAC,CAAC;YACnF,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC;QACpD,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,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAG,KAAe,CAAC,OAAO,EAAE,CAAC;QAC7D,CAAC;IACH,CAAC;CACF,CAAC"}
+{"version":3,"file":"get-sentence.js","sourceRoot":"","sources":["../../../src/tools/sentences/get-sentence.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AAGzE,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,IAAI,EAAE,oBAAoB;IAC1B,WAAW,EAAE;;uIAEwH;IACrI,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,eAAe,EAAE;YACtD,aAAa,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,2BAA2B,EAAE;SAC7E;QACD,QAAQ,EAAE,CAAC,MAAM,CAAC;KACnB;IACD,OAAO,EAAE,KAAK,EAAE,KAAgD,EAAE,WAAwB,EAAE,EAAE;QAC5F,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,kBAAkB,CAAC,WAAW,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,aAAa,IAAI,KAAK,CAAC,CAAC;YACjG,IAAI,CAAC,QAAQ,CAAC,OAAO;gBAAE,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,wBAAwB,CAAC,CAAC;YACnF,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC;QACpD,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,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAG,KAAe,CAAC,OAAO,EAAE,CAAC;QAC7D,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/tools/sentences/list-sentence-resources.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"list-sentence-resources.d.ts","sourceRoot":"","sources":["../../../src/tools/sentences/list-sentence-resources.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEzD,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;qBAehB;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,eAAe,WAAW;;;;;;;;;qBAemnO,CAAC;sBAAqC,CAAC;wBAAyB,CAAC;;;;;;;;;;;CAD9wO,CAAC"}
+{"version":3,"file":"list-sentence-resources.d.ts","sourceRoot":"","sources":["../../../src/tools/sentences/list-sentence-resources.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEzD,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;qBAyBhB;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,eAAe,WAAW;;;;;;;;;qBAeqpN,CAAC;sBAAqC,CAAC;wBAAyB,CAAC;;;;;;;;;;;CADhzN,CAAC"}

package/dist/tools/sentences/list-sentence-resources.js

@@ -2,7 +2,17 @@ import { logger } from "../../utils/logger.js";
 import { listZudelloSentenceResources } from "../../services/zudello/sentences.js";
 export const zudelloListSentenceResources = {
     name: "zudelloListSentenceResources",
-    description: "List action or condition templates for sentences (building blocks for automation rules)",
+    description: `List available action or condition templates for building sentence automation rules.
+
+Call this BEFORE creating sentences to understand valid actions and conditions.
+
+Resource types:
+- ACTION_TEMPLATE: Available actions (ASSIGN, COMPLETE, SET_STATUS, GET_APPROVAL, SEND_EMAIL, etc.)
+- CONDITION_TEMPLATE: Available conditions (VARIANCE_AMOUNT, APPROVED_TRUE, ALLOCATION_PO, etc.)
+
+Returns the full payload structure for each template, including required fields and operators.
+
+Valid modules: BUDGETS, CONTRACTS, EXPENSES, INVENTORY, PURCHASING, RELATIONSHIPS, SALES`,
     inputSchema: {
         type: "object",
         properties: {

package/dist/tools/sentences/list-sentence-resources.js.map

@@ -1 +1 @@
-{"version":3,"file":"list-sentence-resources.js","sourceRoot":"","sources":["../../../src/tools/sentences/list-sentence-resources.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,4BAA4B,EAAE,MAAM,qCAAqC,CAAC;AAGnF,MAAM,CAAC,MAAM,4BAA4B,GAAG;IAC1C,IAAI,EAAE,8BAA8B;IACpC,WAAW,EAAE,yFAAyF;IACtG,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,YAAY,EAAE;gBACZ,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,CAAC,iBAAiB,EAAE,oBAAoB,CAAC;gBAC/C,WAAW,EAAE,2BAA2B;aACzC;YACD,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,eAAe,EAAE;SACzD;QACD,QAAQ,EAAE,CAAC,cAAc,EAAE,QAAQ,CAAC;KACrC;IACD,OAAO,EAAE,KAAK,EAAE,KAA+C,EAAE,WAAwB,EAAE,EAAE;QAC3F,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,4BAA4B,CACjD,WAAW,EACX,KAAK,CAAC,YAAmB,EACzB,KAAK,CAAC,MAAM,CACb,CAAC;YACF,IAAI,CAAC,QAAQ,CAAC,OAAO;gBAAE,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,0BAA0B,CAAC,CAAC;YACrF,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,CAAC,IAAI,EAAE,KAAK,EAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,IAAI,CAAC,EAAE,CAAC;QACxF,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,oCAAoC,EAAE,KAAK,EAAE,KAAc,CAAC,CAAC;YAC1E,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAG,KAAe,CAAC,OAAO,EAAE,CAAC;QAC7D,CAAC;IACH,CAAC;CACF,CAAC"}
+{"version":3,"file":"list-sentence-resources.js","sourceRoot":"","sources":["../../../src/tools/sentences/list-sentence-resources.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,4BAA4B,EAAE,MAAM,qCAAqC,CAAC;AAGnF,MAAM,CAAC,MAAM,4BAA4B,GAAG;IAC1C,IAAI,EAAE,8BAA8B;IACpC,WAAW,EAAE;;;;;;;;;;yFAU0E;IACvF,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,YAAY,EAAE;gBACZ,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,CAAC,iBAAiB,EAAE,oBAAoB,CAAC;gBAC/C,WAAW,EAAE,2BAA2B;aACzC;YACD,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,eAAe,EAAE;SACzD;QACD,QAAQ,EAAE,CAAC,cAAc,EAAE,QAAQ,CAAC;KACrC;IACD,OAAO,EAAE,KAAK,EAAE,KAA+C,EAAE,WAAwB,EAAE,EAAE;QAC3F,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,4BAA4B,CACjD,WAAW,EACX,KAAK,CAAC,YAAmB,EACzB,KAAK,CAAC,MAAM,CACb,CAAC;YACF,IAAI,CAAC,QAAQ,CAAC,OAAO;gBAAE,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,0BAA0B,CAAC,CAAC;YACrF,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,CAAC,IAAI,EAAE,KAAK,EAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,IAAI,CAAC,EAAE,CAAC;QACxF,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,oCAAoC,EAAE,KAAK,EAAE,KAAc,CAAC,CAAC;YAC1E,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAG,KAAe,CAAC,OAAO,EAAE,CAAC;QAC7D,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/tools/sentences/list-sentence-templates.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"list-sentence-templates.d.ts","sourceRoot":"","sources":["../../../src/tools/sentences/list-sentence-templates.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEzD,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;qBAWhB;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,eAAe,WAAW;;;;;;;;;;;CAUxF,CAAC"}
+{"version":3,"file":"list-sentence-templates.d.ts","sourceRoot":"","sources":["../../../src/tools/sentences/list-sentence-templates.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEzD,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;qBAehB;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,eAAe,WAAW;;;;;;;;;;;CAUxF,CAAC"}

package/dist/tools/sentences/list-sentence-templates.js

@@ -2,7 +2,11 @@ import { logger } from "../../utils/logger.js";
 import { listZudelloSentenceTemplates } from "../../services/zudello/sentences.js";
 export const zudelloListSentenceTemplates = {
     name: "zudelloListSentenceTemplates",
-    description: "List sentence templates for a module (global templates for creating team sentences)",
+    description: `List sentence templates from the global library for a specific module.
+
+These are pre-built automation rules that can be used as starting points.
+
+Valid modules: BUDGETS, CONTRACTS, EXPENSES, INVENTORY, PURCHASING, RELATIONSHIPS, SALES`,
     inputSchema: {
         type: "object",
         properties: {

package/dist/tools/sentences/list-sentence-templates.js.map

@@ -1 +1 @@
-{"version":3,"file":"list-sentence-templates.js","sourceRoot":"","sources":["../../../src/tools/sentences/list-sentence-templates.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,4BAA4B,EAAE,MAAM,qCAAqC,CAAC;AAGnF,MAAM,CAAC,MAAM,4BAA4B,GAAG;IAC1C,IAAI,EAAE,8BAA8B;IACpC,WAAW,EAAE,qFAAqF;IAClG,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,eAAe,EAAE;YACxD,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,kBAAkB,EAAE;SAC/D;QACD,QAAQ,EAAE,CAAC,QAAQ,CAAC;KACrB;IACD,OAAO,EAAE,KAAK,EAAE,KAA6C,EAAE,WAAwB,EAAE,EAAE;QACzF,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,4BAA4B,CAAC,WAAW,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;YAChG,IAAI,CAAC,QAAQ,CAAC,OAAO;gBAAE,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,0BAA0B,CAAC,CAAC;YACrF,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,CAAC,IAAI,EAAE,KAAK,EAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,IAAI,CAAC,EAAE,CAAC;QACxF,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,oCAAoC,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,EAAE,KAAc,CAAC,CAAC;YAC7F,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAG,KAAe,CAAC,OAAO,EAAE,CAAC;QAC7D,CAAC;IACH,CAAC;CACF,CAAC"}
+{"version":3,"file":"list-sentence-templates.js","sourceRoot":"","sources":["../../../src/tools/sentences/list-sentence-templates.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,4BAA4B,EAAE,MAAM,qCAAqC,CAAC;AAGnF,MAAM,CAAC,MAAM,4BAA4B,GAAG;IAC1C,IAAI,EAAE,8BAA8B;IACpC,WAAW,EAAE;;;;yFAI0E;IACvF,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,eAAe,EAAE;YACxD,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,kBAAkB,EAAE;SAC/D;QACD,QAAQ,EAAE,CAAC,QAAQ,CAAC;KACrB;IACD,OAAO,EAAE,KAAK,EAAE,KAA6C,EAAE,WAAwB,EAAE,EAAE;QACzF,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,4BAA4B,CAAC,WAAW,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;YAChG,IAAI,CAAC,QAAQ,CAAC,OAAO;gBAAE,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,0BAA0B,CAAC,CAAC;YACrF,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,CAAC,IAAI,EAAE,KAAK,EAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,IAAI,CAAC,EAAE,CAAC;QACxF,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,oCAAoC,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,EAAE,KAAc,CAAC,CAAC;YAC7F,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAG,KAAe,CAAC,OAAO,EAAE,CAAC;QAC7D,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/tools/sentences/list-sentences.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"list-sentences.d.ts","sourceRoot":"","sources":["../../../src/tools/sentences/list-sentences.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEzD,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBAcR,GAAG,eAAe,WAAW;;;;;;;;;;;CAerD,CAAC"}
+{"version":3,"file":"list-sentences.d.ts","sourceRoot":"","sources":["../../../src/tools/sentences/list-sentences.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEzD,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBAoBR,GAAG,eAAe,WAAW;;;;;;;;;;;CAerD,CAAC"}

package/dist/tools/sentences/list-sentences.js

@@ -2,7 +2,13 @@ import { logger } from "../../utils/logger.js";
 import { listZudelloSentences } from "../../services/zudello/sentences.js";
 export const zudelloListSentences = {
     name: "zudelloListSentences",
-    description: "List automation rules (sentences) for a module. Sentences are evaluated top-to-bottom.",
+    description: `List sentence automation rules for a specific module.
+
+Returns sentences from either the team library (isTemplate=false) or global template library (isTemplate=true).
+
+Note: Sentences are filtered by module only. If submodule is provided, results will be filtered client-side.
+
+Valid modules: BUDGETS, CONTRACTS, EXPENSES, INVENTORY, PURCHASING, RELATIONSHIPS, SALES`,
     inputSchema: {
         type: "object",
         properties: {

package/dist/tools/sentences/list-sentences.js.map

@@ -1 +1 @@
-{"version":3,"file":"list-sentences.js","sourceRoot":"","sources":["../../../src/tools/sentences/list-sentences.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAG3E,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,IAAI,EAAE,sBAAsB;IAC5B,WAAW,EAAE,wFAAwF;IACrG,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,4CAA4C,EAAE;YACrF,UAAU,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,iDAAiD,EAAE;YAC/F,OAAO,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,0BAA0B,EAAE;YACrE,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,0BAA0B,EAAE;YACjE,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,gCAAgC,EAAE;SAC3E;QACD,QAAQ,EAAE,CAAC,QAAQ,CAAC;KACrB;IACD,OAAO,EAAE,KAAK,EAAE,KAAU,EAAE,WAAwB,EAAE,EAAE;QACtD,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,oBAAoB,CAAC,WAAW,EAAE,KAAK,CAAC,MAAM,EAAE;gBACrE,UAAU,EAAE,KAAK,CAAC,UAAU;gBAC5B,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,OAAO,EAAE,KAAK,CAAC,OAAO;aACvB,CAAC,CAAC;YACH,IAAI,CAAC,QAAQ,CAAC,OAAO;gBAAE,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,0BAA0B,CAAC,CAAC;YACrF,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,CAAC,IAAI,EAAE,KAAK,EAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,IAAI,CAAC,EAAE,CAAC;QACxF,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,4BAA4B,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,EAAE,KAAc,CAAC,CAAC;YACrF,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAG,KAAe,CAAC,OAAO,EAAE,CAAC;QAC7D,CAAC;IACH,CAAC;CACF,CAAC"}
+{"version":3,"file":"list-sentences.js","sourceRoot":"","sources":["../../../src/tools/sentences/list-sentences.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAG3E,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,IAAI,EAAE,sBAAsB;IAC5B,WAAW,EAAE;;;;;;yFAM0E;IACvF,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,4CAA4C,EAAE;YACrF,UAAU,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,iDAAiD,EAAE;YAC/F,OAAO,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,0BAA0B,EAAE;YACrE,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,0BAA0B,EAAE;YACjE,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,gCAAgC,EAAE;SAC3E;QACD,QAAQ,EAAE,CAAC,QAAQ,CAAC;KACrB;IACD,OAAO,EAAE,KAAK,EAAE,KAAU,EAAE,WAAwB,EAAE,EAAE;QACtD,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,oBAAoB,CAAC,WAAW,EAAE,KAAK,CAAC,MAAM,EAAE;gBACrE,UAAU,EAAE,KAAK,CAAC,UAAU;gBAC5B,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,OAAO,EAAE,KAAK,CAAC,OAAO;aACvB,CAAC,CAAC;YACH,IAAI,CAAC,QAAQ,CAAC,OAAO;gBAAE,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,0BAA0B,CAAC,CAAC;YACrF,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,CAAC,IAAI,EAAE,KAAK,EAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,IAAI,CAAC,EAAE,CAAC;QACxF,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,4BAA4B,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,EAAE,KAAc,CAAC,CAAC;YACrF,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAG,KAAe,CAAC,OAAO,EAAE,CAAC;QAC7D,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/tools/sentences/update-sentence.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"update-sentence.d.ts","sourceRoot":"","sources":["../../../src/tools/sentences/update-sentence.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEzD,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;qBAWT;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,eAAe,WAAW;;;;;;;;;;;CAcpG,CAAC"}
+{"version":3,"file":"update-sentence.d.ts","sourceRoot":"","sources":["../../../src/tools/sentences/update-sentence.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEzD,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;qBAkCT;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,eAAe,WAAW;;;;;;;;;;;CAcpG,CAAC"}

package/dist/tools/sentences/update-sentence.js

@@ -2,7 +2,30 @@ import { logger } from "../../utils/logger.js";
 import { updateZudelloSentence } from "../../services/zudello/sentences.js";
 export const zudelloUpdateSentence = {
     name: "zudelloUpdateSentence",
-    description: "Update an existing automation rule (sentence) - WRITE operation requiring approval",
+    description: `Update an existing sentence automation rule in Zudello.
+
+WORKFLOW:
+1. First call getSentence to get the current sentence state
+2. Modify only the fields you need to change
+3. Pass the complete modified object to this tool
+
+The API auto-increments the version (e.g., 1.0.0 → 1.0.1).
+
+COMMON MODIFICATIONS:
+- Change enabled state: Set "enabled": true/false
+- Modify actions: Update recipe.actions array (use listSentenceResources for valid payloads)
+- Modify conditions: Update recipe.conditions array
+- Change trigger: Update recipe.trigger (event_type, module, submodule)
+
+TRIGGER EVENT TYPES: submit, extract, approval, reject, complete, export, delete, restore, duplicate, merge, unmerge, assign, unassign, comment, attachment, status_change, field_change, line_change, tag_change, approval_change, budget_change, contract_change
+
+IMPORTANT:
+- Pass the COMPLETE sentence object, not just changed fields
+- The submodule in top-level and recipe.trigger should match
+- If changing evalOrder, you may need to use updateSentencesOrder to reposition
+- Use listSentenceResources to get valid action/condition payloads
+
+Valid modules: BUDGETS, CONTRACTS, EXPENSES, INVENTORY, PURCHASING, RELATIONSHIPS, SALES`,
     inputSchema: {
         type: "object",
         properties: {

package/dist/tools/sentences/update-sentence.js.map

@@ -1 +1 @@
-{"version":3,"file":"update-sentence.js","sourceRoot":"","sources":["../../../src/tools/sentences/update-sentence.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AAG5E,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,IAAI,EAAE,uBAAuB;IAC7B,WAAW,EAAE,oFAAoF;IACjG,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,eAAe,EAAE;YACtD,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,gCAAgC,EAAE;SAC3E;QACD,QAAQ,EAAE,CAAC,MAAM,EAAE,SAAS,CAAC;KAC9B;IACD,OAAO,EAAE,KAAK,EAAE,KAAyD,EAAE,WAAwB,EAAE,EAAE;QACrG,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,qBAAqB,CAAC,WAAW,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;YACrF,IAAI,CAAC,QAAQ,CAAC,OAAO;gBAAE,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,2BAA2B,CAAC,CAAC;YACtF,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,QAAQ,EAAE,QAAQ,CAAC,IAAI;gBACvB,OAAO,EAAE,+BAA+B;aACzC,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,6BAA6B,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,EAAE,KAAc,CAAC,CAAC;YAClF,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAG,KAAe,CAAC,OAAO,EAAE,CAAC;QAC7D,CAAC;IACH,CAAC;CACF,CAAC"}
+{"version":3,"file":"update-sentence.js","sourceRoot":"","sources":["../../../src/tools/sentences/update-sentence.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AAG5E,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,IAAI,EAAE,uBAAuB;IAC7B,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;;yFAuB0E;IACvF,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,eAAe,EAAE;YACtD,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,gCAAgC,EAAE;SAC3E;QACD,QAAQ,EAAE,CAAC,MAAM,EAAE,SAAS,CAAC;KAC9B;IACD,OAAO,EAAE,KAAK,EAAE,KAAyD,EAAE,WAAwB,EAAE,EAAE;QACrG,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,qBAAqB,CAAC,WAAW,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;YACrF,IAAI,CAAC,QAAQ,CAAC,OAAO;gBAAE,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,2BAA2B,CAAC,CAAC;YACtF,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,QAAQ,EAAE,QAAQ,CAAC,IAAI;gBACvB,OAAO,EAAE,+BAA+B;aACzC,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,6BAA6B,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,EAAE,KAAc,CAAC,CAAC;YAClF,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAG,KAAe,CAAC,OAAO,EAAE,CAAC;QAC7D,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/tools/sentences/update-sentences-order.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"update-sentences-order.d.ts","sourceRoot":"","sources":["../../../src/tools/sentences/update-sentences-order.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEzD,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;qBAcf;QAAE,SAAS,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE,eAAe,WAAW;;;;;;;;;CAavG,CAAC"}
+{"version":3,"file":"update-sentences-order.d.ts","sourceRoot":"","sources":["../../../src/tools/sentences/update-sentences-order.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEzD,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;qBA6Bf;QAAE,SAAS,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE,eAAe,WAAW;;;;;;;;;CAavG,CAAC"}

package/dist/tools/sentences/update-sentences-order.js

@@ -2,7 +2,22 @@ import { logger } from "../../utils/logger.js";
 import { updateZudelloSentencesOrder } from "../../services/zudello/sentences.js";
 export const zudelloUpdateSentencesOrder = {
     name: "zudelloUpdateSentencesOrder",
-    description: "Update sentence evaluation order - CRITICAL as sentences are evaluated top-to-bottom",
+    description: `Update the evaluation order of sentences for a module.
+
+CRITICAL: Sentence order determines evaluation sequence - sentences are processed top-to-bottom (order 0 first, then 1, 2, etc.). Incorrect ordering can break automation workflows.
+
+IMPORTANT REQUIREMENTS:
+1. You MUST include ALL sentences for the module, not just a submodule subset
+2. First call listSentences with the module (without submodule filter) to get all current sentences
+3. Include every sentence UUID in the new order, even if you're only moving one sentence
+4. Order values should be sequential integers starting from 0
+
+Example workflow:
+1. listSentences({module: "PURCHASING"}) - get all sentences for module
+2. Determine the desired new order
+3. Call this tool with ALL sentence UUIDs and their new order values
+
+Valid modules: BUDGETS, CONTRACTS, EXPENSES, INVENTORY, PURCHASING, RELATIONSHIPS, SALES`,
     inputSchema: {
         type: "object",
         properties: {

package/dist/tools/sentences/update-sentences-order.js.map

@@ -1 +1 @@
-{"version":3,"file":"update-sentences-order.js","sourceRoot":"","sources":["../../../src/tools/sentences/update-sentences-order.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,2BAA2B,EAAE,MAAM,qCAAqC,CAAC;AAGlF,MAAM,CAAC,MAAM,2BAA2B,GAAG;IACzC,IAAI,EAAE,6BAA6B;IACnC,WAAW,EAAE,sFAAsF;IACnG,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,SAAS,EAAE;gBACT,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,WAAW,EAAE,gEAAgE;aAC9E;SACF;QACD,QAAQ,EAAE,CAAC,WAAW,CAAC;KACxB;IACD,OAAO,EAAE,KAAK,EAAE,KAA4D,EAAE,WAAwB,EAAE,EAAE;QACxG,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,2BAA2B,CAAC,WAAW,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;YACjF,IAAI,CAAC,QAAQ,CAAC,OAAO;gBAAE,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,wBAAwB,CAAC,CAAC;YACnF,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE,qBAAqB,KAAK,CAAC,SAAS,CAAC,MAAM,YAAY;aACjE,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,mCAAmC,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC,MAAM,EAAE,EAAE,KAAc,CAAC,CAAC;YACrG,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAG,KAAe,CAAC,OAAO,EAAE,CAAC;QAC7D,CAAC;IACH,CAAC;CACF,CAAC"}
+{"version":3,"file":"update-sentences-order.js","sourceRoot":"","sources":["../../../src/tools/sentences/update-sentences-order.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,2BAA2B,EAAE,MAAM,qCAAqC,CAAC;AAGlF,MAAM,CAAC,MAAM,2BAA2B,GAAG;IACzC,IAAI,EAAE,6BAA6B;IACnC,WAAW,EAAE;;;;;;;;;;;;;;;yFAe0E;IACvF,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,SAAS,EAAE;gBACT,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,WAAW,EAAE,gEAAgE;aAC9E;SACF;QACD,QAAQ,EAAE,CAAC,WAAW,CAAC;KACxB;IACD,OAAO,EAAE,KAAK,EAAE,KAA4D,EAAE,WAAwB,EAAE,EAAE;QACxG,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,2BAA2B,CAAC,WAAW,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;YACjF,IAAI,CAAC,QAAQ,CAAC,OAAO;gBAAE,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,wBAAwB,CAAC,CAAC;YACnF,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE,qBAAqB,KAAK,CAAC,SAAS,CAAC,MAAM,YAAY;aACjE,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,mCAAmC,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC,MAAM,EAAE,EAAE,KAAc,CAAC,CAAC;YACrG,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAG,KAAe,CAAC,OAAO,EAAE,CAAC;QAC7D,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/tools/users/get-user-groups.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-user-groups.d.ts","sourceRoot":"","sources":["../../../src/tools/users/get-user-groups.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEzD,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;qBAaR;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,eAAe,WAAW;;;;;;;;;;;;;;;;CAcrF,CAAC"}
+{"version":3,"file":"get-user-groups.d.ts","sourceRoot":"","sources":["../../../src/tools/users/get-user-groups.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEzD,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;qBAsCR;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,eAAe,WAAW;;;;;;;;;;;;;;;;CAcrF,CAAC"}

package/dist/tools/users/get-user-groups.js

@@ -2,10 +2,35 @@ import { logger } from "../../utils/logger.js";
 import { getZudelloUserGroups } from "../../services/zudello/users.js";
 export const zudelloGetUserGroups = {
     name: "zudelloGetUserGroups",
-    description: `Get user groups for the team.
+    description: `Retrieve user groups for the current team with smart filtering capabilities.
 
-Returns user group information including names and descriptions.
-Use when user asks about team groups or group membership.`,
+User groups are used for access control, approval workflows, and task assignment in Zudello.
+Each group has a name, description, type, and optionally a list of member user IDs.
+
+KEY FEATURES:
+- Smart filtering: Filter by status, type, name patterns, or general search
+- Performance optimized: Member ID lists excluded by default (use includeMemberIds: true when needed)
+- Pagination support: Handle large datasets with limit/offset parameters
+
+FILTERING OPTIONS:
+- status: Filter by ACTIVE/INACTIVE groups
+- userGroupType: Filter by type like 'LEGACY', 'ACCESS', 'APPROVAL'
+- search: Search across group names and descriptions
+- namePattern: Target specific name patterns (e.g., "Admin", "Project")
+- includeMemberIds: Include user ID arrays (default: false for performance)
+
+COMMON USE CASES:
+- List all active groups: {status: "ACTIVE"}
+- Find admin groups: {namePattern: "admin"}
+- Search for project groups: {search: "project"}
+- Get finance groups with members: {namePattern: "finance", includeMemberIds: true}
+- Find approval groups: {userGroupType: "APPROVAL"}
+
+RESPONSE INCLUDES:
+- Group details: UUID, name, description, status, type
+- Member count: Number of users in each group
+- Member IDs: Only when includeMemberIds is true
+- Pagination metadata: Total count, returned count, offset, limit`,
     inputSchema: {
         type: "object",
         properties: {

package/dist/tools/users/get-user-groups.js.map

@@ -1 +1 @@
-{"version":3,"file":"get-user-groups.js","sourceRoot":"","sources":["../../../src/tools/users/get-user-groups.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AAGvE,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,IAAI,EAAE,sBAAsB;IAC5B,WAAW,EAAE;;;0DAG2C;IACxD,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,sCAAsC,EAAE;YAC9E,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,6BAA6B,EAAE;SACvE;KACF;IACD,OAAO,EAAE,KAAK,EAAE,KAA0C,EAAE,WAAwB,EAAE,EAAE;QACtF,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,oBAAoB,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;YAChE,IAAI,CAAC,QAAQ,CAAC,OAAO;gBAAE,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,2BAA2B,CAAC,CAAC;YACtF,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,UAAU,EAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,IAAI,EAAE;gBAC3C,QAAQ,EAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ;aAClC,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,4BAA4B,EAAE,KAAK,EAAE,KAAc,CAAC,CAAC;YAClE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAG,KAAe,CAAC,OAAO,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC;QAC7E,CAAC;IACH,CAAC;CACF,CAAC"}
+{"version":3,"file":"get-user-groups.js","sourceRoot":"","sources":["../../../src/tools/users/get-user-groups.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AAGvE,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,IAAI,EAAE,sBAAsB;IAC5B,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;kEA4BmD;IAChE,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,sCAAsC,EAAE;YAC9E,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,6BAA6B,EAAE;SACvE;KACF;IACD,OAAO,EAAE,KAAK,EAAE,KAA0C,EAAE,WAAwB,EAAE,EAAE;QACtF,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,oBAAoB,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;YAChE,IAAI,CAAC,QAAQ,CAAC,OAAO;gBAAE,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,2BAA2B,CAAC,CAAC;YACtF,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,UAAU,EAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,IAAI,EAAE;gBAC3C,QAAQ,EAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ;aAClC,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,4BAA4B,EAAE,KAAK,EAAE,KAAc,CAAC,CAAC;YAClE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAG,KAAe,CAAC,OAAO,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC;QAC7E,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/tools/users/get-users.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-users.d.ts","sourceRoot":"","sources":["../../../src/tools/users/get-users.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEzD,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBAkBjB;QACL,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,eACY,WAAW;;;;;;;;;;;;;;;;;;;;;;;;CAwB3B,CAAC"}
+{"version":3,"file":"get-users.d.ts","sourceRoot":"","sources":["../../../src/tools/users/get-users.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEzD,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBAiDjB;QACL,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,eACY,WAAW;;;;;;;;;;;;;;;;;;;;;;;;CAwB3B,CAAC"}

package/dist/tools/users/get-users.js

@@ -2,10 +2,41 @@ import { logger } from "../../utils/logger.js";
 import { getZudelloUsers } from "../../services/zudello/users.js";
 export const zudelloGetUsers = {
     name: "zudelloGetUsers",
-    description: `Get team users with filtering and pagination.
+    description: `Retrieve team users with smart filtering capabilities.
 
-Returns user information including names, emails, status, and avatars.
-Supports filtering by status, name patterns, email domains, and general search.`,
+Team users represent people who have access to the Zudello system for this team.
+Each user has personal information, email, avatar, and status.
+
+KEY FEATURES:
+- Smart filtering: Filter by status, names, email patterns, or general search
+- Flexible search: Search across names and emails simultaneously
+- Domain filtering: Find users by email domain (e.g., employees vs contractors)
+- Pagination support: Handle large user lists efficiently
+
+FILTERING OPTIONS:
+- status: Filter by ACTIVE/INACTIVE users
+- search: Search across first name, last name, and email
+- namePattern: Target specific name patterns (e.g., "John", "Smith")
+- emailDomain: Filter by email domain (e.g., "@company.com", "@contractor.com")
+
+COMMON USE CASES:
+- List all active users: {status: "ACTIVE"}
+- Find users named John: {namePattern: "john"}
+- Search for finance team: {search: "finance"}
+- Get all contractors: {emailDomain: "@contractor.com"}
+- Find specific user: {search: "john.smith@company.com"}
+- List employees only: {emailDomain: "@company.com"}
+
+RESPONSE INCLUDES:
+- User details: UUID, first name, last name, email
+- Status: ACTIVE or INACTIVE
+- Avatar: Profile picture URL (if available)
+- Pagination metadata: Total count, returned count, offset, limit
+
+TYPICAL WORKFLOW:
+1. Search broadly first: {search: "john"}
+2. Narrow down with specific filters: {namePattern: "john", emailDomain: "@company.com"}
+3. Use pagination for large result sets: {limit: 50, offset: 0}`,
     inputSchema: {
         type: "object",
         properties: {

package/dist/tools/users/get-users.js.map

@@ -1 +1 @@
-{"version":3,"file":"get-users.js","sourceRoot":"","sources":["../../../src/tools/users/get-users.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAGlE,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,IAAI,EAAE,iBAAiB;IACvB,WAAW,EAAE;;;gFAGiE;IAC9E,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,oCAAoC,EAAE;YAC7E,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,gCAAgC,EAAE;YACzE,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,wBAAwB,EAAE;YACtE,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,wBAAwB,EAAE;YACtE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,4BAA4B,EAAE;YACpE,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,mBAAmB,EAAE;SAC7D;KACF;IACD,OAAO,EAAE,KAAK,EACZ,KAOC,EACD,WAAwB,EACxB,EAAE;QACF,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,eAAe,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;YAC3D,IAAI,CAAC,QAAQ,CAAC,OAAO;gBAAE,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,qBAAqB,CAAC,CAAC;YAChF,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC;YACzC,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;oBACvB,IAAI,EAAE,CAAC,CAAC,IAAI;oBACZ,SAAS,EAAE,CAAC,CAAC,UAAU;oBACvB,QAAQ,EAAE,CAAC,CAAC,SAAS;oBACrB,QAAQ,EAAE,GAAG,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE;oBACjD,KAAK,EAAE,CAAC,CAAC,KAAK;oBACd,MAAM,EAAE,CAAC,CAAC,MAAM;oBAChB,MAAM,EAAE,CAAC,CAAC,MAAM;iBACjB,CAAC,CAAC;gBACH,QAAQ,EAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ;aAClC,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,uBAAuB,EAAE,KAAK,EAAE,KAAc,CAAC,CAAC;YAC7D,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAG,KAAe,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;QACxE,CAAC;IACH,CAAC;CACF,CAAC"}
+{"version":3,"file":"get-users.js","sourceRoot":"","sources":["../../../src/tools/users/get-users.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAGlE,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,IAAI,EAAE,iBAAiB;IACvB,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gEAkCiD;IAC9D,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,oCAAoC,EAAE;YAC7E,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,gCAAgC,EAAE;YACzE,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,wBAAwB,EAAE;YACtE,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,wBAAwB,EAAE;YACtE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,4BAA4B,EAAE;YACpE,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,mBAAmB,EAAE;SAC7D;KACF;IACD,OAAO,EAAE,KAAK,EACZ,KAOC,EACD,WAAwB,EACxB,EAAE;QACF,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,eAAe,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;YAC3D,IAAI,CAAC,QAAQ,CAAC,OAAO;gBAAE,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,qBAAqB,CAAC,CAAC;YAChF,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC;YACzC,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;oBACvB,IAAI,EAAE,CAAC,CAAC,IAAI;oBACZ,SAAS,EAAE,CAAC,CAAC,UAAU;oBACvB,QAAQ,EAAE,CAAC,CAAC,SAAS;oBACrB,QAAQ,EAAE,GAAG,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE;oBACjD,KAAK,EAAE,CAAC,CAAC,KAAK;oBACd,MAAM,EAAE,CAAC,CAAC,MAAM;oBAChB,MAAM,EAAE,CAAC,CAAC,MAAM;iBACjB,CAAC,CAAC;gBACH,QAAQ,EAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ;aAClC,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,uBAAuB,EAAE,KAAK,EAAE,KAAc,CAAC,CAAC;YAC7D,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAG,KAAe,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;QACxE,CAAC;IACH,CAAC;CACF,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zudello/modelcontextprotocol",
-  "version": "1.0.0",
+  "version": "1.1.1",
   "description": "MCP server exposing 106 Zudello ERP automation tools for Claude Desktop and other MCP-compatible clients",
   "type": "module",
   "main": "dist/index.js",