@cyanheads/musicbrainz-mcp-server 0.2.0 → 0.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (79) hide show
  1. package/AGENTS.md +44 -13
  2. package/CLAUDE.md +44 -13
  3. package/Dockerfile +6 -3
  4. package/README.md +79 -125
  5. package/changelog/0.2.x/0.2.1.md +32 -0
  6. package/changelog/0.3.x/0.3.0.md +33 -0
  7. package/dist/config/server-config.d.ts +1 -0
  8. package/dist/config/server-config.d.ts.map +1 -1
  9. package/dist/config/server-config.js +5 -0
  10. package/dist/config/server-config.js.map +1 -1
  11. package/dist/index.js +2 -1
  12. package/dist/index.js.map +1 -1
  13. package/dist/mcp-server/resources/definitions/entity.resource.d.ts.map +1 -1
  14. package/dist/mcp-server/resources/definitions/entity.resource.js +18 -6
  15. package/dist/mcp-server/resources/definitions/entity.resource.js.map +1 -1
  16. package/dist/mcp-server/tools/definitions/_pagination.d.ts +12 -0
  17. package/dist/mcp-server/tools/definitions/_pagination.d.ts.map +1 -0
  18. package/dist/mcp-server/tools/definitions/_pagination.js +52 -0
  19. package/dist/mcp-server/tools/definitions/_pagination.js.map +1 -0
  20. package/dist/mcp-server/tools/definitions/_shared.d.ts +2 -0
  21. package/dist/mcp-server/tools/definitions/_shared.d.ts.map +1 -1
  22. package/dist/mcp-server/tools/definitions/_shared.js +22 -6
  23. package/dist/mcp-server/tools/definitions/_shared.js.map +1 -1
  24. package/dist/mcp-server/tools/definitions/browse-entities.tool.d.ts +15 -3
  25. package/dist/mcp-server/tools/definitions/browse-entities.tool.d.ts.map +1 -1
  26. package/dist/mcp-server/tools/definitions/browse-entities.tool.js +128 -31
  27. package/dist/mcp-server/tools/definitions/browse-entities.tool.js.map +1 -1
  28. package/dist/mcp-server/tools/definitions/get-artist.tool.d.ts +13 -0
  29. package/dist/mcp-server/tools/definitions/get-artist.tool.d.ts.map +1 -1
  30. package/dist/mcp-server/tools/definitions/get-artist.tool.js +53 -1
  31. package/dist/mcp-server/tools/definitions/get-artist.tool.js.map +1 -1
  32. package/dist/mcp-server/tools/definitions/get-cover-art.tool.d.ts +7 -0
  33. package/dist/mcp-server/tools/definitions/get-cover-art.tool.d.ts.map +1 -1
  34. package/dist/mcp-server/tools/definitions/get-cover-art.tool.js +45 -8
  35. package/dist/mcp-server/tools/definitions/get-cover-art.tool.js.map +1 -1
  36. package/dist/mcp-server/tools/definitions/get-label.tool.d.ts +15 -0
  37. package/dist/mcp-server/tools/definitions/get-label.tool.d.ts.map +1 -1
  38. package/dist/mcp-server/tools/definitions/get-label.tool.js +28 -4
  39. package/dist/mcp-server/tools/definitions/get-label.tool.js.map +1 -1
  40. package/dist/mcp-server/tools/definitions/get-recording.tool.d.ts +13 -0
  41. package/dist/mcp-server/tools/definitions/get-recording.tool.d.ts.map +1 -1
  42. package/dist/mcp-server/tools/definitions/get-recording.tool.js +27 -6
  43. package/dist/mcp-server/tools/definitions/get-recording.tool.js.map +1 -1
  44. package/dist/mcp-server/tools/definitions/get-release-group.tool.d.ts +4 -0
  45. package/dist/mcp-server/tools/definitions/get-release-group.tool.d.ts.map +1 -1
  46. package/dist/mcp-server/tools/definitions/get-release-group.tool.js +9 -3
  47. package/dist/mcp-server/tools/definitions/get-release-group.tool.js.map +1 -1
  48. package/dist/mcp-server/tools/definitions/get-release.tool.d.ts +24 -3
  49. package/dist/mcp-server/tools/definitions/get-release.tool.d.ts.map +1 -1
  50. package/dist/mcp-server/tools/definitions/get-release.tool.js +69 -8
  51. package/dist/mcp-server/tools/definitions/get-release.tool.js.map +1 -1
  52. package/dist/mcp-server/tools/definitions/get-work.tool.d.ts +8 -2
  53. package/dist/mcp-server/tools/definitions/get-work.tool.d.ts.map +1 -1
  54. package/dist/mcp-server/tools/definitions/get-work.tool.js +33 -5
  55. package/dist/mcp-server/tools/definitions/get-work.tool.js.map +1 -1
  56. package/dist/mcp-server/tools/definitions/index.d.ts +152 -53
  57. package/dist/mcp-server/tools/definitions/index.d.ts.map +1 -1
  58. package/dist/mcp-server/tools/definitions/lookup-identifier.tool.d.ts +2 -2
  59. package/dist/mcp-server/tools/definitions/lookup-identifier.tool.d.ts.map +1 -1
  60. package/dist/mcp-server/tools/definitions/lookup-identifier.tool.js +26 -7
  61. package/dist/mcp-server/tools/definitions/lookup-identifier.tool.js.map +1 -1
  62. package/dist/mcp-server/tools/definitions/search-entities.tool.d.ts +9 -1
  63. package/dist/mcp-server/tools/definitions/search-entities.tool.d.ts.map +1 -1
  64. package/dist/mcp-server/tools/definitions/search-entities.tool.js +44 -14
  65. package/dist/mcp-server/tools/definitions/search-entities.tool.js.map +1 -1
  66. package/dist/services/musicbrainz/musicbrainz-service.d.ts +12 -3
  67. package/dist/services/musicbrainz/musicbrainz-service.d.ts.map +1 -1
  68. package/dist/services/musicbrainz/musicbrainz-service.js +22 -4
  69. package/dist/services/musicbrainz/musicbrainz-service.js.map +1 -1
  70. package/dist/services/musicbrainz/release-appearances.d.ts +16 -0
  71. package/dist/services/musicbrainz/release-appearances.d.ts.map +1 -0
  72. package/dist/services/musicbrainz/release-appearances.js +15 -0
  73. package/dist/services/musicbrainz/release-appearances.js.map +1 -0
  74. package/dist/services/musicbrainz/types.d.ts +13 -4
  75. package/dist/services/musicbrainz/types.d.ts.map +1 -1
  76. package/package.json +10 -9
  77. package/server.json +17 -3
  78. package/skills/musicbrainz-guide/SKILL.md +69 -0
  79. package/skills/musicbrainz-guide/references/query-syntax.md +23 -0
@@ -0,0 +1,52 @@
1
+ /**
2
+ * @fileoverview Shared search/browse page limits and truthful continuation notices.
3
+ * @module mcp-server/tools/definitions/_pagination
4
+ */
5
+ import { z } from '@cyanheads/mcp-ts-core';
6
+ import { parseConfig } from '@cyanheads/mcp-ts-core/config';
7
+ import { createCounter } from '@cyanheads/mcp-ts-core/utils';
8
+ import { getServerConfig } from '../../../config/server-config.js';
9
+ const clamped = createCounter('musicbrainz.limit.clamped', 'Oversized page limits clamped to the MusicBrainz maximum', '{calls}');
10
+ /** Resolve the switch after core loads .env, when the schema is first inspected. */
11
+ export const PageLimit = z
12
+ .lazy(() => {
13
+ parseConfig();
14
+ const limit = z.number().int().min(1);
15
+ return getServerConfig().clampOversizedLimits ? limit : limit.max(100);
16
+ })
17
+ .default(25)
18
+ .describe('Positive integer page size (default 25); values above 100 are clamped to 100 with a notice. With MUSICBRAINZ_CLAMP_OVERSIZED_LIMITS=off, maximum 100 is enforced.');
19
+ /** Record the clamp once before requesting the applied page. */
20
+ export function applyPageLimit(requested, toolName, ctx) {
21
+ const applied = Math.min(requested, 100);
22
+ if (requested > applied) {
23
+ ctx.log.info('MusicBrainz page limit clamped', { tool: toolName, requested, applied });
24
+ clamped.add(1, { tool: toolName });
25
+ }
26
+ return applied;
27
+ }
28
+ /** Compose one notice; an empty upstream page never supplies a nonadvancing offset. */
29
+ export function pageNotice(total, offset, shown, requested, applied, emptyNotice, searchLimit) {
30
+ const notices = [];
31
+ if (requested > applied)
32
+ notices.push(`Requested limit ${requested} was clamped to ${applied}.`);
33
+ if (searchLimit !== undefined && searchLimit < applied) {
34
+ notices.push(`The search window reduced this page limit to ${searchLimit} (500 matches maximum).`);
35
+ }
36
+ if (total === 0)
37
+ notices.push(emptyNotice);
38
+ else if (shown === 0) {
39
+ notices.push(offset >= total
40
+ ? `This page is exhausted: offset=${offset} is at or beyond the total of ${total}. Request a lower offset to retrieve matches.`
41
+ : `MusicBrainz returned an empty page at offset=${offset} despite reporting ${total} total entities. Retry later or verify the query; no advancing continuation offset is available.`);
42
+ }
43
+ else if (searchLimit !== undefined && offset + shown >= 500 && offset + shown < total) {
44
+ notices.push('The 500-match search window is exhausted. Narrow the query or use musicbrainz_browse_entities for complete linked sets.');
45
+ }
46
+ else if (offset + shown < total) {
47
+ const remaining = total - offset - shown;
48
+ notices.push(`${remaining} more entities remain. Call again with offset=${offset + shown} to continue paging.`);
49
+ }
50
+ return notices.length ? notices.join(' ') : undefined;
51
+ }
52
+ //# sourceMappingURL=_pagination.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"_pagination.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/_pagination.ts"],"names":[],"mappings":"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"}
@@ -59,6 +59,8 @@ export declare const RelationSchema: z.ZodObject<{
59
59
  targetType: z.ZodString;
60
60
  targetId: z.ZodOptional<z.ZodString>;
61
61
  targetName: z.ZodOptional<z.ZodString>;
62
+ targetDisambiguation: z.ZodOptional<z.ZodString>;
63
+ orderingKey: z.ZodOptional<z.ZodNumber>;
62
64
  begin: z.ZodOptional<z.ZodString>;
63
65
  end: z.ZodOptional<z.ZodString>;
64
66
  }, z.core.$strip>;
@@ -1 +1 @@
1
- {"version":3,"file":"_shared.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/_shared.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"_shared.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/_shared.ts"],"names":[],"mappings":"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"}
@@ -109,6 +109,14 @@ export const RelationSchema = z
109
109
  .string()
110
110
  .optional()
111
111
  .describe('Name/title of the related entity. Omitted when absent.'),
112
+ targetDisambiguation: z
113
+ .string()
114
+ .optional()
115
+ .describe('Qualifier distinguishing the related entity from namesakes. Omitted when absent.'),
116
+ orderingKey: z
117
+ .number()
118
+ .optional()
119
+ .describe('Upstream relationship sequence key, including zero. Omitted when unknown; array order is preserved.'),
112
120
  begin: z.string().optional().describe('Relationship start date. Omitted when absent.'),
113
121
  end: z.string().optional().describe('Relationship end date. Omitted when absent.'),
114
122
  })
@@ -146,7 +154,7 @@ export function normalizeArtistCredits(credits) {
146
154
  const artistId = c.artist?.id;
147
155
  if (!artistId)
148
156
  continue;
149
- const joinPhrase = c.joinphrase?.trim();
157
+ const joinPhrase = c.joinphrase;
150
158
  out.push({
151
159
  name: c.name ?? c.artist?.name ?? '',
152
160
  artistId,
@@ -158,7 +166,7 @@ export function normalizeArtistCredits(credits) {
158
166
  }
159
167
  /** Render an artist-credit array to its display string, stitching join phrases. */
160
168
  export function artistCreditString(credits) {
161
- return credits.map((c) => `${c.artistName}${c.joinPhrase ?? ''}`).join('') || 'Unknown artist';
169
+ return credits.map((c) => `${c.name}${c.joinPhrase ?? ''}`).join('') || 'Unknown artist';
162
170
  }
163
171
  /**
164
172
  * Render the artist-credit array as a detail block surfacing every sub-field
@@ -170,8 +178,8 @@ export function renderArtistCredits(credits) {
170
178
  return [];
171
179
  const lines = ['', '### Artist credit'];
172
180
  for (const c of credits) {
173
- const credited = c.name && c.name !== c.artistName ? ` (credited as "${safeText(c.name)}")` : '';
174
- const join = c.joinPhrase ? ` + join "${safeText(c.joinPhrase)}"` : '';
181
+ const credited = c.name && c.name !== c.artistName ? ` (credited as ${safeText(`"${c.name}"`)})` : '';
182
+ const join = c.joinPhrase ? ` + join ${safeText(`"${c.joinPhrase}"`)}` : '';
175
183
  lines.push(`- ${safeText(c.artistName)}${credited} — ${c.artistId}${join}`);
176
184
  }
177
185
  return lines;
@@ -217,21 +225,25 @@ function relationTarget(rel) {
217
225
  return {
218
226
  ...(rel.artist?.id && { id: rel.artist.id }),
219
227
  ...(rel.artist?.name && { name: rel.artist.name }),
228
+ ...(rel.artist?.disambiguation && { disambiguation: rel.artist.disambiguation }),
220
229
  };
221
230
  case 'work':
222
231
  return {
223
232
  ...(rel.work?.id && { id: rel.work.id }),
224
233
  ...(rel.work?.title && { name: rel.work.title }),
234
+ ...(rel.work?.disambiguation && { disambiguation: rel.work.disambiguation }),
225
235
  };
226
236
  case 'recording':
227
237
  return {
228
238
  ...(rel.recording?.id && { id: rel.recording.id }),
229
239
  ...(rel.recording?.title && { name: rel.recording.title }),
240
+ ...(rel.recording?.disambiguation && { disambiguation: rel.recording.disambiguation }),
230
241
  };
231
242
  case 'label':
232
243
  return {
233
244
  ...(rel.label?.id && { id: rel.label.id }),
234
245
  ...(rel.label?.name && { name: rel.label.name }),
246
+ ...(rel.label?.disambiguation && { disambiguation: rel.label.disambiguation }),
235
247
  };
236
248
  default:
237
249
  return {};
@@ -264,6 +276,8 @@ export function normalizeRelations(relations) {
264
276
  targetType: rel['target-type'] ?? 'unknown',
265
277
  ...(target.id ? { targetId: target.id } : {}),
266
278
  ...(target.name ? { targetName: target.name } : {}),
279
+ ...(target.disambiguation ? { targetDisambiguation: target.disambiguation } : {}),
280
+ ...(typeof rel['ordering-key'] === 'number' ? { orderingKey: rel['ordering-key'] } : {}),
267
281
  ...(rel.begin ? { begin: rel.begin } : {}),
268
282
  ...(rel.end ? { end: rel.end } : {}),
269
283
  });
@@ -324,7 +338,9 @@ export function renderRelationships(rels) {
324
338
  const target = safeText(r.targetName ?? r.targetId ?? r.targetType);
325
339
  const dir = r.direction ? ` ${r.direction}` : '';
326
340
  const dates = r.begin || r.end ? ` [${r.begin ?? ''}${r.end ? `–${r.end}` : ''}]` : '';
327
- lines.push(`- **${safeText(r.type)}**${attrs}${dir} → ${r.targetType}: ${target}${r.targetId ? ` (${r.targetId})` : ''}${dates}`);
341
+ const qualifier = r.targetDisambiguation ? ` — ${safeText(r.targetDisambiguation)}` : '';
342
+ const ordering = typeof r.orderingKey === 'number' ? ` [ordering key: ${r.orderingKey}]` : '';
343
+ lines.push(`- **${safeText(r.type)}**${attrs}${dir} → ${r.targetType}: ${target}${r.targetId ? ` (${r.targetId})` : ''}${qualifier}${dates}${ordering}`);
328
344
  }
329
345
  return lines;
330
346
  }
@@ -349,7 +365,7 @@ export function renderAliases(aliases) {
349
365
  a.type ? safeText(a.type) : null,
350
366
  a.locale ? safeText(a.locale) : null,
351
367
  a.sortName && a.sortName !== a.name ? `sort: ${safeText(a.sortName)}` : null,
352
- a.primary ? 'primary' : null,
368
+ typeof a.primary === 'boolean' ? `primary: ${a.primary ? 'yes' : 'no'}` : null,
353
369
  ]
354
370
  .filter(Boolean)
355
371
  .join(', ');
@@ -1 +1 @@
1
- {"version":3,"file":"_shared.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/_shared.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"_shared.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/_shared.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAC3C,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AAC3E,OAAO,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAU9D;;;;;;;;GAQG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAc;IAC9C,IAAI,CAAC,CAAC,KAAK,YAAY,QAAQ,CAAC;QAAE,OAAO,IAAI,CAAC;IAC9C,IAAI,KAAK,CAAC,IAAI,KAAK,gBAAgB,CAAC,eAAe;QAAE,OAAO,cAAc,CAAC;IAC3E,IAAI,KAAK,CAAC,IAAI,KAAK,gBAAgB,CAAC,QAAQ;QAAE,OAAO,kBAAkB,CAAC;IACxE,OAAO,IAAI,CAAC;AACd,CAAC;AAED,6DAA6D;AAC7D,MAAM,CAAC,MAAM,YAAY,GAAG,sCAAsC,CAAC;AAEnE,4FAA4F;AAC5F,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,YAAY,EAAE,CAAC,CAAC;AAEpE,iFAAiF;AAEjF,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,oDAAoD,CAAC,CAAC;AAEnG,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC;KAChC,MAAM,CAAC;IACN,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,+DAA+D,CAAC;IAC1F,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gEAAgE,CAAC;IAC/F,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,wBAAwB,CAAC;IACzD,UAAU,EAAE,CAAC;SACV,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,sFAAsF,CACvF;CACJ,CAAC;KACD,QAAQ,CAAC,8CAA8C,CAAC,CAAC;AAE5D,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC;KAC5B,MAAM,CAAC;IACN,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,kEAAkE,CAAC;IAC/E,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,iCAAiC,CAAC;IACtE,KAAK,EAAE,CAAC;SACL,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,QAAQ,CAAC,gFAAgF,CAAC;CAC9F,CAAC;KACD,QAAQ,CAAC,6EAA6E,CAAC,CAAC;AAE3F,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC;KACvB,MAAM,CAAC;IACN,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,oBAAoB,CAAC;IAC/C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,oCAAoC,CAAC;CACjE,CAAC;KACD,QAAQ,CAAC,gDAAgD,CAAC,CAAC;AAE9D,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC;KACzB,MAAM,CAAC;IACN,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,aAAa,CAAC;IACxC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kDAAkD,CAAC;IAC5F,IAAI,EAAE,CAAC;SACJ,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,qEAAqE,CAAC;IAClF,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kDAAkD,CAAC;IAC1F,OAAO,EAAE,CAAC;SACP,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,QAAQ,CAAC,wEAAwE,CAAC;CACtF,CAAC;KACD,QAAQ,CAAC,mCAAmC,CAAC,CAAC;AAEjD,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC;KAC5B,MAAM,CAAC;IACN,IAAI,EAAE,CAAC;SACJ,MAAM,EAAE;SACR,QAAQ,CAAC,iFAAiF,CAAC;IAC9F,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,uEAAuE,CAAC;IACpF,UAAU,EAAE,CAAC;SACV,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;SACjB,QAAQ,EAAE;SACV,QAAQ,CAAC,4EAA4E,CAAC;IACzF,UAAU,EAAE,CAAC;SACV,MAAM,EAAE;SACR,QAAQ,CAAC,iFAAiF,CAAC;IAC9F,QAAQ,EAAE,CAAC;SACR,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,yFAAyF,CAC1F;IACH,UAAU,EAAE,CAAC;SACV,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,wDAAwD,CAAC;IACrE,oBAAoB,EAAE,CAAC;SACpB,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,kFAAkF,CAAC;IAC/F,WAAW,EAAE,CAAC;SACX,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,qGAAqG,CACtG;IACH,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,+CAA+C,CAAC;IACtF,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,6CAA6C,CAAC;CACnF,CAAC;KACD,QAAQ,CAAC,oFAAoF,CAAC,CAAC;AAElG,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC;KAChC,MAAM,CAAC;IACN,IAAI,EAAE,CAAC;SACJ,MAAM,EAAE;SACR,QAAQ,CAAC,2EAA2E,CAAC;IACxF,QAAQ,EAAE,CAAC;SACR,MAAM,EAAE;SACR,QAAQ,CACP,uFAAuF,CACxF;CACJ,CAAC;KACD,QAAQ,CACP,8FAA8F,CAC/F,CAAC;AAEJ,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC;KAChC,MAAM,CAAC;IACN,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,gEAAgE,CAAC;IAC9F,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mDAAmD,CAAC;IAC1F,KAAK,EAAE,CAAC;SACL,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,QAAQ,CAAC,gEAAgE,CAAC;IAC7E,IAAI,EAAE,CAAC;SACJ,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,QAAQ,CAAC,+DAA+D,CAAC;CAC7E,CAAC;KACD,QAAQ,CACP,8LAA8L,CAC/L,CAAC;AAEJ,iFAAiF;AAEjF,MAAM,UAAU,sBAAsB,CACpC,OAAsC;IAEtC,IAAI,CAAC,OAAO,EAAE,MAAM;QAAE,OAAO,EAAE,CAAC;IAChC,MAAM,GAAG,GAAyC,EAAE,CAAC;IACrD,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,MAAM,QAAQ,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;QAC9B,IAAI,CAAC,QAAQ;YAAE,SAAS;QACxB,MAAM,UAAU,GAAG,CAAC,CAAC,UAAU,CAAC;QAChC,GAAG,CAAC,IAAI,CAAC;YACP,IAAI,EAAE,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,MAAM,EAAE,IAAI,IAAI,EAAE;YACpC,QAAQ;YACR,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,IAAI,IAAI,CAAC,CAAC,IAAI,IAAI,EAAE;YAC1C,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACtC,CAAC,CAAC;IACL,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,kBAAkB,CAAC,OAA6C;IAC9E,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,UAAU,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,gBAAgB,CAAC;AAC3F,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAA6C;IAC/E,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACpC,MAAM,KAAK,GAAG,CAAC,EAAE,EAAE,mBAAmB,CAAC,CAAC;IACxC,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,MAAM,QAAQ,GACZ,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,iBAAiB,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QACvF,MAAM,IAAI,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,WAAW,QAAQ,CAAC,IAAI,CAAC,CAAC,UAAU,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5E,KAAK,CAAC,IAAI,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,QAAQ,MAAM,CAAC,CAAC,QAAQ,GAAG,IAAI,EAAE,CAAC,CAAC;IAC9E,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,IAAoC;IAEpC,IAAI,CAAC,IAAI;QAAE,OAAO;IAClB,MAAM,MAAM,GAAmC;QAC7C,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5C,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACtC,GAAG,CAAC,OAAO,IAAI,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAClE,CAAC;IACF,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;AAC7D,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,IAA0B;IACtD,IAAI,CAAC,IAAI,EAAE,MAAM;QAAE,OAAO,EAAE,CAAC;IAC7B,OAAO,IAAI;SACR,MAAM,CAAC,CAAC,CAAC,EAAkC,EAAE,CAAC,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;SAC9F,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AACtF,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,OAA+B;IAC9D,IAAI,CAAC,OAAO,EAAE,MAAM;QAAE,OAAO,EAAE,CAAC;IAChC,MAAM,GAAG,GAAkC,EAAE,CAAC;IAC9C,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,IAAI,CAAC,CAAC,CAAC,IAAI;YAAE,SAAS;QACtB,GAAG,CAAC,IAAI,CAAC;YACP,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,GAAG,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACvD,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACnC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACzC,GAAG,CAAC,OAAO,CAAC,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAClE,CAAC,CAAC;IACL,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,oEAAoE;AACpE,SAAS,cAAc,CAAC,GAAgB;IACtC,QAAQ,GAAG,CAAC,aAAa,CAAC,EAAE,CAAC;QAC3B,KAAK,QAAQ;YACX,OAAO;gBACL,GAAG,CAAC,GAAG,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;gBAC5C,GAAG,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,IAAI,EAAE,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;gBAClD,GAAG,CAAC,GAAG,CAAC,MAAM,EAAE,cAAc,IAAI,EAAE,cAAc,EAAE,GAAG,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC;aACjF,CAAC;QACJ,KAAK,MAAM;YACT,OAAO;gBACL,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;gBACxC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,IAAI,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;gBAChD,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,cAAc,IAAI,EAAE,cAAc,EAAE,GAAG,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC;aAC7E,CAAC;QACJ,KAAK,WAAW;YACd,OAAO;gBACL,GAAG,CAAC,GAAG,CAAC,SAAS,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,GAAG,CAAC,SAAS,CAAC,EAAE,EAAE,CAAC;gBAClD,GAAG,CAAC,GAAG,CAAC,SAAS,EAAE,KAAK,IAAI,EAAE,IAAI,EAAE,GAAG,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;gBAC1D,GAAG,CAAC,GAAG,CAAC,SAAS,EAAE,cAAc,IAAI,EAAE,cAAc,EAAE,GAAG,CAAC,SAAS,CAAC,cAAc,EAAE,CAAC;aACvF,CAAC;QACJ,KAAK,OAAO;YACV,OAAO;gBACL,GAAG,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC;gBAC1C,GAAG,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,IAAI,EAAE,IAAI,EAAE,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;gBAChD,GAAG,CAAC,GAAG,CAAC,KAAK,EAAE,cAAc,IAAI,EAAE,cAAc,EAAE,GAAG,CAAC,KAAK,CAAC,cAAc,EAAE,CAAC;aAC/E,CAAC;QACJ;YACE,OAAO,EAAE,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,SAAoC;IAIrE,MAAM,aAAa,GAAqC,EAAE,CAAC;IAC3D,MAAM,aAAa,GAAyC,EAAE,CAAC;IAC/D,IAAI,CAAC,SAAS,EAAE,MAAM;QAAE,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,CAAC;IAEhE,KAAK,MAAM,GAAG,IAAI,SAAS,EAAE,CAAC;QAC5B,IAAI,GAAG,CAAC,aAAa,CAAC,KAAK,KAAK,EAAE,CAAC;YACjC,MAAM,QAAQ,GAAG,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC;YACnC,IAAI,QAAQ;gBAAE,aAAa,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,IAAI,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;YACxE,SAAS;QACX,CAAC;QACD,MAAM,MAAM,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC;QACnC,MAAM,UAAU,GAAG,GAAG,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAC/D,aAAa,CAAC,IAAI,CAAC;YACjB,IAAI,EAAE,GAAG,CAAC,IAAI,IAAI,SAAS;YAC3B,GAAG,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,GAAG,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACtD,GAAG,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC7C,UAAU,EAAE,GAAG,CAAC,aAAa,CAAC,IAAI,SAAS;YAC3C,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC7C,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACnD,GAAG,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,oBAAoB,EAAE,MAAM,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACjF,GAAG,CAAC,OAAO,GAAG,CAAC,cAAc,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,GAAG,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACxF,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC1C,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACrC,CAAC,CAAC;IACL,CAAC;IACD,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,IAAiC;IAEjC,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;IACpC,OAAO;QACL,MAAM,EAAE,IAAI,CAAC,OAAO,KAAK,IAAI,IAAI,CAAC,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ,IAAI,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC;QACnF,GAAG,CAAC,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAChE,GAAG,CAAC,OAAO,IAAI,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACjE,GAAG,CAAC,OAAO,IAAI,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC/D,CAAC;AACJ,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,cAAc,CAAC,EAA6B;IAC1D,IAAI,OAAO,EAAE,KAAK,QAAQ,IAAI,EAAE,IAAI,CAAC;QAAE,OAAO;IAC9C,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;IAC3C,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,GAAG,EAAE,CAAC,CAAC;IAC9C,MAAM,OAAO,GAAG,YAAY,GAAG,EAAE,CAAC;IAClC,OAAO,GAAG,OAAO,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;AAC7D,CAAC;AAED,iFAAiF;AACjF,EAAE;AACF,iFAAiF;AACjF,8EAA8E;AAC9E,kFAAkF;AAElF;;;;;;GAMG;AACH,MAAM,yBAAyB,GAAG,yBAAyB,CAAC;AAC5D,MAAM,UAAU,QAAQ,CAAC,KAAa;IACpC,OAAO,KAAK;SACT,OAAO,CAAC,yBAAyB,EAAE,GAAG,CAAC;SACvC,IAAI,EAAE;SACN,OAAO,CAAC,cAAc,EAAE,MAAM,CAAC;SAC/B,OAAO,CAAC,wCAAwC,EAAE,KAAK,CAAC;SACxD,OAAO,CAAC,mBAAmB,EAAE,KAAK,CAAC;SACnC,OAAO,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;AAClC,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,OAAO,CAAC,KAAa;IACnC,OAAO,KAAK,CAAC,OAAO,CAAC,yBAAyB,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;AAC9D,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,IAAsC;IACxE,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACjC,MAAM,KAAK,GAAG,CAAC,EAAE,EAAE,mBAAmB,CAAC,CAAC;IACxC,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;QACrB,MAAM,KAAK,GAAG,CAAC,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QACxF,MAAM,MAAM,GAAG,QAAQ,CAAC,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,UAAU,CAAC,CAAC;QACpE,MAAM,GAAG,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACjD,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,IAAI,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QACvF,MAAM,SAAS,GAAG,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,MAAM,QAAQ,CAAC,CAAC,CAAC,oBAAoB,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACzF,MAAM,QAAQ,GAAG,OAAO,CAAC,CAAC,WAAW,KAAK,QAAQ,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9F,KAAK,CAAC,IAAI,CACR,OAAO,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,KAAK,GAAG,GAAG,MAAM,CAAC,CAAC,UAAU,KAAK,MAAM,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,SAAS,GAAG,KAAK,GAAG,QAAQ,EAAE,CAC7I,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,KAA2C;IAC7E,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAClC,MAAM,KAAK,GAAG,CAAC,EAAE,EAAE,oBAAoB,CAAC,CAAC;IACzC,KAAK,MAAM,CAAC,IAAI,KAAK;QAAE,KAAK,CAAC,IAAI,CAAC,OAAO,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IACvF,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,IAAiC;IAC1D,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO;IAC9B,OAAO,oBAAoB,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;AAC9F,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,OAAsC;IAClE,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO;IACjC,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QAC9B,MAAM,IAAI,GAAG;YACX,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI;YAChC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI;YACpC,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI;YAC5E,OAAO,CAAC,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI;SAC/E;aACE,MAAM,CAAC,OAAO,CAAC;aACf,IAAI,CAAC,IAAI,CAAC,CAAC;QACd,OAAO,GAAG,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;IAC1D,CAAC,CAAC,CAAC;IACH,OAAO,gBAAgB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,cAAc,CAC5B,IAAgD;IAEhD,IAAI,CAAC,IAAI;QAAE,OAAO;IAClB,MAAM,SAAS,GAAG,OAAO,IAAI,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,YAAY,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IAClG,IAAI,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,GAAG;QAAE,OAAO,kBAAkB,IAAI,CAAC,KAAK,MAAM,IAAI,CAAC,GAAG,GAAG,SAAS,EAAE,CAAC;IAC5F,IAAI,IAAI,CAAC,KAAK;QACZ,OAAO,kBAAkB,IAAI,CAAC,KAAK,MAAM,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,GAAG,SAAS,EAAE,CAAC;IAC1F,IAAI,IAAI,CAAC,GAAG;QAAE,OAAO,wBAAwB,IAAI,CAAC,GAAG,GAAG,SAAS,EAAE,CAAC;IACpE,IAAI,OAAO,IAAI,CAAC,KAAK,KAAK,SAAS;QAAE,OAAO,yBAAyB,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACjG,OAAO;AACT,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,kBAAkB,CAAC,IAAwC;IACzE,MAAM,KAAK,GAAG;QACZ,WAAW,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE;QACvC,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,UAAU,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI;QAC9D,OAAO,IAAI,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,UAAU,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI;QAC9E,OAAO,IAAI,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI;KAC5E,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAClB,OAAO,kBAAkB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;AAC9C,CAAC"}
@@ -18,6 +18,7 @@ export declare const browseEntitiesTool: import("@cyanheads/mcp-ts-core").ToolDe
18
18
  }>;
19
19
  link: z.ZodObject<{
20
20
  artist: z.ZodOptional<z.ZodString>;
21
+ track_artist: z.ZodOptional<z.ZodString>;
21
22
  label: z.ZodOptional<z.ZodString>;
22
23
  'release-group': z.ZodOptional<z.ZodString>;
23
24
  release: z.ZodOptional<z.ZodString>;
@@ -27,7 +28,9 @@ export declare const browseEntitiesTool: import("@cyanheads/mcp-ts-core").ToolDe
27
28
  work: z.ZodOptional<z.ZodString>;
28
29
  area: z.ZodOptional<z.ZodString>;
29
30
  }, z.core.$catchall<z.ZodUnknown>>;
30
- limit: z.ZodDefault<z.ZodNumber>;
31
+ type: z.ZodOptional<z.ZodString>;
32
+ status: z.ZodOptional<z.ZodString>;
33
+ limit: z.ZodDefault<z.ZodLazy<z.ZodNumber>>;
31
34
  offset: z.ZodDefault<z.ZodNumber>;
32
35
  }, z.core.$strip>, z.ZodObject<{
33
36
  targetType: z.ZodString;
@@ -43,18 +46,27 @@ export declare const browseEntitiesTool: import("@cyanheads/mcp-ts-core").ToolDe
43
46
  date: z.ZodOptional<z.ZodString>;
44
47
  country: z.ZodOptional<z.ZodString>;
45
48
  length: z.ZodOptional<z.ZodString>;
49
+ secondaryTypes: z.ZodOptional<z.ZodArray<z.ZodString>>;
50
+ firstReleaseDate: z.ZodOptional<z.ZodString>;
46
51
  }, z.core.$strip>>;
47
52
  offset: z.ZodNumber;
53
+ type: z.ZodOptional<z.ZodString>;
54
+ status: z.ZodOptional<z.ZodString>;
48
55
  }, z.core.$strip>, readonly [{
56
+ readonly reason: "invalid_filter";
57
+ readonly code: JsonRpcErrorCode.ValidationError;
58
+ readonly when: "A nonempty type/status filter has an unknown token, an empty pipe-list member, or is unsupported for the target and parent.";
59
+ readonly recovery: "Use type only for release-group by artist or release by artist/label/recording/track_artist; use status only for release by artist/label/recording/release-group/track_artist. Separate valid tokens with | and omit unsupported filters. Types: album, single, ep, broadcast, other, audio drama, audiobook, compilation, demo, dj-mix, field recording, interview, live, mixtape/street, remix, soundtrack, spokenword. Statuses: official, promotion, bootleg, pseudo-release, withdrawn, cancelled.";
60
+ }, {
49
61
  readonly reason: "invalid_link";
50
62
  readonly code: JsonRpcErrorCode.ValidationError;
51
63
  readonly when: "A parent key is unknown, aliases collide, not exactly one nonempty parent is supplied, or the MBID/parent combination is invalid.";
52
- readonly recovery: "Provide exactly one parent key: artist, label, release-group, release, recording, work, or area. releaseGroup and release_group alias release-group; never combine aliases. Supply a 36-character hexadecimal UUID MBID valid for target_type.";
64
+ readonly recovery: "Provide exactly one parent key with a nonzero hexadecimal UUID MBID. Accepted parents by target: artist → area, recording, release, release-group, work; label → area, release; release-group → artist, release; release → area, artist, label, recording, release-group, track_artist; recording → artist, release, work; work → artist. releaseGroup and release_group alias release-group; never combine aliases. track_artist uses an artist MBID; verify it with musicbrainz_get_artist.";
53
65
  }, {
54
66
  readonly reason: "entity_not_found";
55
67
  readonly code: JsonRpcErrorCode.NotFound;
56
68
  readonly when: "The link MBID is well-formed but no such parent entity exists (HTTP 404).";
57
- readonly recovery: "No parent entity exists with that MBID. Verify the ID with the matching musicbrainz_get_* tool or musicbrainz_search_entities.";
69
+ readonly recovery: "No parent entity exists with that MBID. For area links, obtain areaId from musicbrainz_get_artist or musicbrainz_get_label for a known artist or label; these tools do not resolve arbitrary areas. For track_artist links, verify the artist with musicbrainz_get_artist or musicbrainz_search_entities. For other parents, verify the ID with the matching musicbrainz_get_* tool or musicbrainz_search_entities.";
58
70
  }], {
59
71
  readonly totalCount: z.ZodNumber;
60
72
  readonly truncated: z.ZodOptional<z.ZodBoolean>;
@@ -1 +1 @@
1
- {"version":3,"file":"browse-entities.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/browse-entities.tool.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAiHjE,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAwN7B,CAAC"}
1
+ {"version":3,"file":"browse-entities.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/browse-entities.tool.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAY,MAAM,+BAA+B,CAAC;AA+H3E,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA0U7B,CAAC"}
@@ -6,18 +6,19 @@
6
6
  * @module mcp-server/tools/definitions/browse-entities.tool
7
7
  */
8
8
  import { tool, z } from '@cyanheads/mcp-ts-core';
9
- import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
9
+ import { JsonRpcErrorCode, McpError } from '@cyanheads/mcp-ts-core/errors';
10
+ import { normalizeMbid } from '../../../services/musicbrainz/mbid.js';
10
11
  import { getMusicBrainzService, MusicBrainzService, } from '../../../services/musicbrainz/musicbrainz-service.js';
12
+ import { applyPageLimit, PageLimit, pageNotice } from './_pagination.js';
11
13
  import { artistCreditString, classifyMbidError, formatDuration, MbidInput, normalizeArtistCredits, safeText, } from './_shared.js';
12
14
  const TARGET_TYPES = ['artist', 'release-group', 'release', 'recording', 'work', 'label'];
13
- /** Maps the `{type}-count` envelope key for each entity type. */
14
- const COUNT_KEY = {
15
- artist: 'artist-count',
16
- 'release-group': 'release-group-count',
17
- release: 'release-count',
18
- recording: 'recording-count',
19
- work: 'work-count',
20
- label: 'label-count',
15
+ const PARENTS = {
16
+ artist: ['area', 'recording', 'release', 'release-group', 'work'],
17
+ label: ['area', 'release'],
18
+ 'release-group': ['artist', 'release'],
19
+ release: ['area', 'artist', 'label', 'recording', 'release-group', 'track_artist'],
20
+ recording: ['artist', 'release', 'work'],
21
+ work: ['artist'],
21
22
  };
22
23
  const EntityRefSchema = z
23
24
  .object({
@@ -44,6 +45,14 @@ const EntityRefSchema = z
44
45
  .string()
45
46
  .optional()
46
47
  .describe('Recording length as m:ss. Omitted when not a recording / unknown.'),
48
+ secondaryTypes: z
49
+ .array(z.string())
50
+ .optional()
51
+ .describe('Release-group secondary classifications in upstream order. Omitted when empty; absence does not establish a studio album.'),
52
+ firstReleaseDate: z
53
+ .string()
54
+ .optional()
55
+ .describe('Recording first-release date, possibly partial. Omitted when absent.'),
47
56
  })
48
57
  .describe('A lightweight reference to a linked entity.');
49
58
  function mapEntity(type, raw) {
@@ -71,6 +80,7 @@ function mapEntity(type, raw) {
71
80
  name: e.title ?? '',
72
81
  artistCredit: artistCreditString(normalizeArtistCredits(e['artist-credit'])),
73
82
  ...(length ? { length } : {}),
83
+ ...(e['first-release-date'] ? { firstReleaseDate: e['first-release-date'] } : {}),
74
84
  };
75
85
  }
76
86
  const e = raw;
@@ -84,6 +94,9 @@ function mapEntity(type, raw) {
84
94
  ...common,
85
95
  name: e.title ?? '',
86
96
  ...(subtype ? { type: subtype } : {}),
97
+ ...(isReleaseGroup && e['secondary-types']?.length
98
+ ? { secondaryTypes: e['secondary-types'] }
99
+ : {}),
87
100
  ...(status ? { status } : {}),
88
101
  artistCredit: artistCreditString(normalizeArtistCredits(e['artist-credit'])),
89
102
  ...(date ? { date } : {}),
@@ -92,20 +105,26 @@ function mapEntity(type, raw) {
92
105
  }
93
106
  export const browseEntitiesTool = tool('musicbrainz_browse_entities', {
94
107
  title: 'musicbrainz-mcp-server: browse entities',
95
- description: 'Paginate entities linked to one parent MBID: release-groups by artist; releases by artist, label, release-group, or recording; recordings by artist, work, or release; works by artist; artists/labels by area. Artist release-groups and release-group editions embed one upstream page in get_* lookups; use this tool for the complete entity set. Recording browse returns identities, not performance attributes/dates or ordered release tracks: use musicbrainz_get_recording for work relationships and musicbrainz_get_release for tracks. Provide exactly one valid parent link. offset pages to any depth; totalCount is the upstream entity total. Release rows carry status, other entity subtypes use type.',
108
+ description: 'Paginate entities linked to one parent MBID. Accepted parents by target: artist → area, recording, release, release-group, work; label → area, release; release-group → artist, release; release → area, artist, label, recording, release-group, track_artist; recording → artist, release, work; work → artist. track_artist enumerates releases crediting an artist on tracks but not at release level. Artist release-groups and release-group editions embed one upstream page in get_* lookups; use this tool for the complete entity set. Recording browse returns identities, not performance attributes/dates or ordered release tracks: use musicbrainz_get_recording for work relationships and musicbrainz_get_release for tracks. Provide exactly one valid parent link. offset pages to any depth; totalCount is the exact filtered upstream entity total. Optional type/status filters apply only on supported parent pairs; preserve applied filters on continuation. Release rows carry status, other entity subtypes use type; release-groups include secondaryTypes and recordings include firstReleaseDate when available.',
96
109
  annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: true },
97
110
  errors: [
111
+ {
112
+ reason: 'invalid_filter',
113
+ code: JsonRpcErrorCode.ValidationError,
114
+ when: 'A nonempty type/status filter has an unknown token, an empty pipe-list member, or is unsupported for the target and parent.',
115
+ recovery: 'Use type only for release-group by artist or release by artist/label/recording/track_artist; use status only for release by artist/label/recording/release-group/track_artist. Separate valid tokens with | and omit unsupported filters. Types: album, single, ep, broadcast, other, audio drama, audiobook, compilation, demo, dj-mix, field recording, interview, live, mixtape/street, remix, soundtrack, spokenword. Statuses: official, promotion, bootleg, pseudo-release, withdrawn, cancelled.',
116
+ },
98
117
  {
99
118
  reason: 'invalid_link',
100
119
  code: JsonRpcErrorCode.ValidationError,
101
120
  when: 'A parent key is unknown, aliases collide, not exactly one nonempty parent is supplied, or the MBID/parent combination is invalid.',
102
- recovery: 'Provide exactly one parent key: artist, label, release-group, release, recording, work, or area. releaseGroup and release_group alias release-group; never combine aliases. Supply a 36-character hexadecimal UUID MBID valid for target_type.',
121
+ recovery: 'Provide exactly one parent key with a nonzero hexadecimal UUID MBID. Accepted parents by target: artist → area, recording, release, release-group, work; label → area, release; release-group → artist, release; release → area, artist, label, recording, release-group, track_artist; recording → artist, release, work; work → artist. releaseGroup and release_group alias release-group; never combine aliases. track_artist uses an artist MBID; verify it with musicbrainz_get_artist.',
103
122
  },
104
123
  {
105
124
  reason: 'entity_not_found',
106
125
  code: JsonRpcErrorCode.NotFound,
107
126
  when: 'The link MBID is well-formed but no such parent entity exists (HTTP 404).',
108
- recovery: 'No parent entity exists with that MBID. Verify the ID with the matching musicbrainz_get_* tool or musicbrainz_search_entities.',
127
+ recovery: 'No parent entity exists with that MBID. For area links, obtain areaId from musicbrainz_get_artist or musicbrainz_get_label for a known artist or label; these tools do not resolve arbitrary areas. For track_artist links, verify the artist with musicbrainz_get_artist or musicbrainz_search_entities. For other parents, verify the ID with the matching musicbrainz_get_* tool or musicbrainz_search_entities.',
109
128
  },
110
129
  ],
111
130
  input: z.object({
@@ -113,18 +132,27 @@ export const browseEntitiesTool = tool('musicbrainz_browse_entities', {
113
132
  link: z
114
133
  .object({
115
134
  artist: MbidInput.optional().describe('Parent artist MBID (e.g. release-groups/recordings/releases by this artist).'),
135
+ track_artist: MbidInput.optional().describe('Artist MBID for release-only browse: releases crediting the artist on tracks but not at release level.'),
116
136
  label: MbidInput.optional().describe('Parent label MBID (releases on this label).'),
117
137
  'release-group': MbidInput.optional().describe('Parent release-group MBID (releases in this group).'),
118
- release: MbidInput.optional().describe('Parent release MBID (recording entities in this edition, not ordered tracks).'),
138
+ release: MbidInput.optional().describe('Parent release MBID (artists, labels, release-groups, or recording entities in this edition; recordings are not ordered tracks).'),
119
139
  releaseGroup: MbidInput.optional().describe('Alias for release-group; use only one spelling.'),
120
140
  release_group: MbidInput.optional().describe('Alias for release-group; use only one spelling.'),
121
- recording: MbidInput.optional().describe('Parent recording MBID (releases containing this recording).'),
122
- work: MbidInput.optional().describe('Parent work MBID (recordings of this work).'),
123
- area: MbidInput.optional().describe('Parent area MBID (artists/labels in this area).'),
141
+ recording: MbidInput.optional().describe('Parent recording MBID (artists or releases linked to this recording).'),
142
+ work: MbidInput.optional().describe('Parent work MBID (artists or recordings linked to this work).'),
143
+ area: MbidInput.optional().describe('Parent area MBID (artists, labels, or releases in this area).'),
124
144
  })
125
145
  .catchall(z.unknown())
126
146
  .describe('Exactly one parent MBID. The valid key depends on target_type (see the description).'),
127
- limit: z.number().int().min(1).max(100).default(25).describe('Page size (1–100).'),
147
+ type: z
148
+ .string()
149
+ .optional()
150
+ .describe('Pipe-separated release types: album, single, ep, broadcast, other, audio drama, audiobook, compilation, demo, dj-mix, field recording, interview, live, mixtape/street, remix, soundtrack, spokenword. Supported for release-group by artist and release by artist/label/recording/track_artist. Primary types union; primary and secondary categories intersect; release-group by artist requires all secondary types. Tokens are trimmed/lowercased; blank means absent.'),
151
+ status: z
152
+ .string()
153
+ .optional()
154
+ .describe('Pipe-separated statuses for release by artist/label/recording/release-group/track_artist: official, promotion, bootleg, pseudo-release, withdrawn, cancelled. Tokens are trimmed/lowercased and unioned; blank means absent.'),
155
+ limit: PageLimit,
128
156
  offset: z
129
157
  .number()
130
158
  .int()
@@ -136,10 +164,18 @@ export const browseEntitiesTool = tool('musicbrainz_browse_entities', {
136
164
  targetType: z.string().describe('The entity type that was enumerated.'),
137
165
  linkType: z
138
166
  .string()
139
- .describe('The parent link type used (artist, label, release-group, release, recording, work, or area).'),
167
+ .describe('The parent link type used (artist, track_artist, label, release-group, release, recording, work, or area).'),
140
168
  linkMbid: z.string().describe('The parent MBID that was browsed.'),
141
169
  entities: z.array(EntityRefSchema).describe('This page of linked entities, in upstream order.'),
142
170
  offset: z.number().describe('The offset used for this page.'),
171
+ type: z
172
+ .string()
173
+ .optional()
174
+ .describe('Canonical applied pipe-separated type filter; preserve on continuation.'),
175
+ status: z
176
+ .string()
177
+ .optional()
178
+ .describe('Canonical applied pipe-separated status filter; preserve on continuation.'),
143
179
  }),
144
180
  enrichment: {
145
181
  totalCount: z
@@ -167,6 +203,7 @@ export const browseEntitiesTool = tool('musicbrainz_browse_entities', {
167
203
  const service = getMusicBrainzService();
168
204
  const acceptedKeys = [
169
205
  'artist',
206
+ 'track_artist',
170
207
  'label',
171
208
  'release-group',
172
209
  'release',
@@ -193,15 +230,68 @@ export const browseEntitiesTool = tool('musicbrainz_browse_entities', {
193
230
  throw ctx.fail('invalid_link', `Provide exactly one link MBID — received ${linkEntries.length}.`);
194
231
  }
195
232
  const [linkType, suppliedMbid] = first;
196
- const linkMbid = suppliedMbid.trim().toLowerCase();
233
+ if (!PARENTS[input.target_type].includes(linkType)) {
234
+ throw ctx.fail('invalid_link', `Unsupported browse pair: ${input.target_type} by ${linkType}. Accepted parents for ${input.target_type}: ${PARENTS[input.target_type].join(', ')}.`);
235
+ }
236
+ const filters = {};
237
+ for (const field of ['type', 'status']) {
238
+ const supplied = input[field]?.trim();
239
+ if (!supplied)
240
+ continue;
241
+ const releaseParents = field === 'type'
242
+ ? ['artist', 'label', 'recording', 'track_artist']
243
+ : ['artist', 'label', 'recording', 'release-group', 'track_artist'];
244
+ const supported = (input.target_type === 'release' && releaseParents.includes(linkType)) ||
245
+ (field === 'type' && input.target_type === 'release-group' && linkType === 'artist');
246
+ if (!supported) {
247
+ throw ctx.fail('invalid_filter', `${field} is not supported for ${input.target_type} by ${linkType}; omit this filter.`);
248
+ }
249
+ const tokens = supplied.split('|').map((token) => token.trim().toLowerCase());
250
+ const vocabulary = field === 'type'
251
+ ? [
252
+ 'album',
253
+ 'single',
254
+ 'ep',
255
+ 'broadcast',
256
+ 'other',
257
+ 'audio drama',
258
+ 'audiobook',
259
+ 'compilation',
260
+ 'demo',
261
+ 'dj-mix',
262
+ 'field recording',
263
+ 'interview',
264
+ 'live',
265
+ 'mixtape/street',
266
+ 'remix',
267
+ 'soundtrack',
268
+ 'spokenword',
269
+ ]
270
+ : ['official', 'promotion', 'bootleg', 'pseudo-release', 'withdrawn', 'cancelled'];
271
+ if (tokens.some((token) => !vocabulary.includes(token))) {
272
+ throw ctx.fail('invalid_filter', `Invalid ${field} filter: use nonempty pipe-separated tokens from ${vocabulary.join(', ')}.`);
273
+ }
274
+ filters[field] = tokens.join('|');
275
+ }
276
+ let linkMbid;
277
+ try {
278
+ linkMbid = normalizeMbid(suppliedMbid);
279
+ }
280
+ catch (error) {
281
+ if (classifyMbidError(error) === 'invalid_mbid') {
282
+ throw ctx.fail('invalid_link', 'Malformed link MBID: supply a nonzero hyphenated hexadecimal UUID.');
283
+ }
284
+ throw error;
285
+ }
197
286
  let envelope;
287
+ const limit = applyPageLimit(input.limit, 'musicbrainz_browse_entities', ctx);
198
288
  try {
199
- envelope = await service.browse(input.target_type, { link: linkType, linkMbid, limit: input.limit, offset: input.offset }, ctx, { signal: ctx.signal });
289
+ envelope = await service.browse(input.target_type, { link: linkType, linkMbid, limit, offset: input.offset, ...filters }, ctx, { signal: ctx.signal });
200
290
  }
201
291
  catch (error) {
202
292
  const reason = classifyMbidError(error);
203
- if (reason === 'invalid_mbid') {
204
- throw ctx.fail('invalid_link', `Malformed link MBID "${linkMbid}".`);
293
+ if (error instanceof McpError && error.code === JsonRpcErrorCode.ValidationError) {
294
+ throw ctx.fail('invalid_link', `MusicBrainz rejected the browse query ${input.target_type} by ${linkType}; verify the parent type and MBID.`);
205
295
  }
206
296
  if (reason === 'entity_not_found') {
207
297
  throw ctx.fail('entity_not_found', `No ${linkType} exists with MBID ${linkMbid}.`);
@@ -211,23 +301,24 @@ export const browseEntitiesTool = tool('musicbrainz_browse_entities', {
211
301
  const key = MusicBrainzService.pluralKey(input.target_type);
212
302
  const rawEntities = (envelope[key] ?? []);
213
303
  const entities = rawEntities.map((e) => mapEntity(input.target_type, e));
214
- const totalCount = envelope[COUNT_KEY[input.target_type]];
215
- const total = typeof totalCount === 'number' ? totalCount : input.offset + entities.length;
304
+ const total = envelope[`${input.target_type}-count`];
216
305
  ctx.enrich.total(total);
217
306
  const remaining = total - (input.offset + entities.length);
218
- if (remaining > 0) {
219
- ctx.enrich.truncated({ shown: entities.length, cap: input.limit });
220
- ctx.enrich.notice(`${remaining} more linked entit${remaining === 1 ? 'y' : 'ies'} remain. Call again with offset=${input.offset + entities.length} to continue paging.`);
221
- }
222
- else if (entities.length === 0) {
223
- ctx.enrich.notice(`No ${input.target_type} entities are linked to ${linkType} ${linkMbid}.`);
224
- }
307
+ if (remaining > 0)
308
+ ctx.enrich.truncated({ shown: entities.length, cap: limit });
309
+ const notice = pageNotice(total, input.offset, entities.length, input.limit, limit, `No ${input.target_type} entities are linked to ${linkType} ${linkMbid}.`);
310
+ const filterNotice = Object.entries(filters)
311
+ .map(([key, value]) => `${key}=${value}`)
312
+ .join('; ');
313
+ if (notice)
314
+ ctx.enrich.notice(filterNotice ? `${notice} Preserve applied filters: ${filterNotice}.` : notice);
225
315
  return {
226
316
  targetType: input.target_type,
227
317
  linkType,
228
318
  linkMbid,
229
319
  entities,
230
320
  offset: input.offset,
321
+ ...filters,
231
322
  };
232
323
  },
233
324
  format: (result) => {
@@ -235,6 +326,10 @@ export const browseEntitiesTool = tool('musicbrainz_browse_entities', {
235
326
  `## Browse ${result.targetType} by ${result.linkType}`,
236
327
  `**Parent:** ${result.linkMbid} | **Offset:** ${result.offset} | **This page:** ${result.entities.length}`,
237
328
  ];
329
+ if (result.type)
330
+ lines.push(`**Type filter:** ${safeText(result.type)}`);
331
+ if (result.status)
332
+ lines.push(`**Status filter:** ${safeText(result.status)}`);
238
333
  for (const e of result.entities) {
239
334
  const meta = [
240
335
  e.type ? safeText(e.type) : null,
@@ -243,6 +338,8 @@ export const browseEntitiesTool = tool('musicbrainz_browse_entities', {
243
338
  e.date,
244
339
  e.country,
245
340
  e.length,
341
+ e.secondaryTypes?.map(safeText).join(', '),
342
+ e.firstReleaseDate ? `First release: ${safeText(e.firstReleaseDate)}` : null,
246
343
  ]
247
344
  .filter(Boolean)
248
345
  .join(' · ');