@mgsoftwarebv/mcp-server-bridge 3.3.5 → 3.3.7

package/README.md

@@ -98,11 +98,11 @@ Use **get-teams** to list the providers you can act on and copy a `teamId`.
 - **get-teams** — list the provider teams (workspaces) you can act on; use a returned id as `teamId` on other tools
 
 ### Tickets, Customers & Projects
-- **get-tickets** — list tickets with filters (status, priority, project, customer, text query)
-- **get-ticket-by-id** — fetch one ticket with comment text, a full attachment listing (ids), and inline images (base64)
-- **create-ticket** — create a new ticket
-- **update-ticket** — update fields (title, description, status, priority, type, project, customer, assignee, estimated hours); `assigneeId: null` unassigns
-- **add-ticket-comment** — add a comment (plain text or TipTap JSON); `isInternal` for internal-only notes
+- **get-tickets** — list tickets with filters (status, priority, project, customer, text query); each result includes the ticket ID (UUID) and ticket number
+- **get-ticket-by-id** — fetch one ticket by UUID or ticket number, with comment text, a full attachment listing (ids), and inline images (base64)
+- **create-ticket** — create a new ticket (returns UUID and ticket number)
+- **update-ticket** — update fields (title, description, status, priority, type, project, customer, assignee, estimated hours); accepts UUID or ticket number; `assigneeId: null` unassigns
+- **add-ticket-comment** — add a comment (plain text or TipTap JSON); accepts UUID or ticket number; `isInternal` for internal-only notes
 - **get-ticket-comments** — read all comments as plain text (author, internal flag, timestamp)
 - **get-ticket-attachment** — get a 1-hour signed download URL for any ticket/comment attachment (any file type)
 - **get-customers** — list/search customers

package/dist/index.js

@@ -105508,6 +105508,10 @@ var teamIdProp = {
   type: "string",
   description: "Provider team ID. Optional when you belong to a single provider; required when you belong to several. Call get-teams to list the providers you can act on."
 };
+var ticketIdentifierProp = {
+  type: "string",
+  description: "Ticket ID (UUID) or ticket number (e.g. 2026-REFRO-116). Pass teamId when using a ticket number across multiple providers."
+};
 var TOOLS = [
   {
     name: "get-teams",
@@ -105520,7 +105524,7 @@ var TOOLS = [
   },
   {
     name: "get-tickets",
-    description: "Get tickets with optional filtering by status, priority, project, customer, tags, or search query. Each ticket includes its tags.",
+    description: "Get tickets with optional filtering by status, priority, project, customer, tags, or search query. Each ticket includes its ID (UUID), ticket number, and tags.",
     inputSchema: {
       type: "object",
       properties: {
@@ -105567,12 +105571,12 @@ var TOOLS = [
   },
   {
     name: "get-ticket-by-id",
-    description: "Get a specific ticket by its ID, including tags, comment text and a full attachment listing (with ids). Images from ticket and comment attachments are downloaded and returned inline as base64. For non-image attachments, call get-ticket-attachment with the listed id to get a download URL.",
+    description: "Get a specific ticket by its ID or ticket number, including tags, comment text and a full attachment listing (with ids). Images from ticket and comment attachments are downloaded and returned inline as base64. For non-image attachments, call get-ticket-attachment with the listed id to get a download URL.",
     inputSchema: {
       type: "object",
       properties: {
         teamId: teamIdProp,
-        id: { type: "string", description: "Ticket ID" }
+        id: ticketIdentifierProp
       },
       required: ["id"]
     }
@@ -105642,7 +105646,7 @@ var TOOLS = [
       type: "object",
       properties: {
         teamId: teamIdProp,
-        id: { type: "string", description: "Ticket ID" },
+        id: ticketIdentifierProp,
         title: { type: "string" },
         description: {
           type: "string",
@@ -105844,7 +105848,7 @@ var TOOLS = [
       type: "object",
       properties: {
         teamId: teamIdProp,
-        ticketId: { type: "string", description: "Ticket ID" },
+        ticketId: ticketIdentifierProp,
         content: { type: "string", description: "Comment body" },
         isInternal: { type: "boolean", default: false }
       },
@@ -105858,7 +105862,7 @@ var TOOLS = [
       type: "object",
       properties: {
         teamId: teamIdProp,
-        ticketId: { type: "string", description: "Ticket ID" }
+        ticketId: ticketIdentifierProp
       },
       required: ["ticketId"]
     }
@@ -105886,8 +105890,8 @@ var TOOLS = [
       properties: {
         teamId: teamIdProp,
         ticketId: {
-          type: "string",
-          description: "Ticket ID (UUID) to attach the file to."
+          ...ticketIdentifierProp,
+          description: "Ticket ID (UUID) or ticket number to attach the file to."
         },
         filePath: {
           type: "string",
@@ -106688,17 +106692,87 @@ async function resolveTeamScope(requestedTeamId) {
 }
 
 // src/tools/ticket-access.ts
-function notFoundResponse(ticketId) {
+var UUID_REGEX = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+function isUuid(value) {
+  return UUID_REGEX.test(value);
+}
+function notFoundResponse(identifier) {
   return {
     content: [
       {
         type: "text",
-        text: `Ticket not found or no access: ${ticketId}. Call get-tickets to find the correct ticket.`
+        text: `Ticket not found or no access: ${identifier}. Call get-tickets to find the correct ticket.`
       }
     ]
   };
 }
+function multipleMatchesResponse(identifier, matches) {
+  const list = matches.map((t8) => `- **${t8.ticketNumber}** (ID: ${t8.id}): ${t8.title}`).join("\n");
+  return {
+    content: [
+      {
+        type: "text",
+        text: `Multiple tickets match "${identifier}":
+${list}
+
+Pass a more specific ticket number or include \`teamId\` to disambiguate.`
+      }
+    ]
+  };
+}
+var ticketLookupFields = {
+  id: schema_exports.tickets.id,
+  ticketNumber: schema_exports.tickets.ticketNumber,
+  title: schema_exports.tickets.title
+};
+async function resolveTicketIdentifier(requestedTeamId, identifier) {
+  if (isUuid(identifier)) {
+    return { ok: true, id: identifier };
+  }
+  const scope = await resolveTeamScope(requestedTeamId);
+  if (!scope.ok) return scope;
+  const accessPredicate = buildTicketAccessPredicate(
+    scope.teamIds,
+    scope.projectIds,
+    scope.customerIds
+  );
+  const baseFilters = [
+    accessPredicate,
+    eq(schema_exports.tickets.isDeleted, false)
+  ];
+  const exactMatches = await db.select(ticketLookupFields).from(schema_exports.tickets).where(
+    and(
+      ...baseFilters,
+      sql`lower(${schema_exports.tickets.ticketNumber}) = lower(${identifier})`
+    )
+  ).limit(5);
+  let matches = exactMatches;
+  if (matches.length === 0) {
+    matches = await db.select(ticketLookupFields).from(schema_exports.tickets).where(
+      and(...baseFilters, ilike(schema_exports.tickets.ticketNumber, `%${identifier}%`))
+    ).limit(5);
+  }
+  if (matches.length === 0) {
+    return {
+      ok: false,
+      response: {
+        content: [
+          {
+            type: "text",
+            text: `No ticket found with number "${identifier}". Call get-tickets to search by title or keyword.`
+          }
+        ]
+      }
+    };
+  }
+  if (matches.length > 1) {
+    return { ok: false, response: multipleMatchesResponse(identifier, matches) };
+  }
+  return { ok: true, id: matches[0].id };
+}
 async function loadAccessibleTicket(requestedTeamId, ticketId) {
+  const resolved = await resolveTicketIdentifier(requestedTeamId, ticketId);
+  if (!resolved.ok) return resolved;
   const scope = await resolveTeamScope(requestedTeamId);
   if (!scope.ok) return scope;
   const [ticket] = await db.select({
@@ -106712,7 +106786,7 @@ async function loadAccessibleTicket(requestedTeamId, ticketId) {
     priority: schema_exports.tickets.priority,
     type: schema_exports.tickets.type,
     assigneeId: schema_exports.tickets.assigneeId
-  }).from(schema_exports.tickets).where(eq(schema_exports.tickets.id, ticketId)).limit(1);
+  }).from(schema_exports.tickets).where(eq(schema_exports.tickets.id, resolved.id)).limit(1);
   if (!ticket) return { ok: false, response: notFoundResponse(ticketId) };
   const hasAccess = scope.teamIds.includes(ticket.teamId) || !!ticket.projectId && scope.projectIds.includes(ticket.projectId) || !!ticket.customerId && scope.customerIds.includes(ticket.customerId);
   if (!hasAccess) return { ok: false, response: notFoundResponse(ticketId) };
@@ -119809,6 +119883,10 @@ function tiptapToPlainText(content) {
   if (doc?.type !== "doc" || !Array.isArray(doc.content)) return content;
   return doc.content.map(renderNode).join("").trim();
 }
+function descriptionPlainText(content) {
+  const text3 = tiptapToPlainText(content).trim();
+  return text3 || null;
+}
 
 // src/tools/ticket-comments.ts
 async function handleAddTicketComment(input) {
@@ -120462,6 +120540,7 @@ async function handleGetTickets(input) {
 ${rows.map((t8) => {
           const ticketTags2 = tagsByTicket.get(t8.id) ?? [];
           return `**${t8.ticketNumber}**: ${t8.title}
+ID: ${t8.id}
 Status: ${t8.status} | Priority: ${t8.priority}
 ${ticketTags2.length > 0 ? `Tags: ${formatTagList(ticketTags2)}
 ` : ""}${t8.projectName ? `Project: ${t8.projectName}
@@ -120475,11 +120554,13 @@ ${ticketTags2.length > 0 ? `Tags: ${formatTagList(ticketTags2)}
 }
 async function handleGetTicketById(input) {
   const { id } = input;
+  const resolved = await resolveTicketIdentifier(input.teamId, id);
+  if (!resolved.ok) return resolved.response;
   const scope = await resolveTeamScope(input.teamId);
   if (!scope.ok) return scope.response;
   const { teamIds, projectIds, customerIds } = scope;
   const ticketRow = await db.query.tickets.findFirst({
-    where: eq(schema_exports.tickets.id, id),
+    where: eq(schema_exports.tickets.id, resolved.id),
     with: {
       project: { columns: { id: true, name: true } },
       customer: { columns: { id: true, name: true } },
@@ -120587,6 +120668,7 @@ ${text3.split("\n").map((l4) => `     ${l4}`).join("\n")}`;
   const tagsLine = ticketTags2.length > 0 ? `Tags: ${formatTagList(ticketTags2)}
 ` : `Tags: (none)
 `;
+  const descriptionText = descriptionPlainText(ticketRow.description);
   const content = [
     {
       type: "text",
@@ -120599,7 +120681,7 @@ Status: ${ticketRow.status}
 Priority: ${ticketRow.priority}
 Type: ${ticketRow.type}
 ${ticketRow.dueDate ? `Deadline: ${new Date(ticketRow.dueDate).toLocaleDateString()}
-` : ""}${ticketRow.description ? `Description: ${tiptapToPlainText(ticketRow.description)}
+` : ""}${descriptionText ? `Description: ${descriptionText}
 ` : ""}${ticketRow.project?.name ? `Project: ${ticketRow.project.name}
 ` : ""}${ticketRow.customer?.name ? `Customer: ${ticketRow.customer.name}
 ` : ""}` + tagsLine + assigneeLine + requesterLine + `Created: ${new Date(ticketRow.createdAt).toLocaleDateString()}
@@ -120743,7 +120825,7 @@ async function handleCreateTicket(input) {
     teamId: resolvedTeamId,
     ticketNumber,
     title,
-    description: description ?? null,
+    description: ensureTipTapFormat(description),
     status,
     priority,
     type,
@@ -120786,7 +120868,7 @@ async function handleCreateTicket(input) {
         text: `\u2705 **Ticket Created Successfully!**
 
 Ticket Number: **${created.ticketNumber}**
-ID: ${created.id}
+Ticket id: ${created.id}
 Title: ${title}
 Status: ${status}
 Priority: ${priority}