@galaxy-tool-util/core 1.10.0 → 1.12.0

package/dist/cache-http/cache-to-trs.js

@@ -0,0 +1,81 @@
+/**
+ * Convert cache index entries into GA4GH TRS Tool / ToolVersion shapes.
+ *
+ * Mapping (per merged plan §3):
+ *   Tool.id              ← tool_id (TRS form, ~-separated; we already store it that way)
+ *   Tool.organization    ← left of first `~`, falling back to tool_id when there is no separator
+ *   Tool.url             ← {baseUrl}/api/ga4gh/trs/v2/tools/{tool_id}
+ *   Tool.toolclass       ← GALAXY_TOOL_CLASS
+ *   Tool.versions        ← entries grouped by tool_id, mapped to ToolVersion
+ *   ToolVersion.id       ← tool_version
+ *   ToolVersion.url      ← {baseUrl}/api/ga4gh/trs/v2/tools/{tool_id}/versions/{tool_version}
+ *   ToolVersion.descriptor_type ← ["GALAXY"]
+ */
+import { GALAXY_TOOL_CLASS } from "@galaxy-tool-util/schema";
+import { parseToolshedToolId } from "../cache/tool-id.js";
+const TRS_BASE = "/api/ga4gh/trs/v2/tools";
+function trsToolUrl(baseUrl, toolId) {
+    return `${baseUrl}${TRS_BASE}/${encodeURIComponent(toolId)}`;
+}
+function trsVersionUrl(baseUrl, toolId, toolVersion) {
+    return `${trsToolUrl(baseUrl, toolId)}/versions/${encodeURIComponent(toolVersion)}`;
+}
+/**
+ * Normalize a cache `tool_id` to TRS form (`owner~repo~tool_id`). The cache
+ * historically stores readable form (`shed/repos/owner/repo/tool_id`); newer
+ * entries may already be TRS-shaped. Callers reading off the cache index
+ * should always go through this.
+ */
+export function toTrsToolId(rawToolId) {
+    const parsed = parseToolshedToolId(rawToolId);
+    return parsed === null ? rawToolId : parsed.trsToolId;
+}
+function organizationOf(trsToolId) {
+    const idx = trsToolId.indexOf("~");
+    return idx === -1 ? trsToolId : trsToolId.slice(0, idx);
+}
+export function entryToTrsVersion(entry, baseUrl) {
+    const trsToolId = toTrsToolId(entry.tool_id);
+    return {
+        id: entry.tool_version,
+        url: trsVersionUrl(baseUrl, trsToolId, entry.tool_version),
+        descriptor_type: ["GALAXY"],
+    };
+}
+/** Group entries by TRS tool_id and emit one TRS Tool per group. */
+export function cacheToTrs(entries, baseUrl) {
+    const groups = new Map();
+    for (const entry of entries) {
+        const trsToolId = toTrsToolId(entry.tool_id);
+        const list = groups.get(trsToolId);
+        if (list === undefined)
+            groups.set(trsToolId, [entry]);
+        else
+            list.push(entry);
+    }
+    const tools = [];
+    for (const [trsToolId, group] of groups) {
+        tools.push({
+            id: trsToolId,
+            url: trsToolUrl(baseUrl, trsToolId),
+            organization: organizationOf(trsToolId),
+            toolclass: GALAXY_TOOL_CLASS,
+            versions: group.map((e) => entryToTrsVersion(e, baseUrl)),
+        });
+    }
+    return tools;
+}
+/** Build a single TRS Tool by TRS-form tool id, or null if no entries match. */
+export function cacheToTrsOne(entries, trsToolId, baseUrl) {
+    const matching = entries.filter((e) => toTrsToolId(e.tool_id) === trsToolId);
+    if (matching.length === 0)
+        return null;
+    return {
+        id: trsToolId,
+        url: trsToolUrl(baseUrl, trsToolId),
+        organization: organizationOf(trsToolId),
+        toolclass: GALAXY_TOOL_CLASS,
+        versions: matching.map((e) => entryToTrsVersion(e, baseUrl)),
+    };
+}
+//# sourceMappingURL=cache-to-trs.js.map

package/dist/cache-http/cache-to-trs.js.map

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

package/dist/cache-http/dto.d.ts

@@ -0,0 +1,69 @@
+/**
+ * DTOs for the shared cache HTTP surface — admin namespace.
+ *
+ * camelCase at the API boundary; snake_case stays internal to the on-disk
+ * cache index. See `decorate()` in handlers.ts for the mapping.
+ */
+import type { CacheStats } from "../cache/tool-cache.js";
+/** Cache entry decorated with admin metadata for inspector UIs. */
+export interface CachedToolEntry {
+    cacheKey: string;
+    toolId: string;
+    toolVersion: string;
+    /** Cache request version when it differs from the displayed wrapper version (e.g. _default_). */
+    requestVersion?: string;
+    source: string;
+    sourceUrl: string;
+    cachedAt: string;
+    /** Omitted if storage backend lacks `stat()` support. */
+    sizeBytes?: number;
+    /** Probed only when the caller requests `decode=true`; defaults to true. */
+    decodable: boolean;
+    /** Deep link to the ToolShed repo page when the tool id is parseable. */
+    toolshedUrl?: string;
+    /** False for orphan reconstructions / unknown ids — they can't drive a refetch. */
+    refetchable: boolean;
+}
+export interface ListResponse {
+    entries: CachedToolEntry[];
+    stats: CacheStats;
+}
+export interface DeleteResponse {
+    removed: boolean;
+}
+export interface ClearResponse {
+    removed: number;
+}
+export interface RefetchRequest {
+    toolId: string;
+    toolVersion?: string;
+}
+export interface RefetchResponse {
+    cacheKey: string;
+    fetched: boolean;
+    alreadyCached: boolean;
+}
+export interface AddRequest {
+    toolId: string;
+    toolVersion?: string;
+}
+export interface AddResponse {
+    cacheKey: string;
+    alreadyCached: boolean;
+}
+/** Tool search results (substring match over id/name/description). */
+export interface SearchResults {
+    q: string;
+    page: number;
+    pageSize: number;
+    total: number;
+    hits: Array<{
+        toolId: string;
+        toolVersion: string;
+        name?: string;
+        description?: string;
+    }>;
+}
+/** Schema kind for parameter_*_schema endpoints. */
+export type ParameterSchemaKind = "request" | "landing_request" | "test_case_xml";
+//# sourceMappingURL=dto.d.ts.map

package/dist/cache-http/dto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dto.d.ts","sourceRoot":"","sources":["../../src/cache-http/dto.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEzD,mEAAmE;AACnE,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,iGAAiG;IACjG,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,yDAAyD;IACzD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4EAA4E;IAC5E,SAAS,EAAE,OAAO,CAAC;IACnB,yEAAyE;IACzE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mFAAmF;IACnF,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,KAAK,EAAE,UAAU,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,OAAO,CAAC;CACxB;AAED,sEAAsE;AACtE,MAAM,WAAW,aAAa;IAC5B,CAAC,EAAE,MAAM,CAAC;IACV,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,KAAK,CAAC;QACV,MAAM,EAAE,MAAM,CAAC;QACf,WAAW,EAAE,MAAM,CAAC;QACpB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC,CAAC;CACJ;AAED,oDAAoD;AACpD,MAAM,MAAM,mBAAmB,GAAG,SAAS,GAAG,iBAAiB,GAAG,eAAe,CAAC"}

package/dist/cache-http/dto.js

@@ -0,0 +1,8 @@
+/**
+ * DTOs for the shared cache HTTP surface — admin namespace.
+ *
+ * camelCase at the API boundary; snake_case stays internal to the on-disk
+ * cache index. See `decorate()` in handlers.ts for the mapping.
+ */
+export {};
+//# sourceMappingURL=dto.js.map

package/dist/cache-http/dto.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dto.js","sourceRoot":"","sources":["../../src/cache-http/dto.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/cache-http/error.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Framework-agnostic HTTP error consumed by both gxwf-web and tool-cache-proxy
+ * adapters. Status + message + optional structured detail.
+ */
+export declare class HttpError extends Error {
+    readonly status: number;
+    readonly detail?: unknown;
+    constructor(status: number, message: string, detail?: unknown);
+}
+//# sourceMappingURL=error.d.ts.map

package/dist/cache-http/error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../../src/cache-http/error.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,qBAAa,SAAU,SAAQ,KAAK;IAClC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;gBACd,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO;CAM9D"}

package/dist/cache-http/error.js

@@ -0,0 +1,15 @@
+/**
+ * Framework-agnostic HTTP error consumed by both gxwf-web and tool-cache-proxy
+ * adapters. Status + message + optional structured detail.
+ */
+export class HttpError extends Error {
+    status;
+    detail;
+    constructor(status, message, detail) {
+        super(message);
+        this.name = "HttpError";
+        this.status = status;
+        this.detail = detail;
+    }
+}
+//# sourceMappingURL=error.js.map

package/dist/cache-http/error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.js","sourceRoot":"","sources":["../../src/cache-http/error.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,OAAO,SAAU,SAAQ,KAAK;IACzB,MAAM,CAAS;IACf,MAAM,CAAW;IAC1B,YAAY,MAAc,EAAE,OAAe,EAAE,MAAgB;QAC3D,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;QACxB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;CACF"}

package/dist/cache-http/handlers.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Framework-agnostic handler functions for the shared cache HTTP surface.
+ *
+ * Both gxwf-web (Route-union dispatch) and tool-cache-proxy (node:http switch)
+ * call these functions; their server-specific layer just parses URL/body and
+ * serializes the return value. HTTP failures throw `HttpError`.
+ */
+import { type TrsTool, type TrsToolVersion } from "@galaxy-tool-util/schema";
+import type { ToolInfoService } from "../tool-info.js";
+import type { ToolSourceDocument } from "../tool-source.js";
+import { type CacheStats } from "../cache/tool-cache.js";
+import type { AddRequest, AddResponse, ClearResponse, DeleteResponse, ListResponse, ParameterSchemaKind, RefetchRequest, RefetchResponse, SearchResults } from "./dto.js";
+/** Per-request context — the service implements both reads and admin ops. */
+export interface HandlerCtx {
+    service: ToolInfoService;
+    /** Absolute base URL for self-referential links (TRS Tool.url etc.). May be empty. */
+    baseUrl: string;
+}
+export interface ListOptions {
+    /** Probe each entry to flag undecodable payloads. Adds N file reads. */
+    decode?: boolean;
+}
+export declare function listCache(ctx: HandlerCtx, opts?: ListOptions): Promise<ListResponse>;
+export declare function cacheStats(ctx: HandlerCtx): Promise<CacheStats>;
+export declare function deleteCacheEntry(ctx: HandlerCtx, cacheKey: string): Promise<DeleteResponse>;
+export declare function clearCache(ctx: HandlerCtx, prefix?: string): Promise<ClearResponse>;
+export declare function refetchTool(ctx: HandlerCtx, body: RefetchRequest): Promise<RefetchResponse>;
+export declare function addTool(ctx: HandlerCtx, body: AddRequest): Promise<AddResponse>;
+export interface SearchOptions {
+    q?: string;
+    page?: number;
+    pageSize?: number;
+}
+export declare function searchTools(ctx: HandlerCtx, opts: SearchOptions): Promise<SearchResults>;
+export declare function trsListTools(ctx: HandlerCtx): Promise<TrsTool[]>;
+export declare function trsGetTool(ctx: HandlerCtx, toolId: string): Promise<TrsTool>;
+export declare function trsListVersions(ctx: HandlerCtx, toolId: string): Promise<TrsToolVersion[]>;
+export declare function getParsedTool(ctx: HandlerCtx, toolId: string, toolVersion: string): Promise<unknown>;
+export declare function getParameterSchema(ctx: HandlerCtx, toolId: string, toolVersion: string, kind: ParameterSchemaKind): Promise<unknown>;
+export declare function getToolSource(ctx: HandlerCtx, toolId: string, toolVersion: string): Promise<ToolSourceDocument>;
+//# sourceMappingURL=handlers.d.ts.map

package/dist/cache-http/handlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handlers.d.ts","sourceRoot":"","sources":["../../src/cache-http/handlers.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,EAKL,KAAK,OAAO,EACZ,KAAK,cAAc,EACpB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAE5D,OAAO,EAAwB,KAAK,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAI/E,OAAO,KAAK,EACV,UAAU,EACV,WAAW,EAEX,aAAa,EACb,cAAc,EACd,YAAY,EACZ,mBAAmB,EACnB,cAAc,EACd,eAAe,EACf,aAAa,EACd,MAAM,UAAU,CAAC;AAElB,6EAA6E;AAC7E,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,eAAe,CAAC;IACzB,sFAAsF;IACtF,OAAO,EAAE,MAAM,CAAC;CACjB;AAyDD,MAAM,WAAW,WAAW;IAC1B,wEAAwE;IACxE,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAID,wBAAsB,SAAS,CAAC,GAAG,EAAE,UAAU,EAAE,IAAI,GAAE,WAAgB,GAAG,OAAO,CAAC,YAAY,CAAC,CAuB9F;AAED,wBAAsB,UAAU,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAErE;AAED,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAIjG;AAED,wBAAsB,UAAU,CAAC,GAAG,EAAE,UAAU,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAGzF;AAED,wBAAsB,WAAW,CAAC,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC,CAOjG;AAED,wBAAsB,OAAO,CAAC,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC,CAQrF;AAID,MAAM,WAAW,aAAa;IAC5B,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAID,wBAAsB,WAAW,CAAC,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,CA8C9F;AAED,wBAAsB,YAAY,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAGtE;AAED,wBAAsB,UAAU,CAAC,GAAG,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAKlF;AAED,wBAAsB,eAAe,CAAC,GAAG,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAGhG;AAED,wBAAsB,aAAa,CACjC,GAAG,EAAE,UAAU,EACf,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,OAAO,CAAC,CAIlB;AAQD,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,UAAU,EACf,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,mBAAmB,GACxB,OAAO,CAAC,OAAO,CAAC,CAoBlB;AAED,wBAAsB,aAAa,CACjC,GAAG,EAAE,UAAU,EACf,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,kBAAkB,CAAC,CAS7B"}

package/dist/cache-http/handlers.js

@@ -0,0 +1,241 @@
+/**
+ * Framework-agnostic handler functions for the shared cache HTTP surface.
+ *
+ * Both gxwf-web (Route-union dispatch) and tool-cache-proxy (node:http switch)
+ * call these functions; their server-specific layer just parses URL/body and
+ * serializes the return value. HTTP failures throw `HttpError`.
+ */
+import * as S from "effect/Schema";
+import * as JSONSchema from "effect/JSONSchema";
+import { ParsedTool, createFieldModel, } from "@galaxy-tool-util/schema";
+import { parseToolshedToolId, toolIdFromTrs } from "../cache/tool-id.js";
+import { DEFAULT_TOOL_VERSION } from "../cache/tool-cache.js";
+import { cacheKey } from "../cache/cache-key.js";
+import { HttpError } from "./error.js";
+import { cacheToTrs, cacheToTrsOne, toTrsToolId } from "./cache-to-trs.js";
+const decodeParsedTool = S.decodeUnknownSync(ParsedTool);
+function tryDecode(contents) {
+    try {
+        decodeParsedTool(contents);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function decorate(ctx, entry, decode) {
+    // Older caches recorded stock IDs as <shed>/repos/<stock-id>.
+    const stockPrefix = toolIdFromTrs(ctx.service.cache.defaultToolshedUrl, "");
+    const suffix = entry.tool_id.startsWith(stockPrefix)
+        ? entry.tool_id.slice(stockPrefix.length)
+        : null;
+    const toolId = suffix !== null && suffix !== "" && !suffix.includes("/") ? suffix : entry.tool_id;
+    const parsed = parseToolshedToolId(toolId);
+    const refetchable = entry.source !== "orphan" && entry.tool_id !== "unknown" && entry.tool_id !== "";
+    const out = {
+        cacheKey: entry.cache_key,
+        toolId,
+        toolVersion: entry.tool_version,
+        source: entry.source,
+        sourceUrl: entry.source_url,
+        cachedAt: entry.cached_at,
+        // Optimistic when not probing — UI shouldn't flag-as-broken what we
+        // didn't actually check.
+        decodable: true,
+        refetchable,
+    };
+    if (entry.tool_version !== DEFAULT_TOOL_VERSION) {
+        const coords = ctx.service.cache.resolveToolCoordinates(toolId, DEFAULT_TOOL_VERSION);
+        const defaultKey = await cacheKey(coords.toolshedUrl, coords.trsToolId, DEFAULT_TOOL_VERSION);
+        if (defaultKey === entry.cache_key)
+            out.requestVersion = DEFAULT_TOOL_VERSION;
+    }
+    if (parsed !== null) {
+        const [owner, repo] = parsed.trsToolId.split("~");
+        out.toolshedUrl = `${parsed.toolshedUrl}/view/${encodeURIComponent(owner)}/${encodeURIComponent(repo)}`;
+    }
+    const stat = await ctx.service.cache.statCached(entry.cache_key);
+    if (stat !== null)
+        out.sizeBytes = stat.sizeBytes;
+    if (decode) {
+        const raw = await ctx.service.cache.loadCachedRaw(entry.cache_key);
+        out.decodable = raw !== null && tryDecode(raw);
+    }
+    return out;
+}
+// ── Admin namespace ────────────────────────────────────────────────────
+export async function listCache(ctx, opts = {}) {
+    const raw = (await ctx.service.cache.listCached());
+    const entries = await Promise.all(raw.map((e) => decorate(ctx, e, opts.decode === true)));
+    const bySource = {};
+    let oldest;
+    let newest;
+    let totalBytes = 0;
+    let anySize = false;
+    for (const e of entries) {
+        bySource[e.source] = (bySource[e.source] ?? 0) + 1;
+        if (oldest === undefined || e.cachedAt < oldest)
+            oldest = e.cachedAt;
+        if (newest === undefined || e.cachedAt > newest)
+            newest = e.cachedAt;
+        if (e.sizeBytes !== undefined) {
+            totalBytes += e.sizeBytes;
+            anySize = true;
+        }
+    }
+    const stats = { count: entries.length, bySource };
+    if (oldest !== undefined)
+        stats.oldest = oldest;
+    if (newest !== undefined)
+        stats.newest = newest;
+    if (anySize)
+        stats.totalBytes = totalBytes;
+    return { entries, stats };
+}
+export async function cacheStats(ctx) {
+    return ctx.service.cache.getCacheStats();
+}
+export async function deleteCacheEntry(ctx, cacheKey) {
+    const removed = await ctx.service.cache.removeCached(cacheKey);
+    if (!removed)
+        throw new HttpError(404, `No cached entry: ${cacheKey}`);
+    return { removed };
+}
+export async function clearCache(ctx, prefix) {
+    const removed = await ctx.service.cache.clearCache(prefix);
+    return { removed };
+}
+export async function refetchTool(ctx, body) {
+    if (!body.toolId)
+        throw new HttpError(400, "toolId is required");
+    try {
+        return await ctx.service.refetch(body.toolId, body.toolVersion ?? null, { force: true });
+    }
+    catch (e) {
+        throw new HttpError(502, e instanceof Error ? e.message : String(e));
+    }
+}
+export async function addTool(ctx, body) {
+    if (!body.toolId)
+        throw new HttpError(400, "toolId is required");
+    try {
+        const r = await ctx.service.refetch(body.toolId, body.toolVersion ?? null);
+        return { cacheKey: r.cacheKey, alreadyCached: r.alreadyCached };
+    }
+    catch (e) {
+        throw new HttpError(502, e instanceof Error ? e.message : String(e));
+    }
+}
+const DEFAULT_PAGE_SIZE = 25;
+export async function searchTools(ctx, opts) {
+    const q = (opts.q ?? "").trim().toLowerCase();
+    const page = Math.max(1, Math.floor(opts.page ?? 1));
+    const pageSize = Math.max(1, Math.min(200, Math.floor(opts.pageSize ?? DEFAULT_PAGE_SIZE)));
+    const entries = (await ctx.service.cache.listCached());
+    const enriched = await Promise.all(entries.map(async (entry) => {
+        let name;
+        let description;
+        const raw = await ctx.service.cache.loadCachedRaw(entry.cache_key);
+        if (raw !== null && typeof raw === "object") {
+            const r = raw;
+            if (typeof r.name === "string")
+                name = r.name;
+            if (typeof r.description === "string")
+                description = r.description;
+        }
+        return { entry, name, description };
+    }));
+    const filtered = q === ""
+        ? enriched
+        : enriched.filter(({ entry, name, description }) => {
+            if (entry.tool_id.toLowerCase().includes(q))
+                return true;
+            if (name !== undefined && name.toLowerCase().includes(q))
+                return true;
+            if (description !== undefined && description.toLowerCase().includes(q))
+                return true;
+            return false;
+        });
+    const total = filtered.length;
+    const start = (page - 1) * pageSize;
+    const slice = filtered.slice(start, start + pageSize);
+    return {
+        q,
+        page,
+        pageSize,
+        total,
+        hits: slice.map(({ entry, name, description }) => {
+            const hit = {
+                toolId: toTrsToolId(entry.tool_id),
+                toolVersion: entry.tool_version,
+            };
+            if (name !== undefined)
+                hit.name = name;
+            if (description !== undefined)
+                hit.description = description;
+            return hit;
+        }),
+    };
+}
+export async function trsListTools(ctx) {
+    const entries = (await ctx.service.cache.listCached());
+    return cacheToTrs(entries, ctx.baseUrl);
+}
+export async function trsGetTool(ctx, toolId) {
+    const entries = (await ctx.service.cache.listCached());
+    const tool = cacheToTrsOne(entries, toolId, ctx.baseUrl);
+    if (tool === null)
+        throw new HttpError(404, `Tool not found: ${toolId}`);
+    return tool;
+}
+export async function trsListVersions(ctx, toolId) {
+    const tool = await trsGetTool(ctx, toolId);
+    return [...tool.versions];
+}
+export async function getParsedTool(ctx, toolId, toolVersion) {
+    const tool = await ctx.service.getToolInfo(toolId, toolVersion);
+    if (tool === null)
+        throw new HttpError(404, `Tool not found: ${toolId}@${toolVersion}`);
+    return tool;
+}
+const SCHEMA_KIND_TO_REPRESENTATION = {
+    request: "request",
+    landing_request: "landing_request",
+    test_case_xml: "test_case_xml",
+};
+export async function getParameterSchema(ctx, toolId, toolVersion, kind) {
+    const representation = SCHEMA_KIND_TO_REPRESENTATION[kind];
+    if (representation === undefined) {
+        throw new HttpError(400, `Unknown parameter schema kind: ${kind}`);
+    }
+    const tool = await ctx.service.getToolInfo(toolId, toolVersion);
+    if (tool === null)
+        throw new HttpError(404, `Tool not found: ${toolId}@${toolVersion}`);
+    const bundle = {
+        parameters: tool.inputs,
+    };
+    const effectSchema = createFieldModel(bundle, representation);
+    if (!effectSchema) {
+        throw new HttpError(500, "Could not generate schema — unsupported parameter types");
+    }
+    try {
+        return JSONSchema.make(effectSchema);
+    }
+    catch (e) {
+        const msg = e instanceof Error ? e.message : String(e);
+        throw new HttpError(500, `JSON Schema generation failed: ${msg}`);
+    }
+}
+export async function getToolSource(ctx, toolId, toolVersion) {
+    let source;
+    try {
+        source = await ctx.service.fetchToolSource(toolId, toolVersion);
+    }
+    catch (err) {
+        throw new HttpError(502, err instanceof Error ? err.message : String(err));
+    }
+    if (source === null)
+        throw new HttpError(404, `Tool source not found: ${toolId}@${toolVersion}`);
+    return source;
+}
+//# sourceMappingURL=handlers.js.map

package/dist/cache-http/handlers.js.map

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

package/dist/cache-http/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @module @galaxy-tool-util/core/http
+ *
+ * Framework-agnostic HTTP-handler surface shared by `gxwf-web` and
+ * `tool-cache-proxy`. Server adapters parse URL/body and serialize the
+ * return value; failures throw `HttpError`.
+ */
+export { HttpError } from "./error.js";
+export { matchCacheRoute, dispatchCacheRoute, type CacheResult, type CacheRoute, } from "./route-table.js";
+export { cacheToTrs, cacheToTrsOne, entryToTrsVersion, type CacheIndexRecord, } from "./cache-to-trs.js";
+export { type HandlerCtx, type ListOptions, type SearchOptions, listCache, cacheStats, deleteCacheEntry, clearCache, refetchTool, addTool, searchTools, trsListTools, trsGetTool, trsListVersions, getParsedTool, getParameterSchema, getToolSource, } from "./handlers.js";
+export type { AddRequest, AddResponse, CachedToolEntry, ClearResponse, DeleteResponse, ListResponse, ParameterSchemaKind, RefetchRequest, RefetchResponse, SearchResults, } from "./dto.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/cache-http/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cache-http/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,KAAK,WAAW,EAChB,KAAK,UAAU,GAChB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,UAAU,EACV,aAAa,EACb,iBAAiB,EACjB,KAAK,gBAAgB,GACtB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,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,eAAe,CAAC;AACvB,YAAY,EACV,UAAU,EACV,WAAW,EACX,eAAe,EACf,aAAa,EACb,cAAc,EACd,YAAY,EACZ,mBAAmB,EACnB,cAAc,EACd,eAAe,EACf,aAAa,GACd,MAAM,UAAU,CAAC"}

package/dist/cache-http/index.js

@@ -0,0 +1,12 @@
+/**
+ * @module @galaxy-tool-util/core/http
+ *
+ * Framework-agnostic HTTP-handler surface shared by `gxwf-web` and
+ * `tool-cache-proxy`. Server adapters parse URL/body and serialize the
+ * return value; failures throw `HttpError`.
+ */
+export { HttpError } from "./error.js";
+export { matchCacheRoute, dispatchCacheRoute, } from "./route-table.js";
+export { cacheToTrs, cacheToTrsOne, entryToTrsVersion, } from "./cache-to-trs.js";
+export { listCache, cacheStats, deleteCacheEntry, clearCache, refetchTool, addTool, searchTools, trsListTools, trsGetTool, trsListVersions, getParsedTool, getParameterSchema, getToolSource, } from "./handlers.js";
+//# sourceMappingURL=index.js.map

package/dist/cache-http/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cache-http/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EACL,eAAe,EACf,kBAAkB,GAGnB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,UAAU,EACV,aAAa,EACb,iBAAiB,GAElB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAIL,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,eAAe,CAAC"}

package/dist/cache-http/route-table.d.ts

@@ -0,0 +1,67 @@
+/**
+ * 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 { type HandlerCtx } from "./handlers.js";
+import type { ParameterSchemaKind } from "./dto.js";
+export type CacheRoute = {
+    handler: "searchTools";
+    query: URLSearchParams;
+} | {
+    handler: "trsListTools";
+} | {
+    handler: "trsGetTool";
+    toolId: string;
+} | {
+    handler: "trsListVersions";
+    toolId: string;
+} | {
+    handler: "getParsedTool";
+    toolId: string;
+    toolVersion: string;
+} | {
+    handler: "getParameterSchema";
+    toolId: string;
+    toolVersion: string;
+    kind: ParameterSchemaKind;
+} | {
+    handler: "getToolSource";
+    toolId: string;
+    toolVersion: string;
+} | {
+    handler: "listCache";
+    query: URLSearchParams;
+} | {
+    handler: "cacheStats";
+} | {
+    handler: "deleteCacheEntry";
+    cacheKey: string;
+} | {
+    handler: "clearCache";
+    query: URLSearchParams;
+} | {
+    handler: "refetchTool";
+} | {
+    handler: "addTool";
+};
+/** Match a method + url against the shared cache HTTP surface. */
+export declare function matchCacheRoute(method: string, url: string): CacheRoute | null;
+/** Handler results carry either a JSON payload or source bytes and headers. */
+export type CacheResult = {
+    kind: "json";
+    body: unknown;
+} | {
+    kind: "bytes";
+    body: Uint8Array;
+    headers: Record<string, string>;
+};
+/**
+ * Run a matched route. Body-bearing routes call `readBody` for parsed JSON.
+ * Errors throw `HttpError`; adapters translate them.
+ */
+export declare function dispatchCacheRoute(route: CacheRoute, ctx: HandlerCtx, readBody: <T>() => Promise<T>): Promise<CacheResult>;
+//# sourceMappingURL=route-table.d.ts.map

package/dist/cache-http/route-table.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-table.d.ts","sourceRoot":"","sources":["../../src/cache-http/route-table.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAcL,KAAK,UAAU,EAChB,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EAAc,mBAAmB,EAAkB,MAAM,UAAU,CAAC;AAEhF,MAAM,MAAM,UAAU,GAElB;IAAE,OAAO,EAAE,aAAa,CAAC;IAAC,KAAK,EAAE,eAAe,CAAA;CAAE,GAClD;IAAE,OAAO,EAAE,cAAc,CAAA;CAAE,GAC3B;IAAE,OAAO,EAAE,YAAY,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACzC;IAAE,OAAO,EAAE,iBAAiB,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC9C;IAAE,OAAO,EAAE,eAAe,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GACjE;IACE,OAAO,EAAE,oBAAoB,CAAC;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,mBAAmB,CAAC;CAC3B,GACD;IAAE,OAAO,EAAE,eAAe,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GAEjE;IAAE,OAAO,EAAE,WAAW,CAAC;IAAC,KAAK,EAAE,eAAe,CAAA;CAAE,GAChD;IAAE,OAAO,EAAE,YAAY,CAAA;CAAE,GACzB;IAAE,OAAO,EAAE,kBAAkB,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACjD;IAAE,OAAO,EAAE,YAAY,CAAC;IAAC,KAAK,EAAE,eAAe,CAAA;CAAE,GACjD;IAAE,OAAO,EAAE,aAAa,CAAA;CAAE,GAC1B;IAAE,OAAO,EAAE,SAAS,CAAA;CAAE,CAAC;AAU3B,kEAAkE;AAClE,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAgE9E;AAED,+EAA+E;AAC/E,MAAM,MAAM,WAAW,GACnB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GAC/B;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,UAAU,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,CAAC;AAEzE;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,UAAU,EACjB,GAAG,EAAE,UAAU,EACf,QAAQ,EAAE,CAAC,CAAC,OAAO,OAAO,CAAC,CAAC,CAAC,GAC5B,OAAO,CAAC,WAAW,CAAC,CAetB"}