@cyanheads/musicbrainz-mcp-server 0.2.0 → 0.2.1

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 (66) hide show
  1. package/AGENTS.md +24 -11
  2. package/CLAUDE.md +24 -11
  3. package/Dockerfile +3 -3
  4. package/README.md +39 -23
  5. package/changelog/0.2.x/0.2.1.md +32 -0
  6. package/dist/config/server-config.d.ts +1 -0
  7. package/dist/config/server-config.d.ts.map +1 -1
  8. package/dist/config/server-config.js +5 -0
  9. package/dist/config/server-config.js.map +1 -1
  10. package/dist/index.js +1 -1
  11. package/dist/index.js.map +1 -1
  12. package/dist/mcp-server/resources/definitions/entity.resource.d.ts.map +1 -1
  13. package/dist/mcp-server/resources/definitions/entity.resource.js +6 -2
  14. package/dist/mcp-server/resources/definitions/entity.resource.js.map +1 -1
  15. package/dist/mcp-server/tools/definitions/_pagination.d.ts +12 -0
  16. package/dist/mcp-server/tools/definitions/_pagination.d.ts.map +1 -0
  17. package/dist/mcp-server/tools/definitions/_pagination.js +46 -0
  18. package/dist/mcp-server/tools/definitions/_pagination.js.map +1 -0
  19. package/dist/mcp-server/tools/definitions/_shared.d.ts +2 -0
  20. package/dist/mcp-server/tools/definitions/_shared.d.ts.map +1 -1
  21. package/dist/mcp-server/tools/definitions/_shared.js +22 -6
  22. package/dist/mcp-server/tools/definitions/_shared.js.map +1 -1
  23. package/dist/mcp-server/tools/definitions/browse-entities.tool.d.ts +2 -2
  24. package/dist/mcp-server/tools/definitions/browse-entities.tool.d.ts.map +1 -1
  25. package/dist/mcp-server/tools/definitions/browse-entities.tool.js +40 -29
  26. package/dist/mcp-server/tools/definitions/browse-entities.tool.js.map +1 -1
  27. package/dist/mcp-server/tools/definitions/get-artist.tool.d.ts +2 -0
  28. package/dist/mcp-server/tools/definitions/get-artist.tool.d.ts.map +1 -1
  29. package/dist/mcp-server/tools/definitions/get-cover-art.tool.d.ts +7 -0
  30. package/dist/mcp-server/tools/definitions/get-cover-art.tool.d.ts.map +1 -1
  31. package/dist/mcp-server/tools/definitions/get-cover-art.tool.js +45 -8
  32. package/dist/mcp-server/tools/definitions/get-cover-art.tool.js.map +1 -1
  33. package/dist/mcp-server/tools/definitions/get-recording.tool.d.ts +13 -0
  34. package/dist/mcp-server/tools/definitions/get-recording.tool.d.ts.map +1 -1
  35. package/dist/mcp-server/tools/definitions/get-recording.tool.js +23 -2
  36. package/dist/mcp-server/tools/definitions/get-recording.tool.js.map +1 -1
  37. package/dist/mcp-server/tools/definitions/get-release.tool.d.ts +13 -3
  38. package/dist/mcp-server/tools/definitions/get-release.tool.d.ts.map +1 -1
  39. package/dist/mcp-server/tools/definitions/get-release.tool.js +47 -5
  40. package/dist/mcp-server/tools/definitions/get-release.tool.js.map +1 -1
  41. package/dist/mcp-server/tools/definitions/get-work.tool.d.ts +3 -1
  42. package/dist/mcp-server/tools/definitions/get-work.tool.d.ts.map +1 -1
  43. package/dist/mcp-server/tools/definitions/get-work.tool.js +4 -4
  44. package/dist/mcp-server/tools/definitions/get-work.tool.js.map +1 -1
  45. package/dist/mcp-server/tools/definitions/index.d.ts +41 -6
  46. package/dist/mcp-server/tools/definitions/index.d.ts.map +1 -1
  47. package/dist/mcp-server/tools/definitions/lookup-identifier.tool.d.ts +2 -2
  48. package/dist/mcp-server/tools/definitions/lookup-identifier.tool.d.ts.map +1 -1
  49. package/dist/mcp-server/tools/definitions/lookup-identifier.tool.js +26 -7
  50. package/dist/mcp-server/tools/definitions/lookup-identifier.tool.js.map +1 -1
  51. package/dist/mcp-server/tools/definitions/search-entities.tool.d.ts +2 -1
  52. package/dist/mcp-server/tools/definitions/search-entities.tool.d.ts.map +1 -1
  53. package/dist/mcp-server/tools/definitions/search-entities.tool.js +13 -14
  54. package/dist/mcp-server/tools/definitions/search-entities.tool.js.map +1 -1
  55. package/dist/services/musicbrainz/musicbrainz-service.d.ts +8 -3
  56. package/dist/services/musicbrainz/musicbrainz-service.d.ts.map +1 -1
  57. package/dist/services/musicbrainz/musicbrainz-service.js +18 -4
  58. package/dist/services/musicbrainz/musicbrainz-service.js.map +1 -1
  59. package/dist/services/musicbrainz/release-appearances.d.ts +16 -0
  60. package/dist/services/musicbrainz/release-appearances.d.ts.map +1 -0
  61. package/dist/services/musicbrainz/release-appearances.js +15 -0
  62. package/dist/services/musicbrainz/release-appearances.js.map +1 -0
  63. package/dist/services/musicbrainz/types.d.ts +6 -3
  64. package/dist/services/musicbrainz/types.d.ts.map +1 -1
  65. package/package.json +6 -6
  66. package/server.json +17 -3
@@ -9,9 +9,12 @@ export declare const allToolDefinitions: (import("@cyanheads/mcp-ts-core").ToolD
9
9
  release: "release";
10
10
  "release-group": "release-group";
11
11
  }>>;
12
+ limit: import("zod").ZodDefault<import("zod").ZodNumber>;
13
+ offset: import("zod").ZodDefault<import("zod").ZodNumber>;
12
14
  }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
13
15
  mbid: import("zod").ZodString;
14
16
  entityType: import("zod").ZodString;
17
+ offset: import("zod").ZodNumber;
15
18
  representativeRelease: import("zod").ZodOptional<import("zod").ZodString>;
16
19
  images: import("zod").ZodArray<import("zod").ZodObject<{
17
20
  id: import("zod").ZodString;
@@ -37,6 +40,10 @@ export declare const allToolDefinitions: (import("@cyanheads/mcp-ts-core").ToolD
37
40
  readonly recovery: "No release or release-group exists with that MBID. Check that entity_type matches the MBID (a release-group MBID needs entity_type=release-group), or find the MBID with musicbrainz_search_entities.";
38
41
  }], {
39
42
  readonly hasArt: import("zod").ZodBoolean;
43
+ readonly totalCount: import("zod").ZodNumber;
44
+ readonly truncated: import("zod").ZodOptional<import("zod").ZodBoolean>;
45
+ readonly shown: import("zod").ZodOptional<import("zod").ZodNumber>;
46
+ readonly cap: import("zod").ZodOptional<import("zod").ZodNumber>;
40
47
  readonly notice: import("zod").ZodOptional<import("zod").ZodString>;
41
48
  }> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
42
49
  mbid: import("zod").ZodString;
@@ -97,10 +104,11 @@ export declare const allToolDefinitions: (import("@cyanheads/mcp-ts-core").ToolD
97
104
  work: "work";
98
105
  }>;
99
106
  query: import("zod").ZodString;
100
- limit: import("zod").ZodDefault<import("zod").ZodNumber>;
107
+ limit: import("zod").ZodDefault<import("zod").ZodLazy<import("zod").ZodNumber>>;
101
108
  offset: import("zod").ZodDefault<import("zod").ZodNumber>;
102
109
  }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
103
110
  entityType: import("zod").ZodString;
111
+ offset: import("zod").ZodNumber;
104
112
  results: import("zod").ZodArray<import("zod").ZodObject<{
105
113
  mbid: import("zod").ZodString;
106
114
  name: import("zod").ZodString;
@@ -168,6 +176,8 @@ export declare const allToolDefinitions: (import("@cyanheads/mcp-ts-core").ToolD
168
176
  targetType: import("zod").ZodString;
169
177
  targetId: import("zod").ZodOptional<import("zod").ZodString>;
170
178
  targetName: import("zod").ZodOptional<import("zod").ZodString>;
179
+ targetDisambiguation: import("zod").ZodOptional<import("zod").ZodString>;
180
+ orderingKey: import("zod").ZodOptional<import("zod").ZodNumber>;
171
181
  begin: import("zod").ZodOptional<import("zod").ZodString>;
172
182
  end: import("zod").ZodOptional<import("zod").ZodString>;
173
183
  }, import("zod/v4/core").$strip>>;
@@ -192,6 +202,8 @@ export declare const allToolDefinitions: (import("@cyanheads/mcp-ts-core").ToolD
192
202
  readonly notice: import("zod").ZodOptional<import("zod").ZodString>;
193
203
  }> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
194
204
  mbid: import("zod").ZodString;
205
+ media_offset: import("zod").ZodDefault<import("zod").ZodNumber>;
206
+ media_limit: import("zod").ZodDefault<import("zod").ZodNumber>;
195
207
  }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
196
208
  mbid: import("zod").ZodString;
197
209
  title: import("zod").ZodString;
@@ -216,6 +228,9 @@ export declare const allToolDefinitions: (import("@cyanheads/mcp-ts-core").ToolD
216
228
  labelName: import("zod").ZodOptional<import("zod").ZodString>;
217
229
  catalogNumber: import("zod").ZodOptional<import("zod").ZodString>;
218
230
  }, import("zod/v4/core").$strip>>;
231
+ mediaOffset: import("zod").ZodNumber;
232
+ mediaTotal: import("zod").ZodNumber;
233
+ trackTotal: import("zod").ZodNumber;
219
234
  media: import("zod").ZodArray<import("zod").ZodObject<{
220
235
  position: import("zod").ZodOptional<import("zod").ZodNumber>;
221
236
  format: import("zod").ZodOptional<import("zod").ZodString>;
@@ -245,7 +260,12 @@ export declare const allToolDefinitions: (import("@cyanheads/mcp-ts-core").ToolD
245
260
  readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
246
261
  readonly when: "The MBID is well-formed but no release exists with it (MusicBrainz returns HTTP 404).";
247
262
  readonly recovery: "No release exists with that MBID. Verify the ID, or search by title with musicbrainz_search_entities.";
248
- }], undefined> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
263
+ }], {
264
+ readonly truncated: import("zod").ZodOptional<import("zod").ZodBoolean>;
265
+ readonly shown: import("zod").ZodOptional<import("zod").ZodNumber>;
266
+ readonly cap: import("zod").ZodOptional<import("zod").ZodNumber>;
267
+ readonly notice: import("zod").ZodOptional<import("zod").ZodString>;
268
+ }> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
249
269
  mbid: import("zod").ZodString;
250
270
  inc_relationships: import("zod").ZodDefault<import("zod").ZodBoolean>;
251
271
  }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
@@ -268,6 +288,17 @@ export declare const allToolDefinitions: (import("@cyanheads/mcp-ts-core").ToolD
268
288
  date: import("zod").ZodOptional<import("zod").ZodString>;
269
289
  country: import("zod").ZodOptional<import("zod").ZodString>;
270
290
  }, import("zod/v4/core").$strip>>;
291
+ releaseAppearanceSummary: import("zod").ZodObject<{
292
+ shown: import("zod").ZodNumber;
293
+ cap: import("zod").ZodNumber;
294
+ completeness: import("zod").ZodEnum<{
295
+ complete: "complete";
296
+ truncated: "truncated";
297
+ unknown: "unknown";
298
+ }>;
299
+ totalCount: import("zod").ZodOptional<import("zod").ZodNumber>;
300
+ notice: import("zod").ZodString;
301
+ }, import("zod/v4/core").$strip>;
271
302
  relationships: import("zod").ZodArray<import("zod").ZodObject<{
272
303
  type: import("zod").ZodString;
273
304
  direction: import("zod").ZodOptional<import("zod").ZodString>;
@@ -275,6 +306,8 @@ export declare const allToolDefinitions: (import("@cyanheads/mcp-ts-core").ToolD
275
306
  targetType: import("zod").ZodString;
276
307
  targetId: import("zod").ZodOptional<import("zod").ZodString>;
277
308
  targetName: import("zod").ZodOptional<import("zod").ZodString>;
309
+ targetDisambiguation: import("zod").ZodOptional<import("zod").ZodString>;
310
+ orderingKey: import("zod").ZodOptional<import("zod").ZodNumber>;
278
311
  begin: import("zod").ZodOptional<import("zod").ZodString>;
279
312
  end: import("zod").ZodOptional<import("zod").ZodString>;
280
313
  }, import("zod/v4/core").$strip>>;
@@ -320,6 +353,8 @@ export declare const allToolDefinitions: (import("@cyanheads/mcp-ts-core").ToolD
320
353
  targetType: import("zod").ZodString;
321
354
  targetId: import("zod").ZodOptional<import("zod").ZodString>;
322
355
  targetName: import("zod").ZodOptional<import("zod").ZodString>;
356
+ targetDisambiguation: import("zod").ZodOptional<import("zod").ZodString>;
357
+ orderingKey: import("zod").ZodOptional<import("zod").ZodNumber>;
323
358
  begin: import("zod").ZodOptional<import("zod").ZodString>;
324
359
  end: import("zod").ZodOptional<import("zod").ZodString>;
325
360
  }, import("zod/v4/core").$strip>>;
@@ -429,8 +464,8 @@ export declare const allToolDefinitions: (import("@cyanheads/mcp-ts-core").ToolD
429
464
  }, {
430
465
  readonly reason: "invalid_identifier";
431
466
  readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
432
- readonly when: "The ISRC/ISWC is malformed (the dedicated endpoint returns HTTP 400), or the barcode contains anything other than digits once spaces and hyphens are removed.";
433
- readonly recovery: "ISRC is 12 chars (e.g. USRC17607839); ISWC is T- then three dot-separated 3-digit groups and a check digit, T-DDD.DDD.DDD-C (e.g. T-010.140.236-1); a barcode is the UPC/EAN digits only (e.g. 075678164125 — spaces and hyphens are ignored, wildcards are not accepted). Verify the format.";
467
+ readonly when: "The ISRC/ISWC fails its accepted grammar locally or the dedicated endpoint rejects it with HTTP 400, or the barcode contains anything other than digits once spaces and hyphens are removed.";
468
+ readonly recovery: "ISRC accepts CCXXXYYNNNNN or CC-XXX-YY-NNNNN (e.g. USRC17607839), ignoring case and surrounding whitespace. ISWC accepts T plus ten digits, with optional hyphen after T, optional dots between three-digit groups, and optional hyphen/dot before the check digit; whitespace and case are ignored (e.g. T-010.140.236-1 or T0101402361). A barcode is UPC/EAN digits (e.g. 075678164125 — spaces and hyphens ignored, wildcards rejected). Verify the format; check digits are not repaired.";
434
469
  }], undefined> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
435
470
  target_type: import("zod").ZodEnum<{
436
471
  artist: "artist";
@@ -451,7 +486,7 @@ export declare const allToolDefinitions: (import("@cyanheads/mcp-ts-core").ToolD
451
486
  work: import("zod").ZodOptional<import("zod").ZodString>;
452
487
  area: import("zod").ZodOptional<import("zod").ZodString>;
453
488
  }, import("zod/v4/core").$catchall<import("zod").ZodUnknown>>;
454
- limit: import("zod").ZodDefault<import("zod").ZodNumber>;
489
+ limit: import("zod").ZodDefault<import("zod").ZodLazy<import("zod").ZodNumber>>;
455
490
  offset: import("zod").ZodDefault<import("zod").ZodNumber>;
456
491
  }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
457
492
  targetType: import("zod").ZodString;
@@ -473,7 +508,7 @@ export declare const allToolDefinitions: (import("@cyanheads/mcp-ts-core").ToolD
473
508
  readonly reason: "invalid_link";
474
509
  readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
475
510
  readonly when: "A parent key is unknown, aliases collide, not exactly one nonempty parent is supplied, or the MBID/parent combination is invalid.";
476
- 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.";
511
+ 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; recording → artist, release, work; work → artist. releaseGroup and release_group alias release-group; never combine aliases.";
477
512
  }, {
478
513
  readonly reason: "entity_not_found";
479
514
  readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAaH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAW9B,CAAC"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAaH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAW9B,CAAC"}
@@ -53,7 +53,7 @@ export declare const lookupIdentifierTool: import("@cyanheads/mcp-ts-core").Tool
53
53
  }, {
54
54
  readonly reason: "invalid_identifier";
55
55
  readonly code: JsonRpcErrorCode.ValidationError;
56
- readonly when: "The ISRC/ISWC is malformed (the dedicated endpoint returns HTTP 400), or the barcode contains anything other than digits once spaces and hyphens are removed.";
57
- readonly recovery: "ISRC is 12 chars (e.g. USRC17607839); ISWC is T- then three dot-separated 3-digit groups and a check digit, T-DDD.DDD.DDD-C (e.g. T-010.140.236-1); a barcode is the UPC/EAN digits only (e.g. 075678164125 — spaces and hyphens are ignored, wildcards are not accepted). Verify the format.";
56
+ readonly when: "The ISRC/ISWC fails its accepted grammar locally or the dedicated endpoint rejects it with HTTP 400, or the barcode contains anything other than digits once spaces and hyphens are removed.";
57
+ readonly recovery: "ISRC accepts CCXXXYYNNNNN or CC-XXX-YY-NNNNN (e.g. USRC17607839), ignoring case and surrounding whitespace. ISWC accepts T plus ten digits, with optional hyphen after T, optional dots between three-digit groups, and optional hyphen/dot before the check digit; whitespace and case are ignored (e.g. T-010.140.236-1 or T0101402361). A barcode is UPC/EAN digits (e.g. 075678164125 — spaces and hyphens ignored, wildcards rejected). Verify the format; check digits are not repaired.";
58
58
  }], undefined>;
59
59
  //# sourceMappingURL=lookup-identifier.tool.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"lookup-identifier.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/lookup-identifier.tool.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAY,MAAM,+BAA+B,CAAC;AAsD3E,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAiM/B,CAAC"}
1
+ {"version":3,"file":"lookup-identifier.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/lookup-identifier.tool.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAY,MAAM,+BAA+B,CAAC;AAsD3E,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAyN/B,CAAC"}
@@ -70,8 +70,8 @@ export const lookupIdentifierTool = tool('musicbrainz_lookup_identifier', {
70
70
  {
71
71
  reason: 'invalid_identifier',
72
72
  code: JsonRpcErrorCode.ValidationError,
73
- when: 'The ISRC/ISWC is malformed (the dedicated endpoint returns HTTP 400), or the barcode contains anything other than digits once spaces and hyphens are removed.',
74
- recovery: 'ISRC is 12 chars (e.g. USRC17607839); ISWC is T- then three dot-separated 3-digit groups and a check digit, T-DDD.DDD.DDD-C (e.g. T-010.140.236-1); a barcode is the UPC/EAN digits only (e.g. 075678164125 — spaces and hyphens are ignored, wildcards are not accepted). Verify the format.',
73
+ when: 'The ISRC/ISWC fails its accepted grammar locally or the dedicated endpoint rejects it with HTTP 400, or the barcode contains anything other than digits once spaces and hyphens are removed.',
74
+ recovery: 'ISRC accepts CCXXXYYNNNNN or CC-XXX-YY-NNNNN (e.g. USRC17607839), ignoring case and surrounding whitespace. ISWC accepts T plus ten digits, with optional hyphen after T, optional dots between three-digit groups, and optional hyphen/dot before the check digit; whitespace and case are ignored (e.g. T-010.140.236-1 or T0101402361). A barcode is UPC/EAN digits (e.g. 075678164125 — spaces and hyphens ignored, wildcards rejected). Verify the format; check digits are not repaired.',
75
75
  },
76
76
  ],
77
77
  input: z.object({
@@ -81,7 +81,16 @@ export const lookupIdentifierTool = tool('musicbrainz_lookup_identifier', {
81
81
  value: z
82
82
  .string()
83
83
  .min(1)
84
- .describe('The identifier value. ISRC e.g. "USRC17607839"; ISWC e.g. "T-010.140.236-1"; barcode = the UPC/EAN digits, e.g. "075678164125" (spaces and hyphens are ignored; any other character, including a wildcard, is rejected).'),
84
+ .describe('ISRC: compact CCXXXYYNNNNN or grouped CC-XXX-YY-NNNNN (e.g. GBAYE9701274 or GB-AYE-97-01274), case-insensitive with surrounding whitespace. ISWC: T plus ten digits, optional hyphen after T, optional dots between three-digit groups, optional hyphen/dot before the check digit (e.g. T-010.140.236-1 or T0101402361); whitespace and case are ignored. Echoes canonical uppercase ISRC or T-DDD.DDD.DDD-C ISWC. Barcode: UPC/EAN digits, e.g. 075678164125; spaces and hyphens are ignored, other characters rejected.')
85
+ .meta({
86
+ examples: [
87
+ 'GBAYE9701274',
88
+ 'GB-AYE-97-01274',
89
+ 'T-010.140.236-1',
90
+ 'T0101402361',
91
+ '075678164125',
92
+ ],
93
+ }),
85
94
  }),
86
95
  // The resolved entity type varies by id_type, so `result` is a discriminated
87
96
  // union on `kind`. Wrapped in an object because the tool() output slot is a
@@ -121,9 +130,14 @@ export const lookupIdentifierTool = tool('musicbrainz_lookup_identifier', {
121
130
  ctx.log.info('musicbrainz_lookup_identifier', { id_type: input.id_type, value: input.value });
122
131
  const service = getMusicBrainzService();
123
132
  if (input.id_type === 'isrc') {
133
+ const supplied = input.value.trim().toUpperCase();
134
+ if (!/^(?:[A-Z]{2}[A-Z0-9]{3}\d{7}|[A-Z]{2}-[A-Z0-9]{3}-\d{2}-\d{5})$/.test(supplied)) {
135
+ throw ctx.fail('invalid_identifier', 'ISRC must be CCXXXYYNNNNN or CC-XXX-YY-NNNNN.');
136
+ }
137
+ const identifier = supplied.replaceAll('-', '');
124
138
  let envelope;
125
139
  try {
126
- envelope = await service.resolveIsrc(input.value, ctx, { signal: ctx.signal });
140
+ envelope = await service.resolveIsrc(identifier, ctx, { signal: ctx.signal });
127
141
  }
128
142
  catch (error) {
129
143
  const reason = classifyIdentifierError(error);
@@ -145,12 +159,17 @@ export const lookupIdentifierTool = tool('musicbrainz_lookup_identifier', {
145
159
  if (recordings.length === 0) {
146
160
  throw ctx.fail('identifier_not_found', `No recording carries ISRC ${input.value}.`);
147
161
  }
148
- return { result: { kind: 'recordings', identifier: input.value, recordings } };
162
+ return { result: { kind: 'recordings', identifier, recordings } };
149
163
  }
150
164
  if (input.id_type === 'iswc') {
165
+ const groups = /^T-?(\d{3})\.?(\d{3})\.?(\d{3})[-.]?(\d)$/.exec(input.value.replace(/\s/g, '').toUpperCase());
166
+ if (!groups) {
167
+ throw ctx.fail('invalid_identifier', 'ISWC must be T plus ten digits with optional group punctuation, e.g. T-010.140.236-1.');
168
+ }
169
+ const identifier = `T-${groups[1]}.${groups[2]}.${groups[3]}-${groups[4]}`;
151
170
  let envelope;
152
171
  try {
153
- envelope = await service.resolveIswc(input.value, ctx, { signal: ctx.signal });
172
+ envelope = await service.resolveIswc(identifier, ctx, { signal: ctx.signal });
154
173
  }
155
174
  catch (error) {
156
175
  const reason = classifyIdentifierError(error);
@@ -168,7 +187,7 @@ export const lookupIdentifierTool = tool('musicbrainz_lookup_identifier', {
168
187
  if (works.length === 0) {
169
188
  throw ctx.fail('identifier_not_found', `No work carries ISWC ${input.value}.`);
170
189
  }
171
- return { result: { kind: 'works', identifier: input.value, works } };
190
+ return { result: { kind: 'works', identifier, works } };
172
191
  }
173
192
  // barcode — Lucene search filter on releases (ranked, not a dedicated endpoint).
174
193
  // The value is interpolated into a Lucene query, so it must be pure digits:
@@ -1 +1 @@
1
- {"version":3,"file":"lookup-identifier.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/lookup-identifier.tool.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"lookup-identifier.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/lookup-identifier.tool.ts"],"names":[],"mappings":"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"}
@@ -18,10 +18,11 @@ export declare const searchEntitiesTool: import("@cyanheads/mcp-ts-core").ToolDe
18
18
  work: "work";
19
19
  }>;
20
20
  query: z.ZodString;
21
- limit: z.ZodDefault<z.ZodNumber>;
21
+ limit: z.ZodDefault<z.ZodLazy<z.ZodNumber>>;
22
22
  offset: z.ZodDefault<z.ZodNumber>;
23
23
  }, z.core.$strip>, z.ZodObject<{
24
24
  entityType: z.ZodString;
25
+ offset: z.ZodNumber;
25
26
  results: z.ZodArray<z.ZodObject<{
26
27
  mbid: z.ZodString;
27
28
  name: z.ZodString;
@@ -1 +1 @@
1
- {"version":3,"file":"search-entities.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/search-entities.tool.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAqIjE,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAyG7B,CAAC"}
1
+ {"version":3,"file":"search-entities.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/search-entities.tool.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAsIjE,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA6G7B,CAAC"}
@@ -9,6 +9,7 @@
9
9
  import { tool, z } from '@cyanheads/mcp-ts-core';
10
10
  import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
11
11
  import { getMusicBrainzService, MusicBrainzService, } from '../../../services/musicbrainz/musicbrainz-service.js';
12
+ import { applyPageLimit, PageLimit, pageNotice } from './_pagination.js';
12
13
  import { artistCreditString, formatDuration, normalizeArtistCredits, safeText } from './_shared.js';
13
14
  const ENTITY_TYPES = ['artist', 'release-group', 'release', 'recording', 'work', 'label'];
14
15
  const ResultSchema = z
@@ -131,17 +132,12 @@ export const searchEntitiesTool = tool('musicbrainz_search_entities', {
131
132
  .string()
132
133
  .min(1)
133
134
  .describe('Lucene query string; must contain non-whitespace text. Plain text matches names/titles; field scoping (e.g. `artist:`, `country:`, `tag:`) is supported. Sent to MusicBrainz exactly as given.'),
134
- limit: z
135
- .number()
136
- .int()
137
- .min(1)
138
- .max(100)
139
- .default(25)
140
- .describe('Maximum results to return (1–100).'),
135
+ limit: PageLimit,
141
136
  offset: z.number().int().min(0).default(0).describe('Result offset for pagination (0-based).'),
142
137
  }),
143
138
  output: z.object({
144
139
  entityType: z.string().describe('The entity type that was searched.'),
140
+ offset: z.number().describe('The effective zero-based result offset used for this page.'),
145
141
  results: z
146
142
  .array(ResultSchema)
147
143
  .describe('Ranked matches, in MusicBrainz score-descending order.'),
@@ -152,7 +148,7 @@ export const searchEntitiesTool = tool('musicbrainz_search_entities', {
152
148
  notice: z
153
149
  .string()
154
150
  .optional()
155
- .describe('Guidance when zero results matched — how to broaden or correct the query.'),
151
+ .describe('Limit clamp and pagination guidance, including zero matches, exhausted pages, and empty-page discrepancies.'),
156
152
  },
157
153
  async handler(input, ctx) {
158
154
  ctx.log.info('musicbrainz_search_entities', {
@@ -165,21 +161,24 @@ export const searchEntitiesTool = tool('musicbrainz_search_entities', {
165
161
  throw ctx.fail('blank_query', 'The search query is blank — it contains only whitespace.');
166
162
  }
167
163
  const service = getMusicBrainzService();
168
- const envelope = await service.search(input.entityType, input.query, { limit: input.limit, offset: input.offset }, ctx, { signal: ctx.signal });
164
+ const limit = applyPageLimit(input.limit, 'musicbrainz_search_entities', ctx);
165
+ const envelope = await service.search(input.entityType, input.query, { limit, offset: input.offset }, ctx, { signal: ctx.signal });
169
166
  const key = MusicBrainzService.pluralKey(input.entityType);
170
167
  const rawHits = (envelope[key] ?? []);
171
168
  const results = rawHits.map((h) => mapHit(input.entityType, h));
172
169
  ctx.enrich.echo(input.query);
173
- ctx.enrich.total(typeof envelope.count === 'number' ? envelope.count : results.length);
174
- if (results.length === 0) {
175
- ctx.enrich.notice(`No ${input.entityType} matched "${input.query}". Broaden the query, check spelling, or try a different entityType.`);
176
- }
177
- return { entityType: input.entityType, results };
170
+ const total = envelope.count;
171
+ ctx.enrich.total(total);
172
+ const notice = pageNotice(total, input.offset, results.length, input.limit, limit, `No ${input.entityType} matched "${input.query}". Broaden the query, check spelling, or try a different entityType.`);
173
+ if (notice)
174
+ ctx.enrich.notice(notice);
175
+ return { entityType: input.entityType, offset: input.offset, results };
178
176
  },
179
177
  format: (result) => {
180
178
  const lines = [
181
179
  `## MusicBrainz ${result.entityType} search`,
182
180
  `**Matches:** ${result.results.length}`,
181
+ `**Offset:** ${result.offset}`,
183
182
  ];
184
183
  for (const r of result.results) {
185
184
  lines.push(`\n### ${safeText(r.name)}${r.disambiguation ? ` (${safeText(r.disambiguation)})` : ''}`);
@@ -1 +1 @@
1
- {"version":3,"file":"search-entities.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/search-entities.tool.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"search-entities.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/search-entities.tool.ts"],"names":[],"mappings":"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"}
@@ -41,11 +41,15 @@ export declare class MusicBrainzService {
41
41
  private readonly userAgent;
42
42
  constructor(baseUrl: string, contact: string, version: string, limiter: RateLimiter, cacheTtlSeconds: number, timeoutMs: number, maxRetries: number);
43
43
  /** Full-text Lucene search over an entity type. Returns the raw search envelope. */
44
- search(type: EntityType, query: string, params: SearchParams, ctx: Context, options?: CallOptions): Promise<SearchEnvelope>;
44
+ search(type: EntityType, query: string, params: SearchParams, ctx: Context, options?: CallOptions): Promise<SearchEnvelope & {
45
+ count: number;
46
+ }>;
45
47
  /** Look up one entity by MBID with the requested `inc` sub-resources folded in. */
46
48
  lookup<T>(type: EntityType, mbid: string, params: LookupParams, ctx: Context, options?: CallOptions): Promise<T>;
47
49
  /** Paginate the complete set of `target` entities linked to one parent MBID. */
48
- browse(target: EntityType, params: BrowseParams, ctx: Context, options?: CallOptions): Promise<BrowseEnvelope>;
50
+ browse<T extends EntityType>(target: T, params: BrowseParams, ctx: Context, options?: CallOptions): Promise<BrowseEnvelope & Record<`${T}-count`, number>>;
51
+ /** Require an exact upstream total only on search and browse responses. */
52
+ private validateCount;
49
53
  /**
50
54
  * Resolve a standard identifier to entities. ISRC and ISWC are dedicated
51
55
  * deterministic endpoints; barcode is a release search filter
@@ -60,7 +64,8 @@ export declare class MusicBrainzService {
60
64
  static pluralKey(type: EntityType): keyof SearchEnvelope & keyof BrowseEnvelope;
61
65
  /**
62
66
  * Core request pipeline: cache check → rate-limited, retried fetch + parse →
63
- * cache store. `path` is the full WS/2 path with query string (already
67
+ * endpoint validation → cache store. Malformed totals neither retry nor cache.
68
+ * `path` is the full WS/2 path with query string (already
64
69
  * `fmt=json`). `fetchWithTimeout` maps upstream HTTP 400 to `InvalidParams`,
65
70
  * but that code is reserved for malformed JSON-RPC parameter shape; this
66
71
  * service reclassifies the upstream domain rejection to `ValidationError`.
@@ -1 +1 @@
1
- {"version":3,"file":"musicbrainz-service.d.ts","sourceRoot":"","sources":["../../../src/services/musicbrainz/musicbrainz-service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAgBtD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,EACV,cAAc,EACd,UAAU,EACV,WAAW,EACX,UAAU,EACV,YAAY,EACZ,cAAc,EACf,MAAM,YAAY,CAAC;AAwBpB,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,YAAY;IAC3B,iGAAiG;IACjG,GAAG,EAAE,MAAM,EAAE,CAAC;CACf;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,qBAAa,kBAAkB;IAI3B,OAAO,CAAC,QAAQ,CAAC,OAAO;IAGxB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,eAAe;IAChC,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,UAAU;IAT7B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IAEnC,YACmB,OAAO,EAAE,MAAM,EAChC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACE,OAAO,EAAE,WAAW,EACpB,eAAe,EAAE,MAAM,EACvB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAGpC;IAED,oFAAoF;IACpF,MAAM,CACJ,IAAI,EAAE,UAAU,EAChB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,YAAY,EACpB,GAAG,EAAE,OAAO,EACZ,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,cAAc,CAAC,CAQzB;IAED,mFAAmF;IAC7E,MAAM,CAAC,CAAC,EACZ,IAAI,EAAE,UAAU,EAChB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,YAAY,EACpB,GAAG,EAAE,OAAO,EACZ,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,CAAC,CAAC,CAKZ;IAED,gFAAgF;IAC1E,MAAM,CACV,MAAM,EAAE,UAAU,EAClB,MAAM,EAAE,YAAY,EACpB,GAAG,EAAE,OAAO,EACZ,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,cAAc,CAAC,CAWzB;IAED;;;;;;;OAOG;IACH,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC,CAMrF;IAED,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,cAAc,CAAC,CAOvF;IAED,8FAA8F;IAC9F,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,cAAc,GAAG,MAAM,cAAc,CAE9E;IAED;;;;;;;;;;OAUG;YACW,OAAO;IAmDrB;;;;OAIG;IACH,OAAO,CAAC,KAAK;CAmBd;AAMD,4EAA4E;AAC5E,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAuB5D;AAED,0EAA0E;AAC1E,wBAAgB,qBAAqB,IAAI,kBAAkB,CAO1D;AAED,oDAAoD;AACpD,wBAAgB,uBAAuB,IAAI,IAAI,CAE9C"}
1
+ {"version":3,"file":"musicbrainz-service.d.ts","sourceRoot":"","sources":["../../../src/services/musicbrainz/musicbrainz-service.ts"],"names":[],"mappings":"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"}
@@ -64,7 +64,7 @@ export class MusicBrainzService {
64
64
  offset: String(params.offset),
65
65
  fmt: 'json',
66
66
  });
67
- return this.request(`/${type}?${search.toString()}`, ctx, options);
67
+ return this.request(`/${type}?${search.toString()}`, ctx, options, (envelope) => this.validateCount(envelope.count));
68
68
  }
69
69
  /** Look up one entity by MBID with the requested `inc` sub-resources folded in. */
70
70
  async lookup(type, mbid, params, ctx, options) {
@@ -85,7 +85,19 @@ export class MusicBrainzService {
85
85
  if (target === 'release-group' || target === 'release' || target === 'recording') {
86
86
  search.set('inc', 'artist-credits');
87
87
  }
88
- return await this.request(`/${target}?${search.toString()}`, ctx, options);
88
+ return await this.request(`/${target}?${search.toString()}`, ctx, options, (envelope) => this.validateCount(envelope[`${target}-count`]));
89
+ }
90
+ /** Require an exact upstream total only on search and browse responses. */
91
+ validateCount(count) {
92
+ if (typeof count !== 'number' ||
93
+ !Number.isFinite(count) ||
94
+ !Number.isInteger(count) ||
95
+ count < 0) {
96
+ throw serviceUnavailable('MusicBrainz returned a malformed response: the total count must be a finite nonnegative integer.', {
97
+ reason: 'musicbrainz_malformed_response',
98
+ recovery: { hint: 'Retry this query later; MusicBrainz returned an invalid total.' },
99
+ });
100
+ }
89
101
  }
90
102
  /**
91
103
  * Resolve a standard identifier to entities. ISRC and ISWC are dedicated
@@ -108,7 +120,8 @@ export class MusicBrainzService {
108
120
  }
109
121
  /**
110
122
  * Core request pipeline: cache check → rate-limited, retried fetch + parse →
111
- * cache store. `path` is the full WS/2 path with query string (already
123
+ * endpoint validation → cache store. Malformed totals neither retry nor cache.
124
+ * `path` is the full WS/2 path with query string (already
112
125
  * `fmt=json`). `fetchWithTimeout` maps upstream HTTP 400 to `InvalidParams`,
113
126
  * but that code is reserved for malformed JSON-RPC parameter shape; this
114
127
  * service reclassifies the upstream domain rejection to `ValidationError`.
@@ -117,7 +130,7 @@ export class MusicBrainzService {
117
130
  * `options.maxRetries` tighten the configured per-attempt timeout and retry
118
131
  * count for this call only.
119
132
  */
120
- async request(path, ctx, options) {
133
+ async request(path, ctx, options, validate) {
121
134
  const key = cacheKey('mb', path);
122
135
  if (this.cacheTtlSeconds > 0) {
123
136
  const cached = await ctx.state.get(key);
@@ -156,6 +169,7 @@ export class MusicBrainzService {
156
169
  }
157
170
  throw error;
158
171
  }
172
+ validate?.(result);
159
173
  if (this.cacheTtlSeconds > 0) {
160
174
  await ctx.state.set(key, result, { ttl: this.cacheTtlSeconds });
161
175
  }
@@ -1 +1 @@
1
- {"version":3,"file":"musicbrainz-service.js","sourceRoot":"","sources":["../../../src/services/musicbrainz/musicbrainz-service.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"musicbrainz-service.js","sourceRoot":"","sources":["../../../src/services/musicbrainz/musicbrainz-service.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,16 @@
1
+ /**
2
+ * @fileoverview Lookup-only release appearance completeness for recording tool and resource views.
3
+ * @module services/musicbrainz/release-appearances
4
+ */
5
+ import type { RawRecording } from './types.js';
6
+ /** Completeness evidence for the embedded upstream release page, without a count request. */
7
+ export interface ReleaseAppearanceSummary {
8
+ cap: number;
9
+ completeness: 'complete' | 'unknown' | 'truncated';
10
+ notice: string;
11
+ shown: number;
12
+ totalCount?: number;
13
+ }
14
+ /** A short present page proves completeness; a full or absent page needs an upstream count. */
15
+ export declare function summarizeReleaseAppearances(raw: Pick<RawRecording, 'id' | 'releases' | 'release-count'>): ReleaseAppearanceSummary;
16
+ //# sourceMappingURL=release-appearances.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"release-appearances.d.ts","sourceRoot":"","sources":["../../../src/services/musicbrainz/release-appearances.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,6FAA6F;AAC7F,MAAM,WAAW,wBAAwB;IACvC,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,EAAE,UAAU,GAAG,SAAS,GAAG,WAAW,CAAC;IACnD,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,+FAA+F;AAC/F,wBAAgB,2BAA2B,CACzC,GAAG,EAAE,IAAI,CAAC,YAAY,EAAE,IAAI,GAAG,UAAU,GAAG,eAAe,CAAC,GAC3D,wBAAwB,CAa1B"}
@@ -0,0 +1,15 @@
1
+ /** A short present page proves completeness; a full or absent page needs an upstream count. */
2
+ export function summarizeReleaseAppearances(raw) {
3
+ const cap = 25;
4
+ const shown = raw.releases?.length ?? 0;
5
+ const totalCount = raw['release-count'] ?? (raw.releases && shown < cap ? shown : undefined);
6
+ const completeness = totalCount === undefined ? 'unknown' : totalCount > shown ? 'truncated' : 'complete';
7
+ return {
8
+ shown,
9
+ cap,
10
+ completeness,
11
+ ...(totalCount === undefined ? {} : { totalCount }),
12
+ notice: `Enumerate release appearances with musicbrainz_browse_entities (target_type=release, link.recording=${raw.id}, offset=0). Start at offset=0 because the embedded page may use a different order from browse.`,
13
+ };
14
+ }
15
+ //# sourceMappingURL=release-appearances.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"release-appearances.js","sourceRoot":"","sources":["../../../src/services/musicbrainz/release-appearances.ts"],"names":[],"mappings":"AAeA,+FAA+F;AAC/F,MAAM,UAAU,2BAA2B,CACzC,GAA4D;IAE5D,MAAM,GAAG,GAAG,EAAE,CAAC;IACf,MAAM,KAAK,GAAG,GAAG,CAAC,QAAQ,EAAE,MAAM,IAAI,CAAC,CAAC;IACxC,MAAM,UAAU,GAAG,GAAG,CAAC,eAAe,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,IAAI,KAAK,GAAG,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAC7F,MAAM,YAAY,GAChB,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,GAAG,KAAK,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,UAAU,CAAC;IACvF,OAAO;QACL,KAAK;QACL,GAAG;QACH,YAAY;QACZ,GAAG,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC;QACnD,MAAM,EAAE,uGAAuG,GAAG,CAAC,EAAE,iGAAiG;KACvN,CAAC;AACJ,CAAC"}