@basicbit/vrchat-mcp 0.1.0

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

@@ -0,0 +1,162 @@
+import { getConfig } from '../../config/index.js';
+import { shapeReadData } from '../../core/readTools.js';
+import { WorldFavoritesInputSchema, WorldFavoritesOutputSchema, WorldInstancesInputSchema, WorldInstancesOverviewOutputSchema, WorldProfileInputSchema, WorldProfileOutputSchema, WorldSearchInputSchema, WorldSearchOutputSchema, } from '../../models/worlds.js';
+import { getWorldInstancesOverview, getWorldProfile, listFavoriteWorlds, resolveWorldId, searchWorlds, } from '../../services/worlds/index.js';
+import { getVrcxWorldMemo } from '../../services/vrcx/index.js';
+import { readOnlyToolAnnotations } from '../../utils/toolAnnotations.js';
+import { toolName } from '../../utils/toolNames.js';
+import { textContent, toolError } from '../../utils/toolResponses.js';
+export function registerCuratedWorldTools(server) {
+    server.registerTool(toolName('vrchat.worlds.search'), {
+        description: 'Search worlds by name and return compact results (read-only).',
+        inputSchema: WorldSearchInputSchema,
+        outputSchema: WorldSearchOutputSchema,
+        annotations: readOnlyToolAnnotations,
+    }, async (args) => {
+        try {
+            const query = String(args?.query ?? '').trim();
+            if (!query)
+                return toolError('query is required');
+            const { worlds, page, stale } = await searchWorlds({
+                ...(args ?? {}),
+                query,
+            });
+            const payload = {
+                query,
+                total: worlds.length,
+                stale,
+                page,
+                worlds,
+                notes: args?.includeTags ? ['Tags are included verbatim and may be noisy.'] : undefined,
+            };
+            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.worlds.favorites'), {
+        description: 'List favorited worlds with compact results (read-only).',
+        inputSchema: WorldFavoritesInputSchema,
+        outputSchema: WorldFavoritesOutputSchema,
+        annotations: readOnlyToolAnnotations,
+    }, async (args) => {
+        try {
+            const { worlds, page, stale } = await listFavoriteWorlds({
+                ...(args ?? {}),
+            });
+            const payload = {
+                total: worlds.length,
+                stale,
+                page,
+                worlds,
+                notes: args?.includeTags ? ['Tags are included verbatim and may be noisy.'] : undefined,
+            };
+            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.world.profile'), {
+        description: 'Get a world profile by worldId or name (read-only).',
+        inputSchema: WorldProfileInputSchema,
+        outputSchema: WorldProfileOutputSchema,
+        annotations: readOnlyToolAnnotations,
+    }, async (args) => {
+        try {
+            const resolved = await resolveWorldId({
+                worldId: args?.worldId,
+                name: args?.name,
+            });
+            if (!resolved.ok) {
+                return toolError(resolved.reason, {
+                    status: resolved.status,
+                    message: resolved.reason,
+                    nextSteps: resolved.nextSteps,
+                });
+            }
+            const result = await getWorldProfile(resolved.worldId);
+            const shaped = shapeReadData(result.world, {
+                fields: args?.fields,
+                compact: args?.compact,
+                maxArrayLength: args?.maxArrayLength,
+            });
+            let vrcxMemo;
+            try {
+                const config = getConfig();
+                const memoResult = await getVrcxWorldMemo({
+                    enabled: config.vrcx.enabled,
+                    databasePath: config.vrcx.databasePath,
+                    worldDbPath: config.vrcx.worldDbPath,
+                    worldId: resolved.worldId,
+                });
+                if (memoResult.ok && (memoResult.memo || memoResult.editedAt)) {
+                    vrcxMemo = { editedAt: memoResult.editedAt, memo: memoResult.memo };
+                }
+            }
+            catch {
+                // ignore VRCX errors; world profile should still work
+            }
+            const payload = {
+                worldId: resolved.worldId,
+                resolvedBy: resolved.resolvedBy,
+                stale: result.stale,
+                world: shaped,
+                vrcxMemo,
+            };
+            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.world.instances_overview'), {
+        description: 'Summarize world instances by access type and region (read-only).',
+        inputSchema: WorldInstancesInputSchema,
+        outputSchema: WorldInstancesOverviewOutputSchema,
+        annotations: readOnlyToolAnnotations,
+    }, async (args) => {
+        try {
+            const resolved = await resolveWorldId({
+                worldId: args?.worldId,
+                name: args?.name,
+            });
+            if (!resolved.ok) {
+                return toolError(resolved.reason, {
+                    status: resolved.status,
+                    message: resolved.reason,
+                    nextSteps: resolved.nextSteps,
+                });
+            }
+            const result = await getWorldInstancesOverview(resolved.worldId);
+            const payload = {
+                worldId: resolved.worldId,
+                resolvedBy: resolved.resolvedBy,
+                stale: result.stale,
+                instances: result.summary,
+            };
+            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=worlds.js.map

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

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

package/dist/src/tools/generated.js

@@ -0,0 +1,19 @@
+import { registerGeneratedReadTools } from '../core/readToolRegistry.js';
+import { registerGeneratedWriteTools } from '../core/writeToolRegistry.js';
+import { ReadOptionsSchema, ReadToolOutputSchema } from '../schemas/read.js';
+import { WriteOptionsSchema, WriteToolOutputSchema } from '../schemas/write.js';
+import { readToolResponse } from './read/common.js';
+import { writeToolResponse } from './write/common.js';
+export async function registerGeneratedTools(server) {
+    await registerGeneratedReadTools(server, {
+        readOptionsSchema: ReadOptionsSchema,
+        readOutputSchema: ReadToolOutputSchema,
+        respond: readToolResponse,
+    });
+    await registerGeneratedWriteTools(server, {
+        writeOptionsSchema: WriteOptionsSchema,
+        writeOutputSchema: WriteToolOutputSchema,
+        respond: writeToolResponse,
+    });
+}
+//# sourceMappingURL=generated.js.map

package/dist/src/tools/generated.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generated.js","sourceRoot":"","sources":["../../../src/tools/generated.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,0BAA0B,EAAE,MAAM,6BAA6B,CAAC;AACzE,OAAO,EAAE,2BAA2B,EAAE,MAAM,8BAA8B,CAAC;AAC3E,OAAO,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC7E,OAAO,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAChF,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAEtD,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,MAAiB;IAC5D,MAAM,0BAA0B,CAAC,MAAM,EAAE;QACvC,iBAAiB,EAAE,iBAAiB;QACpC,gBAAgB,EAAE,oBAAoB;QACtC,OAAO,EAAE,gBAAgB;KAC1B,CAAC,CAAC;IACH,MAAM,2BAA2B,CAAC,MAAM,EAAE;QACxC,kBAAkB,EAAE,kBAAkB;QACtC,iBAAiB,EAAE,qBAAqB;QACxC,OAAO,EAAE,iBAAiB;KAC3B,CAAC,CAAC;AACL,CAAC"}

package/dist/src/tools/raw.js

@@ -0,0 +1,49 @@
+import { z } from 'zod';
+import { callOperation, CallError } from '../core/client.js';
+import { CallInputSchema } from '../schemas/call.js';
+import { writeToolAnnotations } from '../utils/toolAnnotations.js';
+import { toolName } from '../utils/toolNames.js';
+import { toolError } from '../utils/toolResponses.js';
+const RAW_BLOCKED_OPERATION_IDS = new Set([
+    'getGroupAnnouncements',
+    'createGroupAnnouncement',
+    'deleteGroupAnnouncement',
+]);
+export function registerRawTools(server) {
+    server.registerTool(toolName('vrchat.call'), {
+        description: 'Call a VRChat OpenAPI operation by operationId.',
+        inputSchema: CallInputSchema,
+        outputSchema: z.object({
+            url: z.string(),
+            status: z.number().optional(),
+            headers: z.record(z.string(), z.string()).optional(),
+            data: z.any().optional(),
+            dryRun: z.boolean().optional(),
+        }),
+        annotations: writeToolAnnotations,
+    }, async (args) => {
+        if (RAW_BLOCKED_OPERATION_IDS.has(args.operationId)) {
+            return toolError(`Operation ${args.operationId} is disabled: group announcement endpoints are deprecated and unsafe.`);
+        }
+        try {
+            const result = await callOperation(args);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify(result, null, 2),
+                    },
+                ],
+                structuredContent: result,
+            };
+        }
+        catch (err) {
+            if (err instanceof CallError && err.payload) {
+                return toolError(err.message, err.payload);
+            }
+            const message = err instanceof Error ? err.message : 'Unknown error';
+            return toolError(message);
+        }
+    });
+}
+//# sourceMappingURL=raw.js.map

package/dist/src/tools/raw.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"raw.js","sourceRoot":"","sources":["../../../src/tools/raw.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,aAAa,EAAE,SAAS,EAAkB,MAAM,mBAAmB,CAAC;AAC7E,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAEtD,MAAM,yBAAyB,GAAG,IAAI,GAAG,CAAC;IACxC,uBAAuB;IACvB,yBAAyB;IACzB,yBAAyB;CAC1B,CAAC,CAAC;AAEH,MAAM,UAAU,gBAAgB,CAAC,MAAiB;IAChD,MAAM,CAAC,YAAY,CACjB,QAAQ,CAAC,aAAa,CAAC,EACvB;QACE,WAAW,EAAE,iDAAiD;QAC9D,WAAW,EAAE,eAAe;QAC5B,YAAY,EAAE,CAAC,CAAC,MAAM,CAAC;YACrB,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;YACf,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAC7B,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;YACpD,IAAI,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;YACxB,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;SAC/B,CAAC;QACF,WAAW,EAAE,oBAAoB;KAClC,EACD,KAAK,EAAE,IAAe,EAAE,EAAE;QACxB,IAAI,yBAAyB,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC;YACpD,OAAO,SAAS,CACd,aAAa,IAAI,CAAC,WAAW,uEAAuE,CACrG,CAAC;QACJ,CAAC;QAED,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,IAAI,CAAC,CAAC;YACzC,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;qBACtC;iBACF;gBACD,iBAAiB,EAAE,MAA4C;aAChE,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,GAAG,YAAY,SAAS,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC;gBAC5C,OAAO,SAAS,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;YAC7C,CAAC;YACD,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC;YACrE,OAAO,SAAS,CAAC,OAAO,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/src/tools/read/common.js

@@ -0,0 +1,58 @@
+import { callReadOperation } from '../../core/readTools.js';
+import { ReadToolOutputSchema } from '../../schemas/read.js';
+import { toolName } from '../../utils/toolNames.js';
+import { readOnlyToolAnnotations } from '../../utils/toolAnnotations.js';
+import { textContent, toolError } from '../../utils/toolResponses.js';
+export function splitReadArgs(args) {
+    const input = (args ?? {});
+    const { fields, compact, maxArrayLength, includeMeta, page, ...params } = input;
+    const options = {
+        fields: fields,
+        compact: compact,
+        maxArrayLength: maxArrayLength,
+        includeMeta: includeMeta,
+        page: page,
+    };
+    return {
+        params: params,
+        options,
+        includeMeta: options.includeMeta,
+    };
+}
+export function splitReadArgsWithNumber(args) {
+    const { number, n, ...rest } = (args ?? {});
+    const { params, options, includeMeta } = splitReadArgs(rest);
+    if (n !== undefined)
+        params.n = n;
+    if (params.n === undefined && number !== undefined)
+        params.n = number;
+    return { params, options, includeMeta };
+}
+export function readToolResponse(result, includeMeta) {
+    const text = JSON.stringify(includeMeta ? result : result.data, null, 2);
+    return {
+        content: textContent(text),
+        structuredContent: result,
+    };
+}
+export function registerReadTool(options) {
+    const { server, name, description, operationId, inputSchema, buildParams } = options;
+    const builder = buildParams ?? splitReadArgs;
+    server.registerTool(toolName(name), {
+        description,
+        inputSchema,
+        outputSchema: ReadToolOutputSchema,
+        annotations: readOnlyToolAnnotations,
+    }, async (args) => {
+        try {
+            const { params, options: readOptions, includeMeta } = builder(args ?? {});
+            const result = await callReadOperation(operationId, params, readOptions);
+            return readToolResponse(result, includeMeta);
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : 'Unknown error';
+            return toolError(message);
+        }
+    });
+}
+//# sourceMappingURL=common.js.map

package/dist/src/tools/read/common.js.map

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

package/dist/src/tools/read/system.js

@@ -0,0 +1,19 @@
+import { ReadOptionsSchema } from '../../schemas/read.js';
+import { registerReadTool } from './common.js';
+export function registerSystemReadTools(server) {
+    registerReadTool({
+        server,
+        name: 'vrchat.config.get',
+        description: 'Fetch API config (read-only).',
+        operationId: 'getConfig',
+        inputSchema: ReadOptionsSchema,
+    });
+    registerReadTool({
+        server,
+        name: 'vrchat.system.time',
+        description: 'Get current system time (read-only).',
+        operationId: 'getSystemTime',
+        inputSchema: ReadOptionsSchema,
+    });
+}
+//# sourceMappingURL=system.js.map

package/dist/src/tools/read/system.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"system.js","sourceRoot":"","sources":["../../../../src/tools/read/system.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE/C,MAAM,UAAU,uBAAuB,CAAC,MAAiB;IACvD,gBAAgB,CAAC;QACf,MAAM;QACN,IAAI,EAAE,mBAAmB;QACzB,WAAW,EAAE,+BAA+B;QAC5C,WAAW,EAAE,WAAW;QACxB,WAAW,EAAE,iBAAiB;KAC/B,CAAC,CAAC;IAEH,gBAAgB,CAAC;QACf,MAAM;QACN,IAAI,EAAE,oBAAoB;QAC1B,WAAW,EAAE,sCAAsC;QACnD,WAAW,EAAE,eAAe;QAC5B,WAAW,EAAE,iBAAiB;KAC/B,CAAC,CAAC;AACL,CAAC"}

package/dist/src/tools/registerAllTools.js

@@ -0,0 +1,41 @@
+import { registerAuthTools } from './auth.js';
+import { registerCacheTools } from './cache.js';
+import { registerCuratedAvatarTools } from './curated/avatars.js';
+import { registerCuratedEventTools } from './curated/events.js';
+import { registerCuratedFriendTools } from './curated/friends.js';
+import { registerCuratedGroupTools } from './curated/groups.js';
+import { registerCuratedInstanceTools } from './curated/instances.js';
+import { registerCuratedInviteTools } from './curated/invites.js';
+import { registerCuratedNotificationTools } from './curated/notifications.js';
+import { registerCuratedStatusPageTools } from './curated/statusPage.js';
+import { registerCuratedStatusTools } from './curated/status.js';
+import { registerCuratedUserTools } from './curated/users.js';
+import { registerCuratedVrcxTools } from './curated/vrcx/index.js';
+import { registerCuratedWorldTools } from './curated/worlds.js';
+import { registerGeneratedTools } from './generated.js';
+import { registerSystemReadTools } from './read/system.js';
+import { registerRawTools } from './raw.js';
+import { getConfig } from '../config/index.js';
+export async function registerAllTools(server) {
+    const config = getConfig();
+    if (config.rawTools.enabled) {
+        registerRawTools(server);
+    }
+    registerCuratedFriendTools(server);
+    registerCuratedAvatarTools(server);
+    registerCuratedEventTools(server);
+    registerCuratedGroupTools(server);
+    registerCuratedInstanceTools(server);
+    registerCuratedInviteTools(server);
+    registerCuratedStatusTools(server);
+    registerCuratedStatusPageTools(server);
+    registerCuratedUserTools(server);
+    registerCuratedNotificationTools(server);
+    registerCuratedWorldTools(server);
+    registerCuratedVrcxTools(server);
+    registerCacheTools(server);
+    registerSystemReadTools(server);
+    registerAuthTools(server);
+    await registerGeneratedTools(server);
+}
+//# sourceMappingURL=registerAllTools.js.map

package/dist/src/tools/registerAllTools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registerAllTools.js","sourceRoot":"","sources":["../../../src/tools/registerAllTools.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,0BAA0B,EAAE,MAAM,sBAAsB,CAAC;AAClE,OAAO,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,EAAE,0BAA0B,EAAE,MAAM,sBAAsB,CAAC;AAClE,OAAO,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,EAAE,4BAA4B,EAAE,MAAM,wBAAwB,CAAC;AACtE,OAAO,EAAE,0BAA0B,EAAE,MAAM,sBAAsB,CAAC;AAClE,OAAO,EAAE,gCAAgC,EAAE,MAAM,4BAA4B,CAAC;AAC9E,OAAO,EAAE,8BAA8B,EAAE,MAAM,yBAAyB,CAAC;AACzE,OAAO,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAC;AACjE,OAAO,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAE/C,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,MAAiB;IACtD,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,IAAI,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;QAC5B,gBAAgB,CAAC,MAAM,CAAC,CAAC;IAC3B,CAAC;IACD,0BAA0B,CAAC,MAAM,CAAC,CAAC;IACnC,0BAA0B,CAAC,MAAM,CAAC,CAAC;IACnC,yBAAyB,CAAC,MAAM,CAAC,CAAC;IAClC,yBAAyB,CAAC,MAAM,CAAC,CAAC;IAClC,4BAA4B,CAAC,MAAM,CAAC,CAAC;IACrC,0BAA0B,CAAC,MAAM,CAAC,CAAC;IACnC,0BAA0B,CAAC,MAAM,CAAC,CAAC;IACnC,8BAA8B,CAAC,MAAM,CAAC,CAAC;IACvC,wBAAwB,CAAC,MAAM,CAAC,CAAC;IACjC,gCAAgC,CAAC,MAAM,CAAC,CAAC;IACzC,yBAAyB,CAAC,MAAM,CAAC,CAAC;IAClC,wBAAwB,CAAC,MAAM,CAAC,CAAC;IACjC,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAE3B,uBAAuB,CAAC,MAAM,CAAC,CAAC;IAEhC,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAE1B,MAAM,sBAAsB,CAAC,MAAM,CAAC,CAAC;AACvC,CAAC"}

package/dist/src/tools/write/common.js

@@ -0,0 +1,10 @@
+import { textContent } from '../../utils/toolResponses.js';
+export function writeToolResponse(result, includeMeta) {
+    const payload = includeMeta ? result : { data: result.data };
+    const text = JSON.stringify(payload, null, 2);
+    return {
+        content: textContent(text),
+        structuredContent: result,
+    };
+}
+//# sourceMappingURL=common.js.map

package/dist/src/tools/write/common.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.js","sourceRoot":"","sources":["../../../../src/tools/write/common.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAE3D,MAAM,UAAU,iBAAiB,CAC/B,MAA6G,EAC7G,WAAqB;IAErB,MAAM,OAAO,GAAG,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;IAC7D,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAC9C,OAAO;QACL,OAAO,EAAE,WAAW,CAAC,IAAI,CAAC;QAC1B,iBAAiB,EAAE,MAA4C;KAChE,CAAC;AACJ,CAAC"}

package/dist/src/utils/json.js

@@ -0,0 +1,53 @@
+import { z } from 'zod';
+export const JsonValueSchema = z.lazy(() => z.union([
+    z.string(),
+    z.number(),
+    z.boolean(),
+    z.null(),
+    z.array(JsonValueSchema),
+    z.record(z.string(), JsonValueSchema),
+]));
+function isPlainObject(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value))
+        return false;
+    return (Object.getPrototypeOf(value) === Object.prototype ||
+        Object.getPrototypeOf(value) === null);
+}
+export function isJsonValue(value) {
+    if (value === null)
+        return true;
+    const valueType = typeof value;
+    if (valueType === 'string' || valueType === 'number' || valueType === 'boolean') {
+        return Number.isFinite(value) || valueType !== 'number';
+    }
+    if (Array.isArray(value)) {
+        return value.every(isJsonValue);
+    }
+    if (isPlainObject(value)) {
+        return Object.values(value).every(isJsonValue);
+    }
+    return false;
+}
+export function isJsonObject(value) {
+    if (!isPlainObject(value))
+        return false;
+    return Object.values(value).every(isJsonValue);
+}
+export function parseJsonText(value) {
+    try {
+        const parsed = JSON.parse(value);
+        return isJsonValue(parsed) ? parsed : null;
+    }
+    catch {
+        return null;
+    }
+}
+export function toJsonValue(value, label) {
+    if (value === undefined || value === null)
+        return value;
+    if (isJsonValue(value))
+        return value;
+    const prefix = label ? `${label}: ` : '';
+    throw new Error(`${prefix}Expected JSON value.`);
+}
+//# sourceMappingURL=json.js.map

package/dist/src/utils/json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.js","sourceRoot":"","sources":["../../../src/utils/json.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAQxB,MAAM,CAAC,MAAM,eAAe,GAAyB,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAC/D,CAAC,CAAC,KAAK,CAAC;IACN,CAAC,CAAC,MAAM,EAAE;IACV,CAAC,CAAC,MAAM,EAAE;IACV,CAAC,CAAC,OAAO,EAAE;IACX,CAAC,CAAC,IAAI,EAAE;IACR,CAAC,CAAC,KAAK,CAAC,eAAe,CAAC;IACxB,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,eAAe,CAAC;CACtC,CAAC,CACH,CAAC;AAEF,SAAS,aAAa,CAAC,KAAc;IACnC,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAC9E,OAAO,CACL,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,KAAK,MAAM,CAAC,SAAS;QACjD,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,KAAK,IAAI,CACtC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAChC,MAAM,SAAS,GAAG,OAAO,KAAK,CAAC;IAC/B,IAAI,SAAS,KAAK,QAAQ,IAAI,SAAS,KAAK,QAAQ,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;QAChF,OAAO,MAAM,CAAC,QAAQ,CAAC,KAAe,CAAC,IAAI,SAAS,KAAK,QAAQ,CAAC;IACpE,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;IAClC,CAAC;IACD,IAAI,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;IACjD,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAAc;IACzC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACxC,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,IAAI,CAAC;QACH,MAAM,MAAM,GAAY,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC1C,OAAO,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;IAC7C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,WAAW,CACzB,KAAc,EACd,KAAc;IAEd,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IACxD,IAAI,WAAW,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACrC,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IACzC,MAAM,IAAI,KAAK,CAAC,GAAG,MAAM,sBAAsB,CAAC,CAAC;AACnD,CAAC"}

package/dist/src/utils/schema.js

@@ -0,0 +1,14 @@
+export function parseWithSchema(schema, value, label) {
+    try {
+        return schema.parse(value);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Unknown schema parse error.';
+        const prefix = label ? `${label}: ` : '';
+        throw new Error(`${prefix}${message}`);
+    }
+}
+export function parseArrayWithSchema(schema, value, label) {
+    return parseWithSchema(schema.array(), value ?? [], label);
+}
+//# sourceMappingURL=schema.js.map

package/dist/src/utils/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../src/utils/schema.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,eAAe,CAC7B,MAAoB,EACpB,KAAc,EACd,KAAc;IAEd,IAAI,CAAC;QACH,OAAO,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC7B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,GACX,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,6BAA6B,CAAC;QACzE,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QACzC,MAAM,IAAI,KAAK,CAAC,GAAG,MAAM,GAAG,OAAO,EAAE,CAAC,CAAC;IACzC,CAAC;AACH,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,MAAoB,EACpB,KAAc,EACd,KAAc;IAEd,OAAO,eAAe,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,KAAK,IAAI,EAAE,EAAE,KAAK,CAAC,CAAC;AAC7D,CAAC"}

package/dist/src/utils/stableStringify.js

@@ -0,0 +1,36 @@
+function normalize(value) {
+    if (value === null)
+        return null;
+    if (typeof value === 'string' ||
+        typeof value === 'number' ||
+        typeof value === 'boolean') {
+        return value;
+    }
+    if (typeof value === 'bigint') {
+        return value.toString();
+    }
+    if (Array.isArray(value)) {
+        return value.map((entry) => normalize(entry));
+    }
+    if (typeof value === 'object') {
+        const record = value;
+        const keys = Object.keys(record).sort();
+        const out = {};
+        for (const key of keys) {
+            const normalized = normalize(record[key]);
+            out[key] = normalized;
+        }
+        return out;
+    }
+    if (typeof value === 'symbol')
+        return value.toString();
+    if (typeof value === 'function')
+        return value.name ? `[function ${value.name}]` : '[function]';
+    if (typeof value === 'undefined')
+        return '';
+    return '';
+}
+export function stableStringify(value) {
+    return JSON.stringify(normalize(value));
+}
+//# sourceMappingURL=stableStringify.js.map

package/dist/src/utils/stableStringify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stableStringify.js","sourceRoot":"","sources":["../../../src/utils/stableStringify.ts"],"names":[],"mappings":"AAEA,SAAS,SAAS,CAAC,KAAc;IAC/B,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAChC,IACE,OAAO,KAAK,KAAK,QAAQ;QACzB,OAAO,KAAK,KAAK,QAAQ;QACzB,OAAO,KAAK,KAAK,SAAS,EAC1B,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC,QAAQ,EAAE,CAAC;IAC1B,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;IAChD,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,MAAM,GAAG,KAAgC,CAAC;QAChD,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;QACxC,MAAM,GAAG,GAA8B,EAAE,CAAC;QAC1C,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,MAAM,UAAU,GAAG,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;YAC1C,GAAG,CAAC,GAAG,CAAC,GAAG,UAAU,CAAC;QACxB,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC,QAAQ,EAAE,CAAC;IACvD,IAAI,OAAO,KAAK,KAAK,UAAU;QAAE,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,aAAa,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,YAAY,CAAC;IAC/F,IAAI,OAAO,KAAK,KAAK,WAAW;QAAE,OAAO,EAAE,CAAC;IAC5C,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,OAAO,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;AAC1C,CAAC"}

package/dist/src/utils/strings.js

@@ -0,0 +1,7 @@
+export function nonEmptyString(value) {
+    if (typeof value !== 'string')
+        return undefined;
+    const trimmed = value.trim();
+    return trimmed ? trimmed : undefined;
+}
+//# sourceMappingURL=strings.js.map

package/dist/src/utils/strings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"strings.js","sourceRoot":"","sources":["../../../src/utils/strings.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IAChD,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,OAAO,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;AACvC,CAAC"}

package/dist/src/utils/toolAnnotations.js

@@ -0,0 +1,17 @@
+export const readOnlyToolAnnotations = {
+    readOnlyHint: true,
+};
+export const writeToolAnnotations = {
+    readOnlyHint: false,
+};
+export const destructiveToolAnnotations = {
+    readOnlyHint: false,
+    destructiveHint: true,
+};
+export function annotationsForWriteMethod(method) {
+    const normalized = method.toLowerCase();
+    if (normalized === 'delete')
+        return destructiveToolAnnotations;
+    return writeToolAnnotations;
+}
+//# sourceMappingURL=toolAnnotations.js.map

package/dist/src/utils/toolAnnotations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolAnnotations.js","sourceRoot":"","sources":["../../../src/utils/toolAnnotations.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,uBAAuB,GAAoB;IACtD,YAAY,EAAE,IAAI;CACnB,CAAC;AAEF,MAAM,CAAC,MAAM,oBAAoB,GAAoB;IACnD,YAAY,EAAE,KAAK;CACpB,CAAC;AAEF,MAAM,CAAC,MAAM,0BAA0B,GAAoB;IACzD,YAAY,EAAE,KAAK;IACnB,eAAe,EAAE,IAAI;CACtB,CAAC;AAEF,MAAM,UAAU,yBAAyB,CAAC,MAAc;IACtD,MAAM,UAAU,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;IACxC,IAAI,UAAU,KAAK,QAAQ;QAAE,OAAO,0BAA0B,CAAC;IAC/D,OAAO,oBAAoB,CAAC;AAC9B,CAAC"}

package/dist/src/utils/toolNames.js

@@ -0,0 +1,13 @@
+function sanitize(name) {
+    return name.replace(/[^a-zA-Z0-9_-]/g, '_');
+}
+export function toolName(name) {
+    return sanitize(name.replace(/\./g, '_'));
+}
+export function readToolName(operationId) {
+    return sanitize(`vrchat_read_${operationId}`);
+}
+export function writeToolName(operationId) {
+    return sanitize(`vrchat_write_${operationId}`);
+}
+//# sourceMappingURL=toolNames.js.map

package/dist/src/utils/toolNames.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolNames.js","sourceRoot":"","sources":["../../../src/utils/toolNames.ts"],"names":[],"mappings":"AAAA,SAAS,QAAQ,CAAC,IAAY;IAC5B,OAAO,IAAI,CAAC,OAAO,CAAC,iBAAiB,EAAE,GAAG,CAAC,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,IAAY;IACnC,OAAO,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,WAAmB;IAC9C,OAAO,QAAQ,CAAC,eAAe,WAAW,EAAE,CAAC,CAAC;AAChD,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,WAAmB;IAC/C,OAAO,QAAQ,CAAC,gBAAgB,WAAW,EAAE,CAAC,CAAC;AACjD,CAAC"}

package/dist/src/utils/toolResponses.js

@@ -0,0 +1,12 @@
+export function textContent(text) {
+    return [{ type: 'text', text }];
+}
+export function toolError(message, payload) {
+    const body = payload ?? { error: message };
+    const text = payload ? JSON.stringify(body, null, 2) : message;
+    return {
+        isError: true,
+        content: textContent(text),
+    };
+}
+//# sourceMappingURL=toolResponses.js.map

package/dist/src/utils/toolResponses.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolResponses.js","sourceRoot":"","sources":["../../../src/utils/toolResponses.ts"],"names":[],"mappings":"AAKA,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,OAAe,EAAE,OAAiC;IAC1E,MAAM,IAAI,GAAG,OAAO,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;IAC3C,MAAM,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;IAC/D,OAAO;QACL,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,WAAW,CAAC,IAAI,CAAC;KAC3B,CAAC;AACJ,CAAC"}

package/docs/architecture.md

@@ -0,0 +1,46 @@
+# Architecture Overview
+
+This server is organized by responsibility so each file stays small and focused.
+
+## Entry point
+
+- `src/index.ts` boots the MCP server, initializes auth, registers tools/resources, wires pipeline handlers, and connects the stdio transport.
+
+## Core API plumbing (`src/core/`)
+
+- `spec.ts` loads and caches the VRChat OpenAPI spec.
+- `client.ts` executes API operations with auth + headers and enforces write gating.
+- `readTools.ts` provides read-only helpers (pagination, field selection, shaping).
+- `readToolRegistry.ts` registers auto-generated GET tools from the spec.
+- `writeToolRegistry.ts` registers auto-generated non-GET tools from the spec.
+
+## Tool registration (`src/tools/`)
+
+- `registerAllTools.ts` is the single place that wires up all tools.
+- `raw.ts` exposes `vrchat_call` for direct operationId invocation (disabled by default; enable via `rawTools.enabled`).
+- `auth.ts` exposes login/status/logout.
+- `cache.ts` exposes cache invalidation.
+- `curated/` contains task-focused tools.
+- `read/` contains system read utilities (config/time).
+
+## Schemas (`src/schemas/`)
+
+- Shared Zod schemas for tool inputs/outputs.
+
+## Services (`src/services/`)
+
+- Small, testable domain services like caching, friend lookup, and pipeline events.
+
+## Resources (`src/resources/`)
+
+- MCP resources backed by pipeline/cache (e.g., friend change delta feed).
+
+## Infra + utils
+
+- `src/infra/` for logging.
+- `src/utils/` for small helpers such as tool name mapping.
+
+## Tests
+
+- `test/` focuses on deterministic behavior (spec parsing, tool naming, read helpers, cache).
+- Coverage is reported via `npm run test:coverage`.