@basicbit/vrchat-mcp 0.1.0

package/dist/src/services/vrcx/shared.js.map

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

package/dist/src/services/vrcx/status.js

@@ -0,0 +1,54 @@
+import { withVrcxDb } from './db.js';
+import { resolveVrcxPaths } from './paths.js';
+import { getActiveUserId, getDatabaseVersion, toUserPrefix } from './shared.js';
+export function getVrcxStatus(input) {
+    const paths = resolveVrcxPaths({
+        databasePath: input.databasePath,
+        worldDbPath: input.worldDbPath,
+    });
+    if (!input.enabled) {
+        return Promise.resolve({
+            enabled: false,
+            available: false,
+            paths,
+            activeUserId: null,
+            userPrefix: null,
+            databaseVersion: null,
+            warnings: ['VRCX integration disabled by config.'],
+        });
+    }
+    if (!paths.db.exists || !paths.db.path) {
+        const hint = paths.db.path
+            ? `VRCX database not found at "${paths.db.path}".`
+            : 'VRCX database path could not be resolved.';
+        return Promise.resolve({
+            enabled: true,
+            available: false,
+            paths,
+            activeUserId: null,
+            userPrefix: null,
+            databaseVersion: null,
+            warnings: [hint],
+        });
+    }
+    const result = withVrcxDb(paths.db.path, (db) => {
+        const activeUserId = getActiveUserId(db);
+        const userPrefix = activeUserId ? toUserPrefix(activeUserId) : null;
+        const databaseVersion = getDatabaseVersion(db);
+        const warnings = [];
+        if (activeUserId && !userPrefix) {
+            warnings.push('Failed to derive userPrefix from activeUserId.');
+        }
+        return { activeUserId, userPrefix, databaseVersion, warnings };
+    });
+    return Promise.resolve({
+        enabled: true,
+        available: true,
+        paths,
+        activeUserId: result.activeUserId,
+        userPrefix: result.userPrefix,
+        databaseVersion: result.databaseVersion,
+        warnings: result.warnings,
+    });
+}
+//# sourceMappingURL=status.js.map

package/dist/src/services/vrcx/status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../../../../src/services/vrcx/status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,gBAAgB,EAA0B,MAAM,YAAY,CAAC;AACtE,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhF,MAAM,UAAU,aAAa,CAAC,KAI7B;IASC,MAAM,KAAK,GAAG,gBAAgB,CAAC;QAC7B,YAAY,EAAE,KAAK,CAAC,YAAY;QAChC,WAAW,EAAE,KAAK,CAAC,WAAW;KAC/B,CAAC,CAAC;IAEH,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;QACnB,OAAO,OAAO,CAAC,OAAO,CAAC;YACrB,OAAO,EAAE,KAAK;YACd,SAAS,EAAE,KAAK;YAChB,KAAK;YACL,YAAY,EAAE,IAAI;YAClB,UAAU,EAAE,IAAI;YAChB,eAAe,EAAE,IAAI;YACrB,QAAQ,EAAE,CAAC,sCAAsC,CAAC;SACnD,CAAC,CAAC;IACL,CAAC;IAED,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC;QACvC,MAAM,IAAI,GAAG,KAAK,CAAC,EAAE,CAAC,IAAI;YACxB,CAAC,CAAC,+BAA+B,KAAK,CAAC,EAAE,CAAC,IAAI,IAAI;YAClD,CAAC,CAAC,2CAA2C,CAAC;QAChD,OAAO,OAAO,CAAC,OAAO,CAAC;YACrB,OAAO,EAAE,IAAI;YACb,SAAS,EAAE,KAAK;YAChB,KAAK;YACL,YAAY,EAAE,IAAI;YAClB,UAAU,EAAE,IAAI;YAChB,eAAe,EAAE,IAAI;YACrB,QAAQ,EAAE,CAAC,IAAI,CAAC;SACjB,CAAC,CAAC;IACL,CAAC;IAED,MAAM,MAAM,GAAG,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,EAAE;QAC9C,MAAM,YAAY,GAAG,eAAe,CAAC,EAAE,CAAC,CAAC;QACzC,MAAM,UAAU,GAAG,YAAY,CAAC,CAAC,CAAC,YAAY,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QACpE,MAAM,eAAe,GAAG,kBAAkB,CAAC,EAAE,CAAC,CAAC;QAC/C,MAAM,QAAQ,GAAa,EAAE,CAAC;QAC9B,IAAI,YAAY,IAAI,CAAC,UAAU,EAAE,CAAC;YAChC,QAAQ,CAAC,IAAI,CAAC,gDAAgD,CAAC,CAAC;QAClE,CAAC;QACD,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,eAAe,EAAE,QAAQ,EAAE,CAAC;IACjE,CAAC,CAAC,CAAC;IAEH,OAAO,OAAO,CAAC,OAAO,CAAC;QACrB,OAAO,EAAE,IAAI;QACb,SAAS,EAAE,IAAI;QACf,KAAK;QACL,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,eAAe,EAAE,MAAM,CAAC,eAAe;QACvC,QAAQ,EAAE,MAAM,CAAC,QAAQ;KAC1B,CAAC,CAAC;AACL,CAAC"}

package/dist/src/services/worlds/index.js

@@ -0,0 +1,256 @@
+import { callReadOperationParsed } from '../api/client.js';
+import { buildCacheKey, cacheConfig, cacheManager } from '../cache.js';
+import { buildWorldSummary, normalizeWorldName, } from '../../models/worlds.js';
+import { nonEmptyString } from '../../utils/strings.js';
+const CACHE_TTL_MS = cacheConfig.groupsTtlMs;
+const CACHE_STALE_TTL_MS = cacheConfig.groupsStaleTtlMs;
+const INSTANCE_TTL_MS = cacheConfig.notificationsTtlMs;
+const INSTANCE_STALE_TTL_MS = cacheConfig.notificationsStaleTtlMs;
+const DEFAULT_PAGE_SIZE = 50;
+const DEFAULT_MAX_PAGES = 5;
+function readPageOptions(input, defaults) {
+    const pageSize = typeof input.pageSize === 'number' ? Math.floor(input.pageSize) : defaults.pageSize;
+    const maxPages = typeof input.maxPages === 'number' ? Math.floor(input.maxPages) : defaults.maxPages;
+    const maxItems = typeof input.maxItems === 'number' ? Math.floor(input.maxItems) : undefined;
+    const offset = typeof input.offset === 'number' ? Math.floor(input.offset) : undefined;
+    return { pageSize, maxPages, maxItems, offset };
+}
+async function fetchWorldSearchCached(cacheKeyParams, params, page) {
+    const cacheKey = buildCacheKey('worlds:search', cacheKeyParams);
+    return await cacheManager.getOrSetStale(cacheKey, CACHE_TTL_MS, CACHE_STALE_TTL_MS, ['worlds', 'worlds:search'], async () => {
+        const result = await callReadOperationParsed('searchWorlds', params, {
+            page: {
+                enabled: true,
+                size: page.pageSize,
+                maxPages: page.maxPages,
+                maxItems: page.maxItems,
+                offset: page.offset,
+            },
+        });
+        return { worlds: result.data, page: result.page };
+    });
+}
+async function fetchWorldFavoritesCached(cacheKeyParams, params, page) {
+    const cacheKey = buildCacheKey('worlds:favorites', cacheKeyParams);
+    return await cacheManager.getOrSetStale(cacheKey, CACHE_TTL_MS, CACHE_STALE_TTL_MS, ['worlds', 'worlds:favorites'], async () => {
+        const result = await callReadOperationParsed('getFavoritedWorlds', params, {
+            page: {
+                enabled: true,
+                size: page.pageSize,
+                maxPages: page.maxPages,
+                maxItems: page.maxItems,
+                offset: page.offset,
+            },
+        });
+        return { worlds: result.data, page: result.page };
+    });
+}
+async function fetchWorldProfileCached(worldId, ttlMs = CACHE_TTL_MS, staleTtlMs = CACHE_STALE_TTL_MS) {
+    const cacheKey = buildCacheKey('worlds:profile', { worldId });
+    return await cacheManager.getOrSetStale(cacheKey, ttlMs, staleTtlMs, ['worlds', 'worlds:profile'], async () => {
+        const result = await callReadOperationParsed('getWorld', { worldId });
+        return result.data;
+    });
+}
+function applyWorldSummaryOptions(summary, input) {
+    if (input.includeTags === true)
+        return summary;
+    const withoutTags = { ...summary };
+    delete withoutTags.tags;
+    return withoutTags;
+}
+function extractAccessType(location) {
+    if (!location)
+        return 'unknown';
+    if (location.includes('~group(') || location.includes('~groupAccessType')) {
+        return 'group';
+    }
+    if (location.includes('~private'))
+        return 'private';
+    if (location.includes('~friends'))
+        return 'friends';
+    if (location.includes('~hidden'))
+        return 'hidden';
+    if (location.includes('~public'))
+        return 'public';
+    return location.includes('~') ? 'custom' : 'public';
+}
+function extractRegion(location) {
+    if (!location)
+        return undefined;
+    const match = /~region\(([^)]+)\)/i.exec(location);
+    if (!match)
+        return undefined;
+    return match[1];
+}
+function summarizeInstances(raw) {
+    if (!Array.isArray(raw)) {
+        return {
+            totalInstances: 0,
+            totalOccupants: 0,
+            countsByAccess: {},
+            countsByRegion: {},
+        };
+    }
+    let totalInstances = 0;
+    let totalOccupants = 0;
+    const countsByAccess = {};
+    const countsByRegion = {};
+    for (const entry of raw) {
+        if (!Array.isArray(entry) || entry.length === 0)
+            continue;
+        totalInstances += 1;
+        const location = typeof entry[0] === 'string' ? entry[0] : undefined;
+        const occupants = typeof entry[1] === 'number' ? entry[1] : 0;
+        totalOccupants += occupants;
+        const access = extractAccessType(location);
+        countsByAccess[access] = (countsByAccess[access] ?? 0) + 1;
+        const region = extractRegion(location);
+        if (region) {
+            countsByRegion[region] = (countsByRegion[region] ?? 0) + 1;
+        }
+    }
+    return {
+        totalInstances,
+        totalOccupants,
+        countsByAccess,
+        countsByRegion,
+    };
+}
+export async function searchWorlds(input) {
+    const page = readPageOptions(input, {
+        pageSize: DEFAULT_PAGE_SIZE,
+        maxPages: DEFAULT_MAX_PAGES,
+    });
+    const cacheKeyParams = {
+        search: input.query,
+        n: page.pageSize,
+        maxPages: page.maxPages,
+        maxItems: page.maxItems,
+        offset: page.offset,
+        featured: input.featured,
+        sort: nonEmptyString(input.sort),
+        order: nonEmptyString(input.order),
+        tag: nonEmptyString(input.tag),
+        notag: nonEmptyString(input.notag),
+        releaseStatus: nonEmptyString(input.releaseStatus),
+        maxUnityVersion: nonEmptyString(input.maxUnityVersion),
+        minUnityVersion: nonEmptyString(input.minUnityVersion),
+        platform: nonEmptyString(input.platform),
+    };
+    const params = {
+        search: input.query,
+        n: page.pageSize,
+        offset: page.offset,
+        featured: input.featured,
+        sort: nonEmptyString(input.sort),
+        order: nonEmptyString(input.order),
+        tag: nonEmptyString(input.tag),
+        notag: nonEmptyString(input.notag),
+        releaseStatus: nonEmptyString(input.releaseStatus),
+        maxUnityVersion: nonEmptyString(input.maxUnityVersion),
+        minUnityVersion: nonEmptyString(input.minUnityVersion),
+        platform: nonEmptyString(input.platform),
+    };
+    const { value, stale } = await fetchWorldSearchCached(cacheKeyParams, params, page);
+    const summaries = value.worlds
+        .map(buildWorldSummary)
+        .filter((entry) => Boolean(entry));
+    return {
+        worlds: summaries.map((summary) => applyWorldSummaryOptions(summary, input)),
+        page: value.page,
+        stale,
+    };
+}
+export async function listFavoriteWorlds(input) {
+    const page = readPageOptions(input, {
+        pageSize: DEFAULT_PAGE_SIZE,
+        maxPages: DEFAULT_MAX_PAGES,
+    });
+    const cacheKeyParams = {
+        search: nonEmptyString(input.query),
+        n: page.pageSize,
+        maxPages: page.maxPages,
+        maxItems: page.maxItems,
+        offset: page.offset,
+        featured: input.featured,
+        sort: nonEmptyString(input.sort),
+        order: nonEmptyString(input.order),
+        tag: nonEmptyString(input.tag),
+        notag: nonEmptyString(input.notag),
+        releaseStatus: nonEmptyString(input.releaseStatus),
+        maxUnityVersion: nonEmptyString(input.maxUnityVersion),
+        minUnityVersion: nonEmptyString(input.minUnityVersion),
+        platform: nonEmptyString(input.platform),
+        userId: nonEmptyString(input.userId),
+    };
+    const params = {
+        search: nonEmptyString(input.query),
+        n: page.pageSize,
+        offset: page.offset,
+        featured: input.featured,
+        sort: nonEmptyString(input.sort),
+        order: nonEmptyString(input.order),
+        tag: nonEmptyString(input.tag),
+        notag: nonEmptyString(input.notag),
+        releaseStatus: nonEmptyString(input.releaseStatus),
+        maxUnityVersion: nonEmptyString(input.maxUnityVersion),
+        minUnityVersion: nonEmptyString(input.minUnityVersion),
+        platform: nonEmptyString(input.platform),
+        userId: nonEmptyString(input.userId),
+    };
+    const { value, stale } = await fetchWorldFavoritesCached(cacheKeyParams, params, page);
+    const summaries = value.worlds
+        .map(buildWorldSummary)
+        .filter((entry) => Boolean(entry));
+    return {
+        worlds: summaries.map((summary) => applyWorldSummaryOptions(summary, input)),
+        page: value.page,
+        stale,
+    };
+}
+export async function resolveWorldId(args) {
+    const worldId = typeof args.worldId === 'string' ? args.worldId : undefined;
+    if (worldId)
+        return { ok: true, worldId, resolvedBy: 'id' };
+    const name = typeof args.name === 'string' ? args.name : undefined;
+    if (!name) {
+        return {
+            ok: false,
+            reason: 'Provide worldId or name.',
+            status: 'not_found',
+            nextSteps: ['vrchat_worlds_search'],
+        };
+    }
+    const searchResult = await searchWorlds({
+        query: name,
+        pageSize: 50,
+        maxPages: 1,
+        maxItems: 50,
+    });
+    const normalized = normalizeWorldName(name);
+    const matches = searchResult.worlds.filter((world) => normalizeWorldName(world.name) === normalized);
+    if (matches.length === 1) {
+        return { ok: true, worldId: matches[0].worldId, resolvedBy: 'name' };
+    }
+    const reason = matches.length === 0
+        ? `No world found matching "${name}".`
+        : `Multiple worlds matched "${name}".`;
+    return {
+        ok: false,
+        reason,
+        status: 'not_found',
+        nextSteps: ['vrchat_worlds_search'],
+    };
+}
+export async function getWorldProfile(worldId, ttlMs = CACHE_TTL_MS, staleTtlMs = CACHE_STALE_TTL_MS) {
+    const result = await fetchWorldProfileCached(worldId, ttlMs, staleTtlMs);
+    return { world: result.value, stale: result.stale };
+}
+export async function getWorldInstancesOverview(worldId) {
+    const result = await fetchWorldProfileCached(worldId, INSTANCE_TTL_MS, INSTANCE_STALE_TTL_MS);
+    const world = result.value;
+    const summary = summarizeInstances(world?.instances);
+    return { summary, stale: result.stale };
+}
+//# sourceMappingURL=index.js.map

package/dist/src/services/worlds/index.js.map

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

package/dist/src/tools/auth.js

@@ -0,0 +1,44 @@
+import { z } from 'zod';
+import { authManager } from '../auth/index.js';
+import { cacheManager } from '../services/cache.js';
+import { AuthStatusSchema } from '../schemas/auth.js';
+import { readOnlyToolAnnotations, writeToolAnnotations, } from '../utils/toolAnnotations.js';
+import { toolName } from '../utils/toolNames.js';
+export function registerAuthTools(server) {
+    server.registerTool(toolName('vrchat.auth.begin'), {
+        description: 'Begin login flow via local browser UI.',
+        outputSchema: z.object({ url: z.string(), token: z.string() }),
+        annotations: writeToolAnnotations,
+    }, async () => {
+        const { url, token } = await authManager.startLoginServer();
+        return {
+            content: [{ type: 'text', text: `Open in browser: ${url}` }],
+            structuredContent: { url, token },
+        };
+    });
+    server.registerTool(toolName('vrchat.auth.status'), {
+        description: 'Auth status.',
+        outputSchema: AuthStatusSchema,
+        annotations: readOnlyToolAnnotations,
+    }, () => {
+        const status = authManager.getStatus();
+        return {
+            content: [{ type: 'text', text: status.loggedIn ? 'logged-in' : 'logged-out' }],
+            structuredContent: status,
+        };
+    });
+    server.registerTool(toolName('vrchat.auth.logout'), {
+        description: 'Logout and clear session.',
+        outputSchema: AuthStatusSchema,
+        annotations: writeToolAnnotations,
+    }, async () => {
+        await authManager.logout();
+        cacheManager.invalidateAll();
+        const status = authManager.getStatus();
+        return {
+            content: [{ type: 'text', text: 'logged-out' }],
+            structuredContent: status,
+        };
+    });
+}
+//# sourceMappingURL=auth.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../../../src/tools/auth.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EACL,uBAAuB,EACvB,oBAAoB,GACrB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEjD,MAAM,UAAU,iBAAiB,CAAC,MAAiB;IACjD,MAAM,CAAC,YAAY,CACjB,QAAQ,CAAC,mBAAmB,CAAC,EAC7B;QACE,WAAW,EAAE,wCAAwC;QACrD,YAAY,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;QAC9D,WAAW,EAAE,oBAAoB;KAClC,EACD,KAAK,IAAI,EAAE;QACT,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,MAAM,WAAW,CAAC,gBAAgB,EAAE,CAAC;QAC5D,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,oBAAoB,GAAG,EAAE,EAAE,CAAC;YAC5D,iBAAiB,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE;SAClC,CAAC;IACJ,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,QAAQ,CAAC,oBAAoB,CAAC,EAC9B;QACE,WAAW,EAAE,cAAc;QAC3B,YAAY,EAAE,gBAAgB;QAC9B,WAAW,EAAE,uBAAuB;KACrC,EACD,GAAG,EAAE;QACH,MAAM,MAAM,GAAG,WAAW,CAAC,SAAS,EAAE,CAAC;QACvC,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,YAAY,EAAE,CAAC;YAC/E,iBAAiB,EAAE,MAAM;SAC1B,CAAC;IACJ,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,QAAQ,CAAC,oBAAoB,CAAC,EAC9B;QACE,WAAW,EAAE,2BAA2B;QACxC,YAAY,EAAE,gBAAgB;QAC9B,WAAW,EAAE,oBAAoB;KAClC,EACD,KAAK,IAAI,EAAE;QACT,MAAM,WAAW,CAAC,MAAM,EAAE,CAAC;QAC3B,YAAY,CAAC,aAAa,EAAE,CAAC;QAC7B,MAAM,MAAM,GAAG,WAAW,CAAC,SAAS,EAAE,CAAC;QACvC,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC;YAC/C,iBAAiB,EAAE,MAAM;SAC1B,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/src/tools/cache.js

@@ -0,0 +1,61 @@
+import { z } from 'zod';
+import { cacheConfig, cacheManager } from '../services/cache.js';
+import { writeToolAnnotations } from '../utils/toolAnnotations.js';
+import { toolName } from '../utils/toolNames.js';
+import { textContent, toolError } from '../utils/toolResponses.js';
+export function registerCacheTools(server) {
+    server.registerTool(toolName('vrchat.cache.invalidate'), {
+        description: 'Invalidate cached data (local-only).',
+        inputSchema: z.object({
+            scope: z.enum(['all', 'area', 'key']).optional(),
+            area: z.string().optional(),
+            key: z.string().optional(),
+        }),
+        outputSchema: z.object({
+            enabled: z.boolean(),
+            cleared: z.number().int().min(0),
+            scope: z.string(),
+            area: z.string().optional(),
+            key: z.string().optional(),
+        }),
+        annotations: writeToolAnnotations,
+    }, (args) => {
+        const enabled = cacheConfig.enabled;
+        if (!enabled) {
+            const payload = { enabled, cleared: 0, scope: 'disabled' };
+            return {
+                content: textContent(JSON.stringify(payload, null, 2)),
+                structuredContent: payload,
+            };
+        }
+        const scope = args?.scope ?? 'all';
+        if (scope === 'area' && !args?.area) {
+            return toolError('area is required when scope=area');
+        }
+        if (scope === 'key' && !args?.key) {
+            return toolError('key is required when scope=key');
+        }
+        let cleared = 0;
+        if (scope === 'all') {
+            cleared = cacheManager.invalidateAll();
+        }
+        else if (scope === 'area') {
+            cleared = cacheManager.invalidateByTag(String(args.area));
+        }
+        else {
+            cleared = cacheManager.invalidateByKey(String(args.key));
+        }
+        const payload = {
+            enabled,
+            cleared,
+            scope,
+            area: scope === 'area' ? String(args.area) : undefined,
+            key: scope === 'key' ? String(args.key) : undefined,
+        };
+        return {
+            content: textContent(JSON.stringify(payload, null, 2)),
+            structuredContent: payload,
+        };
+    });
+}
+//# sourceMappingURL=cache.js.map

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

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

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

@@ -0,0 +1,57 @@
+import { getConfig } from '../../config/index.js';
+import { shapeReadData } from '../../core/readTools.js';
+import { AvatarProfileInputSchema, AvatarProfileOutputSchema } from '../../models/avatars.js';
+import { getAvatarProfile } from '../../services/avatars/index.js';
+import { getVrcxAvatarMemo } 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 registerCuratedAvatarTools(server) {
+    server.registerTool(toolName('vrchat.avatar.profile'), {
+        description: 'Get an avatar profile by avatarId (read-only).',
+        inputSchema: AvatarProfileInputSchema,
+        outputSchema: AvatarProfileOutputSchema,
+        annotations: readOnlyToolAnnotations,
+    }, async (args) => {
+        try {
+            const input = AvatarProfileInputSchema.parse(args);
+            const result = await getAvatarProfile(input.avatarId);
+            const shaped = shapeReadData(result.avatar, {
+                fields: input.fields,
+                compact: input.compact,
+                maxArrayLength: input.maxArrayLength,
+            });
+            let vrcxMemo;
+            try {
+                const config = getConfig();
+                const memoResult = await getVrcxAvatarMemo({
+                    enabled: config.vrcx.enabled,
+                    databasePath: config.vrcx.databasePath,
+                    worldDbPath: config.vrcx.worldDbPath,
+                    avatarId: input.avatarId,
+                });
+                if (memoResult.ok && (memoResult.memo || memoResult.editedAt)) {
+                    vrcxMemo = { editedAt: memoResult.editedAt, memo: memoResult.memo };
+                }
+            }
+            catch {
+                // ignore VRCX errors; avatar profile should still work
+            }
+            const payload = {
+                avatarId: input.avatarId,
+                stale: result.stale,
+                avatar: 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);
+        }
+    });
+}
+//# sourceMappingURL=avatars.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"avatars.js","sourceRoot":"","sources":["../../../../src/tools/curated/avatars.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,wBAAwB,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AAC9F,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACnE,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AACzE,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAEtE,MAAM,UAAU,0BAA0B,CAAC,MAAiB;IAC1D,MAAM,CAAC,YAAY,CACjB,QAAQ,CAAC,uBAAuB,CAAC,EACjC;QACE,WAAW,EAAE,gDAAgD;QAC7D,WAAW,EAAE,wBAAwB;QACrC,YAAY,EAAE,yBAAyB;QACvC,WAAW,EAAE,uBAAuB;KACrC,EACD,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,wBAAwB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YACnD,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;YACtD,MAAM,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE;gBAC1C,MAAM,EAAE,KAAK,CAAC,MAAM;gBACpB,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,cAAc,EAAE,KAAK,CAAC,cAAc;aACrC,CAAC,CAAC;YAEH,IAAI,QAAsE,CAAC;YAC3E,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;gBAC3B,MAAM,UAAU,GAAG,MAAM,iBAAiB,CAAC;oBACzC,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,OAAO;oBAC5B,YAAY,EAAE,MAAM,CAAC,IAAI,CAAC,YAAY;oBACtC,WAAW,EAAE,MAAM,CAAC,IAAI,CAAC,WAAW;oBACpC,QAAQ,EAAE,KAAK,CAAC,QAAQ;iBACzB,CAAC,CAAC;gBACH,IAAI,UAAU,CAAC,EAAE,IAAI,CAAC,UAAU,CAAC,IAAI,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;oBAC9D,QAAQ,GAAG,EAAE,QAAQ,EAAE,UAAU,CAAC,QAAQ,EAAE,IAAI,EAAE,UAAU,CAAC,IAAI,EAAE,CAAC;gBACtE,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,uDAAuD;YACzD,CAAC;YAED,MAAM,OAAO,GAAG;gBACd,QAAQ,EAAE,KAAK,CAAC,QAAQ;gBACxB,KAAK,EAAE,MAAM,CAAC,KAAK;gBACnB,MAAM,EAAE,MAAM;gBACd,QAAQ;aACT,CAAC;YAEF,OAAO;gBACL,OAAO,EAAE,WAAW,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;gBACtD,iBAAiB,EAAE,OAAkC;aACtD,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,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"}