basecamp-mcp 1.0.2 → 1.0.4

package/README.md

@@ -129,10 +129,13 @@ npm run dev
 - `basecamp_list_kanban_columns` - List all columns in a kanban board
 - `basecamp_list_kanban_cards` - List cards in a column with steps and assignees
 - `basecamp_get_kanban_card` - Get complete details of a specific card
-- `basecamp_create_kanban_card` - Create new card with title and optional content
-- `basecamp_update_kanban_card` - Update card with advanced content editing (supports full replacement, append, prepend, search/replace, plus title, due date, assignees, notifications)
+- `basecamp_create_kanban_card` - Create new card with title, content, and optional checklist steps
+- `basecamp_update_kanban_card` - Update card with advanced content editing (supports full replacement, append, prepend, search/replace, plus title, due date, assignees, notifications, and complete step array management)
 - `basecamp_move_kanban_card` - Move a card to a different column and/or position
-- `basecamp_create_kanban_step` - Add checklist step to a card
+
+#### Activity
+- `basecamp_list_recordings` - Browse recent activity globally or across specific projects, with filtering by type, date range, person, and text search. All filters support multiple values for OR-matching (e.g., multiple project IDs, person IDs, types, or search terms)
+- `basecamp_list_campfire_messages` - Browse chat messages from Campfires with filtering by campfire, person, text content, and date range. All filters support multiple values for OR-matching
 
 ## Development
 

package/dist/index.d.ts

@@ -9,6 +9,7 @@
  * - Comments (universal - work on any resource)
  * - People
  * - Kanban (cards, columns, steps)
+ * - Activity (recordings browsing)
  *
  * Environment variables required:
  * - BASECAMP_CLIENT_ID

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;GAgBG"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;GAiBG"}

package/dist/index.js

@@ -9,6 +9,7 @@
  * - Comments (universal - work on any resource)
  * - People
  * - Kanban (cards, columns, steps)
+ * - Activity (recordings browsing)
  *
  * Environment variables required:
  * - BASECAMP_CLIENT_ID
@@ -18,13 +19,16 @@
  */
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { registerActivityTools } from "./tools/activity.js";
 import { registerCommentTools } from "./tools/comments.js";
+import { registerDocumentTools } from "./tools/documents.js";
 import { registerKanbanTools } from "./tools/kanban.js";
 import { registerMessageTools } from "./tools/messages.js";
 import { registerPeopleTools } from "./tools/people.js";
 // Import tool registration functions
 import { registerProjectTools } from "./tools/projects.js";
 import { registerTodoTools } from "./tools/todos.js";
+import { registerUploadTools } from "./tools/uploads.js";
 /**
  * Main server initialization and startup
  */
@@ -55,6 +59,9 @@ async function main() {
     registerCommentTools(server);
     registerPeopleTools(server);
     registerKanbanTools(server);
+    registerActivityTools(server);
+    registerDocumentTools(server);
+    registerUploadTools(server);
     console.error("Tools registered successfully");
     // Create stdio transport
     const transport = new StdioServerTransport();

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,qCAAqC;AACrC,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAErD;;GAEG;AACH,KAAK,UAAU,IAAI;IACjB,0CAA0C;IAC1C,MAAM,eAAe,GAAG;QACtB,oBAAoB;QACpB,wBAAwB;QACxB,wBAAwB;QACxB,qBAAqB;KACtB,CAAC;IAEF,MAAM,OAAO,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;IAC3E,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,OAAO,CAAC,KAAK,CACX,kDAAkD,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACvE,CAAC;QACF,OAAO,CAAC,KAAK,CACX,+EAA+E,CAChF,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,6BAA6B;IAC7B,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,IAAI,EAAE,qBAAqB;QAC3B,OAAO,EAAE,OAAO;KACjB,CAAC,CAAC;IAEH,+BAA+B;IAC/B,OAAO,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC;IACtC,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAC7B,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAC7B,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAC1B,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAC7B,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAC5B,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAC5B,OAAO,CAAC,KAAK,CAAC,+BAA+B,CAAC,CAAC;IAE/C,yBAAyB;IACzB,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAE7C,8BAA8B;IAC9B,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAEhC,OAAO,CAAC,KAAK,CAAC,sCAAsC,CAAC,CAAC;IACtD,OAAO,CAAC,KAAK,CAAC,kCAAkC,CAAC,CAAC;AACpD,CAAC;AAED,iBAAiB;AACjB,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,2CAA2C,EAAE,KAAK,CAAC,CAAC;IAClE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,qCAAqC;AACrC,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAEzD;;GAEG;AACH,KAAK,UAAU,IAAI;IACjB,0CAA0C;IAC1C,MAAM,eAAe,GAAG;QACtB,oBAAoB;QACpB,wBAAwB;QACxB,wBAAwB;QACxB,qBAAqB;KACtB,CAAC;IAEF,MAAM,OAAO,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;IAC3E,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,OAAO,CAAC,KAAK,CACX,kDAAkD,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACvE,CAAC;QACF,OAAO,CAAC,KAAK,CACX,+EAA+E,CAChF,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,6BAA6B;IAC7B,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,IAAI,EAAE,qBAAqB;QAC3B,OAAO,EAAE,OAAO;KACjB,CAAC,CAAC;IAEH,+BAA+B;IAC/B,OAAO,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC;IACtC,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAC7B,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAC7B,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAC1B,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAC7B,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAC5B,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAC5B,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAC9B,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAC9B,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAC5B,OAAO,CAAC,KAAK,CAAC,+BAA+B,CAAC,CAAC;IAE/C,yBAAyB;IACzB,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAE7C,8BAA8B;IAC9B,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAEhC,OAAO,CAAC,KAAK,CAAC,sCAAsC,CAAC,CAAC;IACtD,OAAO,CAAC,KAAK,CAAC,kCAAkC,CAAC,CAAC;AACpD,CAAC;AAED,iBAAiB;AACjB,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,2CAA2C,EAAE,KAAK,CAAC,CAAC;IAClE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/tools/activity.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Activity browsing tools for Basecamp MCP server
+ *
+ * Uses the Basecamp recordings API to provide activity browsing:
+ * listing recent changes across projects with filtering by type,
+ * date range, person, project, and text search.
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+/**
+ * Register all activity-related tools with the MCP server
+ */
+export declare function registerActivityTools(server: McpServer): void;
+//# sourceMappingURL=activity.d.ts.map

package/dist/tools/activity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"activity.d.ts","sourceRoot":"","sources":["../../src/tools/activity.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAwHzE;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAqiB7D"}

package/dist/tools/activity.js

@@ -0,0 +1,547 @@
+/**
+ * Activity browsing tools for Basecamp MCP server
+ *
+ * Uses the Basecamp recordings API to provide activity browsing:
+ * listing recent changes across projects with filtering by type,
+ * date range, person, project, and text search.
+ */
+import { asyncPagedIterator } from "basecamp-client";
+import { z } from "zod";
+import { CHARACTER_LIMIT, DEFAULT_LIMIT } from "../constants.js";
+import { BasecampIdSchema } from "../schemas/common.js";
+import { initializeBasecampClient } from "../utils/auth.js";
+import { handleBasecampError } from "../utils/errorHandlers.js";
+/** Default recording types to fetch when no type filter is specified */
+const DEFAULT_RECORDING_TYPES = [
+    "Todo",
+    "Message",
+    "Document",
+    "Comment",
+    "Upload",
+    "Kanban::Card",
+];
+/** Map of friendly type aliases to canonical Basecamp API type names */
+const TYPE_ALIASES = {
+    todo: "Todo",
+    todos: "Todo",
+    message: "Message",
+    messages: "Message",
+    msg: "Message",
+    document: "Document",
+    doc: "Document",
+    docs: "Document",
+    comment: "Comment",
+    comments: "Comment",
+    upload: "Upload",
+    uploads: "Upload",
+    file: "Upload",
+    files: "Upload",
+    todolist: "Todolist",
+    question: "Question::Answer",
+    answer: "Question::Answer",
+    event: "Schedule::Entry",
+    schedule: "Schedule::Entry",
+    vault: "Vault",
+    card: "Kanban::Card",
+    cards: "Kanban::Card",
+    kanban: "Kanban::Card",
+    step: "Kanban::Step",
+    steps: "Kanban::Step",
+};
+/**
+ * Parse a "since" value into a Date object.
+ *
+ * Supports:
+ * - Relative durations: "24h", "7d", "2w"
+ * - Keywords: "today", "yesterday"
+ * - ISO 8601 dates: "2024-01-15", "2024-01-15T10:00:00Z"
+ */
+function parseSince(value) {
+    const now = new Date();
+    const trimmed = value.trim();
+    const lower = trimmed.toLowerCase();
+    // Relative durations: Nh, Nd, Nw
+    const hourMatch = lower.match(/^(\d+)h$/);
+    if (hourMatch) {
+        return new Date(now.getTime() - Number.parseInt(hourMatch[1], 10) * 3600000);
+    }
+    const dayMatch = lower.match(/^(\d+)d$/);
+    if (dayMatch) {
+        return new Date(now.getTime() - Number.parseInt(dayMatch[1], 10) * 86400000);
+    }
+    const weekMatch = lower.match(/^(\d+)w$/);
+    if (weekMatch) {
+        return new Date(now.getTime() - Number.parseInt(weekMatch[1], 10) * 7 * 86400000);
+    }
+    // Keywords
+    if (lower === "today") {
+        const d = new Date(now);
+        d.setHours(0, 0, 0, 0);
+        return d;
+    }
+    if (lower === "yesterday") {
+        const d = new Date(now);
+        d.setDate(d.getDate() - 1);
+        d.setHours(0, 0, 0, 0);
+        return d;
+    }
+    // ISO 8601 / date string
+    const parsed = new Date(trimmed);
+    if (Number.isNaN(parsed.getTime())) {
+        throw new Error(`Invalid since value: "${value}". ` +
+            'Use ISO 8601 (e.g., "2024-01-15"), relative duration (e.g., "24h", "7d", "2w"), ' +
+            'or keyword ("today", "yesterday").');
+    }
+    return parsed;
+}
+/**
+ * Resolve an array of type strings (possibly using aliases)
+ * to deduplicated canonical Basecamp API type names.
+ */
+function resolveTypes(types) {
+    const resolved = new Set();
+    for (const t of types) {
+        const lower = t.trim().toLowerCase();
+        resolved.add(TYPE_ALIASES[lower] || t.trim());
+    }
+    return [...resolved];
+}
+/**
+ * Register all activity-related tools with the MCP server
+ */
+export function registerActivityTools(server) {
+    server.registerTool("basecamp_list_recordings", {
+        title: "List Basecamp Activity (Recordings)",
+        description: `Browse recent activity across Basecamp by listing recordings. Recordings represent all content in Basecamp: todos, messages, documents, comments, uploads, and more.
+
+Use this tool to:
+- See what's been happening across all projects or specific projects
+- Find recent activity by one or more people
+- Review changes since a specific date or time period
+- Filter activity by content type (todos, messages, documents, etc.)
+- Search activity by title text
+
+All filters support multiple values for OR-matching.
+
+Examples:
+  - "What happened in the last 24 hours?" → since: "24h"
+  - "Show recent todos in project 12345" → project_ids: [12345], type: ["todo"]
+  - "What did Alice and Bob do this week?" → person_ids: [111, 222], since: "7d"
+  - "Find messages mentioning launch across projects 1 and 2" → project_ids: [1, 2], type: ["message"], query: ["launch"]
+  - "Find items about design or UX" → query: ["design", "UX"]
+  - "List all messages across projects" → type: ["message"]`,
+        inputSchema: {
+            project_ids: z
+                .array(BasecampIdSchema)
+                .optional()
+                .describe("Filter to specific projects (bucket IDs). Supports multiple IDs for OR-matching. Omit to browse across all projects."),
+            type: z
+                .array(z.string())
+                .optional()
+                .describe('Recording type filter. Options: "todo", "message", "document", "comment", "upload", ' +
+                '"todolist", "question", "schedule", "vault". ' +
+                "Supports multiple values for OR-matching. " +
+                "Omit to fetch all common types (todo, message, document, comment, upload, card)."),
+            since: z
+                .string()
+                .optional()
+                .describe('Show activity since this time. Accepts ISO 8601 dates (e.g., "2024-01-15"), ' +
+                'relative durations ("24h", "7d", "2w"), or keywords ("today", "yesterday").'),
+            person_ids: z
+                .array(BasecampIdSchema)
+                .optional()
+                .describe("Filter by creator person IDs. Supports multiple IDs for OR-matching. Use basecamp_list_people to find person IDs."),
+            query: z
+                .array(z.string())
+                .optional()
+                .describe("Case-insensitive text search against recording titles. Supports multiple terms for OR-matching."),
+            sort: z
+                .enum(["created_at", "updated_at"])
+                .optional()
+                .describe('Sort field: "created_at" (default) or "updated_at".'),
+            direction: z
+                .enum(["desc", "asc"])
+                .optional()
+                .describe('Sort direction: "desc" (default, newest first) or "asc" (oldest first).'),
+            status: z
+                .enum(["active", "archived", "trashed"])
+                .optional()
+                .describe('Recording status filter: "active" (default), "archived", or "trashed".'),
+            limit: z
+                .number()
+                .min(1)
+                .max(100)
+                .optional()
+                .describe(`Maximum number of recordings to return (default: ${DEFAULT_LIMIT}, max: 100).`),
+        },
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true,
+        },
+    }, async (params) => {
+        try {
+            const client = await initializeBasecampClient();
+            // Determine which types to fetch
+            const types = params.type
+                ? resolveTypes(params.type)
+                : DEFAULT_RECORDING_TYPES;
+            // Build shared query params
+            const baseQuery = {};
+            if (params.project_ids && params.project_ids.length > 0) {
+                baseQuery.bucket = params.project_ids.join(",");
+            }
+            if (params.sort) {
+                baseQuery.sort = params.sort;
+            }
+            if (params.direction) {
+                baseQuery.direction = params.direction;
+            }
+            if (params.status) {
+                baseQuery.status = params.status;
+            }
+            // Parse since date upfront if provided
+            const sinceDate = params.since ? parseSince(params.since) : null;
+            const sortField = params.sort || "created_at";
+            // Fetch recordings for each type in parallel, with early termination if since is set
+            const fetchPromises = types.map(async (type) => {
+                const items = [];
+                for await (const item of asyncPagedIterator({
+                    fetchPage: client.recordings.list,
+                    request: {
+                        query: { type, ...baseQuery },
+                    },
+                })) {
+                    // If filtering by date and results are sorted desc (default),
+                    // stop once we hit records older than the cutoff
+                    if (sinceDate && params.direction !== "asc") {
+                        const itemDate = new Date(sortField === "updated_at" ? item.updated_at : item.created_at);
+                        if (itemDate < sinceDate) {
+                            break;
+                        }
+                    }
+                    items.push(item);
+                }
+                return items;
+            });
+            const results = await Promise.all(fetchPromises);
+            let filtered = results.flat();
+            // If direction is asc, we couldn't do early termination, so filter now
+            if (sinceDate && params.direction === "asc") {
+                filtered = filtered.filter((r) => {
+                    const date = new Date(sortField === "updated_at" ? r.updated_at : r.created_at);
+                    return date >= sinceDate;
+                });
+            }
+            // Filter by person IDs (OR-match)
+            if (params.person_ids && params.person_ids.length > 0) {
+                const personIdSet = new Set(params.person_ids);
+                filtered = filtered.filter((r) => r.creator && personIdSet.has(r.creator.id));
+            }
+            // Filter by text search (case-insensitive substring match on title, OR-matching)
+            if (params.query && params.query.length > 0) {
+                const lowerQueries = params.query.map((q) => q.toLowerCase());
+                filtered = filtered.filter((r) => {
+                    const lowerTitle = r.title.toLowerCase();
+                    return lowerQueries.some((q) => lowerTitle.includes(q));
+                });
+            }
+            // Sort merged results
+            const sortDir = params.direction || "desc";
+            filtered.sort((a, b) => {
+                const dateA = new Date(sortField === "updated_at" ? a.updated_at : a.created_at).getTime();
+                const dateB = new Date(sortField === "updated_at" ? b.updated_at : b.created_at).getTime();
+                return sortDir === "desc" ? dateB - dateA : dateA - dateB;
+            });
+            // Apply limit
+            const limit = params.limit || DEFAULT_LIMIT;
+            const total = filtered.length;
+            filtered = filtered.slice(0, limit);
+            // Serialize response
+            const serialized = filtered.map((r) => ({
+                id: r.id,
+                type: r.type,
+                title: r.title,
+                status: r.status,
+                created_at: r.created_at,
+                updated_at: r.updated_at,
+                url: r.app_url,
+                creator: r.creator
+                    ? {
+                        id: r.creator.id,
+                        name: r.creator.name,
+                        email: r.creator.email_address,
+                    }
+                    : null,
+                project: r.bucket
+                    ? {
+                        id: r.bucket.id,
+                        name: r.bucket.name,
+                    }
+                    : null,
+                ...(r.parent
+                    ? {
+                        parent: {
+                            id: r.parent.id,
+                            title: r.parent.title,
+                            type: r.parent.type,
+                        },
+                    }
+                    : {}),
+            }));
+            const result = {
+                recordings: serialized,
+                total_fetched: total,
+                returned: serialized.length,
+            };
+            if (total > limit) {
+                result.truncated = true;
+                result.truncation_message = `Showing ${limit} of ${total} recordings. Increase limit or narrow filters to see more.`;
+            }
+            let jsonStr = JSON.stringify(result, null, 2);
+            // Handle response size limit
+            if (jsonStr.length > CHARACTER_LIMIT) {
+                const reducedLimit = Math.floor(serialized.length / 2);
+                const reduced = serialized.slice(0, reducedLimit);
+                jsonStr = JSON.stringify({
+                    recordings: reduced,
+                    total_fetched: total,
+                    returned: reduced.length,
+                    truncated: true,
+                    truncation_message: `Response truncated to ${reduced.length} recordings due to size limits. Use more specific filters or a smaller limit.`,
+                }, null, 2);
+            }
+            return {
+                content: [{ type: "text", text: jsonStr }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: handleBasecampError(error) }],
+            };
+        }
+    });
+    server.registerTool("basecamp_list_campfire_messages", {
+        title: "List Campfire Messages",
+        description: `Browse chat messages from Basecamp Campfires. Campfires are real-time chat rooms within projects.
+
+Use this tool to:
+- See recent chat activity across all campfires or specific ones
+- Find messages from specific people
+- Search message content for keywords
+- Review chat history since a specific date or time period
+
+All filters support multiple values for OR-matching.
+
+Examples:
+  - "What's been discussed in chat today?" → since: "today"
+  - "Show messages from Alice and Bob" → person_ids: [111, 222]
+  - "Find chat messages mentioning deploy or release" → query: ["deploy", "release"]
+  - "Recent messages in campfire 12345" → campfire_ids: [12345]`,
+        inputSchema: {
+            campfire_ids: z
+                .array(BasecampIdSchema)
+                .optional()
+                .describe("Filter to specific campfires by ID. Supports multiple IDs for OR-matching. Omit to browse all campfires."),
+            person_ids: z
+                .array(BasecampIdSchema)
+                .optional()
+                .describe("Filter by sender person IDs. Supports multiple IDs for OR-matching. Use basecamp_list_people to find person IDs."),
+            query: z
+                .array(z.string())
+                .optional()
+                .describe("Case-insensitive text search against message content. Supports multiple terms for OR-matching."),
+            since: z
+                .string()
+                .optional()
+                .describe('Show messages since this time. Accepts ISO 8601 dates (e.g., "2024-01-15"), ' +
+                'relative durations ("24h", "7d", "2w"), or keywords ("today", "yesterday").'),
+            limit: z
+                .number()
+                .min(1)
+                .max(100)
+                .optional()
+                .describe(`Maximum number of messages to return (default: ${DEFAULT_LIMIT}, max: 100).`),
+        },
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true,
+        },
+    }, async (params) => {
+        try {
+            const client = await initializeBasecampClient();
+            // Parse since date upfront if provided
+            const sinceDate = params.since ? parseSince(params.since) : null;
+            // Determine which campfires to fetch from
+            let campfiresToFetch = [];
+            if (params.campfire_ids && params.campfire_ids.length > 0) {
+                // Fetch all campfires to get bucket IDs for the requested campfire IDs
+                const allCampfires = [];
+                for await (const campfire of asyncPagedIterator({
+                    fetchPage: client.campfires.list,
+                    request: {},
+                })) {
+                    allCampfires.push(campfire);
+                }
+                const campfireIdSet = new Set(params.campfire_ids);
+                campfiresToFetch = allCampfires
+                    .filter((c) => campfireIdSet.has(c.id))
+                    .map((c) => ({
+                    bucketId: c.bucket.id,
+                    campfireId: c.id,
+                    campfireName: c.title,
+                    projectName: c.bucket.name,
+                }));
+                if (campfiresToFetch.length === 0) {
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: JSON.stringify({
+                                    error: "No campfires found matching the provided IDs.",
+                                    provided_ids: params.campfire_ids,
+                                }, null, 2),
+                            },
+                        ],
+                    };
+                }
+            }
+            else {
+                // Fetch all campfires, filtering by updated_at if since is provided
+                for await (const campfire of asyncPagedIterator({
+                    fetchPage: client.campfires.list,
+                    request: {},
+                })) {
+                    // Skip campfires that haven't been updated since the filter date
+                    if (sinceDate) {
+                        const campfireUpdatedAt = new Date(campfire.updated_at);
+                        if (campfireUpdatedAt < sinceDate) {
+                            continue;
+                        }
+                    }
+                    campfiresToFetch.push({
+                        bucketId: campfire.bucket.id,
+                        campfireId: campfire.id,
+                        campfireName: campfire.title,
+                        projectName: campfire.bucket.name,
+                    });
+                }
+                if (campfiresToFetch.length === 0) {
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: JSON.stringify({ messages: [], total_fetched: 0, returned: 0 }, null, 2),
+                            },
+                        ],
+                    };
+                }
+            }
+            // Fetch lines from each campfire in parallel
+            const fetchPromises = campfiresToFetch.map(async ({ bucketId, campfireId, campfireName, projectName }) => {
+                const lines = [];
+                for await (const line of asyncPagedIterator({
+                    fetchPage: client.campfires.listLines,
+                    request: {
+                        params: { bucketId, campfireId },
+                    },
+                })) {
+                    // API returns newest first - early termination if since is set
+                    if (sinceDate) {
+                        const lineDate = new Date(line.created_at);
+                        if (lineDate < sinceDate) {
+                            break;
+                        }
+                    }
+                    lines.push({
+                        ...line,
+                        campfire_name: campfireName,
+                        project_name: projectName,
+                    });
+                }
+                return lines;
+            });
+            const results = await Promise.all(fetchPromises);
+            let allLines = results.flat();
+            // Filter by person IDs (OR-match)
+            if (params.person_ids && params.person_ids.length > 0) {
+                const personIdSet = new Set(params.person_ids);
+                allLines = allLines.filter((line) => line.creator && personIdSet.has(line.creator.id));
+            }
+            // Filter by text search (case-insensitive substring match on content, OR-matching)
+            if (params.query && params.query.length > 0) {
+                const lowerQueries = params.query.map((q) => q.toLowerCase());
+                allLines = allLines.filter((line) => {
+                    const lowerContent = line.content.toLowerCase();
+                    return lowerQueries.some((q) => lowerContent.includes(q));
+                });
+            }
+            // Sort all messages by created_at desc (newest first)
+            allLines.sort((a, b) => {
+                const dateA = new Date(a.created_at).getTime();
+                const dateB = new Date(b.created_at).getTime();
+                return dateB - dateA;
+            });
+            // Apply limit
+            const limit = params.limit || DEFAULT_LIMIT;
+            const total = allLines.length;
+            allLines = allLines.slice(0, limit);
+            // Serialize response
+            const serialized = allLines.map((line) => ({
+                id: line.id,
+                content: line.content,
+                created_at: line.created_at,
+                url: line.app_url,
+                creator: line.creator
+                    ? {
+                        id: line.creator.id,
+                        name: line.creator.name,
+                        email: line.creator.email_address,
+                    }
+                    : null,
+                campfire: {
+                    id: line.parent?.id,
+                    name: line.campfire_name,
+                },
+                project: {
+                    id: line.bucket.id,
+                    name: line.project_name,
+                },
+            }));
+            const result = {
+                messages: serialized,
+                total_fetched: total,
+                returned: serialized.length,
+            };
+            if (total > limit) {
+                result.truncated = true;
+                result.truncation_message = `Showing ${limit} of ${total} messages. Increase limit or narrow filters to see more.`;
+            }
+            let jsonStr = JSON.stringify(result, null, 2);
+            // Handle response size limit
+            if (jsonStr.length > CHARACTER_LIMIT) {
+                const reducedLimit = Math.floor(serialized.length / 2);
+                const reduced = serialized.slice(0, reducedLimit);
+                jsonStr = JSON.stringify({
+                    messages: reduced,
+                    total_fetched: total,
+                    returned: reduced.length,
+                    truncated: true,
+                    truncation_message: `Response truncated to ${reduced.length} messages due to size limits. Use more specific filters or a smaller limit.`,
+                }, null, 2);
+            }
+            return {
+                content: [{ type: "text", text: jsonStr }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: handleBasecampError(error) }],
+            };
+        }
+    });
+}
+//# sourceMappingURL=activity.js.map