@cyanheads/musicbrainz-mcp-server 0.1.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 (89) hide show
  1. package/AGENTS.md +466 -0
  2. package/CLAUDE.md +466 -0
  3. package/Dockerfile +121 -0
  4. package/LICENSE +201 -0
  5. package/README.md +329 -0
  6. package/changelog/0.1.x/0.1.0.md +27 -0
  7. package/changelog/template.md +127 -0
  8. package/dist/config/server-config.d.ts +24 -0
  9. package/dist/config/server-config.d.ts.map +1 -0
  10. package/dist/config/server-config.js +90 -0
  11. package/dist/config/server-config.js.map +1 -0
  12. package/dist/index.d.ts +10 -0
  13. package/dist/index.d.ts.map +1 -0
  14. package/dist/index.js +27 -0
  15. package/dist/index.js.map +1 -0
  16. package/dist/mcp-server/resources/definitions/entity.resource.d.ts +33 -0
  17. package/dist/mcp-server/resources/definitions/entity.resource.d.ts.map +1 -0
  18. package/dist/mcp-server/resources/definitions/entity.resource.js +72 -0
  19. package/dist/mcp-server/resources/definitions/entity.resource.js.map +1 -0
  20. package/dist/mcp-server/resources/definitions/index.d.ts +27 -0
  21. package/dist/mcp-server/resources/definitions/index.d.ts.map +1 -0
  22. package/dist/mcp-server/resources/definitions/index.js +8 -0
  23. package/dist/mcp-server/resources/definitions/index.js.map +1 -0
  24. package/dist/mcp-server/tools/definitions/_shared.d.ts +105 -0
  25. package/dist/mcp-server/tools/definitions/_shared.d.ts.map +1 -0
  26. package/dist/mcp-server/tools/definitions/_shared.js +382 -0
  27. package/dist/mcp-server/tools/definitions/_shared.js.map +1 -0
  28. package/dist/mcp-server/tools/definitions/browse-entities.tool.d.ts +62 -0
  29. package/dist/mcp-server/tools/definitions/browse-entities.tool.d.ts.map +1 -0
  30. package/dist/mcp-server/tools/definitions/browse-entities.tool.js +236 -0
  31. package/dist/mcp-server/tools/definitions/browse-entities.tool.js.map +1 -0
  32. package/dist/mcp-server/tools/definitions/get-artist.tool.d.ts +78 -0
  33. package/dist/mcp-server/tools/definitions/get-artist.tool.d.ts.map +1 -0
  34. package/dist/mcp-server/tools/definitions/get-artist.tool.js +200 -0
  35. package/dist/mcp-server/tools/definitions/get-artist.tool.js.map +1 -0
  36. package/dist/mcp-server/tools/definitions/get-cover-art.tool.d.ts +42 -0
  37. package/dist/mcp-server/tools/definitions/get-cover-art.tool.d.ts.map +1 -0
  38. package/dist/mcp-server/tools/definitions/get-cover-art.tool.js +149 -0
  39. package/dist/mcp-server/tools/definitions/get-cover-art.tool.js.map +1 -0
  40. package/dist/mcp-server/tools/definitions/get-label.tool.d.ts +52 -0
  41. package/dist/mcp-server/tools/definitions/get-label.tool.d.ts.map +1 -0
  42. package/dist/mcp-server/tools/definitions/get-label.tool.js +110 -0
  43. package/dist/mcp-server/tools/definitions/get-label.tool.js.map +1 -0
  44. package/dist/mcp-server/tools/definitions/get-recording.tool.d.ts +58 -0
  45. package/dist/mcp-server/tools/definitions/get-recording.tool.d.ts.map +1 -0
  46. package/dist/mcp-server/tools/definitions/get-recording.tool.js +135 -0
  47. package/dist/mcp-server/tools/definitions/get-recording.tool.js.map +1 -0
  48. package/dist/mcp-server/tools/definitions/get-release-group.tool.d.ts +55 -0
  49. package/dist/mcp-server/tools/definitions/get-release-group.tool.d.ts.map +1 -0
  50. package/dist/mcp-server/tools/definitions/get-release-group.tool.js +140 -0
  51. package/dist/mcp-server/tools/definitions/get-release-group.tool.js.map +1 -0
  52. package/dist/mcp-server/tools/definitions/get-release.tool.d.ts +66 -0
  53. package/dist/mcp-server/tools/definitions/get-release.tool.d.ts.map +1 -0
  54. package/dist/mcp-server/tools/definitions/get-release.tool.js +213 -0
  55. package/dist/mcp-server/tools/definitions/get-release.tool.js.map +1 -0
  56. package/dist/mcp-server/tools/definitions/get-work.tool.d.ts +62 -0
  57. package/dist/mcp-server/tools/definitions/get-work.tool.d.ts.map +1 -0
  58. package/dist/mcp-server/tools/definitions/get-work.tool.js +132 -0
  59. package/dist/mcp-server/tools/definitions/get-work.tool.js.map +1 -0
  60. package/dist/mcp-server/tools/definitions/index.d.ts +468 -0
  61. package/dist/mcp-server/tools/definitions/index.d.ts.map +1 -0
  62. package/dist/mcp-server/tools/definitions/index.js +28 -0
  63. package/dist/mcp-server/tools/definitions/index.js.map +1 -0
  64. package/dist/mcp-server/tools/definitions/lookup-identifier.tool.d.ts +59 -0
  65. package/dist/mcp-server/tools/definitions/lookup-identifier.tool.d.ts.map +1 -0
  66. package/dist/mcp-server/tools/definitions/lookup-identifier.tool.js +214 -0
  67. package/dist/mcp-server/tools/definitions/lookup-identifier.tool.js.map +1 -0
  68. package/dist/mcp-server/tools/definitions/search-entities.tool.d.ts +42 -0
  69. package/dist/mcp-server/tools/definitions/search-entities.tool.d.ts.map +1 -0
  70. package/dist/mcp-server/tools/definitions/search-entities.tool.js +187 -0
  71. package/dist/mcp-server/tools/definitions/search-entities.tool.js.map +1 -0
  72. package/dist/services/cover-art/cover-art-service.d.ts +40 -0
  73. package/dist/services/cover-art/cover-art-service.d.ts.map +1 -0
  74. package/dist/services/cover-art/cover-art-service.js +118 -0
  75. package/dist/services/cover-art/cover-art-service.js.map +1 -0
  76. package/dist/services/musicbrainz/musicbrainz-service.d.ts +81 -0
  77. package/dist/services/musicbrainz/musicbrainz-service.d.ts.map +1 -0
  78. package/dist/services/musicbrainz/musicbrainz-service.js +188 -0
  79. package/dist/services/musicbrainz/musicbrainz-service.js.map +1 -0
  80. package/dist/services/musicbrainz/rate-limiter.d.ts +32 -0
  81. package/dist/services/musicbrainz/rate-limiter.d.ts.map +1 -0
  82. package/dist/services/musicbrainz/rate-limiter.js +54 -0
  83. package/dist/services/musicbrainz/rate-limiter.js.map +1 -0
  84. package/dist/services/musicbrainz/types.d.ts +301 -0
  85. package/dist/services/musicbrainz/types.d.ts.map +1 -0
  86. package/dist/services/musicbrainz/types.js +11 -0
  87. package/dist/services/musicbrainz/types.js.map +1 -0
  88. package/package.json +103 -0
  89. package/server.json +111 -0
@@ -0,0 +1,132 @@
1
+ /**
2
+ * @fileoverview musicbrainz_get_work — work (a composition, the song as written,
3
+ * distinct from any recording) by MBID: type, language(s), ISWCs, writer/composer/
4
+ * lyricist relationships, and the recordings that perform it. Recording relations
5
+ * are capped at one page — musicbrainz_browse_entities (recording by work) gives
6
+ * the complete list.
7
+ * @module mcp-server/tools/definitions/get-work.tool
8
+ */
9
+ import { tool, z } from '@cyanheads/mcp-ts-core';
10
+ import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
11
+ import { getMusicBrainzService } from '../../../services/musicbrainz/musicbrainz-service.js';
12
+ import { AliasSchema, classifyMbidError, ExternalLinkSchema, MBID_EXAMPLE, normalizeAliases, normalizeRelations, normalizeTags, RelationSchema, renderAliases, renderExternalLinks, renderRelationships, renderTags, safeText, TagSchema, } from './_shared.js';
13
+ /** One-page cap for the recording relationships embedded in a work lookup. */
14
+ const LOOKUP_PAGE_CAP = 25;
15
+ export const getWorkTool = tool('musicbrainz_get_work', {
16
+ title: 'musicbrainz-mcp-server: get work',
17
+ description: 'Work (a composition — the song as written, distinct from any specific recording) by MBID: type, language(s), ISWCs (the work-level standard identifier), writer/composer/lyricist relationships (with the credited artist MBID), aliases, tags, and the recordings that perform it. Recording relations are capped at one page; for the complete list of recordings of a work, call musicbrainz_browse_entities with target_type=recording and link.work.',
18
+ annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: true },
19
+ errors: [
20
+ {
21
+ reason: 'invalid_mbid',
22
+ code: JsonRpcErrorCode.InvalidParams,
23
+ when: 'The MBID is malformed or the all-zeros sentinel (MusicBrainz returns HTTP 400).',
24
+ recovery: `MBID must be a 36-character UUID (e.g. ${MBID_EXAMPLE}). Use musicbrainz_search_entities (entity_type=work) to find one from a title.`,
25
+ },
26
+ {
27
+ reason: 'entity_not_found',
28
+ code: JsonRpcErrorCode.NotFound,
29
+ when: 'The MBID is well-formed but no work exists with it (MusicBrainz returns HTTP 404).',
30
+ recovery: 'No work exists with that MBID. Verify the ID, or search by title with musicbrainz_search_entities.',
31
+ },
32
+ ],
33
+ input: z.object({
34
+ mbid: z.string().describe('Work MBID (36-character UUID).'),
35
+ inc_relationships: z
36
+ .boolean()
37
+ .default(true)
38
+ .describe('Include writer/composer relationships, recording relationships, and external links.'),
39
+ }),
40
+ output: z.object({
41
+ mbid: z.string().describe('Work MBID.'),
42
+ title: z.string().describe('Work title.'),
43
+ disambiguation: z.string().optional().describe('Short qualifier. Omitted when absent.'),
44
+ type: z.string().optional().describe('Work type (Song, Symphony, …). Omitted when unknown.'),
45
+ languages: z.array(z.string()).describe('Lyrics languages (ISO codes; may be empty).'),
46
+ iswcs: z.array(z.string()).describe('ISWCs assigned to this work (may be empty).'),
47
+ aliases: z.array(AliasSchema).describe('Alternate titles (may be empty).'),
48
+ tags: z.array(TagSchema).describe('Community tags/genres (may be empty).'),
49
+ relationships: z
50
+ .array(RelationSchema)
51
+ .describe('Writer/composer/lyricist relationships and recording-rels (may be empty; recording-rels capped at one page).'),
52
+ externalLinks: z
53
+ .array(ExternalLinkSchema)
54
+ .describe('External resource links (url-rels) (may be empty).'),
55
+ }),
56
+ enrichment: {
57
+ truncated: z
58
+ .boolean()
59
+ .optional()
60
+ .describe('True when the recording relationships hit the one-page cap. Absent when the full set fit in one page.'),
61
+ shown: z
62
+ .number()
63
+ .optional()
64
+ .describe('Number of recording relationships returned. Absent when not truncated.'),
65
+ cap: z
66
+ .number()
67
+ .optional()
68
+ .describe('The one-page cap that was applied. Absent when not truncated.'),
69
+ notice: z
70
+ .string()
71
+ .optional()
72
+ .describe('How to fetch the complete list of recordings of this work when truncated.'),
73
+ },
74
+ async handler(input, ctx) {
75
+ ctx.log.info('musicbrainz_get_work', { mbid: input.mbid });
76
+ const service = getMusicBrainzService();
77
+ const inc = ['aliases', 'tags', 'genres'];
78
+ if (input.inc_relationships)
79
+ inc.push('artist-rels', 'recording-rels', 'url-rels');
80
+ let raw;
81
+ try {
82
+ raw = await service.lookup('work', input.mbid, { inc }, ctx, { signal: ctx.signal });
83
+ }
84
+ catch (error) {
85
+ const reason = classifyMbidError(error);
86
+ if (reason)
87
+ throw ctx.fail(reason, undefined, { ...ctx.recoveryFor(reason), mbid: input.mbid });
88
+ throw error;
89
+ }
90
+ const { relationships, externalLinks } = normalizeRelations(raw.relations);
91
+ const languages = raw.languages ?? (raw.language ? [raw.language] : []);
92
+ const recordingRelCount = relationships.filter((r) => r.targetType === 'recording').length;
93
+ if (input.inc_relationships && recordingRelCount >= LOOKUP_PAGE_CAP) {
94
+ ctx.enrich.truncated({ shown: recordingRelCount, cap: LOOKUP_PAGE_CAP });
95
+ ctx.enrich.notice(`Recording relationships capped at ${LOOKUP_PAGE_CAP}. Call musicbrainz_browse_entities (target_type=recording, link.work=${input.mbid}) for the complete list of recordings of this work.`);
96
+ }
97
+ return {
98
+ mbid: raw.id,
99
+ title: raw.title ?? '',
100
+ ...(raw.disambiguation ? { disambiguation: raw.disambiguation } : {}),
101
+ ...(raw.type ? { type: raw.type } : {}),
102
+ languages,
103
+ iswcs: raw.iswcs ?? [],
104
+ aliases: normalizeAliases(raw.aliases),
105
+ tags: normalizeTags(raw.tags ?? raw.genres),
106
+ relationships,
107
+ externalLinks,
108
+ };
109
+ },
110
+ format: (result) => {
111
+ const lines = [
112
+ `## ${safeText(result.title)}${result.disambiguation ? ` (${safeText(result.disambiguation)})` : ''}`,
113
+ ];
114
+ lines.push(`**MBID:** ${result.mbid}`);
115
+ if (result.type)
116
+ lines.push(`**Type:** ${safeText(result.type)}`);
117
+ if (result.languages.length)
118
+ lines.push(`**Languages:** ${result.languages.join(', ')}`);
119
+ if (result.iswcs.length)
120
+ lines.push(`**ISWCs:** ${result.iswcs.join(', ')}`);
121
+ const tags = renderTags(result.tags);
122
+ if (tags)
123
+ lines.push(tags);
124
+ const aliases = renderAliases(result.aliases);
125
+ if (aliases)
126
+ lines.push(aliases);
127
+ lines.push(...renderRelationships(result.relationships));
128
+ lines.push(...renderExternalLinks(result.externalLinks));
129
+ return [{ type: 'text', text: lines.join('\n') }];
130
+ },
131
+ });
132
+ //# sourceMappingURL=get-work.tool.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"get-work.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-work.tool.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,468 @@
1
+ /**
2
+ * @fileoverview Barrel collecting all MusicBrainz tool definitions into the
3
+ * `allToolDefinitions` array consumed by createApp().
4
+ * @module mcp-server/tools/definitions/index
5
+ */
6
+ export declare const allToolDefinitions: (import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
7
+ target_type: import("zod").ZodEnum<{
8
+ artist: "artist";
9
+ "release-group": "release-group";
10
+ release: "release";
11
+ recording: "recording";
12
+ work: "work";
13
+ label: "label";
14
+ }>;
15
+ link: import("zod").ZodObject<{
16
+ artist: import("zod").ZodOptional<import("zod").ZodString>;
17
+ label: import("zod").ZodOptional<import("zod").ZodString>;
18
+ 'release-group': import("zod").ZodOptional<import("zod").ZodString>;
19
+ recording: import("zod").ZodOptional<import("zod").ZodString>;
20
+ work: import("zod").ZodOptional<import("zod").ZodString>;
21
+ area: import("zod").ZodOptional<import("zod").ZodString>;
22
+ }, import("zod/v4/core").$strip>;
23
+ limit: import("zod").ZodDefault<import("zod").ZodNumber>;
24
+ offset: import("zod").ZodDefault<import("zod").ZodNumber>;
25
+ }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
26
+ targetType: import("zod").ZodString;
27
+ linkType: import("zod").ZodString;
28
+ linkMbid: import("zod").ZodString;
29
+ entities: import("zod").ZodArray<import("zod").ZodObject<{
30
+ mbid: import("zod").ZodString;
31
+ name: import("zod").ZodString;
32
+ disambiguation: import("zod").ZodOptional<import("zod").ZodString>;
33
+ type: import("zod").ZodOptional<import("zod").ZodString>;
34
+ artistCredit: import("zod").ZodOptional<import("zod").ZodString>;
35
+ date: import("zod").ZodOptional<import("zod").ZodString>;
36
+ country: import("zod").ZodOptional<import("zod").ZodString>;
37
+ length: import("zod").ZodOptional<import("zod").ZodString>;
38
+ }, import("zod/v4/core").$strip>>;
39
+ offset: import("zod").ZodNumber;
40
+ }, import("zod/v4/core").$strip>, readonly [{
41
+ readonly reason: "invalid_link";
42
+ readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.InvalidParams;
43
+ readonly when: "No link MBID was provided, more than one was provided, or the link MBID is malformed (HTTP 400).";
44
+ readonly recovery: "Provide exactly one link MBID (e.g. link.artist) that is a valid parent for the target_type. MBIDs are 36-char UUIDs.";
45
+ }, {
46
+ readonly reason: "entity_not_found";
47
+ readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
48
+ readonly when: "The link MBID is well-formed but no such parent entity exists (HTTP 404).";
49
+ readonly recovery: "No parent entity exists with that MBID. Verify the ID with the matching musicbrainz_get_* tool or musicbrainz_search_entities.";
50
+ }], {
51
+ readonly totalCount: import("zod").ZodNumber;
52
+ readonly truncated: import("zod").ZodOptional<import("zod").ZodBoolean>;
53
+ readonly shown: import("zod").ZodOptional<import("zod").ZodNumber>;
54
+ readonly cap: import("zod").ZodOptional<import("zod").ZodNumber>;
55
+ readonly notice: import("zod").ZodOptional<import("zod").ZodString>;
56
+ }> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
57
+ mbid: import("zod").ZodString;
58
+ inc_release_groups: import("zod").ZodDefault<import("zod").ZodBoolean>;
59
+ inc_relationships: import("zod").ZodDefault<import("zod").ZodBoolean>;
60
+ }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
61
+ mbid: import("zod").ZodString;
62
+ name: import("zod").ZodString;
63
+ sortName: import("zod").ZodOptional<import("zod").ZodString>;
64
+ disambiguation: import("zod").ZodOptional<import("zod").ZodString>;
65
+ type: import("zod").ZodOptional<import("zod").ZodString>;
66
+ gender: import("zod").ZodOptional<import("zod").ZodString>;
67
+ country: import("zod").ZodOptional<import("zod").ZodString>;
68
+ area: import("zod").ZodOptional<import("zod").ZodString>;
69
+ lifeSpan: import("zod").ZodOptional<import("zod").ZodObject<{
70
+ begin: import("zod").ZodOptional<import("zod").ZodString>;
71
+ end: import("zod").ZodOptional<import("zod").ZodString>;
72
+ ended: import("zod").ZodOptional<import("zod").ZodBoolean>;
73
+ }, import("zod/v4/core").$strip>>;
74
+ aliases: import("zod").ZodArray<import("zod").ZodObject<{
75
+ name: import("zod").ZodString;
76
+ sortName: import("zod").ZodOptional<import("zod").ZodString>;
77
+ type: import("zod").ZodOptional<import("zod").ZodString>;
78
+ locale: import("zod").ZodOptional<import("zod").ZodString>;
79
+ primary: import("zod").ZodOptional<import("zod").ZodBoolean>;
80
+ }, import("zod/v4/core").$strip>>;
81
+ tags: import("zod").ZodArray<import("zod").ZodObject<{
82
+ name: import("zod").ZodString;
83
+ count: import("zod").ZodNumber;
84
+ }, import("zod/v4/core").$strip>>;
85
+ releaseGroups: import("zod").ZodArray<import("zod").ZodObject<{
86
+ mbid: import("zod").ZodString;
87
+ title: import("zod").ZodString;
88
+ primaryType: import("zod").ZodOptional<import("zod").ZodString>;
89
+ secondaryTypes: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
90
+ firstReleaseDate: import("zod").ZodOptional<import("zod").ZodString>;
91
+ disambiguation: import("zod").ZodOptional<import("zod").ZodString>;
92
+ }, import("zod/v4/core").$strip>>;
93
+ relationships: import("zod").ZodArray<import("zod").ZodObject<{
94
+ type: import("zod").ZodString;
95
+ direction: import("zod").ZodOptional<import("zod").ZodString>;
96
+ attributes: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
97
+ targetType: import("zod").ZodString;
98
+ targetId: import("zod").ZodOptional<import("zod").ZodString>;
99
+ targetName: import("zod").ZodOptional<import("zod").ZodString>;
100
+ begin: import("zod").ZodOptional<import("zod").ZodString>;
101
+ end: import("zod").ZodOptional<import("zod").ZodString>;
102
+ }, import("zod/v4/core").$strip>>;
103
+ externalLinks: import("zod").ZodArray<import("zod").ZodObject<{
104
+ type: import("zod").ZodString;
105
+ resource: import("zod").ZodString;
106
+ }, import("zod/v4/core").$strip>>;
107
+ }, import("zod/v4/core").$strip>, readonly [{
108
+ readonly reason: "invalid_mbid";
109
+ readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.InvalidParams;
110
+ readonly when: "The MBID is malformed or the all-zeros sentinel (MusicBrainz returns HTTP 400).";
111
+ readonly recovery: "MBID must be a 36-character UUID (e.g. a74b1b7f-71a5-4011-9441-d0b5e4122711). Use musicbrainz_search_entities to find an artist's MBID from its name.";
112
+ }, {
113
+ readonly reason: "entity_not_found";
114
+ readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
115
+ readonly when: "The MBID is well-formed but no artist exists with it (MusicBrainz returns HTTP 404).";
116
+ readonly recovery: "No artist exists with that MBID. Verify the ID, or search by name with musicbrainz_search_entities.";
117
+ }], {
118
+ readonly truncated: import("zod").ZodOptional<import("zod").ZodBoolean>;
119
+ readonly shown: import("zod").ZodOptional<import("zod").ZodNumber>;
120
+ readonly cap: import("zod").ZodOptional<import("zod").ZodNumber>;
121
+ readonly notice: import("zod").ZodOptional<import("zod").ZodString>;
122
+ }> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
123
+ mbid: import("zod").ZodString;
124
+ entity_type: import("zod").ZodDefault<import("zod").ZodEnum<{
125
+ "release-group": "release-group";
126
+ release: "release";
127
+ }>>;
128
+ }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
129
+ mbid: import("zod").ZodString;
130
+ entityType: import("zod").ZodString;
131
+ representativeRelease: import("zod").ZodOptional<import("zod").ZodString>;
132
+ images: import("zod").ZodArray<import("zod").ZodObject<{
133
+ id: import("zod").ZodString;
134
+ front: import("zod").ZodBoolean;
135
+ back: import("zod").ZodBoolean;
136
+ types: import("zod").ZodArray<import("zod").ZodString>;
137
+ imageUrl: import("zod").ZodString;
138
+ thumbnail250: import("zod").ZodOptional<import("zod").ZodString>;
139
+ thumbnail500: import("zod").ZodOptional<import("zod").ZodString>;
140
+ thumbnail1200: import("zod").ZodOptional<import("zod").ZodString>;
141
+ approved: import("zod").ZodOptional<import("zod").ZodBoolean>;
142
+ comment: import("zod").ZodOptional<import("zod").ZodString>;
143
+ }, import("zod/v4/core").$strip>>;
144
+ }, import("zod/v4/core").$strip>, readonly [{
145
+ readonly reason: "invalid_mbid";
146
+ readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.InvalidParams;
147
+ readonly when: "The MBID is malformed or the all-zeros sentinel (the upstream returns HTTP 400).";
148
+ readonly recovery: "MBID must be a 36-character UUID (e.g. a74b1b7f-71a5-4011-9441-d0b5e4122711). Use musicbrainz_search_entities to find a release or release-group MBID.";
149
+ }], {
150
+ readonly hasArt: import("zod").ZodBoolean;
151
+ readonly notice: import("zod").ZodOptional<import("zod").ZodString>;
152
+ }> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
153
+ mbid: import("zod").ZodString;
154
+ }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
155
+ mbid: import("zod").ZodString;
156
+ name: import("zod").ZodString;
157
+ sortName: import("zod").ZodOptional<import("zod").ZodString>;
158
+ disambiguation: import("zod").ZodOptional<import("zod").ZodString>;
159
+ type: import("zod").ZodOptional<import("zod").ZodString>;
160
+ labelCode: import("zod").ZodOptional<import("zod").ZodNumber>;
161
+ country: import("zod").ZodOptional<import("zod").ZodString>;
162
+ area: import("zod").ZodOptional<import("zod").ZodString>;
163
+ lifeSpan: import("zod").ZodOptional<import("zod").ZodObject<{
164
+ begin: import("zod").ZodOptional<import("zod").ZodString>;
165
+ end: import("zod").ZodOptional<import("zod").ZodString>;
166
+ ended: import("zod").ZodOptional<import("zod").ZodBoolean>;
167
+ }, import("zod/v4/core").$strip>>;
168
+ aliases: import("zod").ZodArray<import("zod").ZodObject<{
169
+ name: import("zod").ZodString;
170
+ sortName: import("zod").ZodOptional<import("zod").ZodString>;
171
+ type: import("zod").ZodOptional<import("zod").ZodString>;
172
+ locale: import("zod").ZodOptional<import("zod").ZodString>;
173
+ primary: import("zod").ZodOptional<import("zod").ZodBoolean>;
174
+ }, import("zod/v4/core").$strip>>;
175
+ tags: import("zod").ZodArray<import("zod").ZodObject<{
176
+ name: import("zod").ZodString;
177
+ count: import("zod").ZodNumber;
178
+ }, import("zod/v4/core").$strip>>;
179
+ externalLinks: import("zod").ZodArray<import("zod").ZodObject<{
180
+ type: import("zod").ZodString;
181
+ resource: import("zod").ZodString;
182
+ }, import("zod/v4/core").$strip>>;
183
+ }, import("zod/v4/core").$strip>, readonly [{
184
+ readonly reason: "invalid_mbid";
185
+ readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.InvalidParams;
186
+ readonly when: "The MBID is malformed or the all-zeros sentinel (MusicBrainz returns HTTP 400).";
187
+ readonly recovery: "MBID must be a 36-character UUID (e.g. a74b1b7f-71a5-4011-9441-d0b5e4122711). Use musicbrainz_search_entities (entity_type=label) to find one from a name.";
188
+ }, {
189
+ readonly reason: "entity_not_found";
190
+ readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
191
+ readonly when: "The MBID is well-formed but no label exists with it (MusicBrainz returns HTTP 404).";
192
+ readonly recovery: "No label exists with that MBID. Verify the ID, or search by name with musicbrainz_search_entities.";
193
+ }], undefined> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
194
+ mbid: import("zod").ZodString;
195
+ inc_relationships: import("zod").ZodDefault<import("zod").ZodBoolean>;
196
+ }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
197
+ mbid: import("zod").ZodString;
198
+ title: import("zod").ZodString;
199
+ disambiguation: import("zod").ZodOptional<import("zod").ZodString>;
200
+ length: import("zod").ZodOptional<import("zod").ZodString>;
201
+ artistCredit: import("zod").ZodArray<import("zod").ZodObject<{
202
+ name: import("zod").ZodString;
203
+ artistId: import("zod").ZodString;
204
+ artistName: import("zod").ZodString;
205
+ joinPhrase: import("zod").ZodOptional<import("zod").ZodString>;
206
+ }, import("zod/v4/core").$strip>>;
207
+ artistCreditString: import("zod").ZodString;
208
+ isrcs: import("zod").ZodArray<import("zod").ZodString>;
209
+ firstReleaseDate: import("zod").ZodOptional<import("zod").ZodString>;
210
+ releases: import("zod").ZodArray<import("zod").ZodObject<{
211
+ mbid: import("zod").ZodString;
212
+ title: import("zod").ZodString;
213
+ date: import("zod").ZodOptional<import("zod").ZodString>;
214
+ country: import("zod").ZodOptional<import("zod").ZodString>;
215
+ }, import("zod/v4/core").$strip>>;
216
+ relationships: import("zod").ZodArray<import("zod").ZodObject<{
217
+ type: import("zod").ZodString;
218
+ direction: import("zod").ZodOptional<import("zod").ZodString>;
219
+ attributes: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
220
+ targetType: import("zod").ZodString;
221
+ targetId: import("zod").ZodOptional<import("zod").ZodString>;
222
+ targetName: import("zod").ZodOptional<import("zod").ZodString>;
223
+ begin: import("zod").ZodOptional<import("zod").ZodString>;
224
+ end: import("zod").ZodOptional<import("zod").ZodString>;
225
+ }, import("zod/v4/core").$strip>>;
226
+ externalLinks: import("zod").ZodArray<import("zod").ZodObject<{
227
+ type: import("zod").ZodString;
228
+ resource: import("zod").ZodString;
229
+ }, import("zod/v4/core").$strip>>;
230
+ }, import("zod/v4/core").$strip>, readonly [{
231
+ readonly reason: "invalid_mbid";
232
+ readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.InvalidParams;
233
+ readonly when: "The MBID is malformed or the all-zeros sentinel (MusicBrainz returns HTTP 400).";
234
+ readonly recovery: "MBID must be a 36-character UUID (e.g. a74b1b7f-71a5-4011-9441-d0b5e4122711). Use musicbrainz_search_entities (entity_type=recording) to find one from a title.";
235
+ }, {
236
+ readonly reason: "entity_not_found";
237
+ readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
238
+ readonly when: "The MBID is well-formed but no recording exists with it (MusicBrainz returns HTTP 404).";
239
+ readonly recovery: "No recording exists with that MBID. Verify the ID, or search by title with musicbrainz_search_entities.";
240
+ }], undefined> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
241
+ mbid: import("zod").ZodString;
242
+ }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
243
+ mbid: import("zod").ZodString;
244
+ title: import("zod").ZodString;
245
+ disambiguation: import("zod").ZodOptional<import("zod").ZodString>;
246
+ artistCredit: import("zod").ZodArray<import("zod").ZodObject<{
247
+ name: import("zod").ZodString;
248
+ artistId: import("zod").ZodString;
249
+ artistName: import("zod").ZodString;
250
+ joinPhrase: import("zod").ZodOptional<import("zod").ZodString>;
251
+ }, import("zod/v4/core").$strip>>;
252
+ artistCreditString: import("zod").ZodString;
253
+ status: import("zod").ZodOptional<import("zod").ZodString>;
254
+ date: import("zod").ZodOptional<import("zod").ZodString>;
255
+ country: import("zod").ZodOptional<import("zod").ZodString>;
256
+ barcode: import("zod").ZodOptional<import("zod").ZodString>;
257
+ packaging: import("zod").ZodOptional<import("zod").ZodString>;
258
+ language: import("zod").ZodOptional<import("zod").ZodString>;
259
+ script: import("zod").ZodOptional<import("zod").ZodString>;
260
+ releaseGroupId: import("zod").ZodOptional<import("zod").ZodString>;
261
+ labelInfo: import("zod").ZodArray<import("zod").ZodObject<{
262
+ labelId: import("zod").ZodOptional<import("zod").ZodString>;
263
+ labelName: import("zod").ZodOptional<import("zod").ZodString>;
264
+ catalogNumber: import("zod").ZodOptional<import("zod").ZodString>;
265
+ }, import("zod/v4/core").$strip>>;
266
+ media: import("zod").ZodArray<import("zod").ZodObject<{
267
+ position: import("zod").ZodOptional<import("zod").ZodNumber>;
268
+ format: import("zod").ZodOptional<import("zod").ZodString>;
269
+ title: import("zod").ZodOptional<import("zod").ZodString>;
270
+ trackCount: import("zod").ZodOptional<import("zod").ZodNumber>;
271
+ tracks: import("zod").ZodArray<import("zod").ZodObject<{
272
+ position: import("zod").ZodOptional<import("zod").ZodNumber>;
273
+ number: import("zod").ZodOptional<import("zod").ZodString>;
274
+ title: import("zod").ZodString;
275
+ length: import("zod").ZodOptional<import("zod").ZodString>;
276
+ recordingId: import("zod").ZodOptional<import("zod").ZodString>;
277
+ }, import("zod/v4/core").$strip>>;
278
+ }, import("zod/v4/core").$strip>>;
279
+ coverArt: import("zod").ZodObject<{
280
+ exists: import("zod").ZodBoolean;
281
+ count: import("zod").ZodOptional<import("zod").ZodNumber>;
282
+ front: import("zod").ZodOptional<import("zod").ZodBoolean>;
283
+ back: import("zod").ZodOptional<import("zod").ZodBoolean>;
284
+ }, import("zod/v4/core").$strip>;
285
+ }, import("zod/v4/core").$strip>, readonly [{
286
+ readonly reason: "invalid_mbid";
287
+ readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.InvalidParams;
288
+ readonly when: "The MBID is malformed or the all-zeros sentinel (MusicBrainz returns HTTP 400).";
289
+ readonly recovery: "MBID must be a 36-character UUID (e.g. a74b1b7f-71a5-4011-9441-d0b5e4122711). Use musicbrainz_search_entities (entity_type=release) to find one from a title.";
290
+ }, {
291
+ readonly reason: "entity_not_found";
292
+ readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
293
+ readonly when: "The MBID is well-formed but no release exists with it (MusicBrainz returns HTTP 404).";
294
+ readonly recovery: "No release exists with that MBID. Verify the ID, or search by title with musicbrainz_search_entities.";
295
+ }], undefined> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
296
+ mbid: import("zod").ZodString;
297
+ }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
298
+ mbid: import("zod").ZodString;
299
+ title: import("zod").ZodString;
300
+ disambiguation: import("zod").ZodOptional<import("zod").ZodString>;
301
+ primaryType: import("zod").ZodOptional<import("zod").ZodString>;
302
+ secondaryTypes: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
303
+ firstReleaseDate: import("zod").ZodOptional<import("zod").ZodString>;
304
+ artistCredit: import("zod").ZodArray<import("zod").ZodObject<{
305
+ name: import("zod").ZodString;
306
+ artistId: import("zod").ZodString;
307
+ artistName: import("zod").ZodString;
308
+ joinPhrase: import("zod").ZodOptional<import("zod").ZodString>;
309
+ }, import("zod/v4/core").$strip>>;
310
+ artistCreditString: import("zod").ZodString;
311
+ releases: import("zod").ZodArray<import("zod").ZodObject<{
312
+ mbid: import("zod").ZodString;
313
+ title: import("zod").ZodString;
314
+ date: import("zod").ZodOptional<import("zod").ZodString>;
315
+ country: import("zod").ZodOptional<import("zod").ZodString>;
316
+ status: import("zod").ZodOptional<import("zod").ZodString>;
317
+ disambiguation: import("zod").ZodOptional<import("zod").ZodString>;
318
+ }, import("zod/v4/core").$strip>>;
319
+ tags: import("zod").ZodArray<import("zod").ZodObject<{
320
+ name: import("zod").ZodString;
321
+ count: import("zod").ZodNumber;
322
+ }, import("zod/v4/core").$strip>>;
323
+ coverArt: import("zod").ZodObject<{
324
+ exists: import("zod").ZodBoolean;
325
+ count: import("zod").ZodOptional<import("zod").ZodNumber>;
326
+ front: import("zod").ZodOptional<import("zod").ZodBoolean>;
327
+ back: import("zod").ZodOptional<import("zod").ZodBoolean>;
328
+ }, import("zod/v4/core").$strip>;
329
+ }, import("zod/v4/core").$strip>, readonly [{
330
+ readonly reason: "invalid_mbid";
331
+ readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.InvalidParams;
332
+ readonly when: "The MBID is malformed or the all-zeros sentinel (MusicBrainz returns HTTP 400).";
333
+ readonly recovery: "MBID must be a 36-character UUID (e.g. a74b1b7f-71a5-4011-9441-d0b5e4122711). Use musicbrainz_search_entities (entity_type=release-group) to find one from a title.";
334
+ }, {
335
+ readonly reason: "entity_not_found";
336
+ readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
337
+ readonly when: "The MBID is well-formed but no release-group exists with it (MusicBrainz returns HTTP 404).";
338
+ readonly recovery: "No release-group exists with that MBID. Verify the ID, or search by title with musicbrainz_search_entities.";
339
+ }], undefined> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
340
+ mbid: import("zod").ZodString;
341
+ inc_relationships: import("zod").ZodDefault<import("zod").ZodBoolean>;
342
+ }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
343
+ mbid: import("zod").ZodString;
344
+ title: import("zod").ZodString;
345
+ disambiguation: import("zod").ZodOptional<import("zod").ZodString>;
346
+ type: import("zod").ZodOptional<import("zod").ZodString>;
347
+ languages: import("zod").ZodArray<import("zod").ZodString>;
348
+ iswcs: import("zod").ZodArray<import("zod").ZodString>;
349
+ aliases: import("zod").ZodArray<import("zod").ZodObject<{
350
+ name: import("zod").ZodString;
351
+ sortName: import("zod").ZodOptional<import("zod").ZodString>;
352
+ type: import("zod").ZodOptional<import("zod").ZodString>;
353
+ locale: import("zod").ZodOptional<import("zod").ZodString>;
354
+ primary: import("zod").ZodOptional<import("zod").ZodBoolean>;
355
+ }, import("zod/v4/core").$strip>>;
356
+ tags: import("zod").ZodArray<import("zod").ZodObject<{
357
+ name: import("zod").ZodString;
358
+ count: import("zod").ZodNumber;
359
+ }, import("zod/v4/core").$strip>>;
360
+ relationships: import("zod").ZodArray<import("zod").ZodObject<{
361
+ type: import("zod").ZodString;
362
+ direction: import("zod").ZodOptional<import("zod").ZodString>;
363
+ attributes: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
364
+ targetType: import("zod").ZodString;
365
+ targetId: import("zod").ZodOptional<import("zod").ZodString>;
366
+ targetName: import("zod").ZodOptional<import("zod").ZodString>;
367
+ begin: import("zod").ZodOptional<import("zod").ZodString>;
368
+ end: import("zod").ZodOptional<import("zod").ZodString>;
369
+ }, import("zod/v4/core").$strip>>;
370
+ externalLinks: import("zod").ZodArray<import("zod").ZodObject<{
371
+ type: import("zod").ZodString;
372
+ resource: import("zod").ZodString;
373
+ }, import("zod/v4/core").$strip>>;
374
+ }, import("zod/v4/core").$strip>, readonly [{
375
+ readonly reason: "invalid_mbid";
376
+ readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.InvalidParams;
377
+ readonly when: "The MBID is malformed or the all-zeros sentinel (MusicBrainz returns HTTP 400).";
378
+ readonly recovery: "MBID must be a 36-character UUID (e.g. a74b1b7f-71a5-4011-9441-d0b5e4122711). Use musicbrainz_search_entities (entity_type=work) to find one from a title.";
379
+ }, {
380
+ readonly reason: "entity_not_found";
381
+ readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
382
+ readonly when: "The MBID is well-formed but no work exists with it (MusicBrainz returns HTTP 404).";
383
+ readonly recovery: "No work exists with that MBID. Verify the ID, or search by title with musicbrainz_search_entities.";
384
+ }], {
385
+ readonly truncated: import("zod").ZodOptional<import("zod").ZodBoolean>;
386
+ readonly shown: import("zod").ZodOptional<import("zod").ZodNumber>;
387
+ readonly cap: import("zod").ZodOptional<import("zod").ZodNumber>;
388
+ readonly notice: import("zod").ZodOptional<import("zod").ZodString>;
389
+ }> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
390
+ id_type: import("zod").ZodEnum<{
391
+ barcode: "barcode";
392
+ isrc: "isrc";
393
+ iswc: "iswc";
394
+ }>;
395
+ value: import("zod").ZodString;
396
+ }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
397
+ result: import("zod").ZodDiscriminatedUnion<[import("zod").ZodObject<{
398
+ kind: import("zod").ZodLiteral<"recordings">;
399
+ identifier: import("zod").ZodString;
400
+ recordings: import("zod").ZodArray<import("zod").ZodObject<{
401
+ mbid: import("zod").ZodString;
402
+ title: import("zod").ZodString;
403
+ artistCredit: import("zod").ZodString;
404
+ length: import("zod").ZodOptional<import("zod").ZodString>;
405
+ }, import("zod/v4/core").$strip>>;
406
+ }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
407
+ kind: import("zod").ZodLiteral<"works">;
408
+ identifier: import("zod").ZodString;
409
+ works: import("zod").ZodArray<import("zod").ZodObject<{
410
+ mbid: import("zod").ZodString;
411
+ title: import("zod").ZodString;
412
+ type: import("zod").ZodOptional<import("zod").ZodString>;
413
+ }, import("zod/v4/core").$strip>>;
414
+ }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
415
+ kind: import("zod").ZodLiteral<"releases">;
416
+ identifier: import("zod").ZodString;
417
+ releases: import("zod").ZodArray<import("zod").ZodObject<{
418
+ mbid: import("zod").ZodString;
419
+ title: import("zod").ZodString;
420
+ artistCredit: import("zod").ZodString;
421
+ date: import("zod").ZodOptional<import("zod").ZodString>;
422
+ country: import("zod").ZodOptional<import("zod").ZodString>;
423
+ score: import("zod").ZodNumber;
424
+ }, import("zod/v4/core").$strip>>;
425
+ }, import("zod/v4/core").$strip>], "kind">;
426
+ }, import("zod/v4/core").$strip>, readonly [{
427
+ readonly reason: "identifier_not_found";
428
+ readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
429
+ readonly when: "The identifier is well-formed but resolves to zero entities.";
430
+ readonly recovery: "No entity carries that identifier. Check the value, or search by name with musicbrainz_search_entities.";
431
+ }, {
432
+ readonly reason: "invalid_identifier";
433
+ readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.InvalidParams;
434
+ readonly when: "The ISRC/ISWC is malformed (the dedicated endpoint returns HTTP 400).";
435
+ readonly recovery: "ISRC is 12 chars (e.g. USRC17607839); ISWC is T- followed by 10 digits (e.g. T-345246800-1). Verify the format.";
436
+ }], undefined> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
437
+ entityType: import("zod").ZodEnum<{
438
+ artist: "artist";
439
+ "release-group": "release-group";
440
+ release: "release";
441
+ recording: "recording";
442
+ work: "work";
443
+ label: "label";
444
+ }>;
445
+ query: import("zod").ZodString;
446
+ limit: import("zod").ZodDefault<import("zod").ZodNumber>;
447
+ offset: import("zod").ZodDefault<import("zod").ZodNumber>;
448
+ }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
449
+ entityType: import("zod").ZodString;
450
+ results: import("zod").ZodArray<import("zod").ZodObject<{
451
+ mbid: import("zod").ZodString;
452
+ name: import("zod").ZodString;
453
+ score: import("zod").ZodNumber;
454
+ disambiguation: import("zod").ZodOptional<import("zod").ZodString>;
455
+ type: import("zod").ZodOptional<import("zod").ZodString>;
456
+ artistCredit: import("zod").ZodOptional<import("zod").ZodString>;
457
+ date: import("zod").ZodOptional<import("zod").ZodString>;
458
+ country: import("zod").ZodOptional<import("zod").ZodString>;
459
+ length: import("zod").ZodOptional<import("zod").ZodString>;
460
+ isrcs: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
461
+ iswcs: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
462
+ }, import("zod/v4/core").$strip>>;
463
+ }, import("zod/v4/core").$strip>, undefined, {
464
+ readonly effectiveQuery: import("zod").ZodString;
465
+ readonly totalCount: import("zod").ZodNumber;
466
+ readonly notice: import("zod").ZodOptional<import("zod").ZodString>;
467
+ }>)[];
468
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +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"}