roon-mcp 0.1.0

package/dist/RoonMcpServer.js

@@ -0,0 +1,218 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+import { RoonMcpError } from "./types.js";
+const MUSIC_ITEM_TYPES = [
+    "artist",
+    "album",
+    "track",
+    "genre",
+    "playlist",
+    "radio",
+    "unknown",
+];
+/**
+ * Owns MCP startup and tool registration, and maps tool calls to services.
+ * Milestone 1 ships only `list_zones`.
+ */
+export class RoonMcpServer {
+    roon;
+    zones;
+    search;
+    tracks;
+    playback;
+    server;
+    constructor(roon, zones, search, tracks, playback) {
+        this.roon = roon;
+        this.zones = zones;
+        this.search = search;
+        this.tracks = tracks;
+        this.playback = playback;
+        this.server = new McpServer({
+            name: "roon-mcp",
+            version: "0.1.0",
+        });
+        this.registerTools();
+    }
+    registerTools() {
+        this.server.registerTool("list_zones", {
+            title: "List Roon zones",
+            description: "List the playable zones/outputs exposed by the paired Roon Core. " +
+                "Returns each zone's id, display name, playback state, and output ids.",
+            inputSchema: {},
+        }, async () => {
+            try {
+                const zones = await this.zones.listZones();
+                const message = zones.length === 0 ? "No zones available on the paired Core." : undefined;
+                return structured({ zones, ...(message ? { message } : {}) });
+            }
+            catch (err) {
+                return toToolError(err);
+            }
+        });
+        this.server.registerTool("search_music", {
+            title: "Search Roon music",
+            description: "Resolve a text query into ranked Roon browse candidates. Optionally " +
+                "filter by item type (artist, album, track, genre, playlist, radio); " +
+                "for non-genre types, an empty typed search broadens to all categories. " +
+                "type:\"genre\" is special: genres don't appear in Roon's flat search, so " +
+                "the server walks the dedicated Genres tree and returns the nearest-match " +
+                "genre nodes (with their parent path in the subtitle) without broadening — " +
+                "e.g. \"Psychedelic Trance\" yields \"Psytrance\"/\"Trance\". Set " +
+                "includeStreaming:true (only meaningful for type:\"genre\") to also pull a " +
+                "track mix from streaming services (e.g. TIDAL): the server takes the " +
+                "genre-relevant albums and samples tracks across them, so library genre " +
+                "nodes are listed first and ready-to-play streaming tracks appended after. " +
+                "Returns opaque, session-scoped item keys for use by playback tools.",
+            inputSchema: {
+                query: z.string().min(1).describe("Free-text search, e.g. 'Dark Ambient' or 'Tycho'."),
+                type: z
+                    .enum(MUSIC_ITEM_TYPES)
+                    .optional()
+                    .describe("Restrict results to this item type."),
+                limit: z
+                    .number()
+                    .int()
+                    .min(1)
+                    .max(50)
+                    .optional()
+                    .describe("Max candidates to return (default 10)."),
+                includeStreaming: z
+                    .boolean()
+                    .optional()
+                    .describe("Also pull a track mix from streaming services. " +
+                    "Only applies when type is \"genre\": library genre nodes come first, " +
+                    "then tracks sampled across genre-relevant streaming albums. Default false."),
+            },
+        }, async (args) => {
+            try {
+                const result = await this.search.searchMusic(args);
+                return structured(result);
+            }
+            catch (err) {
+                return toToolError(err);
+            }
+        });
+        this.server.registerTool("get_tracks_for", {
+            title: "Expand a Roon item into tracks",
+            description: "Expand an artist, album, genre, or playlist candidate into concrete " +
+                "playable tracks. Pass an itemKey from a recent search_music result. " +
+                "Returns track candidates with session-scoped item keys (use them " +
+                "promptly with enqueue_and_play). Non-expandable items return empty " +
+                "tracks with a skipped reason rather than an error.",
+            inputSchema: {
+                itemKey: z
+                    .string()
+                    .min(1)
+                    .describe("Opaque item key from a recent search_music result."),
+                limit: z
+                    .number()
+                    .int()
+                    .min(1)
+                    .max(50)
+                    .optional()
+                    .describe("Max tracks to return (default 10)."),
+            },
+        }, async (args) => {
+            try {
+                const result = await this.tracks.getTracksFor(args);
+                return structured(result);
+            }
+            catch (err) {
+                return toToolError(err);
+            }
+        });
+        this.server.registerTool("play_now", {
+            title: "Play an item now in a Roon zone",
+            description: "Immediately play a single search candidate in the target zone. Pass an " +
+                "itemKey from a recent search_music result (item keys are session-scoped, " +
+                "so use a fresh one). zoneId is optional: omit it to use the configured " +
+                "default zone (ROON_DEFAULT_ZONE) or the single/Office/playing fallback; " +
+                "an ambiguous result returns ZONE_AMBIGUOUS so you can ask. Optionally " +
+                "shuffle. Returns a PlaybackResult.",
+            inputSchema: {
+                zoneId: z
+                    .string()
+                    .min(1)
+                    .optional()
+                    .describe("Target zone id or output id (from list_zones). Omit to use the default zone."),
+                itemKey: z
+                    .string()
+                    .min(1)
+                    .describe("Opaque item key from a recent search_music result."),
+                shuffle: z
+                    .boolean()
+                    .optional()
+                    .describe("Shuffle the selection when starting playback."),
+            },
+        }, async (args) => {
+            try {
+                const result = await this.playback.playNow(args);
+                return structured(result);
+            }
+            catch (err) {
+                return toToolError(err);
+            }
+        });
+        this.server.registerTool("enqueue_and_play", {
+            title: "Build and start a curated Roon queue",
+            description: "Build an ad-hoc queue from an ordered list of curated item keys and " +
+                "start playback in the target zone. This replaces the zone's current " +
+                "queue: the first playable item starts immediately (Play Now), the rest " +
+                "are appended in order. Pass itemKeys from recent get_tracks_for/" +
+                "search_music results (use them promptly — they are session-scoped). " +
+                "zoneId is optional (omit to use the default zone; see play_now). " +
+                "Optionally shuffle. Returns a PlaybackResult with queued/skipped counts " +
+                "so you can backfill skipped items.",
+            inputSchema: {
+                zoneId: z
+                    .string()
+                    .min(1)
+                    .optional()
+                    .describe("Target zone id or output id (from list_zones). Omit to use the default zone."),
+                itemKeys: z
+                    .array(z.string().min(1))
+                    .min(1)
+                    .describe("Ordered item keys to queue (from get_tracks_for/search_music)."),
+                shuffle: z
+                    .boolean()
+                    .optional()
+                    .describe("Shuffle the queue; omit to leave the zone's setting unchanged."),
+            },
+        }, async (args) => {
+            try {
+                const result = await this.playback.enqueueAndPlay(args);
+                return structured(result);
+            }
+            catch (err) {
+                return toToolError(err);
+            }
+        });
+    }
+    async start() {
+        this.roon.start();
+        const transport = new StdioServerTransport();
+        await this.server.connect(transport);
+    }
+    async stop() {
+        this.roon.stop();
+        await this.server.close();
+    }
+}
+function structured(payload) {
+    return {
+        content: [{ type: "text", text: JSON.stringify(payload, null, 2) }],
+        structuredContent: payload,
+    };
+}
+function toToolError(err) {
+    const code = err instanceof RoonMcpError ? err.code : "BROWSE_FAILED";
+    const message = err instanceof Error ? err.message : String(err);
+    return {
+        isError: true,
+        content: [
+            { type: "text", text: JSON.stringify({ error: { code, message } }, null, 2) },
+        ],
+    };
+}
+//# sourceMappingURL=RoonMcpServer.js.map

package/dist/RoonMcpServer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RoonMcpServer.js","sourceRoot":"","sources":["../src/RoonMcpServer.ts"],"names":[],"mappings":"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"}

package/dist/SearchNavigator.d.ts

@@ -0,0 +1,38 @@
+import type { BrowseHierarchy, BrowseItem, BrowseResultBody } from "node-roon-api-browse";
+import { BrowseSessionManager } from "./BrowseSessionManager.js";
+import { type Locator } from "./locator.js";
+export { hierarchyForLocator } from "./locator.js";
+export declare const SEARCH_HIERARCHY: BrowseHierarchy;
+/** A selectable browse entry: has a key and isn't a header. */
+export declare function isSelectable(item: BrowseItem): boolean;
+/**
+ * Re-navigates the search hierarchy to reach an item by *locator* (query +
+ * group index + item index). Because every step runs in one uninterrupted
+ * browse session, the keys are live at the moment they're used — unlike the raw
+ * keys `search_music` collects and then strands by popping back. See
+ * `locator.ts` for the why.
+ */
+export declare class SearchNavigator {
+    private readonly browse;
+    constructor(browse: BrowseSessionManager);
+    /**
+     * Drill to the item at (loc.g, loc.i) and browse *into* it, leaving the
+     * session positioned at the item's child/action level. Returns that browse
+     * result. Throws INVALID_ITEM_KEY if the indices no longer resolve.
+     *
+     * Compose inside `runExclusive` — this issues a multi-step browse sequence.
+     */
+    openItem(loc: Locator): Promise<BrowseResultBody>;
+    private openSearchItem;
+    /**
+     * Re-walk the `genres` hierarchy by node title, drilling each segment of the
+     * path from the root, and browse *into* the final genre node. Matching by
+     * title (not a stale key) keeps the locator durable across calls — the same
+     * reasoning as the search locator.
+     */
+    private openGenrePath;
+    /** Load the children of the currently-opened item (its actions or sub-list). */
+    loadCurrent(count?: number): Promise<BrowseItem[]>;
+}
+/** Decode an MCP itemKey to a locator, or throw if it isn't a valid locator. */
+export declare function requireLocator(itemKey: string): Locator;

package/dist/SearchNavigator.js

@@ -0,0 +1,104 @@
+import { decodeLocator, isGenreLocator, } from "./locator.js";
+import { RoonMcpError } from "./types.js";
+export { hierarchyForLocator } from "./locator.js";
+// Flat-search results live in the "search" hierarchy; we re-navigate there.
+export const SEARCH_HIERARCHY = "search";
+// Genre nodes live in the dedicated "genres" hierarchy.
+const GENRES_HIERARCHY = "genres";
+// Load generously when re-resolving so a locator index is never cut off by a
+// short page (search itself may have collected with a small `limit`).
+const RESOLVE_COUNT = 100;
+/** A selectable browse entry: has a key and isn't a header. */
+export function isSelectable(item) {
+    return Boolean(item.item_key) && item.hint !== "header";
+}
+const STALE = () => new RoonMcpError("INVALID_ITEM_KEY", "That search result is no longer available; re-run search_music to refresh it.");
+/**
+ * Re-navigates the search hierarchy to reach an item by *locator* (query +
+ * group index + item index). Because every step runs in one uninterrupted
+ * browse session, the keys are live at the moment they're used — unlike the raw
+ * keys `search_music` collects and then strands by popping back. See
+ * `locator.ts` for the why.
+ */
+export class SearchNavigator {
+    browse;
+    constructor(browse) {
+        this.browse = browse;
+    }
+    /**
+     * Drill to the item at (loc.g, loc.i) and browse *into* it, leaving the
+     * session positioned at the item's child/action level. Returns that browse
+     * result. Throws INVALID_ITEM_KEY if the indices no longer resolve.
+     *
+     * Compose inside `runExclusive` — this issues a multi-step browse sequence.
+     */
+    async openItem(loc) {
+        return isGenreLocator(loc) ? this.openGenrePath(loc) : this.openSearchItem(loc);
+    }
+    async openSearchItem(loc) {
+        await this.browse.browse({ hierarchy: SEARCH_HIERARCHY, input: loc.q, pop_all: true });
+        const top = await this.browse.load({
+            hierarchy: SEARCH_HIERARCHY,
+            offset: 0,
+            count: RESOLVE_COUNT,
+        });
+        const group = top.items.filter(isSelectable)[loc.g];
+        if (!group?.item_key)
+            throw STALE();
+        const gnav = await this.browse.browse({ hierarchy: SEARCH_HIERARCHY, item_key: group.item_key });
+        if (gnav.action !== "list")
+            throw STALE();
+        const children = await this.browse.load({
+            hierarchy: SEARCH_HIERARCHY,
+            offset: 0,
+            count: RESOLVE_COUNT,
+        });
+        const item = children.items.filter(isSelectable)[loc.i];
+        if (!item?.item_key)
+            throw STALE();
+        return this.browse.browse({ hierarchy: SEARCH_HIERARCHY, item_key: item.item_key });
+    }
+    /**
+     * Re-walk the `genres` hierarchy by node title, drilling each segment of the
+     * path from the root, and browse *into* the final genre node. Matching by
+     * title (not a stale key) keeps the locator durable across calls — the same
+     * reasoning as the search locator.
+     */
+    async openGenrePath(loc) {
+        await this.browse.browse({ hierarchy: GENRES_HIERARCHY, pop_all: true });
+        let last;
+        for (const name of loc.ge) {
+            const level = await this.browse.load({
+                hierarchy: GENRES_HIERARCHY,
+                offset: 0,
+                count: RESOLVE_COUNT,
+            });
+            const target = name.trim().toLowerCase();
+            const node = level.items
+                .filter(isSelectable)
+                .find((i) => i.title.trim().toLowerCase() === target);
+            if (!node?.item_key)
+                throw STALE();
+            last = await this.browse.browse({ hierarchy: GENRES_HIERARCHY, item_key: node.item_key });
+            if (last.action !== "list")
+                throw STALE();
+        }
+        if (!last)
+            throw STALE();
+        return last;
+    }
+    /** Load the children of the currently-opened item (its actions or sub-list). */
+    async loadCurrent(count = RESOLVE_COUNT) {
+        const loaded = await this.browse.load({ hierarchy: SEARCH_HIERARCHY, offset: 0, count });
+        return loaded.items;
+    }
+}
+/** Decode an MCP itemKey to a locator, or throw if it isn't a valid locator. */
+export function requireLocator(itemKey) {
+    const loc = decodeLocator(itemKey);
+    if (!loc) {
+        throw new RoonMcpError("INVALID_ITEM_KEY", "itemKey is not a valid search_music locator; pass a key from a recent search_music/get_tracks_for result.");
+    }
+    return loc;
+}
+//# sourceMappingURL=SearchNavigator.js.map

package/dist/SearchNavigator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SearchNavigator.js","sourceRoot":"","sources":["../src/SearchNavigator.ts"],"names":[],"mappings":"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"}

package/dist/SearchService.d.ts

@@ -0,0 +1,29 @@
+import { BrowseSessionManager } from "./BrowseSessionManager.js";
+import { GenreService } from "./GenreService.js";
+import { TrackExpansionService } from "./TrackExpansionService.js";
+import { type SearchMusicInput, type SearchMusicOutput } from "./types.js";
+/** Turns a text query into ranked browse candidates via the search hierarchy. */
+export declare class SearchService {
+    private readonly browse;
+    private readonly genres;
+    private readonly tracks;
+    constructor(browse: BrowseSessionManager, genres: GenreService, tracks: TrackExpansionService);
+    searchMusic(input: SearchMusicInput): Promise<SearchMusicOutput>;
+    private searchGenres;
+    /**
+     * Genre discovery beyond the library. Roon's flat search is text-based, not
+     * genre-filtered, so a raw "tracks" search for a genre name returns noise
+     * (tracks with the word in their title). Instead we take the genre-relevant
+     * albums the flat search surfaces (album/artist metadata makes those genuinely
+     * on-genre) and sample a few tracks across them — the same spread-across-albums
+     * approach get_tracks_for uses for library genres — yielding a real cross-album
+     * mix rather than whole albums. Each expansion re-navigates the flat search; an
+     * opt-in cost we accept for the streaming path.
+     */
+    private collectStreamingGenreTracks;
+    private performSearch;
+    /** Indices (into the top-level group list) to scan for the requested type. */
+    private selectGroupIndices;
+    private collectFromGroups;
+    private rankCandidates;
+}

package/dist/SearchService.js

@@ -0,0 +1,236 @@
+import { encodeLocator } from "./locator.js";
+import { SEARCH_HIERARCHY, isSelectable } from "./SearchNavigator.js";
+import { perAlbumBudget } from "./TrackExpansionService.js";
+import { RoonMcpError, } from "./types.js";
+const DEFAULT_LIMIT = 10;
+const MAX_LIMIT = 50;
+const GROUP_SCAN_COUNT = 50;
+// Ensures a candidate of the requested type always outranks any other type,
+// so "exact type matches" sort before broader matches.
+const TYPE_BOOST = 1.0;
+// English Roon search category titles → our item type.
+const GROUP_TITLE_TO_TYPE = {
+    artists: "artist",
+    albums: "album",
+    tracks: "track",
+    genres: "genre",
+    playlists: "playlist",
+    stations: "radio",
+    "internet radio": "radio",
+};
+function normalize(text) {
+    return text.trim().toLowerCase();
+}
+/** Strip a trailing count, e.g. "Albums (12)" → "albums". */
+function groupTitleToType(title) {
+    const cleaned = normalize(title).replace(/\s*\(\d+\)\s*$/, "");
+    return GROUP_TITLE_TO_TYPE[cleaned] ?? "unknown";
+}
+/** Turns a text query into ranked browse candidates via the search hierarchy. */
+export class SearchService {
+    browse;
+    genres;
+    tracks;
+    constructor(browse, genres, tracks) {
+        this.browse = browse;
+        this.genres = genres;
+        this.tracks = tracks;
+    }
+    async searchMusic(input) {
+        const limit = Math.min(Math.max(input.limit ?? DEFAULT_LIMIT, 1), MAX_LIMIT);
+        // Genres don't appear in Roon's flat search; resolve them via the dedicated
+        // `genres` hierarchy instead (GenreService), and never silently broaden to
+        // artists/albums — that hid the failure before.
+        if (input.type === "genre") {
+            return this.searchGenres(input.query, limit, input.includeStreaming);
+        }
+        // Search builds its own item keys inside performSearch, so a stale-session
+        // failure is recoverable with one reset-and-replay (see runExclusiveWithRetry).
+        return this.browse.runExclusiveWithRetry(() => this.performSearch(input, limit));
+    }
+    async searchGenres(query, limit, includeStreaming) {
+        const libraryGenres = await this.genres.searchGenres(query, limit);
+        let streamingTracks = [];
+        if (includeStreaming) {
+            streamingTracks = await this.collectStreamingGenreTracks(query, limit);
+        }
+        const candidates = [...libraryGenres, ...streamingTracks];
+        let message;
+        if (candidates.length === 0) {
+            message = `No results for "${query}".`;
+        }
+        else if (libraryGenres.length === 0) {
+            message = `No library genres matched "${query}"; showing streaming tracks.`;
+        }
+        else if ((libraryGenres[0]?.score ?? 0) < 1) {
+            const suffix = includeStreaming ? "; also showing streaming tracks" : "";
+            message = `No genre exactly named "${query}"; showing nearest genres${suffix}.`;
+        }
+        return { query, candidates, broadened: false, message };
+    }
+    /**
+     * Genre discovery beyond the library. Roon's flat search is text-based, not
+     * genre-filtered, so a raw "tracks" search for a genre name returns noise
+     * (tracks with the word in their title). Instead we take the genre-relevant
+     * albums the flat search surfaces (album/artist metadata makes those genuinely
+     * on-genre) and sample a few tracks across them — the same spread-across-albums
+     * approach get_tracks_for uses for library genres — yielding a real cross-album
+     * mix rather than whole albums. Each expansion re-navigates the flat search; an
+     * opt-in cost we accept for the streaming path.
+     */
+    async collectStreamingGenreTracks(query, limit) {
+        const albumSearch = await this.browse.runExclusiveWithRetry(() => this.performSearch({ query, type: "album" }, limit));
+        const albums = albumSearch.candidates.filter((c) => c.type === "album");
+        if (albums.length === 0)
+            return [];
+        // Spread the budget so the mix draws from several albums, not just the first.
+        const perAlbum = perAlbumBudget(limit, albums.length);
+        const out = [];
+        for (const album of albums) {
+            if (out.length >= limit)
+                break;
+            const expanded = await this.tracks.getTracksFor({ itemKey: album.itemKey, limit: perAlbum });
+            for (const track of expanded.tracks) {
+                if (out.length >= limit)
+                    break;
+                out.push({
+                    itemKey: track.itemKey,
+                    title: track.title,
+                    subtitle: track.artist ?? album.title,
+                    type: "track",
+                    // Inherit the album's relevance so on-genre albums sort their tracks up.
+                    score: album.score,
+                    available: track.available,
+                    sourceGroup: "Streaming",
+                });
+            }
+        }
+        return out;
+    }
+    async performSearch(input, limit) {
+        // Roon only registers the search when `input` and `pop_all` ride in the
+        // same browse call; submitting `input` after a separate reset yields a
+        // "No Results" placeholder. Keep them together.
+        const submitted = await this.browse.browse({
+            hierarchy: SEARCH_HIERARCHY,
+            input: input.query,
+            pop_all: true,
+        });
+        if (submitted.action === "message") {
+            return {
+                query: input.query,
+                candidates: [],
+                broadened: false,
+                message: submitted.message ?? "Search returned no results.",
+            };
+        }
+        const groupsLoad = await this.browse.load({
+            hierarchy: SEARCH_HIERARCHY,
+            offset: 0,
+            count: GROUP_SCAN_COUNT,
+        });
+        const groups = groupsLoad.items.filter(isSelectable);
+        if (groups.length === 0) {
+            return { query: input.query, candidates: [], broadened: false, message: "No results." };
+        }
+        let broadened = false;
+        let candidates = await this.collectFromGroups(input.query, groups, this.selectGroupIndices(groups, input.type), limit);
+        // If a typed search came back empty, broaden to all categories.
+        if (candidates.length === 0 && input.type) {
+            broadened = true;
+            candidates = await this.collectFromGroups(input.query, groups, groups.map((_, idx) => idx), limit);
+        }
+        const ranked = this.rankCandidates(candidates, input.query, input.type).slice(0, limit);
+        let message;
+        if (broadened) {
+            message = `No "${input.type}" matches; broadened to all categories.`;
+        }
+        else if (ranked.length === 0) {
+            message = "No results.";
+        }
+        return { query: input.query, candidates: ranked, broadened, message };
+    }
+    /** Indices (into the top-level group list) to scan for the requested type. */
+    selectGroupIndices(groups, type) {
+        const all = groups.map((_, idx) => idx);
+        if (!type)
+            return all;
+        return all.filter((idx) => groupTitleToType(groups[idx].title) === type);
+    }
+    async collectFromGroups(query, groups, indices, limit) {
+        const out = [];
+        for (const g of indices) {
+            const group = groups[g];
+            const type = groupTitleToType(group.title);
+            try {
+                const nav = await this.browse.browse({ hierarchy: SEARCH_HIERARCHY, item_key: group.item_key });
+                // action:"none" means Roon didn't push a new level (e.g. a "No Results"
+                // placeholder item) — nothing to load and nothing to pop.
+                if (nav.action !== "list")
+                    continue;
+                const loaded = await this.browse.load({
+                    hierarchy: SEARCH_HIERARCHY,
+                    offset: 0,
+                    count: limit,
+                });
+                // Encode each candidate as a locator (query + group index + item index)
+                // rather than the raw Roon key: the raw key dies when we pop back below,
+                // whereas a locator lets playback re-navigate to a live key later. The
+                // item index is into the *selectable* children so it matches what
+                // SearchNavigator re-derives.
+                const children = loaded.items.filter(isSelectable);
+                children.forEach((item, i) => {
+                    out.push({
+                        itemKey: encodeLocator({ q: query, g, i }),
+                        title: item.title,
+                        subtitle: item.subtitle,
+                        type,
+                        score: 0,
+                        available: true,
+                        sourceGroup: group.title,
+                    });
+                });
+                // item_keys are level-scoped: pop back to the group list before the
+                // next group so its keys stay valid.
+                await this.browse.browse({ hierarchy: SEARCH_HIERARCHY, pop_levels: 1 });
+            }
+            catch (err) {
+                // A single bad group shouldn't sink the whole search.
+                if (err instanceof RoonMcpError && err.code === "INVALID_ITEM_KEY")
+                    continue;
+                throw err;
+            }
+        }
+        return out;
+    }
+    rankCandidates(candidates, query, type) {
+        const q = normalize(query);
+        for (const c of candidates)
+            c.score = scoreCandidate(c, q, type);
+        return [...candidates].sort((a, b) => b.score - a.score);
+    }
+}
+function scoreCandidate(c, q, type) {
+    const title = normalize(c.title);
+    let score;
+    if (title === q)
+        score = 1.0;
+    else if (title.startsWith(q))
+        score = 0.7;
+    else if (title.includes(q))
+        score = 0.5;
+    else
+        score = tokenOverlap(title, q) * 0.4 + 0.05;
+    if (type && c.type === type)
+        score += TYPE_BOOST;
+    return Number(score.toFixed(4));
+}
+function tokenOverlap(title, query) {
+    const titleTokens = new Set(title.split(/\s+/).filter(Boolean));
+    const queryTokens = query.split(/\s+/).filter(Boolean);
+    if (queryTokens.length === 0)
+        return 0;
+    const hits = queryTokens.filter((t) => titleTokens.has(t)).length;
+    return hits / queryTokens.length;
+}
+//# sourceMappingURL=SearchService.js.map

package/dist/SearchService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SearchService.js","sourceRoot":"","sources":["../src/SearchService.ts"],"names":[],"mappings":"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"}