@galaxy-tool-util/search 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 John Chilton
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,21 @@
+# @galaxy-tool-util/search
+
+Tool discovery for Galaxy: Tool Shed search client, result normalization, and ranking helpers.
+
+Built on `@galaxy-tool-util/core` (`ParsedTool`, `ToolInfoService`, cache). Browser-safe — no Node-only imports in the universal entry.
+
+## Status
+
+`0.1.x` — wire types and a normalizer for Tool Shed `/api/tools?q=` responses. HTTP client, `ToolSearchService`, and ranking land in subsequent minor releases.
+
+## Usage (Stage 1)
+
+```ts
+import { normalizeToolSearchResults } from "@galaxy-tool-util/search";
+
+const raw: unknown = await fetch(
+  "https://toolshed.g2.bx.psu.edu/api/tools?q=fastqc",
+).then((r) => r.json());
+const results = normalizeToolSearchResults(raw);
+// { totalResults, page, pageSize, hostname, hits: ToolSearchHit[] }
+```

package/dist/client/index.d.ts

@@ -0,0 +1,5 @@
+export { ToolFetchError, getTRSToolVersions, getLatestTRSToolVersion, } from "@galaxy-tool-util/core";
+export type { TRSToolVersion } from "@galaxy-tool-util/core";
+export { searchTools, iterateToolSearchPages } from "./toolshed.js";
+export type { SearchToolsOptions } from "./toolshed.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/client/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACd,kBAAkB,EAClB,uBAAuB,GACxB,MAAM,wBAAwB,CAAC;AAChC,YAAY,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AACpE,YAAY,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC"}

package/dist/client/index.js

@@ -0,0 +1,3 @@
+export { ToolFetchError, getTRSToolVersions, getLatestTRSToolVersion, } from "@galaxy-tool-util/core";
+export { searchTools, iterateToolSearchPages } from "./toolshed.js";
+//# sourceMappingURL=index.js.map

package/dist/client/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACd,kBAAkB,EAClB,uBAAuB,GACxB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAE,WAAW,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC"}

package/dist/client/toolshed.d.ts

@@ -0,0 +1,22 @@
+import type { SearchResults, ToolSearchHit } from "../models/toolshed-search.js";
+export interface SearchToolsOptions {
+    page?: number;
+    pageSize?: number;
+    fetcher?: typeof fetch;
+}
+/**
+ * Fetch a page of tool search results from a Tool Shed.
+ *
+ * Pass the query verbatim — the Tool Shed wraps it with `*term*` server-side,
+ * so any client-side rewrite would double-wrap and break scoring.
+ *
+ * An `ObjectNotFound` 404 (which some Tool Shed versions return when paging
+ * past the last page of hits) is treated as an empty page.
+ */
+export declare function searchTools(toolshedUrl: string, query: string, opts?: SearchToolsOptions): Promise<SearchResults<ToolSearchHit>>;
+/**
+ * Iterate Tool Shed search results page-by-page. Stops when the server
+ * returns fewer hits than `pageSize` (or no hits at all).
+ */
+export declare function iterateToolSearchPages(toolshedUrl: string, query: string, opts?: SearchToolsOptions): AsyncGenerator<SearchResults<ToolSearchHit>, void, void>;
+//# sourceMappingURL=toolshed.d.ts.map

package/dist/client/toolshed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolshed.d.ts","sourceRoot":"","sources":["../../src/client/toolshed.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAKjF,MAAM,WAAW,kBAAkB;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,KAAK,CAAC;CACxB;AAED;;;;;;;;GAQG;AACH,wBAAsB,WAAW,CAC/B,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,MAAM,EACb,IAAI,GAAE,kBAAuB,GAC5B,OAAO,CAAC,aAAa,CAAC,aAAa,CAAC,CAAC,CAkDvC;AAED;;;GAGG;AACH,wBAAuB,sBAAsB,CAC3C,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,MAAM,EACb,IAAI,GAAE,kBAAuB,GAC5B,cAAc,CAAC,aAAa,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,CAS1D"}

package/dist/client/toolshed.js

@@ -0,0 +1,68 @@
+import { ToolFetchError } from "@galaxy-tool-util/core";
+import { normalizeToolSearchResults } from "../models/toolshed-search.js";
+const REQUEST_TIMEOUT_MS = 30_000;
+/**
+ * Fetch a page of tool search results from a Tool Shed.
+ *
+ * Pass the query verbatim — the Tool Shed wraps it with `*term*` server-side,
+ * so any client-side rewrite would double-wrap and break scoring.
+ *
+ * An `ObjectNotFound` 404 (which some Tool Shed versions return when paging
+ * past the last page of hits) is treated as an empty page.
+ */
+export async function searchTools(toolshedUrl, query, opts = {}) {
+    const fetcher = opts.fetcher ?? globalThis.fetch;
+    const params = new URLSearchParams({ q: query });
+    if (opts.page !== undefined)
+        params.set("page", String(opts.page));
+    if (opts.pageSize !== undefined)
+        params.set("page_size", String(opts.pageSize));
+    const url = `${toolshedUrl}/api/tools?${params.toString()}`;
+    let response;
+    try {
+        response = await fetcher(url, {
+            headers: { Accept: "application/json" },
+            signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS),
+        });
+    }
+    catch (err) {
+        throw new ToolFetchError(`Tool Shed search request to ${url} failed: ${err.message}`, url);
+    }
+    if (response.status === 404) {
+        console.debug(`Tool Shed search: ${url} returned 404 — treating as empty page`);
+        return {
+            total_results: 0,
+            page: opts.page ?? 1,
+            page_size: opts.pageSize ?? 0,
+            hostname: toolshedUrl,
+            hits: [],
+        };
+    }
+    if (!response.ok) {
+        const body = await response.text().catch(() => "");
+        throw new ToolFetchError(`Tool Shed search request to ${url} failed: ${response.status} ${body.slice(0, 200)}`, url, response.status);
+    }
+    const json = await response.json();
+    try {
+        return normalizeToolSearchResults(json);
+    }
+    catch (err) {
+        throw new ToolFetchError(`Tool Shed search response from ${url} was malformed: ${err.message}`, url, response.status);
+    }
+}
+/**
+ * Iterate Tool Shed search results page-by-page. Stops when the server
+ * returns fewer hits than `pageSize` (or no hits at all).
+ */
+export async function* iterateToolSearchPages(toolshedUrl, query, opts = {}) {
+    const pageSize = opts.pageSize ?? 10;
+    let page = opts.page ?? 1;
+    while (true) {
+        const results = await searchTools(toolshedUrl, query, { ...opts, page, pageSize });
+        yield results;
+        if (results.hits.length < pageSize)
+            return;
+        page += 1;
+    }
+}
+//# sourceMappingURL=toolshed.js.map

package/dist/client/toolshed.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @module @galaxy-tool-util/search
+ *
+ * Universal entry — safe to import in Node or browser. Tool discovery
+ * primitives: Tool Shed wire types, response normalization, HTTP client, and
+ * (in subsequent releases) `ToolSearchService` + ranking.
+ */
+export type { ToolSearchHit, SearchResults } from "./models/toolshed-search.js";
+export { normalizeToolSearchResults } from "./models/toolshed-search.js";
+export { searchTools, iterateToolSearchPages, getTRSToolVersions, getLatestTRSToolVersion, ToolFetchError, } from "./client/index.js";
+export type { SearchToolsOptions, TRSToolVersion } from "./client/index.js";
+export { ToolSearchService } from "./tool-search.js";
+export type { NormalizedToolHit, ToolSearchServiceOptions, SearchToolsServiceOptions, } from "./tool-search.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAChF,OAAO,EAAE,0BAA0B,EAAE,MAAM,6BAA6B,CAAC;AAEzE,OAAO,EACL,WAAW,EACX,sBAAsB,EACtB,kBAAkB,EAClB,uBAAuB,EACvB,cAAc,GACf,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAE5E,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,YAAY,EACV,iBAAiB,EACjB,wBAAwB,EACxB,yBAAyB,GAC1B,MAAM,kBAAkB,CAAC"}

package/dist/index.js

@@ -0,0 +1,11 @@
+/**
+ * @module @galaxy-tool-util/search
+ *
+ * Universal entry — safe to import in Node or browser. Tool discovery
+ * primitives: Tool Shed wire types, response normalization, HTTP client, and
+ * (in subsequent releases) `ToolSearchService` + ranking.
+ */
+export { normalizeToolSearchResults } from "./models/toolshed-search.js";
+export { searchTools, iterateToolSearchPages, getTRSToolVersions, getLatestTRSToolVersion, ToolFetchError, } from "./client/index.js";
+export { ToolSearchService } from "./tool-search.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,0BAA0B,EAAE,MAAM,6BAA6B,CAAC;AAEzE,OAAO,EACL,WAAW,EACX,sBAAsB,EACtB,kBAAkB,EAClB,uBAAuB,EACvB,cAAc,GACf,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/models/toolshed-search.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Plain TypeScript types for Tool Shed `/api/tools?q=` responses, plus a
+ * one-way normalizer that coerces the server's stringified pagination numbers
+ * and shape-checks the payload.
+ *
+ * Wire types stay snake_case to mirror the Tool Shed JSON. Downstream code
+ * (`ToolSearchService`, Stage 3) flattens these into a camelCase
+ * `NormalizedToolHit` model.
+ *
+ * Effect Schema is intentionally not used here: these payloads are one-way
+ * deserialized from a trusted peer and immediately flattened, so the
+ * bidirectional codec / diagnostics tree / composable transforms that justify
+ * Effect Schema for user-authored content do not apply.
+ */
+/** A single hit inside a Tool Shed tool search response. */
+export interface ToolSearchHit {
+    tool: {
+        /** Tool id local to its repository (e.g. `fastqc`). Not the full Galaxy tool id. */
+        id: string;
+        name: string;
+        description: string | null;
+        repo_name: string;
+        repo_owner_username: string;
+        /**
+         * Tool version. Optional — current Tool Shed search payloads omit it.
+         * See `TS_SEARCH_OVERHAUL_ISSUE.md` (P0) for the upstream patch.
+         */
+        version?: string;
+        /**
+         * Mercurial changeset revision the hit was indexed from. Optional for
+         * the same reason as `version`.
+         */
+        changeset_revision?: string;
+    };
+    /** Indexed-field → matched-term map (e.g. `{ name: "fastqc", help: "fastqc" }`). */
+    matched_terms: Record<string, string>;
+    /** Whoosh BM25 score. Higher is better. */
+    score: number;
+}
+/** Generic Tool Shed search response wrapper. */
+export interface SearchResults<A> {
+    total_results: number;
+    page: number;
+    page_size: number;
+    /** Tool Shed base URL the response was served from. */
+    hostname: string;
+    hits: A[];
+}
+/**
+ * Validate and normalize a raw Tool Shed `/api/tools?q=` response.
+ *
+ * Coerces stringified pagination numbers (`total_results`, `page`,
+ * `page_size`) into JS numbers and shape-checks each hit. Throws a
+ * descriptive `Error` identifying the offending field on malformed input;
+ * the HTTP client (Stage 2) is responsible for wrapping network/transport
+ * failures as `ToolFetchError`.
+ */
+export declare function normalizeToolSearchResults(raw: unknown): SearchResults<ToolSearchHit>;
+//# sourceMappingURL=toolshed-search.d.ts.map

package/dist/models/toolshed-search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolshed-search.d.ts","sourceRoot":"","sources":["../../src/models/toolshed-search.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,4DAA4D;AAC5D,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE;QACJ,oFAAoF;QACpF,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;QAC3B,SAAS,EAAE,MAAM,CAAC;QAClB,mBAAmB,EAAE,MAAM,CAAC;QAC5B;;;WAGG;QACH,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB;;;WAGG;QACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;KAC7B,CAAC;IACF,oFAAoF;IACpF,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,2CAA2C;IAC3C,KAAK,EAAE,MAAM,CAAC;CACf;AAED,iDAAiD;AACjD,MAAM,WAAW,aAAa,CAAC,CAAC;IAC9B,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,uDAAuD;IACvD,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,CAAC,EAAE,CAAC;CACX;AAsGD;;;;;;;;GAQG;AACH,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,OAAO,GAAG,aAAa,CAAC,aAAa,CAAC,CAiBrF"}

package/dist/models/toolshed-search.js

@@ -0,0 +1,125 @@
+/**
+ * Plain TypeScript types for Tool Shed `/api/tools?q=` responses, plus a
+ * one-way normalizer that coerces the server's stringified pagination numbers
+ * and shape-checks the payload.
+ *
+ * Wire types stay snake_case to mirror the Tool Shed JSON. Downstream code
+ * (`ToolSearchService`, Stage 3) flattens these into a camelCase
+ * `NormalizedToolHit` model.
+ *
+ * Effect Schema is intentionally not used here: these payloads are one-way
+ * deserialized from a trusted peer and immediately flattened, so the
+ * bidirectional codec / diagnostics tree / composable transforms that justify
+ * Effect Schema for user-authored content do not apply.
+ */
+function isObject(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function coerceCount(value, field) {
+    if (typeof value === "number") {
+        if (!Number.isFinite(value)) {
+            throw new Error(`Tool Shed search response: \`${field}\` is not a finite number`);
+        }
+        return value;
+    }
+    if (typeof value === "string") {
+        const n = Number(value);
+        if (!Number.isFinite(n)) {
+            throw new Error(`Tool Shed search response: \`${field}\` (${JSON.stringify(value)}) is not numeric`);
+        }
+        return n;
+    }
+    throw new Error(`Tool Shed search response: \`${field}\` must be a number or numeric string`);
+}
+function coerceMatchedTerms(value, hitIndex) {
+    if (!isObject(value)) {
+        throw new Error(`Tool Shed search response: hits[${hitIndex}].matched_terms must be an object`);
+    }
+    const out = {};
+    for (const [k, v] of Object.entries(value)) {
+        if (typeof v !== "string") {
+            throw new Error(`Tool Shed search response: hits[${hitIndex}].matched_terms[${JSON.stringify(k)}] must be a string`);
+        }
+        out[k] = v;
+    }
+    return out;
+}
+function coerceToolHit(value, hitIndex) {
+    if (!isObject(value)) {
+        throw new Error(`Tool Shed search response: hits[${hitIndex}] must be an object`);
+    }
+    const tool = value.tool;
+    if (!isObject(tool)) {
+        throw new Error(`Tool Shed search response: hits[${hitIndex}].tool must be an object`);
+    }
+    const required = [
+        "id",
+        "name",
+        "repo_name",
+        "repo_owner_username",
+    ];
+    for (const key of required) {
+        if (typeof tool[key] !== "string") {
+            throw new Error(`Tool Shed search response: hits[${hitIndex}].tool.${String(key)} must be a string`);
+        }
+    }
+    const description = tool.description;
+    if (description !== null && typeof description !== "string" && description !== undefined) {
+        throw new Error(`Tool Shed search response: hits[${hitIndex}].tool.description must be a string or null`);
+    }
+    const version = tool.version;
+    if (version !== undefined && typeof version !== "string") {
+        throw new Error(`Tool Shed search response: hits[${hitIndex}].tool.version must be a string`);
+    }
+    const changeset = tool.changeset_revision;
+    if (changeset !== undefined && typeof changeset !== "string") {
+        throw new Error(`Tool Shed search response: hits[${hitIndex}].tool.changeset_revision must be a string`);
+    }
+    if (typeof value.score !== "number" || !Number.isFinite(value.score)) {
+        throw new Error(`Tool Shed search response: hits[${hitIndex}].score must be a finite number`);
+    }
+    const hit = {
+        tool: {
+            id: tool.id,
+            name: tool.name,
+            description: (description ?? null),
+            repo_name: tool.repo_name,
+            repo_owner_username: tool.repo_owner_username,
+        },
+        matched_terms: coerceMatchedTerms(value.matched_terms, hitIndex),
+        score: value.score,
+    };
+    if (version !== undefined)
+        hit.tool.version = version;
+    if (changeset !== undefined)
+        hit.tool.changeset_revision = changeset;
+    return hit;
+}
+/**
+ * Validate and normalize a raw Tool Shed `/api/tools?q=` response.
+ *
+ * Coerces stringified pagination numbers (`total_results`, `page`,
+ * `page_size`) into JS numbers and shape-checks each hit. Throws a
+ * descriptive `Error` identifying the offending field on malformed input;
+ * the HTTP client (Stage 2) is responsible for wrapping network/transport
+ * failures as `ToolFetchError`.
+ */
+export function normalizeToolSearchResults(raw) {
+    if (!isObject(raw)) {
+        throw new Error("Tool Shed search response: payload must be an object");
+    }
+    if (typeof raw.hostname !== "string") {
+        throw new Error("Tool Shed search response: `hostname` must be a string");
+    }
+    if (!Array.isArray(raw.hits)) {
+        throw new Error("Tool Shed search response: `hits` must be an array");
+    }
+    return {
+        total_results: coerceCount(raw.total_results, "total_results"),
+        page: coerceCount(raw.page, "page"),
+        page_size: coerceCount(raw.page_size, "page_size"),
+        hostname: raw.hostname,
+        hits: raw.hits.map(coerceToolHit),
+    };
+}
+//# sourceMappingURL=toolshed-search.js.map

package/dist/models/toolshed-search.js.map

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

package/dist/tool-search.d.ts

@@ -0,0 +1,68 @@
+import type { ToolInfoService, ToolSource } from "@galaxy-tool-util/core";
+import type { ParsedTool } from "@galaxy-tool-util/schema";
+/**
+ * A Tool Shed search hit flattened into a neutral, camelCase shape suitable
+ * for UI consumption and cross-source dedup.
+ *
+ * Fields mirror the Tool Shed wire types but add two derived ids:
+ * - `trsToolId` — `<owner>~<repo>~<toolId>`, consumable by the TRS API and
+ *   `ToolInfoService.getToolInfo`.
+ * - `fullToolId` — `<host>/repos/<owner>/<repo>/<toolId>[/<version>]`, the id
+ *   Galaxy stores in workflows.
+ */
+export interface NormalizedToolHit {
+    /** Source the hit came from. */
+    source: ToolSource;
+    toolId: string;
+    toolName: string;
+    toolDescription: string | null;
+    repoName: string;
+    repoOwnerUsername: string;
+    score: number;
+    /** Tool version, when the server supplies one. Tool Shed currently omits this. */
+    version?: string;
+    /** Mercurial changeset revision, when the server supplies one. */
+    changesetRevision?: string;
+    /** `<owner>~<repo>~<toolId>` — TRS-style id. */
+    trsToolId: string;
+    /** `<host>/repos/<owner>/<repo>/<toolId>[/<version>]` — full Galaxy tool id. */
+    fullToolId: string;
+    /** Populated when `enrich: true` was requested and the fetch succeeded. */
+    parsedTool?: ParsedTool;
+}
+export interface SearchToolsServiceOptions {
+    /** Server-side page size. Defaults to 20. */
+    pageSize?: number;
+    /** Hard cap on hits returned (after dedup). Defaults to 50. */
+    maxResults?: number;
+    /** When true, resolve each hit's `ParsedTool` via the info service (and cache). */
+    enrich?: boolean;
+}
+export interface ToolSearchServiceOptions {
+    /**
+     * Sources to query. Only `type: "toolshed"` sources are searched — Galaxy
+     * instances do not expose an equivalent tool-search endpoint.
+     */
+    sources: ToolSource[];
+    /** Shared with `ToolInfoService` so enriched hits reuse its cache. */
+    info: ToolInfoService;
+    fetcher?: typeof fetch;
+}
+/**
+ * High-level tool discovery service. Fans a query out across configured
+ * Tool Shed sources, dedupes hits that describe the same `(owner, repo,
+ * toolId)` across mirrors (first source wins), sorts by server score, and
+ * optionally enriches each hit with a full `ParsedTool`.
+ */
+export declare class ToolSearchService {
+    private readonly sources;
+    private readonly info;
+    private readonly fetcher;
+    constructor(opts: ToolSearchServiceOptions);
+    searchTools(query: string, opts?: SearchToolsServiceOptions): Promise<NormalizedToolHit[]>;
+    getToolVersions(toolshedUrl: string, trsToolId: string): Promise<string[]>;
+    getLatestVersionForToolId(toolshedUrl: string, trsToolId: string): Promise<string | null>;
+    private collectFromSource;
+    private enrich;
+}
+//# sourceMappingURL=tool-search.d.ts.map

package/dist/tool-search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-search.d.ts","sourceRoot":"","sources":["../src/tool-search.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAE1E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAK3D;;;;;;;;;GASG;AACH,MAAM,WAAW,iBAAiB;IAChC,gCAAgC;IAChC,MAAM,EAAE,UAAU,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,kFAAkF;IAClF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kEAAkE;IAClE,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,gDAAgD;IAChD,SAAS,EAAE,MAAM,CAAC;IAClB,gFAAgF;IAChF,UAAU,EAAE,MAAM,CAAC;IACnB,2EAA2E;IAC3E,UAAU,CAAC,EAAE,UAAU,CAAC;CACzB;AAED,MAAM,WAAW,yBAAyB;IACxC,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,+DAA+D;IAC/D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mFAAmF;IACnF,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,wBAAwB;IACvC;;;OAGG;IACH,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,sEAAsE;IACtE,IAAI,EAAE,eAAe,CAAC;IACtB,OAAO,CAAC,EAAE,OAAO,KAAK,CAAC;CACxB;AAED;;;;;GAKG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAe;IACvC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAkB;IACvC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAe;gBAE3B,IAAI,EAAE,wBAAwB;IAMpC,WAAW,CACf,KAAK,EAAE,MAAM,EACb,IAAI,GAAE,yBAA8B,GACnC,OAAO,CAAC,iBAAiB,EAAE,CAAC;IA+BzB,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAK1E,yBAAyB,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;YAIjF,iBAAiB;YAmBjB,MAAM;CASrB"}

package/dist/tool-search.js

@@ -0,0 +1,97 @@
+import { getLatestTRSToolVersion, getTRSToolVersions, toolIdFromTrs } from "@galaxy-tool-util/core";
+import { iterateToolSearchPages } from "./client/toolshed.js";
+/**
+ * High-level tool discovery service. Fans a query out across configured
+ * Tool Shed sources, dedupes hits that describe the same `(owner, repo,
+ * toolId)` across mirrors (first source wins), sorts by server score, and
+ * optionally enriches each hit with a full `ParsedTool`.
+ */
+export class ToolSearchService {
+    sources;
+    info;
+    fetcher;
+    constructor(opts) {
+        this.sources = opts.sources.filter((s) => s.type === "toolshed");
+        this.info = opts.info;
+        this.fetcher = opts.fetcher ?? globalThis.fetch;
+    }
+    async searchTools(query, opts = {}) {
+        const pageSize = opts.pageSize ?? 20;
+        const maxResults = opts.maxResults ?? 50;
+        const perSource = await Promise.all(this.sources.map((source) => this.collectFromSource(source, query, pageSize, maxResults).catch((err) => {
+            const msg = err instanceof Error ? err.message : String(err);
+            console.debug(`Tool Shed search failed for ${source.url}: ${msg}`);
+            return [];
+        })));
+        const dedupKey = (h) => `${h.repoOwnerUsername}~${h.repoName}~${h.toolId}`;
+        const seen = new Map();
+        for (let i = 0; i < this.sources.length; i++) {
+            for (const hit of perSource[i]) {
+                const k = dedupKey(hit);
+                if (!seen.has(k))
+                    seen.set(k, hit);
+            }
+        }
+        const merged = Array.from(seen.values()).sort((a, b) => b.score - a.score);
+        const truncated = merged.slice(0, maxResults);
+        if (opts.enrich) {
+            await Promise.all(truncated.map((hit) => this.enrich(hit)));
+        }
+        return truncated;
+    }
+    async getToolVersions(toolshedUrl, trsToolId) {
+        const versions = await getTRSToolVersions(toolshedUrl, trsToolId, this.fetcher);
+        return versions.map((v) => v.id);
+    }
+    async getLatestVersionForToolId(toolshedUrl, trsToolId) {
+        return getLatestTRSToolVersion(toolshedUrl, trsToolId, this.fetcher);
+    }
+    async collectFromSource(source, query, pageSize, maxResults) {
+        const out = [];
+        for await (const page of iterateToolSearchPages(source.url, query, {
+            pageSize,
+            fetcher: this.fetcher,
+        })) {
+            for (const hit of page.hits) {
+                out.push(normalizeHit(hit, source));
+            }
+            if (out.length >= maxResults)
+                return out;
+        }
+        return out;
+    }
+    async enrich(hit) {
+        try {
+            const parsed = await this.info.getToolInfo(hit.trsToolId, hit.version ?? null);
+            if (parsed !== null)
+                hit.parsedTool = parsed;
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            console.debug(`Enrichment failed for ${hit.trsToolId}: ${msg}`);
+        }
+    }
+}
+function normalizeHit(hit, source) {
+    const { id, name, description, repo_name, repo_owner_username, version, changeset_revision } = hit.tool;
+    const trsToolId = `${repo_owner_username}~${repo_name}~${id}`;
+    const base = toolIdFromTrs(source.url, trsToolId);
+    const fullToolId = version ? `${base}/${version}` : base;
+    const normalized = {
+        source,
+        toolId: id,
+        toolName: name,
+        toolDescription: description,
+        repoName: repo_name,
+        repoOwnerUsername: repo_owner_username,
+        score: hit.score,
+        trsToolId,
+        fullToolId,
+    };
+    if (version !== undefined)
+        normalized.version = version;
+    if (changeset_revision !== undefined)
+        normalized.changesetRevision = changeset_revision;
+    return normalized;
+}
+//# sourceMappingURL=tool-search.js.map

package/dist/tool-search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-search.js","sourceRoot":"","sources":["../src/tool-search.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,uBAAuB,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAIpG,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAqD9D;;;;;GAKG;AACH,MAAM,OAAO,iBAAiB;IACX,OAAO,CAAe;IACtB,IAAI,CAAkB;IACtB,OAAO,CAAe;IAEvC,YAAY,IAA8B;QACxC,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC;QACjE,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACtB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,UAAU,CAAC,KAAK,CAAC;IAClD,CAAC;IAED,KAAK,CAAC,WAAW,CACf,KAAa,EACb,OAAkC,EAAE;QAEpC,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC;QACrC,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,IAAI,EAAE,CAAC;QAEzC,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,GAAG,CACjC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAC1B,IAAI,CAAC,iBAAiB,CAAC,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;YACxE,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC7D,OAAO,CAAC,KAAK,CAAC,+BAA+B,MAAM,CAAC,GAAG,KAAK,GAAG,EAAE,CAAC,CAAC;YACnE,OAAO,EAAyB,CAAC;QACnC,CAAC,CAAC,CACH,CACF,CAAC;QAEF,MAAM,QAAQ,GAAG,CAAC,CAAoB,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,iBAAiB,IAAI,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC;QAC9F,MAAM,IAAI,GAAG,IAAI,GAAG,EAA6B,CAAC;QAClD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAC7C,KAAK,MAAM,GAAG,IAAI,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC/B,MAAM,CAAC,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;gBACxB,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;oBAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;YACrC,CAAC;QACH,CAAC;QACD,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;QAC3E,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;QAE9C,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,MAAM,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QAC9D,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,KAAK,CAAC,eAAe,CAAC,WAAmB,EAAE,SAAiB;QAC1D,MAAM,QAAQ,GAAG,MAAM,kBAAkB,CAAC,WAAW,EAAE,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QAChF,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACnC,CAAC;IAED,KAAK,CAAC,yBAAyB,CAAC,WAAmB,EAAE,SAAiB;QACpE,OAAO,uBAAuB,CAAC,WAAW,EAAE,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IACvE,CAAC;IAEO,KAAK,CAAC,iBAAiB,CAC7B,MAAkB,EAClB,KAAa,EACb,QAAgB,EAChB,UAAkB;QAElB,MAAM,GAAG,GAAwB,EAAE,CAAC;QACpC,IAAI,KAAK,EAAE,MAAM,IAAI,IAAI,sBAAsB,CAAC,MAAM,CAAC,GAAG,EAAE,KAAK,EAAE;YACjE,QAAQ;YACR,OAAO,EAAE,IAAI,CAAC,OAAO;SACtB,CAAC,EAAE,CAAC;YACH,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;gBAC5B,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC;YACtC,CAAC;YACD,IAAI,GAAG,CAAC,MAAM,IAAI,UAAU;gBAAE,OAAO,GAAG,CAAC;QAC3C,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IAEO,KAAK,CAAC,MAAM,CAAC,GAAsB;QACzC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,SAAS,EAAE,GAAG,CAAC,OAAO,IAAI,IAAI,CAAC,CAAC;YAC/E,IAAI,MAAM,KAAK,IAAI;gBAAE,GAAG,CAAC,UAAU,GAAG,MAAM,CAAC;QAC/C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC7D,OAAO,CAAC,KAAK,CAAC,yBAAyB,GAAG,CAAC,SAAS,KAAK,GAAG,EAAE,CAAC,CAAC;QAClE,CAAC;IACH,CAAC;CACF;AAED,SAAS,YAAY,CAAC,GAAkB,EAAE,MAAkB;IAC1D,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,SAAS,EAAE,mBAAmB,EAAE,OAAO,EAAE,kBAAkB,EAAE,GAC1F,GAAG,CAAC,IAAI,CAAC;IACX,MAAM,SAAS,GAAG,GAAG,mBAAmB,IAAI,SAAS,IAAI,EAAE,EAAE,CAAC;IAC9D,MAAM,IAAI,GAAG,aAAa,CAAC,MAAM,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;IAClD,MAAM,UAAU,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,OAAO,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IACzD,MAAM,UAAU,GAAsB;QACpC,MAAM;QACN,MAAM,EAAE,EAAE;QACV,QAAQ,EAAE,IAAI;QACd,eAAe,EAAE,WAAW;QAC5B,QAAQ,EAAE,SAAS;QACnB,iBAAiB,EAAE,mBAAmB;QACtC,KAAK,EAAE,GAAG,CAAC,KAAK;QAChB,SAAS;QACT,UAAU;KACX,CAAC;IACF,IAAI,OAAO,KAAK,SAAS;QAAE,UAAU,CAAC,OAAO,GAAG,OAAO,CAAC;IACxD,IAAI,kBAAkB,KAAK,SAAS;QAAE,UAAU,CAAC,iBAAiB,GAAG,kBAAkB,CAAC;IACxF,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@galaxy-tool-util/search",
+  "version": "0.1.0",
+  "description": "Tool discovery — Tool Shed search client, result normalization, and ranking",
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "browser": "./dist/index.js",
+      "import": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/jmchilton/galaxy-tool-util-ts",
+    "directory": "packages/search"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "license": "MIT",
+  "devDependencies": {
+    "@types/node": "^25.5.0"
+  },
+  "dependencies": {
+    "@galaxy-tool-util/core": "0.3.0",
+    "@galaxy-tool-util/schema": "0.4.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "test": "tsc --noEmit && vitest run",
+    "test:watch": "vitest",
+    "lint": "eslint src/ test/",
+    "format": "prettier --check 'src/**/*.ts' 'test/**/*.ts'",
+    "format-fix": "prettier --write 'src/**/*.ts' 'test/**/*.ts'",
+    "lint:pkg": "publint",
+    "check:types": "attw --pack . --profile esm-only",
+    "check:browser": "node scripts/verify-browser-entry.mjs"
+  }
+}