@basicbit/vrchat-mcp 0.1.0

package/dist/src/tools/curated/events.js

@@ -0,0 +1,212 @@
+import { shapeReadData } from '../../core/readTools.js';
+import { CalendarEventCreateSchema, CalendarEventDeleteSchema, CalendarEventFollowSchema, CalendarEventUpdateSchema, CalendarEventWriteOutputSchema, EventsDiscoverInputSchema, EventsDiscoverOutputSchema, EventsSearchInputSchema, EventsSearchOutputSchema, EventsUpcomingInputSchema, EventsUpcomingOutputSchema, } from '../../models/events.js';
+import { buildCalendarCreateRequest, buildCalendarUpdateRequest, createCalendarEvent, deleteCalendarEvent, discoverEvents, followCalendarEvent, listUpcomingEvents, searchEvents, updateCalendarEvent, } from '../../services/events/curated.js';
+import { checkGroupAllowed } from '../../services/groups/index.js';
+import { destructiveToolAnnotations, readOnlyToolAnnotations, writeToolAnnotations, } from '../../utils/toolAnnotations.js';
+import { toolName } from '../../utils/toolNames.js';
+import { textContent, toolError } from '../../utils/toolResponses.js';
+export function registerCuratedEventTools(server) {
+    server.registerTool(toolName('vrchat.events.discover'), {
+        description: 'Discover public calendar events with optional category/tag filters (read-only).',
+        inputSchema: EventsDiscoverInputSchema,
+        outputSchema: EventsDiscoverOutputSchema,
+        annotations: readOnlyToolAnnotations,
+    }, async (args) => {
+        try {
+            const result = await discoverEvents(args ?? {});
+            const events = shapeReadData(result.events, {
+                fields: args?.fields,
+                compact: args?.compact,
+                maxArrayLength: args?.maxArrayLength,
+            });
+            const payload = {
+                scope: result.scope,
+                pageSize: result.pageSize,
+                maxPages: result.maxPages,
+                maxItems: result.maxItems,
+                totalEvents: result.totalEvents,
+                truncated: result.truncated,
+                nextCursor: result.nextCursor,
+                page: result.page,
+                events: events,
+            };
+            return {
+                content: textContent(JSON.stringify(payload, null, 2)),
+                structuredContent: payload,
+            };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : 'Unknown error';
+            return toolError(message);
+        }
+    });
+    server.registerTool(toolName('vrchat.events.upcoming'), {
+        description: 'List calendar events in the upcoming window (read-only). Defaults to the next 7 days.',
+        inputSchema: EventsUpcomingInputSchema,
+        outputSchema: EventsUpcomingOutputSchema,
+        annotations: readOnlyToolAnnotations,
+    }, async (args) => {
+        try {
+            const result = await listUpcomingEvents(args ?? {});
+            const payload = {
+                from: result.from.toISOString(),
+                to: result.to.toISOString(),
+                windowHours: result.windowHours,
+                pageSize: result.pageSize,
+                maxPages: result.maxPages,
+                maxItems: result.maxItems,
+                totalEvents: result.totalEvents,
+                truncated: result.truncated,
+                segments: result.segments,
+                events: result.events,
+            };
+            return {
+                content: textContent(JSON.stringify(payload, null, 2)),
+                structuredContent: payload,
+            };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : 'Unknown error';
+            return toolError(message);
+        }
+    });
+    server.registerTool(toolName('vrchat.events.search'), {
+        description: 'Search calendar events by term (read-only).',
+        inputSchema: EventsSearchInputSchema,
+        outputSchema: EventsSearchOutputSchema,
+        annotations: readOnlyToolAnnotations,
+    }, async (args) => {
+        try {
+            const result = await searchEvents(args ?? {});
+            const payload = {
+                searchTerm: result.searchTerm,
+                utcOffset: result.utcOffset,
+                pageSize: result.pageSize,
+                maxPages: result.maxPages,
+                totalEvents: result.totalEvents,
+                truncated: result.truncated,
+                page: result.page,
+                events: result.events,
+            };
+            return {
+                content: textContent(JSON.stringify(payload, null, 2)),
+                structuredContent: payload,
+            };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : 'Unknown error';
+            return toolError(message);
+        }
+    });
+    server.registerTool(toolName('vrchat.event.create'), {
+        description: 'Create a group calendar event.',
+        inputSchema: CalendarEventCreateSchema,
+        outputSchema: CalendarEventWriteOutputSchema,
+        annotations: writeToolAnnotations,
+    }, async (args) => {
+        try {
+            const input = CalendarEventCreateSchema.parse(args);
+            const allowed = checkGroupAllowed(input.groupId);
+            if (!allowed.ok) {
+                return toolError(allowed.reason);
+            }
+            const request = buildCalendarCreateRequest(input);
+            const event = await createCalendarEvent(input.groupId, request);
+            const payload = {
+                status: 'created',
+                event: event ?? null,
+            };
+            return {
+                content: textContent(JSON.stringify(payload, null, 2)),
+                structuredContent: payload,
+            };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : 'Unknown error';
+            return toolError(message);
+        }
+    });
+    server.registerTool(toolName('vrchat.event.update'), {
+        description: 'Update a group calendar event.',
+        inputSchema: CalendarEventUpdateSchema,
+        outputSchema: CalendarEventWriteOutputSchema,
+        annotations: writeToolAnnotations,
+    }, async (args) => {
+        try {
+            const input = CalendarEventUpdateSchema.parse(args);
+            const allowed = checkGroupAllowed(input.groupId);
+            if (!allowed.ok) {
+                return toolError(allowed.reason);
+            }
+            const request = buildCalendarUpdateRequest(input);
+            const event = await updateCalendarEvent(input.groupId, input.calendarId, request);
+            const payload = {
+                status: 'updated',
+                event: event ?? null,
+            };
+            return {
+                content: textContent(JSON.stringify(payload, null, 2)),
+                structuredContent: payload,
+            };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : 'Unknown error';
+            return toolError(message);
+        }
+    });
+    server.registerTool(toolName('vrchat.event.follow'), {
+        description: 'Follow or unfollow a group calendar event.',
+        inputSchema: CalendarEventFollowSchema,
+        outputSchema: CalendarEventWriteOutputSchema,
+        annotations: writeToolAnnotations,
+    }, async (args) => {
+        try {
+            const input = CalendarEventFollowSchema.parse(args);
+            const allowed = checkGroupAllowed(input.groupId);
+            if (!allowed.ok) {
+                return toolError(allowed.reason);
+            }
+            const event = await followCalendarEvent(input);
+            const payload = {
+                status: input.isFollowing ? 'followed' : 'unfollowed',
+                event: event ?? null,
+            };
+            return {
+                content: textContent(JSON.stringify(payload, null, 2)),
+                structuredContent: payload,
+            };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : 'Unknown error';
+            return toolError(message);
+        }
+    });
+    server.registerTool(toolName('vrchat.event.delete'), {
+        description: 'Delete a group calendar event.',
+        inputSchema: CalendarEventDeleteSchema,
+        outputSchema: CalendarEventWriteOutputSchema,
+        annotations: destructiveToolAnnotations,
+    }, async (args) => {
+        try {
+            const input = CalendarEventDeleteSchema.parse(args);
+            const allowed = checkGroupAllowed(input.groupId);
+            if (!allowed.ok) {
+                return toolError(allowed.reason);
+            }
+            const result = await deleteCalendarEvent(input.groupId, input.calendarId);
+            const payload = {
+                status: 'deleted',
+                result: result ?? null,
+            };
+            return {
+                content: textContent(JSON.stringify(payload, null, 2)),
+                structuredContent: payload,
+            };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : 'Unknown error';
+            return toolError(message);
+        }
+    });
+}
+//# sourceMappingURL=events.js.map

package/dist/src/tools/curated/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../../../src/tools/curated/events.ts"],"names":[],"mappings":"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"}

package/dist/src/tools/curated/friends.js

@@ -0,0 +1,168 @@
+import { FriendDetailsInputSchema, FriendDetailsOutputSchema, FriendSearchInputSchema, FriendSearchOutputSchema, FriendsListInputSchema, FriendsListOutputSchema, FriendsOverviewInputSchema, FriendsOverviewOutputSchema, } from '../../models/friends.js';
+import { getFriendDetails, getFriendsOverview, listFriends, searchFriends, } from '../../services/friends/index.js';
+import { readOnlyToolAnnotations } from '../../utils/toolAnnotations.js';
+import { toolName } from '../../utils/toolNames.js';
+import { textContent, toolError } from '../../utils/toolResponses.js';
+function summarizeFriend(friend) {
+    const userId = typeof friend.userId === 'string'
+        ? friend.userId
+        : typeof friend.id === 'string'
+            ? friend.id
+            : undefined;
+    return {
+        userId,
+        displayName: typeof friend.displayName === 'string' ? friend.displayName : undefined,
+        status: typeof friend.status === 'string' ? friend.status : undefined,
+        statusDescription: typeof friend.statusDescription === 'string' ? friend.statusDescription : undefined,
+        statusEmoji: typeof friend.statusEmoji === 'string' ? friend.statusEmoji : undefined,
+        location: typeof friend.location === 'string' ? friend.location : undefined,
+        userIcon: typeof friend.userIcon === 'string' ? friend.userIcon : undefined,
+        profilePicOverride: typeof friend.profilePicOverride === 'string' ? friend.profilePicOverride : undefined,
+        currentAvatarImageUrl: typeof friend.currentAvatarImageUrl === 'string' ? friend.currentAvatarImageUrl : undefined,
+        currentAvatarThumbnailImageUrl: typeof friend.currentAvatarThumbnailImageUrl === 'string'
+            ? friend.currentAvatarThumbnailImageUrl
+            : undefined,
+        last_login: typeof friend.last_login === 'string' ? friend.last_login : undefined,
+        last_platform: typeof friend.last_platform === 'string' ? friend.last_platform : undefined,
+    };
+}
+export function registerCuratedFriendTools(server) {
+    server.registerTool(toolName('vrchat.friends.search'), {
+        description: 'Search friends by display name (read-only).',
+        inputSchema: FriendSearchInputSchema,
+        outputSchema: FriendSearchOutputSchema,
+        annotations: readOnlyToolAnnotations,
+    }, async (args) => {
+        try {
+            const query = String(args?.query ?? '').trim();
+            if (!query)
+                return toolError('query is required');
+            const result = await searchFriends({ ...(args ?? {}), query });
+            const payload = {
+                query,
+                includeOffline: result.includeOffline,
+                totalFriends: result.totalFriends,
+                matches: result.matches,
+            };
+            return {
+                content: textContent(JSON.stringify(payload, null, 2)),
+                structuredContent: payload,
+            };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : 'Unknown error';
+            return toolError(message);
+        }
+    });
+    server.registerTool(toolName('vrchat.friends.list'), {
+        description: 'List friends with cache-backed pagination (read-only). Defaults to online-only; set includeOffline=true to include offline friends.',
+        inputSchema: FriendsListInputSchema,
+        outputSchema: FriendsListOutputSchema,
+        annotations: readOnlyToolAnnotations,
+    }, async (args) => {
+        try {
+            const result = await listFriends(args ?? {});
+            const detailLevel = args?.detailLevel === 'full' ? 'full' : 'summary';
+            const friends = detailLevel === 'full'
+                ? result.friends
+                : result.friends.map((friend) => summarizeFriend(friend));
+            const payload = {
+                includeOffline: result.includeOffline,
+                pageSize: result.pageSize,
+                maxPages: result.maxPages,
+                maxItems: result.maxItems,
+                totalFriends: result.friends.length,
+                truncated: result.meta.truncated,
+                stale: result.meta.stale,
+                segments: result.meta.segments,
+                detailLevel,
+                friends,
+            };
+            return {
+                content: textContent(JSON.stringify(payload, null, 2)),
+                structuredContent: payload,
+            };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : 'Unknown error';
+            return toolError(message);
+        }
+    });
+    server.registerTool(toolName('vrchat.friends.overview'), {
+        description: 'Summarize friends by status and location with enriched world/group info (read-only).',
+        inputSchema: FriendsOverviewInputSchema,
+        outputSchema: FriendsOverviewOutputSchema,
+        annotations: readOnlyToolAnnotations,
+    }, async (args) => {
+        try {
+            const result = await getFriendsOverview(args ?? {});
+            const payload = {
+                includeOffline: result.includeOffline,
+                statusFilter: result.statusFilter,
+                minInstanceUserCount: result.minInstanceUserCount,
+                instanceDetailLevel: result.instanceDetailLevel,
+                totalFriends: result.totalFriends,
+                onlineCount: result.onlineCount,
+                offlineCount: result.offlineCount,
+                statusCounts: result.statusCounts,
+                maxLocations: result.maxLocations,
+                totalLocations: result.totalLocations,
+                returnedLocations: result.returnedLocations,
+                omittedLocations: result.omittedLocations,
+                locationsTruncated: result.locationsTruncated,
+                totals: result.totals,
+                locations: result.locations,
+                truncated: result.meta.truncated,
+                stale: result.meta.stale,
+                segments: result.meta.segments,
+            };
+            return {
+                content: textContent(JSON.stringify(payload, null, 2)),
+                structuredContent: payload,
+            };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : 'Unknown error';
+            return toolError(message);
+        }
+    });
+    server.registerTool(toolName('vrchat.friend_details'), {
+        description: "Get a friend's profile, status, and location details by display name or userId (read-only).",
+        inputSchema: FriendDetailsInputSchema,
+        outputSchema: FriendDetailsOutputSchema,
+        annotations: readOnlyToolAnnotations,
+    }, async (args) => {
+        try {
+            const name = typeof args?.name === 'string' ? args.name : undefined;
+            const userId = typeof args?.userId === 'string' ? args.userId : undefined;
+            if (!name && !userId) {
+                return toolError('Provide name or userId.');
+            }
+            const result = await getFriendDetails(args ?? {});
+            if (!result.ok) {
+                return toolError(result.reason, {
+                    status: result.status,
+                    message: result.reason,
+                    nextSteps: result.nextSteps,
+                });
+            }
+            const payload = {
+                friend: result.friend,
+                profile: result.profile,
+                location: result.location,
+                instance: result.instance,
+                world: result.world,
+                group: result.group,
+            };
+            return {
+                content: textContent(JSON.stringify(payload, null, 2)),
+                structuredContent: payload,
+            };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : 'Unknown error';
+            return toolError(message);
+        }
+    });
+}
+//# sourceMappingURL=friends.js.map

package/dist/src/tools/curated/friends.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"friends.js","sourceRoot":"","sources":["../../../../src/tools/curated/friends.ts"],"names":[],"mappings":"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"}