freshservice-mcp 0.2.0 → 0.2.2

package/README.md

@@ -207,6 +207,8 @@ Freshservice Changes use numeric values for their standard fields:
 
 `associate_tickets_to_change` uses the association shape documented by Freshservice's Ticket API. The default relationship, `change_initiated_by_ticket`, means the ticket initiated the Change. Use `association_type: "change_initiating_ticket"` when the Change initiated the ticket. `change_id` is placed in the documented nested `display_id` field.
 
+Because the association is applied as a ticket update, Freshservice validates the whole ticket — so on an instance where `description` is a mandatory field, a ticket with an empty description would otherwise be rejected with a 400. The tool handles this transparently: it retries once with a minimal placeholder description, and only for tickets that genuinely have none. Existing descriptions are never overwritten.
+
 ## Local Development
 
 ```bash

package/dist/index.js

@@ -11180,12 +11180,29 @@ async function updateChange(config2, changeId, payload) {
 async function associateTicketsToChange(config2, changeDisplayId, ticketIds, associationType = "change_initiated_by_ticket") {
   return Promise.all(
     ticketIds.map(
-      (ticketId) => updateTicket(config2, ticketId, {
-        [associationType]: { display_id: changeDisplayId }
-      })
+      (ticketId) => associateOneTicket(config2, ticketId, changeDisplayId, associationType)
     )
   );
 }
+function isBlankDescriptionError(error2) {
+  const message = error2 instanceof Error ? error2.message : String(error2);
+  return message.includes("400") && message.includes('"field":"description"') && message.toLowerCase().includes("blank");
+}
+async function associateOneTicket(config2, ticketId, changeDisplayId, associationType) {
+  const association = { [associationType]: { display_id: changeDisplayId } };
+  try {
+    return await updateTicket(config2, ticketId, association);
+  } catch (error2) {
+    if (!isBlankDescriptionError(error2)) throw error2;
+    const existing = await getTicket(config2, ticketId);
+    const currentDescription = existing.description_text?.trim() || stripHtml(existing.description ?? "");
+    if (currentDescription) throw error2;
+    return updateTicket(config2, ticketId, {
+      ...association,
+      description: BLANK_DESCRIPTION_PLACEHOLDER
+    });
+  }
+}
 async function addChangeNote(config2, changeId, payload) {
   const data = await fsPost(
     config2,
@@ -11206,10 +11223,11 @@ async function listAgents(config2, options = {}) {
   const data = await fsGet(config2, "agents", params);
   return data.agents ?? [];
 }
-var DEFAULT_STATUS_MAP, PRIORITY_MAP, CHANGE_PRIORITY_MAP, CHANGE_STATUS_MAP, CHANGE_TYPE_MAP, CHANGE_IMPACT_MAP, CHANGE_RISK_MAP;
+var BLANK_DESCRIPTION_PLACEHOLDER, DEFAULT_STATUS_MAP, PRIORITY_MAP, CHANGE_PRIORITY_MAP, CHANGE_STATUS_MAP, CHANGE_TYPE_MAP, CHANGE_IMPACT_MAP, CHANGE_RISK_MAP;
 var init_freshservice_client = __esm({
   "src/freshservice-client.ts"() {
     "use strict";
+    BLANK_DESCRIPTION_PLACEHOLDER = ".";
     DEFAULT_STATUS_MAP = {
       2: "Open",
       3: "Pending",
@@ -21857,7 +21875,7 @@ ${JSON.stringify(normalizeChange(change), null, 2)}`
     "associate_tickets_to_change",
     {
       title: "Associate Tickets to Change",
-      description: "Associate existing tickets with a Change by updating each ticket using Freshservice's documented Change association object.",
+      description: "Associate existing tickets with a Change by updating each ticket using Freshservice's documented Change association object. A ticket whose description is empty on an instance where description is mandatory is retried once with a minimal placeholder description so the association still lands; existing descriptions are never overwritten.",
       inputSchema: external_exports.object({
         change_id: external_exports.number().int().positive().describe(
           "Change display ID (Freshservice requires display_id in the association body)"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "freshservice-mcp",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "MCP server for Freshservice – manage tickets, changes, agents and conversations from any MCP-compatible AI client",
   "keywords": [
     "mcp",