loomiomcp 0.0.1 → 0.0.2

package/dist/http.js

@@ -1195,12 +1195,192 @@ async function listGroups(input) {
   };
 }
 
-// src/tools/comments.ts
+// src/tools/events.ts
 import { z as z7 } from "zod";
-var createCommentSchema = z7.object({
+var listEventsSchema = z7.object({
+  discussion_id: positiveId.describe(
+    "ID of the discussion whose event stream to fetch. Required \u2014 Loomio's v1/events endpoint silently returns empty without it."
+  ),
+  limit: z7.number().int().min(1).max(200).optional().describe("Page size. Loomio defaults to 50; cap is 200."),
+  offset: z7.number().int().min(0).optional().describe("Page offset (Loomio's `from` parameter). Defaults to 0."),
+  kinds: z7.array(z7.string().min(1)).optional().describe(
+    "Optional filter to only these event kinds (applied client-side after fetch \u2014 Loomio doesn't filter `kind` server-side). Common kinds: new_discussion, new_comment, comment_edited, poll_created, stance_created, outcome_created, discussion_moved, discussion_closed, reaction."
+  )
+});
+async function listEvents(input) {
+  const resp = await loomioGet("/v1/events", {
+    discussion_id: input.discussion_id,
+    ...input.limit !== void 0 ? { per: input.limit } : {},
+    ...input.offset !== void 0 ? { from: input.offset } : {}
+  });
+  if (input.kinds?.length) {
+    const allowed = new Set(input.kinds);
+    return {
+      ...resp,
+      events: (resp.events ?? []).filter((e) => allowed.has(e.kind))
+    };
+  }
+  return resp;
+}
+var CONCURRENCY2 = 6;
+var EVENTS_PAGE_SIZE = 200;
+var MAX_EVENTS_PAGES = 10;
+var ACTIVITY_KINDS = /* @__PURE__ */ new Set([
+  "new_discussion",
+  "new_comment",
+  "comment_edited",
+  "poll_created",
+  "stance_created",
+  "stance_updated",
+  "outcome_created",
+  "reaction"
+]);
+var getUserActivitySchema = z7.object({
+  user_id: positiveId.describe("Loomio user id whose activity to summarise."),
+  group_ids: z7.array(positiveId).min(1).max(50).describe(
+    "Groups to scan. Required \u2014 pass the result of `list_groups` (or a subset of it) to make the cost explicit. ~1 outbound HTTP request per discussion in scope, plus one list_discussions call per group; ~100-300 calls is typical for a wide scan. Capped at 50 groups per call."
+  ),
+  since: z7.string().optional().describe("ISO-8601 timestamp; ignore events before this time."),
+  until: z7.string().optional().describe("ISO-8601 timestamp; ignore events at or after this time.")
+});
+async function listDiscussionIdsForGroup(groupId) {
+  const all = [];
+  let offset = 0;
+  for (let page = 0; page < 20; page++) {
+    const resp = await loomioGet("/b2/discussions", {
+      group_id: groupId,
+      status: "all",
+      limit: EVENTS_PAGE_SIZE,
+      offset
+    });
+    const ds = resp.discussions ?? [];
+    for (const d of ds) all.push({ id: d.id, group_id: groupId });
+    if (ds.length < EVENTS_PAGE_SIZE) break;
+    offset += EVENTS_PAGE_SIZE;
+  }
+  return all;
+}
+async function fetchAllEventsForDiscussion(discussionId) {
+  const all = [];
+  let offset = 0;
+  for (let page = 0; page < MAX_EVENTS_PAGES; page++) {
+    const resp = await loomioGet("/v1/events", {
+      discussion_id: discussionId,
+      per: EVENTS_PAGE_SIZE,
+      from: offset
+    });
+    const evs = resp.events ?? [];
+    for (const e of evs) all.push(e);
+    if (evs.length < EVENTS_PAGE_SIZE) break;
+    offset += EVENTS_PAGE_SIZE;
+  }
+  return all;
+}
+async function runWithConcurrency(items, worker, concurrency) {
+  const results = new Array(items.length).fill(null);
+  let next = 0;
+  async function take() {
+    for (; ; ) {
+      const i = next++;
+      if (i >= items.length) return;
+      try {
+        results[i] = await worker(items[i]);
+      } catch {
+        results[i] = null;
+      }
+    }
+  }
+  await Promise.all(Array.from({ length: Math.min(concurrency, items.length) }, take));
+  return results;
+}
+async function getUserActivity(input) {
+  const groupIds = [...new Set(input.group_ids)];
+  const groupDiscussionLists = await runWithConcurrency(
+    groupIds,
+    (gid) => listDiscussionIdsForGroup(gid),
+    CONCURRENCY2
+  );
+  const discussions = [];
+  for (const list of groupDiscussionLists) {
+    if (list) discussions.push(...list);
+  }
+  const since = input.since ? Date.parse(input.since) : Number.NEGATIVE_INFINITY;
+  const until = input.until ? Date.parse(input.until) : Number.POSITIVE_INFINITY;
+  let eventsExamined = 0;
+  const counts = {
+    total: 0,
+    new_discussion: 0,
+    new_comment: 0,
+    poll_created: 0,
+    stance_created: 0,
+    outcome_created: 0,
+    reaction: 0,
+    other: 0
+  };
+  const byGroup = {};
+  const byMonth = {};
+  let firstActivity = null;
+  let lastActivity = null;
+  const samples = [];
+  const eventStreams = await runWithConcurrency(
+    discussions,
+    async (d) => ({ groupId: d.group_id, events: await fetchAllEventsForDiscussion(d.id) }),
+    CONCURRENCY2
+  );
+  for (const s of eventStreams) {
+    if (!s) continue;
+    for (const e of s.events) {
+      eventsExamined++;
+      if (e.actor_id !== input.user_id) continue;
+      const t = Date.parse(e.created_at);
+      if (Number.isNaN(t) || t < since || t >= until) continue;
+      if (!ACTIVITY_KINDS.has(e.kind)) {
+        counts.other++;
+      } else {
+        const slot = e.kind;
+        if (slot in counts && slot !== "total") counts[slot]++;
+      }
+      counts.total++;
+      byGroup[String(s.groupId)] = (byGroup[String(s.groupId)] ?? 0) + 1;
+      const month = e.created_at.slice(0, 7);
+      byMonth[month] = (byMonth[month] ?? 0) + 1;
+      if (!firstActivity || e.created_at < firstActivity) firstActivity = e.created_at;
+      if (!lastActivity || e.created_at > lastActivity) lastActivity = e.created_at;
+      if (samples.length < 10) {
+        samples.push({
+          kind: e.kind,
+          discussion_id: e.discussion_id,
+          created_at: e.created_at,
+          eventable_type: e.eventable_type,
+          eventable_id: e.eventable_id
+        });
+      }
+    }
+  }
+  return {
+    user_id: input.user_id,
+    scope: {
+      group_ids: groupIds,
+      discussions_scanned: discussions.length,
+      events_examined: eventsExamined,
+      since: input.since ?? null,
+      until: input.until ?? null
+    },
+    counts,
+    by_group: byGroup,
+    by_month: byMonth,
+    first_activity: firstActivity,
+    last_activity: lastActivity,
+    sample_events: samples
+  };
+}
+
+// src/tools/comments.ts
+import { z as z8 } from "zod";
+var createCommentSchema = z8.object({
   discussion_id: positiveId.describe("ID of the discussion to comment on."),
-  body: z7.string().min(1).describe("Comment body (required)."),
-  body_format: z7.enum(["md", "html"]).optional().describe("Format of `body`. Defaults to Loomio's group default when omitted.")
+  body: z8.string().min(1).describe("Comment body (required)."),
+  body_format: z8.enum(["md", "html"]).optional().describe("Format of `body`. Defaults to Loomio's group default when omitted.")
 });
 async function createComment(input) {
   const { discussion_id, ...rest } = input;
@@ -1211,14 +1391,14 @@ async function createComment(input) {
 }
 
 // src/tools/admin.ts
-import { z as z8 } from "zod";
-var deactivateUserSchema = z8.object({
+import { z as z9 } from "zod";
+var deactivateUserSchema = z9.object({
   id: positiveId.describe("Loomio user id to deactivate. Returns 404 if not active.")
 });
 async function deactivateUser(input) {
   return loomioPostB3("/b3/users/deactivate", { id: input.id });
 }
-var reactivateUserSchema = z8.object({
+var reactivateUserSchema = z9.object({
   id: positiveId.describe(
     "Loomio user id to reactivate. Returns 404 if not currently deactivated."
   )
@@ -1298,6 +1478,20 @@ function createLoomioMcpServer() {
     listGroupsSchema,
     listGroups
   );
+  registerTool(
+    server,
+    "list_events",
+    "Fetch the full event stream for one discussion \u2014 every new_comment, poll_created, stance_created, outcome_created, reaction, discussion_moved, etc. \u2014 with actor_id, kind, parent_id, created_at, and pointers to the underlying eventable record. Required: `discussion_id`. Optional `limit` (1-200, default 50), `offset` (Loomio's `from` param), and `kinds` (client-side filter to specific event kinds). The response also embeds related `comments`, `users`, and `polls` arrays for in-place resolution. Use this to answer 'show me the reply tree for thread X', 'who participated in discussion Y', or as the building block for cross-discussion aggregations. Loomio's v1/events endpoint requires a discussion_id; there's no instance-wide or per-user index \u2014 for user-centric questions, use `get_user_activity`.",
+    listEventsSchema,
+    listEvents
+  );
+  registerTool(
+    server,
+    "get_user_activity",
+    "Aggregate one user's activity across a set of groups. Server-side: fans out across every discussion in the specified groups, fetches its event stream, filters to events authored by the target user, and returns counts (by kind, by group, by month), plus first/last activity timestamps and a sample of recent events. Required: `user_id`, `group_ids` (1-50; pass the result of `list_groups` for instance-wide). Optional `since` / `until` (ISO-8601) bound the time window. Cost: one outbound HTTP call per discussion in scope (plus one `list_discussions` per group). Wide scans of an active instance commonly hit 100-300 calls in 5-30 seconds. Concurrency-capped at 6. Use this for 'tell me about user X', 'how active has user Y been in Q1', or before promoting/awarding someone. For one discussion at a time, use `list_events`.",
+    getUserActivitySchema,
+    getUserActivity
+  );
   if (!readOnly) {
     registerTool(
       server,

package/dist/index.js

@@ -643,12 +643,192 @@ async function listGroups(input) {
   };
 }
 
-// src/tools/comments.ts
+// src/tools/events.ts
 import { z as z6 } from "zod";
-var createCommentSchema = z6.object({
+var listEventsSchema = z6.object({
+  discussion_id: positiveId.describe(
+    "ID of the discussion whose event stream to fetch. Required \u2014 Loomio's v1/events endpoint silently returns empty without it."
+  ),
+  limit: z6.number().int().min(1).max(200).optional().describe("Page size. Loomio defaults to 50; cap is 200."),
+  offset: z6.number().int().min(0).optional().describe("Page offset (Loomio's `from` parameter). Defaults to 0."),
+  kinds: z6.array(z6.string().min(1)).optional().describe(
+    "Optional filter to only these event kinds (applied client-side after fetch \u2014 Loomio doesn't filter `kind` server-side). Common kinds: new_discussion, new_comment, comment_edited, poll_created, stance_created, outcome_created, discussion_moved, discussion_closed, reaction."
+  )
+});
+async function listEvents(input) {
+  const resp = await loomioGet("/v1/events", {
+    discussion_id: input.discussion_id,
+    ...input.limit !== void 0 ? { per: input.limit } : {},
+    ...input.offset !== void 0 ? { from: input.offset } : {}
+  });
+  if (input.kinds?.length) {
+    const allowed = new Set(input.kinds);
+    return {
+      ...resp,
+      events: (resp.events ?? []).filter((e) => allowed.has(e.kind))
+    };
+  }
+  return resp;
+}
+var CONCURRENCY2 = 6;
+var EVENTS_PAGE_SIZE = 200;
+var MAX_EVENTS_PAGES = 10;
+var ACTIVITY_KINDS = /* @__PURE__ */ new Set([
+  "new_discussion",
+  "new_comment",
+  "comment_edited",
+  "poll_created",
+  "stance_created",
+  "stance_updated",
+  "outcome_created",
+  "reaction"
+]);
+var getUserActivitySchema = z6.object({
+  user_id: positiveId.describe("Loomio user id whose activity to summarise."),
+  group_ids: z6.array(positiveId).min(1).max(50).describe(
+    "Groups to scan. Required \u2014 pass the result of `list_groups` (or a subset of it) to make the cost explicit. ~1 outbound HTTP request per discussion in scope, plus one list_discussions call per group; ~100-300 calls is typical for a wide scan. Capped at 50 groups per call."
+  ),
+  since: z6.string().optional().describe("ISO-8601 timestamp; ignore events before this time."),
+  until: z6.string().optional().describe("ISO-8601 timestamp; ignore events at or after this time.")
+});
+async function listDiscussionIdsForGroup(groupId) {
+  const all = [];
+  let offset = 0;
+  for (let page = 0; page < 20; page++) {
+    const resp = await loomioGet("/b2/discussions", {
+      group_id: groupId,
+      status: "all",
+      limit: EVENTS_PAGE_SIZE,
+      offset
+    });
+    const ds = resp.discussions ?? [];
+    for (const d of ds) all.push({ id: d.id, group_id: groupId });
+    if (ds.length < EVENTS_PAGE_SIZE) break;
+    offset += EVENTS_PAGE_SIZE;
+  }
+  return all;
+}
+async function fetchAllEventsForDiscussion(discussionId) {
+  const all = [];
+  let offset = 0;
+  for (let page = 0; page < MAX_EVENTS_PAGES; page++) {
+    const resp = await loomioGet("/v1/events", {
+      discussion_id: discussionId,
+      per: EVENTS_PAGE_SIZE,
+      from: offset
+    });
+    const evs = resp.events ?? [];
+    for (const e of evs) all.push(e);
+    if (evs.length < EVENTS_PAGE_SIZE) break;
+    offset += EVENTS_PAGE_SIZE;
+  }
+  return all;
+}
+async function runWithConcurrency(items, worker, concurrency) {
+  const results = new Array(items.length).fill(null);
+  let next = 0;
+  async function take() {
+    for (; ; ) {
+      const i = next++;
+      if (i >= items.length) return;
+      try {
+        results[i] = await worker(items[i]);
+      } catch {
+        results[i] = null;
+      }
+    }
+  }
+  await Promise.all(Array.from({ length: Math.min(concurrency, items.length) }, take));
+  return results;
+}
+async function getUserActivity(input) {
+  const groupIds = [...new Set(input.group_ids)];
+  const groupDiscussionLists = await runWithConcurrency(
+    groupIds,
+    (gid) => listDiscussionIdsForGroup(gid),
+    CONCURRENCY2
+  );
+  const discussions = [];
+  for (const list of groupDiscussionLists) {
+    if (list) discussions.push(...list);
+  }
+  const since = input.since ? Date.parse(input.since) : Number.NEGATIVE_INFINITY;
+  const until = input.until ? Date.parse(input.until) : Number.POSITIVE_INFINITY;
+  let eventsExamined = 0;
+  const counts = {
+    total: 0,
+    new_discussion: 0,
+    new_comment: 0,
+    poll_created: 0,
+    stance_created: 0,
+    outcome_created: 0,
+    reaction: 0,
+    other: 0
+  };
+  const byGroup = {};
+  const byMonth = {};
+  let firstActivity = null;
+  let lastActivity = null;
+  const samples = [];
+  const eventStreams = await runWithConcurrency(
+    discussions,
+    async (d) => ({ groupId: d.group_id, events: await fetchAllEventsForDiscussion(d.id) }),
+    CONCURRENCY2
+  );
+  for (const s of eventStreams) {
+    if (!s) continue;
+    for (const e of s.events) {
+      eventsExamined++;
+      if (e.actor_id !== input.user_id) continue;
+      const t = Date.parse(e.created_at);
+      if (Number.isNaN(t) || t < since || t >= until) continue;
+      if (!ACTIVITY_KINDS.has(e.kind)) {
+        counts.other++;
+      } else {
+        const slot = e.kind;
+        if (slot in counts && slot !== "total") counts[slot]++;
+      }
+      counts.total++;
+      byGroup[String(s.groupId)] = (byGroup[String(s.groupId)] ?? 0) + 1;
+      const month = e.created_at.slice(0, 7);
+      byMonth[month] = (byMonth[month] ?? 0) + 1;
+      if (!firstActivity || e.created_at < firstActivity) firstActivity = e.created_at;
+      if (!lastActivity || e.created_at > lastActivity) lastActivity = e.created_at;
+      if (samples.length < 10) {
+        samples.push({
+          kind: e.kind,
+          discussion_id: e.discussion_id,
+          created_at: e.created_at,
+          eventable_type: e.eventable_type,
+          eventable_id: e.eventable_id
+        });
+      }
+    }
+  }
+  return {
+    user_id: input.user_id,
+    scope: {
+      group_ids: groupIds,
+      discussions_scanned: discussions.length,
+      events_examined: eventsExamined,
+      since: input.since ?? null,
+      until: input.until ?? null
+    },
+    counts,
+    by_group: byGroup,
+    by_month: byMonth,
+    first_activity: firstActivity,
+    last_activity: lastActivity,
+    sample_events: samples
+  };
+}
+
+// src/tools/comments.ts
+import { z as z7 } from "zod";
+var createCommentSchema = z7.object({
   discussion_id: positiveId.describe("ID of the discussion to comment on."),
-  body: z6.string().min(1).describe("Comment body (required)."),
-  body_format: z6.enum(["md", "html"]).optional().describe("Format of `body`. Defaults to Loomio's group default when omitted.")
+  body: z7.string().min(1).describe("Comment body (required)."),
+  body_format: z7.enum(["md", "html"]).optional().describe("Format of `body`. Defaults to Loomio's group default when omitted.")
 });
 async function createComment(input) {
   const { discussion_id, ...rest } = input;
@@ -659,14 +839,14 @@ async function createComment(input) {
 }
 
 // src/tools/admin.ts
-import { z as z7 } from "zod";
-var deactivateUserSchema = z7.object({
+import { z as z8 } from "zod";
+var deactivateUserSchema = z8.object({
   id: positiveId.describe("Loomio user id to deactivate. Returns 404 if not active.")
 });
 async function deactivateUser(input) {
   return loomioPostB3("/b3/users/deactivate", { id: input.id });
 }
-var reactivateUserSchema = z7.object({
+var reactivateUserSchema = z8.object({
   id: positiveId.describe(
     "Loomio user id to reactivate. Returns 404 if not currently deactivated."
   )
@@ -746,6 +926,20 @@ function createLoomioMcpServer() {
     listGroupsSchema,
     listGroups
   );
+  registerTool(
+    server2,
+    "list_events",
+    "Fetch the full event stream for one discussion \u2014 every new_comment, poll_created, stance_created, outcome_created, reaction, discussion_moved, etc. \u2014 with actor_id, kind, parent_id, created_at, and pointers to the underlying eventable record. Required: `discussion_id`. Optional `limit` (1-200, default 50), `offset` (Loomio's `from` param), and `kinds` (client-side filter to specific event kinds). The response also embeds related `comments`, `users`, and `polls` arrays for in-place resolution. Use this to answer 'show me the reply tree for thread X', 'who participated in discussion Y', or as the building block for cross-discussion aggregations. Loomio's v1/events endpoint requires a discussion_id; there's no instance-wide or per-user index \u2014 for user-centric questions, use `get_user_activity`.",
+    listEventsSchema,
+    listEvents
+  );
+  registerTool(
+    server2,
+    "get_user_activity",
+    "Aggregate one user's activity across a set of groups. Server-side: fans out across every discussion in the specified groups, fetches its event stream, filters to events authored by the target user, and returns counts (by kind, by group, by month), plus first/last activity timestamps and a sample of recent events. Required: `user_id`, `group_ids` (1-50; pass the result of `list_groups` for instance-wide). Optional `since` / `until` (ISO-8601) bound the time window. Cost: one outbound HTTP call per discussion in scope (plus one `list_discussions` per group). Wide scans of an active instance commonly hit 100-300 calls in 5-30 seconds. Concurrency-capped at 6. Use this for 'tell me about user X', 'how active has user Y been in Q1', or before promoting/awarding someone. For one discussion at a time, use `list_events`.",
+    getUserActivitySchema,
+    getUserActivity
+  );
   if (!readOnly) {
     registerTool(
       server2,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "loomiomcp",
-  "version": "0.0.1",
+  "version": "0.0.2",
   "description": "Model Context Protocol server for Loomio. Lets Claude (Desktop, Code, or web Projects via Custom Connector) read and create Loomio discussions, polls, and group memberships in plain English.",
   "keywords": [
     "mcp",