mthds 0.0.6 → 0.0.8

package/dist/package/semver.js

@@ -0,0 +1,77 @@
+import semver from "semver";
+export class SemVerError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "SemVerError";
+    }
+}
+/**
+ * Parse a version string into a semver SemVer object.
+ * Strips a leading 'v' prefix if present (common in git tags like v1.2.3).
+ */
+export function parseVersion(versionStr) {
+    const cleaned = versionStr.startsWith("v") ? versionStr.slice(1) : versionStr;
+    const parsed = semver.parse(cleaned);
+    if (parsed === null) {
+        throw new SemVerError(`Invalid semver version: '${versionStr}'`);
+    }
+    return parsed;
+}
+/**
+ * Parse a constraint string into a semver Range.
+ * Supports: "^1.0.0", "~1.0.0", ">=1.0.0 <2.0.0", "*", "1.*", etc.
+ */
+export function parseConstraint(constraintStr) {
+    try {
+        const range = new semver.Range(constraintStr);
+        return range;
+    }
+    catch {
+        throw new SemVerError(`Invalid semver constraint: '${constraintStr}'`);
+    }
+}
+/**
+ * Check whether a version satisfies a constraint.
+ */
+export function versionSatisfies(version, constraint) {
+    return semver.satisfies(version, constraint);
+}
+/**
+ * Select the minimum version that satisfies a constraint (MVS).
+ * Sorts versions ascending and returns the first match.
+ */
+export function selectMinimumVersion(availableVersions, constraint) {
+    const sorted = [...availableVersions].sort(semver.compare);
+    for (const version of sorted) {
+        if (semver.satisfies(version, constraint)) {
+            return version;
+        }
+    }
+    return null;
+}
+/**
+ * Select the minimum version that satisfies ALL constraints simultaneously.
+ * Used for diamond dependency resolution.
+ */
+export function selectMinimumVersionForMultipleConstraints(availableVersions, constraints) {
+    const sorted = [...availableVersions].sort(semver.compare);
+    for (const version of sorted) {
+        if (constraints.every((constraint) => semver.satisfies(version, constraint))) {
+            return version;
+        }
+    }
+    return null;
+}
+/**
+ * Parse a git tag into a SemVer, returning null if not a valid semver tag.
+ * Handles tags like "v1.2.3" and "1.2.3", gracefully ignores non-semver tags.
+ */
+export function parseVersionTag(tag) {
+    try {
+        return parseVersion(tag);
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=semver.js.map

package/dist/package/semver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"semver.js","sourceRoot":"","sources":["../../src/package/semver.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,QAAQ,CAAC;AAE5B,MAAM,OAAO,WAAY,SAAQ,KAAK;IACpC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;IAC5B,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,UAAkB;IAC7C,MAAM,OAAO,GAAG,UAAU,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC;IAC9E,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACrC,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;QACpB,MAAM,IAAI,WAAW,CAAC,4BAA4B,UAAU,GAAG,CAAC,CAAC;IACnE,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,aAAqB;IACnD,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;QAC9C,OAAO,KAAK,CAAC;IACf,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,WAAW,CAAC,+BAA+B,aAAa,GAAG,CAAC,CAAC;IACzE,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAsB,EAAE,UAAwB;IAC/E,OAAO,MAAM,CAAC,SAAS,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;AAC/C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAClC,iBAAkC,EAClC,UAAwB;IAExB,MAAM,MAAM,GAAG,CAAC,GAAG,iBAAiB,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC3D,KAAK,MAAM,OAAO,IAAI,MAAM,EAAE,CAAC;QAC7B,IAAI,MAAM,CAAC,SAAS,CAAC,OAAO,EAAE,UAAU,CAAC,EAAE,CAAC;YAC1C,OAAO,OAAO,CAAC;QACjB,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,0CAA0C,CACxD,iBAAkC,EAClC,WAA2B;IAE3B,MAAM,MAAM,GAAG,CAAC,GAAG,iBAAiB,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC3D,KAAK,MAAM,OAAO,IAAI,MAAM,EAAE,CAAC;QAC7B,IAAI,WAAW,CAAC,KAAK,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC,EAAE,CAAC;YAC7E,OAAO,OAAO,CAAC;QACjB,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,GAAW;IACzC,IAAI,CAAC;QACH,OAAO,YAAY,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/package/vcs-resolver.d.ts

@@ -0,0 +1,19 @@
+import type { SemVer } from "semver";
+/**
+ * Map a package address to a git clone URL.
+ * Prepends https:// and appends .git (unless already present).
+ */
+export declare function addressToCloneUrl(address: string): string;
+/**
+ * List remote git tags that are valid semver versions.
+ * Runs `git ls-remote --tags <url>` and parses the output.
+ */
+export declare function listRemoteVersionTags(cloneUrl: string): Promise<Array<[SemVer, string]>>;
+/**
+ * Select the minimum version matching a constraint from a list of tags (MVS).
+ */
+export declare function resolveVersionFromTags(versionTags: Array<[SemVer, string]>, versionConstraint: string): [SemVer, string];
+/**
+ * Clone a git repository at a specific tag with depth 1.
+ */
+export declare function cloneAtVersion(cloneUrl: string, versionTag: string, destination: string): Promise<void>;

package/dist/package/vcs-resolver.js

@@ -0,0 +1,115 @@
+import { execFile } from "node:child_process";
+import { VCSFetchError, VersionResolutionError } from "./exceptions.js";
+import { parseConstraint, parseVersionTag, selectMinimumVersion, SemVerError } from "./semver.js";
+/**
+ * Map a package address to a git clone URL.
+ * Prepends https:// and appends .git (unless already present).
+ */
+export function addressToCloneUrl(address) {
+    let url = `https://${address}`;
+    if (!url.endsWith(".git")) {
+        url = `${url}.git`;
+    }
+    return url;
+}
+function execGit(args, timeoutMs) {
+    return new Promise((resolve, reject) => {
+        execFile("git", args, { timeout: timeoutMs }, (error, stdout, stderr) => {
+            if (error) {
+                if (error.code === "ENOENT") {
+                    reject(new VCSFetchError("git is not installed or not found on PATH"));
+                    return;
+                }
+                if (error.killed) {
+                    reject(new VCSFetchError(`Timed out running: git ${args.join(" ")}`));
+                    return;
+                }
+                reject(new VCSFetchError(`git ${args[0]} failed: ${stderr.trim()}`));
+                return;
+            }
+            resolve(stdout);
+        });
+    });
+}
+/**
+ * List remote git tags that are valid semver versions.
+ * Runs `git ls-remote --tags <url>` and parses the output.
+ */
+export async function listRemoteVersionTags(cloneUrl) {
+    let stdout;
+    try {
+        stdout = await execGit(["ls-remote", "--tags", cloneUrl], 60_000);
+    }
+    catch (err) {
+        if (err instanceof VCSFetchError)
+            throw err;
+        throw new VCSFetchError(`Failed to list remote tags from '${cloneUrl}': ${err.message}`);
+    }
+    const versionTags = [];
+    for (const line of stdout.trim().split("\n")) {
+        if (!line.trim())
+            continue;
+        const parts = line.split("\t");
+        if (parts.length < 2)
+            continue;
+        const ref = parts[1];
+        // Skip dereferenced tags
+        if (ref.endsWith("^{}"))
+            continue;
+        // Extract tag name from refs/tags/...
+        const tagName = ref.startsWith("refs/tags/") ? ref.slice("refs/tags/".length) : ref;
+        const version = parseVersionTag(tagName);
+        if (version !== null) {
+            versionTags.push([version, tagName]);
+        }
+    }
+    return versionTags;
+}
+/**
+ * Select the minimum version matching a constraint from a list of tags (MVS).
+ */
+export function resolveVersionFromTags(versionTags, versionConstraint) {
+    if (versionTags.length === 0) {
+        throw new VersionResolutionError(`No version tags available to satisfy constraint '${versionConstraint}'`);
+    }
+    let constraint;
+    try {
+        constraint = parseConstraint(versionConstraint);
+    }
+    catch (err) {
+        if (err instanceof SemVerError) {
+            throw new VersionResolutionError(`Invalid version constraint '${versionConstraint}': ${err.message}`);
+        }
+        throw err;
+    }
+    const versions = versionTags.map((entry) => entry[0]);
+    const selected = selectMinimumVersion(versions, constraint);
+    if (selected === null) {
+        const availableStr = versionTags
+            .map((entry) => entry[0])
+            .sort((a, b) => a.compare(b))
+            .map((ver) => ver.version)
+            .join(", ");
+        throw new VersionResolutionError(`No version satisfying '${versionConstraint}' found among: ${availableStr}`);
+    }
+    for (const [ver, tagName] of versionTags) {
+        if (ver.compare(selected) === 0) {
+            return [selected, tagName];
+        }
+    }
+    throw new VersionResolutionError(`Internal error: selected version ${selected.version} not found in tag list`);
+}
+/**
+ * Clone a git repository at a specific tag with depth 1.
+ */
+export async function cloneAtVersion(cloneUrl, versionTag, destination) {
+    try {
+        await execGit(["clone", "--depth", "1", "--branch", versionTag, cloneUrl, destination], 120_000);
+    }
+    catch (err) {
+        if (err instanceof VCSFetchError)
+            throw err;
+        throw new VCSFetchError(`Failed to clone '${cloneUrl}' at tag '${versionTag}': ${err.message}`);
+    }
+}
+//# sourceMappingURL=vcs-resolver.js.map

package/dist/package/vcs-resolver.js.map

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

package/dist/package/visibility.d.ts

@@ -0,0 +1,25 @@
+import type { BundleMetadata } from "./bundle-metadata.js";
+import type { ParsedManifest } from "./manifest/schema.js";
+import { parsePipeRef } from "./qualified-ref.js";
+export interface VisibilityError {
+    readonly pipeRef: string;
+    readonly sourceDomain: string;
+    readonly targetDomain: string;
+    readonly context: string;
+    readonly message: string;
+}
+export declare class PackageVisibilityChecker {
+    private readonly manifest;
+    private readonly bundleMetadatas;
+    private readonly exportedPipes;
+    private readonly mainPipes;
+    constructor(manifest: ParsedManifest | null, bundleMetadatas: BundleMetadata[]);
+    isPipeAccessibleFrom(pipeRef: ReturnType<typeof parsePipeRef>, sourceDomain: string): boolean;
+    validateAllPipeReferences(): VisibilityError[];
+    validateCrossPackageReferences(): VisibilityError[];
+    validateReservedDomains(): VisibilityError[];
+}
+/**
+ * Convenience function: check visibility for a set of bundle metadatas.
+ */
+export declare function checkVisibility(manifest: ParsedManifest | null, bundleMetadatas: BundleMetadata[]): VisibilityError[];

package/dist/package/visibility.js

@@ -0,0 +1,132 @@
+import { RESERVED_DOMAINS, isReservedDomainPath } from "./manifest/schema.js";
+import { parsePipeRef, hasCrossPackagePrefix, splitCrossPackageRef, isLocalTo } from "./qualified-ref.js";
+import { QualifiedRefError } from "./exceptions.js";
+export class PackageVisibilityChecker {
+    manifest;
+    bundleMetadatas;
+    exportedPipes;
+    mainPipes;
+    constructor(manifest, bundleMetadatas) {
+        this.manifest = manifest;
+        this.bundleMetadatas = bundleMetadatas;
+        // Build lookup: exported_pipes[domain_path] = set of pipe codes
+        this.exportedPipes = new Map();
+        if (manifest) {
+            for (const [domainPath, domainExport] of Object.entries(manifest.exports)) {
+                this.exportedPipes.set(domainPath, new Set(domainExport.pipes));
+            }
+        }
+        // Build lookup: main_pipes[domain_path] = main_pipe code (auto-exported)
+        this.mainPipes = new Map();
+        for (const metadata of bundleMetadatas) {
+            if (metadata.mainPipe) {
+                const existing = this.mainPipes.get(metadata.domain);
+                if (!existing || existing === metadata.mainPipe) {
+                    this.mainPipes.set(metadata.domain, metadata.mainPipe);
+                }
+                // Conflicting main_pipe: keep first
+            }
+        }
+    }
+    isPipeAccessibleFrom(pipeRef, sourceDomain) {
+        // No manifest -> all pipes public
+        if (this.manifest === null)
+            return true;
+        // Bare ref -> always allowed
+        if (pipeRef.domainPath === null)
+            return true;
+        // Same-domain ref -> always allowed
+        if (isLocalTo(pipeRef, sourceDomain))
+            return true;
+        const targetDomain = pipeRef.domainPath;
+        const pipeCode = pipeRef.localCode;
+        // Check exports
+        const exported = this.exportedPipes.get(targetDomain) ?? new Set();
+        if (exported.has(pipeCode))
+            return true;
+        // Check main_pipe (auto-exported)
+        const mainPipe = this.mainPipes.get(targetDomain);
+        return Boolean(mainPipe && pipeCode === mainPipe);
+    }
+    validateAllPipeReferences() {
+        if (this.manifest === null)
+            return [];
+        const errors = [];
+        for (const metadata of this.bundleMetadatas) {
+            for (const [pipeRefStr, context] of metadata.pipeReferences) {
+                let ref;
+                try {
+                    ref = parsePipeRef(pipeRefStr);
+                }
+                catch (err) {
+                    if (err instanceof QualifiedRefError)
+                        continue;
+                    throw err;
+                }
+                if (!this.isPipeAccessibleFrom(ref, metadata.domain)) {
+                    const targetDomain = ref.domainPath ?? "";
+                    errors.push({
+                        pipeRef: pipeRefStr,
+                        sourceDomain: metadata.domain,
+                        targetDomain,
+                        context,
+                        message: `Pipe '${pipeRefStr}' referenced in ${context} (domain '${metadata.domain}') ` +
+                            `is not exported by domain '${targetDomain}'. ` +
+                            `Add it to [exports.${targetDomain}] pipes in METHODS.toml.`,
+                    });
+                }
+            }
+        }
+        return errors;
+    }
+    validateCrossPackageReferences() {
+        if (this.manifest === null)
+            return [];
+        const errors = [];
+        for (const metadata of this.bundleMetadatas) {
+            for (const [pipeRefStr, context] of metadata.pipeReferences) {
+                if (!hasCrossPackagePrefix(pipeRefStr))
+                    continue;
+                const [alias] = splitCrossPackageRef(pipeRefStr);
+                errors.push({
+                    pipeRef: pipeRefStr,
+                    sourceDomain: metadata.domain,
+                    targetDomain: alias,
+                    context,
+                    message: `Cross-package reference '${pipeRefStr}' in ${context} ` +
+                        `(domain '${metadata.domain}'): dependencies are not supported ` +
+                        "in this version of the MTHDS standard.",
+                });
+            }
+        }
+        return errors;
+    }
+    validateReservedDomains() {
+        const errors = [];
+        for (const metadata of this.bundleMetadatas) {
+            if (isReservedDomainPath(metadata.domain)) {
+                const firstSegment = metadata.domain.split(".")[0];
+                errors.push({
+                    pipeRef: "",
+                    sourceDomain: metadata.domain,
+                    targetDomain: firstSegment,
+                    context: "bundle domain declaration",
+                    message: `Bundle domain '${metadata.domain}' uses reserved domain '${firstSegment}'. ` +
+                        `Reserved domains (${[...RESERVED_DOMAINS].sort().join(", ")}) cannot be used in user packages.`,
+                });
+            }
+        }
+        return errors;
+    }
+}
+/**
+ * Convenience function: check visibility for a set of bundle metadatas.
+ */
+export function checkVisibility(manifest, bundleMetadatas) {
+    const checker = new PackageVisibilityChecker(manifest, bundleMetadatas);
+    const errors = checker.validateReservedDomains();
+    errors.push(...checker.validateAllPipeReferences());
+    errors.push(...checker.validateCrossPackageReferences());
+    return errors;
+}
+//# sourceMappingURL=visibility.js.map

package/dist/package/visibility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"visibility.js","sourceRoot":"","sources":["../../src/package/visibility.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC9E,OAAO,EAAE,YAAY,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC1G,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAUpD,MAAM,OAAO,wBAAwB;IAClB,QAAQ,CAAwB;IAChC,eAAe,CAAmB;IAClC,aAAa,CAA2B;IACxC,SAAS,CAAsB;IAEhD,YAAY,QAA+B,EAAE,eAAiC;QAC5E,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,eAAe,GAAG,eAAe,CAAC;QAEvC,gEAAgE;QAChE,IAAI,CAAC,aAAa,GAAG,IAAI,GAAG,EAAE,CAAC;QAC/B,IAAI,QAAQ,EAAE,CAAC;YACb,KAAK,MAAM,CAAC,UAAU,EAAE,YAAY,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC1E,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,UAAU,EAAE,IAAI,GAAG,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC;YAClE,CAAC;QACH,CAAC;QAED,yEAAyE;QACzE,IAAI,CAAC,SAAS,GAAG,IAAI,GAAG,EAAE,CAAC;QAC3B,KAAK,MAAM,QAAQ,IAAI,eAAe,EAAE,CAAC;YACvC,IAAI,QAAQ,CAAC,QAAQ,EAAE,CAAC;gBACtB,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;gBACrD,IAAI,CAAC,QAAQ,IAAI,QAAQ,KAAK,QAAQ,CAAC,QAAQ,EAAE,CAAC;oBAChD,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC;gBACzD,CAAC;gBACD,oCAAoC;YACtC,CAAC;QACH,CAAC;IACH,CAAC;IAED,oBAAoB,CAAC,OAAwC,EAAE,YAAoB;QACjF,kCAAkC;QAClC,IAAI,IAAI,CAAC,QAAQ,KAAK,IAAI;YAAE,OAAO,IAAI,CAAC;QAExC,6BAA6B;QAC7B,IAAI,OAAO,CAAC,UAAU,KAAK,IAAI;YAAE,OAAO,IAAI,CAAC;QAE7C,oCAAoC;QACpC,IAAI,SAAS,CAAC,OAAO,EAAE,YAAY,CAAC;YAAE,OAAO,IAAI,CAAC;QAElD,MAAM,YAAY,GAAG,OAAO,CAAC,UAAU,CAAC;QACxC,MAAM,QAAQ,GAAG,OAAO,CAAC,SAAS,CAAC;QAEnC,gBAAgB;QAChB,MAAM,QAAQ,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,YAAY,CAAC,IAAI,IAAI,GAAG,EAAU,CAAC;QAC3E,IAAI,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC;YAAE,OAAO,IAAI,CAAC;QAExC,kCAAkC;QAClC,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;QAClD,OAAO,OAAO,CAAC,QAAQ,IAAI,QAAQ,KAAK,QAAQ,CAAC,CAAC;IACpD,CAAC;IAED,yBAAyB;QACvB,IAAI,IAAI,CAAC,QAAQ,KAAK,IAAI;YAAE,OAAO,EAAE,CAAC;QAEtC,MAAM,MAAM,GAAsB,EAAE,CAAC;QAErC,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;YAC5C,KAAK,MAAM,CAAC,UAAU,EAAE,OAAO,CAAC,IAAI,QAAQ,CAAC,cAAc,EAAE,CAAC;gBAC5D,IAAI,GAAG,CAAC;gBACR,IAAI,CAAC;oBACH,GAAG,GAAG,YAAY,CAAC,UAAU,CAAC,CAAC;gBACjC,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACb,IAAI,GAAG,YAAY,iBAAiB;wBAAE,SAAS;oBAC/C,MAAM,GAAG,CAAC;gBACZ,CAAC;gBAED,IAAI,CAAC,IAAI,CAAC,oBAAoB,CAAC,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;oBACrD,MAAM,YAAY,GAAG,GAAG,CAAC,UAAU,IAAI,EAAE,CAAC;oBAC1C,MAAM,CAAC,IAAI,CAAC;wBACV,OAAO,EAAE,UAAU;wBACnB,YAAY,EAAE,QAAQ,CAAC,MAAM;wBAC7B,YAAY;wBACZ,OAAO;wBACP,OAAO,EACL,SAAS,UAAU,mBAAmB,OAAO,aAAa,QAAQ,CAAC,MAAM,KAAK;4BAC9E,8BAA8B,YAAY,KAAK;4BAC/C,sBAAsB,YAAY,0BAA0B;qBAC/D,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,8BAA8B;QAC5B,IAAI,IAAI,CAAC,QAAQ,KAAK,IAAI;YAAE,OAAO,EAAE,CAAC;QAEtC,MAAM,MAAM,GAAsB,EAAE,CAAC;QAErC,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;YAC5C,KAAK,MAAM,CAAC,UAAU,EAAE,OAAO,CAAC,IAAI,QAAQ,CAAC,cAAc,EAAE,CAAC;gBAC5D,IAAI,CAAC,qBAAqB,CAAC,UAAU,CAAC;oBAAE,SAAS;gBAEjD,MAAM,CAAC,KAAK,CAAC,GAAG,oBAAoB,CAAC,UAAU,CAAC,CAAC;gBAEjD,MAAM,CAAC,IAAI,CAAC;oBACV,OAAO,EAAE,UAAU;oBACnB,YAAY,EAAE,QAAQ,CAAC,MAAM;oBAC7B,YAAY,EAAE,KAAK;oBACnB,OAAO;oBACP,OAAO,EACL,4BAA4B,UAAU,QAAQ,OAAO,GAAG;wBACxD,YAAY,QAAQ,CAAC,MAAM,qCAAqC;wBAChE,wCAAwC;iBAC3C,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,uBAAuB;QACrB,MAAM,MAAM,GAAsB,EAAE,CAAC;QAErC,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;YAC5C,IAAI,oBAAoB,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC1C,MAAM,YAAY,GAAG,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAE,CAAC;gBACpD,MAAM,CAAC,IAAI,CAAC;oBACV,OAAO,EAAE,EAAE;oBACX,YAAY,EAAE,QAAQ,CAAC,MAAM;oBAC7B,YAAY,EAAE,YAAY;oBAC1B,OAAO,EAAE,2BAA2B;oBACpC,OAAO,EACL,kBAAkB,QAAQ,CAAC,MAAM,2BAA2B,YAAY,KAAK;wBAC7E,qBAAqB,CAAC,GAAG,gBAAgB,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,oCAAoC;iBACnG,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;CACF;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAC7B,QAA+B,EAC/B,eAAiC;IAEjC,MAAM,OAAO,GAAG,IAAI,wBAAwB,CAAC,QAAQ,EAAE,eAAe,CAAC,CAAC;IACxE,MAAM,MAAM,GAAG,OAAO,CAAC,uBAAuB,EAAE,CAAC;IACjD,MAAM,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,yBAAyB,EAAE,CAAC,CAAC;IACpD,MAAM,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,8BAA8B,EAAE,CAAC,CAAC;IACzD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/runners/api-runner.d.ts

@@ -1,4 +1,5 @@
 import type { Runner, RunnerType, BuildInputsRequest, BuildOutputRequest, BuildPipeRequest, BuildPipeResponse, BuildRunnerRequest, BuildRunnerResponse, ExecuteRequest, PipelineResponse, ValidateRequest, ValidateResponse } from "./types.js";
+import type { ExecutePipelineOptions, PipelineExecuteResponse, PipelineStartResponse } from "../client/pipeline.js";
 export declare class ApiRunner implements Runner {
     readonly type: RunnerType;
     private readonly baseUrl;
@@ -15,4 +16,6 @@ export declare class ApiRunner implements Runner {
     buildRunner(request: BuildRunnerRequest): Promise<BuildRunnerResponse>;
     execute(request: ExecuteRequest): Promise<PipelineResponse>;
     validate(request: ValidateRequest): Promise<ValidateResponse>;
+    executePipeline(options: ExecutePipelineOptions): Promise<PipelineExecuteResponse>;
+    startPipeline(options: ExecutePipelineOptions): Promise<PipelineStartResponse>;
 }

package/dist/runners/api-runner.js

@@ -1,6 +1,7 @@
 import { loadConfig } from "../config/config.js";
+import { Runners } from "./types.js";
 export class ApiRunner {
-    type = "api";
+    type = Runners.API;
     baseUrl;
     apiKey;
     constructor(baseUrl, apiKey) {
@@ -62,5 +63,12 @@ export class ApiRunner {
     async validate(request) {
         return this.post("/api/v1/validate", request);
     }
+    // ── RunnerProtocol implementation ─────────────────────────────────
+    async executePipeline(options) {
+        return this.post("/api/v1/pipeline/execute", options);
+    }
+    async startPipeline(options) {
+        return this.post("/api/v1/pipeline/start", options);
+    }
 }
 //# sourceMappingURL=api-runner.js.map

package/dist/runners/api-runner.js.map

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

package/dist/runners/pipelex-runner.d.ts

@@ -1,13 +1,27 @@
 import type { Runner, RunnerType, BuildInputsRequest, BuildOutputRequest, BuildPipeRequest, BuildPipeResponse, BuildRunnerRequest, BuildRunnerResponse, ExecuteRequest, PipelineResponse, ValidateRequest, ValidateResponse } from "./types.js";
+import type { ExecutePipelineOptions, PipelineExecuteResponse, PipelineStartResponse } from "../client/pipeline.js";
 export declare class PipelexRunner implements Runner {
     readonly type: RunnerType;
+    private readonly libraryDirs;
+    constructor(libraryDirs?: string[]);
+    private libraryArgs;
     private exec;
+    /**
+     * Run pipelex with stdout and stderr inherited (streamed to the terminal).
+     * Use this for long-running or interactive commands.
+     */
+    private execStreaming;
+    buildPassthrough(subcommand: string, rawArgs: string[]): Promise<void>;
+    runPassthrough(rawArgs: string[]): Promise<void>;
+    validatePassthrough(rawArgs: string[]): Promise<void>;
     health(): Promise<Record<string, unknown>>;
     version(): Promise<Record<string, string>>;
-    buildInputs(_request: BuildInputsRequest): Promise<unknown>;
-    buildOutput(_request: BuildOutputRequest): Promise<unknown>;
+    buildInputs(request: BuildInputsRequest): Promise<unknown>;
+    buildOutput(request: BuildOutputRequest): Promise<unknown>;
     buildPipe(request: BuildPipeRequest): Promise<BuildPipeResponse>;
     buildRunner(request: BuildRunnerRequest): Promise<BuildRunnerResponse>;
     execute(request: ExecuteRequest): Promise<PipelineResponse>;
     validate(request: ValidateRequest): Promise<ValidateResponse>;
+    executePipeline(options: ExecutePipelineOptions): Promise<PipelineExecuteResponse>;
+    startPipeline(_options: ExecutePipelineOptions): Promise<PipelineStartResponse>;
 }