mthds 0.0.6 → 0.0.8

package/dist/agent/commands/install.js

@@ -0,0 +1,178 @@
+/**
+ * Non-interactive agent install command.
+ * All choices are required CLI flags — no prompts, no clack.
+ */
+import { join } from "node:path";
+import { homedir } from "node:os";
+import { mkdirSync, existsSync } from "node:fs";
+import { exec } from "node:child_process";
+import { promisify } from "node:util";
+import { agentSuccess, agentError, AGENT_ERROR_DOMAINS } from "../output.js";
+import { parseAddress } from "../../installer/resolver/address.js";
+import { resolveFromGitHub } from "../../installer/resolver/github.js";
+import { resolveFromLocal } from "../../installer/resolver/local.js";
+import { getAllAgents, getAgentHandler } from "../../installer/agents/registry.js";
+import { isPipelexInstalled } from "../../installer/runtime/check.js";
+import { ensureRuntime } from "../../installer/runtime/installer.js";
+import { trackInstall, shutdown } from "../../installer/telemetry/posthog.js";
+import { InstallLocation as Loc } from "../../installer/agents/types.js";
+const execAsync = promisify(exec);
+export async function agentInstall(address, options) {
+    // Validate required flags
+    if (!options.agent) {
+        agentError("--agent is required", "ArgumentError", {
+            error_domain: AGENT_ERROR_DOMAINS.ARGUMENT,
+        });
+    }
+    if (!options.location) {
+        agentError("--location is required (local or global)", "ArgumentError", {
+            error_domain: AGENT_ERROR_DOMAINS.ARGUMENT,
+        });
+    }
+    if (options.location !== "local" && options.location !== "global") {
+        agentError(`Invalid location: ${options.location}. Must be "local" or "global".`, "ArgumentError", { error_domain: AGENT_ERROR_DOMAINS.ARGUMENT });
+    }
+    // Validate agent ID
+    const agents = getAllAgents();
+    const validAgentIds = agents.map((a) => a.id);
+    if (!validAgentIds.includes(options.agent)) {
+        agentError(`Unknown agent: ${options.agent}. Valid agents: ${validAgentIds.join(", ")}`, "ArgumentError", { error_domain: AGENT_ERROR_DOMAINS.ARGUMENT });
+    }
+    if (address && options.local) {
+        agentError("Cannot use both an address and --local at the same time.", "ArgumentError", { error_domain: AGENT_ERROR_DOMAINS.ARGUMENT });
+    }
+    if (!address && !options.local) {
+        agentError("Provide an address (org/repo) or use --local <path>.", "ArgumentError", { error_domain: AGENT_ERROR_DOMAINS.ARGUMENT });
+    }
+    const selectedAgent = options.agent;
+    const selectedLocation = options.location;
+    const methodFilter = options.method;
+    // Resolve repo
+    let resolved;
+    let orgRepo;
+    if (options.local) {
+        try {
+            resolved = resolveFromLocal(options.local);
+        }
+        catch (err) {
+            agentError(`Failed to resolve local methods: ${err.message}`, "InstallError", { error_domain: AGENT_ERROR_DOMAINS.INSTALL });
+        }
+        if (resolved.methods.length > 0) {
+            const addr = resolved.methods[0].manifest.package.address;
+            orgRepo = addr.replace(/^github\.com\//, "");
+        }
+    }
+    else if (address) {
+        let parsed;
+        try {
+            parsed = parseAddress(address);
+        }
+        catch (err) {
+            agentError(err.message, "InstallError", {
+                error_domain: AGENT_ERROR_DOMAINS.INSTALL,
+            });
+        }
+        try {
+            resolved = await resolveFromGitHub(parsed);
+        }
+        catch (err) {
+            agentError(`Failed to resolve methods: ${err.message}`, "InstallError", { error_domain: AGENT_ERROR_DOMAINS.INSTALL });
+        }
+        orgRepo = `${parsed.org}/${parsed.repo}`;
+    }
+    else {
+        // unreachable due to earlier validation
+        agentError("No address or local path provided.", "ArgumentError", {
+            error_domain: AGENT_ERROR_DOMAINS.ARGUMENT,
+        });
+    }
+    // Filter by --method
+    if (methodFilter) {
+        const match = resolved.methods.find((m) => m.slug === methodFilter);
+        if (!match) {
+            const available = resolved.methods.map((m) => m.slug).join(", ");
+            agentError(`Method "${methodFilter}" not found. Available slugs: ${available || "(none)"}`, "InstallError", { error_domain: AGENT_ERROR_DOMAINS.INSTALL });
+        }
+        resolved = { ...resolved, methods: [match] };
+    }
+    if (resolved.methods.length === 0) {
+        agentError("No valid methods to install.", "InstallError", {
+            error_domain: AGENT_ERROR_DOMAINS.INSTALL,
+        });
+    }
+    // Optional runner install
+    if (!options.noRunner) {
+        if (!isPipelexInstalled()) {
+            try {
+                await ensureRuntime();
+            }
+            catch (err) {
+                agentError(`Failed to install pipelex runtime: ${err.message}`, "InstallError", { error_domain: AGENT_ERROR_DOMAINS.INSTALL, retryable: true });
+            }
+        }
+    }
+    // Determine target directory
+    const localDir = join(process.cwd(), ".claude", "methods");
+    const globalDir = join(homedir(), ".claude", "methods");
+    const targetDir = selectedLocation === Loc.Global ? globalDir : localDir;
+    mkdirSync(targetDir, { recursive: true });
+    // Telemetry for public GitHub repos
+    if (resolved.source === "github" && resolved.isPublic) {
+        for (const method of resolved.methods) {
+            const pkg = method.manifest.package;
+            trackInstall({
+                address: orgRepo ?? pkg.address.replace(/^github\.com\//, ""),
+                slug: method.slug,
+                version: pkg.version,
+                description: pkg.description,
+                display_name: pkg.display_name,
+                authors: pkg.authors,
+                license: pkg.license,
+                mthds_version: pkg.mthds_version,
+                exports: method.manifest.exports,
+                manifest_raw: method.rawManifest,
+            });
+        }
+    }
+    // Install methods
+    const handler = getAgentHandler(selectedAgent);
+    try {
+        await handler.installMethod({
+            repo: resolved,
+            agent: selectedAgent,
+            location: selectedLocation,
+            targetDir,
+        });
+    }
+    catch (err) {
+        agentError(`Install failed: ${err.message}`, "InstallError", { error_domain: AGENT_ERROR_DOMAINS.INSTALL });
+    }
+    // Optional skills install
+    const installedSkills = [];
+    if (options.skills) {
+        const SKILLS_REPO = "https://github.com/mthds-ai/skills";
+        const globalFlag = selectedLocation === Loc.Global ? " -g" : "";
+        try {
+            await execAsync(`npx --yes skills add ${SKILLS_REPO} --skill '*' --agent ${selectedAgent}${globalFlag} -y`, { cwd: process.cwd() });
+            installedSkills.push("*");
+        }
+        catch {
+            // Skills install failures are non-fatal
+        }
+    }
+    await shutdown();
+    const shimDir = join(homedir(), ".mthds", "bin");
+    const shimsGenerated = existsSync(shimDir)
+        ? resolved.methods.map((m) => m.slug)
+        : [];
+    agentSuccess({
+        success: true,
+        installed_methods: resolved.methods.map((m) => m.slug),
+        location: selectedLocation,
+        target_dir: targetDir,
+        installed_skills: installedSkills,
+        shim_dir: shimDir,
+        shims_generated: shimsGenerated,
+    });
+}
+//# sourceMappingURL=install.js.map

package/dist/agent/commands/install.js.map

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

package/dist/agent/commands/pipelex.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Passthrough command group that forwards to pipelex-agent.
+ *
+ * mthds-agent pipelex <cmd> [args...] -> pipelex-agent <cmd> [args...]
+ */
+import { Command } from "commander";
+export declare function registerPipelexCommands(program: Command, logLevelArgs: () => string[]): void;

package/dist/agent/commands/pipelex.js

@@ -0,0 +1,56 @@
+/**
+ * Passthrough command group that forwards to pipelex-agent.
+ *
+ * mthds-agent pipelex <cmd> [args...] -> pipelex-agent <cmd> [args...]
+ */
+import { passthrough } from "../passthrough.js";
+const PIPELEX_COMMANDS = [
+    "validate",
+    "inputs",
+    "concept",
+    "pipe",
+    "assemble",
+    "models",
+    "doctor",
+];
+const PIPELEX_RUN_SUBCOMMANDS = ["pipe", "method"];
+export function registerPipelexCommands(program, logLevelArgs) {
+    const pipelexGroup = program
+        .command("pipelex")
+        .description("Forward commands to pipelex-agent")
+        .passThroughOptions()
+        .allowUnknownOption();
+    for (const subcmd of PIPELEX_COMMANDS) {
+        pipelexGroup
+            .command(subcmd)
+            .description(`Forward to pipelex-agent ${subcmd}`)
+            .allowUnknownOption()
+            .allowExcessArguments(true)
+            .passThroughOptions()
+            .action((_options, cmd) => {
+            const remaining = cmd.args;
+            passthrough("pipelex-agent", [...logLevelArgs(), subcmd, ...remaining]);
+        });
+    }
+    // Register `run` as a sub-group with `pipe` and `method` subcommands:
+    //   mthds-agent pipelex run pipe <args> -> pipelex-agent run pipe <args>
+    //   mthds-agent pipelex run method <args> -> pipelex-agent run method <args>
+    const runGroup = pipelexGroup
+        .command("run")
+        .description("Forward to pipelex-agent run (pipe or method)")
+        .passThroughOptions()
+        .allowUnknownOption();
+    for (const runSub of PIPELEX_RUN_SUBCOMMANDS) {
+        runGroup
+            .command(runSub)
+            .description(`Forward to pipelex-agent run ${runSub}`)
+            .allowUnknownOption()
+            .allowExcessArguments(true)
+            .passThroughOptions()
+            .action((_options, cmd) => {
+            const remaining = cmd.args;
+            passthrough("pipelex-agent", [...logLevelArgs(), "run", runSub, ...remaining]);
+        });
+    }
+}
+//# sourceMappingURL=pipelex.js.map

package/dist/agent/commands/pipelex.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipelex.js","sourceRoot":"","sources":["../../../src/agent/commands/pipelex.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,MAAM,gBAAgB,GAAG;IACvB,UAAU;IACV,QAAQ;IACR,SAAS;IACT,MAAM;IACN,UAAU;IACV,QAAQ;IACR,QAAQ;CACA,CAAC;AAEX,MAAM,uBAAuB,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAU,CAAC;AAE5D,MAAM,UAAU,uBAAuB,CAAC,OAAgB,EAAE,YAA4B;IACpF,MAAM,YAAY,GAAG,OAAO;SACzB,OAAO,CAAC,SAAS,CAAC;SAClB,WAAW,CAAC,mCAAmC,CAAC;SAChD,kBAAkB,EAAE;SACpB,kBAAkB,EAAE,CAAC;IAExB,KAAK,MAAM,MAAM,IAAI,gBAAgB,EAAE,CAAC;QACtC,YAAY;aACT,OAAO,CAAC,MAAM,CAAC;aACf,WAAW,CAAC,4BAA4B,MAAM,EAAE,CAAC;aACjD,kBAAkB,EAAE;aACpB,oBAAoB,CAAC,IAAI,CAAC;aAC1B,kBAAkB,EAAE;aACpB,MAAM,CAAC,CAAC,QAAiC,EAAE,GAAY,EAAE,EAAE;YAC1D,MAAM,SAAS,GAAG,GAAG,CAAC,IAAI,CAAC;YAC3B,WAAW,CAAC,eAAe,EAAE,CAAC,GAAG,YAAY,EAAE,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC,CAAC;QAC1E,CAAC,CAAC,CAAC;IACP,CAAC;IAED,sEAAsE;IACtE,yEAAyE;IACzE,6EAA6E;IAC7E,MAAM,QAAQ,GAAG,YAAY;SAC1B,OAAO,CAAC,KAAK,CAAC;SACd,WAAW,CAAC,+CAA+C,CAAC;SAC5D,kBAAkB,EAAE;SACpB,kBAAkB,EAAE,CAAC;IAExB,KAAK,MAAM,MAAM,IAAI,uBAAuB,EAAE,CAAC;QAC7C,QAAQ;aACL,OAAO,CAAC,MAAM,CAAC;aACf,WAAW,CAAC,gCAAgC,MAAM,EAAE,CAAC;aACrD,kBAAkB,EAAE;aACpB,oBAAoB,CAAC,IAAI,CAAC;aAC1B,kBAAkB,EAAE;aACpB,MAAM,CAAC,CAAC,QAAiC,EAAE,GAAY,EAAE,EAAE;YAC1D,MAAM,SAAS,GAAG,GAAG,CAAC,IAAI,CAAC;YAC3B,WAAW,CAAC,eAAe,EAAE,CAAC,GAAG,YAAY,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC,CAAC;QACjF,CAAC,CAAC,CAAC;IACP,CAAC;AACH,CAAC"}

package/dist/agent/commands/plxt.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Passthrough command group that forwards to plxt.
+ *
+ * mthds-agent plxt <cmd> [args...] -> plxt <cmd> [args...]
+ */
+import { Command } from "commander";
+export declare function registerPlxtCommands(program: Command): void;

package/dist/agent/commands/plxt.js

@@ -0,0 +1,27 @@
+/**
+ * Passthrough command group that forwards to plxt.
+ *
+ * mthds-agent plxt <cmd> [args...] -> plxt <cmd> [args...]
+ */
+import { passthrough } from "../passthrough.js";
+const PLXT_COMMANDS = ["fmt", "lint"];
+export function registerPlxtCommands(program) {
+    const plxtGroup = program
+        .command("plxt")
+        .description("Forward commands to plxt")
+        .passThroughOptions()
+        .allowUnknownOption();
+    for (const subcmd of PLXT_COMMANDS) {
+        plxtGroup
+            .command(subcmd)
+            .description(`Forward to plxt ${subcmd}`)
+            .allowUnknownOption()
+            .allowExcessArguments(true)
+            .passThroughOptions()
+            .action((_options, cmd) => {
+            const remaining = cmd.args;
+            passthrough("plxt", [subcmd, ...remaining]);
+        });
+    }
+}
+//# sourceMappingURL=plxt.js.map

package/dist/agent/commands/plxt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plxt.js","sourceRoot":"","sources":["../../../src/agent/commands/plxt.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,MAAM,aAAa,GAAG,CAAC,KAAK,EAAE,MAAM,CAAU,CAAC;AAE/C,MAAM,UAAU,oBAAoB,CAAC,OAAgB;IACnD,MAAM,SAAS,GAAG,OAAO;SACtB,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,0BAA0B,CAAC;SACvC,kBAAkB,EAAE;SACpB,kBAAkB,EAAE,CAAC;IAExB,KAAK,MAAM,MAAM,IAAI,aAAa,EAAE,CAAC;QACnC,SAAS;aACN,OAAO,CAAC,MAAM,CAAC;aACf,WAAW,CAAC,mBAAmB,MAAM,EAAE,CAAC;aACxC,kBAAkB,EAAE;aACpB,oBAAoB,CAAC,IAAI,CAAC;aAC1B,kBAAkB,EAAE;aACpB,MAAM,CAAC,CAAC,QAAiC,EAAE,GAAY,EAAE,EAAE;YAC1D,MAAM,SAAS,GAAG,GAAG,CAAC,IAAI,CAAC;YAC3B,WAAW,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC,CAAC;QAC9C,CAAC,CAAC,CAAC;IACP,CAAC;AACH,CAAC"}

package/dist/agent/commands/validate.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Agent validate command — validates a .mthds bundle and outputs JSON.
+ */
+import type { RunnerType } from "../../runners/types.js";
+export declare function agentValidateMethod(name: string, options: {
+    pipe?: string;
+    runner?: RunnerType;
+    libraryDir?: string[];
+}): Promise<void>;
+export declare function agentValidatePipe(target: string, options: {
+    pipe?: string;
+    bundle?: string;
+    runner?: RunnerType;
+    libraryDir?: string[];
+}): Promise<void>;

package/dist/agent/commands/validate.js

@@ -0,0 +1,118 @@
+/**
+ * Agent validate command — validates a .mthds bundle and outputs JSON.
+ */
+import { readFileSync } from "node:fs";
+import { agentSuccess, agentError, AGENT_ERROR_DOMAINS } from "../output.js";
+import { createRunner } from "../../runners/registry.js";
+import { isPipelexRunner } from "../../cli/commands/utils.js";
+/** Extract raw args after `validate`, filtering out --runner, -L/--library-dir, and --log-level */
+function extractPassthroughArgs() {
+    const argv = process.argv;
+    const idx = argv.indexOf("validate");
+    if (idx === -1)
+        return [];
+    const raw = argv.slice(idx + 1);
+    const result = [];
+    let i = 0;
+    while (i < raw.length) {
+        if (raw[i] === "--runner" ||
+            raw[i] === "-L" ||
+            raw[i] === "--library-dir" ||
+            raw[i] === "--log-level") {
+            i += 2;
+        }
+        else if (raw[i].startsWith("--runner=") ||
+            raw[i].startsWith("--library-dir=") ||
+            raw[i].startsWith("--log-level=")) {
+            i += 1;
+        }
+        else {
+            result.push(raw[i]);
+            i++;
+        }
+    }
+    return result;
+}
+export async function agentValidateMethod(name, options) {
+    const libraryDirs = options.libraryDir?.length
+        ? options.libraryDir
+        : undefined;
+    let runner;
+    try {
+        runner = createRunner(options.runner, libraryDirs);
+    }
+    catch (err) {
+        agentError(err.message, "RunnerError", {
+            error_domain: AGENT_ERROR_DOMAINS.RUNNER,
+        });
+    }
+    if (isPipelexRunner(runner)) {
+        try {
+            await runner.validatePassthrough(extractPassthroughArgs());
+        }
+        catch (err) {
+            agentError(err.message, "ValidationError", {
+                error_domain: AGENT_ERROR_DOMAINS.VALIDATION,
+            });
+        }
+        return;
+    }
+    agentError("Method target is not yet supported for the API runner. Use 'mthds-agent validate pipe <target>' instead, or specify a different runner with --runner <name>.", "ArgumentError", { error_domain: AGENT_ERROR_DOMAINS.ARGUMENT });
+}
+export async function agentValidatePipe(target, options) {
+    const libraryDirs = options.libraryDir?.length
+        ? options.libraryDir
+        : undefined;
+    let runner;
+    try {
+        runner = createRunner(options.runner, libraryDirs);
+    }
+    catch (err) {
+        agentError(err.message, "RunnerError", {
+            error_domain: AGENT_ERROR_DOMAINS.RUNNER,
+        });
+    }
+    if (isPipelexRunner(runner)) {
+        try {
+            await runner.validatePassthrough(extractPassthroughArgs());
+        }
+        catch (err) {
+            agentError(err.message, "ValidationError", {
+                error_domain: AGENT_ERROR_DOMAINS.VALIDATION,
+            });
+        }
+        return;
+    }
+    const bundlePath = options.bundle ?? (target.endsWith(".mthds") ? target : undefined);
+    if (!bundlePath) {
+        agentError("Provide a .mthds bundle file to validate (positional or --bundle).", "ArgumentError", { error_domain: AGENT_ERROR_DOMAINS.ARGUMENT });
+    }
+    let mthdsContent;
+    try {
+        mthdsContent = readFileSync(bundlePath, "utf-8");
+    }
+    catch (err) {
+        agentError(`Cannot read bundle: ${err.message}`, "IOError", { error_domain: AGENT_ERROR_DOMAINS.IO });
+    }
+    try {
+        const result = await runner.validate({ mthds_content: mthdsContent });
+        if (result.success) {
+            agentSuccess({
+                success: true,
+                message: result.message,
+                pipelex_bundle_blueprint: result.pipelex_bundle_blueprint,
+            });
+        }
+        else {
+            agentError(result.message, "ValidationError", {
+                error_domain: AGENT_ERROR_DOMAINS.VALIDATION,
+            });
+        }
+    }
+    catch (err) {
+        agentError(err.message, "ValidationError", {
+            error_domain: AGENT_ERROR_DOMAINS.VALIDATION,
+        });
+    }
+}
+//# sourceMappingURL=validate.js.map

package/dist/agent/commands/validate.js.map

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

package/dist/agent/output.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Structured output helpers for the mthds-agent CLI.
+ *
+ * Mirrors the contract from pipelex/cli/agent_cli/commands/agent_output.py:
+ * - Success: JSON to stdout
+ * - Error: JSON to stderr + process.exit(1)
+ */
+export declare const AGENT_ERROR_DOMAINS: {
+    readonly ARGUMENT: "argument";
+    readonly CONFIG: "config";
+    readonly RUNNER: "runner";
+    readonly PIPELINE: "pipeline";
+    readonly VALIDATION: "validation";
+    readonly INSTALL: "install";
+    readonly IO: "io";
+    readonly BINARY: "binary";
+};
+export type AgentErrorDomain = (typeof AGENT_ERROR_DOMAINS)[keyof typeof AGENT_ERROR_DOMAINS];
+export declare const AGENT_ERROR_HINTS: Record<string, string>;
+export declare function agentSuccess(result: Record<string, unknown>): void;
+export declare function agentError(message: string, errorType: string, extras?: {
+    hint?: string;
+    error_domain?: AgentErrorDomain;
+    retryable?: boolean;
+}): never;

package/dist/agent/output.js

@@ -0,0 +1,51 @@
+/**
+ * Structured output helpers for the mthds-agent CLI.
+ *
+ * Mirrors the contract from pipelex/cli/agent_cli/commands/agent_output.py:
+ * - Success: JSON to stdout
+ * - Error: JSON to stderr + process.exit(1)
+ */
+// ── Error domains ────────────────────────────────────────────────────
+export const AGENT_ERROR_DOMAINS = {
+    ARGUMENT: "argument",
+    CONFIG: "config",
+    RUNNER: "runner",
+    PIPELINE: "pipeline",
+    VALIDATION: "validation",
+    INSTALL: "install",
+    IO: "io",
+    BINARY: "binary",
+};
+// ── Error hints ──────────────────────────────────────────────────────
+export const AGENT_ERROR_HINTS = {
+    BinaryNotFoundError: "Make sure the required CLI binary is installed and in your PATH.",
+    ArgumentError: "Check the command arguments and try again.",
+    ConfigError: "Run `mthds-agent config list` to see current configuration.",
+    RunnerError: "Check that the runner is properly configured.",
+    ValidationError: "Check the .mthds bundle for syntax or schema errors.",
+    InstallError: "Check the address and try again.",
+};
+// ── Success output ───────────────────────────────────────────────────
+export function agentSuccess(result) {
+    process.stdout.write(JSON.stringify(result, null, 2) + "\n");
+}
+// ── Error output ─────────────────────────────────────────────────────
+export function agentError(message, errorType, extras) {
+    const payload = {
+        success: false,
+        error: message,
+        error_type: errorType,
+        hint: extras?.hint ?? AGENT_ERROR_HINTS[errorType] ?? undefined,
+        error_domain: extras?.error_domain ?? undefined,
+        retryable: extras?.retryable ?? false,
+    };
+    // Remove undefined values for cleaner output
+    for (const key of Object.keys(payload)) {
+        if (payload[key] === undefined) {
+            delete payload[key];
+        }
+    }
+    process.stderr.write(JSON.stringify(payload, null, 2) + "\n");
+    process.exit(1);
+}
+//# sourceMappingURL=output.js.map

package/dist/agent/output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.js","sourceRoot":"","sources":["../../src/agent/output.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,wEAAwE;AAExE,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,QAAQ,EAAE,UAAU;IACpB,MAAM,EAAE,QAAQ;IAChB,MAAM,EAAE,QAAQ;IAChB,QAAQ,EAAE,UAAU;IACpB,UAAU,EAAE,YAAY;IACxB,OAAO,EAAE,SAAS;IAClB,EAAE,EAAE,IAAI;IACR,MAAM,EAAE,QAAQ;CACR,CAAC;AAKX,wEAAwE;AAExE,MAAM,CAAC,MAAM,iBAAiB,GAA2B;IACvD,mBAAmB,EACjB,kEAAkE;IACpE,aAAa,EAAE,4CAA4C;IAC3D,WAAW,EAAE,6DAA6D;IAC1E,WAAW,EAAE,+CAA+C;IAC5D,eAAe,EAAE,sDAAsD;IACvE,YAAY,EAAE,kCAAkC;CACjD,CAAC;AAEF,wEAAwE;AAExE,MAAM,UAAU,YAAY,CAAC,MAA+B;IAC1D,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;AAC/D,CAAC;AAED,wEAAwE;AAExE,MAAM,UAAU,UAAU,CACxB,OAAe,EACf,SAAiB,EACjB,MAIC;IAED,MAAM,OAAO,GAA4B;QACvC,OAAO,EAAE,KAAK;QACd,KAAK,EAAE,OAAO;QACd,UAAU,EAAE,SAAS;QACrB,IAAI,EAAE,MAAM,EAAE,IAAI,IAAI,iBAAiB,CAAC,SAAS,CAAC,IAAI,SAAS;QAC/D,YAAY,EAAE,MAAM,EAAE,YAAY,IAAI,SAAS;QAC/C,SAAS,EAAE,MAAM,EAAE,SAAS,IAAI,KAAK;KACtC,CAAC;IAEF,6CAA6C;IAC7C,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QACvC,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,SAAS,EAAE,CAAC;YAC/B,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC;QACtB,CAAC;IACH,CAAC;IAED,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAC9D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC"}

package/dist/agent/passthrough.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Generic passthrough helper for spawning an external CLI and inheriting stdio.
+ * Used for pipelex-agent and plxt commands that already output JSON.
+ */
+export declare function passthrough(bin: string, args: string[]): void;

package/dist/agent/passthrough.js

@@ -0,0 +1,19 @@
+/**
+ * Generic passthrough helper for spawning an external CLI and inheriting stdio.
+ * Used for pipelex-agent and plxt commands that already output JSON.
+ */
+import { spawnSync } from "node:child_process";
+import { agentError, AGENT_ERROR_DOMAINS } from "./output.js";
+export function passthrough(bin, args) {
+    const result = spawnSync(bin, args, {
+        stdio: "inherit",
+    });
+    if (result.error) {
+        if (result.error.code === "ENOENT") {
+            agentError(`${bin} not found. Make sure it is installed and in your PATH.`, "BinaryNotFoundError", { error_domain: AGENT_ERROR_DOMAINS.BINARY });
+        }
+        agentError(`Failed to spawn ${bin}: ${result.error.message}`, "BinarySpawnError", { error_domain: AGENT_ERROR_DOMAINS.BINARY });
+    }
+    process.exit(result.status ?? 1);
+}
+//# sourceMappingURL=passthrough.js.map

package/dist/agent/passthrough.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"passthrough.js","sourceRoot":"","sources":["../../src/agent/passthrough.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAE9D,MAAM,UAAU,WAAW,CAAC,GAAW,EAAE,IAAc;IACrD,MAAM,MAAM,GAAG,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE;QAClC,KAAK,EAAE,SAAS;KACjB,CAAC,CAAC;IAEH,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QACjB,IAAK,MAAM,CAAC,KAA+B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC9D,UAAU,CACR,GAAG,GAAG,yDAAyD,EAC/D,qBAAqB,EACrB,EAAE,YAAY,EAAE,mBAAmB,CAAC,MAAM,EAAE,CAC7C,CAAC;QACJ,CAAC;QACD,UAAU,CACR,mBAAmB,GAAG,KAAK,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,EACjD,kBAAkB,EAClB,EAAE,YAAY,EAAE,mBAAmB,CAAC,MAAM,EAAE,CAC7C,CAAC;IACJ,CAAC;IAED,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC;AACnC,CAAC"}

package/dist/agent-cli.d.ts

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+/**
+ * mthds-agent — machine-oriented CLI for AI agents.
+ *
+ * Outputs structured JSON to stdout (success) and stderr (errors).
+ * No clack, no chalk, no ora — just JSON.
+ */
+export {};