@zudello/mcp 1.1.2

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

@@ -0,0 +1,65 @@
+import { logger } from "../../utils/logger.js";
+import { getZudelloResources } from "../../services/zudello/resources.js";
+/**
+ * Batch fetch multiple resources by UUIDs
+ */
+export const zudelloGetResources = {
+    name: "zudelloGetResources",
+    description: `Batch fetch multiple resources of different models in a single request.
+
+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: {
+            uuids: {
+                type: "array",
+                items: { type: "string" },
+                description: "Array of resource UUIDs to fetch",
+            },
+            model: {
+                type: "string",
+                description: "Optional model type filter",
+            },
+        },
+        required: ["uuids"],
+    },
+    execute: async (input, authContext) => {
+        try {
+            logger.info("zudelloGetResources executed", { count: input.uuids.length });
+            // Convert UUIDs to ResourceFetchRequest format
+            const requests = input.uuids.map((uuid) => ({
+                model: input.model || "document",
+                uuid,
+            }));
+            const response = await getZudelloResources(requests, authContext);
+            if (!response.success) {
+                throw new Error(response.error || "Failed to get resources");
+            }
+            const resources = response.data?.resources || [];
+            return {
+                success: true,
+                resources,
+                count: resources.length,
+            };
+        }
+        catch (error) {
+            logger.error("zudelloGetResources error", { count: input.uuids.length }, error);
+            return {
+                success: false,
+                error: error instanceof Error ? error.message : "Unknown error",
+                resources: [],
+            };
+        }
+    },
+};
+//# sourceMappingURL=get-resources.js.map

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

@@ -0,0 +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;;;;;;;;;;;;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/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Resource Batch Operations - MCP Tools
+ * Category: resources
+ * Read Operations: 1 | Write Operations: 1
+ */
+export { zudelloGetResources } from "./get-resources.js";
+export { zudelloUpdateOrCreateResources } from "./update-or-create-resources.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/resources/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/resources/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,8BAA8B,EAAE,MAAM,iCAAiC,CAAC"}

package/dist/tools/resources/index.js

@@ -0,0 +1,8 @@
+/**
+ * Resource Batch Operations - MCP Tools
+ * Category: resources
+ * Read Operations: 1 | Write Operations: 1
+ */
+export { zudelloGetResources } from "./get-resources.js";
+export { zudelloUpdateOrCreateResources } from "./update-or-create-resources.js";
+//# sourceMappingURL=index.js.map

package/dist/tools/resources/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/resources/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,8BAA8B,EAAE,MAAM,iCAAiC,CAAC"}

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

@@ -0,0 +1,48 @@
+import type { AuthContext } from "../../context/auth.js";
+/**
+ * Upsert resources (create or update) - WRITE tool with approval
+ */
+export declare const zudelloUpdateOrCreateResources: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            resources: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
+            model: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+    execute: (input: {
+        resources: Array<Record<string, unknown>>;
+        model: string;
+    }, authContext: AuthContext) => Promise<{
+        success: boolean;
+        resources: {
+            success: boolean;
+            model?: string;
+            data?: unknown;
+            message?: string;
+            errors?: unknown[];
+        }[];
+        count: number;
+        message: string;
+        error?: undefined;
+    } | {
+        success: boolean;
+        error: string;
+        resources: null;
+        count?: undefined;
+        message?: undefined;
+    }>;
+};
+//# sourceMappingURL=update-or-create-resources.d.ts.map

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

@@ -0,0 +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;;;;;;;;;;;;;;;;;;;;qBAuDhC;QAAE,SAAS,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,eACtD,WAAW;;;;;;;;;;;;;;;;;;;CA2C3B,CAAC"}

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

@@ -0,0 +1,95 @@
+import { logger } from "../../utils/logger.js";
+import { updateOrCreateZudelloResources } from "../../services/zudello/resources.js";
+/**
+ * Upsert resources (create or update) - WRITE tool with approval
+ */
+export const zudelloUpdateOrCreateResources = {
+    name: "zudelloUpdateOrCreateResources",
+    description: `Update existing resources or create new ones if not found (upsert operation).
+
+## 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: {
+            resources: {
+                type: "array",
+                items: { type: "object" },
+                description: "Array of resource objects to create or update",
+            },
+            model: {
+                type: "string",
+                description: "Model type for the resources",
+            },
+        },
+        required: ["resources", "model"],
+    },
+    execute: async (input, authContext) => {
+        try {
+            logger.info("zudelloUpdateOrCreateResources executed", {
+                count: input.resources.length,
+                model: input.model
+            });
+            // Convert to UpdateOrCreateResourceRequest format
+            const requests = input.resources.map((resource) => ({
+                model: input.model,
+                data: resource,
+            }));
+            const response = await updateOrCreateZudelloResources(requests, authContext, { batch: true });
+            if (!response.success) {
+                throw new Error(response.error || "Failed to update or create resources");
+            }
+            const resources = response.data?.resources || [];
+            return {
+                success: true,
+                resources,
+                count: resources.length,
+                message: response.data?.message || "Resources processed successfully",
+            };
+        }
+        catch (error) {
+            logger.error("zudelloUpdateOrCreateResources error", {
+                count: input.resources.length
+            }, error);
+            return {
+                success: false,
+                error: error instanceof Error ? error.message : "Unknown error",
+                resources: null,
+            };
+        }
+    },
+};
+//# sourceMappingURL=update-or-create-resources.js.map

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

@@ -0,0 +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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;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

@@ -0,0 +1,39 @@
+import type { AuthContext } from "../../context/auth.js";
+export declare const zudelloCreateSentence: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            module: {
+                type: string;
+                description: string;
+            };
+            payload: {
+                type: string;
+                description: string;
+            };
+            user: {
+                type: string;
+                description: string;
+            };
+            sendToLpm: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+    execute: (input: any, authContext: AuthContext) => Promise<{
+        success: boolean;
+        sentence: import("../../services/zudello/types.js").ZudelloSentence | undefined;
+        message: string;
+        error?: undefined;
+    } | {
+        success: boolean;
+        error: string;
+        sentence?: undefined;
+        message?: undefined;
+    }>;
+};
+//# sourceMappingURL=create-sentence.d.ts.map

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

@@ -0,0 +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;;;;;;;;;;;;;;;;;;;;;;;;;qBAkCT,GAAG,eAAe,WAAW;;;;;;;;;;;CAoBrD,CAAC"}

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

@@ -0,0 +1,54 @@
+import { logger } from "../../utils/logger.js";
+import { createZudelloSentence } from "../../services/zudello/sentences.js";
+export const zudelloCreateSentence = {
+    name: "zudelloCreateSentence",
+    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: {
+            module: { type: "string", description: "Module for the sentence" },
+            payload: { type: "object", description: "Sentence configuration" },
+            user: { type: "string", description: "User UUID" },
+            sendToLpm: { type: "boolean", description: "Send to LPM (default: true)" },
+        },
+        required: ["module", "payload", "user"],
+    },
+    execute: async (input, authContext) => {
+        try {
+            const response = await createZudelloSentence(authContext, input.module, input.payload, input.user, input.sendToLpm ?? true);
+            if (!response.success)
+                throw new Error(response.error || "Failed to create sentence");
+            return {
+                success: true,
+                sentence: response.data,
+                message: "Sentence created successfully",
+            };
+        }
+        catch (error) {
+            logger.error("zudelloCreateSentence error", { module: input.module }, error);
+            return { success: false, error: error.message };
+        }
+    },
+};
+//# sourceMappingURL=create-sentence.js.map

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

@@ -0,0 +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;;;;;;;;;;;;;;;;;;;;;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

@@ -0,0 +1,32 @@
+import type { AuthContext } from "../../context/auth.js";
+export declare const zudelloGetSentenceTemplate: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            uuid: {
+                type: string;
+                description: string;
+            };
+            returnDeleted: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+    execute: (input: {
+        uuid: string;
+        returnDeleted?: boolean;
+    }, authContext: AuthContext) => Promise<{
+        success: boolean;
+        template: import("../../services/zudello/types.js").ZudelloSentence | undefined;
+        error?: undefined;
+    } | {
+        success: boolean;
+        error: string;
+        template?: undefined;
+    }>;
+};
+//# sourceMappingURL=get-sentence-template.d.ts.map

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

@@ -0,0 +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;;;;;;;;;;;;;;;;;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

@@ -0,0 +1,29 @@
+import { logger } from "../../utils/logger.js";
+import { getZudelloSentenceTemplate } from "../../services/zudello/sentences.js";
+export const zudelloGetSentenceTemplate = {
+    name: "zudelloGetSentenceTemplate",
+    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: {
+            uuid: { type: "string", description: "Template UUID" },
+            returnDeleted: { type: "boolean", description: "Include deleted templates" },
+        },
+        required: ["uuid"],
+    },
+    execute: async (input, authContext) => {
+        try {
+            const response = await getZudelloSentenceTemplate(authContext, input.uuid, input.returnDeleted ?? false);
+            if (!response.success)
+                throw new Error(response.error || "Failed to get template");
+            return { success: true, template: response.data };
+        }
+        catch (error) {
+            logger.error("zudelloGetSentenceTemplate error", { uuid: input.uuid }, error);
+            return { success: false, error: error.message };
+        }
+    },
+};
+//# sourceMappingURL=get-sentence-template.js.map

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

@@ -0,0 +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;;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

@@ -0,0 +1,32 @@
+import type { AuthContext } from "../../context/auth.js";
+export declare const zudelloGetSentence: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            uuid: {
+                type: string;
+                description: string;
+            };
+            returnDeleted: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+    execute: (input: {
+        uuid: string;
+        returnDeleted?: boolean;
+    }, authContext: AuthContext) => Promise<{
+        success: boolean;
+        sentence: import("../../services/zudello/types.js").ZudelloSentence | undefined;
+        error?: undefined;
+    } | {
+        success: boolean;
+        error: string;
+        sentence?: undefined;
+    }>;
+};
+//# sourceMappingURL=get-sentence.d.ts.map

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

@@ -0,0 +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;;;;;;;;;;;;;;;;;qBAaN;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,aAAa,CAAC,EAAE,OAAO,CAAA;KAAE,eAAe,WAAW;;;;;;;;;CAU3F,CAAC"}

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

@@ -0,0 +1,29 @@
+import { logger } from "../../utils/logger.js";
+import { getZudelloSentence } from "../../services/zudello/sentences.js";
+export const zudelloGetSentence = {
+    name: "zudelloGetSentence",
+    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: {
+            uuid: { type: "string", description: "Sentence UUID" },
+            returnDeleted: { type: "boolean", description: "Include deleted sentences" },
+        },
+        required: ["uuid"],
+    },
+    execute: async (input, authContext) => {
+        try {
+            const response = await getZudelloSentence(authContext, input.uuid, input.returnDeleted ?? false);
+            if (!response.success)
+                throw new Error(response.error || "Failed to get sentence");
+            return { success: true, sentence: response.data };
+        }
+        catch (error) {
+            logger.error("zudelloGetSentence error", { uuid: input.uuid }, error);
+            return { success: false, error: error.message };
+        }
+    },
+};
+//# sourceMappingURL=get-sentence.js.map

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

@@ -0,0 +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;;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/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Sentence/Automation Rules - MCP Tools
+ * Category: sentences
+ * Read Operations: 5 | Write Operations: 3
+ */
+export { zudelloGetSentence } from "./get-sentence.js";
+export { zudelloGetSentenceTemplate } from "./get-sentence-template.js";
+export { zudelloListSentences } from "./list-sentences.js";
+export { zudelloListSentenceTemplates } from "./list-sentence-templates.js";
+export { zudelloListSentenceResources } from "./list-sentence-resources.js";
+export { zudelloCreateSentence } from "./create-sentence.js";
+export { zudelloUpdateSentence } from "./update-sentence.js";
+export { zudelloUpdateSentencesOrder } from "./update-sentences-order.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/sentences/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/sentences/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,0BAA0B,EAAE,MAAM,4BAA4B,CAAC;AACxE,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,4BAA4B,EAAE,MAAM,8BAA8B,CAAC;AAC5E,OAAO,EAAE,4BAA4B,EAAE,MAAM,8BAA8B,CAAC;AAC5E,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,2BAA2B,EAAE,MAAM,6BAA6B,CAAC"}

package/dist/tools/sentences/index.js

@@ -0,0 +1,14 @@
+/**
+ * Sentence/Automation Rules - MCP Tools
+ * Category: sentences
+ * Read Operations: 5 | Write Operations: 3
+ */
+export { zudelloGetSentence } from "./get-sentence.js";
+export { zudelloGetSentenceTemplate } from "./get-sentence-template.js";
+export { zudelloListSentences } from "./list-sentences.js";
+export { zudelloListSentenceTemplates } from "./list-sentence-templates.js";
+export { zudelloListSentenceResources } from "./list-sentence-resources.js";
+export { zudelloCreateSentence } from "./create-sentence.js";
+export { zudelloUpdateSentence } from "./update-sentence.js";
+export { zudelloUpdateSentencesOrder } from "./update-sentences-order.js";
+//# sourceMappingURL=index.js.map

package/dist/tools/sentences/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/sentences/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,0BAA0B,EAAE,MAAM,4BAA4B,CAAC;AACxE,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,4BAA4B,EAAE,MAAM,8BAA8B,CAAC;AAC5E,OAAO,EAAE,4BAA4B,EAAE,MAAM,8BAA8B,CAAC;AAC5E,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,2BAA2B,EAAE,MAAM,6BAA6B,CAAC"}

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

@@ -0,0 +1,46 @@
+import type { AuthContext } from "../../context/auth.js";
+export declare const zudelloListSentenceResources: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            resourceType: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            module: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+    execute: (input: {
+        resourceType: string;
+        module: string;
+    }, authContext: AuthContext) => Promise<{
+        success: boolean;
+        resources: {
+            uuid: string;
+            resource_type: string;
+            payload: {
+                code: string;
+                name: string;
+                template: string;
+                field?: Record<string, unknown>;
+                values?: unknown[];
+                operator?: Record<string, unknown>;
+            };
+        }[] | undefined;
+        count: number;
+        error?: undefined;
+    } | {
+        success: boolean;
+        error: string;
+        resources?: undefined;
+        count?: undefined;
+    }>;
+};
+//# sourceMappingURL=list-sentence-resources.d.ts.map

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

@@ -0,0 +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;;;;;;;;;;;;;;;;;;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

@@ -0,0 +1,41 @@
+import { logger } from "../../utils/logger.js";
+import { listZudelloSentenceResources } from "../../services/zudello/sentences.js";
+export const zudelloListSentenceResources = {
+    name: "zudelloListSentenceResources",
+    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: {
+            resourceType: {
+                type: "string",
+                enum: ["ACTION_TEMPLATE", "CONDITION_TEMPLATE"],
+                description: "Type of sentence resource",
+            },
+            module: { type: "string", description: "Module filter" },
+        },
+        required: ["resourceType", "module"],
+    },
+    execute: async (input, authContext) => {
+        try {
+            const response = await listZudelloSentenceResources(authContext, input.resourceType, input.module);
+            if (!response.success)
+                throw new Error(response.error || "Failed to list resources");
+            return { success: true, resources: response.data, count: response.data?.length || 0 };
+        }
+        catch (error) {
+            logger.error("zudelloListSentenceResources error", input, error);
+            return { success: false, error: error.message };
+        }
+    },
+};
+//# sourceMappingURL=list-sentence-resources.js.map

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

@@ -0,0 +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;;;;;;;;;;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"}