@mgsoftwarebv/mcp-server-bridge 3.5.17 → 3.5.18

package/dist/index.js

@@ -107843,6 +107843,59 @@ var TOOLS = [
       },
       required: ["id"]
     }
+  },
+  {
+    name: "get-user-activity-report",
+    description: "Daily execution/activity report for a single user (or the whole team) over a date range \u2014 built for standups and end-of-day summaries like 'what did Prince do today?'. Aggregates, per requested timezone day boundaries, the user's ticket changes (created/status/assignee/priority/type/tag/GitHub events from the audit log), comments, attachments, time entries (worked hours) and organized calendar items into one chronological timeline plus summary counts. The user is matched as the ACTOR who performed each action (distinct from a ticket's assignee/requester). Scoped to your provider team(s); pass a user UUID for a colleague, 'me' for yourself (default), or 'all' for the whole team. Each activity carries the ticket UUID + ticket number + title, project, a plain-English summary and the actor. Returns explicit `limitations` (e.g. invalid timezone fallback, unknown user, project filter not applicable to calendar items). Also accepts the alias name get_user_activity_report. Use get-projects to resolve a projectId and get-teams to resolve a teamId first.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        teamId: teamIdProp,
+        userId: {
+          type: "string",
+          description: "User to report on (the actor). Defaults to the API key user ('me'). Pass a user UUID for a colleague, or 'all' for every accessible team member."
+        },
+        dateFrom: {
+          type: "string",
+          description: "Inclusive start day (YYYY-MM-DD) in `timezone`. Defaults to today. If only dateTo is given, dateFrom mirrors it."
+        },
+        dateTo: {
+          type: "string",
+          description: "Inclusive end day (YYYY-MM-DD) in `timezone`. Defaults to dateFrom (or today). For a single-day report pass the same value as dateFrom or omit it."
+        },
+        timezone: {
+          type: "string",
+          default: "Europe/Amsterdam",
+          description: "IANA timezone (e.g. Europe/Amsterdam) used to compute day boundaries and local timestamps. Invalid values fall back to Europe/Amsterdam with a note in `limitations`."
+        },
+        include: {
+          type: "array",
+          items: {
+            type: "string",
+            enum: [
+              "tickets",
+              "comments",
+              "status_changes",
+              "attachments",
+              "time_entries",
+              "calendar_items"
+            ]
+          },
+          description: "Activity categories to include. Defaults to all six. 'tickets' = ticket lifecycle/audit events (created, tag, GitHub, generic updates); 'status_changes' = status/assignee/priority/type/project transitions; 'comments', 'attachments', 'time_entries' (worked hours), 'calendar_items' (agenda events organized by the user)."
+        },
+        projectId: {
+          type: "string",
+          description: "Restrict ticket-linked activity (and time entries) to this project UUID. Does not apply to calendar items, which are then omitted (noted in `limitations`)."
+        },
+        pageSize: {
+          type: "number",
+          default: 200,
+          maximum: 500,
+          description: "Max activities returned in the timeline. Summary counts always cover ALL matching activity regardless of this limit."
+        }
+      },
+      required: []
+    }
   }
 ];
 var RESOURCES = [
@@ -127169,6 +127222,562 @@ ${tagErrors.map((e6) => `   \u2022 ${e6}`).join("\n")}
   };
 }
 
+// src/tools/user-activity-report.ts
+var DEFAULT_TIMEZONE = "Europe/Amsterdam";
+var DEFAULT_PAGE_SIZE = 200;
+var MAX_PAGE_SIZE = 500;
+var MAX_ROWS_PER_SOURCE = 2e3;
+var COMMENT_PREVIEW_LENGTH = 140;
+var ACTIVITY_INCLUDE_VALUES = [
+  "tickets",
+  "comments",
+  "status_changes",
+  "attachments",
+  "time_entries",
+  "calendar_items"
+];
+var STATUS_CHANGE_ACTIVITY_TYPES = /* @__PURE__ */ new Set([
+  "status_change",
+  "status_changed",
+  "assignment",
+  "assignee_changed",
+  "priority_change",
+  "priority_changed",
+  "type_change",
+  "type_changed",
+  "project_changed"
+]);
+var COMMENT_ACTIVITY_TYPES = /* @__PURE__ */ new Set([
+  "comment_added",
+  "comment_internal_added",
+  "comment_updated",
+  "comment_deleted"
+]);
+function resolveIncludes(input) {
+  if (input == null || input.length === 0) {
+    return { includes: new Set(ACTIVITY_INCLUDE_VALUES), invalid: [] };
+  }
+  const includes = /* @__PURE__ */ new Set();
+  const invalid = [];
+  for (const raw of input) {
+    const value = String(raw).trim();
+    if (ACTIVITY_INCLUDE_VALUES.includes(value)) {
+      includes.add(value);
+    } else if (value.length > 0) {
+      invalid.push(value);
+    }
+  }
+  return { includes, invalid };
+}
+function isValidIsoDate2(value) {
+  if (!/^\d{4}-\d{2}-\d{2}$/.test(value)) return false;
+  const parsed = /* @__PURE__ */ new Date(`${value}T00:00:00Z`);
+  if (Number.isNaN(parsed.getTime())) return false;
+  return parsed.toISOString().slice(0, 10) === value;
+}
+function isValidTimeZone(timeZone) {
+  if (!timeZone) return false;
+  try {
+    new Intl.DateTimeFormat("en-US", { timeZone });
+    return true;
+  } catch {
+    return false;
+  }
+}
+function todayInTimeZone(timeZone, now2 = /* @__PURE__ */ new Date()) {
+  return new Intl.DateTimeFormat("en-CA", {
+    timeZone,
+    year: "numeric",
+    month: "2-digit",
+    day: "2-digit"
+  }).format(now2);
+}
+function resolveDayWindow(args2) {
+  const today = todayInTimeZone(args2.timezone, args2.now);
+  const from = args2.dateFrom ?? args2.dateTo ?? today;
+  const to = args2.dateTo ?? args2.dateFrom ?? today;
+  return { from, to };
+}
+function classifyTicketActivity(activityType) {
+  if (COMMENT_ACTIVITY_TYPES.has(activityType)) return null;
+  if (STATUS_CHANGE_ACTIVITY_TYPES.has(activityType)) return "status_changes";
+  return "tickets";
+}
+function humanizeActivityType(activityType) {
+  const text3 = activityType.replace(/_/g, " ").trim();
+  if (text3.length === 0) return "Activity";
+  return text3.charAt(0).toUpperCase() + text3.slice(1);
+}
+function summarizeTicketActivity(activityType, oldValue, newValue) {
+  const oldV = oldValue && oldValue.trim() !== "" ? oldValue.trim() : null;
+  const newV = newValue && newValue.trim() !== "" ? newValue.trim() : null;
+  switch (activityType) {
+    case "created":
+      return "Created the ticket";
+    case "updated":
+      return "Updated the ticket";
+    case "status_change":
+    case "status_changed":
+      if (oldV && newV) return `Changed status from ${oldV} to ${newV}`;
+      if (newV) return `Changed status to ${newV}`;
+      return "Changed status";
+    case "assignment":
+    case "assignee_changed":
+      if (!oldV && newV) return `Assigned to ${newV}`;
+      if (oldV && !newV) return `Unassigned from ${oldV}`;
+      if (newV) return `Reassigned to ${newV}`;
+      return "Changed assignment";
+    case "priority_change":
+    case "priority_changed":
+      if (oldV && newV) return `Changed priority from ${oldV} to ${newV}`;
+      if (newV) return `Changed priority to ${newV}`;
+      return "Changed priority";
+    case "type_change":
+    case "type_changed":
+      if (oldV && newV) return `Changed type from ${oldV} to ${newV}`;
+      if (newV) return `Changed type to ${newV}`;
+      return "Changed type";
+    case "project_changed":
+      if (oldV && newV) return `Moved project from ${oldV} to ${newV}`;
+      return "Changed project";
+    case "tag_added":
+      return newV ? `Added tag ${newV}` : "Added a tag";
+    case "tag_removed":
+      return oldV ? `Removed tag ${oldV}` : "Removed a tag";
+    case "sequence_changed":
+      return "Reordered the ticket";
+    case "github_commit_linked":
+      return "Linked a GitHub commit";
+    case "github_pr_opened":
+      return "Opened a GitHub pull request";
+    case "github_pr_merged":
+      return "Merged a GitHub pull request";
+    case "github_pr_closed":
+      return "Closed a GitHub pull request";
+    default:
+      return humanizeActivityType(activityType);
+  }
+}
+function truncate(text3, max) {
+  const clean = text3.replace(/\s+/g, " ").trim();
+  if (clean.length <= max) return clean;
+  return `${clean.slice(0, Math.max(0, max - 1)).trimEnd()}\u2026`;
+}
+function timeZoneOffset(date10, timeZone) {
+  try {
+    const name21 = new Intl.DateTimeFormat("en-US", {
+      timeZone,
+      timeZoneName: "longOffset"
+    }).formatToParts(date10).find((p3) => p3.type === "timeZoneName")?.value;
+    const match = name21?.match(/GMT([+-]\d{2}:\d{2})/);
+    return match?.[1] ?? "+00:00";
+  } catch {
+    return "+00:00";
+  }
+}
+function formatIsoWithOffset(date10, timeZone) {
+  const parts = Object.fromEntries(
+    new Intl.DateTimeFormat("en-US", {
+      timeZone,
+      year: "numeric",
+      month: "2-digit",
+      day: "2-digit",
+      hour: "2-digit",
+      minute: "2-digit",
+      second: "2-digit",
+      hour12: false
+    }).formatToParts(date10).map((p3) => [p3.type, p3.value])
+  );
+  const hour2 = parts.hour === "24" ? "00" : parts.hour;
+  const local = `${parts.year}-${parts.month}-${parts.day}T${hour2}:${parts.minute}:${parts.second}`;
+  return `${local}${timeZoneOffset(date10, timeZone)}`;
+}
+function textResponse13(text3) {
+  return { content: [{ type: "text", text: text3 }] };
+}
+function jsonResponse3(payload) {
+  return {
+    content: [{ type: "text", text: JSON.stringify(payload, null, 2) }]
+  };
+}
+function toNumber4(value) {
+  if (value == null) return 0;
+  if (typeof value === "number") return value;
+  const parsed = Number.parseFloat(String(value));
+  return Number.isFinite(parsed) ? parsed : 0;
+}
+function hoursFrom2(seconds) {
+  return Math.round(toNumber4(seconds) / 3600 * 100) / 100;
+}
+function utcIsoExpr(column) {
+  return sql`to_char(${column} AT TIME ZONE 'UTC', 'YYYY-MM-DD"T"HH24:MI:SS"Z"')`;
+}
+async function handleGetUserActivityReport(input) {
+  const ctx = getAuthContext();
+  const limitations = [];
+  const { includes, invalid } = resolveIncludes(input.include);
+  for (const value of invalid) {
+    limitations.push(`Ignored unknown include value "${value}".`);
+  }
+  if (includes.size === 0) {
+    return textResponse13(
+      `Error: \`include\` contained no valid categories. Allowed: ${ACTIVITY_INCLUDE_VALUES.join(", ")}.`
+    );
+  }
+  let timezone = input.timezone?.trim() || DEFAULT_TIMEZONE;
+  if (!isValidTimeZone(timezone)) {
+    limitations.push(
+      `Invalid timezone "${input.timezone}"; fell back to ${DEFAULT_TIMEZONE}.`
+    );
+    timezone = DEFAULT_TIMEZONE;
+  }
+  if (input.dateFrom && !isValidIsoDate2(input.dateFrom)) {
+    return textResponse13(
+      `Error: invalid dateFrom "${input.dateFrom}". Use YYYY-MM-DD.`
+    );
+  }
+  if (input.dateTo && !isValidIsoDate2(input.dateTo)) {
+    return textResponse13(
+      `Error: invalid dateTo "${input.dateTo}". Use YYYY-MM-DD.`
+    );
+  }
+  const window2 = resolveDayWindow({
+    dateFrom: input.dateFrom,
+    dateTo: input.dateTo,
+    timezone
+  });
+  if (window2.from > window2.to) {
+    return textResponse13(
+      `Error: dateFrom (${window2.from}) is after dateTo (${window2.to}).`
+    );
+  }
+  const scope = await resolveTeamScope(input.teamId);
+  if (!scope.ok) return scope.response;
+  if (scope.teamIds.length === 0) {
+    return textResponse13("No accessible teams found.");
+  }
+  if (input.projectId && !scope.projectIds.includes(input.projectId)) {
+    return textResponse13(
+      `Project not found or no access: ${input.projectId}. Call get-projects first.`
+    );
+  }
+  const rawUserId = input.userId?.trim();
+  const userFilter = !rawUserId || rawUserId === "me" ? ctx.userId : rawUserId;
+  const isAll = userFilter === "all";
+  let user;
+  if (isAll) {
+    user = { id: "all", name: "All team members" };
+  } else {
+    const [row] = await db.select({ id: schema_exports.users.id, name: schema_exports.users.fullName }).from(schema_exports.users).where(eq(schema_exports.users.id, userFilter)).limit(1);
+    if (!row) {
+      limitations.push(
+        `User ${userFilter} was not found; reporting any team-scoped activity recorded for that id.`
+      );
+      user = { id: userFilter, name: null };
+    } else {
+      user = { id: row.id, name: row.name };
+    }
+  }
+  const dayWindow = (column) => sql`(${column} AT TIME ZONE ${timezone})::date BETWEEN ${window2.from}::date AND ${window2.to}::date`;
+  const ticketAccess = and(
+    buildTicketAccessPredicate(
+      scope.teamIds,
+      scope.projectIds,
+      scope.customerIds
+    ),
+    eq(schema_exports.tickets.isDeleted, false)
+  );
+  const activities2 = [];
+  const ticketsTouched = /* @__PURE__ */ new Set();
+  let commentsAdded = 0;
+  let statusChanges = 0;
+  let attachmentsAdded = 0;
+  let timeEntrySeconds = 0;
+  const pushTicketTouched = (ticketId) => {
+    if (ticketId) ticketsTouched.add(ticketId);
+  };
+  if (includes.has("tickets") || includes.has("status_changes")) {
+    const ta = schema_exports.ticketActivity;
+    const conditions = [ticketAccess, dayWindow(ta.createdAt)];
+    if (!isAll) conditions.push(eq(ta.userId, userFilter));
+    if (input.projectId)
+      conditions.push(eq(schema_exports.tickets.projectId, input.projectId));
+    const rows = await db.select({
+      ts: utcIsoExpr(ta.createdAt),
+      activityType: ta.activityType,
+      oldValue: ta.oldValue,
+      newValue: ta.newValue,
+      actorId: ta.userId,
+      actorName: schema_exports.users.fullName,
+      ticketId: schema_exports.tickets.id,
+      ticketNumber: schema_exports.tickets.ticketNumber,
+      ticketTitle: schema_exports.tickets.title,
+      projectId: schema_exports.projects.id,
+      projectName: schema_exports.projects.name
+    }).from(ta).innerJoin(schema_exports.tickets, eq(schema_exports.tickets.id, ta.ticketId)).leftJoin(schema_exports.users, eq(schema_exports.users.id, ta.userId)).leftJoin(schema_exports.projects, eq(schema_exports.projects.id, schema_exports.tickets.projectId)).where(and(...conditions)).limit(MAX_ROWS_PER_SOURCE);
+    if (rows.length >= MAX_ROWS_PER_SOURCE) {
+      limitations.push(
+        `Ticket activity capped at ${MAX_ROWS_PER_SOURCE} rows; counts may be partial. Narrow the date range.`
+      );
+    }
+    for (const r6 of rows) {
+      const bucket = classifyTicketActivity(r6.activityType);
+      if (!bucket || !includes.has(bucket)) continue;
+      pushTicketTouched(r6.ticketId);
+      if (bucket === "status_changes") statusChanges += 1;
+      activities2.push({
+        timestamp: formatIsoWithOffset(new Date(r6.ts), timezone),
+        timestampUtc: r6.ts,
+        type: `ticket_${r6.activityType}`,
+        ticketId: r6.ticketId,
+        ticketNumber: r6.ticketNumber,
+        ticketTitle: r6.ticketTitle,
+        project: r6.projectId ? { id: r6.projectId, name: r6.projectName } : null,
+        summary: summarizeTicketActivity(
+          r6.activityType,
+          r6.oldValue,
+          r6.newValue
+        ),
+        actor: { id: r6.actorId, name: r6.actorName },
+        meta: {
+          activityType: r6.activityType,
+          from: r6.oldValue ?? null,
+          to: r6.newValue ?? null
+        }
+      });
+    }
+  }
+  if (includes.has("comments")) {
+    const tc = schema_exports.ticketComments;
+    const conditions = [ticketAccess, dayWindow(tc.createdAt)];
+    if (!isAll) conditions.push(eq(tc.userId, userFilter));
+    if (input.projectId)
+      conditions.push(eq(schema_exports.tickets.projectId, input.projectId));
+    const rows = await db.select({
+      ts: utcIsoExpr(tc.createdAt),
+      content: tc.content,
+      isInternal: tc.isInternal,
+      actorId: tc.userId,
+      actorUserName: tc.userName,
+      actorName: schema_exports.users.fullName,
+      ticketId: schema_exports.tickets.id,
+      ticketNumber: schema_exports.tickets.ticketNumber,
+      ticketTitle: schema_exports.tickets.title,
+      projectId: schema_exports.projects.id,
+      projectName: schema_exports.projects.name
+    }).from(tc).innerJoin(schema_exports.tickets, eq(schema_exports.tickets.id, tc.ticketId)).leftJoin(schema_exports.users, eq(schema_exports.users.id, tc.userId)).leftJoin(schema_exports.projects, eq(schema_exports.projects.id, schema_exports.tickets.projectId)).where(and(...conditions)).limit(MAX_ROWS_PER_SOURCE);
+    if (rows.length >= MAX_ROWS_PER_SOURCE) {
+      limitations.push(
+        `Comments capped at ${MAX_ROWS_PER_SOURCE} rows; counts may be partial. Narrow the date range.`
+      );
+    }
+    for (const r6 of rows) {
+      commentsAdded += 1;
+      pushTicketTouched(r6.ticketId);
+      activities2.push({
+        timestamp: formatIsoWithOffset(new Date(r6.ts), timezone),
+        timestampUtc: r6.ts,
+        type: r6.isInternal ? "ticket_internal_comment" : "ticket_comment",
+        ticketId: r6.ticketId,
+        ticketNumber: r6.ticketNumber,
+        ticketTitle: r6.ticketTitle,
+        project: r6.projectId ? { id: r6.projectId, name: r6.projectName } : null,
+        summary: `Added ${r6.isInternal ? "internal " : ""}comment: ${truncate(
+          r6.content,
+          COMMENT_PREVIEW_LENGTH
+        )}`,
+        actor: { id: r6.actorId, name: r6.actorName ?? r6.actorUserName },
+        meta: { isInternal: r6.isInternal }
+      });
+    }
+  }
+  if (includes.has("attachments")) {
+    const collectAttachments = async (table, type) => {
+      const conditions = [ticketAccess, dayWindow(table.createdAt)];
+      if (!isAll) conditions.push(eq(table.userId, userFilter));
+      if (input.projectId)
+        conditions.push(eq(schema_exports.tickets.projectId, input.projectId));
+      const rows = await db.select({
+        ts: utcIsoExpr(table.createdAt),
+        fileName: table.fileName,
+        actorId: table.userId,
+        actorName: schema_exports.users.fullName,
+        ticketId: schema_exports.tickets.id,
+        ticketNumber: schema_exports.tickets.ticketNumber,
+        ticketTitle: schema_exports.tickets.title,
+        projectId: schema_exports.projects.id,
+        projectName: schema_exports.projects.name
+      }).from(table).innerJoin(schema_exports.tickets, eq(schema_exports.tickets.id, table.ticketId)).leftJoin(schema_exports.users, eq(schema_exports.users.id, table.userId)).leftJoin(
+        schema_exports.projects,
+        eq(schema_exports.projects.id, schema_exports.tickets.projectId)
+      ).where(and(...conditions)).limit(MAX_ROWS_PER_SOURCE);
+      for (const r6 of rows) {
+        attachmentsAdded += 1;
+        pushTicketTouched(r6.ticketId);
+        activities2.push({
+          timestamp: formatIsoWithOffset(new Date(r6.ts), timezone),
+          timestampUtc: r6.ts,
+          type,
+          ticketId: r6.ticketId,
+          ticketNumber: r6.ticketNumber,
+          ticketTitle: r6.ticketTitle,
+          project: r6.projectId ? { id: r6.projectId, name: r6.projectName } : null,
+          summary: `Uploaded attachment ${r6.fileName}`,
+          actor: { id: r6.actorId, name: r6.actorName },
+          meta: { fileName: r6.fileName }
+        });
+      }
+    };
+    await collectAttachments(schema_exports.ticketAttachments, "ticket_attachment");
+    await collectAttachments(
+      schema_exports.ticketCommentAttachments,
+      "ticket_comment_attachment"
+    );
+  }
+  if (includes.has("time_entries")) {
+    const te = schema_exports.timesheetEvents;
+    const durationSeconds = sql`CASE WHEN ${te.endTime} IS NOT NULL THEN GREATEST(0, EXTRACT(EPOCH FROM (${te.endTime} - ${te.startTime}))) ELSE COALESCE(${te.trackedDuration}, 0) END`;
+    const conditions = [
+      inArray(te.teamId, scope.teamIds),
+      eq(te.isDeleted, false),
+      eq(te.allDay, false),
+      sql`${te.type}::text <> 'deadline'`,
+      dayWindow(te.startTime)
+    ];
+    if (!isAll) conditions.push(eq(te.userId, userFilter));
+    if (input.projectId) conditions.push(eq(te.projectId, input.projectId));
+    const rows = await db.select({
+      id: te.id,
+      ts: utcIsoExpr(te.startTime),
+      title: te.title,
+      type: te.type,
+      billingStatus: te.billingStatus,
+      durationSeconds,
+      actorId: te.userId,
+      actorName: schema_exports.users.fullName,
+      projectId: te.projectId,
+      projectName: schema_exports.projects.name
+    }).from(te).leftJoin(schema_exports.projects, eq(schema_exports.projects.id, te.projectId)).leftJoin(schema_exports.users, eq(schema_exports.users.id, te.userId)).where(and(...conditions)).limit(MAX_ROWS_PER_SOURCE);
+    const entryIds = rows.map((r6) => r6.id);
+    const ticketsByEvent = /* @__PURE__ */ new Map();
+    if (entryIds.length > 0) {
+      const links = await db.select({
+        eventId: schema_exports.timesheetEventTickets.timesheetEventId,
+        ticketId: schema_exports.tickets.id,
+        ticketNumber: schema_exports.tickets.ticketNumber,
+        ticketTitle: schema_exports.tickets.title
+      }).from(schema_exports.timesheetEventTickets).innerJoin(
+        schema_exports.tickets,
+        eq(schema_exports.timesheetEventTickets.ticketId, schema_exports.tickets.id)
+      ).where(
+        inArray(schema_exports.timesheetEventTickets.timesheetEventId, entryIds)
+      );
+      for (const link of links) {
+        const list = ticketsByEvent.get(link.eventId) ?? [];
+        list.push({
+          id: link.ticketId,
+          ticketNumber: link.ticketNumber,
+          title: link.ticketTitle
+        });
+        ticketsByEvent.set(link.eventId, list);
+      }
+    }
+    for (const r6 of rows) {
+      const seconds = toNumber4(r6.durationSeconds);
+      timeEntrySeconds += seconds;
+      const hours = hoursFrom2(seconds);
+      const linked = ticketsByEvent.get(r6.id) ?? [];
+      for (const t8 of linked) ticketsTouched.add(t8.id);
+      const primary = linked[0] ?? null;
+      const projectLabel = r6.projectName ? ` on ${r6.projectName}` : "";
+      const titleLabel = r6.title ? ` \u2014 ${r6.title}` : "";
+      activities2.push({
+        timestamp: formatIsoWithOffset(new Date(r6.ts), timezone),
+        timestampUtc: r6.ts,
+        type: "time_entry",
+        ticketId: primary?.id ?? null,
+        ticketNumber: primary?.ticketNumber ?? null,
+        ticketTitle: primary?.title ?? null,
+        project: r6.projectId ? { id: r6.projectId, name: r6.projectName } : null,
+        summary: `Logged ${hours}h${projectLabel}${titleLabel}`,
+        actor: { id: r6.actorId, name: r6.actorName },
+        meta: {
+          hours,
+          eventType: r6.type,
+          billingStatus: r6.billingStatus,
+          linkedTickets: linked.map((t8) => ({
+            id: t8.id,
+            ticketNumber: t8.ticketNumber
+          }))
+        }
+      });
+    }
+  }
+  if (includes.has("calendar_items")) {
+    if (input.projectId) {
+      limitations.push(
+        "calendar_items were omitted because a projectId filter was set (agenda events have no project link)."
+      );
+    } else {
+      const ae2 = schema_exports.agendaEvents;
+      const conditions = [
+        inArray(ae2.teamId, scope.teamIds),
+        eq(ae2.isDeleted, false),
+        dayWindow(ae2.startTime)
+      ];
+      if (!isAll) conditions.push(eq(ae2.organizerId, userFilter));
+      const rows = await db.select({
+        ts: utcIsoExpr(ae2.startTime),
+        title: ae2.title,
+        status: ae2.status,
+        actorId: ae2.organizerId,
+        actorName: schema_exports.users.fullName
+      }).from(ae2).leftJoin(schema_exports.users, eq(schema_exports.users.id, ae2.organizerId)).where(and(...conditions)).limit(MAX_ROWS_PER_SOURCE);
+      for (const r6 of rows) {
+        activities2.push({
+          timestamp: formatIsoWithOffset(new Date(r6.ts), timezone),
+          timestampUtc: r6.ts,
+          type: "calendar_item",
+          ticketId: null,
+          ticketNumber: null,
+          ticketTitle: null,
+          project: null,
+          summary: `Calendar: ${r6.title}`,
+          actor: { id: r6.actorId, name: r6.actorName },
+          meta: { status: r6.status }
+        });
+      }
+    }
+  }
+  activities2.sort((a6, b7) => a6.timestampUtc.localeCompare(b7.timestampUtc));
+  const pageSize = Math.min(
+    Math.max(1, input.pageSize ?? DEFAULT_PAGE_SIZE),
+    MAX_PAGE_SIZE
+  );
+  const pagedActivities = activities2.slice(0, pageSize);
+  return jsonResponse3({
+    user,
+    period: { from: window2.from, to: window2.to, timezone },
+    filters: {
+      teamIds: scope.teamIds,
+      userId: isAll ? "all" : userFilter,
+      projectId: input.projectId ?? null,
+      include: [...includes]
+    },
+    summary: {
+      ticketsTouched: ticketsTouched.size,
+      commentsAdded,
+      statusChanges,
+      attachmentsAdded,
+      timeEntriesHours: hoursFrom2(timeEntrySeconds),
+      activitiesTotal: activities2.length
+    },
+    activities: pagedActivities,
+    activitiesTruncated: activities2.length > pagedActivities.length,
+    limitations
+  });
+}
+
 // src/server.ts
 var SERVER_VERSION = "3.5.12";
 function createMcpServer() {
@@ -127414,6 +128023,11 @@ function createMcpServer() {
           return await handleGetTimeEntries(
             asToolArgs(toolArgs)
           );
+        case "get-user-activity-report":
+        case "get_user_activity_report":
+          return await handleGetUserActivityReport(
+            asToolArgs(toolArgs)
+          );
         case "create-time-entries":
           return await handleCreateTimeEntries(
             asToolArgs(toolArgs)