vibo-mcp 1.7.1 → 1.8.1

package/.claude-plugin/marketplace.json

@@ -7,7 +7,7 @@
   },
   "metadata": {
     "description": "MCP server for Vibo (vibodj.com) — plan & manage event music, song requests, ideas, guests, and playlists via natural language",
-    "version": "1.7.1"
+    "version": "1.8.1"
   },
   "plugins": [
     {
@@ -15,7 +15,7 @@
       "displayName": "Vibo",
       "source": "./",
       "description": "MCP server for Vibo — browse & manage events, timeline, songs, the DJ song ideas/questions, guests, and exports to Spotify/Apple Music",
-      "version": "1.7.1",
+      "version": "1.8.1",
       "author": {
         "name": "Chris Hall"
       },

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "vibo-mcp",
   "displayName": "Vibo",
-  "version": "1.7.1",
+  "version": "1.8.1",
   "description": "MCP server for Vibo (vibodj.com) — plan & manage event music, song requests, ideas, guests, and playlists via natural language",
   "author": {
     "name": "Chris Hall",

package/dist/bundle.js

@@ -13450,7 +13450,7 @@ ${content.join("\n")}
 var version = {
   major: 4,
   minor: 5,
-  patch: 2
+  patch: 4
 };
 
 // node_modules/zod/v4/core/schemas.js
@@ -15743,22 +15743,99 @@ function isRecursive(inst, stack) {
       result = true;
   };
   const def = inst._zod.def;
-  if (def.type === "lazy") {
-    check2(inst._zod.innerType);
-  } else {
-    const shape = def.shape;
-    if (shape)
-      for (const key of Reflect.ownKeys(shape))
-        check2(shape[key]);
-    for (const key in def) {
-      const value = def[key];
-      if (!value || typeof value !== "object")
-        continue;
-      if (value._zod)
-        check2(value);
-      else if (Array.isArray(value))
-        for (const el of value)
-          check2(el);
+  const kind = def.type;
+  switch (kind) {
+    case "object": {
+      for (const key of Reflect.ownKeys(def.shape))
+        check2(def.shape[key]);
+      check2(def.catchall);
+      break;
+    }
+    case "array":
+      check2(def.element);
+      break;
+    case "tuple":
+      for (const el of def.items)
+        check2(el);
+      check2(def.rest);
+      break;
+    case "record":
+    case "map":
+      check2(def.keyType);
+      check2(def.valueType);
+      break;
+    case "set":
+      check2(def.valueType);
+      break;
+    case "union":
+      for (const el of def.options)
+        check2(el);
+      break;
+    case "intersection":
+      check2(def.left);
+      check2(def.right);
+      break;
+    case "optional":
+    case "nullable":
+    case "default":
+    case "prefault":
+    case "catch":
+    case "readonly":
+    case "nonoptional":
+    case "promise":
+    case "success":
+      check2(def.innerType);
+      break;
+    case "pipe":
+      check2(def.in);
+      check2(def.out);
+      break;
+    case "function":
+      check2(def.input);
+      check2(def.output);
+      break;
+    // reading `_zod.innerType` resolves the getter once and caches it
+    case "lazy":
+      check2(inst._zod.innerType);
+      break;
+    // a leaf by choice: `parts` are regex fragments, not data positions
+    case "template_literal":
+    // leaves
+    case "string":
+    case "number":
+    case "int":
+    case "boolean":
+    case "bigint":
+    case "symbol":
+    case "undefined":
+    case "null":
+    case "void":
+    case "never":
+    case "any":
+    case "unknown":
+    case "date":
+    case "nan":
+    case "enum":
+    case "literal":
+    case "file":
+    case "transform":
+    case "custom":
+      break;
+    default: {
+      kind;
+      for (const key in def) {
+        const desc = Object.getOwnPropertyDescriptor(def, key);
+        if (!desc || desc.get)
+          continue;
+        const value = desc.value;
+        if (!value || typeof value !== "object")
+          continue;
+        if (value._zod)
+          check2(value);
+        else if (Array.isArray(value))
+          for (const el of value)
+            check2(el);
+      }
     }
   }
   stack.delete(inst);
@@ -25891,6 +25968,7 @@ function initializeContext(params) {
     cycles: params?.cycles ?? "ref",
     reused: params?.reused ?? "inline",
     intersections: [],
+    deferred: [],
     external: params?.external ?? void 0
   };
 }
@@ -26239,6 +26317,8 @@ function finalize(ctx, schema) {
         compactTypeUnion(entry[1].def ?? entry[1].schema);
       }
     }
+    for (const rewrite of ctx.deferred)
+      rewrite();
     if (ctx.intersections.length) {
       const carriers = /* @__PURE__ */ new Map();
       for (const seen of ctx.seen.values()) {
@@ -26415,12 +26495,12 @@ var stringProcessor = (schema, ctx, _json, _params) => {
   if (contentEncoding)
     json2.contentEncoding = contentEncoding;
   if (patterns && patterns.size > 0) {
-    const regexes = [...patterns];
-    if (regexes.length === 1)
-      json2.pattern = regexes[0].source;
-    else if (regexes.length > 1) {
+    const patternList = [...patterns];
+    if (patternList.length === 1)
+      json2.pattern = patternList[0].source;
+    else if (patternList.length > 1) {
       json2.allOf = [
-        ...regexes.map((regex) => ({
+        ...patternList.map((regex) => ({
           ...ctx.target === "draft-07" || ctx.target === "draft-04" || ctx.target === "openapi-3.0" ? { type: "string" } : {},
           pattern: regex.source
         }))
@@ -26764,6 +26844,69 @@ var tupleProcessor = (schema, ctx, _json, params) => {
   if (typeof maximum === "number")
     json2.maxItems = maximum;
 };
+function stringifyKeyNames(bySchema, json2, visited) {
+  if (json2.$ref) {
+    if (visited.has(json2))
+      return json2;
+    visited.add(json2);
+    const def = bySchema.get(json2)?.def;
+    if (!def)
+      return json2;
+    const inlined = stringifyKeyNames(bySchema, def, visited);
+    return inlined === def ? json2 : inlined;
+  }
+  for (const keyword of ["anyOf", "oneOf"]) {
+    const branches = json2[keyword];
+    if (!Array.isArray(branches))
+      continue;
+    const mapped = branches.map((branch) => stringifyKeyNames(bySchema, branch, visited));
+    if (mapped.some((branch, i) => branch !== branches[i]))
+      json2 = { ...json2, [keyword]: mapped };
+  }
+  const types = Array.isArray(json2.type) ? json2.type : [json2.type];
+  const numericType = !types.includes("string") && types.some((t) => t === "number" || t === "integer");
+  const values = json2.enum ?? (json2.const !== void 0 ? [json2.const] : void 0);
+  if (!numericType && !values?.some((v) => typeof v === "number"))
+    return json2;
+  const { minimum, maximum, exclusiveMinimum, exclusiveMaximum, multipleOf, format, id, ...rest } = json2;
+  if (rest.enum)
+    rest.enum = rest.enum.map((v) => typeof v === "number" ? String(v) : v);
+  else if (typeof rest.const === "number")
+    rest.const = String(rest.const);
+  if (!numericType)
+    return rest;
+  rest.type = "string";
+  if (!values)
+    rest.pattern = (types.includes("number") ? number : integer).source;
+  return rest;
+}
+var pendingRecords = /* @__PURE__ */ new WeakMap();
+function rewriteKeyNames(ctx) {
+  const bySchema = /* @__PURE__ */ new Map();
+  for (const entry of ctx.seen.values()) {
+    if (entry.def && !bySchema.has(entry.schema))
+      bySchema.set(entry.schema, entry);
+  }
+  const rewrites = /* @__PURE__ */ new Map();
+  for (const record2 of pendingRecords.get(ctx) ?? []) {
+    const seen = ctx.seen.get(record2);
+    const names = (seen?.def ?? seen?.schema)?.propertyNames;
+    if (!names || names === true || rewrites.has(names))
+      continue;
+    const rewritten = stringifyKeyNames(bySchema, names, /* @__PURE__ */ new Set());
+    if (rewritten !== names)
+      rewrites.set(names, rewritten);
+  }
+  if (!rewrites.size)
+    return;
+  for (const entry of ctx.seen.values()) {
+    for (const carrier of [entry.schema, entry.def]) {
+      const rewritten = carrier && rewrites.get(carrier.propertyNames);
+      if (rewritten)
+        carrier.propertyNames = rewritten;
+    }
+  }
+}
 var recordProcessor = (schema, ctx, _json, params) => {
   const json2 = _json;
   const def = schema._zod.def;
@@ -26786,6 +26929,13 @@ var recordProcessor = (schema, ctx, _json, params) => {
         ...params,
         path: [...params.path, "propertyNames"]
       });
+      let pending = pendingRecords.get(ctx);
+      if (!pending) {
+        pending = [];
+        pendingRecords.set(ctx, pending);
+        ctx.deferred.push(() => rewriteKeyNames(ctx));
+      }
+      pending.push(schema);
     }
     json2.additionalProperties = process2(def.valueType, ctx, {
       ...params,
@@ -26797,7 +26947,7 @@ var recordProcessor = (schema, ctx, _json, params) => {
   if (keyValues && !def.partial && !omittableOnInput) {
     const validKeyValues = [...keyValues].filter((v) => typeof v === "string" || typeof v === "number");
     if (validKeyValues.length > 0) {
-      json2.required = validKeyValues;
+      json2.required = validKeyValues.map(String);
     }
   }
 };
@@ -35790,7 +35940,7 @@ function toolAnnotations(opts = {}) {
 }
 
 // src/version.ts
-var VERSION = "1.7.1";
+var VERSION = "1.8.1";
 
 // src/client.ts
 import { dirname as dirname2, join as join3 } from "path";
@@ -36569,17 +36719,27 @@ var UPLOAD_USER_PHOTO = `
   }
 `;
 
+// src/view.ts
+var VIBO_VIEWS = ["compact", "full"];
+var NOTE = `compact strips image/avatar URLs from the response; "full" returns Vibo's payload untouched. No field projection: this server has no verified record of which Vibo fields matter, and inventing one would risk dropping a field a caller needs.`;
+var viewArg = () => viewParam(VIBO_VIEWS, { note: NOTE });
+function viewResponse(view, data) {
+  const rung = resolveView(view, VIBO_VIEWS);
+  return minifiedResult(rung === "compact" ? stripMediaUrls(data) : data);
+}
+
 // src/tools/profile.ts
 function registerProfileTools(server, client2) {
   server.registerTool(
     "vibo_get_me",
     {
       description: "Get the signed-in Vibo user's profile (id, name, email, phone, locale, and whether Spotify/Apple Music are connected). Use the returned _id to recognize your own songs/contacts.",
-      annotations: toolAnnotations({ title: "Get my Vibo profile", readOnly: true })
+      annotations: toolAnnotations({ title: "Get my Vibo profile", readOnly: true }),
+      inputSchema: { view: viewArg() }
     },
-    async () => {
+    async ({ view }) => {
       const data = await client2.gql(GET_ME);
-      return minifiedResult(data.me);
+      return viewResponse(view, data.me);
     }
   );
   server.registerTool(
@@ -36745,15 +36905,6 @@ function registerSectionTools(server, client2) {
   );
 }
 
-// src/view.ts
-var VIBO_VIEWS = ["compact", "full"];
-var NOTE = `compact strips image/avatar URLs from the response; "full" returns Vibo's payload untouched. No field projection: this server has no verified record of which Vibo fields matter, and inventing one would risk dropping a field a caller needs.`;
-var viewArg = () => viewParam(VIBO_VIEWS, { note: NOTE });
-function viewResponse(view, data) {
-  const rung = resolveView(view, VIBO_VIEWS);
-  return minifiedResult(rung === "compact" ? stripMediaUrls(data) : data);
-}
-
 // src/song-search.ts
 var NON_ORIGINAL_MARKERS = [
   "karaoke",
@@ -36896,11 +37047,12 @@ function registerSongTools(server, client2) {
         isFlagged: external_exports.boolean().optional().describe("Filter to do-not-play / flagged songs."),
         sortField: external_exports.enum(["likesCount", "createdAt", "title"]).optional(),
         sortDirection: external_exports.enum(["asc", "desc"]).optional(),
+        view: viewArg(),
         limit: limitSchema,
         skip: skipSchema
       }
     },
-    async ({ eventId, sectionId, q, isMustPlay, isFlagged, sortField, sortDirection, limit, skip }) => {
+    async ({ eventId, sectionId, q, isMustPlay, isFlagged, sortField, sortDirection, limit, skip, view }) => {
       const filter = {};
       if (q !== void 0) filter.q = q;
       if (isMustPlay !== void 0) filter.isMustPlay = isMustPlay;
@@ -36913,7 +37065,7 @@ function registerSongTools(server, client2) {
         ...sortField ? { sort: { field: sortField, direction: sortDirection ?? "desc" } } : {}
       };
       const data = await client2.gql(GET_SECTION_SONGS, variables);
-      return minifiedResult(data.getSectionSongs);
+      return viewResponse(view, data.getSectionSongs);
     }
   );
   server.registerTool(
@@ -37100,15 +37252,16 @@ function registerNotificationTools(server, client2) {
       description: "List your Vibo notifications (song additions, comments, DJ updates, etc.) with read state and linked event/section ids.",
       annotations: toolAnnotations({ title: "List Vibo notifications", readOnly: true }),
       inputSchema: {
+        view: viewArg(),
         limit: limitSchema,
         skip: skipSchema
       }
     },
-    async ({ limit, skip }) => {
+    async ({ limit, skip, view }) => {
       const data = await client2.gql(GET_NOTIFICATIONS, {
         pagination: pagination(limit, skip)
       });
-      return minifiedResult(data.getNotifications);
+      return viewResponse(view, data.getNotifications);
     }
   );
   server.registerTool(
@@ -37497,18 +37650,19 @@ function registerIdeasTools(server, client2) {
         eventId: external_exports.string().describe("Event id."),
         sectionId: external_exports.string().describe("Section id (from vibo_list_sections)."),
         songIdeasId: external_exports.string().describe("The _id from vibo_list_section_song_ideas."),
+        view: viewArg(),
         limit: limitSchema,
         skip: skipSchema
       }
     },
-    async ({ eventId, sectionId, songIdeasId, limit, skip }) => {
+    async ({ eventId, sectionId, songIdeasId, limit, skip, view }) => {
       const data = await client2.gql(LIST_SONG_IDEAS_SONGS, {
         eventId,
         sectionId,
         songIdeasId,
         pagination: pagination(limit, skip)
       });
-      return minifiedResult(data.getEventSectionSongIdeasSongs);
+      return viewResponse(view, data.getEventSectionSongIdeasSongs);
     }
   );
 }
@@ -37559,11 +37713,12 @@ function registerCollaborationTools(server, client2) {
       inputSchema: {
         eventId: external_exports.string().describe("Event id."),
         usersType: external_exports.enum(["host", "guest"]).optional().describe("Filter to only hosts or only guests."),
+        view: viewArg(),
         limit: limitSchema.describe("Max items to return (default 20). Applies per group when usersType is omitted."),
         skip: skipSchema
       }
     },
-    async ({ eventId, usersType, limit, skip }) => {
+    async ({ eventId, usersType, limit, skip, view }) => {
       const page = pagination(limit, skip);
       if (usersType) {
         const data = await client2.gql(LIST_EVENT_USERS, {
@@ -37571,13 +37726,13 @@ function registerCollaborationTools(server, client2) {
           usersType,
           pagination: page
         });
-        return minifiedResult({ ...data.eventUsers, usersType });
+        return viewResponse(view, { ...data.eventUsers, usersType });
       }
       const [hosts, guests] = await Promise.all([
         client2.gql(LIST_EVENT_USERS, { eventId, usersType: "host", pagination: page }),
         client2.gql(LIST_EVENT_USERS, { eventId, usersType: "guest", pagination: page })
       ]);
-      return minifiedResult({
+      return viewResponse(view, {
         hosts: hosts.eventUsers.users,
         guests: guests.eventUsers.users,
         hostsCount: hosts.eventUsers.totalCount,

package/dist/tools/collaboration.js

@@ -2,6 +2,7 @@ import { z } from 'zod';
 import { minifiedResult, schemaConfirm, toolAnnotations } from '@chrischall/mcp-utils';
 import { LIST_EVENT_USERS, INVITE_USERS, CHANGE_USER_ROLE, REMOVE_USER } from '../gql.js';
 import { limitSchema, skipSchema, pagination, previewResult } from './shared.js';
+import { viewArg, viewResponse } from '../view.js';
 export function registerCollaborationTools(server, client) {
     server.registerTool('vibo_list_event_users', {
         description: "List the hosts and guests on an event. With no usersType, returns both groups merged ({hosts, guests, hostsCount, guestsCount}) and `limit`/`skip` apply per group; with usersType, returns that one group's page.",
@@ -9,10 +10,11 @@ export function registerCollaborationTools(server, client) {
         inputSchema: {
             eventId: z.string().describe('Event id.'),
             usersType: z.enum(['host', 'guest']).optional().describe('Filter to only hosts or only guests.'),
+            view: viewArg(),
             limit: limitSchema.describe('Max items to return (default 20). Applies per group when usersType is omitted.'),
             skip: skipSchema,
         },
-    }, async ({ eventId, usersType, limit, skip }) => {
+    }, async ({ eventId, usersType, limit, skip, view }) => {
         const page = pagination(limit, skip);
         if (usersType) {
             const data = await client.gql(LIST_EVENT_USERS, {
@@ -20,7 +22,7 @@ export function registerCollaborationTools(server, client) {
                 usersType,
                 pagination: page,
             });
-            return minifiedResult({ ...data.eventUsers, usersType });
+            return viewResponse(view, { ...data.eventUsers, usersType });
         }
         // The API returns nothing unless usersType is set, so fetch both groups
         // and merge for the intuitive "everyone on the event" listing.
@@ -28,7 +30,10 @@ export function registerCollaborationTools(server, client) {
             client.gql(LIST_EVENT_USERS, { eventId, usersType: 'host', pagination: page }),
             client.gql(LIST_EVENT_USERS, { eventId, usersType: 'guest', pagination: page }),
         ]);
-        return minifiedResult({
+        // BOTH exits go through the rung. The merged branch is the one that runs
+        // when `usersType` is omitted — the default call — so honouring `view` on
+        // only the filtered branch would leave the common path paying full price.
+        return viewResponse(view, {
             hosts: hosts.eventUsers.users,
             guests: guests.eventUsers.users,
             hostsCount: hosts.eventUsers.totalCount,

package/dist/tools/ideas.js

@@ -2,6 +2,7 @@ import { z } from 'zod';
 import { minifiedResult, toolAnnotations } from '@chrischall/mcp-utils';
 import { LIST_SECTION_SONG_IDEAS, LIST_SONG_IDEAS_SONGS } from '../gql.js';
 import { limitSchema, skipSchema, pagination } from './shared.js';
+import { viewArg, viewResponse } from '../view.js';
 export function registerIdeasTools(server, client) {
     server.registerTool('vibo_list_section_song_ideas', {
         description: "List the DJ's suggested song-idea collections for a section (each with a title, songsCount and _id). Use a song-ideas _id with vibo_list_song_ideas_songs to see the suggested songs, then add the ones you like with vibo_add_song_to_section.",
@@ -27,16 +28,17 @@ export function registerIdeasTools(server, client) {
             eventId: z.string().describe('Event id.'),
             sectionId: z.string().describe('Section id (from vibo_list_sections).'),
             songIdeasId: z.string().describe('The _id from vibo_list_section_song_ideas.'),
+            view: viewArg(),
             limit: limitSchema,
             skip: skipSchema,
         },
-    }, async ({ eventId, sectionId, songIdeasId, limit, skip }) => {
+    }, async ({ eventId, sectionId, songIdeasId, limit, skip, view }) => {
         const data = await client.gql(LIST_SONG_IDEAS_SONGS, {
             eventId,
             sectionId,
             songIdeasId,
             pagination: pagination(limit, skip),
         });
-        return minifiedResult(data.getEventSectionSongIdeasSongs);
+        return viewResponse(view, data.getEventSectionSongIdeasSongs);
     });
 }

package/dist/tools/notifications.js

@@ -2,19 +2,21 @@ import { z } from 'zod';
 import { McpToolError, minifiedResult, schemaConfirm, toolAnnotations } from '@chrischall/mcp-utils';
 import { GET_NOTIFICATIONS, GET_NOTIFICATIONS_COUNT, MARK_AS_READ } from '../gql.js';
 import { limitSchema, skipSchema, pagination, previewResult } from './shared.js';
+import { viewArg, viewResponse } from '../view.js';
 export function registerNotificationTools(server, client) {
     server.registerTool('vibo_list_notifications', {
         description: 'List your Vibo notifications (song additions, comments, DJ updates, etc.) with read state and linked event/section ids.',
         annotations: toolAnnotations({ title: 'List Vibo notifications', readOnly: true }),
         inputSchema: {
+            view: viewArg(),
             limit: limitSchema,
             skip: skipSchema,
         },
-    }, async ({ limit, skip }) => {
+    }, async ({ limit, skip, view }) => {
         const data = await client.gql(GET_NOTIFICATIONS, {
             pagination: pagination(limit, skip),
         });
-        return minifiedResult(data.getNotifications);
+        return viewResponse(view, data.getNotifications);
     });
     server.registerTool('vibo_get_notifications_count', {
         description: 'Get the count of unread Vibo notifications.',

package/dist/tools/profile.js

@@ -1,12 +1,14 @@
 import { minifiedResult, toolAnnotations } from '@chrischall/mcp-utils';
 import { GET_ME } from '../gql.js';
+import { viewArg, viewResponse } from '../view.js';
 export function registerProfileTools(server, client) {
     server.registerTool('vibo_get_me', {
         description: "Get the signed-in Vibo user's profile (id, name, email, phone, locale, and whether Spotify/Apple Music are connected). Use the returned _id to recognize your own songs/contacts.",
         annotations: toolAnnotations({ title: 'Get my Vibo profile', readOnly: true }),
-    }, async () => {
+        inputSchema: { view: viewArg() },
+    }, async ({ view }) => {
         const data = await client.gql(GET_ME);
-        return minifiedResult(data.me);
+        return viewResponse(view, data.me);
     });
     server.registerTool('vibo_healthcheck', {
         description: 'Verify connectivity and authentication to the Vibo API by fetching the current user. Returns ok:true with your account id when credentials work.',

package/dist/tools/songs.js

@@ -16,10 +16,11 @@ export function registerSongTools(server, client) {
             isFlagged: z.boolean().optional().describe('Filter to do-not-play / flagged songs.'),
             sortField: z.enum(['likesCount', 'createdAt', 'title']).optional(),
             sortDirection: z.enum(['asc', 'desc']).optional(),
+            view: viewArg(),
             limit: limitSchema,
             skip: skipSchema,
         },
-    }, async ({ eventId, sectionId, q, isMustPlay, isFlagged, sortField, sortDirection, limit, skip }) => {
+    }, async ({ eventId, sectionId, q, isMustPlay, isFlagged, sortField, sortDirection, limit, skip, view }) => {
         const filter = {};
         if (q !== undefined)
             filter.q = q;
@@ -35,7 +36,7 @@ export function registerSongTools(server, client) {
             ...(sortField ? { sort: { field: sortField, direction: sortDirection ?? 'desc' } } : {}),
         };
         const data = await client.gql(GET_SECTION_SONGS, variables);
-        return minifiedResult(data.getSectionSongs);
+        return viewResponse(view, data.getSectionSongs);
     });
     server.registerTool('vibo_search_songs', {
         description: 'Search for songs to add to a section. ALWAYS query as "<Artist> - <Title>" with a ' +

package/dist/version.js

@@ -2,4 +2,4 @@
 // literal on the line carrying the release marker; every manifest and the MCP
 // server banner import VERSION from here, so there is exactly one place to keep
 // in sync (and one release-please extra-files entry).
-export const VERSION = '1.7.1'; // x-release-please-version
+export const VERSION = '1.8.1'; // x-release-please-version

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vibo-mcp",
-  "version": "1.7.1",
+  "version": "1.8.1",
   "mcpName": "io.github.chrischall/vibo-mcp",
   "description": "Vibo (vibodj.com) MCP server for Claude — host/couple event music planning & management. Developed and maintained by AI (Claude Code).",
   "author": "Claude Code (AI) <https://www.anthropic.com/claude>",
@@ -46,17 +46,17 @@
     "typecheck": "tsc -p tsconfig.json --noEmit"
   },
   "dependencies": {
-    "@chrischall/mcp-utils": "^0.23.0",
+    "@chrischall/mcp-utils": "^0.26.1",
     "@fetchproxy/bootstrap": "^2.2.0",
-    "@modelcontextprotocol/sdk": "^1.29.0",
+    "@modelcontextprotocol/sdk": "^1.30.0",
     "dotenv": "^17.4.0",
-    "zod": "^4.4.2"
+    "zod": "^4.5.4"
   },
   "devDependencies": {
     "@types/node": "^26.0.0",
-    "@vitest/coverage-v8": "^4.1.2",
+    "@vitest/coverage-v8": "^5.0.0",
     "esbuild": "^0.28.0",
     "typescript": "^7.0.2",
-    "vitest": "^4.1.2"
+    "vitest": "^5.0.0"
   }
 }

package/server.json

@@ -6,12 +6,12 @@
     "url": "https://github.com/chrischall/vibo-mcp",
     "source": "github"
   },
-  "version": "1.7.1",
+  "version": "1.8.1",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "vibo-mcp",
-      "version": "1.7.1",
+      "version": "1.8.1",
       "transport": {
         "type": "stdio"
       },

package/skills/vibo-mcp/SKILL.md

@@ -87,63 +87,58 @@ you get a dry-run preview of exactly what would be sent.
 
 ## Response shape (`view`)
 
-Exactly one of this server's 39 tools takes `view: "compact" | "full"` —
-**`vibo_search_songs`** — and on it **`compact` is the DEFAULT**. You get the
-slim rung without asking for it.
+**Six of this server's 39 tools take `view: "compact" | "full"`**, and on every
+one of them **`compact` is the DEFAULT**. You get the slim rung without asking.
+
+They are exactly the six reads whose GraphQL document asks Vibo for media:
+
+| Tool | What compact drops |
+| --- | --- |
+| `vibo_search_songs` | `thumbnails { s180x180 original }` per track |
+| `vibo_get_section_songs` | `thumbnails { s180x180 original }` per song |
+| `vibo_list_song_ideas_songs` | `thumbnails { s180x180 original }` per song |
+| `vibo_list_event_users` | `imageUrl` per person (both exits — merged and filtered) |
+| `vibo_list_notifications` | `imageUrl` per notification |
+| `vibo_get_me` | `imageUrl` |
+
+That correspondence is not a coincidence to be maintained by hand: a test in
+`tests/view.test.ts` counts the media selections in `src/gql.ts` and asserts
+the roster of `view`-taking tools matches. Add a seventh selection and it fails.
 
 **Compact here is media stripping, not a field projection.** `src/view.ts`
 writes no field list, because this repo holds no captured Vibo payload to
 derive one from honestly; instead it removes keys whose value is a picture,
 which is subtractive and so cannot drop a field nobody knew about.
 
-Why `vibo_search_songs` is the tool that got it: `annotateSearchResults`
-SPREADS Vibo's own song objects (`{ ...song, quality }`), so it is a
-pass-through with a verdict attached rather than a projection — and the search
-query selects `thumbnails { s180x180 original }` per track, so every cover-art
-URL in the catalog was coming straight back to the caller. Compact removes
-those.
-
-What compact does **not** touch on that tool is the point of the tool:
-`songUrl`, the `links` block (`spotify` / `youtube` / `appleMusic`) and the
-`quality` verdict all survive. A streaming link is this server's product, not
-decoration — `vibo_add_song_to_section` cannot add anything without `songUrl`,
-and the quality verdict is computed from how many services carry a track. A
-`null` link survives too: an absent key and a null one are the same to
-`JSON.parse` but not to a reader deciding whether a service was checked.
+What compact does **not** touch is the point of these tools: `songUrl`, the
+`links` block (`spotify` / `youtube` / `appleMusic`) and the `quality` verdict
+all survive. A streaming link is this server's product, not decoration —
+`vibo_add_song_to_section` cannot add anything without `songUrl`, and the
+quality verdict is computed from how many services carry a track. A `null` link
+survives too: an absent key and a null one are the same to `JSON.parse` but not
+to a reader deciding whether a service was checked.
 
 `view: "full"` returns Vibo's payload untouched, cover art included. There is
 deliberately **no `raw` rung**: nothing here re-serialises or normalises the
 GraphQL response, so `full` already IS the upstream payload and a third value
 would silently alias one that exists.
 
-### The other 38 tools have no `view` — and one group of them matters
+### The other 33 tools have no `view`
 
 - **The 24 mutating tools** (every confirm-gated write, plus
   `vibo_capture_session`) answer with a dry-run preview or a receipt — an id,
   a count, a status. Nothing in a receipt is decoration, and slimming one is
   how you lose the field that says what actually happened.
-- **`vibo_healthcheck`** answers with a connectivity/auth diagnostic, for the
-  same reason.
-- **The 13 remaining reads hand back Vibo's GraphQL payload as it arrived.**
-  No rung is declared on them, so there is no slim option to ask for — and a
-  `view` passed anyway is dropped by zod without a warning, so a successful
-  call is not evidence the rung was honoured.
-
-That last group is not a neutral fact, so budget for it. **Five of those reads
-select media fields from Vibo and return them in full:**
-
-| Tool | What arrives per record |
-| --- | --- |
-| `vibo_get_section_songs` | `thumbnails { s180x180 original }` per song |
-| `vibo_list_song_ideas_songs` | `thumbnails { s180x180 original }` per song |
-| `vibo_list_event_users` | `imageUrl` per person |
-| `vibo_list_notifications` | `imageUrl` per notification |
-| `vibo_get_me` | `imageUrl` |
-
-`vibo_get_section_songs` is the one to watch: it returns the same catalog's
-song records that `vibo_search_songs` returns, carrying the same per-track
-cover art — but with no rung to drop it. Page it with `limit` rather than
-reaching for a `view` that is not there.
+- **`vibo_healthcheck`** answers with a connectivity/auth diagnostic. It runs
+  the same `GET_ME` document as `vibo_get_me` and still takes no rung, because
+  it never returns Vibo's user object — it builds `{ok, userId, email}` here.
+  A `view` on it would be a parameter that changes nothing.
+- **The 8 remaining reads hand back Vibo's GraphQL payload as it arrived**, and
+  their documents select no media, so there is nothing for a rung to remove.
+
+A `view` passed to a tool that does not declare one is dropped by zod without a
+warning, so a successful call is never evidence the rung was honoured. Check
+the table above rather than assuming.
 
 ## Typical flow