@galaxy-tool-util/core 1.10.1 → 1.13.1

package/dist/cache-http/route-table.js

@@ -0,0 +1,145 @@
+/**
+ * URL routing for the shared cache HTTP surface.
+ *
+ * `matchCacheRoute` returns a tagged-union route object given a method + url
+ * (or null if no cache route matches). `dispatchCacheRoute` invokes the
+ * matching handler. Both are framework-agnostic — server adapters (Node http,
+ * Effect HttpServer, …) compose them with their own non-cache routes.
+ */
+import { addTool, cacheStats, clearCache, deleteCacheEntry, getParameterSchema, getParsedTool, getToolSource, listCache, refetchTool, searchTools, trsGetTool, trsListTools, trsListVersions, } from "./handlers.js";
+const PARAMETER_SCHEMA_TAILS = {
+    parameter_request_schema: "request",
+    parameter_landing_request_schema: "landing_request",
+    parameter_test_case_xml_schema: "test_case_xml",
+};
+const TRS_PREFIX = "/api/ga4gh/trs/v2/tools";
+/** Match a method + url against the shared cache HTTP surface. */
+export function matchCacheRoute(method, url) {
+    const [rawPath, queryStr] = url.split("?");
+    const query = new URLSearchParams(queryStr ?? "");
+    // Admin namespace
+    if (rawPath === "/api/tool-cache" || rawPath.startsWith("/api/tool-cache/")) {
+        if (rawPath === "/api/tool-cache") {
+            if (method === "GET")
+                return { handler: "listCache", query };
+            if (method === "DELETE")
+                return { handler: "clearCache", query };
+            return null;
+        }
+        if (rawPath === "/api/tool-cache/stats" && method === "GET") {
+            return { handler: "cacheStats" };
+        }
+        if (rawPath === "/api/tool-cache/refetch" && method === "POST") {
+            return { handler: "refetchTool" };
+        }
+        if (rawPath === "/api/tool-cache/add" && method === "POST") {
+            return { handler: "addTool" };
+        }
+        const keyMatch = rawPath.match(/^\/api\/tool-cache\/([^/]+)$/);
+        if (keyMatch && method === "DELETE") {
+            return { handler: "deleteCacheEntry", cacheKey: decodeURIComponent(keyMatch[1]) };
+        }
+        return null;
+    }
+    // TRS namespace
+    if (rawPath === TRS_PREFIX || rawPath.startsWith(`${TRS_PREFIX}/`)) {
+        if (method !== "GET")
+            return null;
+        if (rawPath === TRS_PREFIX)
+            return { handler: "trsListTools" };
+        const versionsMatch = rawPath.match(/^\/api\/ga4gh\/trs\/v2\/tools\/([^/]+)\/versions$/);
+        if (versionsMatch) {
+            return { handler: "trsListVersions", toolId: decodeURIComponent(versionsMatch[1]) };
+        }
+        const toolMatch = rawPath.match(/^\/api\/ga4gh\/trs\/v2\/tools\/([^/]+)$/);
+        if (toolMatch) {
+            return { handler: "trsGetTool", toolId: decodeURIComponent(toolMatch[1]) };
+        }
+        return null;
+    }
+    // /api/tools (search + per-version reads)
+    if (rawPath === "/api/tools" && method === "GET") {
+        return { handler: "searchTools", query };
+    }
+    const versionMatch = rawPath.match(/^\/api\/tools\/([^/]+)\/versions\/([^/]+)(?:\/([^/]+))?$/);
+    if (versionMatch && method === "GET") {
+        const toolId = decodeURIComponent(versionMatch[1]);
+        const toolVersion = decodeURIComponent(versionMatch[2]);
+        const tail = versionMatch[3];
+        if (tail === undefined) {
+            return { handler: "getParsedTool", toolId, toolVersion };
+        }
+        if (tail === "tool_source") {
+            return { handler: "getToolSource", toolId, toolVersion };
+        }
+        const kind = PARAMETER_SCHEMA_TAILS[tail];
+        if (kind !== undefined) {
+            return { handler: "getParameterSchema", toolId, toolVersion, kind };
+        }
+    }
+    return null;
+}
+/**
+ * Run a matched route. Body-bearing routes call `readBody` for parsed JSON.
+ * Errors throw `HttpError`; adapters translate them.
+ */
+export async function dispatchCacheRoute(route, ctx, readBody) {
+    if (route.handler === "getToolSource") {
+        const source = await getToolSource(ctx, route.toolId, route.toolVersion);
+        return {
+            kind: "bytes",
+            body: new TextEncoder().encode(source.contents),
+            headers: {
+                "Content-Type": "text/plain; charset=utf-8",
+                language: source.language,
+                "X-Tool-Source-Macros-Expanded": String(source.macrosExpanded),
+                "X-Content-Type-Options": "nosniff",
+            },
+        };
+    }
+    return { kind: "json", body: await dispatchJsonCacheRoute(route, ctx, readBody) };
+}
+async function dispatchJsonCacheRoute(route, ctx, readBody) {
+    switch (route.handler) {
+        case "searchTools": {
+            const q = route.query.get("q") ?? undefined;
+            const pageStr = route.query.get("page");
+            const pageSizeStr = route.query.get("page_size");
+            const opts = {};
+            if (q !== undefined)
+                opts.q = q;
+            if (pageStr !== null)
+                opts.page = Number(pageStr);
+            if (pageSizeStr !== null)
+                opts.pageSize = Number(pageSizeStr);
+            return searchTools(ctx, opts);
+        }
+        case "trsListTools":
+            return trsListTools(ctx);
+        case "trsGetTool":
+            return trsGetTool(ctx, route.toolId);
+        case "trsListVersions":
+            return trsListVersions(ctx, route.toolId);
+        case "getParsedTool":
+            return getParsedTool(ctx, route.toolId, route.toolVersion);
+        case "getParameterSchema":
+            return getParameterSchema(ctx, route.toolId, route.toolVersion, route.kind);
+        case "listCache": {
+            const decode = route.query.get("decode") === "1";
+            return listCache(ctx, { decode });
+        }
+        case "cacheStats":
+            return cacheStats(ctx);
+        case "deleteCacheEntry":
+            return deleteCacheEntry(ctx, route.cacheKey);
+        case "clearCache": {
+            const prefix = route.query.get("prefix") ?? undefined;
+            return clearCache(ctx, prefix);
+        }
+        case "refetchTool":
+            return refetchTool(ctx, await readBody());
+        case "addTool":
+            return addTool(ctx, await readBody());
+    }
+}
+//# sourceMappingURL=route-table.js.map

package/dist/cache-http/route-table.js.map

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

package/dist/client/index.d.ts

@@ -1,4 +1,5 @@
 export { fetchFromToolShed, fetchFromGalaxy, ToolFetchError } from "./toolshed.js";
 export { getTRSToolVersions, getLatestTRSToolVersion } from "./trs.js";
 export type { TRSToolVersion } from "./trs.js";
+export { fetchToolSourceFromToolShed, fetchToolSourceFromGalaxy } from "./tool-source.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACnF,OAAO,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,MAAM,UAAU,CAAC;AACvE,YAAY,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACnF,OAAO,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,MAAM,UAAU,CAAC;AACvE,YAAY,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC/C,OAAO,EAAE,2BAA2B,EAAE,yBAAyB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/client/index.js

@@ -1,3 +1,4 @@
 export { fetchFromToolShed, fetchFromGalaxy, ToolFetchError } from "./toolshed.js";
 export { getTRSToolVersions, getLatestTRSToolVersion } from "./trs.js";
+export { fetchToolSourceFromToolShed, fetchToolSourceFromGalaxy } from "./tool-source.js";
 //# sourceMappingURL=index.js.map

package/dist/client/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACnF,OAAO,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,MAAM,UAAU,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACnF,OAAO,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,MAAM,UAAU,CAAC;AAEvE,OAAO,EAAE,2BAA2B,EAAE,yBAAyB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/client/tool-source.d.ts

@@ -0,0 +1,6 @@
+import type { ToolSourceDocument } from "../tool-source.js";
+/** Fetch the expanded wrapper selected by tool version, without changeset selection. */
+export declare function fetchToolSourceFromToolShed(toolshedUrl: string, trsToolId: string, toolVersion: string, fetcher?: typeof fetch): Promise<ToolSourceDocument>;
+/** Galaxy may restrict source display to administrators, depending on its configuration. */
+export declare function fetchToolSourceFromGalaxy(galaxyUrl: string, toolId: string, toolVersion?: string | null, fetcher?: typeof fetch): Promise<ToolSourceDocument>;
+//# sourceMappingURL=tool-source.d.ts.map

package/dist/client/tool-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-source.d.ts","sourceRoot":"","sources":["../../src/client/tool-source.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAyB5D,wFAAwF;AACxF,wBAAgB,2BAA2B,CACzC,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,OAAO,KAAwB,GACvC,OAAO,CAAC,kBAAkB,CAAC,CAK7B;AAED,4FAA4F;AAC5F,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,EAC3B,OAAO,GAAE,OAAO,KAAwB,GACvC,OAAO,CAAC,kBAAkB,CAAC,CAM7B"}

package/dist/client/tool-source.js

@@ -0,0 +1,27 @@
+import { ToolFetchError } from "./toolshed.js";
+async function fetchSource(url, fetcher) {
+    const response = await fetcher(url, {
+        headers: { Accept: "text/plain, application/xml, application/yaml, application/json" },
+        signal: AbortSignal.timeout(30_000),
+    });
+    if (!response.ok) {
+        const body = await response.text().catch(() => "");
+        throw new ToolFetchError(`Failed to fetch tool source from ${url}: ${response.status} ${body.slice(0, 200)}`, url, response.status);
+    }
+    const contents = await response.text();
+    const header = response.headers.get("language")?.toLowerCase();
+    const language = header === "xml" || header === "yaml" || header === "json" || header === "cwl"
+        ? header
+        : "text";
+    return { contents, language, macrosExpanded: language === "xml" };
+}
+/** Fetch the expanded wrapper selected by tool version, without changeset selection. */
+export function fetchToolSourceFromToolShed(toolshedUrl, trsToolId, toolVersion, fetcher = globalThis.fetch) {
+    return fetchSource(`${toolshedUrl.replace(/\/$/, "")}/api/tools/${encodeURIComponent(trsToolId)}/versions/${encodeURIComponent(toolVersion)}/tool_source`, fetcher);
+}
+/** Galaxy may restrict source display to administrators, depending on its configuration. */
+export function fetchToolSourceFromGalaxy(galaxyUrl, toolId, toolVersion, fetcher = globalThis.fetch) {
+    const params = toolVersion ? `?tool_version=${encodeURIComponent(toolVersion)}` : "";
+    return fetchSource(`${galaxyUrl.replace(/\/$/, "")}/api/tools/${encodeURIComponent(toolId)}/raw_tool_source${params}`, fetcher);
+}
+//# sourceMappingURL=tool-source.js.map

package/dist/client/tool-source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-source.js","sourceRoot":"","sources":["../../src/client/tool-source.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAE/C,KAAK,UAAU,WAAW,CAAC,GAAW,EAAE,OAAqB;IAC3D,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,GAAG,EAAE;QAClC,OAAO,EAAE,EAAE,MAAM,EAAE,iEAAiE,EAAE;QACtF,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC;KACpC,CAAC,CAAC;IACH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;QACnD,MAAM,IAAI,cAAc,CACtB,oCAAoC,GAAG,KAAK,QAAQ,CAAC,MAAM,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,EACnF,GAAG,EACH,QAAQ,CAAC,MAAM,CAChB,CAAC;IACJ,CAAC;IACD,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;IACvC,MAAM,MAAM,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,WAAW,EAAE,CAAC;IAC/D,MAAM,QAAQ,GACZ,MAAM,KAAK,KAAK,IAAI,MAAM,KAAK,MAAM,IAAI,MAAM,KAAK,MAAM,IAAI,MAAM,KAAK,KAAK;QAC5E,CAAC,CAAC,MAAM;QACR,CAAC,CAAC,MAAM,CAAC;IACb,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,cAAc,EAAE,QAAQ,KAAK,KAAK,EAAE,CAAC;AACpE,CAAC;AAED,wFAAwF;AACxF,MAAM,UAAU,2BAA2B,CACzC,WAAmB,EACnB,SAAiB,EACjB,WAAmB,EACnB,UAAwB,UAAU,CAAC,KAAK;IAExC,OAAO,WAAW,CAChB,GAAG,WAAW,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,cAAc,kBAAkB,CAAC,SAAS,CAAC,aAAa,kBAAkB,CAAC,WAAW,CAAC,cAAc,EACtI,OAAO,CACR,CAAC;AACJ,CAAC;AAED,4FAA4F;AAC5F,MAAM,UAAU,yBAAyB,CACvC,SAAiB,EACjB,MAAc,EACd,WAA2B,EAC3B,UAAwB,UAAU,CAAC,KAAK;IAExC,MAAM,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,iBAAiB,kBAAkB,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACrF,OAAO,WAAW,CAChB,GAAG,SAAS,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,cAAc,kBAAkB,CAAC,MAAM,CAAC,mBAAmB,MAAM,EAAE,EAClG,OAAO,CACR,CAAC;AACJ,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"toolshed.d.ts","sourceRoot":"","sources":["../../src/client/toolshed.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAEtD,oEAAoE;AACpE,qBAAa,cAAe,SAAQ,KAAK;IAIrC,kCAAkC;IAClC,QAAQ,CAAC,GAAG,EAAE,MAAM;IACpB,2DAA2D;IAC3D,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM;IAN9B,QAAQ,CAAC,IAAI,oBAAoB;gBAE/B,OAAO,EAAE,MAAM;IACf,kCAAkC;IACzB,GAAG,EAAE,MAAM;IACpB,2DAA2D;IAClD,UAAU,CAAC,EAAE,MAAM,YAAA;CAI/B;AAED;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CACrC,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,OAAO,KAAwB,GACvC,OAAO,CAAC,UAAU,CAAC,CAgBrB;AAED;;;;;;GAMG;AACH,wBAAsB,eAAe,CACnC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,EAC3B,OAAO,GAAE,OAAO,KAAwB,GACvC,OAAO,CAAC,UAAU,CAAC,CAkBrB"}
+{"version":3,"file":"toolshed.d.ts","sourceRoot":"","sources":["../../src/client/toolshed.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAEtD,oEAAoE;AACpE,qBAAa,cAAe,SAAQ,KAAK;IAIrC,kCAAkC;IAClC,QAAQ,CAAC,GAAG,EAAE,MAAM;IACpB,2DAA2D;IAC3D,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM;IAN9B,QAAQ,CAAC,IAAI,oBAAoB;gBAE/B,OAAO,EAAE,MAAM;IACf,kCAAkC;IACzB,GAAG,EAAE,MAAM;IACpB,2DAA2D;IAClD,UAAU,CAAC,EAAE,MAAM,YAAA;CAI/B;AA0BD;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CACrC,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,OAAO,KAAwB,GACvC,OAAO,CAAC,UAAU,CAAC,CAgBrB;AAED;;;;;;GAMG;AACH,wBAAsB,eAAe,CACnC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,EAC3B,OAAO,GAAE,OAAO,KAAwB,GACvC,OAAO,CAAC,UAAU,CAAC,CAkBrB"}

package/dist/client/toolshed.js

@@ -1,3 +1,5 @@
+import * as Either from "effect/Either";
+import * as ParseResult from "effect/ParseResult";
 import * as S from "effect/Schema";
 import { ParsedTool } from "@galaxy-tool-util/schema";
 /** Error thrown when fetching a tool from a remote source fails. */
@@ -15,6 +17,26 @@ export class ToolFetchError extends Error {
         this.statusCode = statusCode;
     }
 }
+function truncateDiagnostic(text, limit) {
+    return text.length > limit ? `${text.slice(0, limit - 1)}…` : text;
+}
+/**
+ * Report the first failing field path and a bounded reason. ArrayFormatter
+ * removes the outer error tree, but its Type messages can still render large
+ * schema declarations and actual values, so replace those with a short reason.
+ * Bound both source and detail to keep the complete message under 500 characters;
+ * ToolFetchError.url retains the full source URL.
+ */
+function decodeParsedTool(json, url) {
+    const result = S.decodeUnknownEither(ParsedTool)(json);
+    if (Either.isRight(result))
+        return result.right;
+    const issues = ParseResult.ArrayFormatter.formatErrorSync(result.left);
+    const issue = issues[0];
+    const reason = issue?._tag === "Type" ? "has invalid type" : issue?.message;
+    const detail = issue ? `[${issue.path.join(".")}] ${reason}` : "decode failed";
+    throw new ToolFetchError(`invalid tool metadata from ${truncateDiagnostic(url, 160)}: ${truncateDiagnostic(detail, 300)}`, url);
+}
 /**
  * Fetch parsed tool metadata from a ToolShed instance via its TRS API.
  * @param toolshedUrl - Base URL of the ToolShed (e.g. `https://toolshed.g2.bx.psu.edu`)
@@ -33,7 +55,7 @@ export async function fetchFromToolShed(toolshedUrl, trsToolId, toolVersion, fet
         throw new ToolFetchError(`Failed to fetch from ${url}: ${response.status} ${body.slice(0, 200)}`, url, response.status);
     }
     const json = await response.json();
-    return S.decodeUnknownSync(ParsedTool)(json);
+    return decodeParsedTool(json, url);
 }
 /**
  * Fetch parsed tool metadata from a Galaxy instance via its API.
@@ -55,6 +77,6 @@ export async function fetchFromGalaxy(galaxyUrl, toolId, toolVersion, fetcher =
         throw new ToolFetchError(`Failed to fetch from Galaxy ${url}: ${response.status} ${body.slice(0, 200)}`, url, response.status);
     }
     const json = await response.json();
-    return S.decodeUnknownSync(ParsedTool)(json);
+    return decodeParsedTool(json, url);
 }
 //# sourceMappingURL=toolshed.js.map

package/dist/client/toolshed.js.map

@@ -1 +1 @@
-{"version":3,"file":"toolshed.js","sourceRoot":"","sources":["../../src/client/toolshed.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,eAAe,CAAC;AACnC,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAEtD,oEAAoE;AACpE,MAAM,OAAO,cAAe,SAAQ,KAAK;IAK5B;IAEA;IANF,IAAI,GAAG,gBAAgB,CAAC;IACjC,YACE,OAAe;IACf,kCAAkC;IACzB,GAAW;IACpB,2DAA2D;IAClD,UAAmB;QAE5B,KAAK,CAAC,OAAO,CAAC,CAAC;QAJN,QAAG,GAAH,GAAG,CAAQ;QAEX,eAAU,GAAV,UAAU,CAAS;IAG9B,CAAC;CACF;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,WAAmB,EACnB,SAAiB,EACjB,WAAmB,EACnB,UAAwB,UAAU,CAAC,KAAK;IAExC,MAAM,GAAG,GAAG,GAAG,WAAW,cAAc,SAAS,aAAa,WAAW,EAAE,CAAC;IAC5E,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,GAAG,EAAE;QAClC,OAAO,EAAE,EAAE,MAAM,EAAE,kBAAkB,EAAE;QACvC,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC;KACpC,CAAC,CAAC;IACH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;QACnD,MAAM,IAAI,cAAc,CACtB,wBAAwB,GAAG,KAAK,QAAQ,CAAC,MAAM,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,EACvE,GAAG,EACH,QAAQ,CAAC,MAAM,CAChB,CAAC;IACJ,CAAC;IACD,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;IACnC,OAAO,CAAC,CAAC,iBAAiB,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,CAAC;AAC/C,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,SAAiB,EACjB,MAAc,EACd,WAA2B,EAC3B,UAAwB,UAAU,CAAC,KAAK;IAExC,MAAM,SAAS,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAC7C,MAAM,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,iBAAiB,kBAAkB,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACrF,MAAM,GAAG,GAAG,GAAG,SAAS,cAAc,SAAS,UAAU,MAAM,EAAE,CAAC;IAClE,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,GAAG,EAAE;QAClC,OAAO,EAAE,EAAE,MAAM,EAAE,kBAAkB,EAAE;QACvC,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC;KACpC,CAAC,CAAC;IACH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;QACnD,MAAM,IAAI,cAAc,CACtB,+BAA+B,GAAG,KAAK,QAAQ,CAAC,MAAM,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,EAC9E,GAAG,EACH,QAAQ,CAAC,MAAM,CAChB,CAAC;IACJ,CAAC;IACD,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;IACnC,OAAO,CAAC,CAAC,iBAAiB,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,CAAC;AAC/C,CAAC"}
+{"version":3,"file":"toolshed.js","sourceRoot":"","sources":["../../src/client/toolshed.ts"],"names":[],"mappings":"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"}

package/dist/diagnostics.d.ts

@@ -0,0 +1,5 @@
+/** Optional sink for recoverable diagnostics emitted by core services. */
+export type DiagnosticSink = (message: string) => void;
+/** Default sink for library consumers: recoverable failures stay silent. */
+export declare const ignoreDiagnostic: DiagnosticSink;
+//# sourceMappingURL=diagnostics.d.ts.map

package/dist/diagnostics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.d.ts","sourceRoot":"","sources":["../src/diagnostics.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;AAEvD,4EAA4E;AAC5E,eAAO,MAAM,gBAAgB,EAAE,cAAyB,CAAC"}

package/dist/diagnostics.js

@@ -0,0 +1,3 @@
+/** Default sink for library consumers: recoverable failures stay silent. */
+export const ignoreDiagnostic = () => { };
+//# sourceMappingURL=diagnostics.js.map

package/dist/diagnostics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.js","sourceRoot":"","sources":["../src/diagnostics.ts"],"names":[],"mappings":"AAGA,4EAA4E;AAC5E,MAAM,CAAC,MAAM,gBAAgB,GAAmB,GAAG,EAAE,GAAE,CAAC,CAAC"}

package/dist/index.d.ts

@@ -20,7 +20,7 @@ cacheKey,
 CacheIndex, 
 /** Two-layer cache (memory + storage) for parsed tool metadata. */
 ToolCache, DEFAULT_TOOLSHED_URL, TOOLSHED_URL_ENV_VAR, } from "./cache/index.js";
-export type { ToolCoordinates, CacheIndexEntry, CacheIndexData, CacheStorage, ResolvedCoordinates, CacheStats, } from "./cache/index.js";
+export type { ToolCoordinates, CacheIndexEntry, CacheIndexData, CacheStorage, ResolvedCoordinates, CacheStats, ToolCacheOptions, } from "./cache/index.js";
 /** IndexedDB-backed cache storage for browser/Web Worker contexts. */
 export { IndexedDBCacheStorage } from "./cache/index.js";
 /** Fetch parsed tool metadata from a ToolShed instance via TRS API. */
@@ -31,7 +31,14 @@ export type { TRSToolVersion } from "./client/index.js";
 /** High-level service: fetch tools from multiple sources with automatic caching. */
 export { ToolInfoService } from "./tool-info.js";
 export type { ToolInfoOptions, ToolSource } from "./tool-info.js";
+export { ignoreDiagnostic } from "./diagnostics.js";
+export type { DiagnosticSink } from "./diagnostics.js";
 /** Shared YAML config schema for tool sources and cache settings. */
 export { WorkflowToolConfig, ToolSourceConfig, ToolCacheConfig, toolInfoOptionsFromConfig, } from "./config.js";
 export type { ConfigToolInfoOptions } from "./config.js";
+/** Framework-agnostic HTTP handlers + DTOs shared by gxwf-web and tool-cache-proxy. */
+export { HttpError, matchCacheRoute, dispatchCacheRoute, type CacheResult, type CacheRoute, cacheToTrs, cacheToTrsOne, entryToTrsVersion, listCache, cacheStats, deleteCacheEntry, clearCache, refetchTool, addTool, searchTools, trsListTools, trsGetTool, trsListVersions, getParsedTool, getParameterSchema, getToolSource, } from "./cache-http/index.js";
+export type { HandlerCtx, ListOptions, SearchOptions, CacheIndexRecord, AddRequest, AddResponse, CachedToolEntry, ClearResponse, DeleteResponse, ListResponse, ParameterSchemaKind, RefetchRequest, RefetchResponse, SearchResults, } from "./cache-http/index.js";
+export type { ToolSourceDocument } from "./tool-source.js";
+export { fetchToolSourceFromToolShed, fetchToolSourceFromGalaxy } from "./client/index.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO;AACL,4FAA4F;AAC5F,mBAAmB;AACnB,oEAAoE;AACpE,aAAa;AACb,wFAAwF;AACxF,uBAAuB;AACvB,gGAAgG;AAChG,WAAW;AACX,sFAAsF;AACtF,QAAQ;AACR,iFAAiF;AACjF,UAAU;AACV,mEAAmE;AACnE,SAAS,EACT,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACV,eAAe,EACf,eAAe,EACf,cAAc,EACd,YAAY,EACZ,mBAAmB,EACnB,UAAU,GACX,MAAM,kBAAkB,CAAC;AAC1B,sEAAsE;AACtE,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AACzD,uEAAuE;AACvE,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACvF,8DAA8D;AAC9D,OAAO,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAChF,YAAY,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,oFAAoF;AACpF,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,YAAY,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAClE,qEAAqE;AACrE,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,eAAe,EACf,yBAAyB,GAC1B,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO;AACL,4FAA4F;AAC5F,mBAAmB;AACnB,oEAAoE;AACpE,aAAa;AACb,wFAAwF;AACxF,uBAAuB;AACvB,gGAAgG;AAChG,WAAW;AACX,sFAAsF;AACtF,QAAQ;AACR,iFAAiF;AACjF,UAAU;AACV,mEAAmE;AACnE,SAAS,EACT,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACV,eAAe,EACf,eAAe,EACf,cAAc,EACd,YAAY,EACZ,mBAAmB,EACnB,UAAU,EACV,gBAAgB,GACjB,MAAM,kBAAkB,CAAC;AAC1B,sEAAsE;AACtE,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AACzD,uEAAuE;AACvE,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACvF,8DAA8D;AAC9D,OAAO,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAChF,YAAY,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,oFAAoF;AACpF,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,YAAY,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAClE,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,YAAY,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,qEAAqE;AACrE,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,eAAe,EACf,yBAAyB,GAC1B,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAEzD,uFAAuF;AACvF,OAAO,EACL,SAAS,EACT,eAAe,EACf,kBAAkB,EAClB,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,UAAU,EACV,aAAa,EACb,iBAAiB,EACjB,SAAS,EACT,UAAU,EACV,gBAAgB,EAChB,UAAU,EACV,WAAW,EACX,OAAO,EACP,WAAW,EACX,YAAY,EACZ,UAAU,EACV,eAAe,EACf,aAAa,EACb,kBAAkB,EAClB,aAAa,GACd,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EACV,UAAU,EACV,WAAW,EACX,aAAa,EACb,gBAAgB,EAChB,UAAU,EACV,WAAW,EACX,eAAe,EACf,aAAa,EACb,cAAc,EACd,YAAY,EACZ,mBAAmB,EACnB,cAAc,EACd,eAAe,EACf,aAAa,GACd,MAAM,uBAAuB,CAAC;AAE/B,YAAY,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,2BAA2B,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/index.js

@@ -28,6 +28,10 @@ export { fetchFromToolShed, fetchFromGalaxy, ToolFetchError } from "./client/ind
 export { getTRSToolVersions, getLatestTRSToolVersion } from "./client/index.js";
 /** High-level service: fetch tools from multiple sources with automatic caching. */
 export { ToolInfoService } from "./tool-info.js";
+export { ignoreDiagnostic } from "./diagnostics.js";
 /** Shared YAML config schema for tool sources and cache settings. */
 export { WorkflowToolConfig, ToolSourceConfig, ToolCacheConfig, toolInfoOptionsFromConfig, } from "./config.js";
+/** Framework-agnostic HTTP handlers + DTOs shared by gxwf-web and tool-cache-proxy. */
+export { HttpError, matchCacheRoute, dispatchCacheRoute, cacheToTrs, cacheToTrsOne, entryToTrsVersion, listCache, cacheStats, deleteCacheEntry, clearCache, refetchTool, addTool, searchTools, trsListTools, trsGetTool, trsListVersions, getParsedTool, getParameterSchema, getToolSource, } from "./cache-http/index.js";
+export { fetchToolSourceFromToolShed, fetchToolSourceFromGalaxy } from "./client/index.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO;AACL,4FAA4F;AAC5F,mBAAmB;AACnB,oEAAoE;AACpE,aAAa;AACb,wFAAwF;AACxF,uBAAuB;AACvB,gGAAgG;AAChG,WAAW;AACX,sFAAsF;AACtF,QAAQ;AACR,iFAAiF;AACjF,UAAU;AACV,mEAAmE;AACnE,SAAS,EACT,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,kBAAkB,CAAC;AAS1B,sEAAsE;AACtE,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AACzD,uEAAuE;AACvE,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACvF,8DAA8D;AAC9D,OAAO,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAEhF,oFAAoF;AACpF,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEjD,qEAAqE;AACrE,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,eAAe,EACf,yBAAyB,GAC1B,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO;AACL,4FAA4F;AAC5F,mBAAmB;AACnB,oEAAoE;AACpE,aAAa;AACb,wFAAwF;AACxF,uBAAuB;AACvB,gGAAgG;AAChG,WAAW;AACX,sFAAsF;AACtF,QAAQ;AACR,iFAAiF;AACjF,UAAU;AACV,mEAAmE;AACnE,SAAS,EACT,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,kBAAkB,CAAC;AAU1B,sEAAsE;AACtE,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AACzD,uEAAuE;AACvE,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACvF,8DAA8D;AAC9D,OAAO,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAEhF,oFAAoF;AACpF,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEpD,qEAAqE;AACrE,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,eAAe,EACf,yBAAyB,GAC1B,MAAM,aAAa,CAAC;AAGrB,uFAAuF;AACvF,OAAO,EACL,SAAS,EACT,eAAe,EACf,kBAAkB,EAGlB,UAAU,EACV,aAAa,EACb,iBAAiB,EACjB,SAAS,EACT,UAAU,EACV,gBAAgB,EAChB,UAAU,EACV,WAAW,EACX,OAAO,EACP,WAAW,EACX,YAAY,EACZ,UAAU,EACV,eAAe,EACf,aAAa,EACb,kBAAkB,EAClB,aAAa,GACd,MAAM,uBAAuB,CAAC;AAmB/B,OAAO,EAAE,2BAA2B,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/node-http.d.ts

@@ -0,0 +1,39 @@
+/**
+ * @module @galaxy-tool-util/core/node-http
+ *
+ * Shared Node `http` adapter helpers for servers that compose
+ * `matchCacheRoute` / `dispatchCacheRoute` with their own routes
+ * (`gxwf-web`, `tool-cache-proxy`).
+ *
+ * Re-exported from `@galaxy-tool-util/core/node` — import from there.
+ */
+import type { IncomingMessage, ServerResponse } from "node:http";
+import type { CacheResult } from "./cache-http/route-table.js";
+/** Write a JSON response with status, content-type, and content-length set. */
+export declare function writeJson(res: ServerResponse, status: number, body: unknown): void;
+/** Serialize a cache handler result, preserving source bytes and response headers. */
+export declare function writeCacheResult(res: ServerResponse, result: CacheResult): void;
+export interface CorsOptions {
+    /** `Access-Control-Allow-Origin` value. Default `*`. */
+    origin?: string;
+    /** `Access-Control-Allow-Methods` value. */
+    methods?: string;
+    /** `Access-Control-Allow-Headers` value. */
+    headers?: string;
+}
+/** Set `Access-Control-Allow-*` headers on a response. */
+export declare function setCorsHeaders(res: ServerResponse, opts?: CorsOptions): void;
+/** Read a JSON body off the request. Throws `HttpError(400)` on parse failure. */
+export declare function readJsonBody<T>(req: IncomingMessage): Promise<T>;
+export interface ServeStaticOptions {
+    /** Content-Security-Policy header to set on responses. Omit to skip. */
+    csp?: string;
+    /** Extra MIME-type entries, merged over the defaults. */
+    mimeTypes?: Record<string, string>;
+}
+/**
+ * Serve a file from `uiDir` based on `urlPath`, falling back to `index.html`
+ * for SPA routing. Guards against path traversal. Uses the merged MIME table.
+ */
+export declare function serveStatic(res: ServerResponse, uiDir: string, urlPath: string, opts?: ServeStaticOptions): Promise<void>;
+//# sourceMappingURL=node-http.d.ts.map

package/dist/node-http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-http.d.ts","sourceRoot":"","sources":["../src/node-http.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AACjE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAsB/D,+EAA+E;AAC/E,wBAAgB,SAAS,CAAC,GAAG,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI,CAOlF;AAED,sFAAsF;AACtF,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,cAAc,EAAE,MAAM,EAAE,WAAW,GAAG,IAAI,CAO/E;AAED,MAAM,WAAW,WAAW;IAC1B,wDAAwD;IACxD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,4CAA4C;IAC5C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4CAA4C;IAC5C,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,0DAA0D;AAC1D,wBAAgB,cAAc,CAAC,GAAG,EAAE,cAAc,EAAE,IAAI,GAAE,WAAgB,GAAG,IAAI,CAWhF;AAED,kFAAkF;AAClF,wBAAsB,YAAY,CAAC,CAAC,EAAE,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,CAAC,CAAC,CAatE;AAED,MAAM,WAAW,kBAAkB;IACjC,wEAAwE;IACxE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,yDAAyD;IACzD,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACpC;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAC/B,GAAG,EAAE,cAAc,EACnB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,kBAAuB,GAC5B,OAAO,CAAC,IAAI,CAAC,CAkCf"}

package/dist/node-http.js

@@ -0,0 +1,114 @@
+/**
+ * @module @galaxy-tool-util/core/node-http
+ *
+ * Shared Node `http` adapter helpers for servers that compose
+ * `matchCacheRoute` / `dispatchCacheRoute` with their own routes
+ * (`gxwf-web`, `tool-cache-proxy`).
+ *
+ * Re-exported from `@galaxy-tool-util/core/node` — import from there.
+ */
+import * as fs from "node:fs";
+import * as fsPromises from "node:fs/promises";
+import * as path from "node:path";
+import { HttpError } from "./cache-http/error.js";
+const DEFAULT_MIME_TYPES = {
+    ".html": "text/html; charset=utf-8",
+    ".js": "application/javascript",
+    ".mjs": "application/javascript",
+    ".css": "text/css",
+    ".json": "application/json",
+    ".svg": "image/svg+xml",
+    ".png": "image/png",
+    ".jpg": "image/jpeg",
+    ".jpeg": "image/jpeg",
+    ".gif": "image/gif",
+    ".webp": "image/webp",
+    ".ico": "image/x-icon",
+    ".woff2": "font/woff2",
+    ".woff": "font/woff",
+    ".ttf": "font/ttf",
+    ".map": "application/json",
+};
+/** Write a JSON response with status, content-type, and content-length set. */
+export function writeJson(res, status, body) {
+    const payload = JSON.stringify(body);
+    res.writeHead(status, {
+        "Content-Type": "application/json",
+        "Content-Length": Buffer.byteLength(payload),
+    });
+    res.end(payload);
+}
+/** Serialize a cache handler result, preserving source bytes and response headers. */
+export function writeCacheResult(res, result) {
+    if (result.kind === "json") {
+        writeJson(res, 200, result.body);
+    }
+    else {
+        res.writeHead(200, { ...result.headers, "Content-Length": result.body.byteLength });
+        res.end(result.body);
+    }
+}
+/** Set `Access-Control-Allow-*` headers on a response. */
+export function setCorsHeaders(res, opts = {}) {
+    res.setHeader("Access-Control-Expose-Headers", "language, X-Tool-Source-Macros-Expanded");
+    res.setHeader("Access-Control-Allow-Origin", opts.origin ?? "*");
+    res.setHeader("Access-Control-Allow-Methods", opts.methods ?? "GET, POST, PUT, PATCH, DELETE, OPTIONS");
+    res.setHeader("Access-Control-Allow-Headers", opts.headers ?? "Content-Type, Authorization, If-Unmodified-Since");
+}
+/** Read a JSON body off the request. Throws `HttpError(400)` on parse failure. */
+export async function readJsonBody(req) {
+    return new Promise((resolve, reject) => {
+        const chunks = [];
+        req.on("data", (chunk) => chunks.push(chunk));
+        req.on("end", () => {
+            try {
+                resolve(JSON.parse(Buffer.concat(chunks).toString("utf-8")));
+            }
+            catch (e) {
+                reject(new HttpError(400, `Invalid JSON body: ${String(e)}`));
+            }
+        });
+        req.on("error", reject);
+    });
+}
+/**
+ * Serve a file from `uiDir` based on `urlPath`, falling back to `index.html`
+ * for SPA routing. Guards against path traversal. Uses the merged MIME table.
+ */
+export async function serveStatic(res, uiDir, urlPath, opts = {}) {
+    let decoded;
+    try {
+        decoded = decodeURIComponent(urlPath);
+    }
+    catch {
+        writeJson(res, 400, { detail: "Invalid URL encoding" });
+        return;
+    }
+    const relPath = decoded.replace(/^\/+/, "") || "index.html";
+    const base = path.resolve(uiDir);
+    const resolved = path.resolve(base, relPath);
+    if (resolved !== base && !resolved.startsWith(base + path.sep)) {
+        writeJson(res, 403, { detail: "Forbidden" });
+        return;
+    }
+    const filePath = fs.existsSync(resolved) && fs.statSync(resolved).isFile()
+        ? resolved
+        : path.join(base, "index.html");
+    if (!fs.existsSync(filePath)) {
+        writeJson(res, 404, { detail: "Not found" });
+        return;
+    }
+    const ext = path.extname(filePath);
+    const mime = opts.mimeTypes ? { ...DEFAULT_MIME_TYPES, ...opts.mimeTypes } : DEFAULT_MIME_TYPES;
+    const contentType = mime[ext] ?? "application/octet-stream";
+    const content = await fsPromises.readFile(filePath);
+    const headers = {
+        "Content-Type": contentType,
+        "Content-Length": content.length,
+    };
+    if (opts.csp)
+        headers["Content-Security-Policy"] = opts.csp;
+    res.writeHead(200, headers);
+    res.end(content);
+}
+//# sourceMappingURL=node-http.js.map

package/dist/node-http.js.map

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

package/dist/node.d.ts

@@ -9,4 +9,5 @@
 export { FilesystemCacheStorage, DEFAULT_CACHE_DIR, CACHE_DIR_ENV_VAR, getCacheDir, makeNodeToolCache, makeNodeToolInfoService, } from "./cache/node.js";
 export type { NodeToolCacheOptions, NodeToolInfoOptions } from "./cache/node.js";
 export { loadWorkflowToolConfig } from "./config-node.js";
+export { writeJson, writeCacheResult, setCorsHeaders, readJsonBody, serveStatic, type CorsOptions, type ServeStaticOptions, } from "./node-http.js";
 //# sourceMappingURL=node.d.ts.map

package/dist/node.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../src/node.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACL,sBAAsB,EACtB,iBAAiB,EACjB,iBAAiB,EACjB,WAAW,EACX,iBAAiB,EACjB,uBAAuB,GACxB,MAAM,iBAAiB,CAAC;AACzB,YAAY,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAEjF,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../src/node.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACL,sBAAsB,EACtB,iBAAiB,EACjB,iBAAiB,EACjB,WAAW,EACX,iBAAiB,EACjB,uBAAuB,GACxB,MAAM,iBAAiB,CAAC;AACzB,YAAY,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAEjF,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAE1D,OAAO,EACL,SAAS,EACT,gBAAgB,EAChB,cAAc,EACd,YAAY,EACZ,WAAW,EACX,KAAK,WAAW,EAChB,KAAK,kBAAkB,GACxB,MAAM,gBAAgB,CAAC"}

package/dist/node.js

@@ -8,4 +8,5 @@
  */
 export { FilesystemCacheStorage, DEFAULT_CACHE_DIR, CACHE_DIR_ENV_VAR, getCacheDir, makeNodeToolCache, makeNodeToolInfoService, } from "./cache/node.js";
 export { loadWorkflowToolConfig } from "./config-node.js";
+export { writeJson, writeCacheResult, setCorsHeaders, readJsonBody, serveStatic, } from "./node-http.js";
 //# sourceMappingURL=node.js.map

package/dist/node.js.map

@@ -1 +1 @@
-{"version":3,"file":"node.js","sourceRoot":"","sources":["../src/node.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACL,sBAAsB,EACtB,iBAAiB,EACjB,iBAAiB,EACjB,WAAW,EACX,iBAAiB,EACjB,uBAAuB,GACxB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"node.js","sourceRoot":"","sources":["../src/node.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACL,sBAAsB,EACtB,iBAAiB,EACjB,iBAAiB,EACjB,WAAW,EACX,iBAAiB,EACjB,uBAAuB,GACxB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAE1D,OAAO,EACL,SAAS,EACT,gBAAgB,EAChB,cAAc,EACd,YAAY,EACZ,WAAW,GAGZ,MAAM,gBAAgB,CAAC"}

package/dist/tool-info.d.ts

@@ -1,6 +1,8 @@
 import type { ParsedTool } from "@galaxy-tool-util/schema";
 import { ToolCache } from "./cache/tool-cache.js";
+import type { ToolSourceDocument } from "./tool-source.js";
 import type { CacheStorage } from "./cache/storage/interface.js";
+import { type DiagnosticSink } from "./diagnostics.js";
 /** A remote source for fetching tool metadata. */
 export interface ToolSource {
     type: "toolshed" | "galaxy";
@@ -16,6 +18,8 @@ export interface ToolInfoOptions {
     /** @deprecated Use sources instead. Kept for simple single-source usage. */
     galaxyUrl?: string;
     fetcher?: typeof fetch;
+    /** Receives recoverable fetch/cache diagnostics. Silent by default. */
+    onDiagnostic?: DiagnosticSink;
 }
 /**
  * High-level service for fetching Galaxy tool metadata with automatic caching.
@@ -25,8 +29,11 @@ export declare class ToolInfoService {
     readonly cache: ToolCache;
     private readonly sources;
     private readonly fetcher;
+    private readonly onDiagnostic;
     constructor(opts: ToolInfoOptions);
     getToolInfo(toolId: string, toolVersion?: string | null): Promise<ParsedTool | null>;
+    /** Lazy wrapper-source fetch with write-through caching, independent of parsed metadata. */
+    fetchToolSource(toolId: string, toolVersion?: string | null): Promise<ToolSourceDocument | null>;
     /**
      * Like {@link getToolInfo}, but also returns the cache key the tool lives under
      * — the authoritative key this service caches with. Callers needing the key

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

@@ -1 +1 @@
-{"version":3,"file":"tool-info.d.ts","sourceRoot":"","sources":["../src/tool-info.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,EAAwB,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAIxE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAEjE,kDAAkD;AAClD,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,UAAU,GAAG,QAAQ,CAAC;IAC5B,GAAG,EAAE,MAAM,CAAC;CACb;AAED,0DAA0D;AAC1D,MAAM,WAAW,eAAe;IAC9B,gGAAgG;IAChG,OAAO,EAAE,YAAY,CAAC;IACtB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,4FAA4F;IAC5F,OAAO,CAAC,EAAE,UAAU,EAAE,CAAC;IACvB,4EAA4E;IAC5E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,KAAK,CAAC;CACxB;AAED;;;GAGG;AACH,qBAAa,eAAe;IAC1B,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IAC1B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAe;IACvC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAe;gBAE3B,IAAI,EAAE,eAAe;IAsB3B,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAK1F;;;;;OAKG;IACG,WAAW,CACf,MAAM,EAAE,MAAM,EACd,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,GAC1B,OAAO,CAAC;QAAE,IAAI,EAAE,UAAU,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IA8EpD;;;OAGG;YACW,oBAAoB;IAalC;;;;;;;OAOG;IACG,OAAO,CACX,MAAM,EAAE,MAAM,EACd,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,EAC3B,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,GACzB,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAC;QAAC,aAAa,EAAE,OAAO,CAAA;KAAE,CAAC;IAoCpE,OAAO,CACX,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,UAAU,EACtB,MAAM,GAAE,MAAgB,EACxB,SAAS,GAAE,MAAW,GACrB,OAAO,CAAC,MAAM,CAAC;CAOnB"}
+{"version":3,"file":"tool-info.d.ts","sourceRoot":"","sources":["../src/tool-info.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,EAAwB,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAKxE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAE3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,EAAoB,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEzE,kDAAkD;AAClD,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,UAAU,GAAG,QAAQ,CAAC;IAC5B,GAAG,EAAE,MAAM,CAAC;CACb;AAED,0DAA0D;AAC1D,MAAM,WAAW,eAAe;IAC9B,gGAAgG;IAChG,OAAO,EAAE,YAAY,CAAC;IACtB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,4FAA4F;IAC5F,OAAO,CAAC,EAAE,UAAU,EAAE,CAAC;IACvB,4EAA4E;IAC5E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,KAAK,CAAC;IACvB,uEAAuE;IACvE,YAAY,CAAC,EAAE,cAAc,CAAC;CAC/B;AAED;;;GAGG;AACH,qBAAa,eAAe;IAC1B,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IAC1B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAe;IACvC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAe;IACvC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAiB;gBAElC,IAAI,EAAE,eAAe;IAwB3B,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAK1F,4FAA4F;IACtF,eAAe,CACnB,MAAM,EAAE,MAAM,EACd,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,GAC1B,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC;IA+DrC;;;;;OAKG;IACG,WAAW,CACf,MAAM,EAAE,MAAM,EACd,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,GAC1B,OAAO,CAAC;QAAE,IAAI,EAAE,UAAU,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAoFpD;;;OAGG;YACW,oBAAoB;IAelC;;;;;;;OAOG;IACG,OAAO,CACX,MAAM,EAAE,MAAM,EACd,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,EAC3B,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,GACzB,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAC;QAAC,aAAa,EAAE,OAAO,CAAA;KAAE,CAAC;IAiCpE,OAAO,CACX,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,UAAU,EACtB,MAAM,GAAE,MAAgB,EACxB,SAAS,GAAE,MAAW,GACrB,OAAO,CAAC,MAAM,CAAC;CAOnB"}