@galaxy-tool-util/core 0.1.0

package/README.md

@@ -0,0 +1,13 @@
+# @galaxy-tool-util/core
+
+Galaxy tool cache, ToolShed client, and ParsedTool models.
+
+## Installation
+
+```bash
+npm install @galaxy-tool-util/core
+```
+
+## License
+
+MIT

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

@@ -0,0 +1,36 @@
+/** Metadata for a single cached tool entry. */
+export interface CacheIndexEntry {
+    tool_id: string;
+    tool_version: string;
+    /** How the tool was fetched: "api" (ToolShed), "galaxy", or "local". */
+    source: string;
+    source_url: string;
+    /** ISO 8601 timestamp of when the tool was cached. */
+    cached_at: string;
+}
+/** Serialized cache index structure (persisted as index.json). */
+export interface CacheIndexData {
+    entries: Record<string, CacheIndexEntry>;
+}
+/**
+ * Manages the cache index file (index.json) that tracks metadata about cached tools.
+ * Supports lazy loading, add/remove, and listing operations.
+ */
+export declare class CacheIndex {
+    readonly cacheDir: string;
+    private indexPath;
+    private entries;
+    constructor(cacheDir: string);
+    private getEntries;
+    private loadSync;
+    load(): Promise<void>;
+    save(): Promise<void>;
+    add(key: string, toolId: string, toolVersion: string, source: string, sourceUrl?: string): Promise<void>;
+    remove(key: string): Promise<void>;
+    has(key: string): boolean;
+    listAll(): Array<CacheIndexEntry & {
+        cache_key: string;
+    }>;
+    clear(): Promise<void>;
+}
+//# sourceMappingURL=cache-index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cache-index.d.ts","sourceRoot":"","sources":["../../src/cache/cache-index.ts"],"names":[],"mappings":"AAIA,+CAA+C;AAC/C,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,wEAAwE;IACxE,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,sDAAsD;IACtD,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,kEAAkE;AAClE,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;CAC1C;AAED;;;GAGG;AACH,qBAAa,UAAU;IAIT,QAAQ,CAAC,QAAQ,EAAE,MAAM;IAHrC,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,OAAO,CAAgD;gBAE1C,QAAQ,EAAE,MAAM;IAIrC,OAAO,CAAC,UAAU;IAOlB,OAAO,CAAC,QAAQ;IAcV,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAerB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAMrB,GAAG,CACP,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,SAAS,GAAE,MAAW,GACrB,OAAO,CAAC,IAAI,CAAC;IAWV,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQxC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIzB,OAAO,IAAI,KAAK,CAAC,eAAe,GAAG;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IAOnD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAI7B"}

package/dist/cache/cache-index.js

@@ -0,0 +1,87 @@
+import { readFile, writeFile, mkdir } from "node:fs/promises";
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+/**
+ * Manages the cache index file (index.json) that tracks metadata about cached tools.
+ * Supports lazy loading, add/remove, and listing operations.
+ */
+export class CacheIndex {
+    cacheDir;
+    indexPath;
+    entries = null;
+    constructor(cacheDir) {
+        this.cacheDir = cacheDir;
+        this.indexPath = join(cacheDir, "index.json");
+    }
+    getEntries() {
+        if (this.entries === null) {
+            this.entries = this.loadSync();
+        }
+        return this.entries;
+    }
+    loadSync() {
+        if (!existsSync(this.indexPath)) {
+            return {};
+        }
+        try {
+            const raw = readFileSync(this.indexPath, "utf-8");
+            const data = JSON.parse(raw);
+            return data.entries ?? {};
+        }
+        catch (err) {
+            console.debug(`Failed to load cache index (sync): ${err}`);
+            return {};
+        }
+    }
+    async load() {
+        if (!existsSync(this.indexPath)) {
+            this.entries = {};
+            return;
+        }
+        try {
+            const raw = await readFile(this.indexPath, "utf-8");
+            const data = JSON.parse(raw);
+            this.entries = data.entries ?? {};
+        }
+        catch (err) {
+            console.debug(`Failed to load cache index: ${err}`);
+            this.entries = {};
+        }
+    }
+    async save() {
+        await mkdir(this.cacheDir, { recursive: true });
+        const data = { entries: this.getEntries() };
+        await writeFile(this.indexPath, JSON.stringify(data, null, 2));
+    }
+    async add(key, toolId, toolVersion, source, sourceUrl = "") {
+        this.getEntries()[key] = {
+            tool_id: toolId,
+            tool_version: toolVersion,
+            source,
+            source_url: sourceUrl,
+            cached_at: new Date().toISOString(),
+        };
+        await this.save();
+    }
+    async remove(key) {
+        const entries = this.getEntries();
+        if (key in entries) {
+            delete entries[key];
+            await this.save();
+        }
+    }
+    has(key) {
+        return key in this.getEntries();
+    }
+    listAll() {
+        return Object.entries(this.getEntries()).map(([key, entry]) => ({
+            cache_key: key,
+            ...entry,
+        }));
+    }
+    async clear() {
+        this.entries = {};
+        await this.save();
+    }
+}
+//# sourceMappingURL=cache-index.js.map

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

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

package/dist/cache/cache-key.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Compute a deterministic cache key (SHA-256 hex) for a tool.
+ * The key is derived from the ToolShed URL, TRS tool ID, and version.
+ */
+export declare function cacheKey(toolshedUrl: string, trsToolId: string, toolVersion: string): string;
+//# sourceMappingURL=cache-key.d.ts.map

package/dist/cache/cache-key.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-key.d.ts","sourceRoot":"","sources":["../../src/cache/cache-key.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAG5F"}

package/dist/cache/cache-key.js

@@ -0,0 +1,10 @@
+import { createHash } from "node:crypto";
+/**
+ * Compute a deterministic cache key (SHA-256 hex) for a tool.
+ * The key is derived from the ToolShed URL, TRS tool ID, and version.
+ */
+export function cacheKey(toolshedUrl, trsToolId, toolVersion) {
+    const raw = `${toolshedUrl}/${trsToolId}/${toolVersion}`;
+    return createHash("sha256").update(raw).digest("hex");
+}
+//# sourceMappingURL=cache-key.js.map

package/dist/cache/cache-key.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-key.js","sourceRoot":"","sources":["../../src/cache/cache-key.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC;;;GAGG;AACH,MAAM,UAAU,QAAQ,CAAC,WAAmB,EAAE,SAAiB,EAAE,WAAmB;IAClF,MAAM,GAAG,GAAG,GAAG,WAAW,IAAI,SAAS,IAAI,WAAW,EAAE,CAAC;IACzD,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACxD,CAAC"}

package/dist/cache/index.d.ts

@@ -0,0 +1,7 @@
+export { parseToolshedToolId, toolIdFromTrs } from "./tool-id.js";
+export type { ToolCoordinates } from "./tool-id.js";
+export { cacheKey } from "./cache-key.js";
+export { CacheIndex } from "./cache-index.js";
+export type { CacheIndexEntry, CacheIndexData } from "./cache-index.js";
+export { ToolCache, getCacheDir, DEFAULT_CACHE_DIR, CACHE_DIR_ENV_VAR, DEFAULT_TOOLSHED_URL, TOOLSHED_URL_ENV_VAR, } from "./tool-cache.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cache/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClE,YAAY,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACxE,OAAO,EACL,SAAS,EACT,WAAW,EACX,iBAAiB,EACjB,iBAAiB,EACjB,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,iBAAiB,CAAC"}

package/dist/cache/index.js

@@ -0,0 +1,5 @@
+export { parseToolshedToolId, toolIdFromTrs } from "./tool-id.js";
+export { cacheKey } from "./cache-key.js";
+export { CacheIndex } from "./cache-index.js";
+export { ToolCache, getCacheDir, DEFAULT_CACHE_DIR, CACHE_DIR_ENV_VAR, DEFAULT_TOOLSHED_URL, TOOLSHED_URL_ENV_VAR, } from "./tool-cache.js";
+//# sourceMappingURL=index.js.map

package/dist/cache/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cache/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAElE,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,OAAO,EACL,SAAS,EACT,WAAW,EACX,iBAAiB,EACjB,iBAAiB,EACjB,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,iBAAiB,CAAC"}

package/dist/cache/tool-cache.d.ts

@@ -0,0 +1,48 @@
+import { ParsedTool } from "../models/parsed-tool.js";
+import { CacheIndex } from "./cache-index.js";
+/** Default cache directory: `~/.galaxy/tool_info_cache`. */
+export declare const DEFAULT_CACHE_DIR: string;
+/** Environment variable to override the cache directory. */
+export declare const CACHE_DIR_ENV_VAR = "GALAXY_TOOL_CACHE_DIR";
+/** Default Galaxy ToolShed URL. */
+export declare const DEFAULT_TOOLSHED_URL = "https://toolshed.g2.bx.psu.edu";
+/** Environment variable to override the default ToolShed URL. */
+export declare const TOOLSHED_URL_ENV_VAR = "GALAXY_TOOLSHED_URL";
+/** Resolve cache directory: explicit override > env var > default. */
+export declare function getCacheDir(override?: string): string;
+interface ResolvedCoordinates {
+    toolshedUrl: string;
+    trsToolId: string;
+    version: string | null;
+    readableId: string;
+}
+/**
+ * Two-layer cache (memory + filesystem) for parsed Galaxy tool metadata.
+ * Resolves tool IDs to cache keys, loads/saves tool JSON, and manages the cache index.
+ */
+export declare class ToolCache {
+    readonly cacheDir: string;
+    readonly defaultToolshedUrl: string;
+    readonly index: CacheIndex;
+    private memoryCache;
+    constructor(opts?: {
+        cacheDir?: string;
+        defaultToolshedUrl?: string;
+    });
+    resolveToolCoordinates(toolId: string, toolVersion?: string | null): ResolvedCoordinates;
+    private cachePath;
+    hasCached(toolId: string, toolVersion?: string | null): boolean;
+    loadCached(key: string): Promise<ParsedTool | null>;
+    saveTool(key: string, parsedTool: ParsedTool, toolId: string, toolVersion: string, source: string, sourceUrl?: string): Promise<void>;
+    listCached(): Array<{
+        cache_key: string;
+        tool_id: string;
+        tool_version: string;
+        source: string;
+        source_url: string;
+        cached_at: string;
+    }>;
+    clearCache(toolIdPrefix?: string): Promise<void>;
+}
+export {};
+//# sourceMappingURL=tool-cache.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tool-cache.d.ts","sourceRoot":"","sources":["../../src/cache/tool-cache.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAI9C,4DAA4D;AAC5D,eAAO,MAAM,iBAAiB,QAAgD,CAAC;AAC/E,4DAA4D;AAC5D,eAAO,MAAM,iBAAiB,0BAA0B,CAAC;AACzD,mCAAmC;AACnC,eAAO,MAAM,oBAAoB,mCAAmC,CAAC;AACrE,iEAAiE;AACjE,eAAO,MAAM,oBAAoB,wBAAwB,CAAC;AAE1D,sEAAsE;AACtE,wBAAgB,WAAW,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAErD;AAED,UAAU,mBAAmB;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,qBAAa,SAAS;IACpB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,OAAO,CAAC,WAAW,CAAiC;gBAExC,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,kBAAkB,CAAC,EAAE,MAAM,CAAA;KAAE;IAOrE,sBAAsB,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,mBAAmB;IAkBxF,OAAO,CAAC,SAAS;IAIjB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO;IAOzD,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAqBnD,QAAQ,CACZ,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,UAAU,EACtB,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,SAAS,GAAE,MAAW,GACrB,OAAO,CAAC,IAAI,CAAC;IAQhB,UAAU,IAAI,KAAK,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;QAChB,YAAY,EAAE,MAAM,CAAC;QACrB,MAAM,EAAE,MAAM,CAAC;QACf,UAAU,EAAE,MAAM,CAAC;QACnB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;IAII,UAAU,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAmBvD"}

package/dist/cache/tool-cache.js

@@ -0,0 +1,119 @@
+import { readFile, writeFile, mkdir, unlink } from "node:fs/promises";
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+import { homedir } from "node:os";
+import * as S from "effect/Schema";
+import { ParsedTool } from "../models/parsed-tool.js";
+import { CacheIndex } from "./cache-index.js";
+import { cacheKey } from "./cache-key.js";
+import { parseToolshedToolId, toolIdFromTrs } from "./tool-id.js";
+/** Default cache directory: `~/.galaxy/tool_info_cache`. */
+export const DEFAULT_CACHE_DIR = join(homedir(), ".galaxy", "tool_info_cache");
+/** Environment variable to override the cache directory. */
+export const CACHE_DIR_ENV_VAR = "GALAXY_TOOL_CACHE_DIR";
+/** Default Galaxy ToolShed URL. */
+export const DEFAULT_TOOLSHED_URL = "https://toolshed.g2.bx.psu.edu";
+/** Environment variable to override the default ToolShed URL. */
+export const TOOLSHED_URL_ENV_VAR = "GALAXY_TOOLSHED_URL";
+/** Resolve cache directory: explicit override > env var > default. */
+export function getCacheDir(override) {
+    return override ?? process.env[CACHE_DIR_ENV_VAR] ?? DEFAULT_CACHE_DIR;
+}
+/**
+ * Two-layer cache (memory + filesystem) for parsed Galaxy tool metadata.
+ * Resolves tool IDs to cache keys, loads/saves tool JSON, and manages the cache index.
+ */
+export class ToolCache {
+    cacheDir;
+    defaultToolshedUrl;
+    index;
+    memoryCache = new Map();
+    constructor(opts) {
+        this.cacheDir = getCacheDir(opts?.cacheDir);
+        this.defaultToolshedUrl =
+            opts?.defaultToolshedUrl ?? process.env[TOOLSHED_URL_ENV_VAR] ?? DEFAULT_TOOLSHED_URL;
+        this.index = new CacheIndex(this.cacheDir);
+    }
+    resolveToolCoordinates(toolId, toolVersion) {
+        const parsed = parseToolshedToolId(toolId);
+        if (parsed !== null) {
+            return {
+                toolshedUrl: parsed.toolshedUrl,
+                trsToolId: parsed.trsToolId,
+                version: toolVersion ?? parsed.toolVersion,
+                readableId: toolIdFromTrs(parsed.toolshedUrl, parsed.trsToolId),
+            };
+        }
+        return {
+            toolshedUrl: this.defaultToolshedUrl,
+            trsToolId: toolId,
+            version: toolVersion ?? null,
+            readableId: toolIdFromTrs(this.defaultToolshedUrl, toolId),
+        };
+    }
+    cachePath(key) {
+        return join(this.cacheDir, `${key}.json`);
+    }
+    hasCached(toolId, toolVersion) {
+        const coords = this.resolveToolCoordinates(toolId, toolVersion);
+        if (coords.version === null)
+            return false;
+        const key = cacheKey(coords.toolshedUrl, coords.trsToolId, coords.version);
+        return this.memoryCache.has(key) || existsSync(this.cachePath(key));
+    }
+    async loadCached(key) {
+        if (this.memoryCache.has(key)) {
+            return this.memoryCache.get(key);
+        }
+        const path = this.cachePath(key);
+        if (!existsSync(path))
+            return null;
+        try {
+            const raw = await readFile(path, "utf-8");
+            const data = JSON.parse(raw);
+            const parsedTool = S.decodeUnknownSync(ParsedTool)(data);
+            if (!this.index.has(key)) {
+                await this.index.add(key, data.id ?? "unknown", data.version ?? "unknown", "unknown");
+            }
+            this.memoryCache.set(key, parsedTool);
+            return parsedTool;
+        }
+        catch (err) {
+            console.debug(`Failed to load cached tool ${key}: ${err}`);
+            return null;
+        }
+    }
+    async saveTool(key, parsedTool, toolId, toolVersion, source, sourceUrl = "") {
+        await mkdir(this.cacheDir, { recursive: true });
+        const path = this.cachePath(key);
+        await writeFile(path, JSON.stringify(parsedTool, null, 2));
+        await this.index.add(key, toolId, toolVersion, source, sourceUrl);
+        this.memoryCache.set(key, parsedTool);
+    }
+    listCached() {
+        return this.index.listAll();
+    }
+    async clearCache(toolIdPrefix) {
+        if (toolIdPrefix === undefined) {
+            for (const entry of this.index.listAll()) {
+                const path = this.cachePath(entry.cache_key);
+                if (existsSync(path))
+                    await unlink(path);
+            }
+            await this.index.clear();
+            this.memoryCache.clear();
+        }
+        else {
+            const prefix = toolIdPrefix.replace(/\*$/, "");
+            const toRemove = this.index.listAll().filter((e) => e.tool_id.startsWith(prefix));
+            for (const entry of toRemove) {
+                const path = this.cachePath(entry.cache_key);
+                if (existsSync(path))
+                    await unlink(path);
+                await this.index.remove(entry.cache_key);
+                this.memoryCache.delete(entry.cache_key);
+            }
+        }
+    }
+}
+//# sourceMappingURL=tool-cache.js.map

package/dist/cache/tool-cache.js.map

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

package/dist/cache/tool-id.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Parse and manipulate Galaxy toolshed tool IDs.
+ *
+ * Input format: toolshed.g2.bx.psu.edu/repos/owner/repo/tool_name/version
+ * Or with scheme: https://toolshed.g2.bx.psu.edu/repos/owner/repo/tool_name/version
+ */
+/** Parsed components of a ToolShed tool ID. */
+export interface ToolCoordinates {
+    /** ToolShed base URL (with https:// scheme). */
+    toolshedUrl: string;
+    /** TRS-style tool ID: `owner~repo~tool_name`. */
+    trsToolId: string;
+    /** Tool version, or null if not present in the ID. */
+    toolVersion: string | null;
+}
+/**
+ * Parse a full ToolShed tool ID into its components.
+ * Accepts both scheme-prefixed and bare formats:
+ * - `toolshed.g2.bx.psu.edu/repos/owner/repo/tool_name/version`
+ * - `https://toolshed.g2.bx.psu.edu/repos/owner/repo/tool_name/version`
+ * @returns Parsed coordinates, or null if the ID doesn't match the ToolShed format.
+ */
+export declare function parseToolshedToolId(toolId: string): ToolCoordinates | null;
+/** Reconstruct a human-readable tool ID from a ToolShed URL and TRS tool ID. */
+export declare function toolIdFromTrs(toolshedUrl: string, trsToolId: string): string;
+//# sourceMappingURL=tool-id.d.ts.map

package/dist/cache/tool-id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-id.d.ts","sourceRoot":"","sources":["../../src/cache/tool-id.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,+CAA+C;AAC/C,MAAM,WAAW,eAAe;IAC9B,gDAAgD;IAChD,WAAW,EAAE,MAAM,CAAC;IACpB,iDAAiD;IACjD,SAAS,EAAE,MAAM,CAAC;IAClB,sDAAsD;IACtD,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAa1E;AAED,gFAAgF;AAChF,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAI5E"}

package/dist/cache/tool-id.js

@@ -0,0 +1,34 @@
+/**
+ * Parse and manipulate Galaxy toolshed tool IDs.
+ *
+ * Input format: toolshed.g2.bx.psu.edu/repos/owner/repo/tool_name/version
+ * Or with scheme: https://toolshed.g2.bx.psu.edu/repos/owner/repo/tool_name/version
+ */
+/**
+ * Parse a full ToolShed tool ID into its components.
+ * Accepts both scheme-prefixed and bare formats:
+ * - `toolshed.g2.bx.psu.edu/repos/owner/repo/tool_name/version`
+ * - `https://toolshed.g2.bx.psu.edu/repos/owner/repo/tool_name/version`
+ * @returns Parsed coordinates, or null if the ID doesn't match the ToolShed format.
+ */
+export function parseToolshedToolId(toolId) {
+    if (!toolId.includes("/repos/")) {
+        return null;
+    }
+    const [toolshedBase, rest] = toolId.split("/repos/", 2);
+    const segments = rest.split("/");
+    if (segments.length < 3) {
+        return null;
+    }
+    const trsToolId = `${segments[0]}~${segments[1]}~${segments[2]}`;
+    const toolVersion = segments.length > 3 ? segments[3] : null;
+    const toolshedUrl = toolshedBase.startsWith("http") ? toolshedBase : `https://${toolshedBase}`;
+    return { toolshedUrl, trsToolId, toolVersion };
+}
+/** Reconstruct a human-readable tool ID from a ToolShed URL and TRS tool ID. */
+export function toolIdFromTrs(toolshedUrl, trsToolId) {
+    const parts = trsToolId.split("~");
+    const base = toolshedUrl.replace("https://", "").replace("http://", "");
+    return `${base}/repos/${parts.join("/")}`;
+}
+//# sourceMappingURL=tool-id.js.map

package/dist/cache/tool-id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-id.js","sourceRoot":"","sources":["../../src/cache/tool-id.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAYH;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAc;IAChD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QAChC,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,CAAC,YAAY,EAAE,IAAI,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;IACxD,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACjC,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,SAAS,GAAG,GAAG,QAAQ,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;IACjE,MAAM,WAAW,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC7D,MAAM,WAAW,GAAG,YAAY,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,WAAW,YAAY,EAAE,CAAC;IAC/F,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,WAAW,EAAE,CAAC;AACjD,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,aAAa,CAAC,WAAmB,EAAE,SAAiB;IAClE,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACnC,MAAM,IAAI,GAAG,WAAW,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;IACxE,OAAO,GAAG,IAAI,UAAU,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;AAC5C,CAAC"}

package/dist/client/index.d.ts

@@ -0,0 +1,2 @@
+export { fetchFromToolShed, fetchFromGalaxy, ToolFetchError } 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,EAAE,iBAAiB,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC"}

package/dist/client/index.js

@@ -0,0 +1,2 @@
+export { fetchFromToolShed, fetchFromGalaxy, ToolFetchError } 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,EAAE,iBAAiB,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC"}

package/dist/client/toolshed.d.ts

@@ -0,0 +1,31 @@
+import { ParsedTool } from "../models/parsed-tool.js";
+/** Error thrown when fetching a tool from a remote source fails. */
+export declare class ToolFetchError extends Error {
+    /** The URL that was requested. */
+    readonly url: string;
+    /** HTTP status code, if the request reached the server. */
+    readonly statusCode?: number | undefined;
+    readonly _tag = "ToolFetchError";
+    constructor(message: string, 
+    /** The URL that was requested. */
+    url: string, 
+    /** HTTP status code, if the request reached the server. */
+    statusCode?: number | undefined);
+}
+/**
+ * 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`)
+ * @param trsToolId - TRS-style tool ID (e.g. `owner~repo~tool_name`)
+ * @param toolVersion - Exact tool version string
+ * @param fetcher - Custom fetch implementation (defaults to globalThis.fetch)
+ */
+export declare function fetchFromToolShed(toolshedUrl: string, trsToolId: string, toolVersion: string, fetcher?: typeof fetch): Promise<ParsedTool>;
+/**
+ * Fetch parsed tool metadata from a Galaxy instance via its API.
+ * @param galaxyUrl - Base URL of the Galaxy instance (e.g. `https://usegalaxy.org`)
+ * @param toolId - Full tool ID (e.g. `toolshed.g2.bx.psu.edu/repos/devteam/fastqc/fastqc`)
+ * @param toolVersion - Tool version (optional, fetches latest if omitted)
+ * @param fetcher - Custom fetch implementation (defaults to globalThis.fetch)
+ */
+export declare function fetchFromGalaxy(galaxyUrl: string, toolId: string, toolVersion?: string | null, fetcher?: typeof fetch): Promise<ParsedTool>;
+//# 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":"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"}

package/dist/client/toolshed.js

@@ -0,0 +1,60 @@
+import * as S from "effect/Schema";
+import { ParsedTool } from "../models/parsed-tool.js";
+/** Error thrown when fetching a tool from a remote source fails. */
+export class ToolFetchError extends Error {
+    url;
+    statusCode;
+    _tag = "ToolFetchError";
+    constructor(message, 
+    /** The URL that was requested. */
+    url, 
+    /** HTTP status code, if the request reached the server. */
+    statusCode) {
+        super(message);
+        this.url = url;
+        this.statusCode = statusCode;
+    }
+}
+/**
+ * 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`)
+ * @param trsToolId - TRS-style tool ID (e.g. `owner~repo~tool_name`)
+ * @param toolVersion - Exact tool version string
+ * @param fetcher - Custom fetch implementation (defaults to globalThis.fetch)
+ */
+export async function fetchFromToolShed(toolshedUrl, trsToolId, toolVersion, fetcher = globalThis.fetch) {
+    const url = `${toolshedUrl}/api/tools/${trsToolId}/versions/${toolVersion}`;
+    const response = await fetcher(url, {
+        headers: { Accept: "application/json" },
+        signal: AbortSignal.timeout(30_000),
+    });
+    if (!response.ok) {
+        const body = await response.text().catch(() => "");
+        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);
+}
+/**
+ * Fetch parsed tool metadata from a Galaxy instance via its API.
+ * @param galaxyUrl - Base URL of the Galaxy instance (e.g. `https://usegalaxy.org`)
+ * @param toolId - Full tool ID (e.g. `toolshed.g2.bx.psu.edu/repos/devteam/fastqc/fastqc`)
+ * @param toolVersion - Tool version (optional, fetches latest if omitted)
+ * @param fetcher - Custom fetch implementation (defaults to globalThis.fetch)
+ */
+export async function fetchFromGalaxy(galaxyUrl, toolId, toolVersion, fetcher = globalThis.fetch) {
+    const encodedId = encodeURIComponent(toolId);
+    const params = toolVersion ? `?tool_version=${encodeURIComponent(toolVersion)}` : "";
+    const url = `${galaxyUrl}/api/tools/${encodedId}/parsed${params}`;
+    const response = await fetcher(url, {
+        headers: { Accept: "application/json" },
+        signal: AbortSignal.timeout(30_000),
+    });
+    if (!response.ok) {
+        const body = await response.text().catch(() => "");
+        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);
+}
+//# 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":"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"}

package/dist/index.d.ts

@@ -0,0 +1,28 @@
+/**
+ * @module @galaxy-tool-util/core
+ *
+ * Galaxy tool cache, ToolShed/Galaxy API client, and ParsedTool model.
+ * Handles fetching tool metadata from remote sources and caching locally.
+ */
+/** Effect Schema for parsed tool metadata (id, version, name, inputs, outputs, etc.). */
+export { ParsedTool, HelpContent, XrefDict, Citation } from "./models/parsed-tool.js";
+export { 
+/** Parse a full ToolShed tool ID into ToolCoordinates (toolshedUrl, trsToolId, version). */
+parseToolshedToolId, 
+/** Reconstruct a full tool ID from ToolShed URL and TRS tool ID. */
+toolIdFromTrs, 
+/** Compute a deterministic SHA-256 cache key from ToolShed URL + TRS ID + version. */
+cacheKey, 
+/** Cache metadata index — tracks tool IDs, versions, sources, and timestamps. */
+CacheIndex, 
+/** Two-layer cache (memory + filesystem) for parsed tool metadata. */
+ToolCache, 
+/** Resolve cache directory from explicit override, env var, or default. */
+getCacheDir, DEFAULT_CACHE_DIR, CACHE_DIR_ENV_VAR, DEFAULT_TOOLSHED_URL, TOOLSHED_URL_ENV_VAR, } from "./cache/index.js";
+export type { ToolCoordinates, CacheIndexEntry, CacheIndexData } from "./cache/index.js";
+/** Fetch parsed tool metadata from a ToolShed instance via TRS API. */
+export { fetchFromToolShed, fetchFromGalaxy, ToolFetchError } 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";
+//# 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;;;;;GAKG;AAEH,yFAAyF;AACzF,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACtF,OAAO;AACL,4FAA4F;AAC5F,mBAAmB;AACnB,oEAAoE;AACpE,aAAa;AACb,sFAAsF;AACtF,QAAQ;AACR,iFAAiF;AACjF,UAAU;AACV,sEAAsE;AACtE,SAAS;AACT,2EAA2E;AAC3E,WAAW,EACX,iBAAiB,EACjB,iBAAiB,EACjB,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACzF,uEAAuE;AACvE,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACvF,oFAAoF;AACpF,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,YAAY,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -0,0 +1,26 @@
+/**
+ * @module @galaxy-tool-util/core
+ *
+ * Galaxy tool cache, ToolShed/Galaxy API client, and ParsedTool model.
+ * Handles fetching tool metadata from remote sources and caching locally.
+ */
+/** Effect Schema for parsed tool metadata (id, version, name, inputs, outputs, etc.). */
+export { ParsedTool, HelpContent, XrefDict, Citation } from "./models/parsed-tool.js";
+export { 
+/** Parse a full ToolShed tool ID into ToolCoordinates (toolshedUrl, trsToolId, version). */
+parseToolshedToolId, 
+/** Reconstruct a full tool ID from ToolShed URL and TRS tool ID. */
+toolIdFromTrs, 
+/** Compute a deterministic SHA-256 cache key from ToolShed URL + TRS ID + version. */
+cacheKey, 
+/** Cache metadata index — tracks tool IDs, versions, sources, and timestamps. */
+CacheIndex, 
+/** Two-layer cache (memory + filesystem) for parsed tool metadata. */
+ToolCache, 
+/** Resolve cache directory from explicit override, env var, or default. */
+getCacheDir, DEFAULT_CACHE_DIR, CACHE_DIR_ENV_VAR, DEFAULT_TOOLSHED_URL, TOOLSHED_URL_ENV_VAR, } from "./cache/index.js";
+/** Fetch parsed tool metadata from a ToolShed instance via TRS API. */
+export { fetchFromToolShed, fetchFromGalaxy, ToolFetchError } from "./client/index.js";
+/** High-level service: fetch tools from multiple sources with automatic caching. */
+export { ToolInfoService } from "./tool-info.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;;;;;GAKG;AAEH,yFAAyF;AACzF,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACtF,OAAO;AACL,4FAA4F;AAC5F,mBAAmB;AACnB,oEAAoE;AACpE,aAAa;AACb,sFAAsF;AACtF,QAAQ;AACR,iFAAiF;AACjF,UAAU;AACV,sEAAsE;AACtE,SAAS;AACT,2EAA2E;AAC3E,WAAW,EACX,iBAAiB,EACjB,iBAAiB,EACjB,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,kBAAkB,CAAC;AAE1B,uEAAuE;AACvE,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACvF,oFAAoF;AACpF,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/models/parsed-tool.d.ts

@@ -0,0 +1,46 @@
+import * as S from "effect/Schema";
+/** Tool help content with format (rst, markdown, etc.) and rendered content. */
+export declare const HelpContent: S.Struct<{
+    format: typeof S.String;
+    content: typeof S.String;
+}>;
+/** External reference (e.g. bio.tools ID, bioconductor package). */
+export declare const XrefDict: S.Struct<{
+    value: typeof S.String;
+    type: typeof S.String;
+}>;
+/** Tool citation entry (bibtex, doi, etc.). */
+export declare const Citation: S.Struct<{
+    type: typeof S.String;
+    content: typeof S.String;
+}>;
+/**
+ * Effect Schema for parsed Galaxy tool metadata as returned by the ToolShed TRS API
+ * or Galaxy's /api/tools/:id/parsed endpoint.
+ */
+export declare const ParsedTool: S.Struct<{
+    id: typeof S.String;
+    version: S.NullOr<typeof S.String>;
+    name: typeof S.String;
+    description: S.transform<S.NullOr<typeof S.String>, S.NullOr<typeof S.String>>;
+    inputs: S.Array$<typeof S.Unknown>;
+    outputs: S.Array$<typeof S.Unknown>;
+    citations: S.Array$<S.Struct<{
+        type: typeof S.String;
+        content: typeof S.String;
+    }>>;
+    license: S.NullOr<typeof S.String>;
+    profile: S.NullOr<typeof S.String>;
+    edam_operations: S.Array$<typeof S.String>;
+    edam_topics: S.Array$<typeof S.String>;
+    xrefs: S.Array$<S.Struct<{
+        value: typeof S.String;
+        type: typeof S.String;
+    }>>;
+    help: S.optional<S.Union<[S.Struct<{
+        format: typeof S.String;
+        content: typeof S.String;
+    }>, typeof S.Null]>>;
+}>;
+export type ParsedTool = S.Schema.Type<typeof ParsedTool>;
+//# sourceMappingURL=parsed-tool.d.ts.map

package/dist/models/parsed-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parsed-tool.d.ts","sourceRoot":"","sources":["../../src/models/parsed-tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,eAAe,CAAC;AAEnC,gFAAgF;AAChF,eAAO,MAAM,WAAW;;;EAGtB,CAAC;AAEH,oEAAoE;AACpE,eAAO,MAAM,QAAQ;;;EAGnB,CAAC;AAEH,+CAA+C;AAC/C,eAAO,MAAM,QAAQ;;;EAGnB,CAAC;AAQH;;;GAGG;AACH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;EAcrB,CAAC;AAEH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,UAAU,CAAC,CAAC"}

package/dist/models/parsed-tool.js

@@ -0,0 +1,41 @@
+import * as S from "effect/Schema";
+/** Tool help content with format (rst, markdown, etc.) and rendered content. */
+export const HelpContent = S.Struct({
+    format: S.String,
+    content: S.String,
+});
+/** External reference (e.g. bio.tools ID, bioconductor package). */
+export const XrefDict = S.Struct({
+    value: S.String,
+    type: S.String,
+});
+/** Tool citation entry (bibtex, doi, etc.). */
+export const Citation = S.Struct({
+    type: S.String,
+    content: S.String,
+});
+/** Normalize empty string to null for description field. */
+const NullableDescription = S.transform(S.NullOr(S.String), S.NullOr(S.String), {
+    decode: (val) => (val === "" ? null : val),
+    encode: (val) => val,
+});
+/**
+ * Effect Schema for parsed Galaxy tool metadata as returned by the ToolShed TRS API
+ * or Galaxy's /api/tools/:id/parsed endpoint.
+ */
+export const ParsedTool = S.Struct({
+    id: S.String,
+    version: S.NullOr(S.String),
+    name: S.String,
+    description: NullableDescription,
+    inputs: S.Array(S.Unknown),
+    outputs: S.Array(S.Unknown),
+    citations: S.Array(Citation),
+    license: S.NullOr(S.String),
+    profile: S.NullOr(S.String),
+    edam_operations: S.Array(S.String),
+    edam_topics: S.Array(S.String),
+    xrefs: S.Array(XrefDict),
+    help: S.optional(S.Union(HelpContent, S.Null)),
+});
+//# sourceMappingURL=parsed-tool.js.map

package/dist/models/parsed-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parsed-tool.js","sourceRoot":"","sources":["../../src/models/parsed-tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,eAAe,CAAC;AAEnC,gFAAgF;AAChF,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC;IAClC,MAAM,EAAE,CAAC,CAAC,MAAM;IAChB,OAAO,EAAE,CAAC,CAAC,MAAM;CAClB,CAAC,CAAC;AAEH,oEAAoE;AACpE,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/B,KAAK,EAAE,CAAC,CAAC,MAAM;IACf,IAAI,EAAE,CAAC,CAAC,MAAM;CACf,CAAC,CAAC;AAEH,+CAA+C;AAC/C,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/B,IAAI,EAAE,CAAC,CAAC,MAAM;IACd,OAAO,EAAE,CAAC,CAAC,MAAM;CAClB,CAAC,CAAC;AAEH,4DAA4D;AAC5D,MAAM,mBAAmB,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE;IAC9E,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC;IAC1C,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG;CACrB,CAAC,CAAC;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC;IACjC,EAAE,EAAE,CAAC,CAAC,MAAM;IACZ,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC;IAC3B,IAAI,EAAE,CAAC,CAAC,MAAM;IACd,WAAW,EAAE,mBAAmB;IAChC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC;IAC1B,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC;IAC3B,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC;IAC5B,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC;IAC3B,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC;IAC3B,eAAe,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;IAClC,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;IAC9B,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC;IACxB,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;CAC/C,CAAC,CAAC"}

package/dist/tool-info.d.ts

@@ -0,0 +1,30 @@
+import type { ParsedTool } from "./models/parsed-tool.js";
+import { ToolCache } from "./cache/tool-cache.js";
+/** A remote source for fetching tool metadata. */
+export interface ToolSource {
+    type: "toolshed" | "galaxy";
+    url: string;
+}
+/** Options for constructing a {@link ToolInfoService}. */
+export interface ToolInfoOptions {
+    cacheDir?: string;
+    defaultToolshedUrl?: string;
+    /** Multiple sources tried in order. If provided, overrides defaultToolshedUrl/galaxyUrl. */
+    sources?: ToolSource[];
+    /** @deprecated Use sources instead. Kept for simple single-source usage. */
+    galaxyUrl?: string;
+    fetcher?: typeof fetch;
+}
+/**
+ * High-level service for fetching Galaxy tool metadata with automatic caching.
+ * Tries configured sources in order and caches on first successful fetch.
+ */
+export declare class ToolInfoService {
+    readonly cache: ToolCache;
+    private readonly sources;
+    private readonly fetcher;
+    constructor(opts?: ToolInfoOptions);
+    getToolInfo(toolId: string, toolVersion?: string | null): Promise<ParsedTool | null>;
+    addTool(toolId: string, toolVersion: string, parsedTool: ParsedTool, source?: string, sourceUrl?: string): Promise<string>;
+}
+//# sourceMappingURL=tool-info.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tool-info.d.ts","sourceRoot":"","sources":["../src/tool-info.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAIlD,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,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,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,CAAC,EAAE,eAAe;IAuB5B,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAqDpF,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"}

package/dist/tool-info.js

@@ -0,0 +1,78 @@
+import { ToolCache } from "./cache/tool-cache.js";
+import { cacheKey } from "./cache/cache-key.js";
+import { fetchFromToolShed, fetchFromGalaxy } from "./client/toolshed.js";
+/**
+ * High-level service for fetching Galaxy tool metadata with automatic caching.
+ * Tries configured sources in order and caches on first successful fetch.
+ */
+export class ToolInfoService {
+    cache;
+    sources;
+    fetcher;
+    constructor(opts) {
+        this.cache = new ToolCache({
+            cacheDir: opts?.cacheDir,
+            defaultToolshedUrl: opts?.defaultToolshedUrl,
+        });
+        this.fetcher = opts?.fetcher ?? globalThis.fetch;
+        if (opts?.sources && opts.sources.length > 0) {
+            this.sources = opts.sources;
+        }
+        else {
+            // Build sources from legacy options
+            this.sources = [
+                {
+                    type: "toolshed",
+                    url: opts?.defaultToolshedUrl ?? this.cache.defaultToolshedUrl,
+                },
+            ];
+            if (opts?.galaxyUrl) {
+                this.sources.push({ type: "galaxy", url: opts.galaxyUrl });
+            }
+        }
+    }
+    async getToolInfo(toolId, toolVersion) {
+        const coords = this.cache.resolveToolCoordinates(toolId, toolVersion);
+        if (coords.version === null) {
+            throw new Error(`No version available for tool: ${toolId}`);
+        }
+        const key = cacheKey(coords.toolshedUrl, coords.trsToolId, coords.version);
+        // Check filesystem cache (ToolCache checks memory first internally)
+        const cached = await this.cache.loadCached(key);
+        if (cached !== null)
+            return cached;
+        // Try each source in order
+        for (const source of this.sources) {
+            try {
+                let parsedTool;
+                let sourceLabel;
+                let sourceUrl;
+                if (source.type === "toolshed") {
+                    parsedTool = await fetchFromToolShed(source.url, coords.trsToolId, coords.version, this.fetcher);
+                    sourceLabel = "api";
+                    sourceUrl = `${source.url}/api/tools/${coords.trsToolId}/versions/${coords.version}`;
+                }
+                else {
+                    parsedTool = await fetchFromGalaxy(source.url, toolId, toolVersion, this.fetcher);
+                    sourceLabel = "galaxy";
+                    sourceUrl = `${source.url}/api/tools/${encodeURIComponent(toolId)}/parsed`;
+                }
+                await this.cache.saveTool(key, parsedTool, coords.readableId, coords.version, sourceLabel, sourceUrl);
+                return parsedTool;
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                console.debug(`${source.type} fetch failed (${source.url}) for ${coords.trsToolId}: ${msg}`);
+            }
+        }
+        return null;
+    }
+    async addTool(toolId, toolVersion, parsedTool, source = "local", sourceUrl = "") {
+        const coords = this.cache.resolveToolCoordinates(toolId, toolVersion);
+        const version = coords.version ?? toolVersion;
+        const key = cacheKey(coords.toolshedUrl, coords.trsToolId, version);
+        await this.cache.saveTool(key, parsedTool, coords.readableId, version, source, sourceUrl);
+        return key;
+    }
+}
+//# sourceMappingURL=tool-info.js.map

package/dist/tool-info.js.map

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

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@galaxy-tool-util/core",
+  "version": "0.1.0",
+  "description": "Galaxy tool cache, ToolShed client, and ParsedTool models",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": ["dist", "README.md", "LICENSE"],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/jmchilton/galaxy-tool-util-ts",
+    "directory": "packages/core"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "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'"
+  },
+  "license": "MIT",
+  "devDependencies": {
+    "@types/node": "^25.5.0",
+    "yaml": "^2.8.3"
+  },
+  "dependencies": {
+    "effect": "^3.21.0"
+  }
+}