@openverb/music-atlas 0.1.0

package/dist/openverb.js

@@ -0,0 +1,299 @@
+// src/openverb.ts
+import { createExecutor, loadLibrary } from "openverb";
+
+// openverb.music_atlas.json
+var openverb_music_atlas_default = {
+  namespace: "openverb.music_atlas",
+  version: "0.1.0",
+  description: "Read-only verbs for the World Music Atlas on Open Music Atlas: find places and their songs, list editions, get GeoJSON and embeddable players. No verb changes anything.",
+  verbs: [
+    {
+      name: "find_place",
+      category: "places",
+      description: "Find one place in the atlas by name, ISO 3166-1 alpha-2 code or slug. Case- and accent-insensitive.",
+      params: {
+        query: {
+          type: "string",
+          description: "A place name ('Jamaica', 'cote d'ivoire'), ISO code ('JM') or slug ('jamaica').",
+          required: true
+        }
+      },
+      returns: {
+        place: {
+          type: "object",
+          description: "The place: slug, name, isoCode, kind, continent, region, coordinates [lon, lat], isDisputed, pageUrl."
+        }
+      },
+      destructive: false,
+      requires_confirmation: false
+    },
+    {
+      name: "search_places",
+      category: "places",
+      description: "Places whose name contains the query, names starting with it first.",
+      params: {
+        query: {
+          type: "string",
+          description: "Part of a place name, e.g. 'guinea'.",
+          required: true
+        }
+      },
+      returns: {
+        places: {
+          type: "array<object>",
+          description: "Matching places."
+        },
+        count: {
+          type: "number",
+          description: "How many places matched."
+        }
+      },
+      destructive: false,
+      requires_confirmation: false
+    },
+    {
+      name: "list_places",
+      category: "places",
+      description: "List places in listening order, optionally narrowed to a UN M49 continent, region or kind.",
+      params: {
+        continent: {
+          type: "string",
+          description: "A continent, e.g. 'Africa', 'Americas', 'Asia', 'Europe', 'Oceania', 'Antarctica'.",
+          required: false
+        },
+        region: {
+          type: "string",
+          description: "A region, e.g. 'Caribbean', 'Western Africa', 'South-eastern Asia'.",
+          required: false
+        },
+        kind: {
+          type: "enum",
+          description: "The kind of place. 'place' is used where classification is contested.",
+          enum: ["country", "territory", "continent", "place"],
+          required: false
+        }
+      },
+      returns: {
+        places: {
+          type: "array<object>",
+          description: "The places."
+        },
+        count: {
+          type: "number",
+          description: "How many places."
+        }
+      },
+      destructive: false,
+      requires_confirmation: false
+    },
+    {
+      name: "get_place_song",
+      category: "songs",
+      description: "A place's song in an edition: its title, description, musical style, page and embeddable player.",
+      params: {
+        place: {
+          type: "string",
+          description: "The place's name, ISO code or slug.",
+          required: true
+        },
+        edition: {
+          type: "string",
+          description: "The edition's slug. Defaults to the 2026 Founding Edition ('2026-founding').",
+          required: false
+        }
+      },
+      returns: {
+        place: {
+          type: "object",
+          description: "The place."
+        },
+        edition: {
+          type: "object",
+          description: "The edition: slug, name, year, version, frozenAt."
+        },
+        entry: {
+          type: "object",
+          description: "The song: title, description, style, curatorsSelection, pageUrl, embedUrl."
+        }
+      },
+      destructive: false,
+      requires_confirmation: false
+    },
+    {
+      name: "get_embed_player",
+      category: "songs",
+      description: "The embeddable player for a place's song: its URL and a ready-to-use iframe.",
+      params: {
+        place: {
+          type: "string",
+          description: "The place's name, ISO code or slug.",
+          required: true
+        },
+        edition: {
+          type: "string",
+          description: "The edition's slug. Defaults to '2026-founding'.",
+          required: false
+        },
+        width: {
+          type: "string",
+          description: "The frame's width, e.g. '100%' or '300'. Defaults to '100%'.",
+          required: false
+        },
+        height: {
+          type: "string",
+          description: "The frame's height. Defaults to '212', which fits the player.",
+          required: false
+        }
+      },
+      returns: {
+        embed_url: {
+          type: "string",
+          description: "The player's URL."
+        },
+        html: {
+          type: "string",
+          description: "An iframe for the player."
+        }
+      },
+      destructive: false,
+      requires_confirmation: false
+    },
+    {
+      name: "list_editions",
+      category: "editions",
+      description: "Every published edition of the World Music Atlas, newest first.",
+      params: {},
+      returns: {
+        editions: {
+          type: "array<object>",
+          description: "Editions: slug, name, collection, year, version, styleConstraint, frozenAt, entryCount, pageUrl."
+        },
+        count: {
+          type: "number",
+          description: "How many editions."
+        }
+      },
+      destructive: false,
+      requires_confirmation: false
+    },
+    {
+      name: "get_edition",
+      category: "editions",
+      description: "An edition and every song in it, in listening order.",
+      params: {
+        edition: {
+          type: "string",
+          description: "The edition's slug. Defaults to '2026-founding'.",
+          required: false
+        }
+      },
+      returns: {
+        edition: {
+          type: "object",
+          description: "The edition."
+        },
+        entries: {
+          type: "array<object>",
+          description: "Each place and its song."
+        }
+      },
+      destructive: false,
+      requires_confirmation: false
+    },
+    {
+      name: "get_geojson",
+      category: "maps",
+      description: "An edition as a GeoJSON FeatureCollection: one point per place, with the place and its song as properties.",
+      params: {
+        edition: {
+          type: "string",
+          description: "The edition's slug. Defaults to '2026-founding'.",
+          required: false
+        }
+      },
+      returns: {
+        geojson: {
+          type: "object",
+          description: "A GeoJSON FeatureCollection, EPSG:4326."
+        }
+      },
+      destructive: false,
+      requires_confirmation: false
+    }
+  ]
+};
+
+// src/openverb.ts
+import { atlas, FOUNDING_EDITION } from "@openverb/music-atlas";
+var MUSIC_ATLAS_NAMESPACE = "openverb.music_atlas";
+var musicAtlasLibrary = loadLibrary(openverb_music_atlas_default);
+var ok = (verb, data) => ({ verb, status: "success", data });
+var fail = (verb, message) => ({ verb, status: "error", error_message: message });
+var text = (v) => v === void 0 || v === null || v === "" ? void 0 : String(v);
+function registerMusicAtlasVerbs(executor, client = atlas) {
+  const findOrFail = async (verb, query) => {
+    const place = await client.find(String(query ?? ""));
+    return place ? { place } : { error: fail(verb, `No place in the atlas matches "${query}".`) };
+  };
+  executor.register("find_place", async ({ query }) => {
+    const found = await findOrFail("find_place", query);
+    return "error" in found ? found.error : ok("find_place", { place: found.place });
+  });
+  executor.register("search_places", async ({ query }) => {
+    const places = await client.search(String(query ?? ""));
+    return ok("search_places", { places, count: places.length });
+  });
+  executor.register("list_places", async ({ continent, region, kind }) => {
+    const places = await client.places({
+      continent: text(continent),
+      region: text(region),
+      kind: text(kind)
+    });
+    return ok("list_places", { places, count: places.length });
+  });
+  executor.register("get_place_song", async ({ place, edition }) => {
+    const found = await findOrFail("get_place_song", place);
+    if ("error" in found) return found.error;
+    const slug = text(edition) ?? FOUNDING_EDITION;
+    const detail = await client.place(found.place.slug);
+    const match = detail?.entries.find((e) => e.edition.slug === slug);
+    if (!match) return fail("get_place_song", `${found.place.name} has no song in the edition "${slug}".`);
+    return ok("get_place_song", { place: found.place, edition: match.edition, entry: match.entry });
+  });
+  executor.register("get_embed_player", async ({ place, edition, width, height }) => {
+    const found = await findOrFail("get_embed_player", place);
+    if ("error" in found) return found.error;
+    const slug = text(edition) ?? FOUNDING_EDITION;
+    return ok("get_embed_player", {
+      place: found.place,
+      embed_url: client.embedUrl(found.place, slug),
+      html: client.embedHtml(found.place, slug, { width: text(width), height: text(height) })
+    });
+  });
+  executor.register("list_editions", async () => {
+    const editions = await client.editions();
+    return ok("list_editions", { editions, count: editions.length });
+  });
+  executor.register("get_edition", async ({ edition }) => {
+    const slug = text(edition) ?? FOUNDING_EDITION;
+    const detail = await client.edition(slug);
+    return detail ? ok("get_edition", detail) : fail("get_edition", `There is no edition "${slug}".`);
+  });
+  executor.register("get_geojson", async ({ edition }) => {
+    const slug = text(edition) ?? FOUNDING_EDITION;
+    const geojson = await client.geojson(slug);
+    return geojson ? ok("get_geojson", { geojson }) : fail("get_geojson", `There is no edition "${slug}".`);
+  });
+}
+function createMusicAtlasExecutor(client = atlas) {
+  const executor = createExecutor(musicAtlasLibrary);
+  registerMusicAtlasVerbs(executor, client);
+  return executor;
+}
+export {
+  MUSIC_ATLAS_NAMESPACE,
+  createMusicAtlasExecutor,
+  musicAtlasLibrary,
+  registerMusicAtlasVerbs
+};
+//# sourceMappingURL=openverb.js.map

package/dist/openverb.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/openverb.ts","../openverb.music_atlas.json"],"sourcesContent":["/**\n * The World Music Atlas as OpenVerb verbs, so an AI agent built on OpenVerb\n * can find places, their songs, editions, GeoJSON and players.\n *\n * ```ts\n * import { createMusicAtlasExecutor } from \"@openverb/music-atlas/openverb\"\n *\n * const executor = createMusicAtlasExecutor()\n * await executor.execute({ verb: \"get_place_song\", params: { place: \"Jamaica\" } })\n * ```\n *\n * Needs `openverb` (npm install openverb). Every verb is read-only.\n */\nimport { createExecutor, loadLibrary } from \"openverb\"\nimport type { ActionResult, VerbHandler, VerbLibrary } from \"openverb\"\nimport library from \"../openverb.music_atlas.json\"\n// By package name, not \"./index\": the built file then shares the main entry's\n// client instead of carrying its own copy, whose class TypeScript would treat\n// as a different type from the OpenMusicAtlas you import and pass in.\nimport { atlas, FOUNDING_EDITION, type OpenMusicAtlas, type Place, type PlaceKind } from \"@openverb/music-atlas\"\n\nexport const MUSIC_ATLAS_NAMESPACE = \"openverb.music_atlas\"\n\n/** The verb library: everything an AI may do with the World Music Atlas. */\n// The JSON's inferred type is narrower than VerbLibrary's open records, hence via unknown.\nexport const musicAtlasLibrary: VerbLibrary = loadLibrary(library as unknown as VerbLibrary)\n\n/** Anything handlers can be registered on — an OpenVerb executor, or your own registry. */\nexport interface VerbRegistrar {\n  register(verbName: string, handler: VerbHandler): void\n}\n\nconst ok = (verb: string, data: unknown): ActionResult => ({ verb, status: \"success\", data })\nconst fail = (verb: string, message: string): ActionResult => ({ verb, status: \"error\", error_message: message })\nconst text = (v: unknown) => (v === undefined || v === null || v === \"\" ? undefined : String(v))\n\n/**\n * Register a handler for every Music Atlas verb on an executor, using the\n * given client (by default, the one for https://openmusicatlas.org).\n */\nexport function registerMusicAtlasVerbs(executor: VerbRegistrar, client: OpenMusicAtlas = atlas): void {\n  // Typed explicitly: an inferred union gives both branches an optional\n  // `error`, and `\"error\" in found` would no longer tell them apart.\n  const findOrFail = async (verb: string, query: unknown): Promise<{ place: Place } | { error: ActionResult }> => {\n    const place = await client.find(String(query ?? \"\"))\n    return place ? { place } : { error: fail(verb, `No place in the atlas matches \"${query}\".`) }\n  }\n\n  executor.register(\"find_place\", async ({ query }) => {\n    const found = await findOrFail(\"find_place\", query)\n    return \"error\" in found ? found.error : ok(\"find_place\", { place: found.place })\n  })\n\n  executor.register(\"search_places\", async ({ query }) => {\n    const places = await client.search(String(query ?? \"\"))\n    return ok(\"search_places\", { places, count: places.length })\n  })\n\n  executor.register(\"list_places\", async ({ continent, region, kind }) => {\n    const places = await client.places({\n      continent: text(continent),\n      region: text(region),\n      kind: text(kind) as PlaceKind | undefined,\n    })\n    return ok(\"list_places\", { places, count: places.length })\n  })\n\n  executor.register(\"get_place_song\", async ({ place, edition }) => {\n    const found = await findOrFail(\"get_place_song\", place)\n    if (\"error\" in found) return found.error\n    const slug = text(edition) ?? FOUNDING_EDITION\n    const detail = await client.place(found.place.slug)\n    const match = detail?.entries.find((e) => e.edition.slug === slug)\n    if (!match) return fail(\"get_place_song\", `${found.place.name} has no song in the edition \"${slug}\".`)\n    return ok(\"get_place_song\", { place: found.place, edition: match.edition, entry: match.entry })\n  })\n\n  executor.register(\"get_embed_player\", async ({ place, edition, width, height }) => {\n    const found = await findOrFail(\"get_embed_player\", place)\n    if (\"error\" in found) return found.error\n    const slug = text(edition) ?? FOUNDING_EDITION\n    return ok(\"get_embed_player\", {\n      place: found.place,\n      embed_url: client.embedUrl(found.place, slug),\n      html: client.embedHtml(found.place, slug, { width: text(width), height: text(height) }),\n    })\n  })\n\n  executor.register(\"list_editions\", async () => {\n    const editions = await client.editions()\n    return ok(\"list_editions\", { editions, count: editions.length })\n  })\n\n  executor.register(\"get_edition\", async ({ edition }) => {\n    const slug = text(edition) ?? FOUNDING_EDITION\n    const detail = await client.edition(slug)\n    return detail ? ok(\"get_edition\", detail) : fail(\"get_edition\", `There is no edition \"${slug}\".`)\n  })\n\n  executor.register(\"get_geojson\", async ({ edition }) => {\n    const slug = text(edition) ?? FOUNDING_EDITION\n    const geojson = await client.geojson(slug)\n    return geojson ? ok(\"get_geojson\", { geojson }) : fail(\"get_geojson\", `There is no edition \"${slug}\".`)\n  })\n}\n\n/** An OpenVerb executor with every Music Atlas verb registered and ready to run. */\nexport function createMusicAtlasExecutor(client: OpenMusicAtlas = atlas) {\n  const executor = createExecutor(musicAtlasLibrary)\n  registerMusicAtlasVerbs(executor, client)\n  return executor\n}\n","{\n  \"namespace\": \"openverb.music_atlas\",\n  \"version\": \"0.1.0\",\n  \"description\": \"Read-only verbs for the World Music Atlas on Open Music Atlas: find places and their songs, list editions, get GeoJSON and embeddable players. No verb changes anything.\",\n  \"verbs\": [\n    {\n      \"name\": \"find_place\",\n      \"category\": \"places\",\n      \"description\": \"Find one place in the atlas by name, ISO 3166-1 alpha-2 code or slug. Case- and accent-insensitive.\",\n      \"params\": {\n        \"query\": {\n          \"type\": \"string\",\n          \"description\": \"A place name ('Jamaica', 'cote d'ivoire'), ISO code ('JM') or slug ('jamaica').\",\n          \"required\": true\n        }\n      },\n      \"returns\": {\n        \"place\": {\n          \"type\": \"object\",\n          \"description\": \"The place: slug, name, isoCode, kind, continent, region, coordinates [lon, lat], isDisputed, pageUrl.\"\n        }\n      },\n      \"destructive\": false,\n      \"requires_confirmation\": false\n    },\n    {\n      \"name\": \"search_places\",\n      \"category\": \"places\",\n      \"description\": \"Places whose name contains the query, names starting with it first.\",\n      \"params\": {\n        \"query\": {\n          \"type\": \"string\",\n          \"description\": \"Part of a place name, e.g. 'guinea'.\",\n          \"required\": true\n        }\n      },\n      \"returns\": {\n        \"places\": {\n          \"type\": \"array<object>\",\n          \"description\": \"Matching places.\"\n        },\n        \"count\": {\n          \"type\": \"number\",\n          \"description\": \"How many places matched.\"\n        }\n      },\n      \"destructive\": false,\n      \"requires_confirmation\": false\n    },\n    {\n      \"name\": \"list_places\",\n      \"category\": \"places\",\n      \"description\": \"List places in listening order, optionally narrowed to a UN M49 continent, region or kind.\",\n      \"params\": {\n        \"continent\": {\n          \"type\": \"string\",\n          \"description\": \"A continent, e.g. 'Africa', 'Americas', 'Asia', 'Europe', 'Oceania', 'Antarctica'.\",\n          \"required\": false\n        },\n        \"region\": {\n          \"type\": \"string\",\n          \"description\": \"A region, e.g. 'Caribbean', 'Western Africa', 'South-eastern Asia'.\",\n          \"required\": false\n        },\n        \"kind\": {\n          \"type\": \"enum\",\n          \"description\": \"The kind of place. 'place' is used where classification is contested.\",\n          \"enum\": [\"country\", \"territory\", \"continent\", \"place\"],\n          \"required\": false\n        }\n      },\n      \"returns\": {\n        \"places\": {\n          \"type\": \"array<object>\",\n          \"description\": \"The places.\"\n        },\n        \"count\": {\n          \"type\": \"number\",\n          \"description\": \"How many places.\"\n        }\n      },\n      \"destructive\": false,\n      \"requires_confirmation\": false\n    },\n    {\n      \"name\": \"get_place_song\",\n      \"category\": \"songs\",\n      \"description\": \"A place's song in an edition: its title, description, musical style, page and embeddable player.\",\n      \"params\": {\n        \"place\": {\n          \"type\": \"string\",\n          \"description\": \"The place's name, ISO code or slug.\",\n          \"required\": true\n        },\n        \"edition\": {\n          \"type\": \"string\",\n          \"description\": \"The edition's slug. Defaults to the 2026 Founding Edition ('2026-founding').\",\n          \"required\": false\n        }\n      },\n      \"returns\": {\n        \"place\": {\n          \"type\": \"object\",\n          \"description\": \"The place.\"\n        },\n        \"edition\": {\n          \"type\": \"object\",\n          \"description\": \"The edition: slug, name, year, version, frozenAt.\"\n        },\n        \"entry\": {\n          \"type\": \"object\",\n          \"description\": \"The song: title, description, style, curatorsSelection, pageUrl, embedUrl.\"\n        }\n      },\n      \"destructive\": false,\n      \"requires_confirmation\": false\n    },\n    {\n      \"name\": \"get_embed_player\",\n      \"category\": \"songs\",\n      \"description\": \"The embeddable player for a place's song: its URL and a ready-to-use iframe.\",\n      \"params\": {\n        \"place\": {\n          \"type\": \"string\",\n          \"description\": \"The place's name, ISO code or slug.\",\n          \"required\": true\n        },\n        \"edition\": {\n          \"type\": \"string\",\n          \"description\": \"The edition's slug. Defaults to '2026-founding'.\",\n          \"required\": false\n        },\n        \"width\": {\n          \"type\": \"string\",\n          \"description\": \"The frame's width, e.g. '100%' or '300'. Defaults to '100%'.\",\n          \"required\": false\n        },\n        \"height\": {\n          \"type\": \"string\",\n          \"description\": \"The frame's height. Defaults to '212', which fits the player.\",\n          \"required\": false\n        }\n      },\n      \"returns\": {\n        \"embed_url\": {\n          \"type\": \"string\",\n          \"description\": \"The player's URL.\"\n        },\n        \"html\": {\n          \"type\": \"string\",\n          \"description\": \"An iframe for the player.\"\n        }\n      },\n      \"destructive\": false,\n      \"requires_confirmation\": false\n    },\n    {\n      \"name\": \"list_editions\",\n      \"category\": \"editions\",\n      \"description\": \"Every published edition of the World Music Atlas, newest first.\",\n      \"params\": {},\n      \"returns\": {\n        \"editions\": {\n          \"type\": \"array<object>\",\n          \"description\": \"Editions: slug, name, collection, year, version, styleConstraint, frozenAt, entryCount, pageUrl.\"\n        },\n        \"count\": {\n          \"type\": \"number\",\n          \"description\": \"How many editions.\"\n        }\n      },\n      \"destructive\": false,\n      \"requires_confirmation\": false\n    },\n    {\n      \"name\": \"get_edition\",\n      \"category\": \"editions\",\n      \"description\": \"An edition and every song in it, in listening order.\",\n      \"params\": {\n        \"edition\": {\n          \"type\": \"string\",\n          \"description\": \"The edition's slug. Defaults to '2026-founding'.\",\n          \"required\": false\n        }\n      },\n      \"returns\": {\n        \"edition\": {\n          \"type\": \"object\",\n          \"description\": \"The edition.\"\n        },\n        \"entries\": {\n          \"type\": \"array<object>\",\n          \"description\": \"Each place and its song.\"\n        }\n      },\n      \"destructive\": false,\n      \"requires_confirmation\": false\n    },\n    {\n      \"name\": \"get_geojson\",\n      \"category\": \"maps\",\n      \"description\": \"An edition as a GeoJSON FeatureCollection: one point per place, with the place and its song as properties.\",\n      \"params\": {\n        \"edition\": {\n          \"type\": \"string\",\n          \"description\": \"The edition's slug. Defaults to '2026-founding'.\",\n          \"required\": false\n        }\n      },\n      \"returns\": {\n        \"geojson\": {\n          \"type\": \"object\",\n          \"description\": \"A GeoJSON FeatureCollection, EPSG:4326.\"\n        }\n      },\n      \"destructive\": false,\n      \"requires_confirmation\": false\n    }\n  ]\n}\n"],"mappings":"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","names":[]}

package/openverb.music_atlas.json

@@ -0,0 +1,220 @@
+{
+  "namespace": "openverb.music_atlas",
+  "version": "0.1.0",
+  "description": "Read-only verbs for the World Music Atlas on Open Music Atlas: find places and their songs, list editions, get GeoJSON and embeddable players. No verb changes anything.",
+  "verbs": [
+    {
+      "name": "find_place",
+      "category": "places",
+      "description": "Find one place in the atlas by name, ISO 3166-1 alpha-2 code or slug. Case- and accent-insensitive.",
+      "params": {
+        "query": {
+          "type": "string",
+          "description": "A place name ('Jamaica', 'cote d'ivoire'), ISO code ('JM') or slug ('jamaica').",
+          "required": true
+        }
+      },
+      "returns": {
+        "place": {
+          "type": "object",
+          "description": "The place: slug, name, isoCode, kind, continent, region, coordinates [lon, lat], isDisputed, pageUrl."
+        }
+      },
+      "destructive": false,
+      "requires_confirmation": false
+    },
+    {
+      "name": "search_places",
+      "category": "places",
+      "description": "Places whose name contains the query, names starting with it first.",
+      "params": {
+        "query": {
+          "type": "string",
+          "description": "Part of a place name, e.g. 'guinea'.",
+          "required": true
+        }
+      },
+      "returns": {
+        "places": {
+          "type": "array<object>",
+          "description": "Matching places."
+        },
+        "count": {
+          "type": "number",
+          "description": "How many places matched."
+        }
+      },
+      "destructive": false,
+      "requires_confirmation": false
+    },
+    {
+      "name": "list_places",
+      "category": "places",
+      "description": "List places in listening order, optionally narrowed to a UN M49 continent, region or kind.",
+      "params": {
+        "continent": {
+          "type": "string",
+          "description": "A continent, e.g. 'Africa', 'Americas', 'Asia', 'Europe', 'Oceania', 'Antarctica'.",
+          "required": false
+        },
+        "region": {
+          "type": "string",
+          "description": "A region, e.g. 'Caribbean', 'Western Africa', 'South-eastern Asia'.",
+          "required": false
+        },
+        "kind": {
+          "type": "enum",
+          "description": "The kind of place. 'place' is used where classification is contested.",
+          "enum": ["country", "territory", "continent", "place"],
+          "required": false
+        }
+      },
+      "returns": {
+        "places": {
+          "type": "array<object>",
+          "description": "The places."
+        },
+        "count": {
+          "type": "number",
+          "description": "How many places."
+        }
+      },
+      "destructive": false,
+      "requires_confirmation": false
+    },
+    {
+      "name": "get_place_song",
+      "category": "songs",
+      "description": "A place's song in an edition: its title, description, musical style, page and embeddable player.",
+      "params": {
+        "place": {
+          "type": "string",
+          "description": "The place's name, ISO code or slug.",
+          "required": true
+        },
+        "edition": {
+          "type": "string",
+          "description": "The edition's slug. Defaults to the 2026 Founding Edition ('2026-founding').",
+          "required": false
+        }
+      },
+      "returns": {
+        "place": {
+          "type": "object",
+          "description": "The place."
+        },
+        "edition": {
+          "type": "object",
+          "description": "The edition: slug, name, year, version, frozenAt."
+        },
+        "entry": {
+          "type": "object",
+          "description": "The song: title, description, style, curatorsSelection, pageUrl, embedUrl."
+        }
+      },
+      "destructive": false,
+      "requires_confirmation": false
+    },
+    {
+      "name": "get_embed_player",
+      "category": "songs",
+      "description": "The embeddable player for a place's song: its URL and a ready-to-use iframe.",
+      "params": {
+        "place": {
+          "type": "string",
+          "description": "The place's name, ISO code or slug.",
+          "required": true
+        },
+        "edition": {
+          "type": "string",
+          "description": "The edition's slug. Defaults to '2026-founding'.",
+          "required": false
+        },
+        "width": {
+          "type": "string",
+          "description": "The frame's width, e.g. '100%' or '300'. Defaults to '100%'.",
+          "required": false
+        },
+        "height": {
+          "type": "string",
+          "description": "The frame's height. Defaults to '212', which fits the player.",
+          "required": false
+        }
+      },
+      "returns": {
+        "embed_url": {
+          "type": "string",
+          "description": "The player's URL."
+        },
+        "html": {
+          "type": "string",
+          "description": "An iframe for the player."
+        }
+      },
+      "destructive": false,
+      "requires_confirmation": false
+    },
+    {
+      "name": "list_editions",
+      "category": "editions",
+      "description": "Every published edition of the World Music Atlas, newest first.",
+      "params": {},
+      "returns": {
+        "editions": {
+          "type": "array<object>",
+          "description": "Editions: slug, name, collection, year, version, styleConstraint, frozenAt, entryCount, pageUrl."
+        },
+        "count": {
+          "type": "number",
+          "description": "How many editions."
+        }
+      },
+      "destructive": false,
+      "requires_confirmation": false
+    },
+    {
+      "name": "get_edition",
+      "category": "editions",
+      "description": "An edition and every song in it, in listening order.",
+      "params": {
+        "edition": {
+          "type": "string",
+          "description": "The edition's slug. Defaults to '2026-founding'.",
+          "required": false
+        }
+      },
+      "returns": {
+        "edition": {
+          "type": "object",
+          "description": "The edition."
+        },
+        "entries": {
+          "type": "array<object>",
+          "description": "Each place and its song."
+        }
+      },
+      "destructive": false,
+      "requires_confirmation": false
+    },
+    {
+      "name": "get_geojson",
+      "category": "maps",
+      "description": "An edition as a GeoJSON FeatureCollection: one point per place, with the place and its song as properties.",
+      "params": {
+        "edition": {
+          "type": "string",
+          "description": "The edition's slug. Defaults to '2026-founding'.",
+          "required": false
+        }
+      },
+      "returns": {
+        "geojson": {
+          "type": "object",
+          "description": "A GeoJSON FeatureCollection, EPSG:4326."
+        }
+      },
+      "destructive": false,
+      "requires_confirmation": false
+    }
+  ]
+}

package/package.json

@@ -0,0 +1,87 @@
+{
+  "name": "@openverb/music-atlas",
+  "version": "0.1.0",
+  "description": "The official SDK for Open Music Atlas: the World Music Atlas's places, songs, editions, GeoJSON and embeddable players, with OpenVerb verbs for AI agents.",
+  "keywords": [
+    "openverb",
+    "open-music-atlas",
+    "world-music-atlas",
+    "music",
+    "geography",
+    "gis",
+    "geojson",
+    "maps",
+    "leaflet",
+    "maplibre",
+    "ai",
+    "agent",
+    "verbs"
+  ],
+  "author": "Roman Hancel <roman@romanhancel.com>",
+  "homepage": "https://openmusicatlas.org/developers",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/sgthancel/openverb-music-atlas.git"
+  },
+  "bugs": {
+    "url": "https://github.com/sgthancel/openverb-music-atlas/issues"
+  },
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    },
+    "./openverb": {
+      "types": "./dist/openverb.d.ts",
+      "import": "./dist/openverb.js"
+    },
+    "./openverb.music_atlas.json": "./openverb.music_atlas.json",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "openverb.music_atlas.json",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md"
+  ],
+  "sideEffects": false,
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "build": "node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\" && tsup",
+    "typecheck": "tsc --noEmit",
+    "test": "npm run build && node --test test/client.test.mjs test/cjs.test.cjs test/openverb.test.mjs",
+    "test:live": "npm run build && node --test test/live.test.mjs",
+    "prepublishOnly": "npm run typecheck && npm test"
+  },
+  "peerDependencies": {
+    "openverb": ">=0.1.0"
+  },
+  "peerDependenciesMeta": {
+    "openverb": {
+      "optional": true
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "@types/node": "^22",
+    "openverb": "^0.1.0",
+    "tsup": "^8.3.5",
+    "typescript": "^5.6.3"
+  }
+}