@zudello/modelcontextprotocol 1.0.0 → 1.1.1

package/dist/tools/language/get-language-placeholders.js

@@ -7,12 +7,42 @@ export const zudelloGetLanguagePlaceholders = {
 Language placeholders allow customizing entity labels across the Zudello UI
 to match your organization's terminology (e.g., "Vendor" vs "Supplier").
 
-Returns:
+**RESPONSE STRUCTURE:**
+Returns a resource containing:
 - uuid: Resource UUID (needed for updates)
 - payload.lang: Object mapping entity keys to their labels
-  - Each entry has: singular, plural, linkedModel
+  - Each entry has: singular, plural, and linkedModel
 
-Common entity keys: supplier, customer, account, costCenter, project, contract`,
+**EXAMPLE RESPONSE:**
+{
+  "uuid": "f0e4c2f6-1234-5678-90ab-cdef12345678",
+  "payload": {
+    "lang": {
+      "supplier": { "singular": "Vendor", "plural": "Vendors", "linkedModel": "Supplier" },
+      "account": { "singular": "Account", "plural": "Accounts", "linkedModel": "Account" },
+      "costCenter": { "singular": "Department", "plural": "Departments", "linkedModel": "CostCenter" },
+      "project": { "singular": "Project", "plural": "Projects", "linkedModel": "Project" }
+    }
+  }
+}
+
+**COMMON ENTITY KEYS:**
+- supplier: Supplier/Vendor terminology
+- customer: Customer terminology
+- account: GL Account terminology
+- costCenter: Cost Center/Department terminology
+- project: Project terminology
+- contract: Contract terminology
+- location: Location/Site terminology
+- subsidiary: Subsidiary/Entity terminology
+- warehouse: Warehouse terminology
+- unitOfMeasure: Unit of Measure terminology
+
+**USE CASES:**
+- Review current terminology customizations
+- Audit consistency of UI labels before changes
+- Get the resource UUID needed for update operations
+- Onboard new users by explaining custom terminology`,
     inputSchema: { type: "object", properties: {} },
     execute: async (input, authContext) => {
         try {

package/dist/tools/language/get-language-placeholders.js.map

@@ -1 +1 @@
-{"version":3,"file":"get-language-placeholders.js","sourceRoot":"","sources":["../../../src/tools/language/get-language-placeholders.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,8BAA8B,EAAE,MAAM,iCAAiC,CAAC;AAGjF,MAAM,CAAC,MAAM,8BAA8B,GAAG;IAC5C,IAAI,EAAE,gCAAgC;IACtC,WAAW,EAAE;;;;;;;;;;+EAUgE;IAC7E,WAAW,EAAE,EAAE,IAAI,EAAE,QAAiB,EAAE,UAAU,EAAE,EAAE,EAAE;IACxD,OAAO,EAAE,KAAK,EAAE,KAA8B,EAAE,WAAwB,EAAE,EAAE;QAC1E,IAAI,CAAC;YACH,MAAM,CAAC,KAAK,CAAC,yCAAyC,CAAC,CAAC;YACxD,MAAM,QAAQ,GAAG,MAAM,8BAA8B,CAAC,WAAW,CAAC,CAAC;YACnE,IAAI,CAAC,QAAQ,CAAC,OAAO;gBAAE,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,qCAAqC,CAAC,CAAC;YAChG,MAAM,QAAQ,GAAG,QAAQ,CAAC,IAAI,CAAC;YAC/B,MAAM,IAAI,GAAG,QAAQ,EAAE,OAAO,EAAE,IAAI,IAAI,EAAE,CAAC;YAC3C,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,YAAY,EAAE,QAAQ,EAAE,IAAI;gBAC5B,IAAI;gBACJ,WAAW,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM;gBACrC,OAAO,EAAE,QAAQ,EAAE,OAAO;gBAC1B,SAAS,EAAE,QAAQ,EAAE,UAAU;aAChC,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,sCAAsC,EAAE,EAAE,EAAE,KAAc,CAAC,CAAC;YACzE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAG,KAAe,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;QACzE,CAAC;IACH,CAAC;CACF,CAAC"}
+{"version":3,"file":"get-language-placeholders.js","sourceRoot":"","sources":["../../../src/tools/language/get-language-placeholders.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,8BAA8B,EAAE,MAAM,iCAAiC,CAAC;AAGjF,MAAM,CAAC,MAAM,8BAA8B,GAAG;IAC5C,IAAI,EAAE,gCAAgC;IACtC,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qDAwCsC;IACnD,WAAW,EAAE,EAAE,IAAI,EAAE,QAAiB,EAAE,UAAU,EAAE,EAAE,EAAE;IACxD,OAAO,EAAE,KAAK,EAAE,KAA8B,EAAE,WAAwB,EAAE,EAAE;QAC1E,IAAI,CAAC;YACH,MAAM,CAAC,KAAK,CAAC,yCAAyC,CAAC,CAAC;YACxD,MAAM,QAAQ,GAAG,MAAM,8BAA8B,CAAC,WAAW,CAAC,CAAC;YACnE,IAAI,CAAC,QAAQ,CAAC,OAAO;gBAAE,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,qCAAqC,CAAC,CAAC;YAChG,MAAM,QAAQ,GAAG,QAAQ,CAAC,IAAI,CAAC;YAC/B,MAAM,IAAI,GAAG,QAAQ,EAAE,OAAO,EAAE,IAAI,IAAI,EAAE,CAAC;YAC3C,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,YAAY,EAAE,QAAQ,EAAE,IAAI;gBAC5B,IAAI;gBACJ,WAAW,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM;gBACrC,OAAO,EAAE,QAAQ,EAAE,OAAO;gBAC1B,SAAS,EAAE,QAAQ,EAAE,UAAU;aAChC,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,sCAAsC,EAAE,EAAE,EAAE,KAAc,CAAC,CAAC;YACzE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAG,KAAe,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;QACzE,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/tools/language/update-language-placeholders.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"update-language-placeholders.d.ts","sourceRoot":"","sources":["../../../src/tools/language/update-language-placeholders.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAEhF,eAAO,MAAM,iCAAiC;;;;;;;;;;;;;;;;;qBA8BnC;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,wBAAwB,CAAC,CAAA;KAAE,eAClE,WAAW;;;;;;;;;;;;;;;CAsB3B,CAAC"}
+{"version":3,"file":"update-language-placeholders.d.ts","sourceRoot":"","sources":["../../../src/tools/language/update-language-placeholders.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAEhF,eAAO,MAAM,iCAAiC;;;;;;;;;;;;;;;;;qBA+CnC;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,wBAAwB,CAAC,CAAA;KAAE,eAClE,WAAW;;;;;;;;;;;;;;;CAsB3B,CAAC"}

package/dist/tools/language/update-language-placeholders.js

@@ -7,17 +7,34 @@ export const zudelloUpdateLanguagePlaceholders = {
 Allows customizing UI terminology to match your organization's language preferences.
 Each entity label requires singular and plural forms, plus the linkedModel reference.
 
-WORKFLOW:
+**WORKFLOW:**
 1. First call zudelloGetLanguagePlaceholders to get current values and the resourceUuid
 2. Modify the lang object as needed
 3. Call this tool with the resourceUuid and complete lang object
 
-IMPORTANT: You must provide the COMPLETE lang object with ALL entities.
+**IMPORTANT:** You must provide the COMPLETE lang object with ALL entities.
 This is a PUT operation that replaces the entire language configuration.
 
-Required fields:
+**REQUIRED INPUT:**
 - resourceUuid: The UUID from getLanguagePlaceholders response
-- lang: Object mapping entity keys to their label configuration`,
+- lang: Object mapping entity keys to their label configuration
+
+**EXAMPLE REQUEST:**
+{
+  "resourceUuid": "f0e4c2f6-1234-5678-90ab-cdef12345678",
+  "lang": {
+    "supplier": { "singular": "Vendor", "plural": "Vendors", "linkedModel": "Supplier" },
+    "account": { "singular": "GL Account", "plural": "GL Accounts", "linkedModel": "Account" },
+    "costCenter": { "singular": "Department", "plural": "Departments", "linkedModel": "CostCenter" },
+    "project": { "singular": "Job", "plural": "Jobs", "linkedModel": "Project" }
+  }
+}
+
+**USE CASES:**
+- Align Zudello terminology with ERP system labels
+- Update terminology after organizational rebrand
+- Customize for industry-specific language (e.g., "Job" instead of "Project")
+- Support regional terminology preferences`,
     inputSchema: {
         type: "object",
         properties: {

package/dist/tools/language/update-language-placeholders.js.map

@@ -1 +1 @@
-{"version":3,"file":"update-language-placeholders.js","sourceRoot":"","sources":["../../../src/tools/language/update-language-placeholders.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,iCAAiC,EAAE,MAAM,iCAAiC,CAAC;AAIpF,MAAM,CAAC,MAAM,iCAAiC,GAAG;IAC/C,IAAI,EAAE,mCAAmC;IACzC,WAAW,EAAE;;;;;;;;;;;;;;;gEAeiD;IAC9D,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,YAAY,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,4CAA4C,EAAE;YAC3F,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,kEAAkE;aAChF;SACF;QACD,QAAQ,EAAE,CAAC,cAAc,EAAE,MAAM,CAAC;KACnC;IACD,OAAO,EAAE,KAAK,EACZ,KAA+E,EAC/E,WAAwB,EACxB,EAAE;QACF,IAAI,CAAC;YACH,MAAM,CAAC,KAAK,CAAC,4CAA4C,EAAE;gBACzD,YAAY,EAAE,KAAK,CAAC,YAAY;gBAChC,WAAW,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM;aAC5C,CAAC,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,iCAAiC,CAAC,WAAW,EAAE,KAAK,CAAC,YAAY,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YACtG,IAAI,CAAC,QAAQ,CAAC,OAAO;gBAAE,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,wCAAwC,CAAC,CAAC;YACnG,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC;YACnD,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,YAAY,EAAE,QAAQ,CAAC,IAAI,EAAE,IAAI;gBACjC,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI;gBAClC,OAAO,EAAE,QAAQ,CAAC,IAAI,EAAE,OAAO;gBAC/B,OAAO,EAAE,WAAW,WAAW,uCAAuC;aACvE,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,yCAAyC,EAAE,EAAE,EAAE,KAAc,CAAC,CAAC;YAC5E,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAG,KAAe,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;QACzE,CAAC;IACH,CAAC;CACF,CAAC"}
+{"version":3,"file":"update-language-placeholders.js","sourceRoot":"","sources":["../../../src/tools/language/update-language-placeholders.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,iCAAiC,EAAE,MAAM,iCAAiC,CAAC;AAIpF,MAAM,CAAC,MAAM,iCAAiC,GAAG;IAC/C,IAAI,EAAE,mCAAmC;IACzC,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2CAgC4B;IACzC,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,YAAY,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,4CAA4C,EAAE;YAC3F,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,kEAAkE;aAChF;SACF;QACD,QAAQ,EAAE,CAAC,cAAc,EAAE,MAAM,CAAC;KACnC;IACD,OAAO,EAAE,KAAK,EACZ,KAA+E,EAC/E,WAAwB,EACxB,EAAE;QACF,IAAI,CAAC;YACH,MAAM,CAAC,KAAK,CAAC,4CAA4C,EAAE;gBACzD,YAAY,EAAE,KAAK,CAAC,YAAY;gBAChC,WAAW,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM;aAC5C,CAAC,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,iCAAiC,CAAC,WAAW,EAAE,KAAK,CAAC,YAAY,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YACtG,IAAI,CAAC,QAAQ,CAAC,OAAO;gBAAE,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,wCAAwC,CAAC,CAAC;YACnG,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC;YACnD,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,YAAY,EAAE,QAAQ,CAAC,IAAI,EAAE,IAAI;gBACjC,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI;gBAClC,OAAO,EAAE,QAAQ,CAAC,IAAI,EAAE,OAAO;gBAC/B,OAAO,EAAE,WAAW,WAAW,uCAAuC;aACvE,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,yCAAyC,EAAE,EAAE,EAAE,KAAc,CAAC,CAAC;YAC5E,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAG,KAAe,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;QACzE,CAAC;IACH,CAAC;CACF,CAAC"}

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

@@ -8,8 +8,8 @@ export const zudelloListModels = {
     description: `List all available data models in Zudello that can be used in search queries and other operations.
 
 Model/Module/Submodule relationships:
-- Transaction: Used across EXPENSES, INVENTORY, PURCHASING, SALES modules
-- Item: Used with INVENTORY module
+- Transaction: Used across EXPENSES (CLAIM/EXPENSE/MILEAGE/PAYMENT/REFUND), INVENTORY (RECEIPT), PURCHASING (CREDIT/INVOICE/ORDER/QUOTE/REQUISITION/RETURN/STATEMENT), SALES (CREDIT/INVOICE/ORDER/QUOTE/REMITTANCE)
+- Item: Used with INVENTORY module (CATALOGUE submodule)
 - Customer/Supplier/Employee: RELATIONSHIPS module
 - Budget: BUDGETS module | Contract: CONTRACTS module
 - Dimensional models (Account, Department, Location, etc.): DIMENSIONS module

package/dist/tools/org-admin/teams/fetch-org-team.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fetch-org-team.d.ts","sourceRoot":"","sources":["../../../../src/tools/org-admin/teams/fetch-org-team.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D,eAAO,MAAM,mBAAmB;;;;;;;;;;;;qBAIP,GAAG,eAAe,WAAW;;;;;;;;;CASrD,CAAC"}
+{"version":3,"file":"fetch-org-team.d.ts","sourceRoot":"","sources":["../../../../src/tools/org-admin/teams/fetch-org-team.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D,eAAO,MAAM,mBAAmB;;;;;;;;;;;;qBAkBP,GAAG,eAAe,WAAW;;;;;;;;;CASrD,CAAC"}

package/dist/tools/org-admin/teams/fetch-org-team.js

@@ -2,7 +2,21 @@ import { logger } from "../../../utils/logger.js";
 import { fetchOrgTeam } from "../../../services/zudello/index.js";
 export const zudelloFetchOrgTeam = {
     name: "zudelloFetchOrgTeam",
-    description: "Fetch single organization team",
+    description: `Retrieve a specific team by its UUID.
+
+Returns the complete team configuration including name, cluster assignment, country, default currency, timezone, logo, and team type (production, sandbox, etc.).
+
+**COMMON USE CASES:**
+- Retrieving complete team details before making configuration changes
+- Verifying team settings match expected configuration during audits
+- Checking cluster assignment for performance or data residency requirements
+- Confirming timezone and currency settings for new user onboarding
+- Validating team type when distinguishing production from sandbox environments
+
+**ACCESS REQUIREMENTS:**
+- Organisation admin (is_admin: true in /validate response) OR
+- Zudello staff user (has access to org UUID: d49d0000-0000-4000-8000-000000000001)
+- Non-admin users will receive authorization errors`,
     inputSchema: { type: "object", properties: { teamUuid: { type: "string" } }, required: ["teamUuid"] },
     execute: async (input, authContext) => {
         try {

package/dist/tools/org-admin/teams/fetch-org-team.js.map

@@ -1 +1 @@
-{"version":3,"file":"fetch-org-team.js","sourceRoot":"","sources":["../../../../src/tools/org-admin/teams/fetch-org-team.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AAGlE,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,IAAI,EAAE,qBAAqB;IAC3B,WAAW,EAAE,gCAAgC;IAC7C,WAAW,EAAE,EAAE,IAAI,EAAE,QAAiB,EAAE,UAAU,EAAE,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,UAAU,CAAC,EAAE;IAC9G,OAAO,EAAE,KAAK,EAAE,KAAU,EAAE,WAAwB,EAAE,EAAE;QACtD,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,WAAW,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;YACjE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC;QAChD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,2BAA2B,EAAE,KAAK,EAAE,KAAc,CAAC,CAAC;YACjE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAG,KAAe,CAAC,OAAO,EAAE,CAAC;QAC7D,CAAC;IACH,CAAC;CACF,CAAC"}
+{"version":3,"file":"fetch-org-team.js","sourceRoot":"","sources":["../../../../src/tools/org-admin/teams/fetch-org-team.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AAGlE,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,IAAI,EAAE,qBAAqB;IAC3B,WAAW,EAAE;;;;;;;;;;;;;;oDAcqC;IAClD,WAAW,EAAE,EAAE,IAAI,EAAE,QAAiB,EAAE,UAAU,EAAE,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,UAAU,CAAC,EAAE;IAC9G,OAAO,EAAE,KAAK,EAAE,KAAU,EAAE,WAAwB,EAAE,EAAE;QACtD,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,WAAW,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;YACjE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC;QAChD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,2BAA2B,EAAE,KAAK,EAAE,KAAc,CAAC,CAAC;YACjE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAG,KAAe,CAAC,OAAO,EAAE,CAAC;QAC7D,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/tools/org-admin/teams/list-org-teams.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"list-org-teams.d.ts","sourceRoot":"","sources":["../../../../src/tools/org-admin/teams/list-org-teams.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D,eAAO,MAAM,mBAAmB;;;;;;;qBAIP,GAAG,eAAe,WAAW;;;;;;;;;;;CASrD,CAAC"}
+{"version":3,"file":"list-org-teams.d.ts","sourceRoot":"","sources":["../../../../src/tools/org-admin/teams/list-org-teams.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D,eAAO,MAAM,mBAAmB;;;;;;;qBAoBP,GAAG,eAAe,WAAW;;;;;;;;;;;CASrD,CAAC"}

package/dist/tools/org-admin/teams/list-org-teams.js

@@ -2,7 +2,23 @@ import { logger } from "../../../utils/logger.js";
 import { listOrgTeams } from "../../../services/zudello/index.js";
 export const zudelloListOrgTeams = {
     name: "zudelloListOrgTeams",
-    description: "List organization teams",
+    description: `List all teams within the organisation.
+
+Teams represent the second level of tenancy in Zudello, providing isolated environments for different business units, departments, or entities. Each team maintains its own configuration, documents, and workflows completely separated from other teams.
+
+Returns team details including name, cluster assignment, country, currency, timezone, and team type (production, sandbox, etc.).
+
+**COMMON USE CASES:**
+- Auditing the complete team structure during annual compliance reviews
+- Onboarding a new administrator who needs visibility across all business units
+- Generating reports on team configurations for multi-entity organisations
+- Identifying inactive or sandbox teams for cleanup during system maintenance
+- Planning team provisioning for a new acquisition or business unit
+
+**ACCESS REQUIREMENTS:**
+- Organisation admin (is_admin: true in /validate response) OR
+- Zudello staff user (has access to org UUID: d49d0000-0000-4000-8000-000000000001)
+- Non-admin users will receive authorization errors`,
     inputSchema: { type: "object", properties: {} },
     execute: async (input, authContext) => {
         try {

package/dist/tools/org-admin/teams/list-org-teams.js.map

@@ -1 +1 @@
-{"version":3,"file":"list-org-teams.js","sourceRoot":"","sources":["../../../../src/tools/org-admin/teams/list-org-teams.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AAGlE,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,IAAI,EAAE,qBAAqB;IAC3B,WAAW,EAAE,yBAAyB;IACtC,WAAW,EAAE,EAAE,IAAI,EAAE,QAAiB,EAAE,UAAU,EAAE,EAAE,EAAE;IACxD,OAAO,EAAE,KAAK,EAAE,KAAU,EAAE,WAAwB,EAAE,EAAE;QACtD,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,WAAW,CAAC,CAAC;YACjD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,CAAC,IAAI,EAAE,KAAK,IAAI,EAAE,EAAE,KAAK,EAAE,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;QACvG,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,2BAA2B,EAAE,EAAE,EAAE,KAAc,CAAC,CAAC;YAC9D,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":"list-org-teams.js","sourceRoot":"","sources":["../../../../src/tools/org-admin/teams/list-org-teams.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AAGlE,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,IAAI,EAAE,qBAAqB;IAC3B,WAAW,EAAE;;;;;;;;;;;;;;;;oDAgBqC;IAClD,WAAW,EAAE,EAAE,IAAI,EAAE,QAAiB,EAAE,UAAU,EAAE,EAAE,EAAE;IACxD,OAAO,EAAE,KAAK,EAAE,KAAU,EAAE,WAAwB,EAAE,EAAE;QACtD,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,WAAW,CAAC,CAAC;YACjD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,CAAC,IAAI,EAAE,KAAK,IAAI,EAAE,EAAE,KAAK,EAAE,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;QACvG,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,2BAA2B,EAAE,EAAE,EAAE,KAAc,CAAC,CAAC;YAC9D,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAG,KAAe,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;QACxE,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/tools/org-admin/teams/update-org-team.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"update-org-team.d.ts","sourceRoot":"","sources":["../../../../src/tools/org-admin/teams/update-org-team.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D,eAAO,MAAM,oBAAoB;;;;;;;;;;;;qBAIR,GAAG,eAAe,WAAW;;;;;;;;;CASrD,CAAC"}
+{"version":3,"file":"update-org-team.d.ts","sourceRoot":"","sources":["../../../../src/tools/org-admin/teams/update-org-team.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D,eAAO,MAAM,oBAAoB;;;;;;;;;;;;qBAmBR,GAAG,eAAe,WAAW;;;;;;;;;CASrD,CAAC"}

package/dist/tools/org-admin/teams/update-org-team.js

@@ -2,7 +2,22 @@ import { logger } from "../../../utils/logger.js";
 import { updateOrgTeam } from "../../../services/zudello/index.js";
 export const zudelloUpdateOrgTeam = {
     name: "zudelloUpdateOrgTeam",
-    description: "Update organization team (org admin only)",
+    description: `Update the properties of a specific team within the organisation.
+
+Allows modification of team settings such as name, default currency, timezone, country, and contact details. Changes to team configuration affect all users and documents within that team.
+
+**NOTE:** The Cluster cannot be updated after team creation.
+
+**COMMON USE CASES:**
+- Rebranding a team after a departmental restructure or company name change
+- Updating the default currency when a business unit expands into new markets
+- Changing timezone settings when a team relocates to a different region
+- Correcting country assignment for tax and compliance purposes
+
+**ACCESS REQUIREMENTS:**
+- Organisation admin (is_admin: true in /validate response) OR
+- Zudello staff user (has access to org UUID: d49d0000-0000-4000-8000-000000000001)
+- Non-admin users will receive authorization errors`,
     inputSchema: { type: "object", properties: { teamUuid: { type: "string" } }, required: ["teamUuid"] },
     execute: async (input, authContext) => {
         try {

package/dist/tools/org-admin/teams/update-org-team.js.map

@@ -1 +1 @@
-{"version":3,"file":"update-org-team.js","sourceRoot":"","sources":["../../../../src/tools/org-admin/teams/update-org-team.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AAGnE,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,IAAI,EAAE,sBAAsB;IAC5B,WAAW,EAAE,2CAA2C;IACxD,WAAW,EAAE,EAAE,IAAI,EAAE,QAAiB,EAAE,UAAU,EAAE,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,UAAU,CAAC,EAAE;IAC9G,OAAO,EAAE,KAAK,EAAE,KAAU,EAAE,WAAwB,EAAE,EAAE;QACtD,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,aAAa,CAAC,WAAW,EAAE,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;YACzE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC;QAChD,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,CAAC;QAC7D,CAAC;IACH,CAAC;CACF,CAAC"}
+{"version":3,"file":"update-org-team.js","sourceRoot":"","sources":["../../../../src/tools/org-admin/teams/update-org-team.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AAGnE,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,IAAI,EAAE,sBAAsB;IAC5B,WAAW,EAAE;;;;;;;;;;;;;;;oDAeqC;IAClD,WAAW,EAAE,EAAE,IAAI,EAAE,QAAiB,EAAE,UAAU,EAAE,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,UAAU,CAAC,EAAE;IAC9G,OAAO,EAAE,KAAK,EAAE,KAAU,EAAE,WAAwB,EAAE,EAAE;QACtD,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,aAAa,CAAC,WAAW,EAAE,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;YACzE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC;QAChD,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,CAAC;QAC7D,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/tools/org-admin/users/assign-user-to-team.d.ts

@@ -1,5 +1,5 @@
 import type { AuthContext } from "../../../context/auth.js";
-export declare const zudelloAssignUserToTeam: {
+export declare const zudelloAssignUserToTeams: {
     name: string;
     description: string;
     inputSchema: {

package/dist/tools/org-admin/users/assign-user-to-team.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"assign-user-to-team.d.ts","sourceRoot":"","sources":["../../../../src/tools/org-admin/users/assign-user-to-team.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;qBAIX,GAAG,eAAe,WAAW;;;;;;;;;CAarD,CAAC"}
+{"version":3,"file":"assign-user-to-team.d.ts","sourceRoot":"","sources":["../../../../src/tools/org-admin/users/assign-user-to-team.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;qBAsBZ,GAAG,eAAe,WAAW;;;;;;;;;CAarD,CAAC"}

package/dist/tools/org-admin/users/assign-user-to-team.js

@@ -1,8 +1,26 @@
 import { logger } from "../../../utils/logger.js";
 import { assignUserToTeam } from "../../../services/zudello/index.js";
-export const zudelloAssignUserToTeam = {
-    name: "zudelloAssignUserToTeam",
-    description: "Assign user to team (org admin only)",
+export const zudelloAssignUserToTeams = {
+    name: "zudelloAssignUserToTeams",
+    description: `Assign a user to a team and configure their user group memberships, delegation settings, and default values.
+
+User groups govern both the permissions a user has within a team (what actions they can perform) and the resources they can access (what data they can see). A single user can belong to multiple teams with different user group assignments in each, enabling flexible access control across the organisation.
+
+**TO CREATE NEW ASSIGNMENT:** Provide userId and teamId, leave teamUserUuid empty.
+**TO UPDATE EXISTING ASSIGNMENT:** Provide teamUserUuid along with the fields to update.
+
+**COMMON USE CASES:**
+- Granting a new accounts payable clerk access to their department's team with appropriate processor permissions
+- Assigning a CFO to multiple teams with read-only executive visibility across all business units
+- Removing a departing employee from all teams as part of offboarding procedures (set status to INACTIVE)
+- Promoting a user by adding them to additional user groups with elevated permissions
+- Configuring cross-functional access for shared services staff who support multiple entities
+- Setting up delegation during employee leave periods
+
+**ACCESS REQUIREMENTS:**
+- Organisation admin (is_admin: true in /validate response) OR
+- Zudello staff user (has access to org UUID: d49d0000-0000-4000-8000-000000000001)
+- Non-admin users will receive authorization errors`,
     inputSchema: { type: "object", properties: { userUuid: { type: "string" }, teamUuid: { type: "string" } }, required: ["userUuid", "teamUuid"] },
     execute: async (input, authContext) => {
         try {
@@ -14,7 +32,7 @@ export const zudelloAssignUserToTeam = {
             return { success: true, result: response.data };
         }
         catch (error) {
-            logger.error("zudelloAssignUserToTeam error", input, error);
+            logger.error("zudelloAssignUserToTeams error", input, error);
             return { success: false, error: error.message };
         }
     }

package/dist/tools/org-admin/users/assign-user-to-team.js.map

@@ -1 +1 @@
-{"version":3,"file":"assign-user-to-team.js","sourceRoot":"","sources":["../../../../src/tools/org-admin/users/assign-user-to-team.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AAGtE,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,IAAI,EAAE,yBAAyB;IAC/B,WAAW,EAAE,sCAAsC;IACnD,WAAW,EAAE,EAAE,IAAI,EAAE,QAAiB,EAAE,UAAU,EAAE,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,UAAU,EAAE,UAAU,CAAC,EAAE;IACxJ,OAAO,EAAE,KAAK,EAAE,KAAU,EAAE,WAAwB,EAAE,EAAE;QACtD,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,gBAAgB,CAAC,WAAW,EAAE;gBACnD,MAAM,EAAE,KAAK,CAAC,QAAQ;gBACtB,MAAM,EAAE,KAAK,CAAC,QAAQ;gBACtB,KAAK,EAAE,WAAW,CAAC,cAAc;aAClC,CAAC,CAAC;YACH,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC;QAClD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,+BAA+B,EAAE,KAAK,EAAE,KAAc,CAAC,CAAC;YACrE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAG,KAAe,CAAC,OAAO,EAAE,CAAC;QAC7D,CAAC;IACH,CAAC;CACF,CAAC"}
+{"version":3,"file":"assign-user-to-team.js","sourceRoot":"","sources":["../../../../src/tools/org-admin/users/assign-user-to-team.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AAGtE,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,IAAI,EAAE,0BAA0B;IAChC,WAAW,EAAE;;;;;;;;;;;;;;;;;;oDAkBqC;IAClD,WAAW,EAAE,EAAE,IAAI,EAAE,QAAiB,EAAE,UAAU,EAAE,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,UAAU,EAAE,UAAU,CAAC,EAAE;IACxJ,OAAO,EAAE,KAAK,EAAE,KAAU,EAAE,WAAwB,EAAE,EAAE;QACtD,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,gBAAgB,CAAC,WAAW,EAAE;gBACnD,MAAM,EAAE,KAAK,CAAC,QAAQ;gBACtB,MAAM,EAAE,KAAK,CAAC,QAAQ;gBACtB,KAAK,EAAE,WAAW,CAAC,cAAc;aAClC,CAAC,CAAC;YACH,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC;QAClD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,gCAAgC,EAAE,KAAK,EAAE,KAAc,CAAC,CAAC;YACtE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAG,KAAe,CAAC,OAAO,EAAE,CAAC;QAC7D,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/tools/org-admin/users/create-org-user.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-org-user.d.ts","sourceRoot":"","sources":["../../../../src/tools/org-admin/users/create-org-user.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D,eAAO,MAAM,oBAAoB;;;;;;;qBAIR,GAAG,eAAe,WAAW;;;;;;;;;CASrD,CAAC"}
+{"version":3,"file":"create-org-user.d.ts","sourceRoot":"","sources":["../../../../src/tools/org-admin/users/create-org-user.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D,eAAO,MAAM,oBAAoB;;;;;;;qBAkBR,GAAG,eAAe,WAAW;;;;;;;;;CASrD,CAAC"}

package/dist/tools/org-admin/users/create-org-user.js

@@ -2,7 +2,21 @@ import { logger } from "../../../utils/logger.js";
 import { createOrgUser } from "../../../services/zudello/index.js";
 export const zudelloCreateOrgUser = {
     name: "zudelloCreateOrgUser",
-    description: "Create organization user (org admin only)",
+    description: `Create a new user within the organisation.
+
+The user is provisioned at the organisation level but will not have access to any teams or resources until explicitly assigned using the Assign User to Teams tool. The new user will receive an invitation to set up their account unless a password is provided.
+
+**COMMON USE CASES:**
+- Onboarding new employees as part of the HR provisioning workflow
+- Creating service accounts for integration purposes
+- Bulk provisioning users when deploying Zudello to a new business unit
+- Setting up external auditor access with controlled team assignments
+- Pre-creating user accounts before a go-live date for training purposes
+
+**ACCESS REQUIREMENTS:**
+- Organisation admin (is_admin: true in /validate response) OR
+- Zudello staff user (has access to org UUID: d49d0000-0000-4000-8000-000000000001)
+- Non-admin users will receive authorization errors`,
     inputSchema: { type: "object", properties: {} },
     execute: async (input, authContext) => {
         try {

package/dist/tools/org-admin/users/create-org-user.js.map

@@ -1 +1 @@
-{"version":3,"file":"create-org-user.js","sourceRoot":"","sources":["../../../../src/tools/org-admin/users/create-org-user.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AAGnE,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,IAAI,EAAE,sBAAsB;IAC5B,WAAW,EAAE,2CAA2C;IACxD,WAAW,EAAE,EAAE,IAAI,EAAE,QAAiB,EAAE,UAAU,EAAE,EAAE,EAAE;IACxD,OAAO,EAAE,KAAK,EAAE,KAAU,EAAE,WAAwB,EAAE,EAAE;QACtD,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,aAAa,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;YACzD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC;QAChD,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,CAAC;QAC7D,CAAC;IACH,CAAC;CACF,CAAC"}
+{"version":3,"file":"create-org-user.js","sourceRoot":"","sources":["../../../../src/tools/org-admin/users/create-org-user.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AAGnE,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,IAAI,EAAE,sBAAsB;IAC5B,WAAW,EAAE;;;;;;;;;;;;;;oDAcqC;IAClD,WAAW,EAAE,EAAE,IAAI,EAAE,QAAiB,EAAE,UAAU,EAAE,EAAE,EAAE;IACxD,OAAO,EAAE,KAAK,EAAE,KAAU,EAAE,WAAwB,EAAE,EAAE;QACtD,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,aAAa,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;YACzD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC;QAChD,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,CAAC;QAC7D,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/tools/org-admin/users/fetch-org-user.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fetch-org-user.d.ts","sourceRoot":"","sources":["../../../../src/tools/org-admin/users/fetch-org-user.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D,eAAO,MAAM,mBAAmB;;;;;;;;;;;;qBAIP,GAAG,eAAe,WAAW;;;;;;;;;CASrD,CAAC"}
+{"version":3,"file":"fetch-org-user.d.ts","sourceRoot":"","sources":["../../../../src/tools/org-admin/users/fetch-org-user.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D,eAAO,MAAM,mBAAmB;;;;;;;;;;;;qBAkBP,GAAG,eAAe,WAAW;;;;;;;;;CASrD,CAAC"}

package/dist/tools/org-admin/users/fetch-org-user.js

@@ -2,7 +2,21 @@ import { logger } from "../../../utils/logger.js";
 import { fetchOrgUser } from "../../../services/zudello/index.js";
 export const zudelloFetchOrgUser = {
     name: "zudelloFetchOrgUser",
-    description: "Fetch single organization user",
+    description: `Retrieve a specific user by their UUID with complete profile and team assignment details.
+
+Returns the complete user profile including name, email address, avatar, and their team assignments with associated user groups, delegation settings, and default values.
+
+**COMMON USE CASES:**
+- Reviewing a user's complete access configuration before making changes
+- Verifying user details during onboarding or role change processes
+- Auditing user permissions across all team assignments for compliance reviews
+- Checking user group assignments when troubleshooting permission issues
+- Reviewing team assignments when planning user offboarding or transfers
+
+**ACCESS REQUIREMENTS:**
+- Organisation admin (is_admin: true in /validate response) OR
+- Zudello staff user (has access to org UUID: d49d0000-0000-4000-8000-000000000001)
+- Non-admin users will receive authorization errors`,
     inputSchema: { type: "object", properties: { userUuid: { type: "string" } }, required: ["userUuid"] },
     execute: async (input, authContext) => {
         try {

package/dist/tools/org-admin/users/fetch-org-user.js.map

@@ -1 +1 @@
-{"version":3,"file":"fetch-org-user.js","sourceRoot":"","sources":["../../../../src/tools/org-admin/users/fetch-org-user.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AAGlE,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,IAAI,EAAE,qBAAqB;IAC3B,WAAW,EAAE,gCAAgC;IAC7C,WAAW,EAAE,EAAE,IAAI,EAAE,QAAiB,EAAE,UAAU,EAAE,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,UAAU,CAAC,EAAE;IAC9G,OAAO,EAAE,KAAK,EAAE,KAAU,EAAE,WAAwB,EAAE,EAAE;QACtD,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,WAAW,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;YACjE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC;QAChD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,2BAA2B,EAAE,KAAK,EAAE,KAAc,CAAC,CAAC;YACjE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAG,KAAe,CAAC,OAAO,EAAE,CAAC;QAC7D,CAAC;IACH,CAAC;CACF,CAAC"}
+{"version":3,"file":"fetch-org-user.js","sourceRoot":"","sources":["../../../../src/tools/org-admin/users/fetch-org-user.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AAGlE,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,IAAI,EAAE,qBAAqB;IAC3B,WAAW,EAAE;;;;;;;;;;;;;;oDAcqC;IAClD,WAAW,EAAE,EAAE,IAAI,EAAE,QAAiB,EAAE,UAAU,EAAE,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,UAAU,CAAC,EAAE;IAC9G,OAAO,EAAE,KAAK,EAAE,KAAU,EAAE,WAAwB,EAAE,EAAE;QACtD,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,WAAW,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;YACjE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC;QAChD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,2BAA2B,EAAE,KAAK,EAAE,KAAc,CAAC,CAAC;YACjE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAG,KAAe,CAAC,OAAO,EAAE,CAAC;QAC7D,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/tools/org-admin/users/index.d.ts

@@ -2,6 +2,6 @@ export { zudelloListOrgUsers } from "./list-org-users.js";
 export { zudelloFetchOrgUser } from "./fetch-org-user.js";
 export { zudelloCreateOrgUser } from "./create-org-user.js";
 export { zudelloUpdateOrgUser } from "./update-org-user.js";
-export { zudelloAssignUserToTeam } from "./assign-user-to-team.js";
+export { zudelloAssignUserToTeams } from "./assign-user-to-team.js";
 export { zudelloListOrgUserGroups } from "./list-org-user-groups.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/tools/org-admin/users/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/tools/org-admin/users/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/tools/org-admin/users/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/tools/org-admin/users/index.js

@@ -2,6 +2,6 @@ export { zudelloListOrgUsers } from "./list-org-users.js";
 export { zudelloFetchOrgUser } from "./fetch-org-user.js";
 export { zudelloCreateOrgUser } from "./create-org-user.js";
 export { zudelloUpdateOrgUser } from "./update-org-user.js";
-export { zudelloAssignUserToTeam } from "./assign-user-to-team.js";
+export { zudelloAssignUserToTeams } from "./assign-user-to-team.js";
 export { zudelloListOrgUserGroups } from "./list-org-user-groups.js";
 //# sourceMappingURL=index.js.map

package/dist/tools/org-admin/users/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/tools/org-admin/users/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/tools/org-admin/users/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/tools/org-admin/users/list-org-user-groups.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"list-org-user-groups.d.ts","sourceRoot":"","sources":["../../../../src/tools/org-admin/users/list-org-user-groups.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D,eAAO,MAAM,wBAAwB;;;;;;;qBAIZ,GAAG,eAAe,WAAW;;;;;;;;;;;CASrD,CAAC"}
+{"version":3,"file":"list-org-user-groups.d.ts","sourceRoot":"","sources":["../../../../src/tools/org-admin/users/list-org-user-groups.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D,eAAO,MAAM,wBAAwB;;;;;;;qBAuBZ,GAAG,eAAe,WAAW;;;;;;;;;;;CASrD,CAAC"}

package/dist/tools/org-admin/users/list-org-user-groups.js

@@ -2,7 +2,26 @@ import { logger } from "../../../utils/logger.js";
 import { listOrgUserGroups } from "../../../services/zudello/index.js";
 export const zudelloListOrgUserGroups = {
     name: "zudelloListOrgUserGroups",
-    description: "List organization user groups",
+    description: `List all user groups defined within the organisation.
+
+Unlike team-level queries which only show user groups currently in use within that team, this endpoint returns the complete set of available user groups across the organisation. User groups define permission sets and resource access rules that can be assigned to users within any team.
+
+**USER GROUP TYPES:**
+- ACCESS: Controls general access permissions
+- APPROVAL: Controls approval workflow participation
+- LEGACY: Older permission groups maintained for backward compatibility
+
+**COMMON USE CASES:**
+- Reviewing the complete permission structure during security audits
+- Planning role-based access control strategies for new team deployments
+- Identifying redundant or unused user groups for governance cleanup
+- Documenting permission matrices for compliance and training materials
+- Mapping Zudello user groups to corporate role definitions for identity management integration
+
+**ACCESS REQUIREMENTS:**
+- Organisation admin (is_admin: true in /validate response) OR
+- Zudello staff user (has access to org UUID: d49d0000-0000-4000-8000-000000000001)
+- Non-admin users will receive authorization errors`,
     inputSchema: { type: "object", properties: {} },
     execute: async (input, authContext) => {
         try {

package/dist/tools/org-admin/users/list-org-user-groups.js.map

@@ -1 +1 @@
-{"version":3,"file":"list-org-user-groups.js","sourceRoot":"","sources":["../../../../src/tools/org-admin/users/list-org-user-groups.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AAGvE,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,IAAI,EAAE,0BAA0B;IAChC,WAAW,EAAE,+BAA+B;IAC5C,WAAW,EAAE,EAAE,IAAI,EAAE,QAAiB,EAAE,UAAU,EAAE,EAAE,EAAE;IACxD,OAAO,EAAE,KAAK,EAAE,KAAU,EAAE,WAAwB,EAAE,EAAE;QACtD,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,iBAAiB,CAAC,WAAW,CAAC,CAAC;YACtD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,IAAI,EAAE,EAAE,KAAK,EAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;QACtH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,gCAAgC,EAAE,EAAE,EAAE,KAAc,CAAC,CAAC;YACnE,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":"list-org-user-groups.js","sourceRoot":"","sources":["../../../../src/tools/org-admin/users/list-org-user-groups.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AAGvE,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,IAAI,EAAE,0BAA0B;IAChC,WAAW,EAAE;;;;;;;;;;;;;;;;;;;oDAmBqC;IAClD,WAAW,EAAE,EAAE,IAAI,EAAE,QAAiB,EAAE,UAAU,EAAE,EAAE,EAAE;IACxD,OAAO,EAAE,KAAK,EAAE,KAAU,EAAE,WAAwB,EAAE,EAAE;QACtD,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,iBAAiB,CAAC,WAAW,CAAC,CAAC;YACtD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,IAAI,EAAE,EAAE,KAAK,EAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;QACtH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,gCAAgC,EAAE,EAAE,EAAE,KAAc,CAAC,CAAC;YACnE,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/org-admin/users/list-org-users.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"list-org-users.d.ts","sourceRoot":"","sources":["../../../../src/tools/org-admin/users/list-org-users.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D,eAAO,MAAM,mBAAmB;;;;;;;qBAIP,GAAG,eAAe,WAAW;;;;;;;;;;;CASrD,CAAC"}
+{"version":3,"file":"list-org-users.d.ts","sourceRoot":"","sources":["../../../../src/tools/org-admin/users/list-org-users.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D,eAAO,MAAM,mBAAmB;;;;;;;qBAkBP,GAAG,eAAe,WAAW;;;;;;;;;;;CASrD,CAAC"}

package/dist/tools/org-admin/users/list-org-users.js

@@ -2,7 +2,21 @@ import { logger } from "../../../utils/logger.js";
 import { listOrgUsers } from "../../../services/zudello/index.js";
 export const zudelloListOrgUsers = {
     name: "zudelloListOrgUsers",
-    description: "List organization users",
+    description: `List all users across the entire organisation, regardless of team assignment.
+
+Unlike team-level endpoints which only return users within the selected team, this endpoint provides a complete view of all users provisioned to the organisation. Returns user details including name, email, avatar, and their team assignments.
+
+**COMMON USE CASES:**
+- Conducting user access reviews for SOC 2 or ISO 27001 compliance audits
+- Identifying orphaned users who are no longer assigned to any active teams
+- Generating a complete user roster for licence reconciliation
+- Finding users across teams when investigating document processing issues
+- Preparing for user migrations during system consolidation projects
+
+**ACCESS REQUIREMENTS:**
+- Organisation admin (is_admin: true in /validate response) OR
+- Zudello staff user (has access to org UUID: d49d0000-0000-4000-8000-000000000001)
+- Non-admin users will receive authorization errors`,
     inputSchema: { type: "object", properties: {} },
     execute: async (input, authContext) => {
         try {

package/dist/tools/org-admin/users/list-org-users.js.map

@@ -1 +1 @@
-{"version":3,"file":"list-org-users.js","sourceRoot":"","sources":["../../../../src/tools/org-admin/users/list-org-users.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AAGlE,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,IAAI,EAAE,qBAAqB;IAC3B,WAAW,EAAE,yBAAyB;IACtC,WAAW,EAAE,EAAE,IAAI,EAAE,QAAiB,EAAE,UAAU,EAAE,EAAE,EAAE;IACxD,OAAO,EAAE,KAAK,EAAE,KAAU,EAAE,WAAwB,EAAE,EAAE;QACtD,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,WAAW,CAAC,CAAC;YACjD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,CAAC,IAAI,EAAE,KAAK,IAAI,EAAE,EAAE,KAAK,EAAE,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;QACvG,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,2BAA2B,EAAE,EAAE,EAAE,KAAc,CAAC,CAAC;YAC9D,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":"list-org-users.js","sourceRoot":"","sources":["../../../../src/tools/org-admin/users/list-org-users.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AAGlE,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,IAAI,EAAE,qBAAqB;IAC3B,WAAW,EAAE;;;;;;;;;;;;;;oDAcqC;IAClD,WAAW,EAAE,EAAE,IAAI,EAAE,QAAiB,EAAE,UAAU,EAAE,EAAE,EAAE;IACxD,OAAO,EAAE,KAAK,EAAE,KAAU,EAAE,WAAwB,EAAE,EAAE;QACtD,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,WAAW,CAAC,CAAC;YACjD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,CAAC,IAAI,EAAE,KAAK,IAAI,EAAE,EAAE,KAAK,EAAE,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;QACvG,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,2BAA2B,EAAE,EAAE,EAAE,KAAc,CAAC,CAAC;YAC9D,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAG,KAAe,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;QACxE,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/tools/org-admin/users/update-org-user.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"update-org-user.d.ts","sourceRoot":"","sources":["../../../../src/tools/org-admin/users/update-org-user.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D,eAAO,MAAM,oBAAoB;;;;;;;;;;;;qBAIR,GAAG,eAAe,WAAW;;;;;;;;;CASrD,CAAC"}
+{"version":3,"file":"update-org-user.d.ts","sourceRoot":"","sources":["../../../../src/tools/org-admin/users/update-org-user.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D,eAAO,MAAM,oBAAoB;;;;;;;;;;;;qBAeR,GAAG,eAAe,WAAW;;;;;;;;;CASrD,CAAC"}

package/dist/tools/org-admin/users/update-org-user.js

@@ -2,7 +2,18 @@ import { logger } from "../../../utils/logger.js";
 import { updateOrgUser } from "../../../services/zudello/index.js";
 export const zudelloUpdateOrgUser = {
     name: "zudelloUpdateOrgUser",
-    description: "Update organization user (org admin only)",
+    description: `Update an existing user's core profile information at the organisation level.
+
+Allows modification of user details such as first name and last name. Note that email address cannot be changed as it is the user's login identifier. Team assignments and permissions are managed separately through the Assign User to Teams tool.
+
+**COMMON USE CASES:**
+- Correcting name spelling or updating names after legal name changes
+- Modifying user details during identity consolidation projects
+
+**ACCESS REQUIREMENTS:**
+- Organisation admin (is_admin: true in /validate response) OR
+- Zudello staff user (has access to org UUID: d49d0000-0000-4000-8000-000000000001)
+- Non-admin users will receive authorization errors`,
     inputSchema: { type: "object", properties: { userUuid: { type: "string" } }, required: ["userUuid"] },
     execute: async (input, authContext) => {
         try {

package/dist/tools/org-admin/users/update-org-user.js.map

@@ -1 +1 @@
-{"version":3,"file":"update-org-user.js","sourceRoot":"","sources":["../../../../src/tools/org-admin/users/update-org-user.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AAGnE,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,IAAI,EAAE,sBAAsB;IAC5B,WAAW,EAAE,2CAA2C;IACxD,WAAW,EAAE,EAAE,IAAI,EAAE,QAAiB,EAAE,UAAU,EAAE,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,UAAU,CAAC,EAAE;IAC9G,OAAO,EAAE,KAAK,EAAE,KAAU,EAAE,WAAwB,EAAE,EAAE;QACtD,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,aAAa,CAAC,WAAW,EAAE,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;YACzE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC;QAChD,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,CAAC;QAC7D,CAAC;IACH,CAAC;CACF,CAAC"}
+{"version":3,"file":"update-org-user.js","sourceRoot":"","sources":["../../../../src/tools/org-admin/users/update-org-user.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AAGnE,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,IAAI,EAAE,sBAAsB;IAC5B,WAAW,EAAE;;;;;;;;;;;oDAWqC;IAClD,WAAW,EAAE,EAAE,IAAI,EAAE,QAAiB,EAAE,UAAU,EAAE,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,UAAU,CAAC,EAAE;IAC9G,OAAO,EAAE,KAAK,EAAE,KAAU,EAAE,WAAwB,EAAE,EAAE;QACtD,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,aAAa,CAAC,WAAW,EAAE,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;YACzE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC;QAChD,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,CAAC;QAC7D,CAAC;IACH,CAAC;CACF,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"get-resources.d.ts","sourceRoot":"","sources":["../../../src/tools/resources/get-resources.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEzD;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;qBAsBrB;QAAE,KAAK,EAAE,MAAM,EAAE,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,eAC7B,WAAW;;;;;;;;;;;;;;;;;CAiC3B,CAAC"}
+{"version":3,"file":"get-resources.d.ts","sourceRoot":"","sources":["../../../src/tools/resources/get-resources.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEzD;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;qBA+BrB;QAAE,KAAK,EAAE,MAAM,EAAE,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,eAC7B,WAAW;;;;;;;;;;;;;;;;;CAiC3B,CAAC"}

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

@@ -5,10 +5,19 @@ import { getZudelloResources } from "../../services/zudello/resources.js";
  */
 export const zudelloGetResources = {
     name: "zudelloGetResources",
-    description: `Batch fetch multiple Zudello resources by their UUIDs in a single request.
+    description: `Batch fetch multiple resources of different models in a single request.
 
-More efficient than multiple individual fetch calls when retrieving multiple resources.
-Supports all resource types: Transaction, Item, Customer, Supplier, etc.`,
+Supported models and their contexts:
+- Transaction: EXPENSES (CLAIM/EXPENSE/MILEAGE), INVENTORY (RECEIPT), PURCHASING (INVOICE/ORDER/QUOTE), SALES (INVOICE/ORDER)
+- Item: INVENTORY (CATALOGUE)
+- Customer/Supplier/Employee: RELATIONSHIPS module
+- Budget/Contract: Financial documents with their respective modules
+- Dimensional models (Account, Department, Location, etc.): DIMENSIONS module
+
+Example usage:
+- Fetch multiple transactions by UUID
+- Fetch items by external_id from external system
+- Load related data for multiple resources at once`,
     inputSchema: {
         type: "object",
         properties: {

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

@@ -1 +1 @@
-{"version":3,"file":"get-resources.js","sourceRoot":"","sources":["../../../src/tools/resources/get-resources.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAG1E;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,IAAI,EAAE,qBAAqB;IAC3B,WAAW,EAAE;;;yEAG0D;IACvE,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,KAAK,EAAE;gBACL,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,WAAW,EAAE,kCAAkC;aAChD;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,4BAA4B;aAC1C;SACF;QACD,QAAQ,EAAE,CAAC,OAAO,CAAC;KACpB;IACD,OAAO,EAAE,KAAK,EACZ,KAA0C,EAC1C,WAAwB,EACxB,EAAE;QACF,IAAI,CAAC;YACH,MAAM,CAAC,IAAI,CAAC,8BAA8B,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;YAE3E,+CAA+C;YAC/C,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;gBAC1C,KAAK,EAAE,KAAK,CAAC,KAAK,IAAI,UAAU;gBAChC,IAAI;aACL,CAAC,CAAC,CAAC;YAEJ,MAAM,QAAQ,GAAG,MAAM,mBAAmB,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;YAElE,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;gBACtB,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,yBAAyB,CAAC,CAAC;YAC/D,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;aACxB,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,2BAA2B,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,KAAc,CAAC,CAAC;YACzF,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,EAAE;aACd,CAAC;QACJ,CAAC;IACH,CAAC;CACF,CAAC"}
+{"version":3,"file":"get-resources.js","sourceRoot":"","sources":["../../../src/tools/resources/get-resources.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAG1E;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,IAAI,EAAE,qBAAqB;IAC3B,WAAW,EAAE;;;;;;;;;;;;mDAYoC;IACjD,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,KAAK,EAAE;gBACL,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,WAAW,EAAE,kCAAkC;aAChD;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,4BAA4B;aAC1C;SACF;QACD,QAAQ,EAAE,CAAC,OAAO,CAAC;KACpB;IACD,OAAO,EAAE,KAAK,EACZ,KAA0C,EAC1C,WAAwB,EACxB,EAAE;QACF,IAAI,CAAC;YACH,MAAM,CAAC,IAAI,CAAC,8BAA8B,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;YAE3E,+CAA+C;YAC/C,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;gBAC1C,KAAK,EAAE,KAAK,CAAC,KAAK,IAAI,UAAU;gBAChC,IAAI;aACL,CAAC,CAAC,CAAC;YAEJ,MAAM,QAAQ,GAAG,MAAM,mBAAmB,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;YAElE,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;gBACtB,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,yBAAyB,CAAC,CAAC;YAC/D,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;aACxB,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,2BAA2B,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,KAAc,CAAC,CAAC;YACzF,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,EAAE;aACd,CAAC;QACJ,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/tools/resources/update-or-create-resources.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"update-or-create-resources.d.ts","sourceRoot":"","sources":["../../../src/tools/resources/update-or-create-resources.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEzD;;GAEG;AACH,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;;qBAwBhC;QAAE,SAAS,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,eACtD,WAAW;;;;;;;;;;;;;;;;;;;CA2C3B,CAAC"}
+{"version":3,"file":"update-or-create-resources.d.ts","sourceRoot":"","sources":["../../../src/tools/resources/update-or-create-resources.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEzD;;GAEG;AACH,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;;qBAuDhC;QAAE,SAAS,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,eACtD,WAAW;;;;;;;;;;;;;;;;;;;CA2C3B,CAAC"}