@basicbit/vrchat-mcp 0.1.4 → 0.1.6

package/dist/src/core/generatedOperations.js

@@ -0,0 +1,133 @@
+import { getConfig } from '../config/index.js';
+import { toolName } from '../utils/toolNames.js';
+import { getCuratedReadToolName, getCuratedWriteToolName } from './generatedToolOverrides.js';
+import { GENERATED_READ_SKIP_IDS, GENERATED_WRITE_SKIP_IDS } from './generatedToolSkips.js';
+import { getBlockedOperationReason } from './operationPolicy.js';
+import { getSpecIndex } from './spec.js';
+export const generatedToolStatusValues = [
+    'available',
+    'blocked_by_policy',
+    'curated_replacement',
+    'hard_skipped',
+    'disabled_by_config',
+    'not_allowlisted',
+];
+const DEFAULT_LIMIT = 250;
+function isRecord(value) {
+    return Boolean(value && typeof value === 'object' && !Array.isArray(value));
+}
+function getText(value) {
+    return typeof value === 'string' && value.trim() ? value : undefined;
+}
+export function generatedOperationKind(op) {
+    if (op.method === 'GET')
+        return 'read';
+    if (op.method === 'DELETE')
+        return 'delete';
+    return 'write';
+}
+export function generatedToolName(kind) {
+    if (kind === 'read')
+        return toolName('vrchat.read');
+    if (kind === 'delete')
+        return toolName('vrchat.delete');
+    return toolName('vrchat.write');
+}
+function rawOperation(raw, op) {
+    if (!isRecord(raw))
+        return undefined;
+    const paths = raw.paths;
+    if (!isRecord(paths))
+        return undefined;
+    const pathItem = paths[op.path];
+    if (!isRecord(pathItem))
+        return undefined;
+    const methodEntry = pathItem[op.method.toLowerCase()];
+    return isRecord(methodEntry) ? methodEntry : undefined;
+}
+export function getGeneratedOperationInfo(op) {
+    const kind = generatedOperationKind(op);
+    const blockedReason = getBlockedOperationReason(op.operationId);
+    const curatedToolName = kind === 'read'
+        ? getCuratedReadToolName(op.operationId)
+        : getCuratedWriteToolName(op.operationId);
+    const skipIds = kind === 'read' ? GENERATED_READ_SKIP_IDS : GENERATED_WRITE_SKIP_IDS;
+    const generatedConfig = kind === 'read' ? getConfig().generatedReadTools : getConfig().generatedWriteTools;
+    const allowedIds = new Set(generatedConfig.operationIds);
+    if (blockedReason) {
+        return { generatedToolStatus: 'blocked_by_policy', curatedToolName, blockedReason };
+    }
+    if (curatedToolName) {
+        return { generatedToolStatus: 'curated_replacement', curatedToolName };
+    }
+    if (skipIds.includes(op.operationId)) {
+        return { generatedToolStatus: 'hard_skipped' };
+    }
+    if (!generatedConfig.enabled) {
+        return { generatedToolStatus: 'disabled_by_config' };
+    }
+    if (allowedIds.size > 0 && !allowedIds.has(op.operationId)) {
+        return { generatedToolStatus: 'not_allowlisted' };
+    }
+    return {
+        generatedToolStatus: 'available',
+        generatedToolName: generatedToolName(kind),
+    };
+}
+async function collectGeneratedOperations() {
+    const index = await getSpecIndex();
+    const operations = [];
+    for (const op of index.operations.values()) {
+        const rawOp = rawOperation(index.raw, op);
+        const info = getGeneratedOperationInfo(op);
+        operations.push({
+            operationId: op.operationId,
+            kind: generatedOperationKind(op),
+            method: op.method,
+            path: op.path,
+            summary: getText(rawOp?.summary),
+            description: getText(rawOp?.description),
+            ...info,
+        });
+    }
+    return operations.sort((a, b) => a.operationId.localeCompare(b.operationId));
+}
+function matchesQuery(operation, query) {
+    if (!query)
+        return true;
+    const needle = query.toLowerCase();
+    const haystack = [
+        operation.operationId,
+        operation.method,
+        operation.path,
+        operation.summary,
+        operation.description,
+    ]
+        .filter(Boolean)
+        .join('\n')
+        .toLowerCase();
+    return haystack.includes(needle);
+}
+export async function listGeneratedOperations(input = {}) {
+    const view = input.view ?? 'available';
+    const limit = Math.max(1, Math.floor(input.limit ?? DEFAULT_LIMIT));
+    const filtered = (await collectGeneratedOperations()).filter((operation) => {
+        if (input.kind && operation.kind !== input.kind)
+            return false;
+        if (view === 'available' && operation.generatedToolStatus !== 'available')
+            return false;
+        return matchesQuery(operation, input.query?.trim());
+    });
+    return {
+        operations: filtered.slice(0, limit),
+        total: filtered.length,
+        truncated: filtered.length > limit,
+    };
+}
+export async function getAvailableGeneratedOperationIds(kind) {
+    const operations = await collectGeneratedOperations();
+    return new Set(operations
+        .filter((operation) => operation.kind === kind && operation.generatedToolStatus === 'available')
+        .map((operation) => operation.operationId));
+}
+//# sourceMappingURL=generatedOperations.js.map

package/dist/src/core/generatedOperations.js.map

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

package/dist/src/core/generatedToolDescriptions.js

@@ -0,0 +1,26 @@
+const MAX_SUMMARY_LENGTH = 96;
+function firstTextLine(value) {
+    return typeof value === 'string' ? value.split('\n')[0].replace(/\s+/g, ' ').trim() : '';
+}
+function trimSentence(value) {
+    return value.replace(/[.?!:;]+$/g, '').trim();
+}
+function truncate(value) {
+    if (value.length <= MAX_SUMMARY_LENGTH)
+        return value;
+    const truncated = value.slice(0, MAX_SUMMARY_LENGTH - 1).trimEnd();
+    const lastSpace = truncated.lastIndexOf(' ');
+    const base = lastSpace >= 40 ? truncated.slice(0, lastSpace) : truncated;
+    return `${trimSentence(base)}...`;
+}
+function sentence(value) {
+    return value.endsWith('...') ? value : `${value}.`;
+}
+export function buildGeneratedToolDescription(kind, operationId, op) {
+    const prefix = kind === 'read' ? 'Read VRChat API' : 'Write VRChat API';
+    const summary = trimSentence(firstTextLine(op.summary) || firstTextLine(op.description));
+    if (summary)
+        return `${prefix}: ${sentence(truncate(summary))}`;
+    return `${prefix} operation: ${operationId}.`;
+}
+//# sourceMappingURL=generatedToolDescriptions.js.map

package/dist/src/core/generatedToolDescriptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generatedToolDescriptions.js","sourceRoot":"","sources":["../../../src/core/generatedToolDescriptions.ts"],"names":[],"mappings":"AAKA,MAAM,kBAAkB,GAAG,EAAE,CAAC;AAE9B,SAAS,aAAa,CAAC,KAAc;IACnC,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;AAC3F,CAAC;AAED,SAAS,YAAY,CAAC,KAAa;IACjC,OAAO,KAAK,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;AAChD,CAAC;AAED,SAAS,QAAQ,CAAC,KAAa;IAC7B,IAAI,KAAK,CAAC,MAAM,IAAI,kBAAkB;QAAE,OAAO,KAAK,CAAC;IACrD,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,kBAAkB,GAAG,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;IACnE,MAAM,SAAS,GAAG,SAAS,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IAC7C,MAAM,IAAI,GAAG,SAAS,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACzE,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC;AACpC,CAAC;AAED,SAAS,QAAQ,CAAC,KAAa;IAC7B,OAAO,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,GAAG,CAAC;AACrD,CAAC;AAED,MAAM,UAAU,6BAA6B,CAC3C,IAAsB,EACtB,WAAmB,EACnB,EAA8B;IAE9B,MAAM,MAAM,GAAG,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,kBAAkB,CAAC;IACxE,MAAM,OAAO,GAAG,YAAY,CAAC,aAAa,CAAC,EAAE,CAAC,OAAO,CAAC,IAAI,aAAa,CAAC,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC;IAEzF,IAAI,OAAO;QAAE,OAAO,GAAG,MAAM,KAAK,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC;IAChE,OAAO,GAAG,MAAM,eAAe,WAAW,GAAG,CAAC;AAChD,CAAC"}

package/dist/src/core/generatedToolOverrides.js

@@ -11,9 +11,16 @@ const CURATED_READ_TOOL_MAP = new Map([
     ['getWorld', toToolName('vrchat.world.profile')],
     ['searchWorlds', toToolName('vrchat.worlds.search')],
     ['getFavoritedWorlds', toToolName('vrchat.worlds.favorites')],
+    ['getFavoritedAvatars', toToolName('vrchat.favorites')],
+    ['getFavoriteGroup', toToolName('vrchat.favorites')],
+    ['getFavoriteGroups', toToolName('vrchat.favorites')],
+    ['getFavoriteLimits', toToolName('vrchat.favorites')],
+    ['getFavorites', toToolName('vrchat.favorites')],
     ['getGroup', toToolName('vrchat.group.profile')],
     ['searchGroups', toToolName('vrchat.groups.search')],
     ['getGroupMembers', toToolName('vrchat.group.members')],
+    ['getGroupRoles', toToolName('vrchat.group.roles')],
+    ['getGroupRoleTemplates', toToolName('vrchat.group.roles')],
     ['getGroupPosts', toToolName('vrchat.group.posts_recent')],
     ['getGroupInstances', toToolName('vrchat.group.instances.overview')],
     ['getGroupCalendarEvents', toToolName('vrchat.group.events.list')],
@@ -23,71 +30,28 @@ const CURATED_READ_TOOL_MAP = new Map([
     ['getCalendarEvents', toToolName('vrchat.events.upcoming')],
     ['discoverCalendarEvents', toToolName('vrchat.events.discover')],
     ['searchCalendarEvents', toToolName('vrchat.events.search')],
+    ['getAvatar', toToolName('vrchat.avatar.profile')],
 ]);
 const CURATED_WRITE_TOOL_MAP = new Map([
+    ['boop', toToolName('vrchat.boop')],
+    ['createGroupInvite', toToolName('vrchat.group.invite')],
     ['createInstance', toToolName('vrchat.instance.create')],
+    ['friend', toToolName('vrchat.friend.request')],
     ['inviteMyselfTo', toToolName('vrchat.invite.self')],
     ['inviteUser', toToolName('vrchat.invite.user')],
     ['createGroupCalendarEvent', toToolName('vrchat.event.create')],
     ['updateGroupCalendarEvent', toToolName('vrchat.event.update')],
     ['deleteGroupCalendarEvent', toToolName('vrchat.event.delete')],
     ['followGroupCalendarEvent', toToolName('vrchat.event.follow')],
+    ['addFavorite', toToolName('vrchat.favorite.add')],
+    ['removeFavorite', toToolName('vrchat.favorite.remove')],
+    ['addGroupMemberRole', toToolName('vrchat.group.roles.manage')],
+    ['removeGroupMemberRole', toToolName('vrchat.group.roles.manage')],
+    ['createGroupRole', toToolName('vrchat.group.roles.manage')],
+    ['updateGroupRole', toToolName('vrchat.group.roles.manage')],
+    ['deleteGroupRole', toToolName('vrchat.group.roles.manage')],
     ['updateUser', toToolName('vrchat.profile.update')],
-]);
-const GENERATED_READ_TOOL_DESCRIPTIONS = new Map([
-    ['getConfig', 'Get VRChat API config (includes the current client API key).'],
-    ['getSystemTime', 'Get VRChat server time.'],
-    ['getCurrentUser', 'Fetch the current user (raw API; large payload). Prefer vrchat_me.'],
-    ['getFriends', 'List friends (raw API; prefers pagination).'],
-    ['getUser', 'Fetch a user by userId (raw API). Prefer vrchat_user_profile.'],
-    ['getUserByName', 'Fetch a user by name (raw API). Prefer vrchat_user_profile.'],
-    ['getUserGroups', 'List groups for a user (raw API). Prefer vrchat_user_groups.'],
-    ['getWorld', 'Fetch a world by worldId (raw API). Prefer vrchat_world_profile.'],
-    ['searchWorlds', 'Search worlds (raw API). Prefer vrchat_worlds_search.'],
-    ['getFavoritedWorlds', 'List favorited worlds (raw API). Prefer vrchat_worlds_favorites.'],
-    ['getGroup', 'Fetch a group profile (raw API). Prefer vrchat_group_profile.'],
-    ['searchGroups', 'Search groups (raw API). Prefer vrchat_groups_search.'],
-    ['getGroupMembers', 'List group members (raw API). Prefer vrchat_group_members.'],
-    ['getGroupPosts', 'List group posts (raw API). Prefer vrchat_group_posts_recent.'],
-    ['getGroupInstances', 'List group instances (raw API). Prefer vrchat_group_instances_overview.'],
-    [
-        'getGroupCalendarEvents',
-        'List group calendar events (raw API). Prefer vrchat_group_events_list.',
-    ],
-    ['getGroupCalendarEvent', 'Get a group calendar event (raw API). Prefer vrchat_group_event_get.'],
-    ['getGroupNextCalendarEvent', 'Get the next group calendar event (raw API). Prefer vrchat_group_event_next.'],
-    ['getNotifications', 'List recent notifications (raw API). Prefer vrchat_notifications_recent.'],
-    ['getCalendarEvents', 'List upcoming calendar events (raw API). Prefer vrchat_events_upcoming.'],
-    ['discoverCalendarEvents', 'Discover calendar events (raw API). Prefer vrchat_events_discover.'],
-    ['searchCalendarEvents', 'Search calendar events (raw API). Prefer vrchat_events_search.'],
-]);
-const GENERATED_WRITE_TOOL_DESCRIPTIONS = new Map([
-    ['createInstance', 'Create a VRChat instance (raw API). Prefer vrchat_instance_create.'],
-    [
-        'inviteUser',
-        'Invite a user to an instance (raw API). Prefer vrchat_invite_user or vrchat_invite_user_to_me when inviting to your current instance.',
-    ],
-    ['inviteMyselfTo', 'Invite yourself to an instance (raw API). Prefer vrchat_invite_self.'],
-    [
-        'createGroupCalendarEvent',
-        'Create a group calendar event (raw API). Prefer vrchat_event_create.',
-    ],
-    [
-        'updateGroupCalendarEvent',
-        'Update a group calendar event (raw API). Prefer vrchat_event_update.',
-    ],
-    [
-        'deleteGroupCalendarEvent',
-        'Delete a group calendar event (raw API). Prefer vrchat_event_delete.',
-    ],
-    [
-        'followGroupCalendarEvent',
-        'Follow or unfollow a group calendar event (raw API). Prefer vrchat_event_follow.',
-    ],
-    [
-        'updateUser',
-        'Update the current user profile (raw API). Prefer vrchat_profile_update (or vrchat_status_set for status-only changes).',
-    ],
+    ['logout', toToolName('vrchat.auth.logout')],
 ]);
 export function getCuratedReadToolName(operationId) {
     return CURATED_READ_TOOL_MAP.get(operationId);
@@ -95,10 +59,4 @@ export function getCuratedReadToolName(operationId) {
 export function getCuratedWriteToolName(operationId) {
     return CURATED_WRITE_TOOL_MAP.get(operationId);
 }
-export function getGeneratedReadToolDescription(operationId) {
-    return GENERATED_READ_TOOL_DESCRIPTIONS.get(operationId);
-}
-export function getGeneratedWriteToolDescription(operationId) {
-    return GENERATED_WRITE_TOOL_DESCRIPTIONS.get(operationId);
-}
 //# sourceMappingURL=generatedToolOverrides.js.map

package/dist/src/core/generatedToolOverrides.js.map

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

package/dist/src/core/generatedToolSkips.js

@@ -1,28 +1,11 @@
-export const GENERATED_READ_SKIP_IDS = [
-    'getConfig',
-    'getSystemTime',
-    'getFriends',
-    'getUser',
-    'getUserByName',
-    'getGroup',
-    'getGroupAnnouncements',
-    'getGroupCalendarEvents',
-    'getGroupNextCalendarEvent',
-    'getGroupCalendarEvent',
-    'discoverCalendarEvents',
-    'searchCalendarEvents',
-    'getWorld',
-];
+import { CONTENT_MANAGEMENT_OPERATION_IDS } from './operationPolicy.js';
+// Extra hard skips for generated tools. Curated replacements are filtered in generatedToolOverrides.
+export const GENERATED_READ_SKIP_IDS = ['getGroupAnnouncements'];
 export const GENERATED_WRITE_SKIP_IDS = [
-    'createInstance',
-    'inviteMyselfTo',
-    'inviteUser',
     'createGroupAnnouncement',
     'deleteGroupAnnouncement',
-    'createGroupCalendarEvent',
-    'updateGroupCalendarEvent',
-    'deleteGroupCalendarEvent',
-    'followGroupCalendarEvent',
-    'updateUser',
+    'inviteUserWithPhoto',
+    'requestInviteWithPhoto',
+    ...CONTENT_MANAGEMENT_OPERATION_IDS,
 ];
 //# sourceMappingURL=generatedToolSkips.js.map

package/dist/src/core/generatedToolSkips.js.map

@@ -1 +1 @@
-{"version":3,"file":"generatedToolSkips.js","sourceRoot":"","sources":["../../../src/core/generatedToolSkips.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,WAAW;IACX,eAAe;IACf,YAAY;IACZ,SAAS;IACT,eAAe;IACf,UAAU;IACV,uBAAuB;IACvB,wBAAwB;IACxB,2BAA2B;IAC3B,uBAAuB;IACvB,wBAAwB;IACxB,sBAAsB;IACtB,UAAU;CACX,CAAC;AAEF,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,gBAAgB;IAChB,gBAAgB;IAChB,YAAY;IACZ,yBAAyB;IACzB,yBAAyB;IACzB,0BAA0B;IAC1B,0BAA0B;IAC1B,0BAA0B;IAC1B,0BAA0B;IAC1B,YAAY;CACb,CAAC"}
+{"version":3,"file":"generatedToolSkips.js","sourceRoot":"","sources":["../../../src/core/generatedToolSkips.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gCAAgC,EAAE,MAAM,sBAAsB,CAAC;AAExE,qGAAqG;AACrG,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,uBAAuB,CAAC,CAAC;AAEjE,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,yBAAyB;IACzB,yBAAyB;IACzB,qBAAqB;IACrB,wBAAwB;IACxB,GAAG,gCAAgC;CACpC,CAAC"}

package/dist/src/core/operationDetails.js

@@ -0,0 +1,96 @@
+import { getSpecIndex } from './spec.js';
+import { getGeneratedOperationInfo, } from './generatedOperations.js';
+function isRecord(value) {
+    return Boolean(value && typeof value === 'object' && !Array.isArray(value));
+}
+function getText(value) {
+    return typeof value === 'string' && value.trim() ? value : undefined;
+}
+function resolveLocalRef(raw, ref) {
+    if (!ref.startsWith('#/'))
+        return undefined;
+    let current = raw;
+    for (const part of ref.slice(2).split('/')) {
+        if (!isRecord(current))
+            return undefined;
+        current = current[part.replace(/~1/g, '/').replace(/~0/g, '~')];
+    }
+    return current;
+}
+function schemaDetails(schema, raw) {
+    if (!isRecord(schema))
+        return schema === undefined ? {} : { schema };
+    const ref = typeof schema.$ref === 'string' ? schema.$ref : undefined;
+    if (!ref)
+        return { schema };
+    const resolved = resolveLocalRef(raw, ref);
+    return { schema: resolved ?? schema, schemaRef: ref };
+}
+function rawOperation(raw, op) {
+    if (!isRecord(raw))
+        return undefined;
+    const paths = raw.paths;
+    if (!isRecord(paths))
+        return undefined;
+    const pathItem = paths[op.path];
+    if (!isRecord(pathItem))
+        return undefined;
+    const methodEntry = pathItem[op.method.toLowerCase()];
+    return isRecord(methodEntry) ? methodEntry : undefined;
+}
+function resolveRequestBody(raw, requestBody) {
+    if (!isRecord(requestBody))
+        return undefined;
+    const ref = typeof requestBody.$ref === 'string' ? requestBody.$ref : undefined;
+    const resolved = ref ? resolveLocalRef(raw, ref) : requestBody;
+    return isRecord(resolved) ? resolved : requestBody;
+}
+function firstRequestBodySchema(body) {
+    const content = body?.content;
+    if (!isRecord(content))
+        return {};
+    const contentTypes = Object.keys(content);
+    const json = content['application/json'];
+    const selected = isRecord(json) ? json : contentTypes.map((type) => content[type]).find(isRecord);
+    return {
+        contentTypes,
+        schema: isRecord(selected) ? selected.schema : undefined,
+    };
+}
+function buildRequestBodyDetails(input) {
+    if (!input.op.hasRequestBody)
+        return undefined;
+    const body = resolveRequestBody(input.raw, input.rawOp?.requestBody);
+    const { contentTypes, schema } = firstRequestBodySchema(body);
+    return {
+        required: Boolean(input.op.requestBodyRequired),
+        description: getText(body?.description) ?? input.op.requestBodyDescription,
+        contentTypes,
+        ...schemaDetails(schema ?? input.op.requestBodySchema, input.raw),
+    };
+}
+export async function getOperationDetails(operationId) {
+    const index = await getSpecIndex();
+    const op = index.operations.get(operationId);
+    if (!op)
+        throw new Error(`Unknown operationId: ${operationId}`);
+    const rawOp = rawOperation(index.raw, op);
+    const generatedToolInfo = getGeneratedOperationInfo(op);
+    return {
+        operationId,
+        method: op.method,
+        path: op.path,
+        summary: getText(rawOp?.summary),
+        description: getText(rawOp?.description),
+        ...generatedToolInfo,
+        parameters: op.parameters.map((param) => ({
+            name: param.name,
+            in: param.in,
+            required: param.required,
+            description: param.description,
+            ...schemaDetails(param.schema, index.raw),
+        })),
+        requestBody: buildRequestBodyDetails({ raw: index.raw, op, rawOp }),
+    };
+}
+//# sourceMappingURL=operationDetails.js.map

package/dist/src/core/operationDetails.js.map

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

package/dist/src/core/operationPolicy.js

@@ -0,0 +1,32 @@
+export const CONTENT_MANAGEMENT_OPERATION_IDS = [
+    'createAvatar',
+    'updateAvatar',
+    'deleteAvatar',
+    'createWorld',
+    'updateWorld',
+    'deleteWorld',
+    'publishWorld',
+    'unpublishWorld',
+];
+const BLOCKED_OPERATION_REASONS = new Map([
+    [
+        'getGroupAnnouncements',
+        'group announcement endpoints are deprecated and unsafe.',
+    ],
+    [
+        'createGroupAnnouncement',
+        'group announcement endpoints are deprecated and unsafe.',
+    ],
+    [
+        'deleteGroupAnnouncement',
+        'group announcement endpoints are deprecated and unsafe.',
+    ],
+    ...CONTENT_MANAGEMENT_OPERATION_IDS.map((operationId) => [
+        operationId,
+        'avatar/world content-management endpoints are disabled by policy. Use ordinary view/select/favorite tools instead.',
+    ]),
+]);
+export function getBlockedOperationReason(operationId) {
+    return BLOCKED_OPERATION_REASONS.get(operationId);
+}
+//# sourceMappingURL=operationPolicy.js.map

package/dist/src/core/operationPolicy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"operationPolicy.js","sourceRoot":"","sources":["../../../src/core/operationPolicy.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,gCAAgC,GAAG;IAC9C,cAAc;IACd,cAAc;IACd,cAAc;IACd,aAAa;IACb,aAAa;IACb,aAAa;IACb,cAAc;IACd,gBAAgB;CACR,CAAC;AAEX,MAAM,yBAAyB,GAAG,IAAI,GAAG,CAAiB;IACxD;QACE,uBAAuB;QACvB,yDAAyD;KAC1D;IACD;QACE,yBAAyB;QACzB,yDAAyD;KAC1D;IACD;QACE,yBAAyB;QACzB,yDAAyD;KAC1D;IACD,GAAG,gCAAgC,CAAC,GAAG,CACrC,CAAC,WAAW,EAAE,EAAE,CACd;QACE,WAAW;QACX,oHAAoH;KAC5G,CACb;CACF,CAAC,CAAC;AAEH,MAAM,UAAU,yBAAyB,CAAC,WAAmB;IAC3D,OAAO,yBAAyB,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;AACpD,CAAC"}

package/dist/src/core/readToolRegistry.js

@@ -1,93 +1,47 @@
-import { z } from 'zod';
 import { getConfig } from '../config/index.js';
-import { getSpecIndex } from './spec.js';
 import { callReadOperation } from './readTools.js';
 import { CallError } from './client.js';
-import { buildParamsSchema } from './operationSchemas.js';
-import { readToolName } from '../utils/toolNames.js';
+import { toolName } from '../utils/toolNames.js';
 import { toolError } from '../utils/toolResponses.js';
 import { readOnlyToolAnnotations } from '../utils/toolAnnotations.js';
-import { getCuratedReadToolName, getGeneratedReadToolDescription, } from './generatedToolOverrides.js';
-import { GENERATED_READ_SKIP_IDS } from './generatedToolSkips.js';
-function buildGeneratedReadToolDescription(operationId, op) {
-    const summary = op?.summary ?? op?.description ?? '';
-    const summaryLine = String(summary).split('\n')[0].trim();
-    const curated = getCuratedReadToolName(operationId);
-    const override = getGeneratedReadToolDescription(operationId);
-    if (override)
-        return override;
-    const fallback = summaryLine
-        ? `Auto-generated read tool. ${summaryLine}`
-        : `Auto-generated read tool for ${operationId}.`;
-    if (curated)
-        return `${fallback} Prefer curated tool: ${curated}.`;
-    return `${fallback} Prefer curated tools when available.`;
-}
-function buildGeneratedReadToolInputSchema(input) {
-    const opDef = input.index.operations.get(input.operationId);
-    const paramsInfo = buildParamsSchema(opDef?.parameters ?? [], input.componentsSchemas, {
-        aliasNumberForN: true,
-    });
-    const shape = {};
-    if (paramsInfo.schema) {
-        shape.params = paramsInfo.required ? paramsInfo.schema : paramsInfo.schema.optional();
-    }
-    return z.object(shape).merge(input.readOptionsSchema).passthrough();
-}
+import { getAvailableGeneratedOperationIds } from './generatedOperations.js';
+import { GeneratedReadToolInputSchema } from '../schemas/read.js';
 export async function registerGeneratedReadTools(server, options) {
     const config = getConfig();
-    if (config.generatedReadTools.disable)
+    if (!config.generatedReadTools.enabled)
         return 0;
-    const skipOperationIds = new Set(GENERATED_READ_SKIP_IDS);
-    const index = await getSpecIndex();
-    const spec = index.raw ?? {};
-    const paths = spec.paths ?? {};
-    const componentsSchemas = spec?.components?.schemas;
-    let count = 0;
-    for (const pathItem of Object.values(paths)) {
-        for (const [method, op] of Object.entries(pathItem ?? {})) {
-            if (method !== 'get')
-                continue;
-            if (!op?.operationId)
-                continue;
-            const operationId = op.operationId;
-            if (skipOperationIds.has(operationId))
-                continue;
-            const toolName = readToolName(operationId);
-            const description = buildGeneratedReadToolDescription(operationId, op);
-            const inputSchema = buildGeneratedReadToolInputSchema({
-                operationId,
-                index,
-                componentsSchemas,
-                readOptionsSchema: options.readOptionsSchema,
-            });
-            server.registerTool(toolName, {
-                description,
-                inputSchema,
-                outputSchema: options.readOutputSchema,
-                annotations: readOnlyToolAnnotations,
-            }, async (args) => {
-                try {
-                    const { params = {}, fields, compact, maxArrayLength, includeMeta } = args ?? {};
-                    const result = await callReadOperation(operationId, params, {
-                        fields,
-                        compact,
-                        maxArrayLength,
-                        includeMeta,
-                    });
-                    return options.respond(result, includeMeta);
-                }
-                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);
-                }
+    const availableOperationIds = await getAvailableGeneratedOperationIds('read');
+    if (availableOperationIds.size === 0)
+        return 0;
+    const inputSchema = GeneratedReadToolInputSchema;
+    server.registerTool(toolName('vrchat.read'), {
+        description: 'Call an available generated VRChat GET operation by operationId. Use vrchat_operations and vrchat_operation_details to discover params.',
+        inputSchema,
+        outputSchema: options.readOutputSchema,
+        annotations: readOnlyToolAnnotations,
+    }, async (args) => {
+        try {
+            const { operationId, params = {}, fields, compact, maxArrayLength, includeMeta, page } = inputSchema.parse(args ?? {});
+            if (!availableOperationIds.has(operationId)) {
+                return toolError(`Generated read operation ${operationId} is not available. Use vrchat_operation_details for status.`);
+            }
+            const result = await callReadOperation(operationId, params, {
+                fields,
+                compact,
+                maxArrayLength,
+                includeMeta,
+                page,
             });
-            count += 1;
+            return options.respond(result, includeMeta);
+        }
+        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);
         }
-    }
-    return count;
+    });
+    return 1;
 }
 //# sourceMappingURL=readToolRegistry.js.map