@bgx4k3p/huly-mcp-server 2.1.0 → 2.2.0

package/README.md

@@ -1,5 +1,6 @@
 # Huly MCP Server
 
+[![npm](https://img.shields.io/npm/v/@bgx4k3p/huly-mcp-server?logo=npm&logoColor=white)](https://www.npmjs.com/package/@bgx4k3p/huly-mcp-server)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
 [![Node.js](https://img.shields.io/badge/Node.js-22+-339933?logo=node.js&logoColor=white)](https://nodejs.org)
 [![MCP](https://img.shields.io/badge/MCP-compatible-blue)](https://modelcontextprotocol.io)

package/node_modules/@msgpackr-extract/msgpackr-extract-linux-x64/README.md

@@ -0,0 +1 @@
+Platform specific binary for msgpackr-extract on linux OS with x64 architecture

package/node_modules/@msgpackr-extract/{msgpackr-extract-darwin-x64 → msgpackr-extract-linux-x64}/package.json

@@ -1,8 +1,8 @@
 {
-  "name": "@msgpackr-extract/msgpackr-extract-darwin-x64",
+  "name": "@msgpackr-extract/msgpackr-extract-linux-x64",
   "version": "3.0.3",
   "os": [
-    "darwin"
+    "linux"
   ],
   "cpu": [
     "x64"
@@ -13,5 +13,5 @@
     "type": "git",
     "url": "http://github.com/kriszyp/msgpackr-extract"
   },
-  "description": "Platform specific binary for msgpackr-extract on darwin OS with x64 architecture"
+  "description": "Platform specific binary for msgpackr-extract on linux OS with x64 architecture"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bgx4k3p/huly-mcp-server",
-  "version": "2.1.0",
+  "version": "2.2.0",
   "description": "MCP server for Huly issue tracking with stdio and Streamable HTTP transports",
   "type": "module",
   "license": "MIT",
@@ -38,8 +38,10 @@
     "test": "HULY_TRANSPORT=ws node --test test/integration.test.mjs && HULY_TRANSPORT=rest node --test test/integration.test.mjs",
     "test:ws": "HULY_TRANSPORT=ws node --test test/integration.test.mjs",
     "test:rest": "HULY_TRANSPORT=rest node --test test/integration.test.mjs",
+    "lint": "eslint src/ scripts/",
     "postinstall": "node scripts/patch-sdk.mjs",
-    "pack": "node scripts/pack.mjs"
+    "pack": "node scripts/pack.mjs",
+    "version:sync": "node -e \"const{readFileSync:r,writeFileSync:w}=require('fs');const v=r('VERSION','utf-8').trim();const f='package.json';const j=JSON.parse(r(f,'utf-8'));j.version=v;w(f,JSON.stringify(j,null,2)+'\\n');console.log('Synced version '+v+' to package.json')\""
   },
   "dependencies": {
     "@hcengineering/api-client": "^0.7.3",
@@ -58,5 +60,8 @@
     "@hcengineering/tags",
     "@hcengineering/task",
     "@hcengineering/tracker"
-  ]
+  ],
+  "devDependencies": {
+    "eslint": "^10.1.0"
+  }
 }

package/src/client.mjs

@@ -7,10 +7,12 @@
 import {
   PRIORITY_MAP, PRIORITY_NAMES,
   MILESTONE_STATUS_MAP, MILESTONE_STATUS_NAMES,
-  COLOR_PALETTE, resolveColor,
+  resolveColor,
   DONE_CATEGORY, LOST_CATEGORY, STATUS_CATEGORY_NAMES,
   DEFAULT_LABEL_CATEGORY, DEFAULT_LABEL_COLOR,
   PAGE_SIZE, MAX_BATCH_SIZE, AUTH_CACHE_TTL_MS, DEFAULT_MILESTONE_DAYS,
+  DEFAULT_PAGE_SIZE, DEFAULT_DETAIL_PAGE_SIZE,
+  encodeCursor, decodeCursor,
   nameMatch, strictGet, withExtra,
   toCollaboratorMarkup, fromCollaboratorMarkup,
   toMarkup, fromMarkup
@@ -749,7 +751,11 @@ export class HulyClient {
     if (projectType?.tasks?.length) {
       const taskTypes = await client.findAll(task.class.TaskType, {});
       const scoped = taskTypes.filter(tt => projectType.tasks.includes(tt._id));
-      if (scoped.length) return scoped[0]._id;
+      if (scoped.length) {
+        // Prefer the type named "Task" (the common default), not the first in list (often Epic)
+        const taskType = scoped.find(tt => nameMatch(tt.name || tt._id.split(':').pop(), 'Task'));
+        return (taskType || scoped[0])._id;
+      }
     }
 
     throw new Error(
@@ -785,18 +791,23 @@ export class HulyClient {
    * The SDK's findAll has a server-side page limit. If limit exceeds
    * the page size, this fetches multiple pages using createdOn cursor.
    */
+  /**
+   * Paginated findAll with cursor support.
+   * Fetches from the SDK in PAGE_SIZE batches, returns { items, nextCursor? }.
+   * @param {Object} client - SDK client
+   * @param {string} _class - Document class
+   * @param {Object} query - Query filter
+   * @param {Object} options - { limit, cursor, ...findAllOptions }
+   * @returns {{ items: Object[], nextCursor?: string }}
+   */
   async _paginatedFindAll(client, _class, query, options = {}) {
-    const limit = options.limit || PAGE_SIZE;
+    const limit = options.limit || DEFAULT_PAGE_SIZE;
+    let lastCreatedOn = options.cursor
+      ? decodeCursor(options.cursor).createdOn
+      : undefined;
 
-    // If within a single page, just fetch directly
-    if (limit <= PAGE_SIZE) {
-      return await client.findAll(_class, query, options);
-    }
-
-    // Fetch in pages using createdOn as cursor
     const allResults = [];
-    let remaining = limit;
-    let lastCreatedOn = undefined;
+    let remaining = limit + 1; // fetch one extra to detect next page
 
     while (remaining > 0) {
       const pageLimit = Math.min(remaining, PAGE_SIZE);
@@ -817,11 +828,42 @@ export class HulyClient {
       remaining -= page.length;
       lastCreatedOn = page[page.length - 1].createdOn;
 
-      // If we got less than requested, no more pages
       if (page.length < pageLimit) break;
     }
 
-    return allResults;
+    // If we got more than limit, there are more results
+    if (allResults.length > limit) {
+      const items = allResults.slice(0, limit);
+      return { items, nextCursor: encodeCursor(items[items.length - 1].createdOn) };
+    }
+
+    return { items: allResults };
+  }
+
+  /**
+   * In-memory cursor pagination for small collections fetched via findAll.
+   * Filters by cursor, sorts by createdOn desc, slices to limit.
+   * @param {Object[]} allResults - Full result set from findAll
+   * @param {Object} options - { cursor?, limit? }
+   * @returns {{ items: Object[], nextCursor?: string }}
+   */
+  _cursoredFindAll(allResults, options = {}) {
+    const { cursor, limit = DEFAULT_PAGE_SIZE } = options;
+    let items = [...allResults];
+
+    if (cursor) {
+      const { createdOn } = decodeCursor(cursor);
+      items = items.filter(r => r.createdOn < createdOn);
+    }
+
+    items.sort((a, b) => b.createdOn - a.createdOn);
+
+    if (items.length > limit) {
+      const page = items.slice(0, limit);
+      return { items: page, nextCursor: encodeCursor(page[page.length - 1].createdOn) };
+    }
+
+    return { items };
   }
 
   async _findEmployeeByName(client, name) {
@@ -921,8 +963,7 @@ export class HulyClient {
     const projects = await client.findAll(tracker.class.Project, {});
 
     if (!options.include_details) {
-      // Count issues per project efficiently using the project's own sequence counter
-      return projects.map(project => withExtra(project, {
+      const enriched = projects.map(project => withExtra(project, {
         id: project._id,
         identifier: project.identifier,
         name: project.name || project.identifier,
@@ -934,6 +975,7 @@ export class HulyClient {
         createdOn: project.createdOn,
         modifiedOn: project.modifiedOn
       }));
+      return this._cursoredFindAll(enriched, options);
     }
 
     // Detailed mode: batch fetch all related data once, then group by project
@@ -960,7 +1002,7 @@ export class HulyClient {
       componentsByProject.get(c.space).push(c);
     }
 
-    return limitedProjects.map(project => {
+    const detailed = limitedProjects.map(project => {
       const projMilestones = (milestonesByProject.get(project._id) || []).map(m => ({
         name: m.label,
         status: strictGet(MILESTONE_STATUS_NAMES, m.status, 'Milestone status'),
@@ -993,6 +1035,7 @@ export class HulyClient {
         labels: projLabels
       });
     });
+    return this._cursoredFindAll(detailed, options);
   }
 
   /**
@@ -1067,9 +1110,9 @@ export class HulyClient {
    * @param {number} [limit=500] - Maximum number of issues
    * @returns {Promise<Object[]>}
    */
-  async listIssues(project, status, priority, label, milestone, limit, include_details = false) {
+  async listIssues(project, status, priority, label, milestone, limit, include_details = false, cursor) {
     if (limit === undefined || limit === null) {
-      limit = include_details ? 50 : 500;
+      limit = include_details ? DEFAULT_DETAIL_PAGE_SIZE : DEFAULT_PAGE_SIZE;
     }
     const client = await this._getClient();
 
@@ -1112,10 +1155,11 @@ export class HulyClient {
       }
     }
 
-    let issues = await this._paginatedFindAll(client, tracker.class.Issue, query, {
-      limit,
-      sort: { modifiedOn: -1 }
+    const fetchResult = await this._paginatedFindAll(client, tracker.class.Issue, query, {
+      limit, cursor
     });
+    const issues = fetchResult.items;
+    const nextCursor = fetchResult.nextCursor;
 
     let labelFilter = null;
     if (label) {
@@ -1267,7 +1311,9 @@ export class HulyClient {
       result.push(withExtra(issue, entry));
     }
 
-    return result;
+    const response = { items: result };
+    if (nextCursor) response.nextCursor = nextCursor;
+    return response;
   }
 
   /**
@@ -1650,20 +1696,21 @@ export class HulyClient {
    * List all available labels for issues.
    * @returns {Promise<Object[]>}
    */
-  async listLabels() {
+  async listLabels(options = {}) {
     const client = await this._getClient();
 
     const tagElements = await client.findAll(tags.class.TagElement, {
       targetClass: tracker.class.Issue
     });
 
-    return tagElements.map(t => withExtra(t, {
+    const enriched = tagElements.map(t => withExtra(t, {
       id: t._id,
       name: t.title,
       description: t.description || '',
       color: t.color ? `#${t.color.toString(16).padStart(6, '0')}` : null,
       category: t.category || null
     }));
+    return this._cursoredFindAll(enriched, options);
   }
 
   /**
@@ -1894,7 +1941,7 @@ export class HulyClient {
    * @param {string} projectIdent - Project identifier
    * @returns {Promise<Object[]>}
    */
-  async listTaskTypes(projectIdent) {
+  async listTaskTypes(projectIdent, options = {}) {
     const client = await this._getClient();
 
     const project = await client.findOne(tracker.class.Project, {
@@ -1923,7 +1970,7 @@ export class HulyClient {
       );
     }
 
-    return typesToReturn.map(tt => ({
+    const enriched = typesToReturn.map(tt => ({
       id: tt._id,
       name: tt.name || tt._id.split(':').pop(),
       description: fromMarkup(tt.description),
@@ -1934,6 +1981,7 @@ export class HulyClient {
       statusCategories: tt.statusCategories || [],
       statuses: tt.statuses || []
     }));
+    return this._cursoredFindAll(enriched, options);
   }
 
   /**
@@ -1942,20 +1990,21 @@ export class HulyClient {
    * @param {string} [taskTypeName] - Task type name to scope statuses (e.g., "Task", "Epic")
    * @returns {Promise<Object[]>}
    */
-  async listStatuses(projectIdent, taskTypeName) {
+  async listStatuses(projectIdent, taskTypeName, options = {}) {
     const client = await this._getClient();
 
     const allStatuses = await client.findAll(tracker.class.IssueStatus, {});
 
     // If no scoping requested, return all
     if (!projectIdent && !taskTypeName) {
-      return allStatuses.map(s => ({
+      const enriched = allStatuses.map(s => ({
         id: s._id,
         name: s.name,
         category: STATUS_CATEGORY_NAMES[s.category] || s.category,
         color: s.color,
         description: fromMarkup(s.description)
       }));
+      return this._cursoredFindAll(enriched, options);
     }
 
     // Get task types scoped to this project
@@ -1996,13 +2045,14 @@ export class HulyClient {
       ? allStatuses.filter(s => statusIds.has(s._id))
       : allStatuses;
 
-    return scopedStatuses.map(s => ({
+    const enriched = scopedStatuses.map(s => ({
       id: s._id,
       name: s.name,
       category: STATUS_CATEGORY_NAMES[s.category] || s.category,
       color: s.color,
       description: s.description || ''
     }));
+    return this._cursoredFindAll(enriched, options);
   }
 
   /**
@@ -2036,7 +2086,7 @@ export class HulyClient {
     });
 
     if (!options.include_details) {
-      return milestones.map(m => withExtra(m, {
+      const enriched = milestones.map(m => withExtra(m, {
         id: m._id,
         name: m.label,
         description: fromMarkup(m.description),
@@ -2044,6 +2094,7 @@ export class HulyClient {
         targetDate: m.targetDate ? new Date(m.targetDate).toISOString().split('T')[0] : null,
         comments: m.comments || 0
       }));
+      return this._cursoredFindAll(enriched, options);
     }
 
     // Detailed mode: batch fetch all issues for the project, then group by milestone
@@ -2059,7 +2110,7 @@ export class HulyClient {
       }
     }
 
-    return milestones.map(m => {
+    const detailed = milestones.map(m => {
       const mIssues = (issuesByMilestone.get(m._id) || []).map(i => ({
         id: `${project.identifier}-${i.number}`,
         title: i.title,
@@ -2077,6 +2128,7 @@ export class HulyClient {
         issues: mIssues
       });
     });
+    return this._cursoredFindAll(detailed, options);
   }
 
   /**
@@ -2253,16 +2305,17 @@ export class HulyClient {
    * List all active workspace members.
    * @returns {Promise<Object[]>}
    */
-  async listMembers() {
+  async listMembers(options = {}) {
     const client = await this._getClient();
     const employees = await client.findAll(contactPlugin.mixin.Employee, { active: true });
-    return employees.map(e => withExtra(e, {
+    const enriched = employees.map(e => withExtra(e, {
       id: e._id,
       name: e.name,
       email: e.channels?.[0]?.value || null,
       role: e.role || 'USER',
       position: e.position || null
     }));
+    return this._cursoredFindAll(enriched, options);
   }
 
   /**
@@ -2326,7 +2379,7 @@ export class HulyClient {
    * @param {string} issueId - Issue identifier
    * @returns {Promise<Object[]>}
    */
-  async listComments(issueId) {
+  async listComments(issueId, options = {}) {
     const client = await this._getClient();
     const { issue } = await this._parseAndFindIssue(client, issueId);
 
@@ -2334,13 +2387,14 @@ export class HulyClient {
       attachedTo: issue._id
     }, { sort: { createdOn: 1 } });
 
-    return comments.map(c => withExtra(c, {
+    const enriched = comments.map(c => withExtra(c, {
       id: c._id,
       text: fromMarkup(c.message),
       createdBy: c.createdBy || null,
       createdOn: c.createdOn,
       modifiedOn: c.modifiedOn
     }));
+    return this._cursoredFindAll(enriched, options);
   }
 
   /**
@@ -2574,10 +2628,10 @@ export class HulyClient {
       }
     }
 
-    let issues = await this._paginatedFindAll(client, tracker.class.Issue, query, {
-      limit,
-      sort: { modifiedOn: -1 }
+    const fetchResult = await this._paginatedFindAll(client, tracker.class.Issue, query, {
+      limit
     });
+    const issues = fetchResult.items;
 
     const projects = await client.findAll(tracker.class.Project, {});
     const projMap = new Map(projects.map(p => [p._id, p.identifier]));
@@ -3367,7 +3421,7 @@ export class HulyClient {
 
   // ── Components ──────────────────────────────────────────────
 
-  async listComponents(projectIdent) {
+  async listComponents(projectIdent, options = {}) {
     const client = await this._getClient();
     const project = await client.findOne(tracker.class.Project, {
       identifier: projectIdent.toUpperCase()
@@ -3376,12 +3430,13 @@ export class HulyClient {
 
     const components = await client.findAll(tracker.class.Component, { space: project._id });
 
-    return components.map(c => withExtra(c, {
+    const enriched = components.map(c => withExtra(c, {
       id: c._id,
       name: c.label,
       description: fromMarkup(c.description),
       lead: c.lead || null
     }));
+    return this._cursoredFindAll(enriched, options);
   }
 
   async createComponent(projectIdent, name, description, lead, format) {
@@ -3486,7 +3541,7 @@ export class HulyClient {
 
   // ── Time Reports ────────────────────────────────────────────
 
-  async listTimeReports(issueId) {
+  async listTimeReports(issueId, options = {}) {
     const client = await this._getClient();
     const { issue } = await this._parseAndFindIssue(client, issueId);
 
@@ -3494,12 +3549,13 @@ export class HulyClient {
       attachedTo: issue._id
     }, { sort: { date: -1 } });
 
-    return reports.map(r => withExtra(r, {
+    const enriched = reports.map(r => withExtra(r, {
       id: r._id,
       hours: r.value,
       description: fromMarkup(r.description),
       date: r.date ? new Date(r.date).toISOString() : null
     }));
+    return this._cursoredFindAll(enriched, options);
   }
 
   async deleteTimeReport(reportId) {
@@ -3508,17 +3564,9 @@ export class HulyClient {
     const report = await client.findOne(tracker.class.TimeSpendReport, { _id: reportId });
     if (!report) throw new Error(`Time report not found: ${reportId}`);
 
-    // Update the issue's reportedTime
-    if (report.attachedTo) {
-      const issue = await client.findOne(tracker.class.Issue, { _id: report.attachedTo });
-      if (issue) {
-        const newReported = Math.max(0, (issue.reportedTime || 0) - (report.value || 0));
-        await client.updateDoc(tracker.class.Issue, issue.space, issue._id, {
-          reportedTime: newReported
-        });
-      }
-    }
-
+    // The transactor automatically decrements reportedTime on the issue
+    // when a TimeSpendReport is removed via removeCollection — do NOT
+    // manually update reportedTime here or it gets decremented twice.
     await client.removeCollection(tracker.class.TimeSpendReport, report.space, report._id, report.attachedTo, report.attachedToClass, report.collection);
 
     return {

package/src/dispatch.mjs

@@ -78,11 +78,11 @@ export const accountTools = {
  */
 export const workspaceTools = {
   list_projects: (a, c) =>
-    c.listProjects({ include_details: a.include_details }),
+    c.listProjects({ include_details: a.include_details, cursor: a.cursor, limit: a.limit }),
   get_project: (a, c) =>
     c.getProject(a.project, { include_details: a.include_details }),
   list_issues: (a, c) =>
-    c.listIssues(a.project, a.status, a.priority, a.label, a.milestone, a.limit, a.include_details),
+    c.listIssues(a.project, a.status, a.priority, a.label, a.milestone, a.limit, a.include_details, a.cursor),
   get_issue: (a, c) =>
     c.getIssue(a.issueId, { include_details: a.include_details }),
   create_issue: (a, c) =>
@@ -113,7 +113,7 @@ export const workspaceTools = {
   // Labels
   add_label: (a, c) => c.addLabel(a.issueId, a.label),
   remove_label: (a, c) => c.removeLabel(a.issueId, a.label),
-  list_labels: (a, c) => c.listLabels(),
+  list_labels: (a, c) => c.listLabels({ cursor: a.cursor, limit: a.limit }),
   create_label: (a, c) => c.createLabel(a.name, a.color, a.description),
   update_label: (a, c) =>
     c.updateLabel(a.name, { newName: a.newName, color: a.color, description: a.description }),
@@ -121,14 +121,14 @@ export const workspaceTools = {
   // Relations
   add_relation: (a, c) => c.addRelation(a.issueId, a.relatedToIssueId),
   add_blocked_by: (a, c) => c.addBlockedBy(a.issueId, a.blockedByIssueId),
-  set_parent: (a, c) => c.setParent(a.issueId, a.parentIssueId),
+  set_parent: (a, c) => c.setParent(a.issueId, a.parentId),
 
   // Task types & statuses
-  list_task_types: (a, c) => c.listTaskTypes(a.project),
-  list_statuses: (a, c) => c.listStatuses(a.project, a.taskType),
+  list_task_types: (a, c) => c.listTaskTypes(a.project, { cursor: a.cursor, limit: a.limit }),
+  list_statuses: (a, c) => c.listStatuses(a.project, a.taskType, { cursor: a.cursor, limit: a.limit }),
 
   // Milestones
-  list_milestones: (a, c) => c.listMilestones(a.project, a.status, { include_details: a.include_details }),
+  list_milestones: (a, c) => c.listMilestones(a.project, a.status, { include_details: a.include_details, cursor: a.cursor, limit: a.limit }),
   get_milestone: (a, c) => c.getMilestone(a.project, a.name, { include_details: a.include_details }),
   create_milestone: (a, c) =>
     c.createMilestone(a.project, a.name, a.description, a.targetDate, a.status, a.descriptionFormat),
@@ -141,17 +141,17 @@ export const workspaceTools = {
   delete_milestone: (a, c) => c.deleteMilestone(a.project, a.name),
 
   // Members
-  list_members: (a, c) => c.listMembers(),
+  list_members: (a, c) => c.listMembers({ cursor: a.cursor, limit: a.limit }),
 
   // Comments
   add_comment: (a, c) => c.addComment(a.issueId, a.text, a.format),
-  list_comments: (a, c) => c.listComments(a.issueId),
+  list_comments: (a, c) => c.listComments(a.issueId, { cursor: a.cursor, limit: a.limit }),
   update_comment: (a, c) => c.updateComment(a.issueId, a.commentId, a.text, a.format),
   delete_comment: (a, c) => c.deleteComment(a.issueId, a.commentId),
 
   // Time tracking
   log_time: (a, c) => c.logTime(a.issueId, a.hours, a.description, a.descriptionFormat, a.date, a.employee),
-  list_time_reports: (a, c) => c.listTimeReports(a.issueId),
+  list_time_reports: (a, c) => c.listTimeReports(a.issueId, { cursor: a.cursor, limit: a.limit }),
   delete_time_report: (a, c) => c.deleteTimeReport(a.reportId),
 
   // Projects
@@ -166,7 +166,7 @@ export const workspaceTools = {
   delete_project: (a, c) => c.deleteProject(a.project),
 
   // Components
-  list_components: (a, c) => c.listComponents(a.project),
+  list_components: (a, c) => c.listComponents(a.project, { cursor: a.cursor, limit: a.limit }),
   create_component: (a, c) =>
     c.createComponent(a.project, a.name, a.description, a.lead, a.descriptionFormat),
   update_component: (a, c) =>

package/src/helpers.mjs

@@ -100,6 +100,30 @@ export const PAGE_SIZE = 500;
 export const MAX_BATCH_SIZE = 500;
 export const AUTH_CACHE_TTL_MS = 600000;
 export const DEFAULT_MILESTONE_DAYS = 30;
+export const DEFAULT_PAGE_SIZE = 50;
+export const DEFAULT_DETAIL_PAGE_SIZE = 20;
+
+/**
+ * Encode a pagination cursor from a createdOn timestamp.
+ * Returns an opaque base64url string.
+ */
+export function encodeCursor(createdOn) {
+  return Buffer.from(JSON.stringify({ createdOn })).toString('base64url');
+}
+
+/**
+ * Decode a pagination cursor back to { createdOn }.
+ * Throws on invalid input.
+ */
+export function decodeCursor(cursor) {
+  try {
+    const parsed = JSON.parse(Buffer.from(cursor, 'base64url').toString());
+    if (typeof parsed.createdOn !== 'number') throw new Error();
+    return parsed;
+  } catch {
+    throw new Error('Invalid pagination cursor');
+  }
+}
 
 /**
  * Resolve a color value: name ("blue"), palette index (9), or RGB (0x5E6AD2).

package/src/mcpShared.mjs

@@ -31,6 +31,18 @@ const workspaceProp = {
   }
 };
 
+// Pagination properties for all list tools
+const paginationProps = {
+  cursor: {
+    type: 'string',
+    description: 'Opaque pagination cursor from a previous response\'s nextCursor field. Omit for the first page.'
+  },
+  limit: {
+    type: 'number',
+    description: 'Maximum items per page (default: 50, or 20 with include_details)'
+  }
+};
+
 // ── Tool Definitions ──────────────────────────────────────────
 
 export { workspaceProp };
@@ -112,9 +124,9 @@ export function createMcpServer(capabilities = {}) {
   server.setRequestHandler(ListResourcesRequestSchema, async () => {
     try {
       const client = await pool.getClient();
-      const projects = await client.withReconnect(() => client.listProjects());
+      const result = await client.withReconnect(() => client.listProjects());
       return {
-        resources: projects.map(p => ({
+        resources: result.items.map(p => ({
           uri: `huly://projects/${p.identifier}`,
           name: `${p.identifier}: ${p.name}`,
           description: `Project with ${p.issueCount} issues`,
@@ -324,7 +336,7 @@ function getToolDefinitions() {
     {
       name: 'list_projects',
       description: 'List all projects in the Huly workspace. Returns each project\'s identifier (e.g., "PROJ"), display name, and total issue count. Use this first to discover available projects before querying issues. Set include_details=true to also fetch milestones, components, labels, and member names for each project (limited to 20 projects).',
-      inputSchema: { type: 'object', properties: { include_details: { type: 'boolean', description: 'Include milestones, components, labels, and members for each project (default: false). Limits to 20 projects.' }, ...workspaceProp }, required: [] }
+      inputSchema: { type: 'object', properties: { include_details: { type: 'boolean', description: 'Include milestones, components, labels, and members for each project (default: false). Limits to 20 projects.' }, ...paginationProps, ...workspaceProp }, required: [] }
     },
     {
       name: 'get_project',
@@ -333,8 +345,8 @@ function getToolDefinitions() {
     },
     {
       name: 'list_issues',
-      description: 'List issues in a project with optional filtering. Returns id, title, status, priority, type (Task/Epic/Bug), assignee, component, labels, milestone, parent issue, childCount, dueDate, estimation, reportedTime, createdOn, modifiedOn, and completedAt for each issue. Does NOT include full descriptions — use get_issue to read resolved markdown descriptions (important for migrations). Supports filtering by status, priority, label, and milestone. Default limit 500, auto-paginates. Use search_issues for full-text search across projects.',
-      inputSchema: { type: 'object', properties: { project: { type: 'string', description: 'Project identifier (e.g., "PROJ")' }, status: { type: 'string', description: 'Filter by status: Backlog, Todo, In Progress, Done, Canceled' }, priority: { type: 'string', description: 'Filter by priority: urgent, high, medium, low, none' }, label: { type: 'string', description: 'Filter by label name (exact match)' }, milestone: { type: 'string', description: 'Filter by milestone name (exact match)' }, limit: { type: 'number', description: 'Maximum number of issues to return (default: 500)' }, include_details: { type: 'boolean', description: 'Include full details: descriptions, comments, time reports, relations, and children. Reduces default limit to 50.' }, ...workspaceProp }, required: ['project'] }
+      description: 'List issues in a project with optional filtering and cursor-based pagination. Returns { items, nextCursor? }. Pass nextCursor from a previous response to get the next page. Default page size: 50 (20 with include_details).',
+      inputSchema: { type: 'object', properties: { project: { type: 'string', description: 'Project identifier (e.g., "PROJ")' }, status: { type: 'string', description: 'Filter by status: Backlog, Todo, In Progress, Done, Canceled' }, priority: { type: 'string', description: 'Filter by priority: urgent, high, medium, low, none' }, label: { type: 'string', description: 'Filter by label name (exact match)' }, milestone: { type: 'string', description: 'Filter by milestone name (exact match)' }, include_details: { type: 'boolean', description: 'Include full details: descriptions, comments, time reports, relations, and children. Reduces default page size to 20.' }, ...paginationProps, ...workspaceProp }, required: ['project'] }
     },
     {
       name: 'get_issue',
@@ -363,8 +375,8 @@ function getToolDefinitions() {
     },
     {
       name: 'list_labels',
-      description: 'List all available labels in the workspace. Returns each label\'s name and hex color. Use this to discover existing labels before adding them to issues.',
-      inputSchema: { type: 'object', properties: { ...workspaceProp }, required: [] }
+      description: 'List all available labels in the workspace. Returns { items, nextCursor? }. Each label has name and hex color.',
+      inputSchema: { type: 'object', properties: { ...paginationProps, ...workspaceProp }, required: [] }
     },
     {
       name: 'create_label',
@@ -459,8 +471,8 @@ function getToolDefinitions() {
     // ── Components ───────────────────────────────────────────
     {
       name: 'list_components',
-      description: 'List all components in a project.',
-      inputSchema: { type: 'object', properties: { project: { type: 'string', description: 'Project identifier' }, ...workspaceProp }, required: ['project'] }
+      description: 'List all components in a project. Returns { items, nextCursor? }.',
+      inputSchema: { type: 'object', properties: { project: { type: 'string', description: 'Project identifier' }, ...paginationProps, ...workspaceProp }, required: ['project'] }
     },
     {
       name: 'get_component',
@@ -470,12 +482,12 @@ function getToolDefinitions() {
     {
       name: 'create_component',
       description: 'Create a new component in a project.',
-      inputSchema: { type: 'object', properties: { project: { type: 'string', description: 'Project identifier' }, name: { type: 'string', description: 'Component name' }, description: { type: 'string', description: 'Component description' }, ...workspaceProp }, required: ['project', 'name'] }
+      inputSchema: { type: 'object', properties: { project: { type: 'string', description: 'Project identifier' }, name: { type: 'string', description: 'Component name' }, description: { type: 'string', description: 'Component description' }, lead: { type: 'string', description: 'Lead member name' }, ...workspaceProp }, required: ['project', 'name'] }
     },
     {
       name: 'update_component',
-      description: 'Update a component\'s name or description.',
-      inputSchema: { type: 'object', properties: { project: { type: 'string', description: 'Project identifier' }, name: { type: 'string', description: 'Current component name' }, newName: { type: 'string', description: 'New component name' }, description: { type: 'string', description: 'New description' }, ...workspaceProp }, required: ['project', 'name'] }
+      description: 'Update a component\'s name, description, or lead.',
+      inputSchema: { type: 'object', properties: { project: { type: 'string', description: 'Project identifier' }, name: { type: 'string', description: 'Current component name' }, newName: { type: 'string', description: 'New component name' }, description: { type: 'string', description: 'New description' }, lead: { type: 'string', description: 'Lead member name (empty string to clear)' }, ...workspaceProp }, required: ['project', 'name'] }
     },
     {
       name: 'delete_component',
@@ -486,8 +498,8 @@ function getToolDefinitions() {
     // ── Milestones ───────────────────────────────────────────
     {
       name: 'list_milestones',
-      description: 'List all milestones in a project. Returns name, status, date range, and issue count.',
-      inputSchema: { type: 'object', properties: { project: { type: 'string', description: 'Project identifier' }, include_details: { type: 'boolean', description: 'Include issue list for each milestone' }, ...workspaceProp }, required: ['project'] }
+      description: 'List all milestones in a project. Returns { items, nextCursor? }.',
+      inputSchema: { type: 'object', properties: { project: { type: 'string', description: 'Project identifier' }, include_details: { type: 'boolean', description: 'Include issue list for each milestone' }, ...paginationProps, ...workspaceProp }, required: ['project'] }
     },
     {
       name: 'get_milestone',
@@ -518,8 +530,8 @@ function getToolDefinitions() {
     // ── Members ──────────────────────────────────────────────
     {
       name: 'list_members',
-      description: 'List all active members of the workspace with their names and roles.',
-      inputSchema: { type: 'object', properties: { ...workspaceProp }, required: [] }
+      description: 'List all active members of the workspace. Returns { items, nextCursor? }.',
+      inputSchema: { type: 'object', properties: { ...paginationProps, ...workspaceProp }, required: [] }
     },
     {
       name: 'get_member',
@@ -530,8 +542,8 @@ function getToolDefinitions() {
     // ── Comments ─────────────────────────────────────────────
     {
       name: 'list_comments',
-      description: 'List all comments on an issue, ordered chronologically.',
-      inputSchema: { type: 'object', properties: { issueId: { type: 'string', description: 'Issue identifier (e.g., "PROJ-42")' }, ...workspaceProp }, required: ['issueId'] }
+      description: 'List comments on an issue. Returns { items, nextCursor? }.',
+      inputSchema: { type: 'object', properties: { issueId: { type: 'string', description: 'Issue identifier (e.g., "PROJ-42")' }, ...paginationProps, ...workspaceProp }, required: ['issueId'] }
     },
     {
       name: 'get_comment',
@@ -557,8 +569,8 @@ function getToolDefinitions() {
     // ── Metadata ─────────────────────────────────────────────
     {
       name: 'list_statuses',
-      description: 'List all issue statuses available in a project, grouped by category (Backlog, Unstarted, Active, Won, Lost).',
-      inputSchema: { type: 'object', properties: { project: { type: 'string', description: 'Project identifier' }, ...workspaceProp }, required: ['project'] }
+      description: 'List issue statuses available in a project. Returns { items, nextCursor? }.',
+      inputSchema: { type: 'object', properties: { project: { type: 'string', description: 'Project identifier' }, ...paginationProps, ...workspaceProp }, required: ['project'] }
     },
     {
       name: 'get_status',
@@ -567,8 +579,8 @@ function getToolDefinitions() {
     },
     {
       name: 'list_task_types',
-      description: 'List all task types available in a project (e.g., Issue, Epic, Bug).',
-      inputSchema: { type: 'object', properties: { project: { type: 'string', description: 'Project identifier' }, ...workspaceProp }, required: ['project'] }
+      description: 'List task types available in a project. Returns { items, nextCursor? }.',
+      inputSchema: { type: 'object', properties: { project: { type: 'string', description: 'Project identifier' }, ...paginationProps, ...workspaceProp }, required: ['project'] }
     },
     {
       name: 'get_task_type',
@@ -584,8 +596,8 @@ function getToolDefinitions() {
     },
     {
       name: 'list_time_reports',
-      description: 'List all time reports for an issue.',
-      inputSchema: { type: 'object', properties: { issueId: { type: 'string', description: 'Issue identifier' }, ...workspaceProp }, required: ['issueId'] }
+      description: 'List time reports for an issue. Returns { items, nextCursor? }.',
+      inputSchema: { type: 'object', properties: { issueId: { type: 'string', description: 'Issue identifier' }, ...paginationProps, ...workspaceProp }, required: ['issueId'] }
     },
     {
       name: 'get_time_report',

package/src/server.mjs

@@ -279,7 +279,7 @@ function shutdown(signal) {
   timeout.unref();
 
   // Close all sessions
-  for (const [sid, session] of sessions) {
+  for (const session of sessions.values()) {
     session.transport.close().catch(() => {});
     session.server.close().catch(() => {});
   }

package/node_modules/@msgpackr-extract/msgpackr-extract-darwin-x64/README.md

@@ -1 +0,0 @@
-Platform specific binary for msgpackr-extract on darwin OS with x64 architecture