aiquila-mcp 0.3.21 → 0.3.22

package/dist/tool-registry.js

@@ -33,6 +33,7 @@ import { talkTools } from './tools/apps/talk.js';
 import { userStatusTools } from './tools/apps/user-status.js';
 import { absenceTools } from './tools/apps/absence.js';
 import { notificationsTools } from './tools/apps/notifications.js';
+import { activityTools } from './tools/apps/activity.js';
 import { trashTools } from './tools/apps/trash.js';
 import { versionsTools } from './tools/apps/versions.js';
 import { projectsTools } from './tools/apps/projects.js';
@@ -86,6 +87,7 @@ export const TOOL_REGISTRY = [
     { category: 'translate', appIds: ['text_translate', 'translate'], tools: translateTools },
     { category: 'user_status', appIds: ['user_status'], tools: userStatusTools },
     { category: 'notifications', appIds: ['notifications'], tools: notificationsTools },
+    { category: 'activity', appIds: ['activity'], tools: activityTools },
 ];
 const ALL_CATEGORIES = new Set(TOOL_REGISTRY.map((e) => e.category));
 /**

package/dist/tools/apps/activity.js

@@ -0,0 +1,127 @@
+// SPDX-License-Identifier: MIT
+import { z } from 'zod';
+import { fetchOCS } from '../../client/ocs.js';
+function formatActivities(activities) {
+    return activities
+        .map((a) => {
+        const time = a.datetime ? ` (${a.datetime})` : '';
+        const msg = a.message ? `\n  ${a.message}` : '';
+        return `- [${a.app}] ${a.subject}${time}${msg}`;
+    })
+        .join('\n');
+}
+// ---------------------------------------------------------------------------
+// list_activity
+// ---------------------------------------------------------------------------
+export const listActivityTool = {
+    name: 'list_activity',
+    description: 'List recent entries from the Nextcloud activity feed (file changes, shares, ' +
+        'comments, calendar/contact edits, etc.) for the current user.',
+    inputSchema: z.object({
+        filter: z
+            .enum(['all', 'self', 'by'])
+            .optional()
+            .describe("Which feed to read: 'all' (default), 'self' (your own actions), or 'by' (others' actions)"),
+        limit: z.number().optional().describe('Maximum number of activities to return (default 50)'),
+        since: z
+            .number()
+            .optional()
+            .describe('Return activities after this activity_id (for pagination)'),
+        sort: z
+            .enum(['asc', 'desc'])
+            .optional()
+            .describe("Sort order by time: 'desc' (newest first, default) or 'asc'"),
+    }),
+    handler: async (args) => {
+        try {
+            const filter = args.filter ?? 'all';
+            const queryParams = {
+                limit: String(args.limit ?? 50),
+                sort: args.sort ?? 'desc',
+            };
+            if (args.since !== undefined)
+                queryParams.since = String(args.since);
+            const result = await fetchOCS(`/ocs/v2.php/apps/activity/api/v2/activity/${filter}`, { queryParams });
+            const activities = result.ocs.data;
+            if (activities.length === 0) {
+                return {
+                    content: [{ type: 'text', text: 'No activity.' }],
+                };
+            }
+            const lastId = activities[activities.length - 1].activity_id;
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Activity (${activities.length}):\n${formatActivities(activities)}\n\n` +
+                            `Last activity_id: ${lastId} (pass as 'since' to page further).`,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Error listing activity: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    },
+};
+// ---------------------------------------------------------------------------
+// get_object_activity
+// ---------------------------------------------------------------------------
+export const getObjectActivityTool = {
+    name: 'get_object_activity',
+    description: 'List the activity history for a single object, e.g. one file. Use object_type ' +
+        "'files' with a file ID to see what happened to that file.",
+    inputSchema: z.object({
+        object_type: z.string().optional().describe("The object type to filter by (default 'files')"),
+        object_id: z.string().describe('The object ID (e.g. the Nextcloud file ID)'),
+        limit: z.number().optional().describe('Maximum number of activities to return (default 50)'),
+    }),
+    handler: async (args) => {
+        try {
+            const result = await fetchOCS('/ocs/v2.php/apps/activity/api/v2/activity/filter', {
+                queryParams: {
+                    object_type: args.object_type ?? 'files',
+                    object_id: args.object_id,
+                    limit: String(args.limit ?? 50),
+                },
+            });
+            const activities = result.ocs.data;
+            if (activities.length === 0) {
+                return {
+                    content: [{ type: 'text', text: 'No activity for this object.' }],
+                };
+            }
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Activity (${activities.length}):\n${formatActivities(activities)}`,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Error getting object activity: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    },
+};
+// ---------------------------------------------------------------------------
+// Export
+// ---------------------------------------------------------------------------
+export const activityTools = [listActivityTool, getObjectActivityTool];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aiquila-mcp",
-  "version": "0.3.21",
+  "version": "0.3.22",
   "description": "Nextcloud MCP server — files, calendar, contacts, mail, maps, notes, tasks & 120+ more tools",
   "type": "module",
   "main": "dist/index.js",